Remote configuration changes for CA NSM Agents without using Unicenter Configuration Manager.

Document ID : KB000052150
Last Modified Date : 14/02/2018
Show Technical Document Details

Description:

The solution explains the usage of ldconfig and agentctrl for remote Agent configuration control.

Solution:

To load, remove, and verify agent configuration remotely, use the following command line utilities that are available on every computer that has CA NSM System Agents installed.

In this example the scriptAgt is used.

  1. To create a configset from remote node REMOTENODE for agent scriptAgt

    • Verify the scriptAgt is running on REMOTENODE by running the command:

      orbctrl -@ REMOTENODE

      Figure 1

      Run the command: mkconfig scriptAgt@REMOTENODE > scriptagt.config

    • Edit the configset file scriptagt.config and update with your modifications.

    • Default configset name is bootstrap.

      Example: #CONFIGSET scriptAgt:bootstrap
              #SNMPGROUP generalGroup
              agentName                     Windows Script Agent r11.2.08178
              scriptTableCount             2
              .........................
  2. To load a configset to remote node REMOTENODE for agent scriptAgt

    Run the command: ldconfig -h REMOTENODE scriptagt.config

  3. To load multiple different configsets to remote node REMOTENODE for agent scriptAgt

    • You must use unique CONFIGSET Names

      Example: #CONFIGSET scriptAgt:scriptAgtconfig1

      #CONFIGSET scriptAgt:scriptAgtconfig2

    • After loading each configset, verify the proper existence on REMOTENODE:

      C:\>agentctrl -h REMOTENODE scriptAgt PRINT:ConfigSet:*

      scriptAgt:scriptAgtconfig2
      scriptAgt:scriptAgtconfig1

  4. To remove a configset from remote node REMOTENODE for agent scriptAgt

    Run the command: ldconfig -r -h REMOTENODE scriptAgt:scriptAgtconfig1

  5. To restart scriptAgt for REMOTENODE with new configset

    Run the following commands:

    servicectrl stop --name=scriptAgt --remote=REMOTENODE
    servicectrl start --name=scriptAgt --remote=REMOTENODE --options="-c scriptAgtconfig2"