This section attempts to 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 may wish to return there. For a quicker overview, suitable for those experienced with PHP programs, please see the section called “Really quick overview.” this section is rather verbose.
You may skim over the database section if your ISP has already provided you with database creation tools. We will cover the manual steps required to install a mysql database next.
GenieGate requires access to a MySQL database.
Procedure 3.1. Setup database
-
Create database mysql> CREATE DATABASE dbname;
![[Tip]](img/tip.gif)
Tip It is recommended that GenieGate be given it's own database. (in cases where multiple instances of
~/geniegateexist, separate databases are required) -
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, username is the username for connecting to the database and secret is the password used in connecting to your database. You will need this information later.
-
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/
Next, edit your ~/geniegate/conf/geniegate.ini configuration file.
We are mainly concerned with the [database] section. This is a
standard ini file.
~/geniegate/conf/geniegate.ini
- PLUGINS
This is a colon delimited list of plugins. This can safely be commented out if you are not using any plugins. (We recommend commenting this out for the initial installation)
|
Tip |
|---|---|
|
Other areas may need to be configured as well, but they can be configured at a later time. Right now we are concerned with the initial installation. The ini file is sprinkled with comments designed to help with the edit process. |
In order to setup the database tables, run the setup.php script in your browser. Remember the username and password, you will need them to login to the control panel.
After setup.php has completed, you should be able to login to your control panel. You should change your root 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 completed the installation. You can login, have a look around and experiment with different things. Be aware that account creation may not work as expected until plugins are configured.