This chapter describes management and usage of the licensing system based on CodeMeter from WIBU Systems.

This section contains the following information:

Important Pre-installation Information

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

WIBU Runtime

Viz Engine Version

8.30a

5.4

8.20

5.3.1, 5.3.2

8.10a

5.3.0

7.60a

5.1, 5.2

7.40

4.4.1, 5.0

7.21a

4.3

7.20

4.1

6.80

3.12.1 

6.60a

3.10.0 - 3.12.0

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 Wibu Licensing System

  • 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

  • All additional licenses consumable to a core license must come from the same container as the core license.

  • (warning) 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.

  • Security groups respective Firewalls on Cloud providers might need to be configured to allow UDP traffic on port22350, to reach and consume licenses from a license server.

Basic Set-up

To set up Viz Artist/Viz Engine licensing with WIBU:

  1. Install Viz Artist/Viz Engine with the bundle installer (see Viz Artist and Viz Engine Installation).

  2. Configure CodeMeter with the Vizrt Licensing Service or the CodeMeter WebAdmin (can be opened from the CodeMeter Control Center).

  3. Configure the license system in Viz Engine by starting in configuration mode and navigate to Viz Licenses.

    image-20240916-072437.png

    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.

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

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:

      • Engine Core

      • Preview Core

      • Engine Core VER (New Render Pipeline only)

      • Preview Core VER (New Render Pipeline only)

      • Frameserver Core

      • Free Viz Artist

    • and for OEM (see Note on Shared Licenses)

      • Viz Libero Core

      • Viz Arena Camera Tracking Engine

      • Viz Eclipse Core

  • Additional_Licenses: WIBU additional licenses that are additionally consumed and determined by the core license.

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.

Licensing Unreal Blade Core

Configuration details can be found in Integration with Unreal Engine under Third Party Applications and Files in the Viz Artist User Guide.

WIBU Additional Licenses for Engine Core Licenses

License

Description

Viz Artist

Enables Viz Artist User Interface

DVI OUT HD

Enables Render Preview in OnAir mode

NDI input/output single

Enables NDI in and Out channel for one instance

MezzIP single

Enables Mezzanine in/out channel for one instance

Frameserver single

Enables Multiplexer communication ports for one instance

SDI/IP Video Input Enablement (max)

Enables all SDI/IP input channels

NDI IN Upgrade (max)

Enables all NDI input channels

MezzIP IN Upgrade (max)

Enables all mezzanine IP inputs

SDI/IP OUT Channel

Enables SDI/IP output

NDI OUT Channel

Enables NDI output

MezzIP OUT Upgrade (max)

Enables mezzanine IP output

4K Video Enablement

Allows rendering in UHD 

8K Video Enablement

Allows rendering up to UHD2

DVI OUT Max Resolution

Enables Fullscreen output (Videowall)

Multiple Frameservers (max)

Enables Multiplexer communication ports for all instances

Chroma FX

Enables Chroma Keyer

Global Illumination FX

Enables Global Illumination Editing

Vizrt Multi-touch Plug-in Package

Enables Multitouch plug-ins

Cinema 4D Import

Allows import of C4D files

Dolby E Decoder License

Allows processing of Dolby E audio

Dolby E Encoder License

Allows output of Dolby E audio

Viz Engine DNxHD Codec Support

Allows playback/encoding of DNxHD compressed video

RTT Shaders FX (1)

Enables RTT shader package

Substance FX Authoring

Allows editing of Substance Materials

ezGallery (1)

Enables Erizos plug-in

ezPostFx (1)

Enables Erizos plug-in

ezShaders (1)

Enables Erizos plug-in

ezMesh (1)

Enables Erizos plug-in

ezDeform (1)

Enables Erizos plug-in

ezComposer (1)

Enables Erizos plug-in

ezLogic (1)

Enables Erizos plug-in

ezLink (1)

Enables Erizos plug-in

ezTubular (1)

Enables Erizos plug-in

ezJavascript (Pro) (1)

Enables Erizos plug-in

DornaMT APP (1)

Enables Dorna Multitouch Application

DornaMT Plug-in (1)

Enables Dora Multitouch plug-in

DSX Core HD license

Enables DSX Core functionality up to HD resolution

DSX Core UHD License

Enables DSX Core functionality up to UHD resolution

ClipPlayer Pro

Enables playback of licensable Video Codecs like h265 or HAP

Enables Flexbox plug-in

Enables Flexbox plug-in for Adaptive Scenedesign

Parallel Outputs

Enables multiple outputs

Object Tracker

Enables Object Tracker

Shared Memory Input

Enables Shared Memory Inputs

Shared Memory Output

Enables Shared Memory Outputs

(1) Items are not available in the Engine VER core.

WIBU Additional Licenses for Preview Core Licenses

License

Description

Viz Artist Preview

Enables Viz Artist User Interface

Cinema 4D Import

Allows import of C4D files

Dolby E Decoder License

Allows processing of Dolby E audio

Dolby E Encoder License

Allows output of Dolby E audio

Viz Engine DNxHD Codec Support

Allows playback/encoding of DNxHD compressed video

RTT Shaders FX (1)

Enables RTT shader package

ezGallery (1)

Enables Erizos plug-in

ezPostFx (1)

Enables Erizos plug-in

ezShaders (1)

Enables Erizos plug-in

ezMesh (1)

Enables Erizos plug-in

ezDeform (1)

Enables Erizos plug-in

ezComposer (1)

Enables Erizos plug-in

ezLogic (1)

Enables Erizos plug-in

ezLink (1)

Enables Erizos plug-in

ezTubular (1)

Enables Erizos plug-in

ezJavascript (Pro) (1)

Enables Erizos plug-in

DornaMT APP (1)

Enables Dorna Multitouch Application

DornaMT Plug-in (1)

Enables Dora Multitouch plug-in

DSX Core HD license

Enables DSX Core functionality up to HD resolution

DSX Core UHD License

Enables DSX Core functionality up to UHD resolution

ClipPlayer Pro

Enables playback of licensable Video Codecs like h265 or HAP

Parallel Outputs

Enables multiple outputs

Object Tracker

Enables Object Tracker

(1) Items are not available in the Engine VER core

WIBU Additional Licenses for Frameserver Core Licenses

License

Description

Frameserver single

Enable Frameserver functionality

4K Enablement

Allows rendering in UHD 

Multiple Frameservers (max)

Enables Multiplexer communication ports for all instances

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.

  • 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

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 (tick)
and what additional feature might need to be configured (plus)
or are not available (error)

License

Engine (VER)
Core

Preview (VER)
Core

Frameserver Core

Viz Artist for Learners
(Free Artist)

Viz Arena
Viz Libero
Viz Eclipse

Artist

(plus)

(plus) Artist Preview

(error)

(tick)

(error)

DVI Out HD (<=2K)

(plus)

(tick) (Watermark on Resolution >=PAL)

(error)

(tick) Watermark

(tick)

DVI Out Max Resolution (Videowall)

(plus)

(tick) (Watermark)

(error)

(tick) (Watermark)

(tick)

NDI input/output single
NDI in Upgrade
NDI Out Channel

(plus)

(error)

(error)

(error)

(error)

MezzIP single
MezzIP IN Upgrade
MezzIP Out Upgrade

(plus)

(error)

(error)

(error)

(error)

Frameserver single
Multiple Frameservers

(plus)

(error)

(tick)

(error)

(error)

SDI/IP Video Input Enablement

(plus)

(tick)

(error)

(error)

(tick)

SDI/IP Output Channel

(plus)

(tick) (Watermark)

(error)

(error)

(tick)

NDI Input/Output single

(plus)

(tick) (Watermark)

(error)

(error)

(tick)

NDI IN Upgrade

(plus)

(tick)

(error)

(error)

(tick)

NDI Out Channel

(plus)

(tick) (Watermark)

(error)

(error)

(error)

4K Enablement

(plus)

(tick) (Watermark on Resolution >=PAL)

(plus)

(tick) (Watermark)

(tick)

8K Video Enablement

(plus)

(tick) (Watermark on Resolution >=PAL)

(error)

(tick) (Watermark)

(error)

8K+ Video Enablement

(plus)

(tick) (Watermark on Resolution >=PAL)

(error)

Chroma Keyer

(plus)

(tick)

(error)

(error)

(tick)

Global Illumination

(tick)

(tick)

(error)

(error)

(error)

Multitouch Plug-ins

(plus)

(error)

(error)

(error)

(error)

Bone&Skin Live Motion Capture

(plus)

(tick)

(error)

(error)

(error)

Cinema 4D Import

(plus)

(plus)

(error)

(error)

(error)

Dolby E Encoding

(plus)

(plus)

(error)

(error)

(error)

Dolby E Decoding

(plus)

(plus)

(error)

(error)

(error)

DNxHD Codec Support

(plus)

(plus)

(error)

(error)

(plus)

RTT Shaders (1)

(plus)

(plus)

(error)

(error)

(error)

Substance FX Authoring

(tick)

(tick)

(error)

(error)

(error)

Erizos Plug-ins (1)

(plus)

(plus)

(error)

(error)

(error)

Dorna Plug-ins (1)

(plus)

(plus)

(error)

(error)

(error)

DSX Core HD license

(plus)

(plus)

(error)

(error)

(error)

DSX Core UHD license

(plus)

(plus)

(error)

(error)

(error)

ClipPlayer Pro

(plus)

(plus)

(error)

(error) 

(error)

Flexbox plug-in

(plus)

(tick)

(tick)

(error)

(error)

Parallel Outputs

(plus)

(tick)

(error)

(error)

(error)

Object Tracker

(plus)

(plus)

(error)

(error)

(error)

Shared Memory Input

(plus)

(tick)

(error)

(error)

(tick)

Shared Memory Output

(plus)

(tick)

(error)

(error)

(tick)

(1) Items are not available in the Engine VER core

Core Licenses and Their Effect

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

Core Licenses

Core licenses are used as prerequisite for other licenses and define the basic feature set.

Engine Core

Engine Core VER enables the same functionality, but disables Classic pipeline

Shared

Basic core license to be able to start Viz Engine.

Included functionality:

  • Viz Engine Render pipeline and Classic Pipeline for up to 2K resolution.

  • Clips / Clip Player

    • No limits on Clip Player (incl. broadcast format clip playback, of course proper Matrox Codecs required)

  • Standard set of Plug-ins (Image FX, Real FX, Spline FX, Text FX, Pixel FX, Graffiti FX, SocialTV, EVS and Maps Plugins)

  • Basic Viz Engine functionality including Audio, Video, After Effects Import,Global Illumination and Substance FX

  • Postrendering up to 2K

Preview Core

Preview Core VER enables the same functionality, but disables Classic pipeline

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

Optional (if licensed): Artist (together with ENG_PRV_ARTIST)

Includes rendering in all resolutions (Watermark on all OUTs at any time and all resolutions).

  • Inputs including

    • SDI/IP

    • NDI

    • Mezzanine IP

    • Shared Memory

  • Outputs enabled (no extra licenses required)

    • SDI/IP Output

    • NDI Output

    • Mezzanine IP Output

    • Shared Memory

    • Parallel Outputs

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.

Note: Cannot be used as Frameserver.

Engine Frameserver Core

Shared

Basic core license to use Viz Engine as Frameserver (NLE) only.
Needs to have a Frameserver single license enabled.

Disables all watermarks.

Can be upgrade to 4K resolution.

Note: Default communication Port (6100) is disabled.

Free Viz Artist / Artist for Learners

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

  • Restricted:

    • Means no SDI/IP, NDI, RTP/UDP IN/OUT, WebRTC OUT.

    • Watermark on all OUTs including Postrender and Clip Out.

    • Not combinable with any other licenses

    • No Support for Classic scenes.

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

  • unlimited SDI Inputs

  • unlimited NDI Inputs

  • Shared Memory Inputs

  • Shared Memory Outputs

Optional:

  • DNxHD Codecs

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

  • unlimited SDI Inputs

  • unlimited NDI Inputs

  • Shared Memory Inputs

  • Shared Memory Outputs

  • Clip Playback

  • Post Renderer

Optional:

  • DNxHD Codecs

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

  • unlimited SDI Inputs

  • unlimited NDI Inputs

  • Shared Memory Inputs

  • Shared Memory Outputs

  • Clip Playback

  • Post Renderer

Optional:

  • DNxHD Codecs

Additional Licenses

Viz Artist Licenses

Artist

Shared

Enables the Artist Design User Interface. This is required to create new scenes.

Artist Preview

Shared

Enables the Artist with Preview Core.

Optional Input Licenses

SDI/IP Video Input Enablement (max)

Shared

Enables unlimited SDI or IP video inputs for all engine instances.

Note: Disables DSX Core HD and UHD licenses.

NDI input/output single

User Limit

Enables NDI input and NDI output for one engine instance.

NDI IN Upgrade (max)

Shared

Upgrades NDI input for all engine instances.

MezzIP single

User Limit

Enables optional mezzanine in, and output like RTSP, RTP for one engine instance.

MezzIP IN Upgrade (max)

Shared

Additional RTP/UDP streams for all engine instances.

Shared Memory INPUT

Allows reading of Shared Memory Streams.

Optional Output Licenses

SDI/IP OUT Channel

User Limit

Enables Video Output for SDI/IP hardware for one engine instance.

Fill+Key is considered to be one channel only (even though requiring two physical outs).

Parallel Output channels (preview/clean/matte etc…) are co-enabled with every SDI/IP OUT channel license item being purchased.

NDI OUT Channel

User Limit

Additional NDI streams output for one engine instance

MezzIP OUT Upgrade (max)

Shared

Additional RTP/UDP streams for all engine instances.

Parallel Outputs

User Limit

Enables multiple outputs from one engine instance. This can be an additional Key Preview, Matte scene, GFX channel output etc. using NDI or SDI/IP.

Note: An additional NDI license is not required for GFX channel NDI output.

Shared Memory OUTPUT

Allows sending of Shared Memory Streams.

Frame Server Licenses

Frameserver single

User Limit

Enables Frame Server functionality for NLE plug-ins with this license. This enables the multiplexer ports (50007-50009) for one engine instance. Previewport 50010 is not affected.

Multiple Frameservers (max)

Shared

Upgrades additional engine instances with Frame Server functionality.

Output Resolution Licenses

DVI Out HD

User Limit

Enables OnScreen rendering up to 2K resolution.
DVI OUT is required for local preview in external applications (for example, Viz Trio, Pilot Template Wizard, Pilot Director) or to enable the OnAir Preview.
When configuration is changed at runtime and violates the license restriction, the resolution is limited to the allowed resolution (for example, 2K width/height).

When resolution is configured higher than 2K the startup fails.

DVI OUT Max Resolution

Shared

Enables unlimited DVI output size, mainly needed for Videowall setups.

Note: No DVI OUT size restriction anymore.

4K Video Enablement

Shared

Enables output up to (and including) 4K (in any direction) on all output devices
This affects SDI/IP, NDI, Postrendering, Snapshots, Clipout, WebRTC,….

Note: Allows OUT of <=4K in both dimensions.

8K Video Enablement

Shared

Enables output up to (and including) 8K (in any direction) on all output devices
This affects SDI/IP, NDI, Postrendering, Snapshots, Clipout, WebRTC,….

Note: Allows OUT of <=8K in both dimensions.

8K+ Video Enablement

Shared

Enables output more than 8K (in any direction) on all output devices
This affects SDI/IP, NDI, Postrendering, Snapshots, Clipout, WebRTC,….

Note: Allows OUT of >=8K in both dimensions.

Clip and Codec Licenses

ClipPlayer Pro license

Shared

Allows playback of additional Clip codecs like h265 or HAP with VML player.

DSX Core HD license
DSX Core UHD license

Shared

Enables the use of the Matrox Software only DSX Core solution.
DSX Core also allows to use RTP/SRTSP streaming and ClipOut channels.
Matrox Topology Utils need to be installed.

Note: Disables SDI/IP input licenses.

DNxHD Codec Support

Shared

Allows handling clips in DNxHD format on all Matrox devices.

Additional Viz Engine Licenses

Dolby E Decoder License
Dolby E Encoder License

Shared
Shared

Allows to process Dolby E inputs and Dolby E outputs. A pass through of Dolby E signals does not require any of these licenses.

Cinema 4D Import

Shared

Allows to import Cinema 4D (C4D) files and to use the Cinema 4D LiveLink feature.

Chroma FX

Shared

Enables the Chroma Keyer Feature.

Global Illumination FX

Shared

No longer requires a license in Viz Engine 5.4 or higher.

Substance FX Authoring

Shared

No longer requires a license in Viz Engine 5.4 or higher.

Bone&Skin Live Motion Capture

User Limit

Allows to capture live motion data in real-time.

Object Tracker

Enables the object tracker functionality of VizArc.

AI Keyer Greenscreen-less

Enables the use of AI Keyer.

Maps Base

Enables Maps rendering (future).

Maps Satellite

Enables Maps Satellite rendering (future).

Plug-in Licenses

Flexbox plug-in

User Counted

Allows to use advanced flexbox layouting capabilities for adaptive graphics use cases.

Vizrt Multi-touch Plug-in Package

Shared

Enables the use of Vizrt Multitouch plugins. Note, these plugins are disabled by default.

RTT Shaders FX

Shared

Enables the full functionality of RTT shaders bundled with Viz Engine Classic pipeline.
Without license, some options are disabled.

  • ezGallery

  • ezPostFx

  • ezShaders

  • ezMesh

  • ezDeform

  • ezComposer

  • ezLogic

  • ezLink

  • ezTubular

  • ezJavascript (Pro)

Shared

3rd party Erizos plugins for Classic Pipeline.

  • DornaMT APP

  • DornaMT Plug-in

Exclusive

3rd party Dorna MultiTouch plugins for Classic Pipeline.

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

Core not available

A previously configured Core license which is not available anymore (for example, by switching dongles) is labeled Not Available and shown in red.

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

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:

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

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

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

  2. Connect one WIBU dongle to 'A' and import a key with licenses.

  3. From WIBU web admin UI of 'A', make sure the container exist and all the added features are listed.

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

  1. Set the license configuration in Viz Engine.

  2. Start Viz Engine.

  3. From CodeMeter web admin UI of 'A', verify that the licenses are allocated and used by the client.

  4. Disconnect the network cable of 'A' or shut down the machine.

  5. 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, '.

  6. Move the WIBU dongle from 'A' to 'B'.

  7. Viz Engine recovers and re-obtains the license from 'B'.

Recover First License Server

  1. Recover license server ‘A’.

  2. Disconnected the failover license server from network or shut it down.

  3. Waited until the Viz Engine(s) enter grace period.

  4. Moved WIBU dongle back to the original license server ‘A’.

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