---
Completing Installation
---

Your PHPWebsite has been installed but requires some manual steps before
it is ready for use.


If there is no existing PHPWebsite install and database you will need to
create an empty database for phpWebSite before starting setup.  For
example (MySQL):

mysql -p -u root mysql <<__EOSQL
  CREATE DATABASE phpwebsite;
  GRANT CREATE, DROP, ALTER, SELECT, INSERT, UPDATE, DELETE
    ON phpwebsite.*
    TO phpwsuser@localhost
    IDENTIFIED BY 'a_good_password';
  FLUSH PRIVILEGES;
__EOSQL


In order for the automated setup routine to complete its work a number
of permissions must be temporarily relaxed.  To change the permissions
execute the following commands  from the install directory:

cd setup
./secure_phpws.sh setup

Note: If your web server runs as a user:group other than apache:apache
then you must manually modify the APACHE_USER and APACHE_GROUP variables
at the top of the secure_phpws.sh script.  


Visit your website to complete installation of the database and
software.  For example:

http://www.domain.tld/phpwebsite/setup


Tighten the permissions on generated configuration file.  The config.php
file contains clear text passwords and must be tightly guarded.  Also,
the setup directory is hidden from the web server to avoid any potential
abuses.  Run the following commands from the install directory:

cd setup
./secure_phpws.sh run root root
chown apache:apache ../conf/config.php
chmod u=r,go= ../conf/config.php
chmod u=rwx,go= ../setup


Enjoy your PHPWebsite.