Cannot connect to a Content Manager OnDemand server

You might see errors when you try to connect or log in to a Content Manager OnDemand server in the IBM Content Navigator administration tool and desktop. These errors can occur if ODWEK is not configured correctly.

Symptoms

The connection fails and you see the java.lang.NoClassDefFoundError error, the java.lang.UnsatisfiedLinkError error, or IBM Global Security Kit (GSKit) errors in the web application server SystemOut.log file or SystemErr.log file.

Causes

IBM Content Manager OnDemand Web Enablement Kit (ODWEK) is not configured correctly on your IBM Content Navigator server environment.

Resolving the problem

Identify the error and follow the steps for the corresponding error message.
A java.lang.NoClassDefFoundError error
Error message examples:
[5/24/12 8:57:38:038 PDT] 00000023 servlet
E com.ibm.ws.webcontainer.servlet.ServletWrapper service 
Uncaught service() exception thrown by servlet action: 
java.lang.NoClassDefFoundError: com.ibm.edms.od.ODException
[5/24/12 9:10:37:077 PDT] 0000001c servlet   
E com.ibm.ws.webcontainer.servlet.ServletWrapper service 
SRVE0068E: Uncaught exception created in one of the service methods 
of the servlet action in application navigator. 
Exception created : java.lang.NoClassDefFoundError: com.ibm.edms.od.ODException
To resolve the java.lang.NoClassDefFoundError error, follow these steps:
  1. Add the ODWEK ODApi.jar file to your application server CLASSPATH environment variable.
    By default, the ODApi.jar file is installed in the following directories:
    Table 1. Directories where the ODApi.jar file is installed by default
    Operating system Directory
    AIX® /usr/lpp/ars/www/api/ODApi.jar
    Linux® /opt/ondemand/www/api/ODApi.jar
    Linux for System z® /opt/ondemand/www/api/ODApi.jar
    Microsoft Windows C:\Program Files\ibm\OnDemand Web Enablement Kit\api\ODApi.jar
  2. Restart your application server.
A java.lang.UnsatisfiedLinkError error: Not found in java.library.path
Error message example: 
[5/24/12 8:40:39:663 PDT] 00000025 SystemOut     
O CIWEB Error: [...] com.ibm.ecm.struts.actions.od.ODLogonAction.executeAction()
java.lang.UnsatisfiedLinkError: ars3wapi32 (Not found in java.library.path)
To resolve the java.lang.UnsatisfiedLinkError error, follow these steps:
  1. Add the ODWEK directory to the library path for your operating system.
    By default, ODWEK is installed in the following directories:
    Table 2. Default ODWEK installation directories
    Operating system Directory
    AIX LIBPATH=/usr/lpp/ars/www
    Linux LD_LIBRARY_PATH=/opt/ondemand/www
    Linux for System z LD_LIBRARY_PATH=/opt/ondemand/www
    Microsoft Windows PATH=C:\Program Files\ibm\OnDemand Web Enablement Kit
  2. Restart your application server.
A java.lang.UnsatisfiedLinkError error: ars3wapi32.dll is not a valid Win32 application (Microsoft Windows)
Error message example: 
[5/24/12 8:45:37:959 PDT] 00000023 SystemOut
O CIWEB Error: [...] com.ibm.ecm.struts.actions.od.ODLogonAction.executeAction()
java.lang.UnsatisfiedLinkError: ars3wapi32 
(c:\Program Files\ibm\OnDemand Web Enablement Kit\ars3wapi32.dll is not a valid 
Win32 application.)
This error occurs on Microsoft Windows only. To resolve this error, follow these steps:
  1. Add the ODWEK lib64 directory to your Windows PATH environment variable. The default installation location for the ODWEK lib64 directory is C:\Program Files\ibm\OnDemand Web Enablement Kit\lib64.
  2. Restart your application server.
An IBM Global Security Kit (GSKit) Error
Error message examples: 
[5/24/12 9:03:41:084 PDT] 00000021 SystemErr
R CIWEB Error: [...] com.ibm.ecm.struts.actions.od.ODLogonAction.executeAction()
com.ibm.edms.od.ODException: Dynamic Load Library 'IBM GSKit Not Installed' 
could not be found
[5/24/12 9:16:38:844 PDT] 0000001c SystemOut
O CIWEB Error: [...] com.ibm.ecm.struts.actions.od.ODLogonAction.executeAction()
java.lang.UnsatisfiedLinkError: /usr/lpp/ars/www/libars3wapi32.a (A file or 
directory in the path name does not exist.)
This error indicates that GSKit cannot be found by ODWEK. Starting in ODWEK, Version 8.5, the GSKit installation files are included with and required by ODWEK.
To resolve this error, follow these steps:
  1. Find your ODWEK installation files and review the section in the ODWEK readme file that is labeled: 1.2) IBM Global Security Kit Installation.
  2. Install GSKit.
  3. Restart your application server.