Upgrading an App Visibility agent using the wizard

Where you are in the Upgrade process

As a system administrator, you can upgrade both Java and .NET agents using the installation wizard, as presented in this topic, or you can upgrade the agent using the silent upgrade procedure.

After you upgrade an agent, it runs using the same log files and configuration, and the same agent policy and recording configuration apply.

To upgrade a TrueSight App Visibility Manager agent for Java using the wizard

1. Log in to the computer with the user that runs the application server.

2. Extract the downloaded files to a temporary directory.

3. (Linux) Set the DISPLAY environment variable to ensure that the wizard-based installer launches the screens appropriately.
   export DISPLAY=<IP address of the host computer>:0.0
   

4. Stop the application server or Java virtual machine (JVM) process on the agent computer.

5. Launch the upgrade wizard:

   • (Windows) Right-click setup.exe and select Run as administrator.

   • (Linux) Run setup.bin.

6. Review the Welcome page, and click Next.

7. Read the license agreement, agree to the terms, and click Next.

   If you do not agree to the terms of the license agreement, the upgrade process ends.

8. Enter, or browse to, the TrueSight App Visibility Manager agent for Java installation directory and click Next. 

   The default directory is:

   • (Windows) C:\Program Files (x86)\BMC Software\App Visibility\Agent_for_Java

   • (Linux, AIX, Solaris) /opt/bmc/App_Visibility/Agent_for_Java

9. Review the settings displayed on the Installation Preview page and click Install.

10. Start the application server or JVM process.
11. If you upgraded your TrueSight App Visibility Manager server, and you enabled HA in the upgraded version, ensure that you  change the settings of the App Visibility agent  to connect to the portal's load balancing server.
12. Examine and modify, if necessary, the  application discovery  and  event thresholds (SLAs) for automatically discovered applications.

After you upgrade an agent, it runs using the same log files and configuration, and the same agent policy and recording configuration apply.

To upgrade a TrueSight App Visibility Manager agent for .NET using the wizard

1. Log in to the computer with the user that runs the application server.
2. Extract the downloaded files to a temporary directory.
3. To launch the wizard, double-click setup.exe.
   When you run the setup.exe installation wizard on a system with a previous version of the product, the wizard automatically switches to upgrade mode.
4. Review the Welcome page, and click Next.

5. Read the license agreement, agree to the terms, and click Next.

   If you do not agree to the terms of the license agreement, the upgrade process ends.

6. To confirm that you want to upgrade, click Install.
   The utility upgrades the current version with the same values as the earlier installation.

7. If required services are running, such as IIS, click Next to confirm that the services will be stopped.
   Services are restarted at the end of the upgrade process.
8. After the upgrade process completes, click View Log to view the installation log files.
9. Click Done to exit the wizard.

10. If you enabled HA for the App Visibility portal for the first time, upgrade each App Visibility agent, update the agent's portal connection details to the portal's load balancer. For details, see  Changing settings of the App Visibility agent for .NET.

Verifying the TrueSight App Visibility Manager agent for Java upgrade

You can verify that the App Visibility agent for Java upgrade was successful, and that the agent for Java was invoked, by reviewing the log files created and updated during the agent upgrade. For assistance with any issues that you cannot solve, contact BMC Customer Support.

To review the logs

1. Navigate to the same folder from where you ran the upgrade script and check for the bmc_ad_agent_install.log file.
2. Ensure that other applications or processes are not holding files open.
3. Open and examine the log for error messages, such as that indicate incorrect privileges or write access.

To verify that the Agent for Java has been invoked

1. Navigate to the logs folder in the local installation directory. For example, C:\AppVis\ADOPsInstall\instances\<instance_name>\logs

   Note: The <instance_name> variable is the name that is generated dynamically during the Agent first start-up.
   

2. Check for the aps_agent.log file.
   If the log file exists, the installation was successful. 
3. Open the aps_agent.log file and examine [ERROR] messages for issues that you can address.
4. In the TrueSight console, select Administration > App Visibility Agents from the navigation pane and confirm that the agent is online.

Verifying the TrueSight App Visibility Manager agent for .NET upgrade

You can verify that the App Visibility agent for .NET upgrade was successful, and that the agent for .NET was invoked, by reviewing the log files created and updated during upgrade. For assistance with issues that you cannot solve, contact BMC Customer Support.

To review the installation logs

1. Open the agentinstaller_install_log.txt file, located in the %temp% folder.
2. In the log, verify whether any error messages were reported. If there are no error messages, the upgrade was successful.
3. In the TrueSight console, select Administration > App Visibility Agents from the navigation pane and confirm that the agent is online. For more information, see  Accessing and navigating the TrueSight console.
4. Add App Visibility to the TrueSight console, if you haven't already done so.

Next Step in the Upgrade process

Step 5 Phase B Task 2 — Now that you have successfully installed the App Visibility agent, you must upgrade the Transaction Execution Adapter agent.