This site contains the documentation that is relevant to older WSO2 product versions and offerings.
For the latest WSO2 documentation, visit https://wso2.com/documentation/.
Setting up Oracle RAC
The following sections describe how to set up Oracle RAC to replace the default H2 database in your WSO2 product:Â
Oracle Real Application Clusters (RAC) is an option that facilitates clustering and high availability in Oracle database environments. In the Oracle RAC environment, some of the commands used in oracle.sql
are considered inefficient. Therefore, the product has a separate SQL script (oracle_rac.sql
) for Oracle RAC. The Oracle RAC-friendly script is located in the dbscripts
folder together with other .sql
scripts.
To test products on Oracle RAC, rename oracle_rac.sql
to oracle.sql
before running -Dsetup
.
Setting up the database and users
Follow the steps below to set up an Oracle RAC database.
- Set environment variables <
ORACLE_HOME>
,PATH
,ORACLE_SID
with the corresponding values (/oracle/app/oracle/product/11.2.0/dbhome_1
,$PATH:<ORACLE_HOME>/bin
, andorcl1
 ) as follows:
- Connect to Oracle using SQL*Plus as SYSDBA.
Create a database user and grant privileges to the user as shown below:
Create user <USER_NAME> identified by password account unlock; grant connect to <USER_NAME>; grant create session, create table, create sequence, create trigger to <USER_NAME>; alter user <USER_NAME> quota <SPACE_QUOTA_SIZE_IN_MEGABYTES> on '<TABLE_SPACE_NAME>'; commit;
- Exit from the SQL*Plus session by executing theÂ
quit
 command.
Setting up the JDBC driver
Copy the Oracle JDBC libraries (for example, the <ORACLE_HOME>/jdbc/lib/ojdbc14.jar
file)Â to the <PRODUCT_HOME>/repository/components/lib/
directory.Â
Remove the old database driver from the <PRODUCT_HOME>/repository/components/dropins
directory when you upgrade the database driver.
What's next
By default, all WSO2 products are configured to use the embedded H2 database. To configure your product with Oracle RAC, see Changing to Oracle RAC.