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 Cisco UCS agent in the silent mode, follow these steps:

1. In a text editor, open the cisco_ucs_silent_config.txt file that is available at the following path:

   • Linux:
     /samples/cisco_ucs_silent_config.txt

     Example:

     /opt/ibm/apm/agent/samples/cisco_ucs_silent_config.txt
     

   • Windows:
     install_dir\samples\cisco_ucs_silent_config.txt

     Example:

     C:\IBM\APM\samples\cisco_ucs_silent_config.txt
     

2. In the cisco_ucs_silent_config.txt file, specify values for all mandatory parameters. You can also modify the default values of other parameters. For more information about the configuration parameters, see the following topics:

   • Configuration parameters for the agent
   • Configuration parameters for the data provider

3. Save and close the cisco_ucs_silent_config.txt file, and run the following command:

   • Linux:
     /bin/cisco_ucs-agent.sh config /samples/cisco_ucs_silent_config.txt

     Example:

       /opt/ibm/apm/agent/bin/cisco_ucs-agent.sh config instance_name /opt/ibm/apm/agent/samples/cisco_ucs_silent_config.txt
     

   • Windows:
     \bin\cisco_ucs-agent.bat config \samples\cisco_ucs_silent_config.txt

     Example:

       C:\IBM\APM\bin\cisco_ucs-agent.bat config instance_name C:\IBM\APM\samples\cisco_ucs_silent_config.txt
     

     Where
     instance_name: The name that you want to give to the instance.
     install_dir: Path where the agent is installed.

     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:
     /bin/cisco_ucs-agent.sh start instance_name

   Example:

   /opt/ibm/apm/agent/bin/cisco_ucs-agent.sh start instance_name
   

   • Windows:
     \bin\cisco_ucs-agent.bat start instance_name

   Example:

   C:\IBM\APM\bin\cisco_ucs-agent.bat start instance_name
   

   Where,
   instance_name: Name that you want to give to the instance.
   install_dir: Path where the agent is installed.

What to do next

• Log in to the IBM Cloud Pak console to view the data that is collected by the agent in the dashboards. For more information about using the console, see Starting the Cloud App Management UI.
• If you are monitoring a large Cisco UCS environment, you might need to increase the heap size for the Java™ data provider. For more information, see Increasing the Java heap size.