[Version 5.0.2 and later]Cloudscape Version 5.1 post installation instructions

Why and when to perform this task

After installing Cloudscape Version 5.1, 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 cview, 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 classpath 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 ${CLOUDSCAPE51_JDBC_DRIVER_PATH}\db2j.jar to point to the new version of Cloudscape.

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

  3. If the application server is running Cloudscape as a persistent store for UDDI in previous versions, additional steps are necessary.

    The server 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.1.

    To correct this situation, do the following:

    1. Upgrade the database to Cloudscape 5.1.
    2. Rerun the install script, or edit the classpath field in the datasource.


Related concepts
JDBC providers
Data sources
Connection pooling
Related reference
Vendor-specific data sources minimum required settings



Searchable topic ID:   cloudscape_post_install
Last updated: Jun 21, 2007 9:56:50 PM CDT    WebSphere Application Server for z/OS, Version 5.0.2
http://publib.boulder.ibm.com/infocenter/wasinfo/index.jsp?topic=/com.ibm.websphere.zseries.doc/info/zseries/ae/tdat_cloudscape_post_install.html

Library | Support | Terms of Use | Feedback