Upgrading the Java Agent

AppOptics agents are no longer receiving updates. The new SolarWinds Observability Libraries can send APM data to AppOptics and are regularly updated with new features and improvements. If your components are supported by the new libraries, consider transitioning to the SolarWinds Observability Libraries for your APM needs. Alternatively, you can also consider using SolarWinds Observability as your primary APM monitoring solution.

SolarWinds Observability Libraries are not compatible with AppOptics agents. Do not use a mix of SolarWinds Observability Libraries and AppOptics agents to instrument applications that are part of a distributed trace.

Upgrading to the SolarWinds Observability Java Library

The Java Instrumentation Library for SolarWinds Observability is compatible with the AppOptics collector. SolarWinds Observability libraries are not compatible with AppOptics agents. Do not use a mix of SolarWinds Observability libraries and AppOptics agents to instrument applications that are part of a distributed trace.

To upgrade to the SolarWinds Observability Java Library, uninstall the AppOptics Java Agent and follow the rest of the steps described in Migrate the Java Library from AppOptics to SolarWinds Observability. Before restarting the application, make the following additional configuration changes to have the SolarWinds Observability Java Library continue sending data to AppOptics:

Set a valid AppOptics service key. See the SolarWinds Observability configuration options for the new configuration file and environment variable names.
Set the collector configuration to the AppOptics endpoint collector.appoptics.com:443.

Upgrade to a newer version of the legacy AppOptics Agent

Java Agent

Linux

Upgrade the AppOptics Java agent by following the same steps as Installation.

We check if ./javaagent.json has been modified to retain any custom configurations you may have made. If the file has been modified, the new json file is stored under a different name, e.g. ./javaagent.json.6.18.0. As a next step you should transfer all your custom changes to ./javaagent.json.6.18.0, rename ./javaagent.json to something else such as ./javaagent.json.old and ./javaagent.json.6.18.0 to ./javaagent.json.

Windows

Download and run the latest AppOptics Java agent Windows installer from https://files.appoptics.com/java/latest/JavaAgent_Setup.exe

Java SDK

AppOptics Java SDK is made available on Maven with group Id com.appoptics.agent.java and artifact Id appoptics-sdk. Simply set the version number to the the latest one according to our release notes. (SDK and Agent share the same version number)

Our SDK jar can also be found within the installation folder of the AppOptics Java agent.