This page will include an ongoing list of troubleshooting items for the IBN ICN Connector for VirtualViewer®.

Unsupported file format error

ERROR: I get the following popup error when I try to open a document:

Unsupported file format error message

This error typically occurs when the license file is incorrect or unavailable for VirtualViewer®.

Try the following remedies:

  1. Check to see if you received a new license file with the deployment package and ensure that the new license file is copied to the VirtualViewer® libraries folder, <webapps>\VirtualViewerJavaHTML5\WEB-INF\lib\SnowboundLicense.jar.

    If the license file was copied after the application was deployed, some app servers require the web app to be restarted.

  2. Check to see if you are able to open standard formats (like PDF, TIF etc.) or if those have the same issue as well.

  3. Update web.xml to directly refer to the license file (some app servers like JBOSS have difficulty resolving app deployment paths):

  • Open the VirtualViewer WAR file using 7-zip.
  • Copy the web.xml from \VirtualViewerJavaHTML5.war\WEB-INF\ to your local drive.
  • Open the web.xml in a text editor.
  • Navigate to the very end where it lists the path for license:

    <env-entry>
        <env-entry-name>snowboundLicensePath</env-entry-name>
        <env-entry-value>./WEB-INF/lib/SnowboundLicense.jar</env-entry-value>
    
  • Change the relative path to a fixed path where the app server could get the license JAR from:

    <env-entry>
        <env-entry-name>snowboundLicensePath</env-entry-name>
        <env-entry-value>C:/Snowbound/SnowboundLicense.jar</env-entry-value>
    
  • Save the web.xml and drag/drop it to the \VirtualViewerJavaHTML5.war\WEB-INF\ in 7-zip. This should replace/update the web.xml file.
  • Close the WAR to save.
  • Redeploy the WAR.

Where do I find my CEUri?

Follow the steps below to locate the CEUri required for configuration of the VirtualViewer:

  1. Login to ICN Admin at http://<your IBM Content Navigator Server>:<port>/navigator/?desktop=admin

  2. Navigate to Repositories. Find my CEUri

  3. Select the Repository that is being used in the Desktop that will be running the VirtualViewer and click Edit.

  4. Copy the value located in the Server URL field and use that to configure the CEUri in the P8ContentHandler.properties file. Find my CEUri