Wednesday Feb 19, 2014

Oracle CM SDK 9.0.4.6.8 now available for download

I would like to inform you that we have now released Oracle CM SDK Patch 9.0.4.6.8 to My Oracle Support (Patch 17086605). This CM SDK 9.0.4.6.8 Patch includes a number of bug fixes that have been found by customers and partners during their testing of CM SDK versions 9.0.4.6.3 to 9.0.4.6.7. CM SDK 9.0.4.6.8 is code equal to the published open source code and will be the last official patch from Oracle on CM SDK 9.0.4.6. The Patch Readme that is bundled with the patch contains the list of bugs fixed in this patch as well as the installation and upgrade instructions.

We strongly recommend that you use this new CM SDK 9.0.4.6.8 Patch if you are interested in using CM SDK with the latest Java 6 compliant Middleware such as Oracle WebLogic Server or Oracle GlassFish Server. It will also ensure that you can benefit from fixes and enhancements provided by the community

Click here to download Oracle CM SDK 9.0.4.6.8 now.

Thursday Jan 23, 2014

Oracle released CMSDK as open source

As of January 16th, 2014, Oracle released the source code of CMSDK version 9.0.4.6 to the public as open source under the BSD license agreement.

By making CMSDK available as open source code, Oracle gives its loyal partners the opportunity to offer a continuous support model to their customers. In addition, customers and partners can leverage their existing product knowledge and benefit from community fixes and other group’s enhancements to this product.

The official Statement of Direction for CMSDK has been published here:

http://www.oracle.com/technetwork/middleware/cmsdk/documentation/index.html

Details of the BSD license agreement can be found here:

http://www.oracle.com/technetwork/licenses/bsd-license-1835287.html

Please let me know your thoughts and comments.

Wednesday Dec 11, 2013

Disable JDBC object wrapping in GlassFish

As outlined in my previous blog entry, if you run CMSDK 9.0.4.6 on middleware such as Oracle WebLogic Sever or Oracle GlassFish, you need to disable the JDBC object wrapping first. Otherwise you might be seeing this exception during the startup of a CMSDK Node in GlassFish:

...
oracle.ifs.core.agents.InboundQueueListenerAgent [39] WARNING: Error while processing incoming message.
oracle.ifs.common.IfsException: IFS-13001: Unable to dequeue message
java.lang.ClassCastException: com.sun.gjc.spi.jdbc40.ConnectionWrapper40 cannot be cast to oracle.jdbc.OracleConnection
    at
oracle.ifs.server.S_Queue.dequeue(S_Queue.java:342)
...

How to Disable JDBC Object Wrapping in GlassFish

It is required to disable JDBC object wrapping when using a data source for CMSDK 9.0.4.6. These instructions are for GlassFish 3.1.1 or above, as we don’t support earlier versions of GlassFish with CMSDK.

To disable wrapping of JDBC objects using the Administration Console:

  1. In the Domain Structure tree, expand Resources, then expand JDBC.
  2. Select JDBC Connection Pool in the tree structure.
  3. On the Summary of JDBC Connection Pool page, click the connection pool name that your data source is based on.
  4. Select the Advanced: Edit JDBC Connection Pool Advanced Attributes tab.
  5. In Wrap JDBC Objects, deselect the checkbox to disable wrapping.
  6. Click Save.

    This change does not take effect immediately—it requires that the data source be redeployed or the server be restarted.

In Oracle GlassFish Server this property can also be modified in the domain.xml file or via asadmin command.

Friday Dec 06, 2013

Disable JDBC data type wrapping in WLS

I've now seen this problem several times in customer environments. During startup of a CMSDK Node you see a ClassCastExceptions related to weblogic.jdbc.wrapper.

If something like this shows up in your log file:

...
oracle.ifs.common.IfsException: IFS-45206: Unable to get credential
oracle.ifs.common.IfsException: IFS-10184: Unable to get token
oracle.ifs.common.IfsException: IFS-10191: Unable to make token credential persistent
java.lang.ClassCastException: weblogic.jdbc.wrapper.Blob_oracle_sql_BLOB
    at oracle.ifs.server.S_LibrarySession.getTokenCredentialBlob(S_LibrarySession.java:23888)
...

you have probably not disabled the JDBC data type object wrapping that is enabled by default in WebLogic Server (WLS).

Background

Some JDBC objects from a driver that are returned from WLS are wrapped by default. Wrapping data source objects provides WLS the ability to:

  • Generate debugging output from all method calls.
  • Track connection utilization so that connections can be timed out appropriately.
  • Provide transparent automatic transaction enlistment and security authorization.

WLS provides the ability to disable wrapping which provides the following benefits:

  • Although WLS generates a dynamic proxy for vendor methods that implement an interface to show through the wrapper, some data types do not implement an interface. For example, Oracle data types Array, Blob, Clob, NClob, Ref, SQLXML, and Struct are classes that do not implement interfaces. Disabling wrapping allows applications to use native driver objects directly.
  • Eliminating wrapping overhead can provide a significant performance improvement.

When wrapping is disabled (the wrap-types element is false), the following data types are not wrapped:

  • Array
  • Blob
  • Clob
  • NClob
  • Ref
  • SQLXML
  • Struct
  • ParameterMetaData
    • No connection testing performed.
  • ResultSetMetaData
    • No connection testing performed.
    • No result set testing performed.
    • No JDBC MT profiling performed.

How to Disable Wrapping

It is required to disable JDBC data type wrapping when using a data source with CMSDK 9.0.4.6. This only works in WLS 10.3.4 or above. Since there is no way to change it for WLS versions earlier than 10.3.4, we don’t support those WLS versions with CMSDK.

To disable wrapping of JDBC data type objects using the Administration Console:

  1. If you have not already done so, in the Change Center of the Administration Console, click Lock & Edit.
  2. In the Domain Structure tree, expand Services, then select Data Sources.
  3. On the Summary of Data Sources page, click the data source name.
  4. Select the Configuration: Connection Pool tab.
  5. Scroll down and click Advanced to show the advanced connection pool options.
  6. In Wrap Data Types, deselect the checkbox to disable wrapping.
  7. Click Save.
  8. To activate these changes, in the Change Center of the Administration Console, click Activate Changes.

    This change does not take effect immediately—it requires that the data source be redeployed or the server be restarted.

After that you should not see the ClassCastException anymore and your CMSDK Node should start without errors.

Wednesday Nov 20, 2013

How-To: Deploy CMSDK on Tomcat

Although there are ways to run CMSDK 9.0.4.6 in a standalone JVM, when you need to use the WebDAV protocol to access documents in the CMSDK repository you can’t avoid deploying it into at least a web container.

WebLogic Server or GlassFish Server are one choice, but even Tomcat can be used to host the CMSDK Node that provides the CMSDK protocol servers along with other processes.

When you need to set up a data source on Tomcat the official documentation gives an example like this:


<Resource name="jdbc/OracleDS" auth="Container"
  type="javax.sql.DataSource"  
  driverClassName="oracle.jdbc.OracleDriver"
  url="jdbc:oracle:thin:@myhost.oracle.com:1521:orcl"
  username="cmsdk" password="****" maxActive="20" maxIdle="10"
  maxWait="-1"/>

Unfortunately, when using this data source definition you will see the following exception and the Node won’t come up.

java.lang.ClassCastException: org.apache.tomcat.dbcp.dbcp.DelegatingCallableStatement cannot be cast to oracle.jdbc.OracleCallableStatement

Whereas in other container configurations (such as in WLS and GlassFish) we can specifically disable the JDBC data type wrapping, this isn’t the case in Tomcat. In Tomcat we need to change the definition of the data source to this, to get the Node started and the defaults overwritten:

<Resource name="jdbc/OracleDS" auth="Container"
  type="oracle.jdbc.pool.OracleDataSource"
  factory="oracle.jdbc.pool.OracleDataSourceFactory"
  connectionCachingEnabled="true"
  user="cmsdk" password="****"
  driverClassName="oracle.jdbc.OracleDriver"
  url="jdbc:oracle:thin:@myhost.oracle.com:1521:orcl"
  removeAbandoned="true"
  removeAbandonedTimeout="30"
  maxActive="20"
  maxIdle="10" maxwait="-1"/>


In addition to the above, you need to change the data source name attribute in the web.xml of the cmsdk.ear file, as Tomcat places all configured entries and resources in the java:comp/env portion of the JNDI namespace which is different from what most other containers are doing.
The modified data source name in the CMSDK web.xml for Tomcat should look like this:


<context-param>
  <description>The name of the DataSource for the CMSDK repository</description>
  <param-name>IFS.NODE.DataSourceName</param-name>
  <param-value>java:/comp/env/jdbc/OracleDS</param-value>
</context-param>


About

Latest news, best practices, examples and product updates for CMSDK.

Search

Archives
« July 2014
SunMonTueWedThuFriSat
  
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
  
       
Today