Installing software for remote testing

The following sections desribe how to install, configure and run the software required on both the Client and Server sides to be able to execute tests remotely using TestDriver.

When setting up your Client-Server configuration in order to run tests remotely over a WAN or LAN, the following additional components are required.

Hardware requirements

To be able to run test packages remotely, you will need the following hardware setup:

• Two PCs, one client and one server, connected via a WAN or LAN.

• Lubbock development board with keypad, powered by a switch able external ATX power supply with parallel adapter connected to the server.

• Null modem cable, for connecting the Lubbock development board with the server.

Software requirements for Client PC

• Windows 2000

• JRE 1.4.2 (available from http://java.sun.com/j2se/1.4.2/download.html)

• TestDriver

• TestClient.

Software requirements for Server PC

• Windows 2000

• JRE 1.4.2 (available from http://java.sun.com/j2se/1.4.2/download.html)

• TestDriver

• TestMaster.

Each PC Client used will need to have TestDriver and TestClient installed.

The TestDriver tool is used for building the test packages and submitting them to the remote server for execution. TestDriver is provided on the Symbian OS Development Kit and can be found under epoc32\tools\TestDriver.

To install TestDriver, perform the following steps:

• Unzip testdriver.zip to the root of your C:\ drive. A test driver folder is then created in this location.

• Add C:\testdriver\bin to your PATH environment variable.

More information on installing TestDriver is available in Installing and configuring TestDriver.

Once the test package has been created, it is passed to the TestClient by the TestDriver, together with the ROM image. The TestClient is then responsible for creating a test job for the test, and submitting it to the remote TestMaster.

The TestClient is provided with the Development Kit and can be found under epoc32\tools\TestDriver\TestClient.zip.

To install the TestClient, perform the following steps:

• Unzip the testclient.zip file to the C:\TestDriver folder.

  A config subdirectory is then created, in which you will find a client.properties file.

• Modify this file to include the name of the server hosting the TestMaster (for example lon-test01) using the following syntax:

  master.host.name=YourServerHostName

The PC to be used as the server will need to have TestDriver and TestMaster installed.

The TestDriver must be installed in order for the TestMaster to be able to run tests. To install TestDriver, follow these steps:

• Unzip testdriver.zip to the root of the C: drive on the server machine. A TestDriver folder is then created in this location.

• Add C:\testdriver\bin to your PATH environment variable.

More information on installing TestDriver is available in Installing and configuring TestDriver.

The TestMaster is available on the Symbian OS Development Kit under epoc32\tools\TestDriver\TestMaster.zip.

To install TestMaster, follow these steps:

• Unzip the TestMaster.zip file to the C:\TestDriver folder.

  A config subdirectory is then created, in which you will find a master.properties file.

• Modify the master.properties file to include the name of the server hosting the TestMaster (for example lon-test02) using the following syntax:

  master.host.name=YourServerHostName

To run TestMaster, simply follow these instructions:

• Start the TestMaster by double-clicking on C:\testdriver\RunMaster.bat.

If TestMaster is running correctly, you will see the following output:

TestMaster starting up...
Host: YourServerHostName
RMI Service: RemoteTestDriver
Executor: Waiting for a job.
TestMaster running.

• Introduction to running tests remotely

• How to run test packages remotely

• Installing and configuring TestDriver

• Using TestDriver