4. Install a video appliance

4. Installing a video appliance #

A video appliance is used to route video traffic between appliances. It is the central component for the Nimbra Edge data plane through which all video streams are sent.

A video appliance should be the only thing running on a system. If it is run on a virtual machine the VM needs to have resources dedicated to it, as is most often the case in public cloud providers for example. For instance a video appliance should not run on the same system as an Edge Connect appliance or core. Co-locating the different components on the same system is strongly discouraged but for this tutorial we will make an exception.

Video appliances uses the RIST protocol to communicate with other appliances. Specifically it uses UDP ports 20000-21000.

Remember to ensure UDP ports 20000-21000 are open.

4.1 Installing the video appliance #

  1. In Network Manager, click Create new in the sidebar and select Core Video Appliance
  2. Choose a name (for example video-1). The region you created in previous step is selected by default
  3. Copy the generated install command and run it on the target machine.

The command will fetch the connectit CLI from your Nimbra Edge deployment and use the install video command to perform the installation.

Each time the dialog is opened, a new Appliance secret is generated. It is time-limited and valid for one appliance only.

Add video appliance dialog

If you get toomanyrequests errors, try login to Docker Hub.

sudo docker login

https://www.docker.com/increase-rate-limit

4.2 Find the appliance in Network Manager #

Once the appliance has started it will register itself with Nimbra Edge. It will then be visible under Appliances under ⚙ Settings.

Navigate to ⚙ SettingsAppliances and ensure the status of the appliance is green:

First video appliance

If there are issues with the appliance the status will be yellow or red. More information can be found under ⚙ Edit.

Appliance issue