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, follow the steps for 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-endabled 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
      does
      have HTTP access, and then complete the following steps:
      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 the
        /tmp
        directory 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
        The directory path and file name of the previously generated response file.
      Generate a response file for a silent installation by adding the following argument, following the prompts until you get to the summary, typing
      quit
      , and then pressing the
      Return/Enter
      key on your keyboard:
      -r
      response_file
      • response_file
        Specifies the directory the directory path and file name for the response file.
        Example:
        /temp/installer.properties
  6. Follow the instructions in the console.
  7. When the installer prompts for the data aggregator host information, specify the IP address or the host name for the data aggregator.
    To prevent the data collector from shutting down after the installation, logging an error to the
    DC_installation_directory
    /
    apache-karaf-*
    /shutdown.log
    file, and requiring an uninstall and reinstall of the data collector, specify the data aggregator host information correctly.
    • DC_installation_directory
      The installation directory of the data collector.
      Default:
      /opt
    • 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
    :
    • No:
      You are planning to deploy multi-tenancy
      . You can then associate each data collector installation with a tenant.
    • Yes:
      You
      are not
      planning on deploying multi-tenancy
      .
  9. (Optional) When prompted, specify the following parameters for fault tolerance:
    • Is the data aggregator configured with fault tolerance?
      If you have configured a fault-tolerant environment, specify
      2
      for Yes.
      Default:
      1 (the data aggregator is not configured for fault tolerance).
    • Second Data Aggregator Host/IP Address
      Specify the host name or IP address of the second data aggregator responsible for this data collector.
      You can view this information on the
      System Status
      page.
      For more information, see View System Status.
    For more information, see Fault Tolerance.
The data collector is installed, started, 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/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 and appears in the list on the
    System Status
    page.
    The list can take several minutes to refresh and show the data collector that you just installed.
    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.