Upgrade the Data Collectors

After you upgrade the Data Aggregator, upgrade the Data Collector. To properly upgrade the Data Collector component, upgrade Data Collector on each Data Collector host.
capm350
After you upgrade the Data Aggregator, upgrade the Data Collector. To properly upgrade the Data Collector component, upgrade Data Collector on each Data Collector host.
2
Verify the Prerequisites
Meet the following prerequisites before you upgrade the Data Collector:
  • Verify that ports 8581, 61616, 61618, 61620, and 61622 are open for communication between your Data Collectors and your Data Aggregators.
    For the detailed port list, Review Installation Requirements and Considerations.
  • Before you upgrade, verify the zip and unzip packages are installed. If these packages are not installed, use the following command to install them:
    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
Manually Upgrade the Data Collector
If you launch the Data Collector installer from a secure shell or console and you are not running an X Window System, the installer launches in console mode.
Follow these steps:
  1. Log in to the Data Collector host as the root user or a sudo user.
  2. Change to the /tmp directory:
    cd /tmp
  3. Download the installation package to the /tmp directory:
    wget http://
    data_aggregator
    :
    port
    /dcm/InstData/Linux/VM/install.bin
  4. Change permissions for the installation file:
    chmod a+x install.bin
  5. To run the upgrade, do one of the following steps:
    • Run the installation as the root user:
      ./install.bin -i console
    • Run the installation as the sudo user:
      sudo ./install.bin -i console
      For environments that support a GUI, remove the following argument to run the upgrade in GUI mode:
      -i console
      To generate a response file for silent upgrade, add the following argument:
      -r 
      response_file
      response_file_directory
      Specifies the directory path and file name for the response file.
      Example:
      /temp/installer.properties
      To run the upgrade in silent mode, use the following command:
      ./install.bin -i silent -f 
      response_file
      response_file
       
      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 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.
  8. When the upgrade is complete, the console displays a confirmation message.
  9. Verify that Data Collector is running:
    service dcmd status
Verify the Upgrade
After you upgrade the Data Collectors, verify the upgrade.
Follow these steps:
  1. Log in to
    Performance Center
    as the global administrator.
  2. Navigate to the Data Aggregator data source.
  3. Expand
    System Status
    , and click
    Data Collectors
    .
  4. Verify that Data Collector appears in the list.
    The list can take several minutes to refresh and show the new Data Collector installation.
Upgrade Easily to Post-3.5 GA Releases
The 
CA Performance Management
 3.5 GA release introduces an Upgrade button in
Performance Center
. This button is an extra and easier avenue for upgrading your Data Collectors to releases after the 3.5 GA release.
To use this feature, the Data Collectors must be running as the
root
user.
For a major release, the user interface indicates that an upgrade is required. For a minor incremental upgrade (for example, a monthly update), the user interface does not indicate that an upgrade is required. However, you can still use the Upgrade button to upgrade to the latest release.
The Data Collectors can continue to run during the upgrade and cache polled data to disk. When the Data Aggregator and Data Repository upgrade completes, the Data Collectors load the cached data. All the Data Collectors are upgraded at once through a staged process where up to two Data Collectors upgrade in parallel. This upgrade method allows you to upgrade your Data Collectors with a minimal reporting gap. Also, an upgraded Data Aggregator (at version 3.5 or higher) can continue to communicate with the previous versions of your Data Collectors (at version 3.5 or higher) as they upgrade.
Before you upgrade the Data Collectors, each Data Collector must have a Tenant and IP Domain assigned. The upgrade process skips any Data Collectors with no Tenant or IP Domain assigned. You cannot use this button to upgrade your Data Collectors to the
CA Performance Management
3.5 GA release from an earlier release (for example, 3.2). However, you can use this button to upgrade your Data Collectors easily to post-3.5 GA releases after the initial setup.
This upgrade method does not support remote upgrade for Data Collectors that are assigned with a Pseudo Tenant Proxy. For more information, see Tenant-Agnostic Data Collectors.
The upgrade for these Data Collectors might hang with an "Upgrade Pending" status. You must manually upgrade these Data Collectors. If this issue occurs, the Data Collectors continue to collect data as normal and other Data Collectors continue to upgrade.
Follow these steps:
  1. Log in to
    Performance Center
    as the global administrator.
  2. Hover over
    Administration
    , and click
    Monitored Items Management: Data Collectors
    .
  3. Select all the Data Collectors and click
    Upgrade
    .
    A confirmation message appears.
  4. To proceed with the upgrade, click
    Yes
    .
    The status of the upgrade appears in the Status column.