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

The silent response file contains the agent configuration parameters with default values that are defined for some parameters. You can edit the silent response file to specify different values for the configuration parameters.

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

Configure the IBM® Cloud agent in the silent mode:
  1. Open the ibm_cloud_silent_config.txt file at one of the following paths in a text editor.
    • Linux install_dir/samples/ibm_cloud_silent_config.txt

      Example, /opt/ibm/apm/agent/samples/ibm_cloud_silent_config.txt

    • Windows install_dir\samples\ibm_cloud_silent_config.txt

      Example, C:\IBM\APM\samples\ibm_cloud_silent_config.txt

    where install_dir is the path where the agent is installed.

  2. In the ibm_cloud_silent_config.txt file, specify values for all mandatory parameters and modify the default values of other parameters as needed.

    See Configuration parameters for the IBM Cloud agent for an explanation of each of the configuration parameters.

  3. Save and close the ibm_cloud_silent_config.txt file, and run the following command:
    • Linux install_dir/bin/ibm_cloud-agent.sh config instance_name install_dir/samples/ibm_cloud_silent_config.txt

      Example, /opt/ibm/apm/agent/bin/ibm_cloud-agent.sh config icloud-inst /opt/ibm/apm/agent/samples/ibm_cloud_silent_config.txt

    • Windows install_dir\bin\ibm_cloud-agent.bat config instance_name install_dir\samples\ibm_cloud_silent_config.txt

      Example, C:\IBM\APM\bin\ibm_cloud-agent.bat config icloud-inst C:\IBM\APM\samples\ibm_cloud_silent_config.txt

    where install_dir is the path where the agent is installed and instance_name is the name that you want to give to the agent instance.

    Important: Ensure that you include the absolute path to the silent response file. Otherwise, the agent data is not shown in the dashboards.
  4. Run the following command to start the agent:
    • Linux install_dir/bin/ibm_cloud-agent.sh start instance_name

      Example, /opt/ibm/apm/agent/bin/ibm_cloud-agent.sh start icloud-inst

    • Windows install_dir\bin\ibm_cloud-agent.bat start instance_name

      Example, C:\IBM\APM\bin\ibm_cloud-agent.bat start icloud-inst

    where install_dir is the path where the agent is installed and instance_name is the name of the agent instance.