Agent Installation Guide › Installing an Agent on AIX Systems › Maintaining Agents

Maintaining Agents

Maintenance tasks for CA User Activity Reporting Module agents include the following:

• Changing the agent user, if corporate policy mandates a change.
• Troubleshooting when agent installation is successful but the agent service is not started successfully
• Uninstalling an agent, where the procedures can differ depending on whether installation was interactive or silent

Note: For maintenance tasks such as applying subscription updates to agents and connectors, creating agent groups, and starting or stopping agents, see online help.

Troubleshooting Agent Installation

Occasionally, process binding does not take place as expected. Use the following procedure to diagnose this error and take corrective action.

To diagnose and correct a bind failure

1. Log on to the AIX host as root.
2. Change directories to the agent root directory, /opt/CA/ELMAgent.
3. Type the following command:

   ps - eaf|grep caelm
   

4. Examine the displayed results.
   • A successful bind results in a display similar to the following example. Here, the caelmwatchdog process ID 27773 successfully binds with the caelmagent process ID 27771. A successful bind starts the agent service.

     root 27773 27771   0 18:11:12 ?           0:00 ./caelmwatchdog
     root 27771     1   0 18:11:07 ?           0:02 ./caelmagent -b
     root 27793 26155   0 18:14:22 pts/1       0:00 grep caelm
     root 27772 27771   0 18:11:07 ?           0:00 ./caelmdispatcher
     

   • An unsuccessful bind results in a display similar to the following example. Here, the caelmwatchdog and caelmagent process IDs are not displayed and the agent service is not started.

     root 28386 26155   0 18:56:18 pts/1       0:00 grep caelm
     root 28300     1   0 18:51:39 ?           0:01 ./caelmdispatcher
     

     Note: If the caelmwatchdog binding to the caelmagent did not take place, kill the caelmdispatcher and start the agent service manually.

5. If you determine that the agent start was unsuccessful, do the following:
   1. To kill the caelmdispatcher, enter kill -9 <caelmdispatcher process ID>, for example:

      kill -9 28300
      

   2. Change directories to /opt/CA/ELMAgent/bin.
   3. Start the CA User Activity Reporting Module agent service.

      /S99elmagent start
      

      The message "CA ELM Agent Started Successfully" appears.

Note: View the agent status details again and verify that the agent is Running.