How to Migrate APM Insight Java Agent to a New Applications Manager?

For Java Agent v7.0 and Above

For Java Agent Below v7.0

For Java Agent v7.0 and Above

1. Obtain the new license key: From Applications Manager UI, Navigate to the APM tab → Add Monitor → Java Agent → License Key → Copy to Clipboard.

2. Update the Configuration Files:

Login to the application server where the Java Agent is installed.
Replace the "apm.host" & "license.key" value in the following files with new Applications Manager URL and its license key.

<JavaAgent_extracted_path>/apminsight.conf
<JavaAgent_extracted_path>/<App_Name>_<port>/apminsight.conf

For Example,

license.key=APMI_a856****************************a547eb39fd7ed38e18276c

apm.host=https://apmhost:8443

3. Remove Existing Instance Data:

Delete the following to reset old instance information:

<JavaAgent_extracted_path>/<App_Name>_<port>/apminsight.info file
APM_Java_Instances folder

4. Restart the application server: Restart the respective application server (eg: Tomcat, JBoss, etc.) to apply the updated configurations and establish communication with the new Applications Manager instance.

For Java Agent Below v7.0

1. Obtain the new license key: From Applications Manager UI, Navigate to the APM tab → Add Monitor → Java Agent → License Key → Copy to Clipboard.

2. Update the Configuration Files:

Login to the application server where the Java Agent is installed.
Replace the "apm.host" & "license.key" value in the following file with new Applications Manager URL and its license key: <JavaAgent_extracted_path>/apminsight.conf

For Example,

license.key=APMI_a856****************************a547eb39fd7ed38e18276c

apm.host=https://apmhost:8443

3. Remove Existing Instance Data: Delete the following to reset old instance information: <JavaAgent_extracted_path>/apminsight.info file

Related Articles

How to Migrate APM Insight .NET Agent to a New Applications Manager?