Setting up UA for RAP - The Trading Edition Adapters

Unified Agent (UA) is a Java based agent that gathers statistics from a RAP publisher.

It uses JMX technology and runs parallel to the server it monitors or administers. Sybase recommends that you copy the bin/rap/ua directory and use a different ua directory for each running instance of a RAP adapter.

To start the UA agent and configure the RAP in-process or out-of-process adapter to package UA statistics:

  1. In bin/rap/ua/bin/myenv, set appropriate values for the following envars as specified in the "TODO" instructions at the top of the file:
    • SYBASE_UA
    • SYBASE_JRE
    • UA_RMI_PORT
    Note: UA_RMI_PORT in myenv should match the port property value in service-config.xml.
  2. In bin/rap/ua/plugins/com.sybase.rap.rapservice/agent-plugin.xml, set appropriate values for the following properties as specified in the file:
    • rap.service_host
    • rap.service_port
    • rap.service_startCommand
    • rap.service_pluginsubtype
    • rap.service_plugindisplayname
    If the bin/rap directory link points to the rap-r4 directory, set the following properties in agent-plugin.xml also:
    • rap.service_logFile
    • rap.service_configFileDir
    • rap.service_componentTemplateDir
  3. In in/rap/ua/service/RMI/service-config.xml, set the appropriate value for the following property as specified in the file:
    • port
    Note: The AdminPort node value in the adapter publisher.xml should match the rap.service_port property value in agent-plugin.xml.
Parent topic: RAP - The Trading Edition Adapters