Install the Data Collectors

Install the data collectors after you install Data Aggregator.
Install the data collectors
after
you install the data aggregator. 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.
In this article:
2
Install the Data Collector
You can install the data collector in silent mode by generating a response file, and then use this response file to run future installations in silent mode. Add the response file argument when you run the
install.bin
file.
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://
        <da_host>:<port>
        /dcm/install.htm
        • da_host
          Specifies the data aggregator host name.
        • port
          Specifies the data aggregator required port number.
          Default:
          8581
          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:
          • (HTTP data aggregator)
            wget -P /tmp -nv http://
            <da_host>:<port>
            /dcm/InstData/Linux/VM/install.bin
            • da_host
              Specifies the data aggregator host name.
            • port
              Specifies the data aggregator required port number.
              Default:
              8581
          • (HTTPS-enabled data aggregator) Issue the command with the
            --no-check-certificate
            option:
            wget -P /tmp --no-check-certificate -nv https://
            <da_host>:<port>
            /dcm/InstData/Linux/VM/install.bin
            • da_host
              Specifies the data aggregator host name.
            • port
              Specifies the data aggregator required port number.
              Default:
              8582
        • (If
          wget
          is unavailable) Issue the following command:
          • (HTTP data aggregator)
            curl -o /tmp/install.bin http://
            <da_host>:<port>
            /dcm/InstData/Linux/VM/install.bin
            • da_host
              Specifies the data aggregator host name.
            • port
              Specifies the data aggregator required port number.
              Default:
              8581
          • (HTTPS-enabled data aggregator) Issue the command with the
            -k
            option:
            curl -k -o /tmp/install.bin https://
            <da_host>:<port>
            /dcm/InstData/Linux/VM/install.bin
            • da_host
              Specifies the data aggregator host name.
            • port
              Specifies the data aggregator required port number.
              Default:
              8582
    • (If you
      do not
      have HTTP access to the data aggregator host) Open a command prompt on a computer that has 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:
          • (HTTP data aggregator)
            wget -P ~/Desktop -nv http://
            <da_host>:<port>
            /dcm/InstData/Linux/VM/install.bin
            • da_host
              Specifies the data aggregator host name.
            • port
              Specifies the data aggregator required port number.
              Default:
              8581
          • (HTTPS-enabled data aggregator) Issue the command with the
            --no-check-certificate
            option:
            wget -P ~/Desktop --no-check-certificate -nv https://
            <da_host>:<port>
            /dcm/InstData/Linux/VM/install.bin
            • da_host
              Specifies the data aggregator host name.
            • port
              Specifies the data aggregator required port number.
              Default:
              8582
        • (If
          wget
          is unavailable) Issue the following command:
          • (HTTP data aggregator)
            curl -o /tmp/install.bin http://
            <da_host>:<port>
            /dcm/InstData/Linux/VM/install.bin
            • da_host
              Specifies the data aggregator host name.
            • port
              Specifies the data aggregator required port number.
              Default:
              8581
          • (HTTPS-enabled data aggregator) Issue the command with the
            -k
            option:
            curl -k -o /tmp/install.bin https://
            <da_host>:<port>
            /dcm/InstData/Linux/VM/install.bin
            • da_host
              Specifies the data aggregator host name.
            • port
              Specifies the data aggregator required port number.
              Default:
              8582
      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-*/shutdown.log
    file. Uninstall and reinstall the data collector.
    • apache-karaf-*
      The installation directory for Apache Karaf.
      Example:
      apache-karaf-4.2.6
  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 is connected 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 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
    <DC_installation_directory>
    /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.
The installation is verified.