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

To configure the JBoss agent in the silent mode, complete the following steps:
  1. In a text editor, open the jboss_silent_config.txt file that is available at the following path:
    • Linux or AIXinstall_dir/samples/jboss_silent_config.txt

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

    • Windowsinstall_dir\samples\jboss_silent_config.txt

    where install_dir is the path where the agent is installed.

    The default install_dir paths are listed here:
    • Linux/opt/ibm/apm/agent
    • WindowsC:\IBM\APM\TMAITM6_x64
    ExampleLinux or AIX
    /opt/ibm/apm/agent/samples/jboss_silent_config.txt
    Windows
    C:\IBM\APM\samples\jboss_silent_config.txt
  2. In the jboss_silent_config.txt file, specify values for all mandatory parameters. You can also modify the default values of other parameters.

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

  3. Save and close the jboss_silent_config.txt file, and run the following command:
    • Linux or AIXinstall_dir/bin/jboss-agent.sh config instance_name install_dir/samples/jboss_silent_config.txt
    • Windowsinstall_dir\bin\jboss-agent.bat config instance_name install_dir\samples\jboss_silent_config.txt

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

    The default install_dir paths are listed here:
    • Linux/opt/ibm/apm/agent
    • WindowsC:\IBM\APM\TMAITM6_x64
    Important: Ensure that you include the absolute path to the silent response file. Otherwise, the agent data is not shown in the dashboards.
    Example Linux or AIX
    /opt/ibm/apm/agent/bin/jboss-agent.sh config example-inst01 /opt/ibm/apm/agent/samples/jboss_silent_config.txt
    Windows
    C:\IBM\APM\bin\jboss-agent.bat config example-inst01 C:\IBM\APM\samples\jboss_silent_config.txt
  4. Run the following command to start the agent:
    • Linux or AIXinstall_dir/bin/jboss-agent.sh start instance_name
    • Windowsinstall_dir\bin\jboss-agent.bat start instance_name

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

    The default install_dir paths are listed here:
    • Linux/opt/ibm/apm/agent
    • WindowsC:\IBM\APM\TMAITM6_x64
    ExampleLinux or AIX
    /opt/ibm/apm/agent/bin/jboss-agent.sh start example-inst01
    Windows
    C:\IBM\APM\bin\jboss-agent.bat start example-inst01