The Part on the Web Server

You will need the following software packages in order to perform this part of the installation successfully:

  1. A working web server (preferably Apache under Linux).
  2. PHP 4.0.4pl1 or larger and compatible with compiled mysql, gd, imap4, xml, TTF (TrueType Fonts)
  3. Zend Optimizer™ (for free download at www.zend.com)
  4. Optional a domain or sub domain

For better clarity we divided the installation into several steps:

Step 1: Unpacking
Unpack the file „ps2002.tar.gz“ or „ps2002.zip“ which has been delivered or downloaded from our website. You can unpack the tar-version under Linux with the following commands:

gunzip _ps2002.tar.gz
tar –xvf _ps2002.tar

Under Windows you will need corresponding programmes to unpack the „tar.gz“ or the „ZIP“ format. After the file has been unpacked, there should exist the directory „_ps2002“ with miscellaneous subdirectories and files in the current directory. You could rename the current directory as you like. We assume the original name „_ps2002“ in the following.

Step 2: Adapt file authorisations
Basically the web server has to be able to read all data within the Portalsuite directory „_ps2002“ so that it can make the Portalsuite available also per web. We recommend to use the following commands under Linux for the Apache web server within the Portalsuite directory:

chgrp users * -R
chmod u+rw * -R
chmod g+rw * -R
chmod o+r * -R
chmod o-w * -R

Use the Windows-authorisation functions under Windows equivalent.

Furthermore the subdirectories „/tmp“ and „/media“ in the Portalsuite directory have to be added with writing accesses also for the Apache, since the Portalsuite applies data files there, partly temporarily, partly durable.

Step 3: Generation of the table structure
You find a file named ps2002.sql in the Portalsuite directory /global/install. This file contains instructions how to create tables for the SQL data base as well as instructions with which some tables get basic data.

Execute this instruction file. You can do this simplest from out off the prompt of the shell with the following command in the /global/install Portalsuite-directory:

mysql –h sqlserverip –u username –p ps2002 < ps2002.sql

„sqlserverip“, „username“ and „ps2002“ (the name of the data base) of course have to be replaced by the access data which are valid for your SQL server installation. After the password request and successful login all commands of the „ps2002.sql“ file are executed and several dozens of tables should be applied.

Step 4: Portalsuite configuration file
Next you have to deposit the access data for the data base in the configuration file, so that the Portalsuite can actually access the data base. Therefore edit the file „config.ini“ in the Portalsuite directory „/global/config“:

Presently DBSoftware always has to stand at „mysql“, since currently only „mysql“ is supported as data base. DBSoftware is already a variable for future extension on other data base systems. At „DBserver“ you enter the IP address of your SQL server. If the SQL server runs on the same server as the web server, the local address „127.0.0.1“ can be used. At „DBName“ please enter the chosen name of the data base, in our example we had chosen „ps2002“ during applying the data base. „DBUser“ and „DBCode“ stands for the user and the respective code for access onto the data base.

Step 5: Configure Portalsuite directory in the web server
Now you have to configure your web server in a way that the Portalsuite directory is accessible under an IP address or a domain. It is important that the Portalsuite directory acts as root directory, that means that the subdirectories there like – for instance - „admin“, „content“ etc. are accessible under the IP or the domain as subdirectories as well, e. g.: „http://192.168.211.2/admin“ etc. If you only enter the IP or the domain under which the Portalsuite directory is accessible, you should attain to the so-called Portalsuite Jumppoint. That is quasi about a menu page on which icons of the different Portalsuite applications are presented and linked.

Step 6: PHP 4.0.4pl1
Next please check if PHP version 4 is already installed correctly. Thereto we deposited a link „Show PHP version“ on the Jumppoint page. If you select this link you should get elaborate information on your PHP installation and version.
If the information page cannot be loaded correctly, you have either no PHP installed or the standard file extension „.php“ is not implemented correctly on the web server.
If the information page appears, please check if the modules „mysql“, „imap“ and „gd“ are supported (support has to stand at „enabled“). If the page does not appear, possibly you have to compile PHP newly and reinstall it. In so far as you are unfamiliar with these procedures you should consult your system administrator now.

Step 7: Check and - if necessary - install Zend Optimizer
Next please check if the Zend Optimizer is already installed correctly. Thereto you select the link „Show PHP version“ on the Jumppoint page again. In the third box of the information page, very likely still on the first screen page of the browser, you find the desired information (in the box there is the Zend logo on the right). If there is only something said about the „Zend Engine“ in the box, but nothing about the „Zend Optimizer“ is mentioned, the Zend Optimizer is not yet installed. If you get a message which corresponds with this one, the Zend Optimizer is installed:

This program makes use of the Zend scripting language engine:
Zend Engine v1.0.6, Copyright (c) 1998-2001 Zend Technologies
with Zend Optimizer v1.1.0, Copyright (c) 1998-2000, by Zend Technologies

The only important line is the third line. If it is included, the Zend Optimizer is installed and you can proceed with the next step.

If the „Zend Optimizer“ is not yet installed, please visit the website http://www.zend.com and simply download the „Zend Optimizer“ for free. Please make sure that you download the right Zend Optimizer suited for your operating system and your PHP version number ! The PHP version number is indicated on top of the PHP information page.
At best you follow the included Zend installation instructions now, but we have listed the most important steps in the following, too:
Under Unix / Linux:

  1. Unpack the downloaded and packed file.
  2. Copy the file ZendOptimizer.so into the system. The target directory suggested by Zend is „/usr/local/Zend/lib“ (apply directories before).
  3. Include the two lines into the php.ini (without leading or additional blanks and tabulators):

    zend_optimizer.optimization_level=15
    zend_extension="/usr/local/Zend/lib/ZendOptimizer.so"

    Note: Normally, depending on the Linux/Unix version, you find the php.ini file either in the directory /etc or in the directory /etc/httpd. But the exact position is also output on the PHP information page in the second box on top („configuration file (php.ini) path“).

  4. Afterwards you should reboot the web server application. If you use Apache, you normally will need the following commands:
    apachectl stop
    apachectl start
  5. Afterwards please check the PHP information page again.

Under Windows:

  1. Start the downloaded and packed file and follow the installation instructions.
  2. Afterwards you likely have to reboot your web server application.
  3. Afterwards please check the PHP information page again.

In case of errors or questions please consult the official documentation by Zend and the Zend website. Furthermore Zend provides some discussion forums in which you get support regarding the installation of the Zend Optimizer.