====== Installing Platform4PHP ======

Just copy the entire distribution into your website folder. Be aware that Platform4PHP creates a configuration file in the parent folder of the website root, so be sure your folder configuration can handle this.

I have configured the site at **/var/www/people/web/**, so the configuration file is going to be created in **/var/www/people/**

Open your new website, and you will automatic be taken to the installation page. If the installation encounter any problems you will be notified, so you can remedy them.

===== Configuring Platform4PHP =====

Fill out the configuration form:

^Global database server host name|//localhost//|This points to the database server containing the global database. Here it is localhost, but in a multiserver environment, it could point to another server.|
^Global database user name|//people_database_user//|Database user name|
^Global database password|//mysecretpassword//|Database password|
^Global database name|//people_application//|The global database we created earlier.|
^Local database server host name|//localhost//|Again, as we are running of the same server, we just repeat the information above. If we were setting up a second server, this could be different from above.|
^Local database user name|//people_database_user//| |
^Local database password|//mysecretpassword//| |
^Instance database prefix|//people_instance//|When a new instance is created, the associated database will be prefixed with this title. Select a valid database name.|
^Instance store directory|///var/lib/people/storage///|The storage directory, we created earlier.|
^Temporary files directory|///var/tmp///|The temporary directory, we created earlier.|
^Global log files directory|///var/log/people///|The log directory, we created earlier.|
^URL for server talk|///Platform/Server/php/server_talk.php///|This specifies an URL where the instance servers communicates with each other. This should be left as is.|
^Password salt|//2b6ffe227478eb9145316b18c6b584ed//|Specifies a password salt. This can be anything, but when it is set, it should not be changed, as that would render all passwords invalid. This should be kept the same across multiple servers in the same complex, to ensure that instances are portable.|
^Password for admin interface|//mysecretpassword//|A password for locking the installation directory and other management tools. This will appear in clear text in the configuration file.|

Platform4PHP will check your configuration and if everything checks out, you'll get a message that the installation was a success.

//I have encountered some examples where you get an error, that a variable wasn't set instead of the success message. Reloading the page, fixes the issue. I haven't quite figured out why this happens!//

That's it.