Troubleshooting
MIKE OPERATIONS Web Troubleshooting¶
This document describes Troubleshooting problems during the MIKE OPERATIONS Web Installation and Deployment processes.
Installation¶
Server Error ‘/’ Application¶
From “Programs and Features”, install the Windows feature “Internet Information Services Hostable Web Core”.
HTTP Error 500.19 - Internal Server Error¶
When installing MIKE OPERATIONS Web on Windows Server 2012 R2 or Windows Server 2016, an internal server error could be shown when trying to access the website configured.
The reason for this can be that WCF Services is not installed, as WCF services is not activated by default when installing Windows Server 2012 R2 or Windows Server 2016.
To activate WCF services:
-
Login as administrator on the server.
-
Select Start > Server Manager
-
In Server Manager, select Manage > Add Roles and Features
-
Expand .Net Framework 4.5 Features
-
Select WCF Services
Deployment¶
Service unavailable¶
If the web site keeps reporting “Service unavailable”, the cause could be memory allocation issues on the web site.
To force the website to keep running even when errors occur, turn off “Rapid-Fail Protection” on the app pool (below image assumes that the DefaultAppPool is used).
Using available memory¶
The website is configured to use 50% of the installed memory. In cases where lots of memory is available (>8Gb), the amount of memory can be increased.
The “Web.config” file, found in the root of the website folder, contains a setting “physicalMemoryLimitPercentage”. Increase this number to use more memory, and decrease the memory use if the server containing the website, does not have that much memory (\<4Gb).
Optimizing visualization of meshes and grids¶
When running animations, visualizing of meshes (dfsu) and grids (dfs2), is a processing heavy operation, as a new image is created for each time step at runtime.
The processing of the image is using every available CPU’s (cores) on the web server to make the animation as smooth as possible.
If the animation is not running smooth or if the animation is flickering, note the following to find the cause:
-
Check the Network throughput using the Windows Task Manager. Dfsu and dsf2 files should be placed on the web server, to minimize the network traffic. Especially when using large files.
-
Check the CPU Utilization using the Windows Task Manager. The more CPU’s (cores) on the web server the better, as the image processing is using all available CPU’s.
-
Check the memory usage using the Windows Task Manager. To minimize hard disk operations, make sure that not all memory of the server is used. Add more RAM to the server if needed.
-
Check the disk activity using the Windows Task Manager. A lot of activity can be solved by more RAM and/or a SSD. A Solid State Drive (SSD) is much faster than an ordinary hard disk.
-
Check the number of elements in the dfsu and dfs2 files. Reduce the number of elements in the files if possible.
-
Set the projection of the dfsu and dfs2 files to Web Mercator, to prevent a reprojection of the files during the image generation.
Providing public access to the website¶
One important concept in the communication over the internet are ports.
If you would like to share the website to people outside the DNS you may consult the following web information:
https://lifehacker.com/127276/geek-to-live--how-to-access-a-home-server-behind-a-routerfirewall
http://www.nch.com.au/kb/10046.html
Localhost does not show¶
Create a new website in IIS.
Then choose a port number.
MIKE OPERATION opens but data does not show¶
Open developer tools.
Open debug console and refresh page with F5.
Look for line in red and click on it.
- Case 1:
You need to make sure name is correct in IIS.
- Case 2:
Port Number.
- Case 3:
GIS manager api.
This means there is a problem with the GIS WebAPI. Click on the link. You should receive the following error:
This means you should update the database.
- Case 4:
Case sensitive.
- Case 5:
There is no red line.
Open License.
System.web/identity\@impersonate problem¶
Solution: change in AppPool basic setting the pipeline mode to classic.
System.IdentityModel.Tokens.Jwt¶
The solution is to update the version in Web.config.
Creating custom Symbology for dfs2 and dfsu files¶
By default, the symbology of dfs2 and dfsu files on MO Web, is applied using a rainbow pattern, dividing the largest and the smallest value the mesh or grid into 10 intervals.
This symbology can be customized using xml files placed with the dfsu or dfs2 file. The name of the xml file should contain both the name of the file and the name of the item like this.
The xml file can be made manually or can be generated using a remote file based raster provider in the GIS Manager of MIKE WORKBENCH.
Two types of symbology xml files are supported:
-Gradient symbology type
The gradient symbology type allows specifying the minimum value and the maximum value, a colour gradient range the number of intervals.
-Value Range symbology type
The value ranges symbology type allows specifying every value range and the colour of the value range.
IIS Output Caching¶
Internet Information Services (IIS), supports configuring cache output, so that users using a website, will automatically get any updated file, without clearing the client cache.
Select “Output Caching”.
It is recommended to add output caching for the following file types for a web site containing MIKE OPERATIONS Web.:
-
*.html Web pages.
-
*.json Configuration files.
-
*.png Images.