Request Tracing
For error analysis, dg archive requests and responses can be logged in the "Portal Log File." Tracing is enabled as follows:
-
Open the "portal.cfg" file in the portal directory internal/cfg using a text editor of your choice.
-
Navigate to the "environment" section and add the following line to it:
<systemProperty name="com.sun.xml.internal.ws.transport.http.client.HttpTransportPipe.dump" value="true"/> -
Restart the portal service. For every dg archive operation, the web service request/response details are now logged in the "Portal_startup.log" file.
Example of a Request/Response Tracing entry:
---[HTTP request - https://10.10.101.213:8001/HypService]---
Accept: application/soap+xml, multipart/related
Content-Type: application/soap+xml; charset=utf-8;action="HypWcfApi.HypService/IHypService/MDocGetInfo"
User-Agent: JAX-WS RI 2.2.9-b130926.1035 svn-revision#5f6196f2b90e9460065a4c2f4e30e065b245e51e
<?xml version='1.0' encoding='UTF-8'?><S:Envelope ... </S:Envelope>[HTTP response - https://10.10.101.213:8001/HypService - 200]---
null: HTTP/1.1 200 OK
Content-Length: 2614
Content-Type: application/soap+xml; charset=utf-8
Date: Mon, 27 Apr 2015 13:20:30 GMT
Server: Microsoft-HTTPAPI/2.0
<s:Envelope xmlns:s="https://www.w3.org/2003/05/soap-envelope" xmlns:a="https://www.w3.org/2005/08/addressing"><s:Header><a:Action s:mustUnderstand="1">HypWcfApi.HypService/IHypService/MDocGetInfoResponse</a:Action><a:RelatesTo>uuid:65af1684-0548-47d2-8346-fff60f4c85f1</a:RelatesTo></s:Header><s:Body><MDocGetInfoResponse ><MDocGetInfoResult…></s:Envelope>
SSL connections
For SSL connections between the Intrexx Portal Server and a dg archive web service, the certificate from the certificate authority that issued the service certificate must have been added to the Intrexx Portal Server's certificate store. Self-signed certificates—those not issued by a known certificate authority—are an exception. To enable SSL connections to services using self-signed certificates, you must disable certificate chain validation in the Intrexx Portal Server in this case. This can be done at the service level using a system property. To do this, open the "portal.cfg" file in the portal directory internal/cfg using a text editor, and add a new "<systemProperty>" entry to the "<environment>" section:
<systemProperty name="de.uplanet.lucy.server.dghyparchive.connector.sslTrustEveryone" value="true"/>
After saving the "portal.cfg" file, the portal service must be restarted for the changes to take effect.
More Information
Create and Edit Connections in the "Integration" Module