Starting the OLT server and viewer on separate workstations

When you start Object Level Trace, the OLT server and viewer are automatically started together since you would typically run these components on the same workstation. The OLT server, however, requires a significant amount of memory. When tracing a large application, you may want to run the OLT server separately from the viewer, on a more powerful machine.

The following steps assume that you intend to run your client application on one workstation, the OLT server on a second workstation, and the OLT viewer on a third workstation Your application server can be running on any of these machines or on a fourth machine.

To create a trace with the OLT server and viewer running on separate machines, complete the following steps.

Note: Some platforms only have the OLT Runtime (see Supported platforms and languages). For applications running on those platforms, traces can only be monitored from an AIX or Windows NT/2000 workstation.

On the machine where you intend to monitor the trace:

  1. From a command line, enter olt. The OLT server process starts and the viewer window opens.
  2. In the OLT viewer, select File > Preferences. A settings window opens.
  3. Select OLT. In the OLT server host name field, type the host name of the machine on which you plan to start the OLT server. Click OK.
  4. If you want the OLT server to listen for connecting OLT client on a port other than the default port (2102):
    1. In the OLT viewer, select File > Preferences. A settings window opens.
    2. Select OLT. In the OLT server TCP/IP port field, type the new port for the OLT server to listen on. Click OK.
  5. In the OLT viewer, select File > Exit. By closing the window, you save the OLT server location to the environment file (dertrenv.dat). This information is used when you next start the OLT viewer.

On the machine where you want to run the OLT server:

From a command line, enter the following command:

oltsrv -standalone

The OLT server process starts in a shell window (or korn shell on AIX or Solaris).

On the machine where you started the OLT viewer:

From a command line, enter olt. An OLT viewer window opens displaying the Client Controller page.

On the machine where you intend to run the client application:

  1. Start your client application.

    C++ client application:
    Start your C++ application from a command prompt.

    Java client application:
    At a command prompt, enter the java command that is appropriate for the level of JDK of the client application:

On the machine where you intend to monitor the trace:

  1. On the OLT viewer's Client Controller page, select the client id for the client application you started.
  2. Select Trace only from the list of execution modes.
  3. If you want all subsequent client applications registering with OLT to use the same settings, check the Use default settings for all clients box.

    If you do not check this box, a dialog box opens when the next client application attempts to register with OLT. To use the same settings, click Run. To change the settings for the application, click Change settings and do the following on the Client Controller page:

    1. Select the client id that corresponds to the client application you started.
    2. In the Debugger hostname field, enter the host name for the workstation on which you started the Debugger daemon. If you started the daemon on a port other than 8001, enter the new port number in the Debugger TCP/IP port field.
    3. Select Trace and debug from the execution mode list.
    4. Click Apply to apply the monitoring mode change.
  4. Click Apply to apply the monitoring mode change.
  5. Go to the OLT Trace page to start viewing the trace.

Note: The remote location you entered for the OLT server was saved to your OLT environment file (dertrenv.dat). In future, OLT looks for its server in the location specified by this file. If you decide to run the OLT server and viewer together again on this machine (or to run the OLT server in a location other than the one specified above), you must edit the dertrenv.dat file to point to the correct OLT server location. The dertrenv.dat file is located in your %userprofile%\DbgProf directory on Windows NT/2000, and the $HOME/.DbgProf directory on AIX.


Tracing a distributed application
Setting method breakpoints on the trace
Navigating the trace

ngrelc.gif (533 bytes)
How to read the trace


OLT troubleshooting
OLT troubleshooting - OLT environment file