This section contains troubleshooting suggestions for issues relating to the Synchronizer.
Logs are located in the logFolder location specified in the Install the Synchronizer.
Note: The following logs relate to the Synchronizer Service. Similar log files can be found in the parallel locations for the Integration Bridge Service.
Synchronizer Application logs: <logFolder>/sync/app/app.log
Audit logs: <logFolder>/sync/Audit/Audit.log
SSO logs: <logFolder>/sync/Hpsso/hpsso.log
REST interface logs: <logFolder>/sync/rest/rest.log
Synchronizer service logs: <logFolder>/sync/wrapper/wrapper.log
Error when enabling a service
ALM Octane site log
Check the ALM Octane site log for an error. This is usually located in /opt/octane/logs/nga/site/site.log.
If you receive the message Unexpected exception occurs, contact administrator for support, while enabling the Bridge Service or Synchronizer Service from the ALM Octane UI (displayed in the logs and UI), make sure the user running ALM Octane has read permissions to the service.locator.properties file which resides by default in <octane_install_dir>/webapps/service.locator.properties.
HTTP status code 502
If you receive an error saying HTTP status code is 502, this means ALM Octane is configured to use a proxy and it cannot connect to the Synchronizer or IBS. Make sure the proxy can connect to the Synchronizer or IBS machines.
Authentication 401 error
If the Integration Bridge Service or Synchronizer Service receives an authentication 401 error (displayed in the Synchronizer Service or IBS logs), the service cannot authenticate to ALM Octane. Check that the sso > initString parameter value is identical in the configuration parameters of ALM Octane, the Synchronizer Service, and the Integration Bridge Service.
PWC6345: There is an error in invoking javac. A full JDK (not just JRE) is required
If you receive the message “org.apache.jasper.JasperException: PWC6345: There is an error in invoking javac. A full JDK (not just JRE) is required” when using the ALM Octane Synchronizer UI, make sure the service is running on OpenJDK,
If this is not possible, see Running the Synchronizer service on OpenJRE.
Error 404 when opening the Synchronizer link from the ALM Octane UI
This can happen if the Synchronizer and Integration Bridge services are on a different URL than ALM Octane, and you did not define SYNC_BASE_URL and EXTERNAL_HELP_URL in /opt/sync/conf/octane.site.params.properties, as described in Step 1: Configure ALM Octane to enable the integration.
You can fix this by adding the entries directly in the ALM Octane database and restarting ALM Octane. In the PARAMS table of the ALM Octane site admin database, add entries for SYNC_BASE_URL and EXTERNAL_HELP_URL. The SYNC_BASE_URL format is
User is repeatedly redirected to the ALM Octane login page
This usually happens because of cookie sharing problems, when ALM Octane and Sychronizer are on different domains.
To check cookies and make sure they are set correctly, you can use Chrome Developer tools > Application > Cookies.