Upgrading the App Visibility server in the high-availability mode silently

Failed to execute the [excerpt-include] macro. Cause: [Error number 2 in 0: No wiki with id [confluencePage:page] could be found]. Click on this message for details.

You must be a system administrator to perform the TrueSight App Visibility Manager server components upgrade. 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.

Failed to execute the [excerpt-include] macro. Cause: [Error number 2 in 0: No wiki with id [confluencePage:page] could be found]. Click on this message for details.

Warnings

Some data will be incomplete or missing until you finish the upgrade process.

appvis_ha_enhancements.png

To set options for silent upgrade of the App Visibility portal

The procedure describes how to set the options to upgrade the App Visibility portal when it is the only App Visibility server component on the computer.

Click here to expand the steps.
  1. On the computer where you want to upgrade the App Visibility portal, extract the downloaded files to a temporary directory.
  2. Open the downloaded options file in a text editor:
    • (Windows)   adop-silent-option-upgrade.txt
    • (Linux)   adop-silent-option-upgrade
  3. (For upgrade to high-availability)
    • If you do not want to set up your environment for HA, save and close the upgrade options file without change.
    • If your environment is already set up for HA, add a value for the ha_node_synchronization_port.
      The port synchronizes data between the current and alternate nodes and is dedicated for communication between the nodes.
      The port must be the same number on the current and alternate nodes.
      The default value is 5701.

    • To set up an HA environment, set ha_enabled to true and enter values for the current portal and alternate portal.

      The following example displays values for a portal in an HA environment.

      -J ha_enabled=true
      -J ha_current_node_fqdn=myPortalA.bmc.com
      -J ha_alternate_node_fqdn=myPortalB.bmc.com
      -J ha_alternate_node_db_port=8800
      -J ha_node_synchronization_port=5701


      Parameter descriptions for the portal's alternate component

  4. Save and close the upgrade options file.


To set options for silent upgrade of an App Visibility collector

The procedure describes how to set the options to upgrade an App Visibility collector when it is the only App Visibility server component on the computer.

Click here to expand the steps.
  1. On the computer where you want to upgrade an App Visibility collector, extract the downloaded files to a temporary directory.
  2. Open the downloaded options file in a text editor:
    • (Windows)   adop-silent-option-upgrade.txt
    • (Linux)   adop-silent-option-upgrade

  3. If necessary, update the App Visibility portal connection information.

    For example, if you are upgrading to an HA environment from an environment that is not HA, enter the IP address and port number of the load balancing server for the App Visibility portal.

    -J portal_ip=
    -J portal_communication_port=
  4. (For upgrade to high-availability)
    • If you do not want to set up your environment for HA, save and close the upgrade options file without change.
    • If your environment is already set up for HA, add a value for the ha_node_synchronization_port.
      The port synchronizes data between the current and alternate nodes and is dedicated for communication between the nodes.
      The port must be the same number on the current and alternate nodes.
      The default value is 5701.

    • To set up an HA environment, set ha_enabled to true and enter values for the current collector and alternate portal.

      The following example displays values for a portal in an HA environment.

      -J ha_enabled=true
      -J ha_current_node_fqdn=myCollectorA.bmc.com
      -J ha_alternate_node_fqdn=myCollectorB.bmc.com
      -J ha_alternate_node_db_port=8800
      -J ha_node_synchronization_port=5701

      Parameter descriptions for the collector's alternate component

  5. (For upgrade to high-availability ) Enter values for the load balancer that manages access to the collector: 

    -J ha_lb_host=
    -J ha_lb_port=

    Parameter descriptions for the collector's load balancer

  6. Save and close the upgrade options file.


To set options for silent upgrade of an App Visibility proxy

The procedure describes how to set the options to upgrade an App Visibility proxy when it is the only App Visibility server component on the computer.

Click here to expand the steps.

Note

The upgrade process includes several checks for connectivity to the App Visibility portal and to other App Visibility proxy servers and storage engines. The process cannot continue until the connectivity and cluster issues are resolved, unless you explicitly run the installation utility with a command to continue with such errors.

If you want to upgrade the proxy without testing connectivity (not recommended), run the utility from a command line with the -J continue_with_connectivity_error=true parameter.

At your own risk, you will have to resolve connectivity and cluster issues after the upgrade process, and restart all the cluster nodes for the storage engines.

  1. On the computer where you want to upgrade an App Visibility proxy, extract the downloaded files to a temporary directory.
  2. Open the downloaded options file in a text editor:
    • (Windows)  adop-silent-option-upgrade.txt
    • (Linux)  adop-silent-option-upgrade

  3. Enter values for the proxy storage:

    -J proxy_storage_http_port=8302
    -J proxy_storage_transport_port=8303
    -J proxy_storage_transport_ip=192.0.2.24

    Parameter descriptions for the proxy storage

  4. If necessary, update the App Visibility portal connection information.

    For example, if you are upgrading to an HA environment from an environment that is not HA, enter the IP address and port number of the load balancing server for the App Visibility portal.

    -J portal_ip=
    -J portal_communication_port=
  5. Save and close the upgrade options file.


To upgrade the App Visibility server silently

  1. In a command line window, navigate to the directory with the silent-option-upgrade file.
  2. 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

If the upgrade is successful, an indication is displayed in the command window.

Failed to execute the [excerpt-include] macro. Cause: [Error number 2 in 0: No wiki with id [confluencePage:page] could be found]. Click on this message for details.

Failed to execute the [excerpt-include] macro. Cause: [Error number 2 in 0: No wiki with id [confluencePage:page] could be found]. Click on this message for details.

 

Tip: For faster searching, add an asterisk to the end of your partial query. Example: cert*