I need to install the admin toolkit but I am airgapped

Issue

I have been asked to install the toolkit, but I cannot run the toolkit.sh because it requires internet access.

I have an air-gapped deployment and cannot install the toolkit!

Resolution

Download the toolkit.sh and tar ball, add and tag to your internal registry and then run the toolkit.sh script from a location with kubectl/docker access.

Remember you may need to run curl from your local machine or bastion and copy the files to where you can actually run kubectl/docker.

Some customers need to upload the image via UI or Rancher and tag manually instead of this.

Replace customer-registry-host:5000 with your internal/local registry.

curl -O https://domino-admin-toolkit-files.s3.us-west-2.amazonaws.com/domino-admin-toolkit.tar.gz
docker load < domino-admin-toolkit.tar.gz
# gunzip -cd domino-admin-toolkit.tar.gz | docker load # if you have issues with the line above
# or try to gunzip the file and load as tar
# gunzip domino-admin-toolkit.tar.gz && docker load < domino-admin-toolkit.tar
docker image tag quay.io/domino/cre:slim customer-registry-host:5000/domino-admin-toolkit:v1-compatible 
docker image push customer-registry-host:5000/domino-admin-toolkit:v1-compatible

On the host with kubectl access to Domino platform you need toolkit.sh as well. It can be pulled from an s3 bucket too!

curl -O https://domino-admin-toolkit-files.s3.us-west-2.amazonaws.com/toolkit.sh && chmod a+x ./toolkit.sh

Next, run the toolkit.

./toolkit.sh install --image customer-registry-host:5000/domino/domino-admin-toolkit --tag v1-compatible
 
# --tag is applied in combination with --image
# if --image is not specified, the default value of ‘quay.io/domino/cre' will be used
# if --tag is not specified, then the default value of 'latest’ will be used

From here on you can follow the guidance on using the toolkit and command line options:

https://tickets.dominodatalab.com/hc/en-us/articles/10601074944660-How-to-run-the-Admin-Toolkit

https://tickets.dominodatalab.com/hc/en-us/articles/13017506294676-Admin-Toolkit-script-usage

This applies to Domino prior to 5.5.0

https://docs.dominodatalab.com/en/5.4/admin_guide/9c6da7/run-the-admin-toolkit/#_starting_stopping_and_checking_the_toolkit_status