Upgrading Labelbox customer-managed infra

The on-premise Labelbox platform is delivered using the Replicated platform. The delivery consists of the following:

  • KOTS package - this package provides the base Kubernetes binary and everything needed from a base infrastructure level.
  • Labelbox package - this consists of the Kubernetes manifest files and all the configuration files needed to deploy to KOTS.

Follow the directions below to upgrade both KOTS and the Labelbox application

KOTS upgrade

For upgrades to either the airgapped or non-airgapped environments, KOTS needs to be upgraded.

The following instructions are specific for non-airgapped instances

To upgrade KOTS in a non-airgapped environment, you will need to SSH into the instance and run the following commands:

curl -sSL https://k8s.kurl.sh/labelbox-kots-release-general-stable | sudo bash

Eventually all PODS should have a status of Running or Completed, except for the prediction-import-api POD. That service will be altered with the Labelbox application upgrade and won't be working at this stage in the process. To check on the status, you can run the following commands.

sudo bash -l
kubectl get pods

πŸ“˜

Note

At this stage of the upgrade process, the application will not be working until the Labelbox application upgrade is applied. This process could last up to 2 hours depending upon resources allocated on the instance.

The following instructions are specific for airgapped instances

Log into the Customer portal assigned to you and download the Latest Embedded Kubernetes Installer (a .tar.gz file)
Move the .tar.gz file to the KOTS instance (scp, sftp, etc)
Run the

tar xzvf <kotsinstaller>.tar.gz
cat install.sh | sudo bash -s airgap

πŸ“˜

Note

At this stage of the upgrade process, the application will not be working until the Labelbox application upgrade is applied. The KOTS Upgrade could last up to 2 hours depending upon resources.

Labelbox upgrade

The following instructions are specific for non-airgapped instances

The upgrade for the Labelbox application is done completely through the kots admin-console.

  1. Open then kots admin-console in web browser, typically at :8800
  2. Click Check for update
  3. Preflight checks will run for the new version(s) available, verifying enough system resources to run the new version.

πŸ“˜

Note

Occasionally the pre-flight will get hung up for no apparent reason. The preflight should be skipped in this instance to move on to the deployment. The pre-flight should take less than 10 minutes.

  1. After successful Preflight checks, click β€œDeploy”
  2. Once deployment is done, there should be a READY status on the Dashboard of the kots admin-console

The following instructions are specific for airgapped instances

  1. Open then kots admin-console in web browser, typically at :8800
  2. Click the Upload a new version link and select the Labelbox Airgap Bundle .airgap bundle file you downloaded.
    Preflight checks will run for the new version(s) available, verifying enough system resources to run the new 3. version.

πŸ“˜

Note

Occasionally the pre-flight will get hung up for no apparent reason. The preflight should be skipped in this instance to move on to the deployment. The pre-flight should take less than 10 minutes.

After successful Preflight checks, click Deploy
Once deployment from Kots is done, there should be a READY status on the Dashboard of the kots admin-console.
The upgrade should take between 15 and 20 minutes to rollout. You can check the status of the pods with this command:

watch kubectl get pods

Did this page help you?