Troubleshooting

From FiFormsWiki

Jump to: navigation, search

FiForms is a complex piece of software which depends of quite a lot of other software to operate correctly. Following are some points to look at in troubleshooting.


Contents

Common Problems

I can't log in or open the Main Menu

If you've just installed FiForms, or perhaps made some changes to your server configuration, and you can't open the main menu, follow these steps to insure that FiForms is correctly installed.

More Documentation Coming Soon

Fatal error: require_once() Failed opening required 'FiForms_global.inc.php'

If you get this error message, it means that the FiForms_includes directory is not in your PHP path. You'll need to set your PHP path in your php.ini file or in your webserver configuration.

Warning: Cannot modify header information - ...

Warning: Cannot modify header information - headers already sent by 
(output started at /var/www/FiForms/scripts/localconfig.php:2) in 
/var/www/FiForms/FiForms-includes/FiForms_BasicAuth.inc.php on line 
83  Warning: Cannot modify header information - headers already sent 
by (output started at /var/www/FiForms/scripts/localconfig.php:2) in 
/var/www/FiForms/FiForms-includes/FiForms_BasicAuth.inc.php on line 84

If you get this error message, it means something (possibly a module or configuration script) has started sending output to the browser when it shouldn't. The most common reason for this is having white space or blank line before or after the <?php ?> tags in localconfig.php or in one of the application-specific appconfig.php files.


Paths do not exist or are not writable

SCRIPT_PATH Writable

If the SCRIPT_PATH is not writable by the webserver process, then FiForms will not be able to update its own configuration from within the browser window. However, this is not a problem as long as you are able to manually edit (or upload) the configuration file that is generated for you, when you setup or reconfigure FiForms. In a production environment, the SCRIPT_PATH (and localconfig.php) should not be writable for security reasons.

You can make the script path writable by running the following command on the terminal:

chmod 777 /path/to/FiForms/scripts
chmod 777 /path/to/FiForms/scripts/localconfig.php

(Warning: This is the most insecure setting)

APP_BASE Writable

If APP_BASE is not writable by the webserver process, then FiForms will not be able to automatically install new applications from within the browser interface. A security-conscious administrator in a production environment should not use this feature.

You can make the app path writable by running the following command on the terminal:

chmod 777 /path/to/FiForms/apps -R

(Warning: This is the most insecure setting)


Component Applications are not working.

mysqldump

The mysqldump application is used within FiForms to allow users to create a backup of the database from the server. Be sure that you have installed MySQL and all

Getting More Help

If you're having trouble with your FiForms installation, hopefully this page will help you. If you still need help, have a look at the Discussion Forum or e-mail the developer, Daniel McFeeters, directly at support [at] fiforms [dot] org.

Blatant Plug: If you need more assistance in setting up or troubleshooting your FiForms Framework installation, the developer, Daniel McFeeters, does freelance consulting work and is the owner/operator of FiForms Solutions. Contact us at the above address or through our website for more information.

Personal tools
This is a cached copy of the requested page, and may not be up to date.

Sorry! This site is experiencing technical difficulties.
Try waiting a few minutes and reloading.

(Can't contact the database server: The server requested authentication method unknown to the client (localhost))


You can try searching via Google in the meantime.
Note that their indexes of our content may be out of date.