Configuring the agent by using the command line interface

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 config instance_name
     

   • Unix:

     install_dir/bin/sybase-agent.sh config instance_name
     

     Where:
     install_dir is the agent installation directory.
     instance_name is the Sybase Server instance name.

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.

   a. For the Home Directory parameter, enter the path of the Sybase Server home directory path.

   • Windows:
     The example of Home Directory is C:\sap.

   • Unix:
     The example of Home Directory is /opt/sap.

   b. For the Open Client Directory parameter, enter the Sybase open client installation location.

   • Windows:
     The example of Open Client Directory is C:\sap\ocs-16_0.

   • Unix:
     The example of Open Client Directory is /opt/sap/ocs-16_0.

   c. 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.

   d. For the PASSWORD parameter, enter the password of the user ID that is used by the monitoring agent to connect to the Sybase Server.

   e. For the VERSION parameter, enter the Sybase Server version. The Sybase agent supports Sybase Server versions 15.7 and 16.0 only.

   f. 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:\sap\ASE-16_0\install\servername.log.

   • Unix:
     The example of the ERROR LOG FILE is /opt/sap/ASE-16_0/install/servername.log.

   Where, servername is the Sybase Server name.

   g. 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.