Quick Start

1. Install the ImEx Agent.

2. View web interface on http://127.0.0.1:19390/index.html .

3. The initial configuration wizard displays if no destination directories exist.
   

4. Select a Graphic Hub REST host to use for importing assets. You can also enter the host manually, in the format http://resthost:port/. The GH REST must be bound and connected to a running Graphic Hub.

   Note: When using a Main - Replication cluster make sure BOTH servers are running at the time ImEx is configured!

   Note: Only use Hostnames for Graphic Hubs when configuring GH REST and ImEx Agent, using IP Addresses does not work with ImEx!

   Note: GH REST version 2.0.1 or newer and Graphic Hub version 3.0.1 or newer are required.

   

5. Providing a valid GH REST host enables the Login panel. Provide a valid GH username and password from the Graphic Hub you are connecting to.
   

   

6. Select a destination directory (folder or project), by clicking the browse icon (...) on the right side. You can also create new projects or folders using the directory browser.
   

   

7. Save the selected destination directory by pressing OK, then Add.
   

   

After successful configuration, the ImEx status page opens.

Configure ImEx for Media Staging

The following describes how to configure ImEx for media staging using (third-party) search providers. For a guide on how to setup related Viz products for media staging, see Basic Media Sequencer Configuration.

After setting up ImEx (see Quick Start), a search provider in Pilot Data Server and other media staging related Viz products, also add the fitting pre-authenticated host to ImEx's pre-authenticated hosts list, see Manage Pre-Authenticated hosts.

Basic Media Sequencer Configuration

The following list describes how to setup Media Sequencer for media staging via ImEx Agent.

1. Setup Viz Pilot and Media Sequencer, see Basic Viz Pilot and Media Sequencer setup using, for example, a Viz One as search provider.

2. Open the Media Sequencer configuration file named default.xml in an editor of your choice. By default, this file is located in C:\ProgramData\vizrt\Media Sequencer.

3. Disable the http_resource_poller by adding:

   mode="disabled"

4. In the scheduler section of the configuration file, add the following node:

   <handler type="vme" name="imex_image_staging">

   <entry name="service_document">http://my-imex-host:my-imex-port/</entry>

   <entry name="log_level">50</entry>

   <publish_media_type>image</publish_media_type>

   </handler>

   Here, my-imex-host and my-imex-port need to be set to the relevant ImEx host name in lowercase format (e.g. imex-host) and the relevant port that ImEx uses (e.g. 19390), respectively.

5. When using a single Graphic Hub/Viz Artist: Add a single publishing point to Media Sequencer by adding/configuring the following node in the config section of the configuration file:

   <entry name="global_publishing_points">

   <entry name="image">

   <entry name="uri">http://my-imex-host:my-imex-port/publishingpoint/my-pp-uuid</entry>

   <entry name="atom_id">MY-PP-UUID</entry>

   </entry>

   </entry>

   Here, my-imex-host, my-imex-port, my-pp-uuid and MY-PP-UUID need to be set to the host name in lowercase format used in bullet 3, the port used in bullet 3, the UUID of the relevant publishing point in lowercase formatted as xxxxxxxx-xxxx-xxxx-xxxxxxxxxxxx (e.g. c94a50d8-867b-11e7-bb31-be2e44b06b34) and the used publishing point UUID in uppercase format (e.g. C94A50D8-867B-11E7-BB31-BE2E44B06B34).

   When using multiple Graphic Hubs/Viz Artists: To distribute images used for media staging to several Graphic Hubs, first remove the global_publishing_points node from the config section of the configuration file. Then, add a distinct publishing point for each Viz Engine by adding the following nodes to the handler sections of type viz in the configuration file:

   <entry name="image_publishing_point_uri">http://my-imex-host:my-imex-port/publishingpoint/my-pp-uuid</entry>

   <entry name="image_publishing_point_atom_id">MY-PP-UUID</entry>

   The Viz handlers can be configured in Director, see the Profile Configuration page in the Director Configuration section of the Viz Pilot User Guide. Again, set my-imex-host, my-imex-port, my-pp-uuid and MY-PP-UUID (see bullet 4).

   Note: For each Viz handler, add a publishing point on the Graphic Hub connected to the Viz Artist/Engine which corresponds to the currently relevant Viz handler. Adding an image publishing point to a solely configured Viz handler achieves the same effect as adding a global publishing point.

   Again, the global_publishing_points node has to be removed from the config section to enable publishing points bound to Viz handlers.