Previous Topic: The RegistryNext Topic: Simulator Server


Coordinator Server

Coordinator servers receive the test run information as documents, and coordinate the tests that run on one or more simulator servers. When you stage a test, you choose which coordinator server to coordinate the test from. You also specify a staging document that specifies which simulator servers to use when running instances of the test. Any coordinator server can launch instances on any simulator server (based on the staging document).

The coordinator server manages metric collection and reporting, and communicates the test data to DevTest Workstation for monitoring purposes. A DevTest Server environment can have, and commonly does have, multiple coordinator servers.

The coordinator server runs tests when presented with a staging document, test case, and configuration.

The lisa.coordName property sets the default name of a coordinator server.

lisa.coordName=Coordinator

The fully qualified name of a coordinator server is tcp://hostname-or-IP-address:2011/coordinator-name.

Create a Coordinator Server

To create a coordinator server, run this command:

LISA_HOME\bin\CoordinatorServer -n CoordinatorServerName -m RegistryName

The following examples create a coordinator server with the name coordinator1. The associated registry has the name registry1.

Valid on Windows

cd C:\DevTest\bin
CoordinatorServer -n coordinator1 -m tcp://localhost:2010/registry1

Valid on UNIX

cd DevTest/bin
./CoordinatorServer -n coordinator1 -m tcp://localhost:2010/registry1

You can add the coordinator to a named lab by using the -l option. If you do not specify the -l option, then the coordinator is added to the Default lab.

You can display the version number by using the --version option.

For information, see Running Server Components as Services in Administering.

Monitor Coordinator Servers

If DevTest Workstation is attached to the associated registry, then a running coordinator server appears in the Registry Monitor.

To monitor coordinator servers from the Registry Monitor:

  1. Click the Toggle Registry icon in DevTest Workstation.
  2. Click the Coord Servers tab.

The coordinator servers also appear in the network graph of the Server Console.

To monitor coordinator servers from the Server Console:

  1. Select View, Server Console, from the main menu of DevTest Workstation.
  2. Click the coordinator server in the network graph.

    A details window appears.