Viz Pilot User Guide

Version 7.2 | Published May 08, 2017 ©

Setting Parameters using Pilot Data Server

The Settings tab is used to configure the following values:

• VCP Parameters

• Search Providers

• Tag Settings

Note: Google Chrome is phasing out support for NPAPI plugins, which means the Pilot Data Server configuration page might not work in your version since it requires Silverlight. We recommended using Internet Explorer if you run into this issue.

VCP Parameters

images/docs.vizrt.internal/viz-pilot-guide/7.0/assets/dataserver_vcp_parameters.png

The VCP Parameters page allows the user to configure settings for the Viz Pilot system’s applications. A description of useful database parameters is listed in Database Parameters.

This section contains the following topics:

  • To give applications access to the Pilot Data Server

  • To give applications access to the Preview Server

  • To give applications access to the Update Service

  • To set the VCP Parameters for the Crop Service

  • To enable the built-in Object Store search

  • To configure Order Management

To give applications access to the Pilot Data Server

  1. See how To access the Pilot Data Server Web Interface

  2. Click the Settings link

  3. Select the app_server setting, and add the parameter for the machine you installed the Pilot Data Server on (i.e. <DataServer>:8177)

  4. Click Save

  • This will give all applications with a connection to the database access to the Pilot Data Server.

IMPORTANT! Firewalls must allow inbound communications on port 8177.

To give applications access to the Preview Server

  1. See how To access the Pilot Data Server Web Interface

  2. Click the Settings link

  3. Select the preview_server_uri setting, and add the parameter for the machine you installed the Preview Server on (i.e. http://<hostname>:54000)

    • This machine, with Viz Engine and Preview Server installed, is typically identified as your frame server.

  4. Click Save

  • This will give all applications with a connection to the database access to the Preview Server.

To give applications access to the Update Service

  1. See how To access the Pilot Data Server Web Interface

  2. Click the Settings link

  3. Select the script_runner_uri setting, and add the parameter for the machine running the Update Service (e.g. http://<hostname>:1981)

    • This setting is needed if templates run scripts that use the update service

  4. Click Save

  • This will give all applications with a connection to the database access to Script Runner.

IMPORTANT! If you change the script_runner_uri parameter (after setting it the first time) you need to restart the Media Sequencer for it to take effect.

To set the VCP Parameters for the Crop Service

  1. See how To access the Pilot Data Server Web Interface

  2. Click the Settings link

  3. Select the crop_service_uri setting, and add the parameter for the machine you installed the Pilot Data Server on:

    • http://<cropservicehostname>:8178 /

  4. Optional: Set the MediaSearch_ItemPerPage = Number of items per page to get from MediaSearch.

  5. Optional: Set the croptool_max_image_area to adjust the maximum size of a cropped image that will be served by the Pilot Data Server.
    If the image size (*) is larger than croptool_max_image_area, then the image will be resized, while still respecting the aspect ratio of the crop. The maximum image size applies even if no cropping is done.
    * Image size = image width x height in pixels.

  6. Click Save

To enable the built-in Object Store search

The built-in Object Store search is turned off by default. To enable or disable it:

  1. See how To access the Pilot Data Server Web Interface

  2. Click the Settings link

  3. Select the disable_built_in_vos_search setting,

    • To use built-in Object Store search, set disable_built_in_vos_search to false
    • To use RestVOS search, set disable_built_in_vos_search to true

  4. Click Save

To configure Order Management

This procedure assumes that you have a Viz One system installed and running the Order Management system. For more information on how to configure order management on Viz One, see the section on ‘Tasks and Order Management’ in the Viz One Administrator’s Guide.

  1. See how To access the Pilot Data Server Web Interface

  2. Click the Settings link

  3. Select the order_mgt_uri_template setting, and add the address of the Viz One machine which is hosting the order management system, eg:
    http://<fully-qualified-domain-name-of-viz-one>:8084/tasks/?user={user}&locale=en_US&theme=light#create;tl=work_order;form=create_wo_activex;asset-type=ITEM;upload=true;external-hooks=viznewsroom;closewin=false;set-attr=REQ_TYPE-{asset_type}

Search Providers

images/docs.vizrt.internal/viz-pilot-guide/7.0/assets/dataserver_search_providers.png

Both Director and Viz Pilot News get their Viz One connection parameters from the Viz Pilot database. The Media Sequencer must be configured using your control application.

Asset search providers can set to active or inactive. Disabling a search provider means that it will not be used when searching for assets in a template.

This section contains the following topics:

  • To configure search providers (Viz One)

  • To configure search providers (RestVOS)

  • Authentication for Feed Browser

To configure search providers (Viz One)

  1. See how To access the Pilot Data Server Web Interface

  2. Click the Settings link

  3. Click the Search Providers link

  4. Under Asset search providers click the Add button and enter the host’s service document URL

    • For Viz One 5.4 and later: https://<viz_one>/thirdparty/
    • For Viz One 5.3: https://<viz_one>/api/

    Note: Make sure you enter the correct protocol. For example, if a Viz One is set up on https it will require an https URL.

  5. Add a Short name to help identify the asset’s location, for example in search results.

    • eg. VizOne

    Note: If you change the short name you need to restart the server for the changes to take effect (see To modify the Pilot Data Server database settings ).

    The image below shows the Search Provider Short Name as displayed in search results:

    images/docs.vizrt.internal/viz-pilot-guide/7.0/assets/search_providers_short_name.png

  6. Under Pre-authenticated hosts click the Add button and enter the host’s URL, username and password in order to authenticate your search

    • URL of the host, e.g.: https://<viz_one>/
    • Username and password of the pre-configured user on the Viz One system (configured in the Studio admin web interface)
    • This is required for Viz One (not Object Store)

    WARNING! The username and password used here are available in clear text to anyone who has access to the Settings page. The Viz One user entered here should therefore be given as few rights on the Viz One as possible.

  7. Click Save

To configure search providers (RestVOS)

By default, Viz Pilot 6.0 and later uses the RestVOS search, and a search provider representing the current Pilot Data Server is configured automatically. This requires that the correct value (i.e. a public name that points to the current Pilot Data Server) has been stored in the app_server parameter in VCP Parameters. Changes to this value are picked up during restarts.

The auto-added search provider can be renamed or made active/inactive on the Search Providers page. The uri cannot be changed.

Note: Upgrading from Viz Pilot 5.7 to Viz Pilot 6.0 can result in two search providers with the same URL (i.e. the one that existed before and the new one). The new one is disabled so it will not interfere, but if you want to clean up the list you can delete the old one and activate the new one.

Note: If you change the short name you need to restart the server for the changes to take effect.

Authentication for Feed Browser

The Pre-authenticated hosts configured in the Pilot Data Server also apply to the Feed Browser when hosted in a Viz Pilot system application (see Feed Browser Authentication ).

Tag Settings

images/docs.vizrt.internal/viz-pilot-guide/7.0/assets/dataserver_tagsettings.png

The Tag Settings page is used for administering tags. The tags are assigned to templates in Template Wizard, and then used in Viz Pilot News to organize templates.

To access the Tag settings

  1. See how To access the Pilot Data Server Web Interface

  2. Click the Settings link

  3. Click the Tag settings link

Tag Settings functions

Function

Description

Add tag

Click the Add Tag button and enter a name for the new tag.

images/docs.vizrt.internal/viz-pilot-guide/7.0/assets/dataserver_tagsettings_rename.png

Click the Rename icon to rename the selected tag

images/docs.vizrt.internal/viz-pilot-guide/7.0/assets/dataserver_tagsettings_delete.png

Click the Delete icon to delete the selected tag.

Note: Deleting a tag will not delete the templates that refer to that tag.