Install the Data Collectors

Install the data collectors after you install Data Aggregator.
Install the data collectors after you install the 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 based on your configuration:
    • (If you have HTTP access to the data aggregator host
      and
      you are running an X Window System) Complete the following steps:
      1. Open a web browser on the data collector host.
      2. Navigate to the following address, and then 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 non-default value during the data aggregator installation.
          For more information about the data aggregator server ports that should be open to allow
          DX NetOps Performance Management
          communications to function properly, see Installation Requirements and Considerations.
      3. 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) Complete the following steps:
      1. Open a command prompt on the data collector host.
      2. Download the installation package to the
        /tmp
        directory based on your configuration:
        • (If
          wget
          is available) Issue the following command:
          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 non-default value during the data aggregator installation.
        • (If
          wget
          is unavailable) Issue the following command:
          curl -o /tmp/install.bin 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 non-default value during the data aggregator installation.
    • (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:
        • (If
          wget
          is available) Issue the following command:
          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.
        • (If
          wget
          is unavailable) Issue the following command:
          curl -o /tmp/install.bin http://
          data_aggregator:port
          /dcm/InstData/Linux/VM/install.bin
      2. Transfer the
        install.bin
        installation file to
        /tmp
        on the data collector host.
  3. Change to the
    /tmp
    directory by issuing the following command:
    cd /tmp
  4. Change the permissions for the installation file by issuing the following command:
    chmod a+x install.bin
  5. To run the console installation, do
    one
    of the following steps:
    • Run the installation as the root user by issuing the following command:
      ./install.bin -i console
    • Run the installation as the sudo user by issuing the following command:
      sudo ./install.bin -i console
    • Run the installation in silent mode by issuing 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.
      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 then press
      Enter
      .
  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 the 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 the data collector.
  8. When you are prompted 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 you have configured a fault-tolerant environment, specify
      2
      for Yes.
      Default:
      1
    • Inactive Data Aggregator Host/IP Address
      Specify the host name or IP address of the inactive data aggregator responsible for this data collector.
      For more information about how to view this information, see View the Health of the System.
The data collector is installed, started, and connects to the data aggregator.
If you restart the data collector host, the data collector service automatically restarts and connects to the data aggregator.
Verify the Installation
The data collector installation location and the chosen installation options for upgrade are stored in the
/opt/DCM.cfg
file.
Follow these steps:
  1. Verify that the data collector is running on the data collector host by issuing the following command:
    service dcmd status
  2. Review the
    /opt/IMDataCollector/Logs/CA_Performance_Management_Data_Collector_install_
    timestamp
    .log
    log file on the data collector host. If the installation is successful, the log shows 0 Warnings, 0 NonFatalErrors, and 0 FatalErrors.
    If the installation fails early enough in the process, this log file might be available in the home directory of the root or sudo user.
  3. Verify that the data collector connection is successful. Complete the following steps:
    1. Hover over
      Administration
      ,
      Data Sources
      , and then click the data aggregator data source.
      The
      Monitored Devices
      page appears.
    2. Click
      Data Collectors
      under
      System Status
      .
      The
      Data Collectors
      page appears.
    3. Verify that data collector appears in the list.
      The list can take several minutes to refresh and show the data collector that you just installed.
    4. If the
      Tenant
      and
      IP Domain
      fields are blank for the data collector, assign the data collector to a tenant and IP domain.