How to Install Tribiq CMS

1. Place the files on your server

Put the CMS files onto the machine where you wish to run your site.

You can unpack the Tribiq CMS package (e.g. the .tar.gz or .zip file) on to your local machine then upload everything using an FTP program.

Alternatively you can download the Tribiq CMS package onto your server directly, then unpack it, in a different location from your live site. For example on a Linux server the following command unpacks the .tar.gz package:

tar xvfz community-6.0.3a.tar.gz

If you want to run Tribiq CMS in the root of a domain (e.g. http://yourtribiqsite.com/), you should copy all of the package's files into your public HTML directory, for example:

cd public_html
mv ../community-6.0.3a/*.* .

Alternatively if you want to run Tribiq CMS in a subdirectory (e.g. http://yourtribiqsite.com/cms/), and then you should move and rename the package, for example, the following renames the package to "cms" and places it in your public_html directory:

cd public_html
mv ../community-6.0.3 cms

2. Prepare your MySQL Database

Create your MySQL database and a MySQL user account. (You may have a control panel in which you can do this, or you may need to ask for these things to be created for you.)

If you have MySQL command-line console access, you can create a database and a database user like this:

CREATE DATABASE tribiqdb;
GRANT ALL ON tribiqdb.* TO tribiqcms@locahost IDENTIFIED BY 'password';

3. Create the Docstore, Dropbox and Backup directories

Your CMS needs:

• a Backup directory
• a Docstore directory
• a Dropbox directory

We recommend that the Backup, Docstore and Dropbox directories be kept outside of your webserver's web directory (Document Root). This prevents visitors from accessing files via a URL to the file directly. This is essential if you want to password-protect your Documents.

4. Set permissions

The Docstore, Dropbox and Backup directories that you created above need to be writeable by the webserver so you may need to set their permissions, for example on a UN*X server:

chmod 777 docstore
chmod 777 dropbox
chmod 777 backup

The cache directory in the CMS also needs to be writeable by the webserver so you should also set the permission for it as well, for example on a UN*X server:

chmod 777 cache

Finally, to make your installation process smoother we recommend we you make the tribiq_siteconfig.php file writeable, for example on a UN*X server:

chmod 666 tribiq_siteconfig.php

5. Run the Installer

Use your browser to go to the Tribiq CMS directory, e.g. http://yourtribiqsite.com, or http://yourtribiqsite.com/cms/ if you are installing to a subdirectory, to launch the Installer.

The installer will then:

• Ask you to accept the software license.
• Check to see if your server meets the requirements to run Tribiq CMS.
• Ask you to provide the information on the database and database user that you created in step 2.
• Ask you for your name and email to create your Admin account.
• Write to your tribiq_siteconfig.php file, or ask you to copy and paste some code into it if it is not writeable by the webserver.
• Create the database tables needed for the CMS, and populate them with initial data.

6. Enable a Language

After the installer has finished, you will be directed to Storekeeper (the Administrative back-end) and will be prompted to enable at least one Language for your site.

If you wish for your site to be multilingual you may enable additional Languages by clicking on the green plus icon after you have enabled your first Language.

When you have enabled at least one Language, you will then be able to start creating Content on your site!

7. Enable more Modules (optional)

By default a minimal set of Modules are enabled. You can enable more by going to "Modules" in Storekeeper.

8. Enable mod_rewrite functionality (optional)

If mod_rewrite is enabled in your server's Apache installation, and Apache is configured to read directives from .htaccess files in your web directory, you should rename the htaccess.txt file in the Tribiq CMS directory to .htaccess, for example on a UN*X server:

mv htaccess.txt .htaccess

9. Enable your site

Visitors will not be able to actually see your site until you enable it. To enable your site:

• Go to "Content" in Storekeeper, then go to "Special Pages" in the second level of navigation, then ensure that all of the Content Items shown are published.
• Go to "Administration" in Storekeeper, then go to "Site Disabled" in the main panel, then click on the toolbar button above to enable your site.

Thank you for using Tribiq CMS!