IBM Support

IBM Content Navigator documentation - Troubleshooting: Cannot connect to a Box repository on a WebLogic Server

Product Documentation


Abstract

You might see errors when you try to connect to a Box repository from the administration tool and desktop. These errors can occur if the WebLogic Server with SSL is not configured correctly.

Content

Symptoms
After you successfully log in to Box, when you try to connect to the Box repository, the connection fails and you see the following error message:

The repository is not available.

Also, the WebLogic Server WLout.log file contains errors such as the following example:



<Warning> <Security> <BEA-090504> <Certificate chain received from www.box.com-
… failed hostname verification check. Certificate contained *.box.com but check expected www.box.com>

com.ibm.ecm.mediators.box.BoxLogonMediator.toJSONObject() Returning JSON:{"messages":[{"number":"0","adminResponse":null, "moreInformation":null,"text":" logged in.","explanation":null,"userResponse":null}],"linkedBoxRepositories":[],"errors":
[{"number":"1008","adminResponse":"Additional information about the error is in the web application server log files.
For more information about the log files, see \"IBM Content Navigator log files\" in IBM Knowledge Center. <p>
If you determine that the problem is related to the repository server, use the repository errors to resolve the problem. <p>
If you
determine that the problem is related to the repository configuration, use the administration tool to update the
repository configuration. ","moreInformation":null,"text":"The repository is not available.  ","explanation":
"The repository server might not be running, or the repository might not be configured correctly in the administration tool.
","userResponse":"Ask your system administrator to check the web application server log files for problems with the repository."}]}


Causes
On your WebLogic Server, in the startup configuration, the Java system property –DUseSunHttpHandler is not set to true. The WebLogic Server is making outbound SSL requests by using the default http handler, weblogic.net.http.HttpsURLConnection. However, because the Box repository is running remotely, the WebLogic Server needs to make outbound SSL requests by using the http handler that is pre-configured by IBM Content Navigator.

Resolving the problem

To resolve the problem, add the following JVM parameter to the WebLogic Server startup configuration settings:

–DUseSunHttpHandler=true

You can set the Java system property –DUseSunHttpHandler=true by editing the startup script.

Procedure

To add the http handler setting to the Oracle WebLogic Server startup script:

  1. Open the Oracle WebLogic Server startup script, startWebLogic.cmd or startWebLogic.sh. By default, the startup script is in the following directory:
  2. Operating systemDefault location
    AIX®/opt/Oracle/Middlware/user_projects/domains/domain_name/bin/startWebLogic.sh
    Linux/opt/Oracle/Middlware/user_projects/domains/domain_name/bin/startWebLogic.sh
    Linux for System z®/opt/Oracle/Middlware/user_projects/domains/domain_name/bin/startWebLogic.sh
    WindowsC:\Oracle\Middleware\user_projects\domains\domain_name\bin\startWebLogic.cmd

2. Add the http handler parameter to the startup script.

Operating systemAdd the following lines to the startup script:
AIX®
The default IBM Content Navigator installation directory on AIX is /opt/IBM/ECMClient.
echo "${JAVA_HOME}/bin/java ${JAVA_VM} ${MEM_ARGS}
–DUseSunHttpHandler=true
${JAVA_OPTIONS}
${PROXY_SETTINGS} ${SERVER_CLASS}"


${JAVA_HOME}/bin/java ${JAVA_VM} ${MEM_ARGS}
–DUseSunHttpHandler=true
${JAVA_OPTIONS}
${PROXY_SETTINGS} ${SERVER_CLASS}
Linux
The default IBM Content Navigator installation directory on Linux is /opt/IBM/ECMClient.
echo "${JAVA_HOME}/bin/java ${JAVA_VM} ${MEM_ARGS}
–DUseSunHttpHandler=true ${JAVA_OPTIONS}
${PROXY_SETTINGS} ${SERVER_CLASS}"


${JAVA_HOME}/bin/java ${JAVA_VM} ${MEM_ARGS}
–DUseSunHttpHandler=true ${JAVA_OPTIONS}
${PROXY_SETTINGS} ${SERVER_CLASS}
Linux for System z®
The default IBM Content Navigator installation directory on Linux for System z is /opt/IBM/ECMClient.
echo "${JAVA_HOME}/bin/java ${JAVA_VM} ${MEM_ARGS}
–DUseSunHttpHandler=true ${JAVA_OPTIONS}
${PROXY_SETTINGS} ${SERVER_CLASS}"


${JAVA_HOME}/bin/java ${JAVA_VM} ${MEM_ARGS}
–DUseSunHttpHandler=true ${JAVA_OPTIONS}
${PROXY_SETTINGS} ${SERVER_CLASS}
Windows
The default IBM Content Navigator installation directory on Windows is C:\Program Files (x86)\IBM\ECMClient.
echo Starting WLS with line:
echo %JAVA_HOME%\bin\java %JAVA_VM% %MEM_ARGS%
–DUseSunHttpHandler=true
%JAVA_OPTIONS% %PROXY_SETTINGS% %SERVER_CLASS%
%JAVA_HOME%\bin\java %JAVA_VM% %MEM_ARGS%
–DUseSunHttpHandler=true %JAVA_OPTIONS%
%PROXY_SETTINGS% %SERVER_CLASS%

echo Redirecting output from WLS window to %WLS_REDIRECT_LOG%
%JAVA_HOME%\bin\java %JAVA_VM% %MEM_ARGS%
–DUseSunHttpHandler=true %JAVA_OPTIONS%
%PROXY_SETTINGS% %SERVER_CLASS% >"%WLS_REDIRECT_LOG%" 2>&1
)
Ensure that you specify the correct location of the IBM Content Navigator installation directory for your environment.

3. Save your changes to the startup script.

4. Restart the application server and verify that the application server starts without errors.

Minimum required version: IBM Content Navigator, Version 2.0.3 Fix Pack 5.

[{"Product":{"code":"SSEUEX","label":"IBM Content Navigator"},"Business Unit":{"code":"BU053","label":"Cloud & Data Platform"},"Component":"--","Platform":[{"code":"PF002","label":"AIX"},{"code":"PF016","label":"Linux"},{"code":"PF033","label":"Windows"}],"Version":"2.0.3;3.0.0;3.0.1","Edition":"","Line of Business":{"code":"LOB18","label":"Miscellaneous LOB"}}]

Document Information

Modified date:
17 June 2018

UID

swg27046674