CrossWorlds Software  

Patch Notes for
Version 1.0.1 of the Resource Adapter for CrossWorlds

The patch notes contain the following sections:

NEW AND REVISED IN THIS PATCH

COMPLETED CHANGE REQUESTS

DOWNLOADING THE PATCH

UPGRADE INSTRUCTIONS

 

NEW AND REVISED IN THIS PATCH

Following are new and revised features of the 1.0.1 version of the Resource Adapter for CrossWorlds

Available as of Connector Version

 Feature Description
1.0.1 The ORB classes used by the Resource Adapter for CrossWorlds to establish a connection with CrossWorlds can now be configured through its deployment descriptor. If you are currently using the Resource Adapter for CrossWorlds and can connect to the InterChange Server, you do not need to install this patch.  

For those users who have installed more recent versions of the Visibroker client libraries that are not supported by the existing Resource Adapter for CrossWorlds, this patch will allow you to explicitly specify the classname of the ORB implementation to use when establishing a connection to CrossWorlds.  

 

COMPLETED CHANGE REQUESTS

This patch contains fixes for the following CRs based on customer-reported cases.

CR Number As of Version Problem
12844 1.0.0 The CORBA ORB libraries used to connect to the InterChange Server are hard-coded within the adapter and cannot be configured.  More recent version of the Visibroker client libraries use ORB implementation "com.inprise.vbroker.orb.ORB" rather than  "com.visigenic.vbroker.orb.ORB"; use of such libraries is incompatible with the existing version of the Resource Adapter for CrossWorlds (1.0.0).

 

DOWNLOADING THE PATCH

This section describes how to download the connector patch from the CrossWorlds Exchange website.

Note: Downloading software from the website requires a user name and password. Contact your CrossWorlds system administrator or a technical support contact for your site. To extract and install the connector files, you must have already installed CrossWorlds InterChange Server or Serverless Trading Agent.

To download the connector software from the Web:

  1. Back up any files that contain customized settings, for example, customized startup settings.
  2. Log in to CrossWorlds Exchange. Navigate to the Connectivity page (Products > Information Management > Connectivity), then expand the appropriate item by clicking the plus sign (+) next to it. Click your connector item in the list.
  3. In the Download(s) table, find the zip file for your application version and platform, and download it.

Note: The documentation home page on your system does not contain a link to the manual for this product. You can access the manual from the CrossWorlds Exchange. When you are at the Exchange site, log in as a subscriber (with your user name and password), then click Product Documentation and choose the appropriate link for your operating system. The home page that appears contains a link to the online manual for this product. If you wish, you can also download the home page to %CROSSWORLDS%\documentation\welcome.pdf (Windows) or $CROSSWORLDS/documentation/welcome.pdf (UNIX) on your system.

UPGRADE INSTRUCTIONS

To perform an upgrade to this version of the resource adapter:

  1. Undeploy/remove the most recent (1.0.0) release from your application server if you have not already done so.
  2. Redeploy the patched "CwResourceAdapter.rar" package to your application server.  Different application servers require your to follow different steps; refer to the documentation of your specific application server for instructions on how to deploy a resource adapter.

  3. Determine the appropriate classname for your ORB implementation.  To do this, open file "\crossworlds\lib\vbjorb.jar" using WinZip or a similar product and scroll to file "ORB".  Examine the path of that file as it exists in the JAR archive.  If it is "com\inprise\vbroker\orb", use classname "com.inprise.vbroker.orb.ORB" in the next step.  If it is "com\visigenic\vbroker\orb", use classname "com.visigenic.vbroker.orb.ORB" in the next step.

  4. Specify the classname determined in the previous step for adapter properties "ORBClassName" and "ORBSingletonClassName".  You can specify these values in either file "ra.xml" including the RAR package itself or modify the adapter properties in your application server once you've deployed the adapter.

For Connector Version Platform Property (Case-Sensitive) Value
1.0.1 WIN;UNIX ORBClassName One of the following depending on your version of the Visibroker client libraries:

com.visigenic.vbroker.orb.ORB

com.inprise.vbroker.orb.ORB
1.0.1 WIN;UNIX ORBSingletonClassName One of the following depending on your version of the Visibroker client libraries:

com.visigenic.vbroker.orb.ORB

com.inprise.vbroker.orb.ORB

 

January 23, 2002 11:58 AM

© 2001 CrossWorlds Software, Inc. Proprietary and Confidential. All Rights Reserved.