Configuring the agent by using the silent response file

The silent response file contains the agent configuration parameters. You can edit the silent response file to modify the values of these parameters, and run the configuration script to create an instance and update the agent configuration values. This mode of configuration is called the silent mode.

About this task

You can use the silent response file to configure the PostgreSQL agent on Linux® and Windows systems. After you update the configuration values in the silent response file, you must run the configuration script to configure the agent with these updated values.

Procedure

To configure the agent by editing the silent response file and running the script without responding to prompts, complete the following steps:
  1. In a text editor, open the silent response file that is available in this path: install_dir/samples/postgresql_silent_config.txt where install_dir is the installation directory of PostgreSQL agent. The default installation directory is /opt/ibm/apm/agent.
  2. To edit the silent configuration file, complete the following steps:
    1. For the PostgreSQL Server IP Address parameter, specify the IP address of a PostgreSQL server that you want to monitor remotely. If the agent is installed on the server to be monitored, retain the default value.
    2. For the JDBC database name parameter, specify a database name to change the default database name of postgres.
    3. For the JDBC user name parameter, specify a user name to change the default name of postgres.
    4. For the JDBC password parameter, enter the JDBC user password.
    5. For the JDBC port number parameter, specify a port number to change the default port number of 5432.
    6. For the JDBC JAR file parameter, specify the path for the PostgreSQL connector for the Java™ JAR file
      Important: The version of the JDBC JAR file must be compatible with the version of the PostgreSQL database that is being monitored.
    7. For the Java trace level parameter, specify the trace level according to the IBM® support instructions. The default trace level is Error.
  3. Save and close the silent response file, and run the following command:
    install_dir/bin/postgresql-agent.sh config 
instance_name 
install_dir/samples/postgresql_silent_config.txt

    Where instance_name is the name that you want to give to the instance.
  4. To start the agent, enter the following command:
    install_dir/bin/postgresql-agent.sh start instance_name

What to do next

Log in to the Cloud APM console to view data that is collected by the agent in the dashboards. For information about using the Cloud APM console, see Starting the Cloud APM console.

For help with troubleshooting, see the Troubleshooting section.