Digital Content Manager Version 21.00 Installation Guide
Digital Content Manager Version 21.00 Installation Guide
YOUR USE OF THIS DOCUMENT AND ANY ASSOCIATED PRODUCT IS SUBJECT TO THE TERMS AND
CONDITIONS OF THE AGREEMENT THAT IS IN PLACE BETWEEN YOU AND SYNAMEDIA. SHOULD THERE
BE NO AGREEMENT IN PLACE, THEN YOU ARE NOT AUTHORIZED TO USE THIS DOCUMENT OR THE
ASSOCIATED PRODUCT.
SYNAMEDIA IS THE BRANDING USED BY SYNAMEDIA GROUP AND ITS AFFILIATES. THE BRAND
TOGETHER WITH ANY ASSOCIATED LOGO MAY BE A REGISTERED TRADEMARK IN CERTAIN
JURISDICTIONS. YOU MAY NOT USE THE BRANDING WITHOUT THE SPECIFIC PERMISSION OF
SYNAMEDIA GROUP. SYNAMEDIA GROUP RESERVES ALL ITS RIGHTS IN RESPECT TO THE USE OF ITS
BRANDING.
Table of Contents
Table of Contents 3
Preface 5
Audience 5
Conventions 5
Related Documentation 6
Preface
This section describes the audience and conventions of the Digital Content Manager Installation Guide.
It also references related documentation.
Audience
The audience of this guide includes users and service personnel who are responsible for installing the
Digital Content Manager.
Conventions
This document uses the following formatting conventions.
Conventions Indication
bold typeface Syntaxes, commands and keywords, as well as menu items and settings to be
selected or entered by the user.
italic typeface Document names and titles, new or emphasized terms, and arguments for which
user-specific values are to be defined.
[] Instructions and other elements between square brackets are optional.
{x|y|z} Required alternative keywords are grouped between braces, and separated by
vertical bars.
[x|y|z] Optional alternative keywords are grouped between square brackets, and
separated by vertical bars.
Monospace Terminal sessions and textual information returned by the system
<> Non-printed characters such as passwords are shown in angled brackets.
!, # An exclamation point (!) or a pound sign (#) at the beginning of a line of code
indicates a comment line.
Note Notes generally contain helpful suggestions, remarks, or references to topics covered
elsewhere in this or other documents.
Caution entries will be added to topics where the user needs to be aware of actions or
situations that might result in equipment malfunctioning, loss of data, or other unwanted
events.
A Warning will be added wherever a risk of personal injury and/or equipment damage
Related Documentation
The following list shows the publications for the Digital Content Manager.
You can download DCM documentation from Synamedia's Software & Documentation Downloads
portal: https://www.portal.synamedia.com.
Note To access this page, an account is required. Contact your Synamedia account manager or
support representative for a registration code or complete the form here:
https://www.synamedia.com/about/#contact.
CHAPTER 1
Minimum Requirements 8
Installing CentOS 7 17
Installing Oracle 8 18
Minimum Requirements
The following items or settings are required before installing the Digital Content Manager.
You can download the Digital Content Manager software from the following location:
https://www.portal.synamedia.com.
To access this page, an account is required. If you need a registration code to set up an account,
contact your account manager or support representative or complete the form here:
https://www.synamedia.com/about/#contact.
■ CPU must support the AVX2 instruction set to run the MPEG-2, AVC, or HEVC processing
applications. AVX2 is optional for other applications.
■ At least one configured network interface is needed. Although management and video can use the
same interface, it is recommended to keep them separate for performance reasons. Up to 2
interfaces can be used for management, up to 8 interfaces can be used for video, and up to 8
interfaces can be used for SDI-over-IP.
Note
■ With the exception of use-case SDI-over-IP input combined with video output, the
SDI-over-IP interfaces cannot be shared with video interfaces even with VLAN
delineation.
■ Interfaces for SDI-over-IP input cannot be combined with interfaces for SDI-over-
IP output.
■ For SDI-over-IP interfaces, a dedicated 10G or 25G network interface card (NIC) is required. This
feature is validated with the following NICs:
— 10G NIC: Cisco VIC 1340 & 1227 and Intel X520.
— 25G NIC: Mellanox ConnectX-5
OS dependency is documented above in the relevant OS section. If you wish to use other NICs,
please contact your Synamedia representative.
■ A reachable NTP server and/or PTP server if the host has PTP capable interfaces. (Time
synchronization must be configured through the install wizard or vdcm-configure. Configuration by
manually editing config files is no longer supported).
■ Optional: secure internet connectivity to receive operating system updates.
■ Ensure that the network interfaces are configured properly.
■ For virtualization:
To access this page, an account is required. If you need a registration code to set up an
account, please contact your account manager or support representative or complete the form
here: https://www.synamedia.com/about/#contact.
Note For virtualization of the xgress node, running in a virtual machine can result in lower
performance compared to bare metal. Configuring the hypervisor and virtual
machine for latency sensitive workloads can bring the performance back to the same
level as bare metal. For more information, see
https://www.vmware.com/files/pdf/techpaper/VMW-Tuning-Latency-Sensitive-
Workloads.pdf.
■ K9 installation
— Boot the system. Default OS login = root, OS password= password, change this after initial
login.
— The Digital Content Manager application is preinstalled on the system. It still needs to be
configured.
— First, configure the network interfaces for management, video and optionally SDI-IP. Make sure
that each interface has a valid IPv4 address.
— Run the vdcm-configure wizard. For more details, see Installing the DCM Using the Interactive
Procedure, on page 21.
■ If a central license management system is used, prior to upgrading DCM to Version 20.1 or later,
you must first install Video Service Manager (VSM) Version 12.3.0 or later. If you upgrade the DCM
first, the licensing status changes to 'Evaluation' and you will have two days to install VSM Version
12.3.0 or later to change the status back to 'Authorized'.
Model 1
'Model 1' appliances offer a UEFI configuration option to help in tuning the BIOS settings by using
known workload-based tuning profiles. When a certain workload profile is applied in the BIOS
configuration menu, the server will automatically configure a range of BIOS settings to match the
selected workload profile. When running DCM software on a 'Model 1' computappliance, the workload
profile High Performance Compute (HPC) should be applied, and Hyperthreading should be
enabled. This profile will apply following BIOS settings:
CPU Configuration
Chipset Configuration -> North Bridge -> IIO Configuration -> Intel VT for Directed I/O (VT-d)
ACPI Settings
M3/M4 Servers
The following table lists the recommended BIOS settings for Cisco M3/M4 servers:
M5 Servers
The following table lists the recommended BIOS settings for Cisco M5 servers:
These settings can be configured in Linux, using either NetworkManager or legacy configuration scripts
under /etc/sysconfig/network-scripts. For Cisco servers, these settings can also be confugured in Cisco
UCS Manager (Ethernet Adapter Policy - Cisco B-Series).
For optimal performance of SDI-over-IP feature all settings (BIOS, CPU, interface, and so on) must be
configured as per the recommendation in this section.
Installing CentOS 7
The Digital Content Manager installer delivers all the required dependencies and can be installed on a
minimal CentOS 7 without an internet connection. However, we highly recommend that you have an
internet connection or a local up-to-date rpm repository to receive and install security updates.
Procedure
Step 1 Log in to the CIMC GUI for the UCS box and open the KVM console.
Step 2 From the KVM console menu, choose Virtual Media > Activate Virtual Devices .
Step 3 Choose Virtual Media > Map CD/DVD to specify a path to the ISO image.
Step 4 After mapping this image, reboot the box and boot from the ISO. This can be done in one
of two ways:
■ Press <F6> while the system is starting up to show to the boot menu, and select KVM
Mapped DVD.
■ Change the boot order in the CIMC web GUI and set a KVM mapped DVD type as the
first boot device. The boot order in the CIMC web GUI can be accessed from Server >
BIOS and selecting Configure Boot Order.
Step 5 Once the system boots from this ISO, choose Install CentOS 7 from the menu.
Step 6 Manually specify the installation options. For UCS systems, only one disk must be visible
(with a capacity of 500 GB). The operating system must be installed on this disk. If a prior
installation of an operating system exists, choose a reclaim space option, which allows
the installer to wipe the drive and remove all existing partitions before starting the
install. Choose Software Selection > Minimal Install.
Step 7 Once the options specified above have been selected, click Begin Installation.
Installing Oracle 8
The Digital Content Manager installer delivers all the required dependencies and can be installed on a
minimalOracle 8 without an internet connection. However, we highly recommend that you have an
internet connection or a local up-to-date rpm repository to receive and install security updates.
Procedure
Step 1 Log in to the CIMC GUI for the UCS box and open the KVM console.
Step 2 From the KVM console menu, choose Virtual Media > Activate Virtual Devices .
Step 3 Choose Virtual Media > Map CD/DVD to specify a path to the ISO image.
Step 4 After mapping this image, reboot the box and boot from the ISO. This can be done in one
of two ways:
■ Press <F6> while the system is starting up to show to the boot menu, and select KVM
Mapped DVD.
■ Change the boot order in the CIMC web GUI and set a KVM mapped DVD type as the
first boot device. The boot order in the CIMC web GUI can be accessed from Server >
BIOS and selecting Configure Boot Order.
Step 5 Once the system boots from this ISO, choose Install Oracle 8 from the menu.
Step 6 Manually specify the installation options. For UCS systems, only one disk must be visible
(with a capacity of 500 GB). The operating system must be installed on this disk. If a prior
installation of an operating system exists, choose a reclaim space option, which allows
the installer to wipe the drive and remove all existing partitions before starting the
install. Choose Software Selection > Minimal Install.
Step 7 Once the options specified above have been selected, click Begin Installation.
Step 8 Boot into the latest 4.18.0 kernel, and then remove the kernel-uek:
dnf –y remove kernel-uek
CHAPTER 2
This chapter describes how to install and set up the Digital Content Manager. It consists of the
following sections:
For systems without access to the internet, the offline installer must be used (vdcm-installer-
<version number>.el7.zip). On systems with access to the internet, both the offline and the online
installer can be used. The online installer is vdcm-installer-online-<version number>.el7.zip.
When the online installer is used, the host must have a working connection to the following yum
repos: Centos-Base, Centos-Updates, Centos-Extras, and EPEL. If one of these repositories is not
enabled, enable it before continuing. For example, enable EPEL via:
yum install epel-release
Check that all repos are functional: yum makecache should not return any errors and must exit with
exit code 0. When in doubt, use the offline installer.
Unless mentioned otherwise, the following procedure assumes that you are using the offline installer.
The commands and output for the online installer are similar.
The installer supports an interactive wizard that guides you through the initial installation, and a non-
interactive mode which is more suitable for expert, automated, or batch configuration.
■ rhel-7-server-rpms
■ rhel-7-server-beta-rpms
■ rhel-7-server-optional-rpms
■ rhel-7-server-extras-rpms
subscription-manager repos \
--enable="rhel-7-server-rpms" \
--enable="rhel-7-server-beta-rpms" \
--enable="rhel-7-server-optional-rpms" \
--enable="rhel-7-server-extras-rpms"
Step 1 Download the Digital Content Manager software installer file and extract the zip file to a
location of your choice (for example, /tmp/).
Note The installer extracts into the /tmp directory and runs a setup from there.
Some systems do not allow to execute from /tmp. The installer has an
argument --tmp <DIRECTORY>. This command extracts the content to this
specified directory and runs the installer from there.
Step 4 Before starting the installation, several pre-checks are performed to assess if the platform
you are installing on is suited for installing the Digital Content Manager software. The
following pre-checks are performed:
■ Disk size
■ Memory size and setup
■ CPU feature
■ OS version and type
If any of the pre-checks fails, then an error or a warning is raised. A warning allows you to
carry on installing, an error stops the installation.
Step 5 Once the software is installed, the installation wizard guides you through configuring the
following items:
■ Selecting the Ethernet interfaces for both management, video, and SDI IP (SDI-over-
IP).
■ Reverse path filtering enabling or disabling.
■ Passphrase policy configuration.
■ Setting up of the users for GUI, IIOP and REST.
■ Authentication method configuration (local or RADIUS)
■ Firewall enabling or disabling. For SDI-over-IP, the firewall must be disabled to
achieve maximum performance. In particular, FullHD is not supported with the
firewall enabled.
Step 6 Once the installation wizard has completed, the configuration of the system is checked
and fixed where applicable. Fixes, that cannot be performed automatically or that require
user input, are reported and must be resolved before running the software.
Step 1 Download the appropriate Digital Content Manager software installer file and extract the
zip file to a location of your choice (for example, /tmp/).
Step 2 Run the following command:
chmod +x vdcm-installer-<version number>.el7.sh
Step 3 (Optional) The installer has many optional arguments to automatically configure the
Digital Content Manager after installation. You can run the installer with the argument -
-help to get a list of all possibilities.
./vdcm-installer-<version number>.el7.sh --help
If no configuration arguments are supplied, and Digital Content Manager was not previously enabled
on the system, the default values are used to configure the Digital Content Manager. These defaults
enable all Digital Content Manager features. If (a previous version of) Digital Content Manager was
already enabled on the system, the existing feature selection will be left unchanged.
The installer supports an interactive wizard that guides you through the initial installation, and a non-
interactive mode which is more suitable for expert, automated, or batch configuration.
Step 1 Download the Digital Content Manager software installer file and extract the zip file to a
location of your choice (for example, /tmp/).
Note The installer extracts into the /tmp directory and runs a setup from there.
Some systems do not allow to execute from /tmp. The installer has an
argument --tmp <DIRECTORY>. This command extracts the content to this
specified directory and runs the installer from there.
Step 4 Before starting the installation, several pre-checks are performed to assess if the platform
you are installing on is suited for installing the Digital Content Manager software. The
following pre-checks are performed:
■ Disk size
■ Memory size and setup
■ CPU feature
■ OS version and type
If any of the pre-checks fails, then an error or a warning is raised. A warning allows you to
carry on installing, an error stops the installation.
Step 5 Once the software is installed, the installation wizard guides you through configuring the
following items:
■ Selecting the Ethernet interfaces for both management, video, and SDI IP (SDI-over-
IP).
■ Reverse path filtering enabling or disabling.
■ Passphrase policy configuration.
■ Setting up of the users for GUI, IIOP and REST.
■ Authentication method configuration (local or RADIUS)
■ Firewall enabling or disabling. For SDI-over-IP, the firewall must be disabled to
achieve maximum performance. In particular, FullHD is not supported with the
firewall enabled.
Step 6 Once the installation wizard has completed, the configuration of the system is checked
and fixed where applicable. Fixes, that cannot be performed automatically or that require
user input, are reported and must be resolved before running the software.
Step 1 Download the appropriate Digital Content Manager software installer file and extract the
zip file to a location of your choice (for example, /tmp/).
Step 2 Run the following command:
chmod +x vdcm-installer-<version number>.el8.sh
Step 3 (Optional) The installer has many optional arguments to automatically configure the
Digital Content Manager after installation. You can run the installer with the argument -
-help to get a list of all possibilities.
./vdcm-installer-<version number>.el8.sh --help
If no configuration arguments are supplied, and Digital Content Manager was not previously enabled
on the system, the default values are used to configure the Digital Content Manager. These defaults
enable all Digital Content Manager features. If (a previous version of) Digital Content Manager was
already enabled on the system, the existing feature selection will be left unchanged.
Note This section describes important extra steps required to install Digital Content Manager
software on Oracle 8 systems managed by UEFI with secure boot enabled.
Since Linux kernel version 4.4.0, user-installed kernel modules must be signed on systems with secure
boot enabled. If you are not sure if this configuration is applicable to your system, please check the
following:
mokutil --sb-state
When this command returns the information that SecureBoot is enabled, your system is UEFI managed
with secure boot enabled. Anything else means that it is not.
If you install the Digital Content Manager on such a system, the installation will fail, returning an error
indicating that the installation procedure could not install the Synamedia kernel modules due to a
missing key. In order to install the Synamedia kernel key, the following procedure must be followed.
Procedure
Step 1 After installation of the Digital Content Manager software, add the Synamedia key by
executing as root:
mokutil --import /etc/ssl/certs/synamedia_kmod.der
Step 2 The tool will prompt you for a password that you will need to complete Step 9 below.
This is only a temporary password, so you can choose any password you like.
To verify whether these actions have worked correctly, mokutil --list-new must list the
new key.
Step 3 Enroll the key to the kernel by powering off your machine, and enable the option to start
up in the UEFI manager at the next boot:
Step 4 Next, boot your system and enroll the key. Go to Boot normally in the EFI setup screen
and enter:
Step 5 Press any key within 10 seconds to enter the MOK manager:
Step 7 Optionally, you can view and verify the key that you are going to enroll. Next, go to
Continue:
Step 9 Next, enter the password that was chosen in Step 2. After this, the password will not be
needed anymore.
Step 11 When the system is up again, you use vdcm-configure check to verify that there are no
more errors. For more information about this, refer to Checking and Fixing the
Configuration, on page 41.
Another way to install the specific Digital Content Manager version is using vdcm-repo as described in
previous topic. This only works if the rpms of the specific Digital Content Manager version are
available on the local rpm repository, or in another repository that is configured in yum and is
accessible.
Note The following option is only available if the already installed Digital Content Manager
version, as well as the version that will be installed, are both higher than or equal to
V20.2.0.
A third way to upgrade, downgrade or reinstall the Digital Content Manager is via the GUI. Upload the
zip file obtained from the Synamedia portal (Configuration > Node > Version Info) and click on the
Install icon in the Installer Repository list. A web server in which the upgrade progress can be followed,
will pop up. The same two actions (upload and install) can also be performed via REST; refer to the
REST documentation for details.
Note These advanced options can only be used with the offline installer.
Hosting such a repository on your network enables you to roll out updates to all your machines at
once.
To perform the final upgrade of the package, use the vdcm-repo command. This command is installed
with the vdcm-local-repo RPM.
■ To install a specific version, use the following command, in which <actual version number> is the
version you want to install:
vdcm-repo install vdcm-<actual version number>
This argument causes all other rpm repositories to be temporarily disabled. The installation will be
done only from the newly created or updated local rpm repository.
Note We strongly advise you to install the first card in the first PCIe slot of the server. This
prevents problems if a second card must be installed.
Procedure
Step 2 To check the board type and installed firmware timestamp, type the following command,
where <board number> is the board number (0, 1, and so on):
./ntv2firmwareinstaller -b <board number> -i
Step 3 Check the firmware timestamp (dd-mm-yy) in the provided Corvid88 .bit file. If the
timestamp of the installed firmware (output of previous command) is older than the
timestamp in the provided firmware file, or if the output does not display a firmware
timestamp, update the firmware.
Step 4 To update the firmware, enter the following command, where <Corvid88 file> is the
provided firmware file:
Step 5 Repeat Step 1 to Step 3 for each board that is connected to your host.
Note Rebooting the operating system is not sufficient. The server must be shut
down completely.
Step 9 Enter the following command for each board to verify if the new firmware is loaded on all
boards:
./ntv2firmwareinstaller -b <board number> -i
The DTA-2174B and DTA-2178 card can be configured in three different firmware variants.
To check the actual variants of the DekTec cards present in the server, use either the command:
/opt/vdcm/share/dektec/DtInfoCL64
or:
/opt/vdcm/share/dektec/DtEpc64 -d 0
An example output of the DtInfoCL64 command for a server with one DTA-2178 card is shown
below:
An example output of the DtPce64 command for a server with a DTA-2172 and a DTA-2174B card is
shown below:
In order to change the firmware of the DTA-2174B card to variant 2 in the latter example, apply the
DtEpc64 command with the option -d to select the device, and the option -fv to select the
firmware variant:
Procedure
Step 1 Remove any previously installed DCM software after logging in to the device as root and
entering one of the following commands:
Step 2 To successfully install the Rivermax software, ensure that you have an Internet
connection. If you do not have an Internet connection, contact the Synamedia Customer
Service Desk for assistance.
Step 3 To check which card is installed, run the following command as root:
lspci | grep Mellanox | awk '{print $1}' | xargs -i -r lspci -vv -s {} |
grep -A10 "Vital Product Data"
Rivermax can work with either the MLNX_EN package or the MLNX_OFED package. Only
the MLNX_EN option is described here, since the package is much smaller in size and will
take less time to download and install. The card firmware is included in the package and
will also be updated when MLNX_EN is installed.
Step 6 If a message appears informing you that the drivers need to be rebuilt, follow the
instructions by running the install and append --add-kernel-support.
Step 7 If a message appears informing you that there are conflicting packages between external
repos and the vdcm-deps repo, do the following:
Step 8 If you have a previous version of Rivermax installed, you must uninstall it before installing
a new version.
yum remove rivermax
Step 9 Obtain the Rivermax package directly from Mellanox or a reseller. Next, install it by
executing the following commands:
■ For CentOS 7:
■ For Oracle 8:
Step 11 Install the DCM software. For more information, refer to Installing the Digital Content
Manager for CentOS 7, page 20, or Installing the Digital Content Manager for Oracle 8,
page 23.
Example output:
OFED: 5.2-1.0.4.0
VMA: 9.2.2-1
IBVERBS: 52mlnx1-1.52104
Rivermax: 11.1-7.18 (1.6.18)
enp134s0f0 mlx5_core 5.2-1.0.4 172.18.9.2
enp134s0f1 mlx5_core 5.2-1.0.4 172.18.10.2
Licensed to: xxxxxxxxxxxxxxx
Compiled for version 11.1.7.18
Note If the Rivermax software is installed, the DCM will not show the option to enable ultra
high throughput mode with netmap, because the netmap and Rivermax software are not
compatible with each other.
When the device is able to access the CentOS update repositories on the internet, or if you have a
mirror of them available on your network, the following procedure can be applied:
Procedure
When the device is not able to access the OS update repositories on the internet and if you do not
have a mirror of them available on your network, you will need to carry out the procedure below:
Procedure
Step 1 Download the upgraded rpm package and all of its dependency rpms from a repository
corresponding to the version of the OS you are using, e.g. from
https://www.centos.org/centos-linux/ for CentOS 7, or https://yum.oracle.com/oracle-
linux-8.html for Oracle 8.
Step 2 Copy the rpm packages to a directory on the device, using secure copy.
CHAPTER 3
Configuring Interfaces 42
Configuring Features 43
Configuring Users 43
Configuring NMOS 44
By default, vdcm-configure runs in interactive mode; use the option --non-interactive for non-
interactive processing.
The vdcm-configure wizard command allows the user to re-run the installation wizard in interactive
or non-interactive mode, with all the same options as the installer.
There are specific commands, described below, to configure specific settings without running through
the entire wizard, each having an interactive or a non-interactive mode. These generally mirror the
wizard in interactive mode or non-interactive options.
Aside from the wizard options, some commands have additional options not supported by the wizard,
such as --status to query the current status.
The vdcm-configure check and vdcm-configure fix commands check for configuration errors and
apply fixes where possible.
Note The following procedures use the vdcm-configure script which resides in /opt/vdcm/bin.
The software adds this location into the PATH environment variable, making the
shorthand version available for all users. Make sure to log on again for this change to
take effect. Otherwise, you can use the full file path to the script in the following
commands.
This command attempts to fix as many issues automatically (for example, configure the firewall
daemon according to the selected mode of operation for this device) or interactively (for example,
select the networking interfaces to use for management and video traffic). If an issue is not fixable
automatically or interactively, the script indicates what you can or must do to fix the issue.
Some fixes are only available in interactive mode because they require user input. These are skipped
when --non-interactive is passed. It is possible to limit check and fix to a specific subset with the -i
option, however using this option is not recommended unless advised by TAC. See vdcm-configure
check --help for a list of valid arguments to the -i option.
Configuring Interfaces
Assigning Interfaces
Assign the network interfaces to be used for management, video, and SDI-over-IP:
At least one management interface and one video interface (regular video or controlled video) needs
to be configured. This can be the same network interface. The maximum number of interfaces that can
be configured:
■ management: 2
■ video (regular and controlled combined): 8
■ SDI-over-IP: 8
Management interfaces, regular video interfaces and SDI-over-IP interfaces require an IPv4 IP address.
Controlled video does not require an IPv4 address — although it is allowed. Controlled video interfaces
are not allowed to be VLAN interfaces, but rather parent interfaces for VLANs.
With a controlled video interface, one can create or delete VLAN network interfaces from within the
GUI with this controlled network interface as a parent.
If you configure a network interface (e.g. eth2) as a controlled interface, you can create a new VLAN
interface with its VLAN ID and IP address from within the GUI (e.g. eth2.1201), and use this new VLAN
without restarting the software for IGMP joins by selecting the correct VLAN or TS output by entering
the VLAN ID in the Advanced Settings.
Deleting a VLAN does require a restart of the software. If the controlled interface has an IP address, it
can be used within the software by specifying the non-existent VLAN ID 0. Not all DCM features are
supported with controlled video — features like hitless merge and port-pair-mirroring, for example.
In non-interactive mode, it is sufficient to specify the interface options on the command line in the
desired order, for example:
vdcm-configure set-interface --non-interactive --mgmt mgmt1 --video video1 --ctrlvideo
video2 --video video3
In interactive mode, first the interfaces to configure are selected. Then, if more than one interface is
selected, a menu will be presented to select the desired order.
Configuring Features
Select whether this Digital Content Manager must run with the GUI, REST, ESAM, GQI, MFP monitor,
Splicer, SNMP, Diagnostics, HA sync, DekTec, KMS Proxy, Local Origin Server, NMOS, External IIOP
and/or Secure IIOP. If the Digital Content Manager must run with all of these features, run the
following command:
Hint: You can choose the optional features that you want to enable, such as the GUI, REST, ESAM, GQI,
MFP monitor, Splicer, SNMP, and so on:
vdcm-configure service --enable-gui --enable-rest --enable-esam --enable-gqi --enable-
mfp-monitor --enable-splicer --enable-snmp --enable-diagnostics --enable-hasync --
enable-dektec --enable-kmsproxy --enable-local-origin-server --enable-nmos --enable-
external-iiop --enable-secure-iiop
Configuring Users
The Digital Content Manager software uses PAM to authenticate users (see /etc/pam.d/vdcm*),
directing the requests to a custom Python script that compares the authentication details with the
users database. This database can be manipulated using the vdcm-configure user command,
supporting extra and removal of users, changing passphrases, and changing roles. The available roles
are IIOP admin, REST user, GUI admin, GUI automation, GUI user, and GUI guest. If you have a
management system like VSM, configure credentials to allow access.
If the GUI is to be enabled, add GUI users to authenticate with the GUI service using the following
command:
vdcm-configure user --add <username> --passphrase <passphrase> --gui-admin
If REST is to be enabled, add users to authenticate with the REST service using the following
command:
vdcm-configure user --add <username> --passphrase <passphrase> --rest-user
Note Unless IPsec or another form of host-to-host security is used, the credentials that you
change over a network connection may be visible to others.
Configuring NMOS
Note NMOS configuration is only supported on CentOS 7.
The Digital Content Manager package includes the installation of NMOS (Networked Media Open
Specifications), an AMWA product which provides discovery, registration and control for the SMPTE
ST2110 suite. The DCM provides support to manually add a registry or to perform automatic
registration with unicast DNS or multicast DNS discovery following the DNS Service Discovery
protocol.
This will show the NMOS API port, indicate whether manual or automatic registration is
enabled/disabled, and show the corresponding configuration options. It will also show the registration
status and the selected NMOS registry address, if automatic discovery is enabled.
This tool will ask you if you wish to change the API port, and if you want to use manual or automatic
discovery. For manual discovery, a registry IP will be needed in the form of <IP> or <IP>:<port>. For
automatic discovery, the tool will ask you if you want to enable or disable unicast DNS discovery, and
multicast DNS discovery. For unicast DNS discovery, if required, name servers and a search domain
can be specified.
where:
<REGISTRY> is the registry used for manual discovery mode (when applicable).The format is <IP>
or <IP>:<PORT>.
<NAMESERVERS> is a space-delimited list of name servers used for unicast DNS discovery (when
applicable).
<SEARCHDOMAIN> is the search domain for unicast DNS discovery (when applicable).
Note If the registry is specified, the DCM will assume manual discovery mode and will ignore all
options regarding unicast/multicast DNS discovery, if provided.
Tip: the entire NMOS configuration help section can be displayed upon entering:
vdcm-configure nmos –help
Collectd and Influxdb are configured with the supplied configuration in the installer.
To apply the diagnostics configuration to Collectd and Influxdb, type the following vdcm-configure
command:
vdcm-configure diagnostics --configure
By default, all the diagnostic services are disabled. To enable the diagnostic services, type the
following vdcm-configure command:
vdcm-configure diagnostics --enable
Note
■ When diagnostic services are enabled, the configuration is performed automatically and the
dashboards are installed in Grafana.
■ When a new Digital Content Manager version is installed and the diagnostic services are
enabled, the new diagnostics configuration is applied automatically.
Automatic Configuration
The configuration tool vdcm-configure can set up a Grafana instance. It configures the data sources
and uploads the Digital Content Manager dashboards. This action is done automatically by enabling
the diagnostics service or all services or to run vdcm-configure diagnostics --configure. To perform the
Grafana setup manually run:
vdcm-configure diagnostics --configure-grafana
Grafana requires administrator rights to set up data sources. The configuration of Grafana is done with
the default Grafana credentials. If authentication does not succeed, a username and password are
asked. A Grafana username and password can be provided as arguments.
vdcm-configure diagnostics --configure-grafana --grafana-user admin --grafana-password
admin
Manual Configuration
Procedure
Step 1 Ensure that diagnostics is enabled. For more information, see Configuring the
Diagnostics, on page 46.
Step 2 From the Digital Content Manager GUI, choose Help > Diagnostics.
Step 3 Click the Node tab and then click the Open Grafana in a new tab/window link in the
Debug Mode area.
Step 4 Log in to Grafana. The default user is admin, and the default password is admin. We
highly recommend that you maintain a more secure password policy for Grafana.
Step 5 Add data sources in Grafana:
a) If no organization has been configured yet, create one in the Server Admin field.
b) In the Settings field, select Data Sources.
c) Click Add data source and select InfluxDB.
d) In the Name field, enter local-collectddb.
e) From the Type drop-down list, choose InfluxDB.
f) In the Url field, enter http://localhost:8086.
g) In the Database field, enter collectddb.
h) In the User field, enter admin, and in the Password field, enter admin.
i) Click Save & Test.
Step 6 Configure a second data source:
a) In the Settings field, select Data Sources.
b) Click Add data source.
c) In the Name field, enter local-vDCMdb.
d) From the Type drop-down list, choose InfluxDB.
e) In the Url field, enter http://localhost:8086.
f) In the Database field, enter vDCMdb.
g) In the User field, enter admin, and in the Password field, enter admin.
h) Click Save & Test.
Step 7 Import a Digital Content Manager dashboard:
a) From the Digital Content Manager web GUI, choose Help > Diagnostics.
b) In the Debug Mode area, click the Download the Diagnostics Templates link.
c) Extract the ZIP file containing the template JSON files.
d) Refer to the Grafana window.
e) In the Create field, click Import.
f) Click Upload .json File.
g) Select the template you wish to import.
h) From the local-vdcmdb drop-down list, choose local-vDCMdb.
i) If the local-collectdb field is displayed, choose local-collectddb from the drop-down
list.
j) Click Save & Open. The diagnostic graphs are displayed. The following is an example: