From DotProjectWiki

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)

7.3 Fonts

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:

/usr/X11R6/lib/X11/fonts/truetype

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.