3. Install a video appliance

3. Installing a Connect iT video appliance #

A Connect iT video appliance is used to route video traffic between appliances. It is the central component for the Connect iT 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 a thumb appliance or Connect iT 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.

3.1 Installing the video appliance #

To install a video appliance you need the domain of Connect iT core (from the previous section) and the admin password. You will also need to decide on a name for the appliance, in this tutorial we will simply call it video-1.

Appliances can be part of different regions. This is a way for you to organize your Connect iT system for redundancy and to manage a global network. You can specify the region of an appliance with the --region flag. In this tutorial we will not be specifying the region which means they will all end up in the main region.

sudo ./connectit install video --url https://<domain> --name video-1

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

sudo docker login

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

3.2 Find the appliance in Network Manager #

Once the appliance has started it will register itself with the Connect iT core system. 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. Either hover the status icon or press the gear icon (⚙) to get more information

Appliance issue