Documentation Center

Troubleshooting Configuration Issues

Starting with WorldServer 11.1, a series of /wsgate endpoints have been created, where you can see the configuration values and the localization messages loaded at runtime. This can be useful to pinpoint configuration issues which are otherwise time-consuming and hard to find. Only administrators can access these endpoints and no passwords will be exposed when accessing them.

Troubleshooting ws-legacy configurations

The ws-legacy component uses one bundle per configuration file (such as general.properties, exchange.properties, tm.properties, and so on).

Use the following call to see all merged configuration values loaded at runtime for a specific bundle:
http://<ws-host>:<port>/ws-legacy/ws_gate?action=listConfig&basename=general&token=<token>
To see localization messages loaded at runtime, use the following call:
http://<ws-host>:<port>/ws-legacy/ws_gate?action=listConfig&basename=strings&token=<token>

Troubleshooting ws-api configurations

The ws-api component uses one bundle per multiple configuration files (such as general.properties, api.properties, hibernate.properties, tm.properties, td.properties, exchange.properties).

Use the following call to see all merged configuration values loaded at runtime:
http://<ws-host>:<port>/ws-api/v1/wsgate/config?token=<token>
The same is available for localization messages where ws-api uses one bundle per multiple localization files (such as strings.properties, api_strings.properties). To see localization messages loaded at runtime, use the following call:
http://<ws-host>:<port>/ws-api/v1/wsgate/messages?token=<token>&language=en
where language is the language code (e.g., en, ja, de).

Troubleshooting ws configurations

The ws component uses one bundle per multiple configuration files (such as general.properties, ui.properties).

Use the following call to see all merged configuration values loaded at runtime:
http://<ws-host>:<port>/ws/wsgate/config?token=<token>
The same is available for localization messages where ws uses one bundle per multiple localization files (such as strings.properties, ui_strings.properties). To see localization messages loaded at runtime, use the following call:
http://<ws-host>:<port>/ws/wsgate/messages?token=<token>&language=en
where language is the language code (e.g., en, ja, de).