How to Install Tribiq CMS

1. Download from tribiq.com

Download the Tribiq CMS package (zip or tar.gz) onto the target machine (this can be your desktop or a webserver).

(It's best to unpack the package on the target machine, rather than open the package on your desktop, since loose files can get lost during FTP transfer.)

Decide whether to run Tribiq CMS in the root of a domain (e.g. http://www.yourtribiqsite.com/) or in a subdirectory (e.g. http://www.yourtribiqsite.com/tribiq/.)

2. Unpack the archive

If you are working with on a local machine, use a utility to unzip (like Winzip on Windows). Mac users can double-click to open.

If you are working in Linux command-line, then use a utility like tar, e.g.

tar xvfz Community-5.1.tar.gz

3. Create a MySQL Database

If you use a control panel to manage your site, you may be able to create a MySQL database yourself. Otherwise may need to ask for a MySQL database to be created for you.

For this tutorial, we will assume you call your database "mytribiqsite".

You will also need to create a database user, we suggest you call this "tribiqcms".

If you have MySQL command-line console access as the mysql root user, you can create a database like this:

mysql> CREATE DATABASE tribiqdb DEFAULT CHARACTER SET utf8 COLLATE utf8_general_ci;

(Don't type the 'mysql> ' part, this is the prompt which you should see.)

Then create the database user, like this:

mysql> GRANT ALL ON tribiqdb.* TO tribiqcms@locahost IDENTIFIED BY 'password'; 

(Don't type the "mysql>" part, this is just the command-line prompt.)

4. Permit the Installer to write the config files

The Installer will attempt to write its configuration files into the siteconfigs directory. (These hold essential data like database connection parameters). You can make installation smoother by setting the permissions before running the Installer, otherwise it will inform you when it runs, of anything which needs to be changed.

On Windows, you probably won't need to do anything.

On a Linux/Un*x system, you will need to grant write-permission to certain files and directories. First go to your Tribiq CMS directory:

cd tribiq

Then set the write permissions like this:

chmod 666 siteconfigs/global.php 
chmod 666 siteconfigs/mysitename.php

5. Create the Downloads, Docstore, Dropbox and Backup directories

In order to store Documents, your CMS needs:

• a Docstore directory
• a Dropbox directory
• a Temporary Downloads directory

The CMS allows you to password-protect Documents. Therefore we recommend that the Docstore and Dropbox directories be kept outside of your webserver's "web" (Document Root) directory (so users cannot access Documents via a URL to the file itself).

(If your ISP doesn't allow you to have any directories other than your "web" directory, then you may create the Docstore and Dropbox inside your web directory. We don't recommend this.)

The same principles apply to the Backup directory. This is recommended but your CMS will function without a Backup directory.

First, make the Temporary Downloads directory writeable to the Apache web server:

cd tribiq 
chmod 777 tmp_downloads

To make the Docstore, Dropbox and Backup directories, go to a directory above the web directory, e.g.:

cd ..

Create the directories:

mkdir docstore 
mkdir dropbox 
mkdir backup

Then set the permissions to allow the CMS to write to the folders:

chmod 777 docstore 
chmod 777 dropbox 
chmod 777 backup

6. Use your browser to run the Installer

Use your browser to go to http://www.yourtribiqsite.com (or if you have a subdirectory add /tribiq/ or whatever subdirectory name you chose). Tribiq CMS sees the empty siteconfig files and thereby detects that it hasn't been configured yet. You should see this:

Welcome to Tribiq CMS
Tribiq CMS has not yet been installed.

After a few moments, this screen will refresh to the Start Installation screen.

Follow the installer instructions. If you have already followed Steps 3-5 above, this should take just a couple of minutes.

After a successful install, you should remove the "install" directory:

cd tribiq 
rm -rf install

Note

The MySQL Database User must have ALL permissions enabled, including the CREATE VIEW permission.

Occasional issues have been reported from users of certain Control Panels, in which not all MySQL database user permissions are set, and the Installer fails with a "Cannot create view" error. Despite the "ALL PRIVILEGES" setting being declared when the database user was created, the CREATE VIEW privilege has been omitted. This is a control panel bug, not a Tribiq CMS bug.