Prepare to Install the Data Collectors

To ensure that your data collector installation is successful, complete the requirements before you install a data collector.
To ensure that the data collector installation is successful, complete the following requirements before you install the data collector:
Review Data Collector Considerations
In a standard tenant deployment, each tenant has a dedicated data collector. For multiple tenants that reside in the same IP routing space, you can configure
CA Performance Management
to use fewer data collectors.
For more information, see Tenant-Agnostic Data Collectors.
The following considerations apply to a standard tenant deployment:
  • You can install more than one data collector. Each must be installed on a separate host.
  • In a standard tenant deployment, a data collector supports only one data aggregator.
  • In a multi-tenant environment where a managed service provider is monitoring devices for multiple tenants, you can take the following steps:
    • Install data collector at the MSP site.
      This setup requires the data collector to gain access through a tenant firewall to poll the managed devices.
    • Install the data collector at each tenant site.
  • If only the data aggregator is IPv6, the data collector must support the IPv6 protocol.
    To verify that data collector supports the IPv6 protocol, take the following steps:
    • On the data aggregator host, find the IPv6 address of the computer by issuing the following command:
    • On the data collector host, ensure that the data collector can contact the data aggregator using its IPv6 address by issuing the following command:
Verify the Prerequisites
Meet the following prerequisites before you install the data collector:
  • On the data aggregator system, verify that ports 61616, 61618, 61620, and 61622 are open. These ports enable communication between the data collector and the data aggregator.
  • Verify that ports 1099 and 11099 are blocked from external access. These ports must remain open locally for internal communication.
  • Verify that Security Enhanced Linux (SELinux) is disabled on the computer where you are going to install the data collector. By default, some Linux distributions enable this feature, which does not allow the data collector to function properly. Disable SELinux or create a policy to exclude data collector processes from SELinux restrictions.
    For information about how to configure an SELinux security policy, see the Red Hat documentation.
  • To avoid database corruption of ActiveMQ broker files, exclude the installation directory, and all its subdirectories, from antivirus scans. Prevent scanning by a local instance of an antivirus client and scanning by a remote antivirus instance.
  • Ensure that your desired tenant and corresponding IP domain are provisioned in
    CA Performance Center
    . While a single IP domain can be associated with more than one data collector, each data collector can have only one IP domain assigned to it.
    If you are deploying standard tenancy, use the default tenant and the default domain.
  • The installer requires the zip and unzip packages. If these packages are not installed, issue one of the following commands to install them:
    yum -y install zip unzip
    zypper install -y zip unzip
  • The data collector uses the
    package to schedule the restart of the application when assigning a tenant or IP domain. Verify whether the
    package is installed on each data collector host by issuing the following command:
    rpm -qa | grep ^at
    If the command does not return a result, install the package:
    If you are not the root user, use the sudo prefix.
    yum install at
    zypper install -y at
(Optional) Configure the Sudo User Account for Data Collector
If you do not have root access to install and run the data collector, configure the sudo user account.
Follow these steps:
  1. Locate the following file on the data collector host:
  2. Add one of the following command aliases with the following permissions to the file:
    • Default:
      Cmnd_Alias CA_DATACOLL = /tmp/install.bin,/sbin/service dcmd *, /opt/IMDataCollector/Uninstall/Uninstall, /opt/IMDataCollector/RemoteEngineer/, /opt/IMDataCollector/scripts/dcmd, /usr/bin/crontab
      ## Allows the <caimdc> user to manage the <caimdc>
      • sudouser
        Specify the user who can run the sudo commands.
        This command alias details the commands that the sudo user must be able to run.
    • SLES:
      Cmnd_Alias CA_DATACOLL = /tmp/install.bin,/usr/sbin/service dcmd *,/usr/sbin/service activemq *,/opt/IMDataCollector/Uninstall/Uninstall, /opt/IMDataCollector/RemoteEngineer/, /opt/IMDataCollector/scripts/dcmd, /usr/bin/crontab
      ## Allows the <caimdc> user to manage the <caimdc>
      • sudouser
        Specify the user who can run the sudo commands.
        This command alias details the commands that the sudo user must be able to run.
  3. With the sudo user configured, add the sudo prefix to all commands to install the data collector.
    sudo ./install.bin
Configure UTF-8 Support
Configure the data collector host to support UTF-8 encoding. If UTF-8 encoding is not enabled, characters might not display properly during the installation.
The appropriate language packs are also required to support localized deployments.
Some scripts that are used in the installation of selected components are not localized and run in English.
For more information, see the
Localization Status Readme
Follow these steps:
  1. Do
    of the following steps:
    • Issue the following command from a Korn or bash shell:
      export LANG=LANG_value ; export LC_ALL=$LANG
      • LANG_value
        specifies the value of the language you want the product to support. The following variables are supported:
        Simplified Chinese:
        Traditional Chinese:
      For example:
      export LANG=zh_TW.utf8 ; export LC_ALL=$LANG
    • Issue the following command from a Bourne shell:
      ; export LANG
      ; export LC_ALL
      For example:
      LANG=zh_CN ; export LANG
      LC_ALL=zh_CN ; export LC_ALL
    The language variable is set.
Set a Unique Hostname for the Data Collector Host
Set a unique hostname for the computer where you plan to install data collector.
Follow these steps:
  1. As the root user, log in to the data collector host.
  2. Verify the unique hostname on the computer.
    The hostname for the computer must be associated with the IP address and
    the loopback address of
  3. Verify that the following lines appear in the
    file on the computer:
    Do not remove the following line, or various programs
    # that require network functionality will fail. localhost localhost.localdomain localhost4 localhost4.localdomain4
    ::1 localhost localhost.localdomain localhost6 localhost6.localdomain6
    IP address of your host YourHostName
  4. If the hostname required any changes, restart the network by issuing the following command:
    service network restart
    file is configured correctly.
    The unique host name is set.
These ports must remain open locally for communication between the data aggregator and the data collectors.