Quick Start

This section attempts to quickly walk through the process of installation and setup, it does not cover the Apache plugin configuration. If you have skipped through the directory structure, you should return to it now.

Install database

GenieGate requires access to a MySQL database.

Setup database

  1. Create database mysql> CREATE DATABASE dbname;

    Tip

    It is recommended that GenieGate be given it's own database. (in cases where multiple instances of ~/geniegate exist, separate databases are required)

  2. Setup a user and grant permissions. mysql> GRANT ALL PRIVILEGES ON dbname TO username IDENTIFIED BY 'secret';

    Where dbname is the name of the database you are creating, usernameis the username for connecting to the database and secret is the password used in connecting to your database.

  3. Flush the privileges so that you may connect.

    mysql> FLUSH PRIVILEGES;

    Tip

    Your internet service provider may have provided you with tools to manage mysql databases. You should check with your ISP for the final word on creating and granting access to databases. In many cases, these steps will have already been done for you.

    More information about mysql, including security policies can be found at http://www.mysql.com/

Edit ~/geniegate.ini

Next, edit your local geniegate.ini configuration file. In particular, make sure the [databases] section is accurate.

The remaining configuration values are divided into sections, these sections are divided by [SectionName] values. (this is a standard .ini configuration file)

[database]

HOST

The host name mysql is running on.

USER

This is the username to connect to MySQL

PASS

The password to connect to the database.

DATABASE

The name of the database to connect to.

Tip

Other areas will need to be configured too, but they are dependent on the type of setup you will be doing. At first it's best to get the database working and return later for the other areas.

Run setup.php

In order to setup the database tables, run the setup.php script in your browser. It is important to note that this script will only give you your root login/password once. Running it a second time will not provide you with a password. (this is for security.)

After setup.php has completed, you should be able to login to your control panel. You should change your password as soon as possible.

You can, and probably should disable web/admin/setup.php after you are done with it.

Congratulations, you now have a minimal installation completed. You can login, have a look around and experiment with different things. Be aware that account creation may not work if the plugins are not configured.