Skip to main content

The most recent patch for this version is 7.6.1.  Learn more  

Version: 7.6

Offline installation

Deploy and run Axiomatics Services Manager (ASM) on environments without an internet connection, such as air-gapped servers.

Preparation​

For the offline installation of ASM, you need to acquire the following files from Axiomatics:

  • artifacts.zip
  • axiomatics-services-manager-VERSION.zip
  • registryData.zip
  • registryImage.tar

Contact Axiomatics Customer SupportOpens in a new tab if you have not received them.

SSL certificate​

ASM requires a PKCS#12 (Public Key Cryptography Standard #12) certificate. The certificate file must be named cert.keystore.p12 and during its creation the name (or alias) must be set to server. You will import this certificate to the ASM distribution in a later stage of the procedure.

In production environments, you should import trusted certificates only, while in dev and test environments you have the ability to use self-signed certificates.

tip

You can use OpenSSL to create your own self-signed certificate.

Offline installation procedure​

Place the files listed above under the same directory. Open a terminal, navigate to this directory, and follow the steps below to complete the offline installation of ASM:

  1. Restore the Docker Registry Image (registryImage.tar).

    docker load -i registryImage.tar

  2. Unzip the Docker Registry Image Volume (registryData.zip).

  3. Run the Registry Container.

    note

    Replace <ABSOLUTE_PATH_TO_DIR> with the path of the registry directory.

    docker run -d -p 5000:5000 --restart=always --name registry -v /<ABSOLUTE_PATH_TO_DIR>/registry:/var/lib/registry registry:2

  4. Unzip the artifacts ZIP file (artifacts.zip).

  5. Unzip the ASM ZIP file (axiomatics-services-manager-VERSION.zip).

  6. Copy the artifacts folder to the ASM docker folder.

    note

    Replace <PATH_TO_ASM> with the path to the ASM folder.

    cp -r artifacts /<PATH_TO_ASM>/axiomatics-services-manager-VERSION/docker/

  7. Update the axiomatics-services-manager-VERSION/docker/.env file with the following values:

    CONNECTION=offline

    REGISTRY=localhost:5000/
    note

    The file may be hidden.

  8. Follow the Install the application procedure starting with step 5. In case you want to run ASM on a machine with a hostname other than the default, you should instead start with step 4.