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

If you already have installed on your infrastructure the legacy Video Server & Video Recording, make sure this Role is installed on a different Node.

Install Packages#

This Role consists of Video Server (WSC) and Video Recording (WSC). You need to install the latter only if you plan to record video meetings, otherwise you can install Video Server without Video Recording.

Warning

In case you install this Role on a Node which does not feature the Mesh & Directory Role, make sure the service-discover-agent package is installed as well.

# apt install carbonio-videoserver-advanced \
carbonio-videorecorder
# apt install carbonio-videoserver-advanced \
carbonio-videorecorder
# dnf install carbonio-videoserver-advanced \
carbonio-videorecorder
# dnf install carbonio-videoserver-advanced \
carbonio-videorecorder

Starting from 25.3 release, the /etc/janus/janus.jcfg configuration file will be updated automatically to include the Carbonio VideoServer public IP address (i.e., the one that will accept incoming connections to the Carbonio VideoServer) using a curl call.

However, this may be not true in case the Node setup has a different IP address for incoming and outgoing traffic, for example if the incoming traffic is routed to the Carbonio VideoServer node using IP address 203.0.113.102 and the outgoing traffic from the Node to the Internet is routed through IP address 203.0.113.105, the curl call would return the latter IP (105), but the actual IP in the configuration file should be the former (102).

Therefore, after the installation, make sure that the correct public IP address is present in the file: the line containing the nat_1_1_mapping variable should be:

nat_1_1_mapping = "203.0.113.102"

Finally, enable and start the service with the commands

# systemctl enable carbonio-videoserver.service
# systemctl start  carbonio-videoserver.service

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).

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 Notes#

You can enable the Video Recorder at 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.

Hint

You can mount on that location a dedicated disk or partition and keep it monitored for space usage.