Installation

phpPMS Installation

---

Prerequisites

• Web server (Apache/Lighttpd) with SSL enabled.
• MySQL 5
• PHP 5 >= 5.1.2
• PHP mysql module
• PHP mcrypt module
• PHP ldap module
• PHP curl module
• PHP SimpleXML module

---

Installation

Package installation on Debian GNU/Linux:

apt-get install apache2 php5-mcrypt php5-mysql php5-ldap php5-curl mysql-server

/etc/init.d/apache2 restart

---

Setting up directories and permissions

Create a new directory en the web server root:

mkdir /var/www/phppms
~~~~~~

Copy and extract phpPMS bundle in the directory that has been created:

cp phpPMS.tar.gz /var/www/phppms

cd /var/www/phppms

tar xzf phpPMS.tar.gz

Change the directory 'phppms/inc' owner (it's only needed for installation process).
The owner must be the same of the webserver user:

chown www-data /var/www/phppms/inc

Change directory 'phppms/backup' owner:

chown www-data /var/www/phppms/backup
~~~~~

---

Updating

If your are updating the application, extract the content of downloaded file, make a database backup (you can do it from application) and continue with the next step.

---

Setup environment

Launch web browser and go to this URL:

https://SERVER_NAME_OR_IP/phppms/install/install.php

Follow installer instructions.

This script will do a few tasks to finish the setup process. After a successful finish, we can now login into phpPMS.

---

Post-Installation

• You must change admin password.
• You must change master password.

---

Notes

• If you use LDAP as authentication, you should know that user's passwords that are exchanged between the web server and the LDAP server, are sent in plaintext. Secure communication will be a option in next release.
• If an user do login through LDAP, it will be disabled until an admin user put it on the right group.

[Anonymous]

What the HECK man, what is the "master" password, am I supposed to guess it?
very poor documentation.

[nuxsmin]

Hi, if you read the last page of installation process, you could have seen that the master password is established to '0000' and it warns you that you should change it on first login.

Documentation is in progress, but I think there is enough stuff to make it works. FAQ is written in spanish and translation to english is in progress. Also, there is context help on some items on the application.

[Anonymous]

Downloaded the latest release and can't get past:

DB connection phppms@localhost -> phppms OK
Initial master password setted up to '0000'. It is advisable to change OK
User 'admin' can not be created ERROR
There was an error while configuring environment ERROR

Deleted everything and started from scratch. Still no go. Any ideas?

[nuxsmin]

Hi!, it's very strange, because if previous steps had been completed successfully, it means that DB credentials are ok. Try to execute this query (if you have db access) after error occurs:

INSERT INTO users (vacUName,vacULogin,intUGroupFid,intUProfile,blnIsAdminApp,vacUPassword,blnFromLdap) VALUES('PMS Admin','admin',1,0,1,MD5('admin'),0)

After that reload the page and it should appear as a warning message, not an error.

[Anonymous]

[Anonymous]

I was able to install phppms successfully, but unable to login with admin/admin. Please find the attached screenshot for more information.

Any help to resolve this issue would be much appreciated.

[Anonymous]

i get the following error
Directory permissions are incorrect ('/var/www/html/inc') ERROR

even though i've change permissions, can you advise what are permission have to be ?

[nuxsmin]

Hi, the directory permissions should be 775 and set the owner to apache service user (usually www-data, www-run or httpd).

chmod 775 /var/www/html/inc && chown apache_user:apache_user /var/www/html/inc