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 and unpack it in a directory of
your choice (e.g. /usr/local). The created
directory topincs will be referred to as the
installation directory or 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. The last parameter specifies the
server name you are accessing the Topincs stores under. If you
are accessing Topincs only on your local machine
http://localhost is the right choice. Include the
last line of the output of configure in your Apache
configuration, e.g. httpd.conf. If you are using a
virtual host you will need to put it in the appropriate
section. The line looks similar to this:
Include "TOPINCS_HOME/conf/httpd.conf"
Hint: Topincs can host any number of web databases, also called stores.
Restart Apache. You are now ready to create a Topincs Store. It
is highly recommended to setup an alias topincs for
TOPINCS_HOME/bin/topincs at this point.
