Airgap Install¶

As described in Airgap Install, the prebuilt airgap bundle can be used to install a DRP endpoint and build a manager or a catalog server for other DRP endpoint installations.

Airgap Bundle Creation¶

Build the airgap-install.sh script by running the following:

curl -fsSL get.rebar.digital/stable | bash -s build-airgap <args for airgap>
# example: curl -fsSL get.rebar.digital/stable | bash -s build-airgap --location=dir_name --version=stable --concurrency=16

The above will generate a minimal airgap install. This will generate a self extracting script called airgap-install.sh in the location specified.

The following will generate an airgap image with the discovery and image-deploy bootenvs and additional historical discovery bootenvs.

curl -fsSL get.rebar.digital/stable | bash -s build-airgap --download-iso-bootenvs="sledgehammer,ubuntuhammer,discovery" --download-iso-profiles="sledgehammer-alma8-v4.10.0,sledgehammer-alma9-v4.12.0,ubuntuhammer-v4.11.0,ubuntuhammer-v4.12.0" ...<other args>

Note

If the package repositories are empty, you'll need to download the required isos for sledgehammer. Add the appropriate alma-*-install to your --download-iso-bootenvs flag. The alma version varies based on the sledgehammer version you download."

Example

curl -fsSL get.rebar.digital/stable | bash -s build-airgap --download-iso-bootenvs="sledgehammer,ubuntuhammer,discovery,alma-8-install" ...<other args>

Note

By default, all Docker contexts are downloaded. To filter them, use the --download-contexts flag and specify the desired Docker contexts.

Note

If you wish to include the DRP UX in the airgap image, you will need to change the catalog used in the build process. You will need to get the URL of the UX catalog from RackN. With that URL, you can add the following to the build-airgap command: --catalog="<URL of UX Catalog>"

For a complete list of build-airgap args see drpcli airgap help.

Once your airgap-install.sh script is built, you will need to move it over to your airgapped system and run the following:

./airgap-install.sh install --universal
# this will install drp in /var/lib/dr-provision by default
# a different location can be specified using the --drp-home-dir flag
# all the flags you would normally use with your regular install script can be used here

If you also want to run UX locally and have built the script with a UX catalog, you can run

./airgap-install.sh install --universal --local-ui

Note

Please note that you also have the option to just run:

./airgap-install.sh explode
# This will only explode the catalog to the current dir. A location can also be specified
./airgap-install.sh extract
# This will only extract the tarball to the current dir or location specified

Now to verify the portal is working. On a machine that can access the air-gapped endpoint open a web browser and visit https://<YOUR IP>:8092/. By default, a self-signed cert will need to be accepted (Note that you can provide your own certs during deployment.) Log in using the default user and password. Once logged in, you will be prompted to upload a valid license.

Note

In addition to port 8092, a self signed cert will need to be accepted by visiting [https://\<YOUR IP>:8090/]{.title-ref} so that the local catalog can be displayed in the UI.

At this time you, need to either generate the license from an existing internet accessible DRP endpoint, or by contacting RackN support to have a license generated for you. Once you have a valid license you can upload it from the UX.
Once you have uploaded your license, please verify that your self runner has started up successfully. You can do this by going to the machines tab. You should only see one machine, and it should show up with a green play button next to it. If something has gone wrong during the initial bootstrap process, you should be able to look at logs to figure out what went wrong, fix it and restart the workflow.