Deployment of AppDynamics Private Synthetic Agent for offline environments

EUM (End-User Monitoring)

The AppDynamics Private Synthetic Agent relies on Docker images to function as designed. If your environment has access to external networks, you can download the required images directly either from docker.io using the docker pull command or directly from the AppDynamics downloads portal, as per the steps in the official documentation.

However, if your environment does not have internet access, you must manually download and upload these images. This process is explained below in details.

1. On a machine that has access to the internet, pull the required images from the docker.io repository using the below commands:

docker pull apacheignite/ignite:2.16.0-jdk11
docker pull appdynamics/heimdall-psa
docker pull appdynamics/chrome-agent-psa
docker pull appdynamics/api-monitoring-agent-psa

Note: You can also download the repositories directly from AppDynamics downloads portal, as per the documentation

2. Once downloaded, save each of the repositories to a .tar file:

docker save -o ignite.tar apacheignite/ignite:2.16.0-jdk11
docker save -o heimdall.tar appdynamics/heimdall-psa
docker save -o chrome-agent.tar appdynamics/chrome-agent-psa
docker save -o api-agent.tar appdynamics/api-monitoring-agent-psa

3. All of the .tar files created using the above commands need to be copied to the destination PSA agent machine.

4. Once all of the .tar files were successfully transferred, deploy the repositories using the below commands:

docker load -i ignite.tar
docker load -i heimdall.tar
docker load -i chrome-agent.tar
docker load -i api-agent.tar

5. Check if the repositories are loaded successfully using docker image ls. The output of the docker image ls should look something similar to this:

docker image ls
REPOSITORY                               TAG            IMAGE ID       CREATED         SIZE
appdynamics/chrome-agent-psa             latest         2b15215e727c   3 weeks ago     1.63GB
appdynamics/api-monitoring-agent-psa     latest         d2b6157359da   3 weeks ago     138MB
appdynamics/heimdall-psa                 latest         a38a9b4a0c81   3 weeks ago     533MB
apacheignite/ignite                      2.16.0-jdk11   b043b94a51cf   20 months ago   383MB

Note: The REPOSITORY:TAG values are often referenced inside the .yaml configuration files used during the deployment process. In case of any issues, kindly please:

In case of orchestrated environments (such as Minikube, OpenShift, etc.), ensure that inside the values.yaml file, the repository name and tag for heimdall, chromeAgent, apiMonitoringAgent and ignite is correct,
In case of docker deployment, ensure that inside the docker-compose.yaml file, the repository name and tag for heimdall and ignite is correct. In addition to that, ensure that inside the
application-onprem.yml file, the repository name and tag for chrome and api is correct.

For more details, please feel free to go through our Official Documentation. In case you are still facing issues, please raise a Service Request to the AppDynamics support organisation.

Deployment of AppDynamics Private Synthetic Agent for offline environments