Install in an air-gapped Bring-Your-Own (BYO) cluster with KOTS

Note

Before installing, make sure that you have met the prerequisites.

If you opt to install Obcerv in an existing cluster, you should choose the Bring-Your-Own (BYO) option. You can download the required components from link to the download portal provided to you. You will download the necessary components from the provided link to the download portal.

Installing Obcerv via Kubernetes Off-the-Shelf (KOTS) streamlines the process through the use of a kubectl plugin (KOTS CLI) and an admin console where you can upload your license file, choose install options, and run pre-flight checks prior to deployment.

To install Obcerv using KOTS, do the following:

• Install the KOTS CLI, which is kubectl plugin. Follow the steps in Installing the KOTS CLI.

• Extract kotsadm.tar.gz, which contains the KOTS admin console container images, and then push the images to your private registry:

  kubectl kots admin-console push-images ./kotsadm.tar.gz REGISTRY_HOST \
    --registry-username RW_USERNAME \
    --registry-password RW_PASSWORD
  

• Install the admin console on your desired namespace. To do this, run:

  kubectl kots install [application slug]/[channel] -n [namespace] --shared password [password] 
  

Note

The application slug and channel should have been previously provided to you. Contact your ITRS representative if you do not have the required information.

• Once the namespace has been created, you’ll see a link to the admin console in the command line. Using the password you set in the previous step, log in to the admin console.

• When prompted, upload your license file in the admin console.

Note

The license file should have been previously provided to you. Contact your ITRS representative if you do not have the required information.

• Supply the details required in the Install in airgapped environment screen, and then upload the airgap bundle from your computer.

Note

The airgap bundle should have been previously provided to you. Contact your ITRS representative if you do not have the required information.

• On the Configure Obcerv screen, set your options and then click Continue.

  • On the Prerequisites section, verify that the required packages have been installed. You can also opt to install Linkerd and Prometheus.
  • On the Cluster Settings section, select the appropriate cluster size based on your needs. For more information, see Sizing guidelines.
  • On the Host names section, specify the paths to the apps and ingestion host names you will use.
  • On the Obcerv Apps section, select the optional apps you want to install.
  • On the Credentials section, supply the default usernames and passwords for different types of admins and users.
  • On the TLS Certificates section, you can optionally upload your own certificate file for the host names.

• Once you have verified that your environment has met the prerequisites during the preflight checks, click Deploy. Once the status of all resources are confirmed ready, the install is completed.