Creating an OpenEdge Database

For use with Actional

This document describes the steps for creating an OpenEdge database for use with Actional. The
Actional product components use an underlying database for different purposes. OpenEdge
version 10.2A Service Pack 1 and beyond is required to perform this function. The steps for
creating the database have been extracted from developer’s notes as of July 27, 2009. Please
see the Actional and OpenEdge documentation for more information on performing these steps.

These steps assume an appropriate OpenEdge database environment is installed on a Windows

based computer.

Modify the OpenEdge Environment

Change the default internal timeout from 5 seconds to 30 seconds. You do this by adding the
following line to <OpenEdgeRoot>\Progress\OpenEdge\bin\sql_env.bat:

set PROSQL_LOCKWAIT_TIMEOUT=30

Create the Actional Database

Follow these steps to create the Actional database:

1. Since the database should not be located in the proenv home, create a database
directory somewhere. From a command prompt type the following:

> mkdir \OpenEdgeDB\ACTIONAL

2. Start proenv and set the environment. You can start proenv from the Start menu.
Once started type the following from the proenv prompt:

proenv> <OpenEdgeRoot>\Progress\OpenEdge\bin\sql_env.bat

3. Create a file with the name ACTIONAL.st in the ACTIONAL directory that was created in
step 1 that contains the following content:

#
b C:\OpenEdgeDB\ACTIONAL\ACTIONAL.b1 f 1572864
b C:\OpenEdgeDB\ACTIONAL\ACTIONAL.b2
#
d "Schema Area":6,32;1 C:\OpenEdgeDB\ACTIONAL\ACTIONAL.d1
#
d "LargeBusyArea":7,16;512 C:\OpenEdgeDB\ACTIONAL\ACTIONAL_7.d1 f
1572864
d "LargeBusyArea":7,16;512 C:\OpenEdgeDB\ACTIONAL\ACTIONAL_7.d2

NOTE: The first line “d” above should be all on one line and not split as shown. The end
of the line should read “f 1572864”.

Page 1 of 3
Creating an OpenEdge Database for use with Actional

4. Create the database by running the following commands in the proenv tool:

proenv> cd \OpenEdgeDB\ACTIONAL
proenv> prostrct create ACTIONAL ACTIONAL.st -blocksize 4096
proenv> procopy <OpenEdgeRoot>\Progress\OpenEdge\empty4 ACTIONAL

5. Using proenv, start the database. This example uses port 5555 but any free port can be
used:

proenv> _mprosrv ACTIONAL -S 5555 -SQLStmtCache 1000 -B 20000 -

spin 8000 -L 5000000 -n 50 -bibufs 50 -Mxs 32

NOTE: The command should be on one line and not split between lines as shown.

6. Use SQLExplorer inside proenv to create a user with the following commands:

proenv> sqlexp ACTIONAL -S 5555

SQLExplorer> create user 'oe','oe';
SQLExplorer> grant dba,resource to 'oe';
SQLExplorer> commit;
SQLExplorer> quit

7. Locate and run the appropriate SQL script that creates the Actional schema. The scripts
are found in the
<ActionalRoot>\Actional\<Component>\config\SQL\OpenEdge directory.

proenv> sqlexp ACTIONAL -S 5555 -user oe -password oe <

“SQL_location_dir”\ActionalServerCreationScript.sql

NOTE: The command should be on one line and not split between lines as shown. The
above command creates the schema for the Actional Management Server.

The OpenEdge database is now created and running for use with Actional.

Starting and Stopping the OpenEdge Database

This example uses the proenv tool to start and stop the OpenEdge database that was created
using the steps in the previous section. You should always run the sql_env.bat file whenever
you start the proenv tool prior to running commands. This example runs that file in the startup
section.

To start the OpenEdge database run these commands from the proenv prompt:

proenv> <OpenEdgeRoot>\Progress\OpenEdge\bin\sql_env.bat
proenv> cd \OpenEdgeDB\ACTIONAL
proenv> _mprosrv ACTIONAL -S 5555 -SQLStmtCache 1000 -B 20000 -spin
8000 -L 5000000 -n 50 -bibufs 50 -Mxs 32

NOTE: Each command should be on one line and not split between lines as shown.

To stop the OpenEdge database run these commands from the proenv prompt:

proenv> cd \OpenEdgeDB\ACTIONAL
proenv> proshut ACTIONAL

Page 2 of 3
Creating an OpenEdge Database for use with Actional

When presented with shutdown options, select option 2.

Configuring Actional to use the OpenEdge Database

The following example configures the Actional Management Server to use the newly created and
running OpenEdge database described in the previous sections. You must use Actional version
8.0.3 or later to use the OpenEdge database. This example uses Actional version 8.0.3 where the
database is configured using an External JDBC Driver. In Actional version 8.1 and beyond
the OpenEdge database will be listed in the Database Type dropdown box.

Use the following External JDBC Driver settings when configuring the Actional Management
Server to use an OpenEdge database on the Database Configuration page:

Database Type: External JDBC Driver

User Name: oe
Password: oe
URL: jdbc:datadirect:openedge://<hostname>:<port>;databaseName=ACTIONAL
JDBC driver name: com.ddtek.jdbc.openedge.OpenEdgeDriver
Classpath: base.jar;openedge.jar;util.jar

Browse to and upload the JAR files listed on the Classpath. The files are located in the
<OpenEdgeRoot>\Progress\OpenEdge\java directory.

Click on the “Verify Database” button to verify that the necessary tables exist. If the test
connection to the database and tables do not complete successfully, fix the problem then verify
again. A successful verification should have a status string similar to this: Test connection
to database and table verification completed successfully.

Page 3 of 3