Viz Engine Administrator Guide
Version 5.1 | Published November 09, 2023 ©
WIBU-based Licensing System
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
The WIBU licensing system requires the installation of the CodeMeter Runtime Software (included in the Bundle installer):
|
WIBU Runtime |
Viz Engine Version |
|
7.60a |
5.1 or newer |
|
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 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
-
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.
-
When using any WIBU network container (license server):
-
Open the CodeMeter WebAdmin and add the license server to the server search list:
-
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.
-
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.
-
-
When using any local WIBU container (dongle, file):
-
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
-
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.
-
-
When using a dedicated WIBU container (with full container identifier):
-
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
-
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 plug-ins |
|
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 plug-in |
|
ezPostFx |
ENG_PLROY_EZPOSTFX |
Enables Erizos plug-in |
|
ezShaders |
ENG_PLROY_EZSHADERS |
Enables Erizos plug-in |
|
ezMesh |
ENG_PLROY_EZMESH |
Enables Erizos plug-in |
|
ezDeform |
ENG_PLROY_EZDEFORM |
Enables Erizos plug-in |
|
ezComposer |
ENG_PLROY_EZCOMPOSER |
Enables Erizos plug-in |
|
ezLogic |
ENG_PLROY_EZLOGIC |
Enables Erizos plug-in |
|
ezLink |
ENG_PLROY_EZLINK |
Enables Erizos plug-in |
|
ezTubular |
ENG_PLROY_EZTUBULAR |
Enables Erizos plug-in |
|
ezJavascript (Pro) |
ENG_PLROY_EZJSPRO |
Enables Erizos plug-in |
|
DornaMT APP |
ENG_PLROY_DORNA_MTAP |
Enables Dorna Multitouch Application |
|
DornaMT Plug-in |
ENG_PLROY_DORNA_MTPL |
Enables Dora Multitouch plug-in |
|
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 plug-in |
ENG_FLEXBOX |
Enables Flexbox plug-in for Adaptive Scenedesign |
|
Enable Parallel Outputs |
3_ENG_PARALLEL_OUTPUTS |
Enables multiple outputs |
|
ClipPlayer Pro |
ENG_CLIP_PLAYER_PRO |
Enables playback of licensable Video Codecs like h265 or HAP |
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 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 |
|
|
|
|
|
Clips / Clip Player |
|
|
|
|
|
Engine Core plug-ins |
|
|
|
|
|
SDI/IP Input |
|
|
|
|
|
SDI/IP Output |
|
|
|
|
|
NDI Input |
ENG_CF_NDI |
|
|
|
|
NDI Output |
|
|
|
|
|
Mezzanine IP in |
|
|
|
|
|
Mezzanine IP out |
|
|
|
|
|
Frameserver |
|
|
|
|
|
DVI Out (<=2K) |
|
|
|
|
|
Unlimited DVI Out (Videowall) |
|
|
|
|
|
4K Enablement |
|
|
|
|
|
Unlimited Frameserver |
|
|
|
|
|
Chroma Keyer |
|
|
|
|
|
Global Illumination |
|
|
|
|
|
Multitouch Plug-ins |
|
|
|
|
|
Bone&Skin Live Motion Capture |
|
|
|
|
|
Cinema 4D Import |
|
|
|
|
|
RTT Shaders |
|
|
|
|
|
Substance Shader |
|
|
|
|
|
Dolby E Encoding |
|
|
|
|
|
Dolby E Decoding |
|
|
|
|
|
DNxHD Codec |
|
|
|
|
|
Erizos Plug-ins |
|
|
|
|
|
Dorna Plug-ins |
|
|
|
|
|
UE4 Render Blade Core |
|
|
|
|
|
DSX Core HD license |
|
|
|
|
|
DSX Core UHD license |
|
|
|
|
|
Flexbox plug-in |
|
|
|
|
|
Enable Parallel Outputs |
|
|
|
|
|
ClipPlayer Pro |
|
|
|
|
ENG_ARTIST 
WIBU Licenses and Their Effect
A WIBU license is a dedicated license (application ID) in the WIBU license system.
|
License short name and |
WIBU Share Status |
Description |
|
Core Licenses |
Core licenses are used as prerequisite for other licenses and define the basic feature set. |
|
|
ENG_ENG_CORE |
Shared |
Basic core license to be able to start Viz Engine. Included functionality:
|
|
ENG_PRV_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:
Enabled (if licensed):
Included functionality:
Watermark on all OUTs at any time and all resolutions
|
|
ART_ARTIST_FREE |
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).
|
|
VIZLIB_LIBERO_CORE |
User Counted |
OEM Core for Viz Libero Enabled:
|
|
VIZARE_VIZARENA_CORE |
User Counted |
OEM Core for Viz Arena Enabled:
|
|
VIZLIB_LIBERO_CORE |
User Counted |
OEM Core for Viz Arena Enabled:
|
|
ENG_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 |
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:
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 |
No User Limit |
Shipped with and requires ENG_ENG_CORE. Basic license to be able to start the Viz Artist. |
|
ENG_PRV_ARTIST |
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 |
Shared |
Requires ENG_ENG_CORE or ING_ING_CORE. SDI/IP Video Input (unlimited channels) |
|
ENG_IN_NDI_MAX |
Shared |
Requires ENG_ENG_CORE. Additional NDI streams require unlimited version of respective stream type |
|
ENG_IN_MEZZIP_MAX |
Shared |
Requires ENG_ENG_CORE. Additional RTP/UDP streams require unlimited version of respective stream type |
|
Output Licenses |
|
|
|
ENG_OUT_SDIIP |
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 |
User Limit |
Requires ENG_ENG_CORE. Additional NDI streams. |
|
ENG_OUT_MEZZIP_MAX |
Shared |
Requires ENG_ENG_CORE or ENG_SVCHOST_COR. Additional RTP/UDP streams. |
|
3_ENG_PARALLEL_OUTPUTS |
User Limit |
Requires ENG_ENG_CORE or ENG_PRV_COR.E Enables multiple output from same instance. Currently implemented for NDI only. |
|
Other Licenses |
|
|
|
ENG_ING_4KVIDEO |
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 |
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 |
Shared |
Requires ENG_ENG_CORE. Multiple Frame Server instances per Node. |
|
ENG_CLIP_PLAYER_PRO |
User Limit |
Requires ENG_ENG_CORE. Allows playback of additional Clip codecs like h265 or HAP with VML player. |
|
Plug-in Licenses |
|
|
|
ENG_PLUG_CHROMAFX |
Shared |
Requires ENG_ENG_CORE. |
|
ENG_PLUG_GI |
Shared |
Requires ENG_ENG_CORE. |
|
ENG_PLUG_MULTITOUCH |
Shared |
Requires ENG_ENG_CORE. |
|
ENG_PLUG_MOCAPREAD |
User Limit |
Requires ENG_ENG_CORE. |
|
Flexbox plug-in |
User Counted |
Requires ENG_ENG_CORE or ENG_PRV_CORE. |
|
Third Party Plug-in Licenses |
|
|
|
ENG_PLROY_CINEMA4D |
Shared |
Requires ENG_ENG_CORE or ENG_PRV_CORE. |
|
ENG_PLROY_DOLBYDEC |
Shared |
Requires ENG_ENG_CORE or ENG_PRV_CORE. |
|
ENG_PLROY_DOLBYENC |
Shared |
Requires ENG_ENG_CORE or ENG_PRV_CORE. |
|
ENG_PLROY_DNXHD |
Shared |
Requires ENG_ENG_CORE or ENG_PRV_CORE. |
|
ENG_PLROY_RTTFX |
Shared |
Requires ENG_ENG_CORE or ENG_PRV_CORE. |
|
ENG_PLROY_SUBSAUTH |
Shared |
Requires ENG_ENG_CORE or ENG_PRV_CORE. |
|
ENG_PLROY_EZGALLERY |
Shared |
Requires ENG_ENG_CORE or ENG_PRV_CORE. Erizos licenses. |
|
ENG_PLROY_EZPOSTFX |
Shared |
|
|
ENG_PLROY_EZSHADERS |
Shared |
|
|
ENG_PLROY_EZMESH |
Shared |
|
|
ENG_PLROY_EZDEFORM |
Shared |
|
|
ENG_PLROY_EZCOMPOSER |
Shared |
|
|
ENG_PLROY_EZLOGIC |
Shared |
|
|
ENG_PLROY_EZLINK |
Shared |
|
|
ENG_PLROY_EZTUBULA |
Shared |
|
|
ENG_PLROY_EZJSPRO |
Shared |
|
|
ENG_PLROY_DORNA_MTAP |
Exclusive |
Requires ENG_ENG_CORE or ENG_PRV_CORE. Dorna licenses.
|
|
ENG_PLROY_DORNA_MTPL |
Exclusive |
|
|
DSX Core HD 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. These licenses are marked as orange. |
|
Core not available |
|
A previously configured Core license which is not available anymore |
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.
|
MezzIP Possible OUTs |
Engine Effect |
Engine Licenses Consumed |
|
1 RTP/UDP IN (2K), |
Instance 1: |
1 ENG_ENG_CORE, |
|
1+ RTP/UDP IN (2K), |
1+ RTP/UDP IN (2K) |
1(+) ENG_ENG_CORE, |
|
1 RTP/UDP IN (2K), |
1 RTP/UDP IN (2K) |
ENG_ENG_CORE, |
|
1+ RTP/UDP IN (2K), |
1+ RTP/UDP IN (2K) |
ENG_ENG_CORE, |
|
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
-
Integration with Unreal Engine under Third Party Applications and Files in the Viz Artist User Guide.