Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

Follow the instructions below to set up the OpenEdge.The following sections describe how to replace the default H2 databases with OpenEdge (OE):

Table of Contents
type
maxLevel3minLevel3
styleborder:1
locationtop
flatseparatorpipe

Setup Database And The Database User

1. Download and install OpenEdge on you computer if it is not already done.

2. Go to the <OE-installation-directory>/bin folder and use the proenv script to setup the environment variables. After doing that, add the <OE-insallation-directory>/java/prosp.jar to the CLASSPATH environment variable.

3. Create an empty database using the prodb script. This script creates a database by copying an existing database provided with the installation.

Code Block
prodb CARBON_DB <OE-installation-directory>/empty8

4. Start the database using the proserve script. Provide the database name and a port as arguments to this script using the -db and -S parameters.

Code Block
proserve -db CARBON_DB -S 6767

5. Use the sqlexp script to start the default SQL explorer that comes with the OpenEdge installation. Connect to the database that was created previously by using the -db and -S parameters.

Code Block
sqlexp -db CARBON_DB -S 6767

6. Now use the following commands to create a user and grant the permissions to the database.

Code Block
CREATE USER 'wso2carbon','wso2carbon';
    GRANT dba,resource TO 'wso2carbon';
    COMMIT;

7. Now log out from the SQL explorer by typing "exit."

Setup Configuration Files

1. Edit the default database configuration defined in the  master-datasources.xml  file located at  <PRODUCT_HOME>/repository/conf/datasources  directory as below. Both the database configurations in  registry.xml  and  user-mgt.xml  refer this data source.

Image Removed

Info
titleNote

You have to replace these settings with your custom values.

Code Block
languagehtml/xml
<datasource>
     <name>WSO2_CARBON_DB</name>
     <description>The datasource used for registry and user manager</description>
     <jndiConfig>
           <name>jdbc/WSO2CarbonDB</name>
     </jndiConfig>
     <definition type="RDBMS">
           <configuration>
               <url>jdbc:datadirect:openedge://localhost:6767;databaseName=CARBON_DB</url>
               <username>regadmin</username>
               <password>regadmin</password>
               <driverClassName>com.ddtek.jdbc.openedge.OpenEdgeDriver</driverClassName>
               <maxActive>80</maxActive>
               <maxWait>60000</maxWait>
               <minIdle>5</minIdle>
               <testOnBorrow>true</testOnBorrow>
               <validationQuery>SELECT 1</validationQuery>
               <validationInterval>30000</validationInterval>
           </configuration>
     </definition>
</datasource>
The database configuration options.
  • url - The URL of the database.
  • username - The name of the database user.
  • password - The password of the database user.
  • driverName - The class name of the database driver.
  • maxActive - The maximum number of active connections that can be allocated from this pool at the same time or negative for no limit.
  • maxWait - The maximum number of milliseconds that the pool will wait (when there are no available connections) for a connection to be returned before throwing an exception or <= 0 to wait indefinitely.
  • minIdle - The minimum number of active connections that can remain idle in the pool, without extra ones being created, or 0 to create none.
Info
titleNote

Please note that we do not support running User Manager on OpenEdge in this release.

Setup Drivers

Copy the <OE-insallation-directory>/java/openedge.jar to the <PRODUCT_HOME>/repository/components/lib directory. Here  <PRODUCT_HOME>  refers to the directory where you run WSO2 BRS instance.

Create Database

Automatic Database Creation

1. Next at the first time you start the server, run with the -Dsetup option. It will create all the tables in a given OpenEdge database.

  • For Linux:

    Code Block
    wso2server.sh -Dsetup
  • For Windows:

    Code Block
    wso2server.bat -Dsetup

2. WSO2 BRS is configured to run with the OpenEdge database.

Manual Database Creation

1. For creating the tables manually, the OpenEdge script provided with the BRS have to be modified.

Make a backup of the <PRODUCT_HOME>/dbscripts/openedge.sql under the name of openedge_manual.sql.

2. Replace all the "/" symbols in the openedge_manual.sql script with the ";" symbol.

3. At the end of the openedge_manual.sql script, add the following line and save the script.

Code Block
COMMIT;

4. Run the modified script using the SQL explorer.

Code Block
sqlexp -db CARBON_DB -S 6767 -user wso2carbon -password wso2carbon  <PRODUCT_HOME>/dbscripts/openedge_manual.sql

5. Start the server.

  • For Linux:

    Code Block
    wso2server.sh
    
  • For Windows:

    Code Block
    wso2server.bat
    

...

hiddentrue

...

Include Page
Shared:Setting up OpenEdge (V1)
Shared:Setting up OpenEdge (V1)