If you are experiencing difficulties with your dotProject installation, the following hints have been provided for troubleshooting the cause of the problem.
1 check.php Settings
There is a system check facility available within the docs directory of your root dotProject installation (eg system_name/dotproject/install/docs/check.php). This system check will display an information page that indicates the current status of your installation. Before lodging a support request or investigating any issues that you have, you should check your system status.
If you are unable to even run check.php then you have not correctly set up your config.php and you should sort that out yourself before lodging any support requests or asking any questions.
1.1 Root Directory Setting in check.php Displays Error
Is the root_dir variable set correctly? Please refer to Category:Root Directory Setting in check.php Displays Error
2 General Things to Check
When upgrading an existing installation, have you checked that any new configuration settings in config-dist.php have been transferred to config.php?
Is there any white space (including carriage returns) after the closing php brace ?>. If so, delete them. This could cause the html headers to be sent too early.
When upgrading, have you set the configuration variable check_legacy_password to true.
$dPconfig['check_legacy_password'] = true;
3 Cannot Upload Files Because of....
Please refer to Category:Cannot Upload Files
4 php.ini Options
register_globals = off Set to off DO NOT SET ON WITHOUT CONSIDERING SECURITY IMPLICATIONS - see php references for more information.
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.
session.save_path = /tmp (*nix style)
session.save_path = "d:/apache/php/sessiontemp" (Windows style) Check that this directory actually exists.
5 White Screen of Death
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 );
Uncomment the error reporting line to see if any error messages appear.
6 Not able to see Calendar
If you are unable to see calendar pages and/or gantt charts or many other combinations of problems you may not have the correct modules configured in your PHP installation.
In particular, you must have the gd extension enabled.
To identify the modules you do have configured, see Troubleshooting for details. To include extra modules in your PHP installation please refer to your php manuals and/or PHP specific support facilities.
7 Not able to see Gantt Charts
Some systems are having problems where a gantt chart will suddenly stop displaying - normally associated with a number of tasks - but the number varies from installation to installation. Basically what happens is that the Gantt chart displays until X number of tasks are added and suddenly it stops displaying.
7.1 GD Graphics Library in PHP Must be Enabled
Gantt Charts not displaying can be because you have not enabled the GD Library in your PHP installation (check.php as outlined above will show you whether or not it is turned on).
Please refer to the relevant php documentation for instructions on how to enable GD.
7.2 Memory Allocation
The issue is to do with the physical size of the Gantt Chart image and the memory needed by the system to create it..... It was greater than the default 8mg size within the php.ini file.
I adjusted this to 64mg and it all started working.
The exact line changed in php.ini is.....
- Resource Limits ;
max_execution_time = 30 ; Maximum execution time of each script, in seconds max_input_time = 60 ; Maximum amount of time each script may spend parsing request data memory_limit = 64M ; Maximum amount of memory a script may consume (8MB)
If you see a message SIMILAR to JpGraph Error: Font file /usr/X11R6/lib/X11/fonts/truetype/arial.ttf" is not readable or does not exist, then you are missing a font file on your system. Alternatively, your Gantt chart may just be failing silently.
It could also be that if you are totally missing the directory:
You need to make sure you have at least Arial and Arial Bold in TrueType fonts somewhere on your system.
If it isn't in the above directory you need to edit otproject/lib/jpgraph/src/jpg-config.inc and put the correct directory there.
You will need to source the relevant font files yourself - Google is your friend, although we have heard that some people have copied the font files (arialdb.ttf) from their windows machine into the directory that they have created themselves.
8 Adding XML Support
These instructions have been copied AS IS with no guarantees / no updates and no verification / from our support bulletin board - thank you to Sinewy for his hardwork and time in contributing these.
If you are experiencing problems with blank pages being displayed instead of, say the Calendar or the Gantt Chart, it may be that you do not have XML support compiled into your version of PHP.
This is a PHP issue and if you require further assistance with this you should refer to your PHP documentation and/or support services.
here's the instructions:
cd / mkdir compile cd compile wget http://apache.mirrors.ilisys.com.au/httpd/httpd-2.0.50.tar.gz wget http://au.php.net/get/php-4.3.8.tar.gz/from/us3.php.net/mirror wget http://belnet.dl.sourceforge.net/sourceforge/expat/expat-1.95.7.tar.gz tar zxf httpd-2.0.50.tar.gz tar zxf php-4.3.8.tar.gz tar zxf expat-1.95.7.tar.gz cd expat-1.95.7 ./configure --prefix=/usr make make install cd /compile/httpd-2.0.50 ./configure --enable-so make make install cd /compile wget http://www.xmlsoft.org/sources/libxml2-2.6.11.tar.gz tar zxf libxml2-2.6.11.tar.gz cd libxml2-2.6.11 ./configure --prefix=/usr make make install cd /compile/php-4.3.8 ./configure --with-apxs2=/usr/local/apache2/bin/apxs --with-mysql=/usr --enable-bcmath --enable-calendar --with-xml --with-expat-dir=/usr make make install cp php.ini-dist /usr/local/lib/php.ini nano OR pico /usr/local/apache2/conf/httpd.conf Insert this line with the other AddModule? lines: LoadModule? php4_module libexec/libphp4.so Underneath add this: AddType? application/x-httpd-php .php /etc/init.d/httpd restart
that should give optimal XML support.