Upgrade the Harvester on a Linux Server

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

Upgrade the Harvester on a Linux Server

A two-tier distributed deployment of CA Network Flow Analysis may include one or more Linux Harvester servers. To upgrade the Harvester software on a dedicated Linux server or virtual machine, complete the steps in this topic.

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

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

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. Enter the following string at a command prompt:
```
java -jar consoletool-exe.jar
```
  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.
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 pump service stops.

Follow these steps to upgrade the Harvester:

Log in to the target system as root.
You can install the software locally or remotely--for example, by using ssh when you are logged in with root privileges.

Note: If you do not have root access, use an account with sudo privileges.
Open a command prompt window.
Run the following command to change the ulimit for the open files limit:
```
ulimit -n ulimit_number
```
Example:
```
ulimit -n 65536
```
Prepare the installation/upgrade file for execution:
1. Log in to the Harvester server as root.
  You can install or upgrade the software locally or remotely--for example, by using ssh when you are logged in with root privileges. If you do not have root access, use an account with sudo privileges.
2. Execute the chmod command on the file in a terminal window:
```
chmod u+x NFHarvesterSetup9.1.3.bin
```
3. (Optional) Execute the list command to verify that the file is executable:
```
ls -al
```
  The file permission settings are displayed.
Run the installation or upgrade software:
```
./NFHarvesterSetup9.1.3.bin
```
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.
Verify that the appropriate language is selected, then click OK.
A check determines whether the installed version of CA Network Flow Analysis is supported for upgrade. If a supported version is located, the Prior Installation Detected message opens.
Review the Prior Installation Detected message and click OK to close it. If a supported software version is not installed, upgrade to a supported version.
The Welcome screen opens.
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 License Agreement screen opens.
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.
  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.
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.
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.
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.
(Optional) Review errors that occurred by checking the installation log (Harvester_Install_<timestamp>.log in the <install_path> directory).
Click Done.
The upgrade program closes. The Harvester is upgraded and the CA Network Flow Analysis services are started.
(Optional) Verify that the following conditions are met:
- (Two-tier architecture deployment) Harvester services are running.
- Harvester is receiving data.
- The revision history shows that the component is upgraded to the correct version. To display the revision history, complete the following substeps:
  1. Start MySQL by entering the following command in a Command Prompt window: mysql
  2. Display the revision history by entering the following command:
    select * from revision_history

Next:

To upgrade another Harvester, repeat these steps on the additional Harvester server.
To continue upgrading a two-tier deployment, Upgrade the Console Server.
To continue upgrading a three-tier deployment, Upgrade the DSA Server.