Performing the Diagnostics Server upgrade silently

This topic presents silent upgrade procedures for the BMC Application Diagnostics Server from version 2.1.x to 2.6.x. You can upgrade the Diagnostics Server components using the silent upgrade procedure and deploy the silent upgrade to several computers, or you can upgrade each server component using the the upgrade wizard procedure.

When you run the silent upgrade, only the Diagnostics Server 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 following options file with the installation files from the Electronic Product Distribution site to a temporary directory on the Diagnostics Server computer:
- (Windows) adop-silent-option-upgrade.txt
- (Linux) adop-silent-option-upgrade
Obtain an encrypted root password for the MySQL Database.

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.

Ensure that you have completed all preinstallation tasks.
Review the Preparing-for-a-BMC-Application-Diagnostics-upgrade-and-checking-compatibility topic.
You must have administrative privileges on the computer where you perform the upgrade.

To upgrade the BMC Application Diagnostics 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.
If you did not previously upgrade the MySQL to version 5.6.14, select the data management method for the upgrade:
- copy—(Default) The data directory is copied to the new database.
  If you do not have enough space, a warning is displayed and the upgrade script is aborted.
- move—The data directory is moved to the new database. The previous database is deleted at the end of upgrade process.
To run the silent upgrade, enter the following command:
- Windows
  setup.cmd -i silent -DOPTIONS_FILE=adop-silent-option-upgrade.txt
- Linux
  ./setup.sh -i silent -DOPTIONS_FILE=adop-silent-option-upgrade
Notes
- If you see an error about the database encryption method, see Upgrading-the-Diagnostics-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-BMC-Application-Diagnostics-Server.
- The Diagnostics 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 Diagnostics Server upgrade

The Maintenance Tool enables you to retrieve an encrypted password, which the Diagnostic 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.
The temporaryDirectory is the place to which 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.
The temporaryDirectory is the place to which you downloaded the installation files.
Run the following command, entering your password for the -password and -confirm_password options:
- Windows
  ADOPServerMaintenanceTool.cmd -silent -encrypt -encrypt -password=<password> -confirm_password=<password>
- Linux
  ./ADOPServerMaintenanceTool.sh -silent -encrypt -encrypt -password=<password> -confirm_password=<password>
Note
If the password contains special characters, use quotation marks. For example:
- Windows
  ADOPServerMaintenanceTool.cmd -silent -encrypt -encrypt -password="<password>" -confirm_password="<password>"
- Linux
  ./ADOPServerMaintenanceTool.sh -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 upgrading the Diagnostics Server, the system continues to function with Diagnostics Agents from earlier versions, but the server can no longer receive events from agent version 2.1.x.

BMC strongly recommends upgrading all Diagnostics Agents to the latest version.

Where to go from here

Verifying-the-Diagnostics-Server-upgrade

Upgrading-the-Diagnostics-Agent-for-Java

Upgrading-the-Diagnostics-Agent-for-NET