Page tree

Unsupported content

 

This version of the documentation is no longer supported. However, the documentation is available for your convenience. You will not be able to leave comments.

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 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. You can install components that are not already on the same computer.

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

  1. On the computer where you want to upgrade the App Visibility server component or components, launch the installation wizard:
    • (Windows) Navigate to ADOPServer\Disk1 and double-click setup.exe.
      In Windows 2008, the system may require you to right-click the setup.exe icon to select to Run as administrator.
    • (Linux) Ensure that you have a DISPLAY environment variable set.
      Navigate to ADOPServer/Disk1 and run setup.bin.

    Note

    If you see an error about the database encryption method, see Upgrading the App Visibility server stops because of database encryption method.

  2. In the BMC TrueSight App Visibility Manager 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 ends.
  4. If prompted, select the upgrade component:

    • If the App Visibility portal, collector, and proxy are installed on the computer, all components are selected on the Features page and all components must be 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 App Visibility server installation.
  5. (For portal or collector) Enter the MySQL root password to update the database tables.
    If the root password is the default, do not change the entered password.
  6. Verify that the information on the Installation Preview page reflects your upgrade correctly. Click Previous to make changes, or click Install.
  7. After the upgrade is complete, click View Log to view the log files and confirm that the upgrade process was successful.
  8. Click Done to exit the installation wizard.

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

Related topics

Upgrading App Visibility agents for Java

Upgrading App Visibility agents for .NET