Upgrading an App Visibility agent silently

Where you are in the Upgrade process

As a system administrator, you can upgrade agents using the silent upgrade procedure, as presented in this topic, and deploy the silent upgrade to several computers, or you can upgrade each agent using the installation wizard.

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 silently

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

2. Extract the downloaded files to a temporary directory.
3. Open the silent options file javaagent-silent-options-upgrade.txt in a text editor. 
4. Enter the destination directory where the agent for Java is installed.
   The default value is:
   • (Windows) C:\Program Files (x86)\BMC Software\App Visibility\Agent for Java
   • (Linux, AIX, Solaris) /opt/bmc/JavaAgent
5. Stop the application server or Java virtual machine (JVM) process on the agent computer.

6. In a command line, run the following command and specify the full path and filename for the silent options file:

   • (Windows) setup.exe -i silent -DOPTIONS_FILE="<Full-File-Path>\<Silent Options Filename>"

     For example: setup.exe -i silent -DOPTIONS_FILE="C:\JavaAgentInstaller\Disk1\javaagent-silent-options-upgrade.txt"

   • (Linux, AIX, Solaris) ./setup.bin -i silent -DOPTIONS_FILE="<Full-File-Path>\<Silent Options Filename>"

     For example: ./setup.bin -i silent -DOPTIONS_FILE="/home/Admin/JavaagentInstaller/Disk1/javaagent-silent-options-upgrade.txt"

7. Start the application server or JVM process.

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

9. Examine and modify, if necessary, the  application discovery  and  event thresholds (SLAs) for automatically discovered applications.

To upgrade a TrueSight App Visibility Manager agent for .NET silently

1. Log in to the computer with the user that runs the application server.
2. Extract the downloaded files to a temporary directory.

3. In a command line, run the following command and specify the full path and filename for the silent options file: 

   setup.exe -i silent -DOPTIONS_FILE=<fullFilePath>\agent-silent-upgrade-option.txt


   The utility installs the current version with the same values as the earlier installation.

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

MultiExcerpt named post_upg_dotnet was not found -- Please check the page name and MultiExcerpt name used in the MultiExcerpt-Include macro

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.