Installation - *NIX

Step 1: Obtain the DutchPIPE software

Download the DutchPIPE distribution from:

http://download.dutchpipe.org/

You can either download the packed .zip or .tgz file.

Step 2: Unpack the DutchPIPE software

Unpack to the directory of your choice. In this example installation, we unpack to:

/path/to/dutchpipe

Relative paths in the remainder of these instructions are from the top of this path.

Step 3: Configure the DutchPIPE software

You must patch these settings files:

config/dpserver-ini.php
config/dpuniverse-ini.php

Follow the instructions in these files or see entries in the DutchPIPE for dpserver-ini.php and dpuniverse-ini.php.

Make sure the first line of

refers to the PHP command line installation. Make sure this file is executable (see man chmod under *NIX).

Step 4: Set up the database

Make sure the first line of

refers to the PHP command line installation. Make sure this file is executable (see man chmod under *NIX).

Run the script by entering in the shell:

script/setupdb.php

This script does not (yet) update an old installation. If you don't want to lose data, use a different database name in dpuniverse-ini.php.

Step 5: Configure your web server

If you already have a location to test DutchPIPE, you can skip step 5 and 6.

Decide on what URL you want to host your DutchPIPE installation. You need to let your web server know where to find the directory with the DutchPIPE public files.

There are many ways to add DutchPIPE, this is just one of them. In the example case, we added the following to the vhosts configuration file of Apache 2.2 in our FreeBSD 6 installation:

/usr/local/etc/apache22/extra/httpd-vhosts.conf

<VirtualHost *:80>
    ServerAdmin webmaster@yourdomain.com
    DocumentRoot /path/to/dutchpipe/public
    ServerName www.yourdomain.com
    <Directory "/path/to/dutchpipe/public">
        DirectoryIndex dpclient.php
        Options All
        AllowOverride All
        AddType application/x-httpd-php .php
        Order allow,deny
        Allow from all
    </Directory>
</VirtualHost>

Step 6: Restart your web server

For the example case:

/usr/local/etc/rc.d/apache22.sh restart

Step 7: Start the DutchPIPE server

For the example case:

cd script
./start_dpserver.php

It will output some memory and debug information, so you might want to try, for example:

./start_dpserver.php > mylog &

to throw everything in a log file called mylog and run the process in the background.

There is no proper restart script yet. Simply kill the process and start the script again to restart the server.

Step 8: Browse to your DutchPIPE public installation

In the example case: http://demo.dutchpipe.org/

You should now see an example DutchPIPE installation in your browser.