• Spaces
  • Collections
  • Help
    • ×
     
     
    •  
    BMC TrueSight Operations Management 10.0

    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 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

    1. In a command line, navigate to the \ADOPServer\Disk1 folder in the installation file structure.

    2. Open the downloaded options file in a text editor:
      • (Windows) adop-silent-option-upgrade.txt
      • (Linux) adop-silent-option-upgrade

    3. 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.

    4. 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

      • 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):

    1. To open the Maintenance Tool, go to the temporaryDirectory/Disk/utilities directory where you downloaded the installation files.
    2. Run the ADOPServerMaintenanceTool utility and click the Encrypt tab.
    3. Enter your password in the Password and Confirm Password fields and click Encrypt.
    4. 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
    1. To open the Maintenance Tool, go to the temporaryDirectory\Disk\utilities directory where you downloaded the installation files.

    2. 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>"

    3. 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

    Related topics

    Upgrading App Visibility agents for Java

    Upgrading App Visibility agents for .NET 

     

    © Copyright 2005-2024 BMC Software, Inc. Use of this site signifies your acceptance of BMC’s Terms of Use . BMC, the BMC logo, and other BMC marks are assets of BMC Software, Inc. These trademarks are registered and may be registered in the U.S. and in other countries.