<note important>Preliminary documentation</note>

====== Troubleshooting for Orbit HTML5 Web Viewer ======

The page describes the resource and publication requirement to open and use the Html5 Web Viewer. 

===== Data preparations =====

All Mapping Runs\Oblique Projects included in a Publications have to be prepared properly and HTML5-ready. This readiness status is indicated in the Catalog, see [[https://orbitgt.com/kb/3dm_publisher]] --> Catalog --> Cloud & HTML5

===== Troubleshooting =====

==== No window pops-up ====

Browser pop-ups must be enabled for the HTML5 window to pop-up upon publishing or connecting to a publication.\\
Example: to enable pop-ups on Google Chrome, go to ../chrome/settings/content/popups  and "Allow" pop-ups for all websites or add an exception to allow pop-ups from a specific  Publisher.

==== Error message upon login ====

Displayed message:  

<code>
{"code": "1020","message": "The cloud metadata entry does not indicate a web compatible run (No file trajectory.ovf available); run file 'run_location\orbit_mm_run.omr' of project 'project_name' of publication 'publication_name' is not web compatible"}
</code>

This message error can be caused by: 
  * The [[194:technology:3d_mapping:supported_resources|MM Run]] is not ready for display in HTML5. The web-compatibility status and reason for incompatibility can be found in [[194:desktop_ext:catalog|]]
\\

Displayed message:  

<code>
Login error: {"code": "1022","message": "Unable to find project file 'project_location\project.ini' of project 'project_name' of publication 'publication_name'"}
</code>

This message error can be caused by: 
  * Project file has been moved/removed
\\

Displayed message:  

<code>
Login error: {"code": "1024","message": "Unable to find run '' of project 'project_name' of publication 'publication_name'"}
</code>

This message error can be caused by: 
  * MM Run has been moved/removed
  * The server cannot access the data, see: [[194:server:console:extensions|Data availability for EOS]]


Displayed message: 

<code>
Login error: {"code": "1010","message": "Unable to find dataset file 'WMS.Ortho' of workspace 'admin' of publication 'publication_name'"}
</code>

This message error can be caused by: 
  * Web services are not yet supported on HTML5.


Displayed message: 

<code>
Login error: {"code": "1016","message": "Invalid file format: '..\shp_name.shp';Dataset file '..\shp_name.shp' of workspace 'admin' of publication 'publication_name' is not web compatible"}
</code>

This message error can be caused by: 
  * Only vector files in Orbit formats are supported on HTML5. 


Displayed message: 

<code>
Login error: {"code": "1016","message": "Invalid file format: '..\database_table_name.odb';Dataset file '..\database_table_name.odb' of workspace 'admin' of publication 'publication_name' is not web compatible"}

Submit
</code>

This message error can be caused by: 
  * Databse data is not yet supported on HTML5.


Submit

==== Hanging on Loading Data ====

This  can be caused by: 

  * **No imagery is available in the run**
The HTML5 cannot operate if the run doesn't contain imagery.


  * **Web Sockets are not enabled**
Web Sockets must be enabled on the server machine. See: [[http://https://en.wikipedia.org/wiki/WebSocket|Wikipediq Web Sockets]]

Example of error message displayed message in Google Chrome Developer Tools: 

<code>
app.js?v=18.0.4:1 WebSocket connection to 'ws://localhost:1111/storageWebSocket?Service=StorageWS&StorageSpace=publisher&EMethod=0&EKey=ghKd4oF3lItFmSGiXrJK9Q==' failed: Connection closed before receiving a handshake response
</code>