Installing
The Topincs Server is placed on top of Apache HTTP Server 2, MySQL 5 and PHP 5 (AMP). For setting up AMP in your operating system follow the appropriate guide:
Installing Topincs
The installation must be performed as root. To see
whether your system is ready for installing Topincs, open a
browser at http://localhost. If the page says 'It
works!' your Apache is started. Then check on the command line
if php and mysql is available by running:
php --version mysql --version
Enable the Apache modules mod_rewrite,
mod_headers, and mod_env. Disable the
module mod_mime_magic. PHP needs
mbstring, mysql, and optionally
gmagick.
Download
the latest Topincs distribution. Make sure your decompression
program can handle tag.gz files and unpack the
distribution in TOPINCS_HOME.
Configure Topincs by running:
TOPINCS_HOME/bin/configure root MYSQL_PASSWORD http://www.example.com
Replace MYSQL_PASSWORD by your MySQL password. This command will
create the configuration files in
TOPINCS_HOME/conf. It will also set up the initial
store called topincs. The last parameter specifies the
domain you are accessing the Topincs stores under. If you are
accessing Topincs only on your local machine
http://localhost is the right choice. Append the
last line of the output of configure to
APACHE_HOME/conf/httpd.conf. If you have
virtual hosts configured you need to put it in the appropriate
section. The line looks similar to this:
Include "TOPINCS_HOME/conf/httpd.conf"
Hint: Ubuntu users need to make some adjustments.
Hint: Topincs can host any number of web databases, also called stores.
Restart Apache. Then open a web browser and visit http://localhost/topincs/. You are now ready to use Topincs.
