Configuring the agent by using the command line interface

Edit online

You can configure the Monitoring Agent for Sybase Server by using the command line interface.

Before you begin

The Sybase agent does not support remote configuration. Hence, you need to ensure that the Sybase server is installed on the same host where the Sybase agent is installed.

The Sybase agent supports Sybase Server version 15.7 and 16.0 only.

The user ID that is used to connect to the database server is created.

About this task

The Sybase agent is a multiple instance agent, you must configure and start each agent instance manually.

Procedure

  1. Run the following command to configure the agent.
    • Windows
      install_dir\bin\sybase-agent.bat instance_name
    • UNIX
      install_dir/bin/sybase-agent.sh instance_name
    Where:
    • install_dir is the agent installation directory.
    • instance_name is the Sybase server instance name.
    Note: Sybase agent does not support Sybase server instance names with special characters, on non-windows platform.
  2. When you are prompted to provide values for the following parameters, press Enter to accept the default value, or specify a value and press Enter.
    1. For the Home Directory parameter, enter the path of the Sybase server home directory path.
      • Windows

        The example of Home Directory is C:\sybase.

      • UNIX

        The example of Home Directory is /opt/sybase.

    2. For the Open Client Directory parameter, enter the Sybase open client installation location.
      • Windows

        The example of Open Client Directory is C:\sybase\ocs-16_0.

      • UNIX

        The example of Open Client Directory is /opt/sybase/ocs-16_0.

    3. For the USER ID parameter, enter the user ID that is used by the monitoring agent to connect to the Sybase server.

      The default USER ID is tivoli.

    4. For the PASSWORD parameter, enter the password of the user ID that is used by the monitoring agent to connect to the Sybase server.
    5. For the VERSION parameter, enter the Sybase server version.

      The Sybase agent supports Sybase server versions 15.7 and 16.0 only.

    6. For the ERROR LOG FILE parameter, enter the fully qualified file name of the error log file for the Sybase server.
      • Windows

        The example of the ERROR LOG FILE is C:\sybase\ASE-16_0\install\servername.log.

      • UNIX

        The example of the ERROR LOG FILE is /opt/sybase/ASE-16_0/install/servername.log.

      Where servername is the Sybase server name.
    7. For the EXTENDED parameter, enter the extended parameter that is used by support to exclude certain cursor execution. Optionally, press Enter without specifying any values to execute all cursors.
      The options for the EXTENDED parameter are DBD2,DBD15,KOYSEGD.
      • DBD2 will exclude cursor execution for datasets Sybase_Database_Detail and Sybase_Database_Summary.
      • DBD15 will exclude cursor execution for dataset Sybase_Database_Detail.
      • KOYSEGD will exclude cursor execution for dataset Sybase_Segment_Detail.

What to do next

When the configuration is completed, you can start the monitoring agent and connect the monitoring agent to the Performance Management server.

To start the Sybase agent, use the agent command sybase-agent command.

To connect the Sybase agent to the Performance Management server, use the agent2server command.

For more information about the sybase-agent and agent2server , see Using agent commands in https://www.ibm.com/support/knowledgecenter/SSHLNR_8.1.4/com.ibm.pm.doc/welcome.htm.