Performing the App Visibility server upgrade silently

This topic presents upgrade procedures for the App Visibility server from Application Diagnostics version 2.6.x to the current version. You can upgrade App Visibility components using the silent upgrade procedure, as described in this topic, and deploy the silent upgrade to several computers, or you can upgrade using the upgrade wizard.

When you run the silent installation, only the App Visibility component or components that are on the computer are upgraded. After you upgrade components, you can run the silent installation to install components that are not on the computer.

The following topics are presented:

Before you begin

Download the installation files from the Electronic Product Distribution site to a temporary directory on the App Visibility server computer.
Back up the database.
Note
The upgrade process modifies the database schema. You will need the database backup if you want to revert to the previous version.
If you created a customized agent policy, including adding comments, copy the contents of the policy and save it as a text file. This backup file can be used to compare the previous settings with the current.
1. In the navigation pane of the Operations Management console, select Administration > App Visibility Agent Policies.
2. Click the name of the agent policy you want to back up.
3. Copy the contents of the agent policy and paste them into a text file.
4. Save the text file as a back up.
If you customized other settings with the help of BMC Support, contact them for assistance backing up the settings.
Ensure that you have completed all preinstallation tasks.
Review the Preparing-for-an-App-Visibility-upgrade-and-checking-compatibility topic.

To upgrade the App Visibility server silently

In a command line, navigate to the \ADOPServer\Disk1 folder in the installation file structure.
Open the downloaded options file in a text editor:
- (Windows) adop-silent-option-upgrade.txt
- (Linux) adop-silent-option-upgrade
Enter the encrypted root password for the MySQL Database to update the database tables.
If the root password was not changed since installation, do not change the entered password.
To run the silent upgrade, enter the following command:
- Windows
  setup.exe -i silent -DOPTIONS_FILE=<fullFilePath>\adop-silent-option-upgrade.txt
- Linux
  ./setup.bin -i silent -DOPTIONS_FILE=<fullFilePath>/adop-silent-option-upgrade
Notes
- If you see an error about the database encryption method, see Upgrading-the-App-Visibility-server-stops-because-of-database-encryption-method.
- If the upgrade fails, you must uninstall what has been installed before rerunning the installation wizard. For more information about the uninstall process, see Uninstalling-the-App-Visibility-server.
- The App Visibility server log files are located in the following directories:
  - (Windows) %temp%\adopserver_install_log.txt
  - (Linux) /tmp/adopserver_install_log.txt

Encrypting the password for silent App Visibility server upgrade

The Maintenance Tool enables you to retrieve an encrypted password, which the App Visibility server upgrade utility requires to access the MySQL database. You must use an encrypted password so that it is not exposed in the upgrade options file.

You can run the Maintenance Tool in a GUI or from the command line interface (CLI):

To encrypt a password by using the Maintenance Tool GUI (click here to expand steps)

To open the Maintenance Tool, go to the temporaryDirectory/Disk/utilities directory where you downloaded the installation files.
Run the ADOPServerMaintenanceTool utility and click the Encrypt tab.
Enter your password in the Password and Confirm Password fields and click Encrypt.
Copy and paste the value from the Encrypted Password field to the adop-silent-option file for the proxy_keystore_password_enc parameter.
For example, if the encrypted password output is DES\:d70cbe3669602717ce66af37cce7ecf0, modify the proxy_keystore_password_enc parameter as follows:
-J proxy_keystore_password_enc=DES\:d70cbe3669602717ce66af37cce7ecf0

To encrypt a password by using a CLI (click here to expand steps)

To open the Maintenance Tool, go to the temporaryDirectory\Disk\utilities directory where you downloaded the installation files.
Run the following command, entering your password for the -password and -confirm_password options:
- Windows
  ADOPServerMaintenanceTool.exe -silent -encrypt -encrypt -password=<password> -confirm_password=<password>
- Linux
  ./ADOPServerMaintenanceTool.bin -silent -encrypt -encrypt -password=<password> -confirm_password=<password>
Note
If the password contains special characters, use quotation marks. For example:
- (Windows)
  ADOPServerMaintenanceTool.exe -silent -encrypt -encrypt -password="<password>" -confirm_password="<password>"
- (Linux)
  ./ADOPServerMaintenanceTool.bin -silent -encrypt -encrypt -password="<password>" -confirm_password="<password>"
Copy and paste the output to the adop-silent-option file for your silent installation.
For example, if the encrypted password output is DES\:d70cbe3669602717ce66af37cce7ecf0, modify the proxy_keystore_password_enc parameter as follows:
-J proxy_keystore_password_enc=DES\:d70cbe3669602717ce66af37cce7ecf0

Warning

After you upgrade the App Visibility server, the system can no longer receive events from earlier versions. Upgrade all App Visibility agents to the latest version.

Where to go from here

Adding App Visibility to the Operations Management Console

Verifying-the-App-Visibility-server-upgrade