Troubleshooting
The following information can help you troubleshoot when errors occur.
Web service help - terminal commands
| To view: | Use: |
|---|---|
| All available service commands | hpmweb --help |
| Verbose output of all help commands | hpmweb --help –v |
Logs
The following logs are available. Check these log files first for information when troubleshooting.
| Log file | Location/filename in web service installation directory |
|---|---|
| Web service startup and integration log | /Log/HPMWeb.log |
| web client log | /Service/Log/HansoftWebService.log |
| Web server (nginx) log | /nginx/logs/error.log |
Common HPMWeb.log messages
Hansoft SDK session opened successfully message
A message similar to the following should be displayed as the last line in the log after web service installation is complete and the service is running:
2019-05-23 14:49:42.828 [Info] Hansoft SDK session opened successfully.
No node distribution message
A message similar to the following may be displayed in the log:
2019-05-23 14:20:36.126 [Info] No node distribution installed, installing distribution with checksum 'd6f5cc9db04b097fde100b1c06dddb77'
If this message is displayed, wait a few minutes for the web service to respond and it should work normally.
Unable to open service manager message
A message similar to the following may be displayed after attempting to add the web service from a command line:
C:\HPMWeb>hpmweb --daemon-add
Unable to open service manager: Access is denied.
This indicates that you are not running the command as an Administrator user, which is required to add the service. See the operating system help for information about running commands as an Administrator.
Common HansoftWebService.log messages
App startup finished: HansoftWebService message and pause during web service startup
If you have a large Hansoft database, there may be a long pause when starting the web service. A message similar to the following is displayed in the log:
2019-05-24 14:39:43.222 <Mib/Concurrency/App> [Info] App startup finished: HansoftWebService
This indicates that the web service is syncing with the database. In the Admin view in the Hansoft Client, you can see that the WebSDK user is syncing. During the sync, you can use standard operating system tools to monitor memory usage for the web service and Hansoft Server to make sure operating system does not run out of memory.
When the sync is complete, a message similar to the following is displayed:
2019-05-24 14:40:18.285 [Info] Hansoft SDK session opened successfully.
