Upgrade the Data Collectors

Upgrade the data collectors after you have upgraded the data aggregator.
2
Upgrade the data collectors after you have upgraded the data aggregator. The data collectors continue to run during upgrades and cache polled data to disk. When the data repository and data aggregator upgrade completes, the data collectors load the cached data. The upgrade process upgrades the data collectors at once through a staged process where up to two data collectors upgrade in parallel.
The method that you use to upgrade the data collectors depends on how you plan to run the upgrade:
Upgrade the data collectors
manually
in the following cases:
  • You are upgrading from a
    DX NetOps Performance Management
    3.5 release as a non-root user.
  • You are upgrading from
    DX NetOps Performance Management
    3.2 or lower.
  • A pseudo tenant proxy is assigned to the data collectors.
    For more information, see Tenant-Agnostic Data Collectors.
    If you upgrade as a non-root user, these data collectors might hang with an "Upgrade Pending" status, the data collectors continue to collect data as normal, and other data collectors continue to upgrade.
Run the Upgrade as a Non-Root User
Use the following process to upgrade the data collectors using
DX NetOps Performance Management
.
With this upgrade method:
  • The data collectors are upgraded with a minimal reporting gap.
  • The upgraded data aggregator (
    DX NetOps Performance Management
    3.5 or higher) continues to communicate with the previous versions of your data collectors (
    DX NetOps Performance Management
    3.5 or higher) as they upgrade.
Verify the Prerequisites for Upgrades as a Non-Root User
Before you upgrade the data collectors as a non-root user, ensure that you have completed the following prerequisite steps:
  • You have assigned each data collector a Tenant and IP Domain. The upgrade process skips those data collectors that do not have an assigned Tenant or IP Domain.
  • If you have authenticated and encrypted ActiveMQ communication, you have regenerated the keys and established trust.
    For more information, see Authenticate and Encrypt ActiveMQ Communication.
Upgrade the Data Collector as a Non-Root User
Upgrade the data collectors to the version of the data aggregator. During the upgrade, the data collector service is down until the upgrade completes.
Follow these steps:
  1. Locate the
    /etc/sudoers
    file on the data collector host.
  2. Add the following command alias with the following permissions to the file:
    dcuser dchostname
    = (root) NOPASSWD:
    DC_installation_directory
    /upgrade/install.bin
    If the
    requiretty
    parameter is enabled, add the following text to disable
    requiretty
    for the data collector installer:
    Defaults!
    DC_installation_directory
    /upgrade/install.bin !requiretty
  3. Log in to
    NetOps Portal
    as the global administrator.
  4. Hover over
    Administration
    ,
    Monitored Items Management
    , and then click
    Data Collectors
    .
  5. Select the data collectors, and then click
    Upgrade
    .
    The
    Upgrade Data Collectors
    dialog opens.
  6. To proceed with the upgrade, click
    Yes
    .
    You can view the status of the upgrade in the
    Overall Status
    column.
Run the Upgrade as a Root or Sudo User
Use the following process to upgrade the data collectors manually as a root user or as a user with the necessary sudo privileges.
For a major release,
NetOps Portal
indicates that an upgrade is required. For a minor incremental upgrade (for example, a monthly update),
NetOps Portal
does not indicate that an upgrade is required. However, you can still upgrade to the latest release.
Verify the Prerequisites for an Upgrade as a Root or Sudo User
Before you upgrade the data collectors as a root user or as a user with the necessary sudo privileges, ensure that you have completed the following prerequisite steps:
  • On the data aggregator system, you have verified that the ports that enable communication between the data collector and the data aggregator (ports 61616, 61618, 61620, and 61622) are open.
  • You have installed the zip and unzip packages. If you have not installed these packages, install them by issuing the following command:
    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
Upgrade the Data Collector Manually
Run the upgrade as a root user or as a user with the necessary sudo privileges.
Follow these steps:
  1. Log in to the data collector host as a root user or as a user with the necessary sudo privileges.
  2. Change to the
    /tmp
    directory by issuing the following command:
    cd /tmp
  3. Use
    wget
    ,
    curl
    , or a browser to download the installation package to the
    /tmp
    directory:
    wget http://
    data_aggregator
    :
    port
    /dcm/InstData/Linux/VM/install.bin
    curl -o /tmp/install.bin http://
    data_aggregator
    :
    port
    /dcm/InstData/Linux/VM/install.bin
    Default port:
    8581
  4. Change permissions for the
    install.bin
    file by issuing the following command:
    chmod a+x install.bin
  5. Do
    one
    of the following steps:
    • Run the installation as the root user:
      ./install.bin -i console
    • Run the installation as a user with the necessary sudo privileges:
      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:
    ./installDA.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. (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 fault-tolerant 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.
      To view the status of your data aggregators in
      NetOps Portal
      , hover over
      Administration
      ,
      Data Sources
      , and then click
      System Status
      .
    When the upgrade is complete, the console displays a confirmation message.
  8. Verify that the data collector is running by issuing the following command:
    service dcmd status
The data collector is upgraded.
Verify the Manual Upgrade
After you have upgraded the data collectors manually, verify the upgrade.
Follow these steps:
  1. Log in to
    NetOps Portal
    as the global administrator.
  2. Navigate to the data aggregator data source.
  3. From the
    System Status
    menu, and click
    Data Collectors
    .
  4. Verify that the data collector appears in the list.
    The list can take several minutes to refresh and show the new data collector installation.