Offline installation

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

Requirements

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.

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.