Installation - Windows

Introduction

These instructions are for use in combination with WAMP5, a software distribution that installs the Apache web server, MySQL and PHP 5 for Windows.

However, you can also install DutchPIPE with separate or other web server, database and PHP 5 installations, for example IIS in combination with Microsoft SQL Server. This procedure just uses WAMP5 as an example and because of its fast, user friendly set-up.

In the example setup, we'll be installing DutchPIPE in c:\dutchpipe, WAMP5 in c:\wamp and make DutchPIPE available at http://localhost/, but you can use other locations of course.

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

Extract the files in c:\ so you now have the directory:

c:\dutchpipe

Step 3: Download and Install WAMP5

Download WAMP5 from:

http://www.wampserver.com/en/download.php

Launch what you have downloaded to start the installation process.

You can choose the installation folder. This step-by-step guide uses the default choice:

c:\wamp

You can choose to auto launch WAMP5 at startup, we didn't do that.

You can choose, if this is your first WAMP5 install, what directory contains your DocumentRoot. Choose:

c:\dutchpipe\public

You can choose whether you want to start WAMP5. Choose yes.

Step 4: Configure WAMP5

Now WAMP5 is running, an icon appeared on your tray bar at the bottom right of your screen.

Click on the WAMP5 tray bar icon and select:

PHP settings → PHP extensions → php_sockets

so that php_sockets is enabled.

To enable the avatar upload feature and in general faster image handling, select:

PHP settings → PHP extensions → php_gd2

so that php_gd2 is enabled.

Click on the WAMP5 tray bar icon and select:

Config files → httpd.conf

Notepad or your text editor is launched. Search for the line:

and change it to

Save the file.

Step 5: Configure DutchPIPE

Edit the following file:

c:\dutchpipe\config\dpserver-ini.php

Change the first pair of define's:

1. define('DPSERVER_HOST_URL', 'http://www.yourdomain.com');
2. //define('DPSERVER_HOST_URL', 'http://localhost');

to this:

1. //define('DPSERVER_HOST_URL', 'http://www.yourdomain.com');
2. define('DPSERVER_HOST_URL', 'http://localhost');

Check if the DPSERVER_SOCKET_PORT is a free port on your machine (3333 by default):

1. define('DPSERVER_SOCKET_PORT', '3333');

Change the port number if necessary.

Save the file.

Edit the following file:

c:\dutchpipe\config\dpuniverse-ini.php

Change these two lines:

1. define('DPUNIVERSE_MYSQL_USER', '<youruser>');
2. define('DPUNIVERSE_MYSQL_PASSWORD', '<yourpass>');

into:

1. define('DPUNIVERSE_MYSQL_USER', 'root');
2. define('DPUNIVERSE_MYSQL_PASSWORD', '');

Out of the box MySQL has been set up with a user 'root' and an empty password '', which you can use if you quickly want to complete setup, butin this case you should later secure MySQL by running the DutchPIPE database with another user and a password.

Check out and configure the $DPUNIVERSE_MDB2_* variables in dpuniverse-ini.php if you want to use a different database.

Save the file.

Step 6: Setup the database

Select at the bottom left of your screen:

Start → Run...

and enter the following line:

c:\wamp\php\php.exe -c c:\wamp\apache2\bin c:\dutchpipe\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 7: Restart WAMP5

Click on the WAMP5 tray bar icon and select at the bottom:

Restart All Services

Step 8: Start the DutchPIPE Server

Select at the bottom left of your screen:

Start → Run...

and enter the following line:

c:\wamp\php\php.exe -c c:\wamp\apache2\bin c:\dutchpipe\script\start_dpserver.php

The DutchPIPE server is now running in a Command Prompt window.

Step 9: Done

Launch your web browser and go to:

http://localhost/

You should see the standard DutchPIPE environment, exactly like the demo on:

http://demo.dutchpipe.org/