Set up PSA in an air-gap environment

For security or compliance reasons your organization might restrict outbound internet connections and operate an air-gap environment. You can set up PSA in an air-gap environment by manually downloading the required resources and configuring them offline.
  1. Download the zip file on a connected host.
  2. Set up the agent in the air-gap environment.

Download the zip files on a Connected Host

Complete the following steps on a connected host:
  1. From the Splunk AppDynamicsDownload Center, download the latest versions of the following files:

    • Pre-built Private Synthetic Agent Docker Images (zip)

    • Private Synthetic agent for API monitoring or Private Synthetic Agent for web monitoring

  2. Transfer the files by using a secure method to your air-gap environment.

Set up the agent in the air-gap environment

Complete the following steps in the air-gap environment:
  1. Transfer the files into your offline environment.
  2. Unzip the files.
  3. Load the following Docker images from the Pre-built Private Synthetic Agent Docker Images directory into your local Docker environment:
    CODE 
    docker load -i api-monitoring-agent-<version-number>.tar
docker load -i chrome-agent-<version-number>.tar
docker load -i heimdall-<version-number>.tar
docker load -i ignite-<version-number>.tar

    For example, to load the api-monitoring-agent image:

    CODE 
    $ docker load -i api-monitoring-agent-1.0-471.tar

    The output is:

    CODE 
    Loaded image: 829771730735.dkr.ecr.us-west-2.amazonaws.com/sum/api-monitoring-agent:1.0-471
  4. Tag the source image (loaded image) and the target image (obtained from the install_psa script) for the following:

    • appdynamics/heimdall-psa:<version>

    • appdynamics/api-monitoring-agent-psa:<version>

    • appdynamics/chrome-agent-psa:<version>

    For example, tag the source image 829771730735.dkr.ecr.us-west-2.amazonaws.com/sum/api-monitoring-agent:1.0-471 and the target image appdynamics/chrome-agent-psa:1.0-1282:

    CODE 
    $ docker tag 829771730735.dkr.ecr.us-west-2.amazonaws.com/sum/api-monitoring-agent:1.0-471 appdynamics/chrome-agent-psa:1.0-1282

    Ensure to tag the correct version of the source image (loaded image) and the target image (obtained from the install_psa script).

  5. (Optional) For setting up PSA in Docker Engine, tag the following images with the latest tag:

    • appdynamics/heimdall-psa:<version>

    • appdynamics/api-monitoring-agent-psa:<version>

    • appdynamics/chrome-agent-psa:<version>

    For example, to tag the api-monitoring-agent-1.0-471 with latest:
    CODE 
    $ docker tag 829771730735.dkr.ecr.us-west-2.amazonaws.com/sum/api-monitoring-agent:1.0-471 appdynamics/chrome-agent-psa:latest
  6. Based on your environment, do the following: