...
Troubleshooting is a long process of log analysis and knowing expected exception; here are quick answer to common knowledge that may or may not solve the issue but provide a starting point to understanding the problems. If the issue is not found below, it may be found under CONNECT Community Forum.
| Table of Contents |
|---|
Build Exceptions
What can I do if I can't build the EAR due to validation suite failing?
The EAR is still built before this state and can be located in the Target folder. You can deploy this EAR file manually to your server and debug it with your IDE of choice. You may then run the SoapUI validation suite manually while being able to use breakpoints and step into the methods / features that are failing.
Configuring and Deploying CONNECT
...
Try adding the certificate in the CONNECT application keystore (default one is gateway.jks). If it’s a self-signed certificate then you may also have to put it in the truststore(default one is cacerts.jks) also. CONNECT uses 2-way SSL authentication, you have to import the CONNECT cert into your application truststore and also enable 2-way SSL, it’s a eHealh exchange WS-Security requirement. Please note the secured Adapter interfaces use the same security polices as that of health exchange.
Build Exceptions
What can I do if I can't build the EAR due to validation suite failing?
...
General errors
Why isn't my custom adapter being called?
Double check the proxy settings are correct. If you are using a Java bean as your adapter, ensure you have defined the bean and set the alias configuration to use that bean instead. Also double check the class is correct and is being injected via Spring. If a webservice is being used, ensure the web proxies are set and the URL of your webservice is listed in the Internal Exchange Info configuration under the correct service name and API spec level.
Why can't I log into the Admin GUI?
Ensure you are using the right Username / Password. You can reset the Admin GUI accounts by running the supplied SQL scripts to reset the database to its default CONNECTAdmin account.
SOAPUI ValidationSuite fails to run correctly
Make sure your SoapUI has the libraries (FileUtils and MySQL jars) installed to run the ValidationSuite.
SoapUI Validation Fails with NPE before it hits the server
Make sure your GatewayPropDir property points to the nhinc property folder
The property 'nhinc.properties.dir' is not being found
Check your jvm making sure the path is being specifed: -Dnhinc.properties.dir=//Your/Path/Here/
SoapUI at a remote location
All that needs to be done is to change the endpoint so that the message is sent to the correct location.
Differences between secure and unsecure adapter web service requests
the wsdls are different because the secured versions translate the CONNECT assertion element into an actual SAML assertion, while the unsecured version just keeps CONNECT assertion element
Where's the documentation on how to build an adapter?
the reference adapter which come with CONNECT are a great place to start. In general adapters can be developed on three different interfaces; java, web services, and secured web services. You can implement the adapter’s java interface and package your implementation in the CONNECT application (ear), or go for web services. The WSDLs are in github so if you are familiar with WSDL first web services you can go that route.
Please refer to the Adapter Implementation wiki page for more information.
Security Exceptions
Why are later versions of CONNECT throwing SAML exceptions?
...
If your local gateway uses the CommonType JAR, make sure it the correct version. Otherwise, please make sure your local gateway is using the correct schema.
General errors
Why isn't my custom adapter being called?
Double check the proxy settings are correct. If you are using a Java bean as your adapter, ensure you have defined the bean and set the alias configuration to use that bean instead. Also double check the class is correct and is being injected via Spring. If a webservice is being used, ensure the web proxies are set and the URL of your webservice is listed in the Internal Exchange Info configuration under the correct service name and API spec level.
Why can't I log into the Admin GUI?
Ensure you are using the right Username / Password. You can reset the Admin GUI accounts by running the supplied SQL scripts to reset the database to its default CONNECTAdmin account.
SOAPUI ValidationSuite fails to run correctly
Make sure your SoapUI has the libraries (FileUtils and MySQL jars) installed to run the ValidationSuite.
SoapUI Validation Fails with NPE before it hits the server
Make sure your GatewayPropDir property points to the nhinc property folder
The property 'nhinc.properties.dir' is not being found
Check your jvm making sure the path is being specifed: -Dnhinc.properties.dir=//Your/Path/Here/
SoapUI at a remote location
All that needs to be done is to change the endpoint so that the message is sent to the correct location.
Differences between secure and unsecure adapter web service requests
the wsdls are different because the secured versions translate the CONNECT assertion element into an actual SAML assertion, while the unsecured version just keeps CONNECT assertion element
Where's the documentation on how to build an adapter?
the reference adapter which come with CONNECT are a great place to start. In general adapters can be developed on three different interfaces; java, web services, and secured web services. You can implement the adapter’s java interface and package your implementation in the CONNECT application (ear), or go for web services. The WSDLs are in github so if you are familiar with WSDL first web services you can go that route.
Please refer to the Adapter Implementation wiki page for more information.