From OpenSource

NOTE If you have Raccoon or an earlier version of PAMP installed, your should uninstall them before installing the new version. Be certain to save any important files you might have.

Contents 1 Installation 1.1 Standalone PAMP 1.2 PAMP my MWS 1.3 Optional Files 2 Running 2.1 Smoketest 1 2.2 Smoketest 2 2.3 Smoketest 3 2.4 MWS Smoketest

Installation

Download pamp_1_0_2.zip from SourceForge.

The zip file contains:

• pips_s60_1_3_SS.sis
• ssl.sis
• pamp_1_0_2.sis

The first two are part of Open-C.

NOTE The PAMP sis is a composite file containing many sis-files, several of which contains numerous files. After the license screens, there will be a significant delay before the installation proceeds and the phone may appear frozen. Just wait; patience is a virtue.

PAMP can be installed as stand-alone or on top of MWS. In the former case it is, well, stand-alone, and in the latter case it augments the Apache httpd web-server of MWS. After the installation of PAMP you will basically be able to host PHP sites under MWS in addition to Python sites. The recommendation is to install PAMP on top of MWS.

NOTE If you want to play with both PAMP and MWS separately, you need two devices. They cannot be installed independently on the same device.

Standalone PAMP

• Install pips_s60_1_3_SS.sis and ssl.sis.
• Install pamp_1_0_1.sis.

The installation will create the following new directories:

• c:\data\apache - the ServerRoot of Apache httpd.
• c:\data\php - the location of PHP's ini file.
• c:\data\mysql - the location of MySQL's configuration file.
• c:\mysql - the location of MySQL databases.
• e:\data\apache\htdocs - the DocumentRoot of Apache httpd.

NOTE DocumentRoot is always on E:, so you cannot install PAMP on a device that lacks a memory card. However, after the installation, DocumentRoot can be made to point elsewhere.

PAMP my MWS

In the following it is assumed that you already have MWS installed.

• Install pamp_1_0_2.sis

The installation will create the following directories:

• c:\data\php - the location of PHP's ini file.
• c:\data\mysql - the location of MySQL's configuration file.
• c:\mysql - the location of MySQL databases.

The DocumentRoot continues to be c:\data\web server, e:\data\web server, or f:\data\web server, depending on where MWS was installed.

After the installation you will find one new applications on your phone; Pamp.

NOTE Always install MWS first, and then PAMP. Installing the other way around, if it even succeeds, will not work.

Optional Files

FExplorer

You will want to be able to make minor modifications to httpd.conf and php-ini directly on the phone and for that you need a decent editor. FExplorer is a pretty nice editor for S60, so don't be put off by the bling-bling-ness of its website and the fact that you need to sign it yourself.

PED

Ped is another editor that actually is a Python programmer's editor. You need to have PyS60 installed.

MySQL

In order to be able to directly interact with the MySQL server running on the phone you need to install MySQL on your laptop. Download the right version for your OS from MySQL.

NOTE Depending on the PHP packages you intend to install on top of PAMP, you may or may not actually need to do this. It won't harm though and is quite convenient.

Running

Smoketest 1

1. Start Pamp
2. Invoke [Options]->[Start]->[Pamp]
3. Wait until both Apache and MySQL says Running
4. Start the browser on the phone.
5. Browse to http://127.0.0.1 (stand-alone) or http://127.0.0.1/php (MWS).

You should be greeted with a page that says It works!.

Next you can click on the link phpinfo.php to find out what PHP of PAMP has eaten. The other links refer to sites of different CMSs and are not served from your phone.

Smoketest 2

1. Ensure that Pamp is running.
2. Invoke [Options]->[Start WLAN] and select an approriate WLAN access point. Check here for more information about WLAN access points.
3. Connect your laptop to the same WLAN.
4. Type http://address (stand-alone) or http://address/php (MWS) in your browser, where address is the IP address shown on the Pamp screen. Note that if you have a firewall on your laptop you may have to explicitly enable that address.

You should be greeted with the same It works! as in the previous step.

Smoketest 3

1. Ensure that Pamp is running.
2. Invoke [Options]->[Start WLAN] and select an approriate WLAN access point.
3. Connect your laptop to the same WLAN.
4. Enter mysql -h address, where address is the IP address shown on the Pamp screen, in a command prompt on your PC. Note that if you have a firewall on your laptop you may have to explicitly enable that address.

You should be greeted with:

Welcome to the MySQL monitor.  Commands end with ; or \g.
Your MySQL connection id is 1
Server version: 5.0.67 Source distribution

Type 'help;' or '\h' for help. Type '\c' to clear the buffer.

mysql>

You are talking with MySQL running on your phone.

MWS Smoketest

1. Ensure that PAMP is not running.
2. Start MWS
3. When MWS is running, start PAMP and invoke [Options]->[Start]->[MySQL].
4. Do the browsing part of smoketests 1 and 2, but this time, use your MWS provided address.

If you just want to play with PAMP in a WLAN context, you can start PAMP directly via [Options]->[Start]->[Pamp] and then [Options]->[Start WLAN]. If you subsequently want to start MWS, stop httpd via PAMP first.

Next you can continue with connectivity and PHP package issues.