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:
- 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® |
- Version 9.0: /opt/IBM/odwek/V9.0/api/ODApi.jar
- Version 9.5: /opt/IBM/ondemand/V9.5/www/api/ODApi.jar
|
| Linux |
- Version 9.0: /opt/ibm/odwek/V9.0/api/ODApi.jar
- Version 9.5: /opt/ibm/ondemand/V9.5/www/api/ODApi.jar
|
| Linux for System z® |
- Version 9.0: /opt/ibm/odwek/V9.0/api/ODApi.jar
- Version 9.5: /opt/ibm/ondemand/V9.5/www/api/ODApi.jar
|
| Microsoft Windows |
- Version 9.0: C:\Program Files\IBM\OnDemand Web Enablement Kit\V9.0\api\ODApi.jar
- Version 9.5: C:\Program Files\IBM\OnDemand\V9.5\www\api\ODApi.jar
|
- 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:
- 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 |
- Version 9.0: LIBPATH=/opt/IBM/odwek/V9.0
- Version 9.5: LIBPATH=/opt/IBM/ondemand/V9.5/www
|
| Linux |
- Version 9.0: LD_LIBRARY_PATH=/opt/ibm/odwek/V9.0
- Version 9.5: LD_LIBRARY_PATH=/opt/ibm/ondemand/V9.5/www
|
| Linux for System z |
- Version 9.0: LD_LIBRARY_PATH=/opt/ibm/odwek/V9.0
- Version 9.5: LD_LIBRARY_PATH=/opt/ibm/ondemand/V9.5/www
|
| Microsoft Windows |
- Version 9.0: PATH=C:\Program Files\IBM\OnDemand Web Enablement
Kit\V9.0
- Version 9.5: PATH=C:\Program Files\IBM\OnDemand\V9.5\www
|
- 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:
- Add the ODWEK
lib64 or bin directory to your Windows PATH environment variable:
- For ODWEK Version 9.0, add the lib64
directory. The default location for the lib64 directory isC:\Program
Files\IBM\OnDemand Web Enablement Kit\V9.0\lib64.
- For ODWEK Version 9.5, add the bin
directory. The default location for the bin directory is C:\Program
Files\IBM\OnDemand\V9.5\bin
- 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:
- Find your ODWEK installation
files and review the section in the ODWEK readme file that is labeled: "1.2) IBM Global Security Kit Installation."
- Install GSKit.
- Restart your application server.