Installation Guide

     Previous  Next    Open TOC in new window    View as PDF - New Window  Get Adobe Reader - New Window
Content starts here

Installing Oracle Enterprise Repository Workflow into Oracle BPM 10.3

This section describes how to install the Oracle Enterprise Repository Workflow into Oracle BPM 6.0.

 


Step 1: Requirements

Before installing the Oracle Enterprise Repository Workflow consider these requirements:

 


Step 2: Obtain the Oracle Enterprise Repository Workflow Installer

Obtain the Oracle Enterprise Repository Workflow installer from the following directory within the Oracle Enterprise Repository installation location: $Oracle_HOME/repository103/core/tools/solutions/OER103-OBPM-Workflow-Management-Scripts.zip.

Extract the zip file into the $Oracle_HOME/obpm directory on the server where Oracle BPM is installed. Two directories are created from this zip file: FuegoSetupScript and workflow.

 


Step 3: Configure the build.properties File

Enter the correct values for the workflow_installer_location\FuegoSetupScript\build.properties file. See Table 8-1 for properties descriptions.

Note: Use forward slash characters to separate path elements regardless of platform (see examples below):

Table 8-1 build.properties File Property Values
Property
Description
oracle.home
This property specifies the location of your Oracle Home directory, for example, c:/oracle or /opt/oracle.
fuego.basedir
This property specifies the Oracle BPM installation location. for example, c:/oracle/obpm/enterprise or /opt/oracle/obpm/enterprise.
fuego.fdi.admin.id
This property specifies the admin user for the Oracle BPM installation.This user account is used to access the Oracle BPM webconsole application.
fuego.fdi.admin.password
This property specifies the admin password for the Oracle BPM installation.
fuego.fdi.db.host
This property specifies the machine on which the Oracle BPM FDI (directory) database is to be installed.
fuego.fdi.db.port:
This property specifies the Oracle BPM FDI database port.
fuego.fdi.db.admin.id
This property specifies the database admin user for the Oracle BPM FDI database. The installer uses this property to install the FDI schema (see below).
fuego.fdi.db.admin.password
This property specifies the database user’s password for the Oracle BPM FDI database.
fuego.fdi.db.type
This property specifies the database type for the Oracle BPM FDI database. Possible values are: oracle, mssqlserver, db2.
fuego.fdi.db.user.id
This property specifies the database user name for the Oracle BPM FDI schema the database creates. This property is used by Oracle BPM at run time.
fuego.fdi.db.user.password
This property specifies the database password for the Oracle BPM FDI schema.
fuego.fdi.db.sid
This property specifies the SID for the Oracle BPM FDI database. This property is only applicable for the Oracle database type.
fuego.fdi.db.database
This property specifies the database name for the Oracle BPM FDI database. This property is only applicable for mssqlserver and db2 database types.
fuego.server.db.host
This property specifies the system on which the Oracle BPM process engine database is to be installed.
fuego.server.db.port
This property specifies the Oracle BPM process engine database port.
fuego.server.db.admin.id
This property specifies the database admin user for the Oracle BPM process engine database. The installer uses this property to install the FDI schema (see below).
fuego.server.db.admin.password
This property specifies the database password user for the Oracle BPM process engine database.
fuego.server.db.type
This property specifies the database type for the Oracle BPM process engine database. Possible values are: oracle, mssqlserver, db2.
fuego.server.db.user.id
This property specifies the database user name for the process engine schema that is created. This property is used by Oracle BPM at run time.
fuego.server.db.user.password
This property specifies the database password for the Oracle BPM process engine schema.
fuego.server.db.sid
This property specifies the SID for the Oracle BPM process engine database. This property is only applicable for the oracle database type.
fuego.server.db.database
This property specifies the database name for the Oracle BPM process engine database. This property is only applicable for the mssqlserver and db2 database types.

 


Step 4: Configure the setenv File

Enter the correct values for the workflow_installer_location\FuegoSetupScript\setenv.bat (Windows), or /setenv.sh file (Unix). See Table 8-2 for properties descriptions.

Note: Use back slash characters (\) to separate path elements.

Table 8-2 setenv File Property Values
Property
Description
ORACLE_HOME
This property specifies the location of the Oracle Home directory. For example, c:\oracle or /opt/oracle.
FUEGO_HOME
This property specifies the location where Oracle BPM is installed. For example, c:\oracle\obpm6.0\enterprise.
JAVA_HOME
This property specifies the location of a Java runtime on the system. for example, c:\oracle\obpm6.0\j2eewl\jre.
ANT_HOME
This property specifies the location of a Apache ANT installation on your machine. For example, C:\oracle\modules\org.apache.ant-1.6.5 or /opt/oracle/modules/org.apache.ant-1.6.5

 


Step 5: Edit the workflow.xml File

Edit the workflow.xml file located within the $Oracle_HOME/obpm/FuegoSetupScript/workflow.xml and modify the URI to match the URI of the Oracle Enterprise Repository installation. Retain the /services/FlashlineRegistry at the end of the path reference.

 


Step 6: Copy the JDBC jar(s)

Copy the JDBC jar(s) for your database to the $Oracle_HOME\FuegoSetupScript\ext directory.

 


Step 7: Run the Setup Script

To run the setenv.bat or setenv.sh file:

  1. Open a command, or shell window.
  2. Navigate to the $Oracle_HOME\FuegoSetupScript directory.
  3. Run the following command:
  4. setenv.bat (Windows)

    setenv.sh (Unix)

  5. Run the following command:
  6. ant create-fdi

  7. Run the following command:
  8. ant install-workflow

 


Step 8: Verify the Setup Script

To validate the success of the setup script:

  1. Open the Oracle BPM Admin Center application.
  2. Click Start BPM Applications.
  3. Click Launch Process Administrator.
  4. Access the webconsole Web interface and login using the user credentials supplied within the build.properties file with the properties fuego.fdi.admin.id and fuego.fdi.admin.password.
  5. Select the Engines link in the left side menu.
  6. The oer_engine engine is displayed with a status of Not running.

  7. Click the option to start the engine using the left most icon in the Engine Actions column.
  8. Once the engine is running, the status of the engine displayed is Ready.

  9. Validate that the Oracle BPM service endpoint is listening appropriately. Use a Web browser to connect to the Oracle BPM server at port 9000.
  10. Click the link for obpmServices/oer_engine/ws link.
  11. Two services are then listed, StatusChangeEndpointServiceListener and RefreshConfigServiceListener.

  12. Click the On the Oracle Enterprise Repository installation within the WEB-INF/classes/EndPointEventSubscription.xml file and modify the <sub:host> element to contain the IP address or the fully qualified host name of the server where Oracle BPM is installed.
  13. Oracle Enterprise Repository workflows are now deployed.

Note: If any build failure or errors appear during the ANT deployment of the workflows, follow these steps:
    1. Drop the FDI Schema user (as specified for fuego.fdi.db.schema in build.properties file) from Database.
    2. Drop the FDI Engine user (as specified for fuego.server.db.schema in build.properties file) from Database.
    3. Make sure the BPM Applications are not running and obpmadmcenter.exe is closed.
    4. Run the ant create-fdi command.
    5. Run the command ant install-workflow command.

  Back to Top       Previous  Next