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 your Data Collector installation is successful, complete the requirements before you install a 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,
CA Performance Management
 can be configured 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 Data Collector 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 Data Collector to gain access through a tenant firewall to poll the devices that are being managed.
    • Install Data Collector at each tenant site.
  • If Data Aggregator is IPv6 only, Data Collector must support the IPv6 protocol.
    To verify that Data Collector supports IPv6, take the following steps:
    • On the Data Aggregator host, type the following command to find the IPv6 address of the computer:
      > ifconfig
    • On the Data Collector host, type the following command to ensure that Data Collector can contact Data Aggregator using its IPv6 address:
      > ping6 
      ipv6_address_of_Data Aggregator
Verify the Prerequisites
Meet the following prerequisites before you install 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 Data Collector. By default, some Linux distributions enable this feature, which does not allow Data Collector to function properly. Disable SELinux or create a policy to exclude Data Collector processes from SELinux restrictions.
    For information about configuring 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 not deploying multi-tenancy, use the Default Tenant and the Default Domain.
  • The installer requires the zip and unzip packages. If these packages are not installed, use the following command to install them:
    yum -y install zip unzip
  • The Data Collector uses the "at" package to schedule the restart of the application when assigning a Tenant or IP Domain. Verify whether the "at" package is installed on each Data Collector host:
    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
(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 a command alias with the following permissions to the file:
    Cmnd_Alias CA_DATACOLL =  /tmp/install.bin,/sbin/service dcmd *, /opt/IMDataCollector/Uninstall/Uninstall, /opt/IMDataCollector/RemoteEngineer/
    ## 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.
    With the sudo user configured, and 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 one of the following steps:
    1. Type 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
    2. Type 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 /etc/hosts 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:
    service network restart
    The /etc/hosts file is configured correctly.
    The unique host name is set.
These ports must remain open locally for communication between the Data Aggregator and Data Collectors.