Installing
The installer
You can now run the install script, which is located at path_to_etomite/install/.
To do this you need to open a browser and type in an URL.
If you are running on a your own computer, this will be something like:
http://localhost/{path_to_etomite}/install/
or if on a live server:
http://{www.mydomain.com}/install/
NOTE: If you simply point your browser to http://localhost/{path_to_etomite}/ or http://{www.mydomain.com}/ you should be presented with a message informing you to run the installer, complete with a link to the installer.
Follow all the instructions, and the installer should run fine.
This should ask you for various details of your configuration, check that everything is OK, and create and populate the site database.
There is one case where the defaults aren't a good idea: when creating the admin account, it is a good idea to change the name of the account to something you can easily remember, but is not easy for someone else to guess (so don't choose your first name!)
When choosing a prefix for the tables, don't choose the same prefix as used for any other package whose tables are stored in the same database.
Possible problems
Lack of a database
The Etomite installer needs a database to write the site to, and it will attempt to create one for you. However, your host may not allow the creation of databases from PHP scripts, and the installer will fail if it attempts to create a database when it's not allowed to. To combat this either:
- Create a new database for Etomite from your control panel or MySQL administration tool (best option)
- Make sure you're allowed to create databases from PHP scripts
- Use an existing database
Once you've set up an empty database or have a database ready, you can run the installer.
Session check fails
The etomite installer checks that the PHP configuration is correct for suitable session handling. If this test fails, ask in the forum for further advice, providing
- PHP version
- MySQL version
- Operating System
- Web server type and version
- Ideally, also provide a link from which PHP coinfo
After installation
Providing there were no errors during installation, you should be able to now enter the Manager.
The first thing you need to do is login to the Manager using the administrator name and password you previously set, check the configuration and save it even if you make no changes.
Until the configuration has been saved from the Manager, the site won't operate correctly.
Install Directory
Once you are happy that the installation is working, delete the path_to_etomite/install directory (recommended) or alternatively, rename it.
Configuration File
You will now want to change the permissions on the path_to_etomite/manager/includes/config.inc.php file with
CHMOD 644 or CHMOD 444,
depending on your server.
It would also be a good idea to download a copy of the manager/includes/config.inc.php file to your computer from the server as it has been setup and configured to your server specifications based on the Installation process.
Next: Configuration