1. Installing the Nimbra Connect iT CLI #

The Nimbra Connect iT CLI is used to manage the Nimbra Connect iT installation. Its primary purpose is to install the Nimbra Connect iT core system and the video and thumb appliances. It has some secondary usages as well that we will touch on towards the end of this section.

The goal with this section is to install the Nimbra Connect iT CLI and see what options it provides.

While the Nimbra Connect iT CLI by itself has no dependencies and can run on any Linux system in order for it to do anything useful (such as installing the different components) the system needs the following dependencies:

• docker
• docker compose v2

1.1 Installing docker #

The Nimbra Connect iT installer requires docker and docker compose v2 to be installed on the system. How they are installed varies by operating system.

While many operating systems include docker and docker compose not all include docker compose v2. That is why you will follow the official docker installation instructions in this tutorial.

# Add Docker's official GPG key:
sudo apt-get update
sudo apt-get install ca-certificates curl
sudo install -m 0755 -d /etc/apt/keyrings
sudo curl -fsSL https://download.docker.com/linux/ubuntu/gpg -o /etc/apt/keyrings/docker.asc
sudo chmod a+r /etc/apt/keyrings/docker.asc

# Add the repository to Apt sources:
echo \
  "deb [arch=$(dpkg --print-architecture) signed-by=/etc/apt/keyrings/docker.asc] https://download.docker.com/linux/ubuntu \
  $(. /etc/os-release && echo "$VERSION_CODENAME") stable" | \
  sudo tee /etc/apt/sources.list.d/docker.list > /dev/null
sudo apt-get update

# Install the docker packages
sudo apt-get install docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin

# Add Docker's official GPG key:
sudo apt-get update
sudo apt-get install ca-certificates curl
sudo install -m 0755 -d /etc/apt/keyrings
sudo curl -fsSL https://download.docker.com/linux/debian/gpg -o /etc/apt/keyrings/docker.asc
sudo chmod a+r /etc/apt/keyrings/docker.asc

# Add the repository to Apt sources:
echo \
  "deb [arch=$(dpkg --print-architecture) signed-by=/etc/apt/keyrings/docker.asc] https://download.docker.com/linux/debian \
  $(. /etc/os-release && echo "$VERSION_CODENAME") stable" | \
  sudo tee /etc/apt/sources.list.d/docker.list > /dev/null
sudo apt-get update

# Install the docker packages
sudo apt-get install docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin

1.2 Installing the Nimbra Connect iT CLI #

The Nimbra Connect iT CLI is what is used to manage the installation as well as install and uninstall the different components.

curl --output connectit https://docs.cnctit.io/releases/connectit-R3.22.0
chmod +x connectit

Test that the CLI works by running ./connectit --help

$ ./connectit --help
Use this CLI to use and manage Nimbra Connect iT installations.
For example generating the docker compose files needed to get a Nimbra Connect iT installation up and running.

Usage: connectit <COMMAND>

Commands:
  install    Install a Nimbra Connect iT component
  uninstall  Uninstall a Nimbra Connect iT component
  region     Manage regions
  backup     Create, get and restore backups
  help       Print this message or the help of the given subcommand(s)

Options:
  -h, --help
          Print help (see a summary with '-h')

  -V, --version
          Print version

Examples:

# Install Nimbra Connect iT core system
./connectit install core

# Install Nimbra Connect iT video appliance
./connectit install video --url https://example.test --name video-0

# Install Nimbra Connect iT thumbnail appliance
./connectit install thumb --url https://example.test --name thumb-0

The CLI help provides details on the various command and options it has and can be very helpful when managing your Nimbra Connect iT installation.

1.3 Exploring the CLI #

The CLI has a number of subcommands that you can list with the --help flag. To get more information about a specific subcommand simply add --help after the subcommand, for example if we are interested in what you can install you can run:

$ ./connectit install --help
Install a Connect iT component.

You likely want to start by installing Connect iT core. Once that is installed you can proceed with the video and thumb
appliances.

The video and thumb appliances require a Connect iT or Nimbra Edge system to connect towards.

Usage: connectit install <COMMAND>

Commands:
  core   Install Connect iT Core, the control-plane and the web-interface of Connect iT
  video  Install a video appliance to this machine, used for routing video traffic
  thumb  Install a thumb appliance to this machine, used for generating thumbnails
  help   Print this message or the help of the given subcommand(s)

Options:
  -h, --help
          Print help (see a summary with '-h')

Try a couple of different subcommands and read their help outputs to get a feel for what the CLI is capable of.