Steps for APM Insight agents to migrate to a new DC

DC migration steps for APM Insight agents

For Server based installations

1. Obtain the new device key.
2. Update the license.key value in the APM Insight configuration file (or the environment variable mentioned) with the new device key. The location varies for each agent, as listed below:

 Agent type
 File name
 File location (Relative or Absolute)
 JAVA
 apminsight.conf
 <apminsight-javaagent.zip Extracted Directory>/
 RUBY
 apminsight.conf
 <APP_HOME>/ 
 DOTNET
 apminsight.conf
 %ProgramData%\DotnetAgent\<appname>
 DOTNET_CORE
 apminsight.conf
 <ApplicationPublishDirectory>\DotnetAgent\
 PHP_WINDOWS
 apminsight.conf
 <INSTALLPATH>\APM Insight PHP Agent\zpa\bin
 PHP
 apminsight.conf
 /opt/zpa/bin/
 NODEJS
 apminsighnode.json
 <application root directory> 
 PYTHON
 apminsight_info.json
 <application root directory> 
 All (except PHP)
 S247_LICENSE_KEY
 System Environment variable
 DOTNET_CORE (Windows)
 S247_LICENSE_KEY
 Computer\HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services\W3SVC 

 Computer\HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services\WAS

3. Log in to the server and delete the existing instance information files. Please find the below for the location of the instance files based on the agent:

 Agent type
 File name
 File location (Relative or Absolute)
 JAVA
 apminsight.info
 <apminsight-javaagent.zip Extracted Directory>/
 RUBY
 apminsight.info
 <APP_HOME>/ 
 DOTNET
 apminsight.net.info
 %ProgramData%\DotnetAgent\<Appname>
 DOTNET_CORE
 apminsight.net.info
 <ApplicationPublishDirectory>\DotnetAgent\
 PHP_WINDOWS
 instance.out
 <INSTALLPATH>\APM Insight PHP Agent\zpa\bin
 PHP
 instance.out
 /opt/zpa/bin/
 NODEJS
 apminsight.json
 <application root directory>/apminsightdata

4. Restart the application server and the respective service. The service name varies for each agent, as listed below:

 Agent type
 Service name
 JAVA
 <application server>  

 (eg: Tomcat, JBoss, etc.) 
 RUBY
 <application> 
 DOTNET
 APM Insight .NET Agent Service (Windows)
 DOTNET_CORE
 <application server> or dotnet process
 PHP_WINDOWS
 APM Insight PHP Agent service
 PHP
 zpdpsvc
 NODEJS
 <application server> or npm process
PYTHON
 <application> 

In Serverless Set-up

In Containers and Kubernetes

  1. Rebuild the image in Environment variables or the apminsight.conf file with the new device key.  
  2. ​Delete the existing information files (if found) under volume mapping.
  3. Stop the existing containers and spawn new ones with the updated image. 

In Elastic Beanstalk

  1. Device key set in .ebextension file
    1. Update the device key present in the .ebextension or apminsight.config file.
    2. Add a command to delete the existing instance information files (refer to above for locations).
    3. Re-deploy the application with the new .ebextension or apminsight.config file. 
  1. Device key set in EBS environment variable
    1. Update the EBS device key from the EBS console by editing the S247_LICENSE_KEY variable.
    2. Add a command to the .ebextension or apminsight.config file to delete existing instance information files (refer to above for locations).
    3. Re-deploy the application with the new .ebextension or apminsight.config file. 

In Azure VM Extension or App Service Extension (.NET & .NET Core)

  1. Uninstall the existing extension.
  2. Reinstall the extension with the updated device key.

Azure Web Apps (Java)

  1. Navigate to the agent extracted directory, usually located in APP_HOME/WEB-INF/lib/site24x7.
  2. Update the device key present in the apminsight.config file.
  3. Delete the apminsight.info file present in the same directory.
  4. Restart the Azure Web App. 

Kubernetes postStart lifecycle (PHP)

  1. Change the apikey parameter for the installation script in the Kubernetes postStart lifecycle event or the values.yaml file in Helm charts.
  2. Re-deploy your application/service. 


    • Related Articles

    • Exclude Site24x7 monitoring traffic from Google Analytics

      You can exclude traffic from the Site24x7 Web Transaction (Browser) monitor and Webpage Speed (Browser) traffic from Google Analytics in two ways. To exclude traffic for the Web Defacement monitor, you can follow the first method. 1. Creating a ...

    • Troubleshoot the "pymysql module not found" error when installing the MySQL plugin

      If you're encountering the pymysql module not found error, it likely means that the pymysql Python library is not installed on the server. pymysql is a Python package that provides a way to interact with MySQL databases using Python code and is used ...

    • No data for service and process in Windows server monitor

      If you see "No Data" for process and service metrics (such as CPU or memory usage of monitored services) in the Site24x7 Windows server monitor user interface, follow the troubleshooting steps below. Run PowerShell Commands Open PowerShell as ...

    • Validating sender email using DKIM authentication

      What is DKIM? DomainKeys Identified Mail (DKIM) is an advanced authentication method used widely by email service providers to verify the email from the point of its origin by validating the email sender. It allows the email senders to authenticate ...

    • Accessing products via Site24x7

      You can seamlessly access ManageEngine CloudSpend and Site24x7’s sub-products, like Digital Risk Analyzer, StatusIQ, and Toolset, from within your Site24x7 web client. The product switcher , available at the top-right corner of the interface, lets ...