Video Server & Video Recording (WSC)

Video Server & Video Recording (WSC)#

Before installing this Role on the Carbonio infrastructure, make sure that you installed the Mailstore & Provisioning, which is a requirement for this Role.

Note

This Role can not be installed on the same Node as Video Server & Video Recording.

Install Packages#

This Role consists of Video Server (WSC) and Video Recording. You need to install the latter only if you plan to record video meetings, otherwise you can install Video Server without Video Recording. For this reason we split this Role’s installation in two parts.

Warning

In case you install this Role on a Node which already features the Mesh and Directory Role, make sure you do not install the service-discover-agent package.

Video Server

Ubuntu

# apt install carbonio-videoserver-advanced service-discover-agent

RHEL

# dnf install carbonio-videoserver-advanced service-discover-agent

Bootstrap Carbonio#

Execute:

# carbonio-bootstrap

The bootstrap command will execute a number of tasks and will set up the node. At the end, you will be prompted with a menu and, if you already configured all, you only need to click y for confirmation.

On RHEL 9 only, restart the node to ensure that Carbonio service management come under the control of systemd:

# reboot

Join Carbonio Mesh#

Carbonio Mesh will install as an agent, that connects and communicates with the server. The configuration for the agent is created by launching command

# service-discover setup-wizard

This command will:

ask for the IP address and netmask of the current Node
ask for the Carbonio Mesh secret, which is stored in file /var/lib/service-discover/password on the Directory Leader Node (i.e., the node on which the Mesh server is installed)

In case the password is lost or the credential file becomes corrupted and unusable, you can reset them using the procedure detailed in section Carbonio Mesh Credentials.

Pending setups#

To complete Carbonio Mesh installation, run

# pending-setups -a

Hint

The secret is stored in file /var/lib/service-discover/password, which is accessible only by the root user.

The command will ask for the password stored in the /var/lib/service-discover/password on the Directory Leader Node (i.e., the node on which the Mesh server is installed).

Complete Carbonio VideoServer installation#

After the pending-setups command has completed, make sure that the Video Server’s IP address is present in the configuration file /etc/janus/janus.jcfg and add it if missing: find the variable nat_1_1_mapping and add it, for example:

nat_1_1_mapping = "93.184.216.34"

Check Video Server & Broker#

To make sure that videoserver and message broker are connected successfully, check that in the carbonio-videoserver logs (journalctl -u carbonio-videoserver) you find the line:

RabbitMQEventHandler: Connected successfullySetup of RabbitMQ event
handler completed

Video Recording#

To install the Video Recording packages, execute the command according to the underlying operating system.

Ubuntu

# apt install carbonio-videorecorder

RHEL

# dnf install carbonio-videorecorder

You can then enable the Video Recorder on a user, COS, or global level: please refer to section Configure Carbonio VideoServer Recording for directions.

A recorded session is temporary stored in directory /var/lib/videoserver/ on the Node featuring the Carbonio VideoServer Role: make sure that this directory has sufficient free space, otherwise recorded videos can not be stored. As soon as the recording session terminates, the file will be processed and moved to the Node featuring the Mailstore & Provisioning.