
	Corporate Info \| News \| Solutions \| Products \| Partners \| Services \| Events \| Download \| How To Buy
	e-docs \| Site Map \| Search \| Contact \| Glossary \| WebLogic Server Documentation

Using the Cloudscape Database with WebLogic Server

Introduction

Setting Up Cloudscape for Use with WebLogic Server

Creating the Example "demo" Database

Starting Cloudview

Other Resources

Introduction

Cloudscape is a pure-Java relational database management system (RDBMS) that BEA ships with the WebLogic distribution to allow you to run code examples with a functional RDBMS. The WebLogic Pet Store application and several of the WebLogic Server examples use Cloudscape as the default DBMS. The Cloudscape full-featured evaluation copy is located in the samples/eval/cloudscape directory of the WebLogic Server distribution.

Setting Up Cloudscape for Use with WebLogic Server

In order to use Cloudscape with WebLogic Server, you must:

Add the Cloudscape library, located at samples/eval/cloudscape/lib/cloudscape.jar, to the WebLogic Server CLASSPATH when booting the server.
Set the cloudscape.system.home Java system property on the command line when booting the server. This property must point to the directory that contains the Cloudscape databases.
The shell scripts used to start WebLogic Server with the examples configuration will perform the two steps listed above automatically. See the startExamplesServer start scripts located in the config/examples directory of the WebLogic Server distribution for more details.
Some examples require a WebLogic JDBC connection pool that uses the Cloudscape JDBC driver. The configuration file used for the examples includes a WebLogic JDBC connection pool configured to use the Cloudscape JDBC driver. To verify the settings of this connection pool:
1. Bring up the Administration Console in a browser.
2. Click to expand the Services node in the left-hand pane.
3. Click to expand the JDBC node in the left-hand pane.
4. Click to expand the Connection Pools node.
5. Select the demoPool node to display the configuration properties of the demoPool.

NOTE: The evaluation version of Cloudscape that ships with WebLogic Server is limited to one process accessing the database at a time.

Creating the Example "demo" Database

Many of the examples use the "demo" database that comes pre-built in the cloudscape.system.home directory (the samples/eval/cloudscape/data directory in your WebLogic Server distribution). The DDL used to create this database is located at samples/examples/utils/ddl/demo.ddl. You can use the Schema utility to recreate the database as shown in the command below:

 $ java utils.Schema jdbc:cloudscape:demo;create=true
      COM.cloudscape.core.JDBCDriver
      -verbose demo.ddl

For more information on using the Schema utility, see Using the WebLogic Utilities.

Starting Cloudview

Cloudview is Cloudscape's graphical user interface that you use to create, view, and manage Cloudscape databases.

To start Cloudview from a command shell:

Set your classpath to include:

  /weblogic/samples/eval/cloudscape/lib/tools.jar

  /weblogic/samples/eval/cloudscape/lib/cloudscape.jar

where weblogic is the directory where WebLogic is installed. For example (on one command line):

$ set CLASSPATH=/weblogic/samples/eval/cloudscape/lib/tools.jar;\
  /weblogic/samples/eval/cloudscape/lib/cloudscape.jar

To start Cloudview, enter the following command on one line:
```
 $ java COM.cloudscape.tools.cview 
```
The Cloudview GUI should start. Use the File menu to open an existing database, or create a new one. For more details on using Cloudview, refer to their website http://www.cloudscape.com.

Other Resources

The following links provide more information about Cloudscape:

Cloudscape Website

Online Cloudscape documentation

Cloudscape JBMS whitepaper

Product information

Online support