Agent Installation › Installing an Agent on AIX Systems › Deploying the First Agent › Installing an Agent Interactively

Installing an Agent Interactively

The prerequisites for installing a CA Enterprise Log Manager agent interactively are the same on any UNIX system.

Prerequisites include:

• The following information for entry during the installation process
  • Host name or IP address of the CA Enterprise Log Manager server to which the agent is to return events.
  • Agent authentication key configured in the CA Enterprise Log Manager server.
  • Name of the low-privileged user defined on the target host.
• The target host location of the agent installation tar file.

When you download the agent binaries from CA Enterprise Log Manager, you save the tar file to the host from which you opened the browser to access CA Enterprise Log Manager. Copy this file to the host where you plan to install the agent. Consider creating a directory on the target host under /usr and copying the tar file to /usr/<mydirectory>.

Important! In this guide, we refer to the directory containing the file you invoke to install the agent as the <install directory>.

The installation program installs the agent and creates the agent root directory, /opt/CA/ELMAgent. The installation program refers to /opt/CA/ELMAgent as the install path.

Install the Agent on an AIX Host

Installing a CA Enterprise Log Manager agent on an AIX system is done from the command line.

To install an AIX agent

1. Log on to the target host as root.
2. From the command prompt, navigate to the directory where you saved the agent tar binary file.
3. Run the following command:

   tar -xvf <tar_File_Name>
   

   The directory aix_ppc is created. The _AIX_install_support_ca-elmagent.tar, ca-elmagent-build_number.aix5.3.ppc.rpm, and install_ca-elmagent.sh files are extracted from the agent tar binary file in to aix_ppc.

4. Navigate to the aix_ppc folder, and run the following command:

   sh install_ca-elmagent.sh
   

   The license agreement appears.

5. Read the end-user license agreement. To accept, type Yes.
6. Enter the IP address or host name for the CA Enterprise Log Manager to which this agent forwards the logs it collects.

   Important! Enter the host name if the CA Enterprise Log Manager is assigned its IP address dynamically.

7. Enter the authentication key defined in the CA Enterprise Log Manager server.
8. Enter the agent username or, if root, press Enter.
9. Do one of the following:
   • If you want to run the Agent in FIPS mode, type YES and press Enter.
   • If you want to run the Agent in non-FIPS mode, type NO and press Enter.
10. Enter the full path to the ca-elmagent root directory, or press Enter to accept the default, /opt/CA/ELMAgent.
11. Do one of the following:
    • If you did not export the connector configuration file to this host, type No.

      Note: No is the typical response for the first installation.

    • If you did export Connector.xml, type Yes.

      A prompt that requests the default connectors configuration file path appears.

      1. Type the path.

         A message designed to determine the availability of the Connectors.xml file appears.

    The following message appears: Installation of <ca-elmagent> was successful. If you specified a low privileged user as the agent username, the installation process assigned required permissions.

Note: Technically, the agent service starts when the caelmwatchdog process successfully binds with the caelmagent process. To verify that a successful bind occurred or to troubleshoot a bind failure, see Troubleshooting Agent Installation.

More information

Troubleshooting Agent Installation

Verify Locally that the Agent is Running

Successful agent installation typically starts the agent service. Technically, the agent service starts when the caelmwatchdog process successfully binds with the caelmagent process.

You can determine whether the agent you installed is running while still logged on to the AIX host.

To verify locally that the agent service is running

1. Change directories to the agent root directory, /opt/CA/ELMAgent.
2. Enter the following:

   ps -eaf|grep caelm
   

3. Verify that the agent, caelmagent, is running. If two lines similar to the following example appear in the command results, the agent is running.

   root 16843 16809  0 17:58:11 ?         0:00 ./caelmwatchdog
   root 16809     1  0 17:57:57 ?         0:57 ./caelmagent -b
   

4. If the agent service is not running, see Troubleshooting Agent Installation for remedial action.

More information

Troubleshooting Agent Installation