Installation
The Topincs Server is placed on top of Apache HTTP Server 2, MySQL 5 and PHP (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. In case you use Windows, a binary package will do. Apache 2.2 and PHP are not easy to set up under Windows, you are better off with Apache 2.0. For UNIX type operating systems the source packages are preferable.
MySQL
Download the latest stable MySQL Community Edition.
PHP
Download the latest stable PHP 4 or 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.
Topincs
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 4 or 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
stores
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');Append MYSQL_HOME/bin to your PATH.
PHP
PHP 4
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:
Copy php4ts.dll from PHP_HOME to PHP_HOME\cli.
Copy php4apache2.dll from PHP_HOME\sapi to PHP_HOME.
Set the environment variable PHPRC to PHP_HOME.
Append PHP_HOME/cli to your PATH.
Edit PHP_HOME/php.ini, create if necessary: Add the lines
extension_dir="PHP_HOME\extensions"
extension=php_mbstring.dllDepending on your Windows version you might need to restart at this point.
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.dllDepending 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_PASSWORDApache HTTP Server 2
Edit APACHE_HOME/conf/httpd.conf. Activate PHP support in Apache. PHP has to be run as a module under Apache.
PHP 4
Add the following lines:
LoadModule php4_module PHP_HOME/php4apache2.dll
AddType application/x-httpd-php .phpPHP 5
Add the following lines:
LoadModule php5_module PHP_HOME/php5apache2.dll
AddType application/x-httpd-php .phpMake 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.confRestart Apache.
Test
Open Firefox or Opera 9 and access http://localhost/topincs/. 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.
