WebSphere Application Server - Express, Version 6.0.x     Operating Systems: AIX, HP-UX, Linux, Solaris, Windows

Cloudscape Version 5.1.60x post installation instructions

Version 5.1.6 (plus any subsequent fix packs for this version) is the minimum level of Cloudscape that is required for WebSphere Application Server V6.0 - V6.0.2.

Why and when to perform this task

After installing Cloudscape Version 5.1.60x, you must complete the following steps before you can access the database.

Steps for this task

  1. Upgrade or migrate any existing database instances.
    1. Backup an existing database.

      You must complete a backup in case you have to access the previous version of Cloudscape. After you migrate a database, you cannot access your old database unless you perform a backup.

    2. Migrate an existing database by doing the following:
      • Set the connectionAttributes custom property to upgrade=true.

        The data source is located in the WebSphere Application Server administrative console under the JDBC providers.

      • If you are using the cview interface, located in the WAS_HOME/cloudscape51/bin/embedded directory, click yes when you see the upgrade database prompt.

        Note: Ensure you migrate defaultDB, which is located in the WAS_HOME/bin/DefaultDB directory.

  2. Set or change the class path definitions in any existing JDBC providers, which are defined to use Cloudscape. Cloudscape JAR files will not load when WebSphere Application Server is active.

    Use the WebSphere Application Server environment variable ${CLOUDSCAPE_JDBC_DRIVER_PATH}\db2j.jar to point to the new version of Cloudscape.

    The CLOUDSCAPE_JDBC_DRIVER_PATH environment variable is defined in WebSphere Application Server with a value of WAS_HOME/cloudscape/lib.

  3. If the application server is running Cloudscape as a persistent store for UDDI in previous versions, additional steps are necessary.
    The server SystemOut log might issue this message:
    The data source class name com.ibm.db2j.jdbc.db2jConnectionPoolDataSource could not be found.

    This is because the Cloudscape JAR file has moved to from its location in version 5.x to a new location in version 5.1x.

    To correct this situation, do the following:
    1. Upgrade the database to Cloudscape 5.1.60x.
    2. Rerun the install script, or edit the class path field in the data source.



Related concepts
JDBC providers
Data sources
Connection pooling

Related reference
Vendor-specific data sources minimum required settings

Task topic    

Terms of Use | Feedback

Last updated: Jun 8, 2005 12:45:23 PM EDT
http://publib.boulder.ibm.com/infocenter/wasinfo/v6r0/index.jsp?topic=/com.ibm.websphere.express.doc/info/exp/ae/tdat_cloudscape_post_install.html

© Copyright IBM Corporation 2003, 2005. All Rights Reserved.
This information center is powered by Eclipse technology. (http://www.eclipse.org)