Use this task to create an Oracle database for Business Process
Choreographer.
Steps for this task
- Install the Oracle server on the computer that hosts the database.
Be sure that you are using the 32-bit Oracle libraries that are located in
the lib32 subdirectory.
- On Linux® and UNIX® systems, make sure that the environment
variables ORACLE_BASE and ORACLE_HOME are set for the root
user.
- Check the class path to be sure that your JDBC driver is using
the ojdbc14.jar file.
- On Linux and UNIX systems, create soft links to the
following Oracle libraries in the /usr/lib directory:
- For Oracle 10g: Link to: libclnt.so.10.1.
- For Oracle 9i: Link to: libwtc9.so, libclntsh.so.9.0,
and libocijdbc9.so.
- Create an Oracle database using the Database Configuration Assistant,
for example, with the name BPEDB. There is no
script to quickly create a default Oracle database for Business Process Choreographer.
Make sure that you select the JServer option for the database. The database
must be created to have a Unicode code page.
- Start the Oracle listener by entering the command:
lsnrctl start
- On the server that hosts your application server,
change to the directory where the Business Process Choreographer configuration
scripts for your database system are located:
- If your database is on a different server from your application
server:
- Copy the following Oracle configuration SQL scripts from the
Business Process Choreographer subdirectory on the server that is hosting
the application server to an appropriate directory on the server that is
hosting your database:
clearSchema.sql
createSchema.sql
createTablespace.sql
dropSchema.sql
dropTablespace.sql
- Optional: If you want Business Process Choreographer
Observer to use the same database as the business process container:
- Also copy the following SQL scripts to the same directory on your database
server:
clearSchema_Observer.sql
createSchema_Observer.sql
createTablespace_Observer.sql
dropSchema_Observer.sql
dropTablespace_Observer.sql
- Copy the jar file bpcodbutil.jar, from the lib subdirectory of the install_root directory
to the same directory on your database server.
- On your database server, change to the directory where you copied
the SQL scripts.
- Edit the table space creation script according to the instructions
at the top of the file createTablespace.sql.
- Make sure that you are using a user ID that has at least the following
rights for the database: CONNECT, RESOURCE, CREATE TABLESPACE, DROP TABLESPACE
and CREATE TABLE.
- If you do not want to create the schema in the default instance,
set the ORACLE_SID environment variable.
- To create the table spaces, run the createTablespace.sql script,
as described in the script header. For test purposes, you can use
the same location for all table spaces and pass the path as a command-line
argument to the script, for example, on a Windows system, using user ID bpeuser,
password bpepwd, database name BPEDB, and table space path d:\mydb\ts,
enter:
sqlplus bpeuser/bpepwd@BPEDB @createTablespace.sql d:\mydb\ts
If
you want to drop the table spaces, you can use the dropTablespace.sql script.
- To create the schema, run the createSchema.sql script. For example, on Windows systems, enter:
sqlplus bpeuser/bpepwd@BPEDB @createSchema.sql
- Optional: If you want Business Process Choreographer
Observer to use the same database as the business process container, perform
the following actions:
- Install the jar file that contains UDFs for Business
Process Choreographer Observer.
- On your database server, change to the directory where the jar file bpcodbutil.jar is
located:
- If your database is on the same server as the application server, change
to the lib subdirectory of the install_root directory.
- If your database is not on the same machine as your application server,
change to the directory where you copied the jar file bpcodbutil.jar in
step 8.b.ii.
- Run the Oracle loadjava utility to install the jar file bpcodbutil.jar,
by entering the following command:
loadjava -user user/password@database -resolve bpcodbutil.jar
where user, password, and database have
the same values that you specified for user, password, and database in step 12.
- In case of problems, you can drop the jar file using the command: dropjava
bpcodbutil.jar.
- Create the table space
- Edit the createTablespace_Observer.sql script file according
to the instruction at the top of the file.
- Run the createTablespace_Observer.sql script file according
to the instruction at the top of the file.
- Make sure that the script output contains no errors. If errors occur,
you can drop the table space using the dropTablespace_Observer.sql script
file.
- Create the schema (tables, indexes, and views).
- Run the createSchema_Observer.sql script file according
to the instruction at the top of the file.
- Make sure that the script output contains no errors. If you want to drop
the schema, use the dropSchema_Observer.sql script file.
Result
The
database for Business Process Choreographer exists.
What to do next
Continue configuring in the parent topic at step 2.