Viz Engine Administrator Guide

Version 3.13 | Published March 28, 2019 ©


The Database section has three tabs for setting connections (i.e. a Graphic Hub, Failover servers and Deploy servers).

Global Properties

Use this section to configure the Graphic Hub database connection settings.


  • Host Name: Displays the name of the Graphic Hub naming service. The naming service is always a one to one map to the Host Name of the machine running a Graphic Hub.

  • Hub: Displays the Graphic Hub server name.

  • Port Number: Displays the listener port number for a Graphic Hub. The default port number is 19396, and should normally not be changed.

  • User: Sets the default user.

  • Additional Host Names: Displays the host name or IP address of a Graphic Hub database located on a different subnet, to make it selectable in the log onscreen database drop-down list. Multiple entries can be added, and must be separated by a semicolon. Hosts located on different subnets are highlighted in turquoise in the drop-down list.

  • Communication Timeout Settings:

    • Failover Timeout (sec): Sets the maximum time to wait before a fail over is initiated from the main to the replication Graphic Hub.

    • Global RT Timeout (sec): Sets the maximum response time for any request to a Graphic Hub.

    • Establishing Timeout (sec): Sets the maximum waiting time to establish a connection to a Graphic Hub.

  • Show Auto Log On:

    • Yes: Shows the Auto Log On check box in the Graphic Hub log on window.

    • No: Hides the Auto Log On check box in the Graphic Hub log on window.

  • Auto Log On: Enables or disables automatic log on to a Graphic Hub. This disables the log on screen for Viz Artist/Engine.

  • Import by Name: Checks for objects by name rather than by UUID when set to Yes. Checks by UUID when set to No.

  • Popup Server Messages: Enables or disables popup server messages. Disabled only works on local host.

  • Date Format: Sets the date format to EU (DD.MM.YYYY 13:54) or US (MM/DD/YY 01:54).

  • Archive Bit-Mode: Sets the bit-mode in which the archive is saved.

    Note: For compatibility, 32-bit should be enabled if scenes are imported to Viz Artist versions prior to build 2310.

  • Prefix: Needed if an external control application is used that sends commands containing certain path locations, but where the path of the files is a different one on the Graphic Hub (e.g. because they were deployed to a specific location).

    • Prefix Mode: Activates the prefix mode.

    • Prefix Converting Info: Shows the prefixed (final) paths in the console (this behaves like the Viz Artist 2.x debug mode).

    • Prefix Path: Contains the prefix path string that is used for incoming commands containing path parameters.

  • Transfer Buffer Size: Multiplies the standard buffer size of 51200 bytes by the value entered. This is only for the transfer buffer size to the Graphic Hub (Graphic Hub 2.4 and above only).

  • Max Search Results: Sets the maximum amount of search results which should show in the search result panel (see Item Search and SmartViewSearch in the Viz Artist User Guide).

    • All: Shows all results. To set a maximum amount, deactivate All.

      IMPORTANT! If All is selected this could produce a large number of search results, which may affect the performance of Viz Artist. Vizrt recommend that All should be used on small databases only.

  • Search Date Mode: Selects the results date order for Item Search and SmartView Search:

    • Modification: Sorts search results by their modification date.

    • Creation: Sorts search results by their creation date.

IMPORTANT! Every time the Viz Engine connects to a Graphic Hub, it creates a mapping of all GH REST connections. This mapping is used to speed up images loading by directly downloading images from the Graphic Hub instead of using the GH REST. If the connected GH REST is reconfigured to a different Graphic Hub, then the mapping is not updated until the Viz Engine disconnects and reconnects to Graphic Hub.

Failover Properties


To Add Redundant Servers to the Failover List

  1. Enter the Host Name of a Failover server.

  2. Enter the Graphic Hub instance for Failover.

  3. Enter the Port number of the Graphic Hub for Failover.

  4. Click Add.

  5. Use the Up and Down buttons in the database Failover list to raise and/or lower a database’s priority in the event of Failover.

  6. Click Save.

Deploy Properties


  • Added Deploy Servers Box: Shows all available Deploy Servers.

  • Add: Adds Deploy Servers (see To Add Deploy Servers).

  • Remove: Removes a selected Deploy Server.

  • Host Name: Displays the host name of the Graphic Hub machine to deploy files to.

  • Hub: Displays the name of the Graphic Hub instance to deploy files to.

  • Port: Displays the Graphic Hub listener port number.

  • Use Prefix Folders: Provides a simple server copy functionality that is able to rebuild the underlying structure from a source folder on the source server to a destination folder on the destination server. All references outside the source folder are rebuilt according to the original structure, under /data/. Set to Yes to select a source and destination folder for the deployment. Set to No to keep the structure the same as on the source server. See To Add Deploy Servers below for an example setup.

    • Prefix Folder UUID Source: Displays the source folder UUID on the Graphic Hub to deploy from.

    • Prefix Folder UUID Target: Displays the target folder UUID on the Graphic Hub to deploy to.

To Add Deploy Servers


Note: To configure deploy servers, the user you are currently logged in with on the source server must exist on the destination server with the same credentials.

  1. Enter the Host Name of a deploy server.

  2. Enter the name of the deploy Graphic Hub.

  3. Enter the Port number of the deploy Graphic Hub. The default port is 19396.

  4. If specific source and destination folders are required, set Use Prefix Folders to Yes.

    1. Enter the UUID of the Prefix Folder UUID Source.

    2. Enter the UUID of the Prefix Folder UUID Target.

  5. Click Add, and then Save.

See Also