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.
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 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');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.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_PASSWORD
http://www.example.comhttp://localhost is the right choice. It is important
that you do only use this domain to access Topincs. Try to
communicate only one option to access the Topincs installation and
avoid any other option (like the IP address or alternative domain
names). This is important in order to recognize local item
identifiers which are not persisted. 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 .phpApache 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.confRestart 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.
