Troubleshooting dotProject

config.php settings

  1. On a new installation, have you created a copy of the distribution file called config-dist.php called config.php?
  2. When upgrading an existing installation, have you checked that any new configuration settings in config-dist.php have been transferred to config.php?
  3. Is the root_dir variable set correctly.
  4. Is there any white space (including carriage returns) after the closing php brace ?>. If so, delete them. This cause the html headers to be sent too early.
  5. When upgrading, have you set the configuration variable check_legacy_password to true. 
    $dPconfig['check_legacy_password'] = true;

php.ini file settings

  1. register_globals = off
    Set to off, this hould generally work satisfactorily but you could try setting it to on.
  2. session.auto_start = 0
    This may generally be set to zero. If you are experiencing trouble and this variable is set to 1, try setting it to 0.
  3. session.save_path = /tmp (*nix style)
    session.save_path = "d:/apache/php/sessiontemp" (Windows style)
    Check that this directory actually exists.
  4. file_uploads = on
    Set to on to enable the file upload module. You will also need to have appropriate permissions on the file folder. Maximum upload size can also be configured in php.ini.

Maximum File Upload Size [php.ini file settings]

The maximum file upload size will depend on:
  1. Server Configuration
  2. Bandwidth Connectivity
For the most part, you can control the ability of uploading LARGE (>8mb files) by modification of your php.ini file. However, your modifications will likely go beyond simply tweeking the upload_max_filesize variable.

Here are some sample php.ini modifications used to get a 11mb+ upload to function:

	upload_max_filesize = 20M ; DEFAULT is 2M 
	max_execution_time = 300 ; DEFAULT is 30 [seconds] 
	post_max_size = 12M ; DEFAULT is 8M
You may also find it necessary to modify the memory_limit Resource Limit, but this shouldn't be an issue if you have good bandwidth.

In order to get a 3MB upload to work within our LAN environment, it was only necessary to modify the upload_max_filesize variable. However, file uploads may fail because of script timeouts exceeding max_execution_time if you have a poor network connection between your client and server (e.g. dialup).

Please remember to restart Apache after making modifications to php.ini.

PHP

  1. You need PHP version 4.1.x or higher.
  2. Is MySQL correctly compiled with PHP on a *nix server. You can check this by writing a simple little php file that simply contains: 
    <?php phpinfo(); ?>
    Point your browser at this file (via your web server!) and see if there are configuration entries for MySQL.
  3. If the Gantt charts aren't working, have you compiled the GD libraries with PHP?

Other thigs to try

There is a line in ./index.php that looks like this: 

// If you experience a 'white screen of death' or other problems,
// uncomment the following line of code:
//error_reporting( E_ALL );
Un-comment the error reporting line to see if any error messages appear.

General Things

The project percent complete is calculated on a weighed average of the task durations. Therefore, a project may not be 50% complete even if it had two tasks at 50% complete but they were of different durations. If no tasks have any duration then the project will always show 0% complete.

If you are wanting to use the translation management facilities, the locales/{country code} directory and all the files within this diectory (the *.inc files) will need to have the correct permissions under a POSIX based system to allow the web-server to write to these directories.

Help!

If all else fails then post your problem on the SourceForge forum or Tracker. However, to help out we remote developers, please include the following information:

Please describe the problem as best you can. Try not to say "The contacts links are broken". Something like "When I click on the letters on the Contacts index page, it takes me to the user admin list." would be much better and helps us home in on the problems a lot quicker.

Another example might be "When I try and edit a project I get the error 'create a company first'". The critical piece of information missing here is the fact the dotProject user only has READ-ONLY permissions to the Projects module.