Java Device Test Suite Local Relay User’s Guide

This chapter describes how to install and update a local Relay on a tester host computer in these sections:

• Installing a Local Relay
• Updating a Local Relay

---

Installing a Local Relay

You can install a local Relay on a test harness host before or after installing the test harness. If a test harness has been installed it can be running or not.

Prerequisites

Before installing a local Relay, be sure the following are true:

• The local Relay host can read files in the Central Installation. In this chapter, the Central Installation is referred to as centralInstallDir. It contains ReleaseNotes.html, admin/, docs/, and other files and directories.
• The local Relay host meets the Relay Host requirements listed in the Java Device Test Suite Administration Guide. A local Relay requires roughly 50 megabytes less disk space than a shared Relay because the local Relay uses the shared Relay’s test-related files, such as media samples.
• You know the local Relay .war file’s path. The default name is centralInstallDir/admin/shared/resources/localRelay/JdtsServer.war, but the JdtsServer part of the name is different if your administrator chose a different application context name when installing the shared Relay. This chapter uses appContext for the application context name.

1. If a Sun Java System Application Server is not already installed on your harness host, use the administrator graphical installer to install a Sun Java System Application Server.

Refer to the Java Device Test Suite Administration Guide’s “Performing a Custom Installation” section. In the Choose Install Set screen, select Sun Java System Application Server.

You cannot use the Java Device Test Suite command line installer to install a Sun Java System Application Server.

2. Copy centralInstallDir/admin/shared/resources/localRelay/appContext.war to AppServerInstallDir/domains/domain1/autodeploy/.

3. Wait 30 seconds.

4. Verify that the local Relay is running by entering the following URL in a web browser: http://localhost:appServerPort/appContext/

For example: http://localhost:8080/JdtsServer/. If installation is successful, a “JDTS Relay Version is running” page appears with Relay Mode: Local.

---

Updating a Local Relay

After updating a Central Installation with a new version of the Java Device Test Suite, you must update all local Relays as follows:

1. Be sure the local Relay is running.

If you are not sure, enter the following URL in a web browser: http://localhost:appServerPort/appContext/

For example, http://localhost:8080/JdtsServer. If the Relay is running, a “JDTS Relay Version is running” page appears.

2. Copy
centralInstallDir/admin/shared/resources/localRelay/appContext.war to AppServerInstallDir/domains/domain1/autodeploy/.

The default appContext is JdtsServer.

3. Wait 30 seconds.

4. Verify that the local Relay is the new version by entering the following URL in a web browser: http://localhost:appServerPort/appContext/

For example, http://localhost:8080/JdtsServer. If updating is successful, a “JDTS Relay Version is running” page appears with Relay Mode: Local.

The tester harness uses the new Relay in the next test run.