Graphic Hub Administrator Guide

Version 3.1 | Published July 11, 2018 ©

Troubleshooting GH ImEx Agent

This section provides help for troubleshooting the following scenarios:

Unable to connect to GH ImEx Agent service

This indicates that the GH ImEx Agent HTTP server is not accessible or that the service is not running.

images/download/attachments/33953166/ts11.png

  1. Press [Windows] + R.

  2. A Run window opens in the bottom left corner.

  3. Enter services.msc and click OK. An overview of services opens.

  4. Check whether the Viz GH ImEx Agent service is in Running status.

  5. If the service is not running, right click the Viz GH ImEx Agent service and select Start or Restart.

    images/download/attachments/33953166/ts12.png
  6. In the ImEx Agent web interface, click Retry to connect or refresh the page in the browser.

Status box displays an error

  1. Click on the error icon to get forwarded the page where you can investigate the error.

    images/download/attachments/33953166/status01.png
  2. In this example, we are taken to the GH REST hosts overview page. Hover the mouse over the error to display more information, as for example, Request failed: Status='502'.

    images/download/attachments/33953166/status02.png
  3. The status code 502 Bad Gateway is returned because the Graphic Hub or REST host used in a Distribution plan is either not running or reachable.

Status box displays a warning

  1. Click on the warning icon to get forwarded the page where you can investigate the warning.

    images/download/attachments/33953166/warning_01.png
  2. In this example we are taken to the GH REST hosts overview page. Hover the mouse over the error to display more information, as for example, GH-Rest not reachable.

images/download/attachments/33953166/warning_02.png

Note: ImEx displays a warning although GH REST is not reachable. This is proper behavior, because the given host (here, http://TUTORIAL02:19398) is not referenced by any import jobs, as you can tell from the enabled trash can icon.

Media staging status shows an error

images/download/attachments/33953166/ms01.png

  1. Hover over the error icon to get further information:

    images/download/attachments/33953166/ms02.png
  2. In this example, the destination directory /data/ImportDirectory01 has been deleted. To resolve the error, select an existing folder by clicking the browse (...) icon.

    images/download/attachments/33953166/ms03.png
  3. Selecting an existing folder/project will resolve the error:

    images/download/attachments/33953166/ms05.png

    images/download/attachments/33953166/ms06.png

Media staging status shows a warning

  1. Hover over the warning icon to get further information:

    images/download/attachments/33953166/warning01.png
  2. In this example, the current folder has been renamed.

  3. To remove the warning, click the warning icon and Acknowledge to remove the warning.

    images/download/attachments/33953166/warning02.png

    images/download/attachments/33953166/warning03.png

    images/download/attachments/33953166/warning04.png