Connector for dg archive - Troubleshooting

Request tracing

For the purpose of error analysis, the dg archive queries and responses can be logged in the "Portal log file". Tracing is activated as follows:

  1. Open the "portal.cfg" file from the portal directory \internal\cfg\ in a text editor.

  2. Navigate to the section "environment" and insert the following lines there:

    <systemProperty name="com.sun.xml.internal.ws.transport.http.client.HttpTransportPipe.dump" value="true"/>
    
  3. Restart the portal service. The web service request/response details will then be logged in the "Portal_startup.log" file every time a dg archive action is carried out.

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 xmlns="HypWcfApi.HypService"><MDocGetInfoResult…></s:Envelope>

SSL connections

For SSL connections between the Intrexx Portal Server and a dg archive web service, the certificate of the Certificate Authority that issued the service certificate must have been added to the certificate store of the Intrexx Portal Server. Self-signed certificates are an exception to this, which are not provided by a recognized Certificate Authority. In order to enable SSL connections to services with self-signed certificates, the check on the certificate chain must be deactivated. This is possible at the service level via a system property. To do so, open the "portal.cfg" file in the portal directory /internal/cfg/ with 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 Intrexx portal service must be restarted so that the changes take effect.

More information

General

Create and edit connection in the "Integration" module

Connector for dg archive in applications

Connector for dg archive in processes