WorldServer - New UI pages fail to be loaded if configure IIS as the reverse proxy

Article Number:000016548 | Last Updated:11/25/2021 11:58 AM

Scope/Environment

WorldServer 11.6.1
IIS 10

Symptoms/Context

After configuring IIS as a reverse proxy server for WorldServer11.6.1, it is expected that external users are able to access WorldServer with "https://ws_FQDN/wsxx".

However, "https://ws_FQDN/ws/xx" fail to display, pages are blank or show nothing but message " [page.home.welcome]".
"https://ws_hostname/ws-legacy/xx" can be loaded successfully but workflow editor page is redirected to "http://ws_hostname:8080/ws-legacy/xx".

Resolution

WorldServer configuration files should be configured correctly as below.

WS_CONFIG/general.properties

url_of_origin=https://ws_FQDN/ws-legacy
ws.legacy.url=https://ws_FQDN/ws-legacy
ws.api.url=https://ws_FQDN/ws-api
navigation.panel.url=https://ws_FQDN/ws

WS_CONFIG/ws/ui.properties

ws.legacy.url=https://ws_FQDN/ws-legacy
ws.api.url=https://ws_FQDN/ws-api

Server.xml (please comment out the lines of port HTTPS 8443 configuration)

<Connector port="8080" protocol="HTTP/1.1"
connectionTimeout="20000"
redirectPort="8443" />

Please refer to IIS site for details of IIS configuration. The following should be the general steps.
If the requirement is more compliated or anything goes wrong, please have local IT team or RWS professional service team involved.

1) Install url-rewite extension for IIS (http://www.iis.net/downloads/microsoft/url-rewrite)
2) Install Application Request Routing extension for IIS (http://www.iis.net/downloads/microsoft/application-request-routing
3) Create a blank website. Add a SSL certificate to this website
4) Click on URL Rewrite on the application pane of the website
5) Clink on Add rules and then select Reverse Proxy. Click OK.
6) In the inbound rules, enter "ws_FQDN:8080"

Root Cause

The parameters in WS_CONFIG/general.properties or WS_CONFIG/ws/ui.properties is wrongly configured. Below parameters are poiting to http url.

navigation.panel.url=http://ws_FQDN:8080/ws
ws.legacy.url=http://ws_FQDN:8080/ws-legacy

Reference

Send Article Feedback