Performing the Agent for Java upgrade

This topic presents upgrade procedures for the BMC Application Diagnostics Agent for Java from version 2.0, or later, to 2.5.01. You can upgrade each Agent using the interactive mode, or you can upgrade the Agent using the silent upgrade procedure, and deploy the silent upgrade to several computers.

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

Before you begin

Download the following Agent upgrade files from the Electronic Product Distribution site to a temporary directory on the Agent computer:

• Windows
  • adops-agent-upgrade.bat
  • agentInstaller.jar
• Linux
  • adops-agent-upgrade.sh
  • agentInstaller.jar

You must have execute privileges on the upgrade scripts and write access to the upgrade location.

To upgrade the BMC Application Diagnostics Agent for Java

1. Stop the Java virtual machine (JVM) process on the Agent computer.
2. Open a command shell and run the adops-agent-upgrade.bat (for Windows) or adops-agent-upgrade.sh (for Linux) command.

3. At the prompt, enter the full path to the existing BMC Application Diagnostics Agent installation directory, which must include the ADOPsInstall directory. You can also use a relative path.

   If the path includes a space, enclose the path in quotation marks.

   Information

   Examples

   (Windows) "c:\BMC Software\ADOPs\ADOPsInstall"

   (Linux) /opt/ADOPs/ADOPsInstall

4. Enter a value for the following parameter:
   Please specify the type of Tier this agent represents. Specify the type of tier this Agent represents in the Application View: app, business, web. The default value is app.

5. If the application name is missing for the Agent, enter a value for the following parameter:

   Please specify a name for the monitored Application which will be displayed by the GUI. Enter a name for the application to be displayed in the BMC Application Performance Management Console. The application name is required and it is case insensitive.

6. To start the upgrade, enter yes.
7. When the message BMC Application Diagnostics Java Agent upgraded successfully is displayed, the upgrade is successful and you can close the command shell. Otherwise, see Verifying-the-Agent-for-Java-upgrade.
8. Restart the JVM process.

Behavior of Agent and Agent policy after upgrade

Upgrading BMC Application Diagnostics Agent for Java does not change the Agent policy files. Agent policy files are upgraded with BMC Application Diagnostics Server and contain the new features for the Agents. The Agent for Java continues to use the same Agent policy file as before the upgrade.

Where to go from here

Verify that upgrade of the BMC Application Diagnostics Agent for Java is successful and that the Agent to sending data.

Related topics

Preparing-for-upgrade-and-compatibility
Performing-the-Agent-for-NET-upgrade