Previous Topic: Upgrade a Distributed DeploymentNext Topic: Upgrade the Harvester on a Linux Server

Install the Software › Upgrade a Distributed Deployment › Upgrade the Harvester on a Windows Server

Upgrade the Harvester on a Windows Server

In a distributed deployment, each Harvester is installed on a separate server. To upgrade a Harvester on a dedicated Windows server or virtual machine, complete the steps in this topic. These steps apply to a two-tier or three-tier distributed deployment.

Before You Begin: Verify that the server is upgrade-ready as described in Verify Preparation of the Windows Servers.

Follow these steps to prepare the NFA console server for the Harvester upgrade:

  1. Run the Console tool:
    1. Log in to the NFA console server as a user with administrator privileges for the system and for CA Network Flow Analysis.
    2. Verify that the consoletool-exe.jar file is on the NFA console server in a location such as the Desktop. If you do not have this file, download it.

      The Console tool prepares the system for the upgrade.

    3. Double-click the consoletool-exe.jar file in Windows Explorer or enter the following string at a command prompt: 
      java -jar consoletool-exe.jar

      To launch the Console tool by double-clicking the file, Windows Explorer must have the correct association for .jar files.

      The ConsoleInfoToPollerTool<yyyy-mm--dd>.log file opens when the Console tool completes--whether the tool completes successfully or fails. The log is saved in the <install_path>\Reporter\Logs\ directory.

      The Console tool cannot complete successfully if the system has undeployed interface aggregations or unscheduled merge or delete interface tasks. If the tool does not complete successfully, note the error messages in the log file and contact CA Support.

  2. Stop the pump service on the NFA console server:
    1. Click Start, Programs, Administrative Tools, Services.
    2. Right-click the NetQoS Reporter/Analyzer Pump service.
    3. Select Stop in the right-click menu.

      The service stops.

Follow these steps to upgrade the Harvester:

  1. Start the upgrade: Double-click the NFHarvesterSetup9.1.3.exe file in Windows Explorer on the Harvester server. If you do not have this file, download it.

    A check verifies that the server has a supported version of the Java Runtime Engine (JRE) installed. If the check fails, an error message opens. You cannot launch the installation or upgrade program until this problem is corrected.

    If the server passes the Java prerequisite check, the program starts and the language selection screen opens.

  2. Verify that the appropriate language is selected, then click OK.

    A check verifies whether the installed version of CA Network Flow Analysis is supported for upgrade. If a supported version is found, the Prior Installation Detected message opens.

  3. Review the Prior Installation Detected message and click OK. If the installed CA Network Flow Analysis version is not supported for upgrade, upgrade to a supported version.

    The Welcome screen opens.

  4. Click Next in the Welcome screen.

    A check verifies that the Console tool completed successfully on the NFA console server. If the tool did not run successfully, an error message opens and the upgrade stops.

    If the server passes the check, the CA NFA Harvester License Agreement screen opens.

  5. Review and accept the license agreement:
    1. Read the license agreement and scroll down.
    2. If you want to continue under the terms of the license agreement, click the option to accept it. This option is activated when you scroll to the bottom.
    3. Click Next.

      Prerequisite tests are run to identify problems on the server. If a problem is found, an error message opens. A critical problem causes the upgrade program to exit. If the problem is not critical, the Pre-requisite Check Warning message or other warning message opens, which gives you the option to make corrections now or after the upgrade is complete.

      Once the server passes the required checks and you close any noncritical messages that appear, the Choose Install Folder screen opens. This screen displays the original root installation path as the default setting.

  6. If the Pre-requisite Check Warning message opens, review the test results:
    1. Correct the problems now or wait until the upgrade program finishes. For more information about the warnings, see the Troubleshooting section.
    2. Click OK to close the message.

      Once the server passes the required checks successfully and you dismiss any warnings that appear, the Choose Install Folder screen opens. This screen displays the original root installation path as the default setting.

  7. Verify that the specified installation directory is correct, then click Next.

    Important: If you do not use the original installation path, the upgraded software will not run properly.

    If the program does not find certain expected directories in the installation path, an error message opens and the upgrade stops. This problem does not occur when the previous software installation is fully functional.

    The Pre-Installation Summary screen opens.

  8. Review the pre-installation information, then click Install.

    The Installing Harvester screen opens, which shows the upgrade progress. When the upgrade is complete, the Install Complete screen opens and reports any errors that occurred.

  9. (Optional) If errors occurred during the upgrade, see the following logs for details:
  10. Exit from the upgrade program:
    1. Select one of the restart options:
      • Yes, restart my system: Restart the system as soon as you click Done.
      • No, I will restart my system myself: Defer the restart to be performed manually.
    2. Click Done.

      The upgrade program closes after a moment. If you selected the option to restart now, the system restarts and the upgrade is finalized.

  11. (Optional) Verify that the following conditions are met:

Next: