Installation

Chapter 3. Installation

About the ~/geniegate/ directory.  The main difference between GenieGate and other packages is the use of a directory outside of web space for security reasons.

By default, GenieGate will use your unix HOME directory. It is worth pointing out that your home directory is NOT the same as your document root.

  • Upload the files from geniegate/ to your HOME directory, you should have a ~/geniegate directory on your FTP server after this step.

  • Edit ~/geniegate/conf/geniegate.ini Pay particular attention to the database settings.

  • Upload the web/ files to web server space. (These should be web accessible.)

  • Run web/admin/setup.php in a browser to setup the tables. (This may take a few minutes to run.)

Hopefully, that was all there is to it, setup.php will attempt to provide details as they are needed.

Using an alternate ~/geniegate/.  If you cannot use the HOME directory or if you are using a platform that does not support HOME directories, you may set an environment variable in your .htaccess file or define GENIGATE_HOME in the doconf.php files.

Example 3.1. Setting an environment variable in an .htaccess file

#
# Example .htaccess with an evironment variable
# Works with many versions of Apache.
#
SetEnv GENIEGATE_HOME /home/myispname/private/geniegate

The web files.  Once the path of ~/geniegate is worked out, you may place the web files anywhere you choose. These files do need to be web accessible, as they are used by web browsers.

Congratulations, you now have completed the installation. You can login, have a look around and experiment with different things. The default username for logging in is root with a password of geniegate. You will need to change this as soon as possible.