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

    Page tree

    This topic presents upgrade procedures for the App Visibility server from version 10.0 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.

    Upgrade from an earlier version
    To upgrade from a version earlier than 10.0, first upgrade to version 10.0 Open link .

    The App Visibility portal and collector upgrade processes include a database migration, which moves data from the previous App Visibility database, to the current PostgreSQL App Visibility database.

    The following topics are presented:

    Before you begin

    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 remove the database tables.

      If the root password was not changed since installation, do not change the entered password.

    4. Enter the PostgreSQL database port number for the db_port parameter.

      The port number cannot be the same as the current MySQL database port (default 3301).

      The default port number for the PostgreSQL database is 8800.

    5. Determine whether you want to enable the upgrade process to continue if the database migration encounters a warning.

      The default value (yes) enables the process to continue. 

      Warning

      If database migration continues after encountering a warning, which is the default setting, some data loss might occur.

      Change the value to no to stop the process and return to the previous version.

      # Database Migration continue on warning
-J db_migration_continue_on_warning=yes

      If the database migration encounters an error, the upgrade process stops and returns to the previous version.

    6. Save and close the upgrade options file.
    7. 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 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):

    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-upgrade file for the db_root_password parameter.
      For example, if the encrypted password output is DES\:d70cbe3669602717ce66af37cce7ecf0, modify the db_root_password parameter as follows:
      -J db_root_password=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-upgrade file for your silent installation.
      For example, if the encrypted password output is DES\:d70cbe3669602717ce66af37cce7ecf0, modify the db_root_password parameter as follows:
      -J db_root_password=DES\:d70cbe3669602717ce66af37cce7ecf0

    To adjust the App Visibility portal database size

    After you upgrade the App Visibility portal to version 10.1.00, you can adjust the maximum database size (db.max.size). The upgrade utility always sets the default value to 102400 MB (100 GB).

    Use the following procedure to reset the maximum database size:

    1. On the computer where the App Visibility portal is installed, open the portal.properties file located in the following directory:
      • Windows
        installationDirectory\portal\properties
      • Linux
        installationDirectory/portal/properties
    2. Edit the db.max.size value, in megabytes.
    3. Save the portal.properties file and restart the portal service.

    Where to go from here

    After you upgrade the App Visibility server components, do the following:

    Related topics

    Upgrading App Visibility agents for Java

    Upgrading App Visibility agents for .NET 

    Changing App Visibility collector settings

    Changing App Visibility portal settings

    Changing App Visibility proxy settings

     

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