Performing the Diagnostics Server upgrade

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

When you run the installation wizard on a system with a previous version of the product, the wizard automatically switches to upgrade mode for the installed component or components, and enables you to install components that are not on the same computer.

Before you begin

• Download the installation files from the Electronic Product Distribution site to a temporary directory on the Server computer.

To upgrade the BMC Application Diagnostics Server

1. On the computer where you want to upgrade the Diagnostics Server component or components, launch the installation wizard:
   • Windows
     Navigate to ADOPServer\Disk1 and double-click setup.cmd.
     In Windows 2008, the system may require you to right-click the setup.cmd icon to select to Run as administrator.
   • Linux
     
     1. Before running the wizard, ensure that you have a DISPLAY environment variable set.
     2. Navigate to ADOPServer/Disk1 and run setup.sh.

   Note

   If you see an error about the database encryption method, see Upgrading the Diagnostics Server stops because of database encryption method.

2. In the BMC Application Diagnostics Server Installer Welcome page, click Next.

3. On the License Agreement page, read the agreement and select the I agree to the terms of the license agreement option, and then click Next. If you do not agree to the terms of the license agreement, the upgrade process will end.

4. If prompted, select the upgrade component.

   • If both the BMC Application Diagnostics Portal and Collector are installed on the computer, the utility skips the Features page and both components are upgraded.
   • If one or more server components are not installed, then you can select to install another component on the Features page.
     For instructions about installing the new component, see Performing the Diagnostics Server installation.
5. Enter the MySQL root password to update the database tables.
   If the root password was not changed since installation, do not change the entered password.

6. If you did not previously upgrade the MySQL to version 5.6.14, select the data management method for the upgrade:

   • Copy. The data directory is copied to the new database.
     If you do not have enough space, this option is disabled.
   • Move. The data directory is moved to the new database. The previous database is deleted at the end of upgrade process.
7. Verify that the information on the Installation Preview page reflects your upgrade correctly. Click Previous to make changes, or click Install.
8. After the upgrade is complete, click View Log to view the log files and confirm that the upgrade process was successful.
9. Click Done to exit the installation wizard.