Upgrade the DSA in a Three-Tier Distributed Deployment

Install the Software › Upgrade a Distributed Deployment › Upgrade the DSA in a Three-Tier Distributed Deployment

Upgrade the DSA in a Three-Tier Distributed Deployment

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

Before You Begin: Verify that the installation server meets the following requirements:

The server is upgrade-ready as described in Verify Preparation of the Windows Servers.
The Harvester servers have been upgraded.
The Console tool has been run on the NFA console server, as described at the beginning of Upgrade the Harvester.

Note: If you have a Linux DSA, contact your CA Support Availability Manager or Sales Account team to inquire about obtaining a Windows-based DSA.

Follow these steps:

Verify that processing is complete for the collected DSA data:
1. Log in to the NFA console server with an account that has administrator privileges for CA Network Flow Analysis.
2. Locate the following directory on the NFA console server: <install_path>\Reporter\datashare\data\<DSA_server_IP_address>
3. Verify that the directory does not contain any .csv files. If .csv files are present, keep checking until the files are gone. The files are processed and gone within 15 minutes.
Start the upgrade: Double-click the DSASetup9.1.3.exe file in Windows Explorer.
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.
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.
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 program to exit. A Pre-requisite Check Warning message or other warning message opens for non-critical problems, which gives you the option to make corrections now or after the installation or upgrade is complete.
Review the test results in the Pre-requisite Check Warning message, if it opens:
1. Correct problems now or wait until the program finishes. For more information about the warnings, see the Troubleshooting section.
2. Click OK to close the message.
  The upgrade can proceed only if the previous software version is supported for the upgrade. If you do not have a supported software version installed, upgrade to a supported version before you proceed.
  
  Once the server passes the required checks and you close any warning messages that appear, the Choose Install Folder screen opens. This screen displays the original root installation path as the default setting.
Proceed through the options to verify the installation directories:
1. Click Next in the Choose Install Folder screen.
  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 Select a Location for the MySQL Data Directory screen opens after a moment. This screen shows the original installation path for the MySQL data directory.
  
  The Folder Selected Is Not Empty message also opens, which asks you to verify that you have backed up the directory contents.
2. Click Next in the Select a Location for the MySQL Data Directory screen.
  Important: If you do not use the original installation path, the upgraded software will not run properly.
  
  The Select a Location for the MySQL Temp Directory screen opens, which shows the original installation path for the MySQL tmp directory.
3. Click OK to close the message.
4. Click Next in the Select a Location for the MySQL Temp Directory screen.
  Important: If you do not use the original installation path, the upgraded software will not run properly.
  
  MySQL51 is configured, then the Pre-Installation Summary screen opens.
Review the pre-installation information, then click Install.
The Installing DSA screen opens, which shows the progress of the upgrade. When the upgrade is complete, the Install Complete screen opens. This screen tells you whether any errors occurred during the upgrade.
Click Done.
The upgrade program closes. The DSA is upgraded and the DSA services are restarted.
(Optional) Verify that the following conditions are met:
- DSA services are running.
- The DSA 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
(Optional) Check the DSA_Install_<timestamp> log periodically. This log is located at the install path root level--for example, in the \\CA\NFA directory. Use the log to monitor the migration of the DSA database tables to the new format.
The migration of DSA database table data begins as soon as the CA NFA DSALoader service restarts. The DSA_Install log lists the tables as they are migrated. Nine tables are migrated for each agent or interface. If you have many agents and an extensive amount of stored data, migration may continue for some time.

Next:

To upgrade an additional DSA on another server, repeat these steps.
To upgrade the console server, go to the next topic.