Topincs

Installation

The Topincs Server is placed on top of Apache HTTP Server 2, MySQL 5 and PHP 5 (AMP). This installation guide walks you through the whole process of setting up AMP and Topincs. It is recommended, but not required, to be familiar with the basics of setting up AMP.

Download

Apache HTTP Server 2

Download the latest stable Apache HTTP Server 2 (2.2 or 2.0). In case you use Windows, a binary package will do. For UNIX type operating systems the source packages are preferable.

MySQL

Download the latest stable MySQL Community Edition.

PHP 5

Download the latest stable PHP 5. For Windows use the zip package. Do not use the installer, since this will install the CGI version of PHP! For UNIX use the source packages.

Download the latest Topincs distribution.

Install

Apache HTTP Server 2

Install the Apache web server in the recommended directory. It will be referred to as APACHE_HOME from here. If you compile the sources, make sure you enable mod_rewrite, mod_env, mod_headers and disable mod_mime_magic.

MySQL

Install the MySQL database Database Server into MYSQL_HOME.

PHP

Unpack PHP 5 into PHP_HOME. If you compile the sources, make sure to enable mbstring and mysql.

Topincs

Unpack the distribution into a directory (e.g C:\Program Files or /usr/local). This will create a directory topincs, which will be referred to as TOPINCS_HOME from now on. Make sure the content of TOPINCS_HOME looks like this:

bin
conf
docroot
logs
php
resources
vendor
INSTALL
LICENSE
README
RELEASE_NOTES
VERSION

Windows only: If it is different from the above structure, your decompression program is not handling the distribution file right.

Configure

MySQL

Change into directory MYSQL_HOME/bin.

Windows only: Install MySQL as a service by executing mysqld.exe --install and start the service with net start MySQL.

Execute mysql -u root and change the password with

SET PASSWORD FOR 'root'@'localhost' = OLD_PASSWORD('123');

Replace 123 by a password of your choice. It will be referred to as MYSQL_PASSWORD from now on.

Append MYSQL_HOME/bin to your PATH.

PHP 5

If you follow the installation instructions under a UNIX operating system, you do not need to perform any additional configuration steps, so these steps apply to Windows only:

Set the environment variable PHPRC to PHP_HOME.

Append PHP_HOME to your PATH.

Edit PHP_HOME/php.ini, create if necessary: Add the lines

extension_dir="PHP_HOME\ext"
extension=php_mbstring.dll
extension=php_mysql.dll

Depending on your Windows version you might need to restart at this point.

Topincs

Change into directory TOPINCS_HOME/bin and execute the following command:

configure root MYSQL_PASSWORD

Replace MYSQL_PASSWORD by your MySQL password. This command will create the configuration files in the conf directory. It will also set up the initial store called topincs. Configure needs to be run only on the first installation. Copy the last line of the output into the clipboard, you will need it in the next step.

Apache HTTP Server 2

Edit APACHE_HOME/conf/httpd.conf. Activate PHP support in Apache and include the Topincs Apache configuration file. PHP has to be run as a module under Apache.

Add the following lines:

LoadModule php5_module PHP_HOME/php5apache2_2.dll
AddType application/x-httpd-php .php

Apache 2.0 only: Alter the previous lines and refer to the file php5apache2.dll instead of php5apache2_2.dll.


  
    Make sure mod_rewrite, mod_env, and mod_headers are enabled and mod_mime_magic
    is disabled. If you need mime_magic to be enabled, read the FAQ.
  
  
    At the end, add the line you copied in the previous step:
Include TOPINCS_HOME/conf/httpd.conf
  
    Restart Apache.
  
  Test
  
    Open your web browser and visit http://localhost/topincs/. Visit the Editor and login as test/test. If that
    works, close the browser window, drop the users System,
    Admin, and Test, and create an account for
    yourself. If you are new to Topincs, the server administration section in the
    manual will help you with that. You are now ready to use Topincs.