This chapter describes management and usage of the licensing system based on CodeMeter from WIBU Systems available in Viz Engine 3.10 and later. It replaces the previous VALID/Sentinel/Hardlock Dongle licensing system and allows Viz Engine to be used without a physical dongle on each machine, by allocating licenses from a license server on the network.

This section contains the following information:

Important Pre-installation Information
Key Features and Workflow of the New Licensing System
Limitations and Known Issues
Basic Set-up
Configuration Settings
WIBU License System
Notes
Setup Graphic Hub Journal-based E-Mail Notifications
Setup Redundancy for a WIBU License Server

Important Pre-installation Information

The WIBU licensing system requires the installation of the CodeMeter Runtime Software (included in the Bundle installer):

6.60a for 3.10.0 - 3.12.0
6.80 for 3.12.1 and newer
7.20 for 4.1 or newer
7.21a for 4.3 or newer
7.40 for 4.4.1, 5.0 or newer

When the license should be retrieved from a dedicated license server, it must be configured in the Vizrt Licensing Service (see Client Configuration page in the License Server Setup and Administration section of the Vizrt Licensing Administrator Guide) or the CodeMeter WebAdmin.

Information: There is an auto discovery if no license server is configured in the server search list of CodeMeter.

Information: On network disconnect and reconnect, it may happen that a license is checked out twice. In this case, it must be released manually on the CodeMeter service on the license server or the license server can be restarted.

Note: Prior to upgrading any version it is highly recommended to create a backup of the Viz Engine configuration files located in: %PROGRAMDATA%\vizrt\VizEngine.

Key Features and Workflow of the New Licensing System

The VALID/Sentinel/Hardlock Dongle is no longer supported for Viz Engine 4.0.0 and later versions.
Dongle-less operation on clients with monitoring and logging capabilities.
Grace periods for allocated licenses to avoid immediate expiration on network or service interruptions.
- In Viz Engine 4.0.0/3.14.1 or newer license errors are logged to the Graphic Hub journal (see here how to enable E-Mails).
  - Logs license errors (any grace state or if expired) to the Graphic Hub journal as dedicated log messages with level 820.
  - Logs warnings two weeks and every hour prior to license expiration as dedicated Graphic Hub journal message with level 920.
Configurable WIBU license container location (any local container, any network container or a dedicated container).
Configurable licenses to consume.
Viz Artist/Viz Engine startup was changed and no startup helpers are needed anymore (.cmd files, started executables).
When a core license cannot be allocated on startup Viz Engine starts in configuration mode.
When an additional license fails to allocate on startup an error is logged and the required feature keeps disabled on startup.

Limitations and Known Issues

The binary yes/no VM license introduced in 3.9.1 no longer works.
The WIBU licensing supports OEM starting with Viz Engine 3.12.1 and newer.
When using an Input license as Combination Feature (like NDI or MezzIP) the input must be mapped to Invput 1.
All additional licenses consumable to a core license must come from the same container as the core license.
Matrox DSX.Core installer corrupts an existing CodeMeter Runtime installation and causes a crash on Viz Engine startup.
- Uninstall any CodeMeter Runtime prior to installing Matrox DSX.Core. Install DSX.Core and afterwards install Viz Engine and the newer CodeMeter Runtime.
For a preview in TRIO and Pilot as Engine Core, a DVI OUT license is needed.
Configuration of licenses requires to start Viz Engine in configuration mode with the configuration UI.
In Viz Engine 3.12.1 and newer, the configuration UI works without a valid license and can be configured through the configuration UI.
- In Viz Engine 3.12.0 and older, the configuration UI only works with a valid license, which depends on the configuration. If no proper license is available then a manual edit of the corresponding configuration entries is required. See Configuration Entries in the Viz Engine Configuration File.
- By default, the WIBU licensing system with Engine Core license (ENG_ENG_CORE) is used when no configuration exists.
File-based local WIBU licenses on server operating systems (terminal server) cannot be used via remote desktop connections. For example, if you have installed Windows 10 the access via remote desktop connection works but not, for example, with a Windows Server 2016 system.
Viz Engine Startup may take long when network communication has high latency or bandwidth is limited. Workaround for now is to use a license server on a local network.

Basic Set-up

To set up Viz Artist/Viz Engine licensing with WIBU or VALID/Sentinel/Hardlock:

Install Viz Artist/Viz Engine with the bundle installer (see Viz Artist and Engine Installation).
Configure CodeMeter with the Vizrt Licensing Service or the CodeMeter WebAdmin (can be opened from the CodeMeter Control Center).
Configure the license system in Viz Engine by starting in configuration mode and navigate to Viz Licenses.
1. When using any WIBU network container (license server):
  1. Open the CodeMeter WebAdmin and add the license server to the server search list:
  2. In the configuration UI under Viz Licenses set Container to 0,0 Any Network Container or in the Viz Engine configuration file set License_Containers = 0,0,1.
  3. Configure the core license and any additional licenses. In the configuration UI under Viz Licenses configure Core License and Additional Licenses or in the Viz Engine configuration file configure License_Core and Additional_Licenses.
2. When using any local WIBU container (dongle, file):
  1. In the configuration UI under Viz Licenses set License Location to 0,0 Any Local Container or in the Viz Engine configuration file set License_Containers = 0,0,0
  2. Configure the core license and any additional licenses. In the configuration UI under Viz Licenses configure Core License and Additional Licensesor in the Viz Engine configuration file configure License_Core and Additional_Licenses.
3. When using a dedicated WIBU container (with full container identifier):
  1. In the configuration UI under Viz Licenses, set License Location to a specific container (for example, 130,3910158968 Network license) or in the Viz Engine configuration file set License_Containers = 13 0,3910158968,1
  2. Configure the core license and any additional licenses. In the configuration UI under Viz Licenses configure Core License and Additional Licenses or in the Viz Engine configuration file configure License_Core and Additional_Licenses.
Start Viz Engine.

Configuration Settings

Why Do We Need to Configure the Licenses?

Prevent license theft by instances on other nodes or instances on the same node. Licenses are in one container and have a count.
Several licenses may enable the same feature. There is no one to one mapping of application feature to a single license possible. For example, with multiple instances on one node (Trio One Box), it is important which instance consumes which license for proper operation (first needs SDI OUT, SDI IN and 2nd DVI HD).
A license may enable multiple internal application features.

Configuring the License System in the Viz Engine Configuration UI

See Viz License Configuration.

Note: By default, the WIBU licensing system with Engine Core license (ENG_ENG_CORE) is used when no configuration exists. When no such license is available the configuration file must be edited. See Configuration Entries in the Viz Engine Configuration File.

Note: Configuration of the combination feature requires that no instance is running on the machine that already allocated a combination feature, else no information can be retrieved and it cannot be configured (due to the access mode of this licenses).

Configuration Entries in the Viz Engine Configuration File

Entries changed in 4.0.0 and later: Legacy_Licensing (removed), License_Location (removed, was replaced by License_Containers)

License_Containers: WIBU license source. Determines where WIBU should search for license containers and allocate licenses from.
- Can be set to one of the following values:
  - 0,0,0 - Any Local container. Searches exclusively for containers located on the same PC or allocated to the same VM (for example, dongle, file).
  - 0,0,1 - Any Network container. License is to be sought in the network (LAN, WAN), CodeMeter License Server activated as network server or CmWAN.
  - X,Y,1 - A dedicated container, where X is the container mask (for example, 130) and Y is the container serial (for example, 3910158968)
- Default: 0,0,1
License_Core: WIBU core license, which determines also the available additional licenses.
- For WIBU license details, see WIBU Licenses and their effect.
- Can be set to one of the following values:
  - ENG_ENG_CORE - Engine Core
  - ENG_PRV_CORE - Preview Core
  - ART_ARTIST_FREE - Free Viz Artist
- and for OEM (see Note on Shared Licenses)
  - VIZLIB_LIBERO_CORE - Viz Libero Core
  - VIZARE_VIZARENA_CORE - Viz Arena Camera Tracking Engine
  - VIZECL_VIZECLIPSE_CORE - Viz Eclipse Core
Additional_Licenses: WIBU additional licenses that are additionally consumed and determined by the core license.
- For WIBU license details, see WIBU Licenses and their effect.
  
  Note: When a license is configured it is consumed, even when it has no effect. If licenses are configured that are not allowed, an error is logged on startup.

WIBU Additional Licenses for Engine Core License ENG_ENG_CORE

License	Key	Description
Viz Artist	ENG_ARTIST	Enables Viz Artist User Interface
DVI OUT HD	ENG_CF_DVI	Enables Render Preview in OnAir mode
NDI input/output single	ENG_CF_NDI	Enables NDI in and Out channel for one instance
MezzIP single	ENG_CF_MEZZIP	Enables Mezzanine in/out channel for one instance
Frameserver single	ENG_CF_FS	Enables Multiplexer communication ports for one instance
SDI/IP Video Input Enablement (max)	ENG_ING_SDIIP_MAX	Enables all SDI/IP input channels
NDI IN Upgrade (max)	ENG_IN_NDI_MAX	Enables all NDI input channels
MezzIP IN Upgrade (max)	ENG_IN_MEZZIP_MAX	Enables all mezzanine IP inputs
SDI/IP OUT Channel	ENG_OUT_SDIIP	Enables SDI/IP output
NDI OUT Channel	ENG_OUT_NDI	Enables NDI output
MezzIP OUT Upgrade (max)	ENG_OUT_MEZZIP_MAX	Enables mezzanine IP output
4K Video Enablement	ENG_ING_4KVIDEO	Allows rendering in UHD
DVI OUT Max Resolution	ENG_OUT_DVI_MAX	Enables Fullscreen output (Videowall)
Multiple Frameservers (max)	ENG_OUT_FS_MAX	Enables Multiplexer communication ports for all instances
Chroma FX	ENG_PLUG_CHROMAFX	Enables Chroma Keyer
Global Illumination FX	ENG_PLUG_GI	Enables Global Illumination Editing
Vizrt Multi-touch Plug-in Package	ENG_PLUG_MULTITOUCH	Enables Multitouch plugins
Bone&Skin Live Motion Capture	ENG_PLUG_MOCAPREAD	Enables Capturing of Tracking Data (in Combination with Viz Tracking Hub)
Cinema 4D Import	ENG_PLROY_CINEMA4D	Allows import of C4D files
Dolby E Decoder License	ENG_PLROY_DOLBYDEC	Allows processing of Dolby E audio
Dolby E Encoder License	ENG_PLROY_DOLBYENC	Allows output of Dolby E audio
Viz Engine DNxHD Codec Support	ENG_PLROY_DNXHD	Allows playback/encoding of DNxHD compressed video
RTT Shaders FX	ENG_PLROY_RTTFX	Enables RTT shader package
Substance FX Authoring	ENG_PLROY_SUBSAUTH	Allows editing of Substance Materials
ezGallery	ENG_PLROY_EZGALLERY	Enables Erizos plugin
ezPostFx	ENG_PLROY_EZPOSTFX	Enables Erizos plugin
ezShaders	ENG_PLROY_EZSHADERS	Enables Erizos plugin
ezMesh	ENG_PLROY_EZMESH	Enables Erizos plugin
ezDeform	ENG_PLROY_EZDEFORM	Enables Erizos plugin
ezComposer	ENG_PLROY_EZCOMPOSER	Enables Erizos plugin
ezLogic	ENG_PLROY_EZLOGIC	Enables Erizos plugin
ezLink	ENG_PLROY_EZLINK	Enables Erizos plugin
ezTubular	ENG_PLROY_EZTUBULAR	Enables Erizos plugin
ezJavascript (Pro)	ENG_PLROY_EZJSPRO	Enables Erizos plugin
DornaMT APP	ENG_PLROY_DORNA_MTAP	Enables Dorna Multitouch Application
DornaMT Plug-in	ENG_PLROY_DORNA_MTPL	Enables Dora Multitouch Plugin
DSX Core HD license	ENG_DSXCORE_HD	Enables DSX Core functionality up to HD resolution
DSX Core UHD License	ENG_DSXCORE_UHD	Enables DSX Core functionality up to UHD resolution
Flexbox Plugin	ENG_FLEXBOX	Enables Flexbox plugin for Adaptive Scenedesign

WIBU additional licenses for core license ENG_PRV_CORE:

License	Key	Description
Viz Artist	ENG_PRV_ARTIST	Enables Viz Artist User Interface
DSX Core HD license	ENG_DSXCORE_HD	Enables DSX Core functionality up to HD resolution
DSX Core UHD License	ENG_DSXCORE_UHD	Enables DSX Core functionality up to UHD resolution

WIBU Additional Licenses for Viz Libero Core License

Viz Engine DNxHD Codec Support

WIBU Additional Licenses for Viz Arena Core License

Viz Engine DNxHD Codec Support

WIBU Additional Licenses for Viz Eclipse Core License

Viz Engine DNxHD Codec Support

WIBU License System

Summary of Key Concepts in the Licensing System

Core- and additional licenses exist.
OUT based channel counting for NDI/SDI/IP
IN and OUT channels are resolution independent up to 3G HD
- <=2K size of render output
Preview channels (preview/clean feed OUT) are co-enabled with every OUT channel license.
MezzIP applies to all compressed streams:
- Included: RTP/UDP/WebRTC
- Excluded (requires SDI/IP licenses): SMTPE ST2022-06, ST2022-07, ST2110; ASPEN.
Multiple licenses may enable the same application feature!
Licenses are consumed by multiple processes and license share mode influences possible consumption (see WIBU license share status).

WIBU License Share Status

Refers to a WIBU license and how its usage is counted when it is allocated/consumed.

Exclusive: Allocation can only be performed once on a node (=machine).
User Limit: Each allocation is counted, independent of instance and node.
Shared: Each allocation is counted once per node. Multiple allocations on the same node allocate only a single license.
No User Limit: Only checked for existence, no counting is performed.

License count reduction when consumed on a node in an instance
License share status	Node 1			Node 2
License share status	Instance 1	Instance 2	Instance 3	Instance 1	Instance 2	Instance 3
Exclusive	-1	fails	fails	-1	fails	fails
User Limit	-1	-1	-1	-1	-1	-1
Shared	-1	0	0	-1	0	0
No User Limit	0	0	0	0	0	0

WIBU Core License Summary

The following table represents which features are included in one of the Core features and what additional feature might need to be configured.

License	Engine Core	Preview Core	Free Viz Artist	Arena/Libero/Eclipse
Artist	ENG_ARTIST	ENG_PRV_ARTIST
Clips / Clip Player
Engine Core plug-ins
SDI/IP Input	ENG_ING_SDIIP_MAX
SDI/IP Output	ENG_OUT_SDIIP	(Watermark)
NDI Input	ENG_CF_NDI or ENG_IN_NDI_MAX
NDI Output	ENG_CF_NDI or ENG_OUT_NDI	(Watermark)
Mezzanine IP in	ENG_CF_MEZZIP or ENG_IN_MEZZIP_MAX
Mezzanine IP out	ENG_CF_MEZZIP or ENG_OUT_MEZZIP_MAX	(Watermark)
Frameserver	ENG_CF_FS or ENG_OUT_FS_MAX
DVI Out (<=2K)	ENG_CF_DVI or ENG_OUT_DVI_MAX	(Watermark on Resolution >=PAL)	Watermark
Unlimited DVI Out (Videowall)	ENG_OUT_DVI_MAX	(Watermark)	(Watermark)
4K Enablement	ENG_ING_4KVIDEO	(Watermark on Resolution >=PAL)	(Watermark)
Unlimited Frameserver	ENG_OUT_FS_MAX
Chroma Keyer	ENG_PLUG_CHROMAFX
Global Illumination	ENG_PLUG_GI
Multitouch Plug-ins	ENG_PLUG_MULTITOUCH
Bone&Skin Live Motion Capture	ENG_PLUG_MOCAPREAD
Cinema 4D Import	ENG_PLROY_CINEMA4D	ENG_PLROY_CINEMA4D
RTT Shaders	ENG_PLROY_RTTFX	ENG_PLROY_RTTFX
Substance Shader	ENG_PLROY_SUBSAUTH	ENG_PLROY_SUBSAUTH
Dolby E Encoding	ENG_PLROY_DOLBYENC	ENG_PLROY_DOLBYENC
Dolby E Decoding	ENG_PLROY_DOLBYDEC	ENG_PLROY_DOLBYDEC
DNxHD Codec	ENG_PLROY_DNXHD	ENG_PLROY_DNXHD		ENG_PLROY_DNXHD
Erizos Plug-ins	ENG_PLROY_EZxxxx	ENG_PLROY_EZxxxx
Dorna Plug-ins	ENG_PLROY_DORNA_xxxx	ENG_PLROY_DORNA_xxxx
UE4 Render Blade Core	ENG_UE4_RENDER_BLADE_CORE	ENG_UE4_RENDER_BLADE_CORE
DSX Core HD license	ENG_DSXCORE_HD
DSX Core UHD license	ENG_DSXCORE_UHD
Flexbox Plugin	ENG_FLEXBOX	ENG_FLEXBOX

WIBU Licenses and Their Effect

A WIBU license is a dedicated license (application ID) in the WIBU license system.

License short name and License long name	WIBU Share Status	Description
Core Licenses	Core licenses are used as prerequisite for other licenses and define the basic feature set.
ENG_ENG_CORE Engine Core	Shared	Basic core license to be able to start Viz Engine. Included functionality: GFX only boundary is the channel resolution/size (2K). Clips / Clip Player No limits on Clip Player (incl. broadcast format clip playback - of course proper Matrox Codecs required) Plug-ins Image FX Real FX Spline FX Text FX Pixel FX Graffiti FX Weather SocialTV (NOTE: was never restricted) Engine 3D Stereo Upgrade (=3D Stereo) EVS Control Plug-in Geo FX Viz Engine functionality: Audio FX Video FX After Effects Import Postrender 2K With ENG_ING_4KVIDEO up to 4K With ENG_OUT_DVI_MAX unlimited Postrender on screen preview has a watermark, except when postrendering is actually performed
ENG_PRV_CORE Preview Core	User Limit	Usage 1: Trio / other client applications requiring local preview Usage 2: Standalone preview machine for DVI, Mezzanine, NDI or SDI output always with watermark Disabled: Frameserver (Network) OUT Enabled (if licensed): Artist (together with ENG_PRV_ARTIST) 3DP plug-ins if license is available Included functionality: All resolutions ENG_ING_4KVIDEO ENG_OUT_DVI_MAX All plug-ins from ENG_ENG_CORE enabled All internal plug-ins ENG_PLUG_CHROMAFX ENG_PLUG_GI ENG_PLUG_MULTITOUCH All INs enabled ENG_ING_SDIIP_MAX ENG_IN_NDI_MAX ENG_IN_MEZZIP_MAX 1xOUT enabled (no extra licenses required) ENG_OUT_SDIIP ENG_OUT_NDI ENG_OUT_MEZZIP_MAX Watermark on all OUTs at any time and all resolutions DVI OUT Note: No watermark on DVI OUT (local preview) and renderer snapshots when the resolution is <= 720x576 pixels (PAL, SD). Output system must be set to PAL/SD. SDI OUT MezzIP OUT RTP/UDP OUT WebRTC OUT (SHM OUT) NDI OUT Postrender Clip Out Channel SHM Flexbox plugin
ART_ARTIST_FREE Free Viz Artist	Exclusive	Free Viz Artist version core license. Equal to an ENG_ENG_CORE with 1 x DVI OUT (limited to 2K) and everything is watermarked, except scene editor (small window in bottom right). Enabled: Artist GFX Clips / Clip Player Plug-ins of ENG_ENG_CORE Restricted: Means no SDI/IP, NDI, RTP/UDP IN/OUT, WebRTC OUT Watermark on all OUTs including Postrender, Clip Out Not combinable with any other license
VIZLIB_LIBERO_CORE Libero Core	User Counted	OEM Core for Viz Libero Enabled: Engine Core Disable Watermark Overlay SDI Output NDI Output 2k-4k Resolution DVI Output 2k max. DVI Output All Resolutions Chroma FX Audio DVE After Effects Import Image FX Real FX Spline FX Text FX Pixel FX Graffiti FX Weather FX Social TV FX EVS Control Geo FX unlimited SDI Inputs unlimited NDI Inputs Shared Memory Inputs Shared Memory Outputs Clip Playback Post Renderer Optional: DNxHD Codecs
VIZARE_VIZARENA_CORE Viz Arena Core	User Counted	OEM Core for Viz Arena Enabled: Engine Core Disable Watermark Overlay SDI Output NDI Output 2k-4k Resolution DVI Output 2k max. DVI Output All Resolutions Chroma FX Audio DVE After Effects Import Image FX Real FX Spline FX Text FX Pixel FX Graffiti FX Weather FX Social TV FX EVS Control Geo FX unlimited SDI Inputs unlimited NDI Inputs Shared Memory Inputs Shared Memory Outputs Clip Playback Post Renderer Optional: DNxHD Codecs
VIZLIB_LIBERO_CORE Viz Libero Camera Tracking Core	User Counted	OEM Core for Viz Arena Enabled: Engine Core Disable Watermark Overlay SDI Output NDI Output 2k-4k Resolution DVI Output 2k max. DVI Output All Resolutions Chroma FX Audio DVE After Effects Import Image FX Real FX Spline FX Text FX Pixel FX Graffiti FX Weather FX Social TV FX EVS Control Geo FX unlimited SDI Inputs unlimited NDI Inputs Shared Memory Inputs Shared Memory Outputs Clip Playback Post Renderer Optional: DNxHD Codecs
ENG_UE4_RENDER_BLADE_CORE UE4 Render Blade Core	Shared	Basic core license to be able to use the UE Render Blade (Unreal integration with the Vizrt Media for Unreal Engine plug-in).
Core Addons
DVI OUT HD NDI input/output single MezzIP single Frameserver single	Exclusive	Shipped with and requires ENG_ENG_CORE. Requires ENG_ENG_CORE or ENG_SVCHOST_COR. Allows you to mutually exclusive pick (configure) one of the following: APP_DVI: 1x DVI Out (2K) - meant to operate Viz Artist, or feed an HD Monitor. APP_MEZZ_IP: 1x MezzIP IN (2K), 1x MezzIP OUT (2K) 1x RTP/UDP IN (2K), 1x RTP/UDP OUT (2K) APP_NDI: 1x NDI IN (2K), 1x NDI OUT (2K) APP_MUX_PORTS: 1x Frameserver OUT (2K) Enable/Disable Vizrt Frame Server and NLE plug-ins with this license. No NLE plug-in should work anymore. Note: The ENG_CF is not mandatory to be consumed if the additionally consumed license (example: DVI Max. Resolution == video wall setup) is sufficient for the customer to make the node operational.
ENG_ARTIST Artist	No User Limit	Shipped with and requires ENG_ENG_CORE. Basic license to be able to start the Viz Artist.
ENG_PRV_ARTIST Artist Preview	User Limit	Shipped with and requires ENG_PRV_CORE. Basic license to be able to start the Viz Artist with Preview Core.
Input Licenses
ENG_ING_SDIIP_MAX SDI/IP Video Input Enablement (max)	Shared	Requires ENG_ENG_CORE or ING_ING_CORE. SDI/IP Video Input (unlimited channels)
ENG_IN_NDI_MAX NDI IN Upgrade (max)	Shared	Requires ENG_ENG_CORE. Additional NDI streams require unlimited version of respective stream type
ENG_IN_MEZZIP_MAX MezzIP IN Upgrade (max)	Shared	Requires ENG_ENG_CORE. Additional RTP/UDP streams require unlimited version of respective stream type
Output Licenses
ENG_OUT_SDIIP SDI/IP OUT Channel	User Limit	Requires ENG_ENG_CORE. Referring to: SMPTE ST2022-06, ST2022-07, ST2110; ASPEN Fill+Key is considered to be one channel only (even though requiring two physical outs).Preview channels (preview/clean feed OUT) are co-enabled with every SDI/IP OUT channel license item being purchased.
ENG_OUT_NDI NDI OUT Channel	User Limit	Requires ENG_ENG_CORE. Additional NDI streams.
ENG_OUT_MEZZIP_MAX MezzIP OUT Upgrade (max)	Shared	Requires ENG_ENG_CORE or ENG_SVCHOST_COR. Additional RTP/UDP streams.
Other Licenses
ENG_ING_4KVIDEO 4K Video Enablement	Shared	Requires ENG_ENG_CORE or ENG_SVCHOST_COR. 4K OUT: SDI/IP, NDI, MezzIP (RTP/UDP, WebRTC), postrender. Does not apply to DVI OUT (requires ENG_OUT_DVI_MAX). Note: Allows OUT of <=4K in both dimensions.
ENG_OUT_DVI_MAX DVI OUT Max Resolution	Shared	Requires ENG_ENG_CORE. Required to unlock 2K DVI OUT limit (for example, for Video walls) and postrender resolution. Note: No DVI OUT size restriction anymore.
ENG_OUT_FS_MAX Multiple Frameservers (max)	Shared	Requires ENG_ENG_CORE. Multiple Frame Server instances per Node.
Plug-in Licenses
ENG_PLUG_CHROMAFX Chroma FX	Shared	Requires ENG_ENG_CORE.
ENG_PLUG_GI Global Illumination FX	Shared	Requires ENG_ENG_CORE.
ENG_PLUG_MULTITOUCH Vizrt Multi-touch Plug-in Package	Shared	Requires ENG_ENG_CORE.
ENG_PLUG_MOCAPREAD Bone&Skin Live Motion Capture	User Limit	Requires ENG_ENG_CORE.
Flexbox Plugin	User Counted	Requires ENG_ENG_CORE or ENG_PRV_CORE.
Third Party Plug-in Licenses
ENG_PLROY_CINEMA4D Cinema 4D Import	Shared	Requires ENG_ENG_CORE or ENG_PRV_CORE.
ENG_PLROY_DOLBYDEC Dolby E Decoder License	Shared	Requires ENG_ENG_CORE or ENG_PRV_CORE.
ENG_PLROY_DOLBYENC Dolby E Encoder License	Shared	Requires ENG_ENG_CORE or ENG_PRV_CORE.
ENG_PLROY_DNXHD Viz Engine DNxHD Codec Support	Shared	Requires ENG_ENG_CORE or ENG_PRV_CORE.
ENG_PLROY_RTTFX RTT Shaders FX	Shared	Requires ENG_ENG_CORE or ENG_PRV_CORE.
ENG_PLROY_SUBSAUTH Substance FX Authoring	Shared	Requires ENG_ENG_CORE or ENG_PRV_CORE.
ENG_PLROY_EZGALLERY ezGallery	Shared	Requires ENG_ENG_CORE or ENG_PRV_CORE. Erizos licenses.
ENG_PLROY_EZPOSTFX ezPostFx	Shared
ENG_PLROY_EZSHADERS ezShaders	Shared
ENG_PLROY_EZMESH ezMesh	Shared
ENG_PLROY_EZDEFORM ezDeform	Shared
ENG_PLROY_EZCOMPOSER ezComposer	Shared
ENG_PLROY_EZLOGIC ezLogic	Shared
ENG_PLROY_EZLINK ezLink	Shared
ENG_PLROY_EZTUBULA ezTubular	Shared
ENG_PLROY_EZJSPRO ezJavascript (Pro)	Shared
ENG_PLROY_DORNA_MTAP DornaMT APP	Exclusive	Requires ENG_ENG_CORE or ENG_PRV_CORE. Dorna licenses.
ENG_PLROY_DORNA_MTPL DornaMT Plug-in	Exclusive	Requires ENG_ENG_CORE or ENG_PRV_CORE. Dorna licenses.
DSX Core HD license DSX Core UHD license	Shared	Requires ENG_ENG_CORE

Notes

Colors used in License Overview

The following color schema is used in Viz Engine to display the status of the license:

Correct License (white)	Expired License (red)

Mixed "Permanent" Licenses	Note: A permanent license need to have a end date set. If no end date is found, the license is invalid and should be renewed. These licenses are marked as orange.

Starting Viz Engine with WIBU License System

User configured in Viz Engine configuration which license(s) should be used/consumed.
A core license is required to start Viz Engine.
To enable higher resolutions for postrendering (>2K) then use:
- ENG_ING_4KVIDEO for up to <=4K width/height.
- ENG_OUT_DVI_MAX for unlimited resolution.

Starting Viz Engine with DVI OUT

User configured DVI OUT in Viz Engine configuration file: No Videoout, onair_vga_preview=1 or VGA version, startup in Engine or Artist mode.
The following licenses need to be available in WIBU license system:
- ENG_CF_DVI (resolution limited to <=2K width/height).
- OR ENG_OUT_DVI_MAX (no resolution restriction).
When configuration is changed at runtime and violates the license restriction, the resolution is limited to the allowed resolution (for example, 2K width/height).
DVI OUT is required for local preview in external applications (for example, Viz Trio, Pilot Template Wizard, Pilot Director).
When resolution is higher than 2K the startup fails for ENG_ENG_CORE without a proper ENG_ING_4KVIDEO or ENG_OUT_DVI_MAX license.

Starting Viz Engine with MezzIP OUT and/or 1xMezzIP IN

Without the ENG_ING_4KVIDEO license the output is limited to <=2K width/height.
When running Viz Engine with RTP/UDP IN/OUT or Service Host with WebRTC OUT the following licenses need to be available in the WIBU license system:
- OUT: ENG_CF_MEZZIP OR ENG_OUT_MEZZIP_MAX
- IN: ENG_IN_MEZZIP_MAX
To enable resolutions >2K and <= 4K then ENG_ING_4KVIDEO is required.
See Note on Shared Licenses.

MezzIP Possible OUTs	Engine Effect	Engine Licenses Consumed
1 RTP/UDP IN (2K), 1 RTP/UDP OUT (2K)	Instance 1: 1x RTP/UDP IN (2K), 1x RTP/UDP OUT (2K)	1 ENG_ENG_CORE, ENG_CF
1+ RTP/UDP IN (2K),	1+ RTP/UDP IN (2K) (one or multiple instances)	1(+) ENG_ENG_CORE, ENG_IN_MEZZIP_MAX
1 RTP/UDP IN (2K), 1+ RTP/UDP OUT (2K)	1 RTP/UDP IN (2K)	ENG_ENG_CORE, ENG_CF, ENG_OUT_MEZZIP_MAX
1+ RTP/UDP IN (2K), 1+ RTP/UDP OUT (2K)	1+ RTP/UDP IN (2K) 1+ RTP/UDP OUT (2K)	ENG_ENG_CORE, ENG_IN_MEZZIP_MAX, ENG_OUT_MEZZIP_MAX
4K OUT	4K resolution on any OUT	ENG_ING_4KVIDEO

Starting Viz Engine with NDI OUT and/or NDI IN

When running Viz Engine with NDI IN and/or NDI OUT the following licenses need to be available in the WIBU license system:
- OUT: ENG_CF_NDI OR ENG_OUT_NDI
- IN: ENG_IN_NDI_MAX
To enable resolutions >2K and <= 4K then ENG_ING_4KVIDEO is required.

Starting Viz Engine with Frameserver Functionality (MUX Ports)

When running Viz Engine as a frameserver (for example, for NLE clients or Viz Story) the following licenses need to be available in the WIBU license system:
- ENG_CF_FS to start one frameserver instance per node
- OR ENG_OUT_FS_MAX to start multiple frameserver instances per node
To enable higher resolutions frameserver snapshots (>2K) then use:
- ENG_ING_4KVIDEO for frameserver snapshots of up to <=4K width/height.
- ENG_OUT_DVI_MAX for unlimited resolution frameserver snapshots.

Starting Viz Engine with SDI/IP OUT or SDI/IP IN

When running Viz Engine with SDI/IP IN and/or SDI/IP OUT the following licenses need to be available in the WIBU license system:
- OUT: ENG_OUT_SDIIP per output one license is consumed
- IN: ENG_ING_SDIIP_MAX
To enable higher resolutions SDI/IP OUT/IN (>2K) use:
- ENG_ING_4KVIDEO for up to <=4K width/height.

Starting Viz Engine with Viz Artist

When running Viz Engine with Viz Artist the following licenses need to be available in the WIBU license system:
- ENG_ENG_CORE and ENG_ARTIST
- OR ENG_PRV_CORE and ENG_PRV_ARTIST
- OR ART_ARTIST_FREE

Starting Viz Engine with Unreal Integration (Vizrt Media for Unreal Engine)

When running Viz Engine with Unreal Integration (Vizrt Media for Unreal Engine) the following licenses need to be available in the WIBU license system:
- ENG_ENG_CORE, ENG_ING_SDIIP_MAX, ENG_OUT_SDIIP, ENG_PLUG_CHROMAFX and ENG_UE4_RENDER_BLADE_CORE
- OR ENG_PRV_CORE and ENG_UE4_RENDER_BLADE_CORE
Configuration details can be found in Integration with Unreal Engine under Third Party Applications and Files in the Viz Artist User Guide.

Using DSX Core Licenses

DSX Core licenses can only be used on machines without Matrox hardware. Enabling DSX core on Matrox Topology driver based installations can lead into unintended behavior.

Permanent Licenses

Permanent Licenses need to have a end date set (typically 99 years). Any permanent license without an end-date is listed as "invalid date" and should be renewed by Vizrt. If this is the case, please contact Vizrt Support.

Setup Graphic Hub Journal-based E-Mail Notifications

Configure e-mail sending in Graphic Hub Terminal Options E-Mail settings.
Configure e-mail addresses and notification options for specific alerts in Graphic Hub Manager Alert settings.
Viz Engine directly logs to the Journal of the connected Graphic Hub and triggers e-mail messages for the following alert levels:
- Level 820: Viz Engine WARNING: License, Warnings reported by Viz Engine related to licensing.
- Level 920: Viz Engine ERROR: License, Errors reported by Viz Engine related to licensing.

Setup Redundancy for a WIBU License Server

Setting up WIBU license server redundancy is described below. See License Server Redundancy in the Vizrt Licensing Administrator Guide for additional details.

Note: The grace period for acquired licenses is 72 hours if the license is lost to recover possible network issues or the license server.

Set Up Redundancy for a WIBU License Server

Make sure two hosts (A & B) have VizrtLicensingInstaller.exe installed and select use as network license server during installation. See License Server Activation in the Vizrt Licensing Administrator Guide.
Connect one WIBU dongle to 'A' and import a key with licenses.
From WIBU web admin UI of 'A', make sure the container exist and all the added features are listed.
On the client configure 'A' as first license server, and 'B' as second one (in the search list of the local CodeMeter web admin).

Test License Server Failover

Set the license configuration in Viz Engine.
Start Viz Engine.
From CodeMeter web admin UI of 'A', verify that the licenses are allocated and used by the client.
Disconnect the network cable of 'A' or shut down the machine.
Wait until the Viz Engine(s) starts writing 'License Server not found..' and the grace status for the configured features is 'grace_state=2/VL_GRACE_GRACE, '.
Move the WIBU dongle from 'A' to 'B'.
Viz Engine recovers and re-obtains the license from 'B'.

Recover First License Server

Recover license server ‘A’.
Disconnected the failover license server from network or shut it down.
Waited until the Viz Engine(s) enter grace period.
Moved WIBU dongle back to the original license server ‘A’.
Viz Engine recovers and re-obtains the license from 'A'.

Notes

The license must be in the same container to recover. A second license server with a different container does not work.
Not started Viz Engines which are configured the same, can start and obtain the license from 'B'.
An arbitrary number of servers can be added to the server search list of CodeMeter, even when Viz Engine is running. It is possible to add a failover server after the original license server failed.

See Also

Vizrt Licensing Administrator Guide
Graphic Hub Administrator Guide
Integration with Unreal Engine under Third Party Applications and Files in the Viz Artist User Guide.

Viz Engine Administrator Guide

WIBU-based Licensing System

Important Pre-installation Information

Key Features and Workflow of the New Licensing System

Limitations and Known Issues

Basic Set-up

Configuration Settings

Why Do We Need to Configure the Licenses?

Configuring the License System in the Viz Engine Configuration UI

Configuration Entries in the Viz Engine Configuration File

WIBU Additional Licenses for Engine Core License ENG_ENG_CORE

WIBU additional licenses for core license ENG_PRV_CORE:

WIBU Additional Licenses for Viz Libero Core License

WIBU Additional Licenses for Viz Arena Core License

WIBU Additional Licenses for Viz Eclipse Core License

WIBU License System

Summary of Key Concepts in the Licensing System

WIBU License Share Status

WIBU Core License Summary

WIBU Licenses and Their Effect

Notes

Colors used in License Overview

Starting Viz Engine with WIBU License System

Starting Viz Engine with DVI OUT

Starting Viz Engine with MezzIP OUT and/or 1xMezzIP IN

Starting Viz Engine with NDI OUT and/or NDI IN

Starting Viz Engine with Frameserver Functionality (MUX Ports)

Starting Viz Engine with SDI/IP OUT or SDI/IP IN

Starting Viz Engine with Viz Artist

Starting Viz Engine with Unreal Integration (Vizrt Media for Unreal Engine)

Using DSX Core Licenses

Permanent Licenses

Setup Graphic Hub Journal-based E-Mail Notifications

Setup Redundancy for a WIBU License Server

Set Up Redundancy for a WIBU License Server

Test License Server Failover

Recover First License Server

Notes

Search results