How to Install Tribiq CMS
1. Download from tribiq.com
Download the Tribiq CMS package (zip or tar.gz) onto the machine where you want to run your site.
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 package
Unpack the package. If you are working in Linux command-line, then use a utility like tar, e.g.
tar xvfz Community-5.2.2.tar.gz
3. 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 like this:
mysql> CREATE DATABASE tribiqdb;
Create the database user like this:
mysql> GRANT ALL ON tribiqdb.* TO tribiqcms@locahost IDENTIFIED BY 'password';
4. Permit the Installer to write the config files
Tip: if you perform Steps 4 and 5 before running the installer, you can make the installation process faster!
The Installer will attempt to write its configuration files (called global.php and mysitename.php) into the siteconfigs directory. These files hold essential data like database connection parameters.
On a Linux system, you will need to grant write-permission to these files. Go to your Tribiq CMS directory:
cd tribiqcms/
Then set the write permissions like this, so that the webserver can write to the files:
chmod 666 siteconfigs/global.php chmod 666siteconfigs/mysitename.php
5. Create the Docstore, Dropbox and Backup directories
Your CMS needs:
- a Docstore directory
- a Dropbox directory
- a Backups directory
We recommend that the Docstore, Dropbox and Backups 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.
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
Then make sure that your Temporary Downloads directory is writeable by the webserver. This directory already exists inside your tribiqcms directory, but its permissions may need to be changed.
You should make it writeable like this:
cd tribiqcms/
chmod 777 tmp_downloads
6. Run the Installer
Use your browser to go to the Tribiq CMS directory, i.e. http://www.yourtribiqsite.com, or if you have a subdirectory add /tribiq/.
In a fresh install, you will see this message:
Welcome to Tribiq CMS
Tribiq CMS has not yet been installed.
After a few moments, this screen will launch the Installer, which will check your system and write the config files.
Please note, we are soon going to do away with the CREATE VIEW requirement, as we are going to get rid of MySQL Views from Tribiq CMS.
This will be as of Tribiq CMS 5.1.1. The reason is that MySQL Views currently appear to be inefficiently handled, compared to other MySQL queries which get well optimized.