Using Probekit in Standalone Mode on Solaris

Solaris platform icon This section provides step-by-step instructions for using Probekit in standalone mode on Solaris.

To use Probekit in standalone mode, the Agent Controller must be installed on the target system. The data collection agent and the extension library for Probekit are automatically installed with the Agent Controller.

Follow these steps to run your application using Probekit in standalone mode:

  1. Import a probe, or build your probe in the workbench.
  2. Copy all of the probe files to a folder on the target machine. If you are using multiple probes, concatenate the contents of the *.probescript files together into one *.probescript file.
  3. Add the folder that contains the probe files to the target machine's CLASSPATH.
  4. Add the RAC library folder and the Probekit plugin folder to the target machine's LD_LIBRARY_PATH:
    <racInstallDir>/lib
    <racInstallDir>/plugins/com.ibm.rational.pd.probekit/lib
  5. Add the following option string to the command line that launches your program:
    -XrunpiAgent:server=standalone,
    mode=none,
    extensionLibrary=ProbeAgentExtension.so,
    ext-pk-BCILibraryName=BCIEngProbe.so,
    ext-pk-probescript=<myProbe>.probescript
    where <myProbe> is the name of your probe's .probescript file.
    Note: The option string above is displayed on multiple lines for readability. When you include the option string on your command line, it must be all on one line, with no embedded spaces.
    To have the Probekit agent write log messages, add the following options to the command line:
    Option Description
    ext-pk-logFile=<file> Specifies the name of the file you want the Probekit agent to write log messages to. <file> can be a full path and filename. If you specify stderr instead of a filename, the log output will be written to the standard error channel. If this option is not specified, no log output is written.
    ext-pk-logLevel=<level> Specifies the logging level you want to use. See the table below for the logging levels and their descriptions.
    You can specify the following logging levels:
    Level Description
    none No log output.
    severe Logs only severe errors, such as unable to load libraries.
    warning Logs warning messages. This level is the default.
    info Logs status messages, such as "Initializing".
    config Logs configuration events and information, such as the contents of the .probescript file.
    finest Maximum log output. The log file will contain the name of every class that is instrumented by the Probekit agent.

Parent topic: Using Probekit in Standalone Mode

Terms of use | Feedback
(C) Copyright IBM Corporation 2000, 2005. All Rights Reserved.