Install the Data Collectors

Install Data Collectors after you install Data Aggregator.
capm360
Install Data Collectors after you install Data Aggregator.
To install a Data Collector in silent mode, run the installation and create a response file. Use the response file to run future installations in silent mode. To generate the response file, follow the installation procedure, and add the response file argument when you run the install.bin file.
If you are installing multiple Data Collectors, install each Data Collector instance on a separate host.
If you are reinstalling a Data Collector, see Update the Data Collector.
Follow these steps:
  1. Log in to the Data Collector host either as the root user or the sudo user.
  2. Access the Data Collector installation package by doing one of the following actions:
    • If you have HTTP access to the Data Aggregator host
      and
      you are running an X Window System, open a web browser on the Data Collector host. Navigate to the following address and download the installation package:
      http://data_aggregator:port/dcm/install.htm
      • data_aggregator
        :
        port
        Specifies the Data Aggregator host name and the required port number.
        Default:
        8581, unless you specified a nondefault value during the Data Aggregator installation.
      Save the installation package to the /tmp directory.
    • If you have HTTP access to the Data Aggregator host and you are
      not
      running an X Window System, open a command prompt on the Data Collector host. Download the installation package to the /tmp directory using one of the following commands:
      • wget
        is available:
        wget -P /tmp -nv http://
        data_aggregator:port
        /dcm/InstData/Linux/VM/install.bin
        • data_aggregator
          :
          port
          Specifies the Data Aggregator host name and the required port number.
          Default:
          8581, unless you specified a nondefault value during the Data Aggregator installation.
      • wget
         is unavailable:
        curl -o /tmp/install.bin http://
        data_aggregator:port
        /dcm/InstData/Linux/VM/install.bin
    • If you do
      not
      have HTTP access to the Data Aggregator host, open a command prompt on a computer that
      does
      have HTTP access.
      1. Download the installation package to your Desktop directory using one of the following commands:
        • wget
           is available:
          wget -P ~/Desktop -nv http://
          data_aggregator:port
          /dcm/InstData/Linux/VM/install.bin
          • data_aggregator
            :
            port
            Specifies the Data Aggregator host name and the required port number.
            Default:
            8581, unless you specified a nondefault value during the Data Aggregator installation.
        • wget
           is unavailable:
          curl -o /tmp/install.bin http://
          data_aggregator:port
          /dcm/InstData/Linux/VM/install.bin
      2. Transfer the install.bin file to /tmp on the Data Collector host.
  3. Change to the /tmp directory:
    cd /tmp
  4. Change the permissions for the installation file:
    chmod a+x install.bin
  5. To run the console installation, do one of the following steps:
    • To run the installation as the root user, type the following command:
      ./install.bin -i console
    • To run the installation as the sudo user, type the following command
      sudo ./install.bin -i console
    To generate a response file for silent installation, add the following argument:
    -r
    response_file
    response_file
    specifies the directory the directory path and file name for the response file.
    Example:
    /temp/installer.properties
    Follow the prompts until you get to the summary, type "quit", and press Enter.
    To run the installation in silent mode, use the following command:
    ./install.bin -i silent -f
    response_file
    response_file
    is the directory path and file name of the previously generated response file.
  6. Follow the instructions in the console.
  7. When the installer prompts you for the Data Aggregator host information, specify the IP address or the hostname for Data Aggregator.
    Specify the Data Aggregator host information correctly. If you specify the Data Aggregator host information incorrectly, the Data Collector shuts down after installation. An error message is logged in the
    DC_installation_directory
    /apache-karaf-<
    vers
    >/shutdown.log file. Uninstall and reinstall Data Collector.
  8. When you are asked whether to associate this Data Collector with the Default Tenant, enter 'y' or 'n'.
    • If you are planning to deploy multi-tenancy, enter 'n'. You can then associate each Data Collector installation with a tenant.
    • If you are not deploying multi-tenancy, enter 'y'.
  9. (Optional) When prompted, specify the following parameters for fault tolerance. For more information, see Fault Tolerance.
    • Is the Data Aggregator configured with fault tolerance?
      If fault tolerance was configured for the Data Aggregators, specify 2 for Yes.
      Default:
      1
    • Inactive Data Aggregator Host/IP Address
      Specify the host name/IP address of the inactive Data Aggregator responsible for this Data Collector.
    Data Collector is installed, started, and connects to Data Aggregator.
    If you restart the Data Collector host, the Data Collector service automatically restarts and connects to Data Aggregator.
Verify the Installation
For the Data Collector installations, we use the static location of /opt/DCM.cfg to store where the Data Collectors are installed and the chosen installation options for upgrade.
Follow these steps:
  1. Verify that Data Collector is running on the Data Collector host:
    service dcmd status
  2. Review the the following log file on the Data Collector host:
    /opt/IMDataCollector/Logs/CA_Performance_Management_Data_Collector_install_
    timestamp
    .log
    If the installation is successful, the log shows 0 Warnings, 0 NonFatalErrors, and 0 FatalErrors.
    If the installation fails early enough in the process, the log file may be available in the home directory of the root or sudo user.
  3. Verify that the Data Collector connection is successful after the installation by doing the following actions:
    1. Log in to
      Performance Center
      as the global administrator.
    2. Navigate to the Data Aggregator administration view and expand the System Status view.
    3. Select Data Collectors from the menu.
    4. Verify that Data Collector appears in the list.
      The list can take several minutes to refresh and show the new Data Collector installation.
  4. Assign a tenant and IP domain to each Data Collector if the Tenant and IP Domain are blank:
    1. Select the Data Collector instance and click Assign.
    2. Select another tenant and an IP domain for this Data Collector in the Assign Data Collector dialog and click Save.