Installation
Installation requirements
PHP version >= 5.2.4.
MySQL: 5.0 or newer, InnoDB storage engine
PDO drivers: mysql
qdPM is a PHP5 tool relying on the symfony framework version 1.2. The framework files are bundled with the application, so you don’t need to install symfony before installing qdPM.
Installation
Download the qdPM and unpack ‘qdpm’ folder in your server (you can rename ‘qdpm’ to ‘pm’ or ‘workspace’ etc.).
Ensure that the directories ‘qdpm/core/cache’, ‘qdpm/core/log’, ‘qdpm/uploads/attachments’ and ‘qdpm/uploads/users’ are writable by the web server (have permissions 777).
Run ‘qdpm/check_configuration.php’ to check server configuration (all mandatory requirements should be OK).
After database and qdPM configuration browse to: http://localhost/qdpm/index.php
Database configuration
Create new database for qdPM and import data from install.sql file
Open file ‘qdpm/core/config/databases.yml’ and put information about database there. You have to change only next lines:
dsn: mysql:host=localhost;dbname=qds-team_qdpm
username: db_user
password: db_pass
note: password can’t be empty
qdPM configuration
Open file ‘qdpm/core/apps/frontend/config/app.yml’ and change next parameters:
app_name: qdsTeam workspace # Name of application
app_short_name: qdPM # Short name of application
default_site_width: 90% # use percent or numeric value, for example “100%” or “1000px”
administrator_email: admin@localhost.com
administrator_password: admin
Administrator is internal user who can just manage users and configuration. Administrator can’t create tasks or projects.
So after installation login as administrator and create users.
Note: don’t use administrator email as user email address.
After configuration make sure qdpm/core/cache folder is empty and run qdPM http://localhost/qdpm/index.php
Note: always clear qdpm/core/cache folder after changes in configuration file
After successfully installation you can remove ‘qdpm/frontend_dev.php’ and ‘qdpm/check_configuration.php’ for security reason if you don’t need run qdPM in developer mode
If you like qdPM you can rate project and add your review in SourceForge
Your feedbacks is very important for qdPM!
Installation Problems
You will see error dialog window if you have any problems with run qpdm. In general you can’t login and there are two typical errors “500 Internal Server Error” and “404 Not Found”
For local installation read more about server configuration you can here http://www.symfony-project.org/cookbook … web_server
404 Not Found
- Check AllowOverride in httpd.conf it should be set to “All”, example “AllowOverride All”
500 Internal Server Error
it means you have some server configuration problems. You have to run qdPM in developer mode to see errors in error log. Url to run qdPM in developer ‘http://workspace/web/frontend_dev.php/home’ (add frontend_dev.php before ‘home’ to run qdPM in developer mode)
Error log stored in ‘log/frontend_dev.log’ where you can see what is wrong.
Check php.ini:
short_open_tag = On
safe_mode = Off
In error log: Class ‘PDO’ not found
“PHP Fatal error: Class ‘PDO’ not found in D:\Hosting\2848908\html\blades\lib\symfony\plugins\sfPropelP lugin\lib\vendor\propel\util\PropelPDO.php on line 42″
It means you don’t have mysql PDO driver http://us.php.net/manual/en/book.pdo.php and you have to install it.
In error log you can see: Unable to open PDO connection [wrapped: SQLSTATE[HY000] [2002] Invalid argument] or Can’t connect to local MySQL server through socket ‘/tmp/mysql.sock’
open config\databases.yml
and add unix_socket=/opt/lampp/var/mysql/mysql.sock to dsn, so it will be like this:
dsn: mysql:host=localhost;dbname=qdpm;unix_socket=/opt/lampp/var/mysql/mysql.sock
then clear cache and try again.
note: you have to replace path ‘/opt/lampp/var/mysql/’ to your path to mysql.sock file
I had this problem in ubuntu 9.04 descktop and some people had this problem in Mac – Leopard
GoDaddy Shared Hosting
If you are using GoDaddy Shared Hosting then read this http://gfaraj.wordpress.com/2008/04/25/deploying-a-symfony-project-on-godaddy-shared-hosting/ but there is no warranty you will run qdPM on GoDaddy
If you will have any other problems with installation contact me
