5 Configuring the Oracle Business Process Management Domain
After you have installed Oracle Business Process Management, you can configure the domain, which you can also extend for high availability.
Refer to the following sections to create the database schemas, configure a WebLogic domain, and test the configuration:
Creating the Database Schemas
Before you can configure an Oracle Business Process Management domain, you must create the required Oracle schemas on a certified database for use with this release of Oracle Fusion Middleware.
Follow the instructions in Creating the Database Schemas to create the required schemas.
Configuring the Domain
Use the Configuration Wizard to create and configure a domain.
For information on other methods to create domains, see Additional Tools for Creating, Extending, and Managing WebLogic Domains in Creating WebLogic Domains Using the Configuration Wizard.
Starting the Configuration Wizard
Start the Configuration Wizard to begin configuring a domain.
To start the Configuration Wizard:
Navigating the Configuration Wizard Screens to Create and Configure the Domain
Enter required information in the Configuration Wizard screens to create and configure the domain for the topology.
Note:
You can use this procedure to extend an existing domain. If your needs do not match the instructions in the procedure, be sure to make your selections accordingly, or see the supporting documentation for more details.
Selecting the Domain Type and Domain Home Location for Oracle Business Process Management
Use the Configuration Type screen to select a Domain home directory location, optimally outside the Oracle home directory.
To specify the Domain type and Domain home directory:
For more information about this screen, see Configuration Type in Creating WebLogic Domains Using the Configuration Wizard.
Selecting the Configuration Template for Oracle Business Process Management
Use the Templates screen to select the templates you require.
- On the Templates screen, select Create Domain Using Custom Templates.
- Select Oracle BPM Suite - 14.1.2.0.0 [soa].
For more information about this screen, see Templates in Creating WebLogic Domains Using the Configuration Wizard.
Selecting the Application Home Location
Use the Application Location screen to select the location to store applications associated with your domain, also known as the Application home directory.
Oracle recommends that you locate your Application home in accordance with the directory structure in What Are the Key Oracle Fusion Middleware Directories? in Understanding Oracle Fusion Middleware, where the Application home is located outside the Oracle home directory. This directory structure helps avoid issues when you need to upgrade or re-install your software.
For more about the Application home directory, see About the Application Home Directory.
For more information about this screen, see Application Location in Creating WebLogic Domains Using the Configuration Wizard.
Configuring the Administrator Account
Use the Administrator Account screen to specify the username and password for the default WebLogic Administrator account for the domain.
Oracle recommends that you make a note of the username and password that you enter on this screen; you need these credentials later to boot and connect to the domain's Administration Server.
Specifying the Domain Mode and JDK
Use the Domain Mode and JDK screen to specify the domain mode and Java Development Kit (JDK) for your production environment.
On the Domain Mode and JDK screen:
-
Select Production in the Domain Mode field.
Note:
As of WebLogic Server 14.1.2.0.0, when you select Production mode, WebLogic Server automatically sets some of the security configurations of Secured Production to more secure values. However, there are certain security configurations (such as SSL/TLS) that require manual configuration. See Using Secured Production Mode in Administering Security for Oracle WebLogic Server.
If you want to disable the more secure default settings, then you may select Disable Secure Mode. This will enable the non-SSL listen ports.
If you want to retain the more secure default settings of Secured Production mode in general, but want to change which ports (listen ports, SSL listen ports, or administration ports) will be enabled by default in your domain, then you may:- Leave Disable Secure Mode unselected, and
- Change the default port selections under Enable or Disable Default Ports for Your Domain
For more information, see Understand How Domain Mode Affects the Default Security Configuration in Securing a Production Environment for Oracle WebLogic Server.
-
Select the Oracle HotSpot JDK in the JDK field.
Specifying the Database Configuration Type
Use the Database Configuration type screen to specify details about the database and database schema.
On the Database Configuration type screen, select RCU Data. This option instructs the Configuration Wizard to connect to the database and Service Table (STB) schema to automatically retrieve schema information for schemas needed to configure the domain.
Note:
If you select Manual Configuration on this screen, you must manually fill in parameters for your schema on the next screen.
After selecting RCU Data, specify details in the following fields:
Field | Description |
---|---|
Host Name |
Enter the name of the server hosting the database. Example:
|
DBMS/Service |
Enter the database DBMS name, or service name if you selected a service type driver. Example: |
Port |
Enter the port number on which the database listens. Example: |
Schema Owner Schema Password |
Enter the username and password for connecting to the database's Service Table schema. This is the schema username and password entered for the Service Table component on the Schema Passwords screen in the RCU (see Specifying Schema Passwords). The default username is
|
For an Autonomous Transaction Processing database (both Autonomous Transaction Processing-Dedicated (ATP-D) and Autonomous Transaction Processing Shared (ATP-S)), specify the connection credentials using only the Connection URL String option, and enter the connect string in the following format described in Connection Credentials for an Autonomous Transaction Processing Database.
Click Get RCU Configuration when you finish specifying the database connection information. The following output in the Connection Result Log indicates that the operation succeeded:
Connecting to the database server...OK Retrieving schema data from database server...OK Binding local schema components with retrieved data...OK Successfully Done.
For more information about the schema installed when the RCU is run, see About the Service Table Schema in Creating Schemas with the Repository Creation Utility.
See Database Configuration Type in Creating WebLogic Domains Using the Configuration Wizard .
Specifying JDBC Component Schema Information
Use the JDBC Component Schema screen to verify or specify details about the database schemas.
Verify that the values populated on the JDBC Component Schema screen are correct for all schemas. If you selected RCU Data on the previous screen, the schema table should already be populated appropriately.
For an Autonomous Transaction Processing database (both Autonomous Transaction Processing-Dedicated (ATP-D) and Autonomous Transaction Processing Shared (ATP-S)), specify the connection credentials using only the Connection URL String option, and enter the connect string in the following format:
@TNS_alias?TNS_ADMIN=<path of the wallet files, ojdbc.properties, and tnsnames.ora>
In the connect string, you must pass TNS_alias
as the
database service name found in tnsnames.ora
, and
TNS_ADMIN
property to the location of the wallet files,
ojdbc.properties
, and tnsnames.ora
.
Example connect string for Autonomous Transaction Processing-Dedicated (ATP-D) database:
@dbname_tp?TNS_ADMIN=/users/test/wallet_dbname/
Example connect string for Autonomous Transaction Processing Shared (ATP-S) database:
@dbname_tp?TNS_ADMIN=/users/test/wallet_dbname/
For high availability environments, see the following sections in High Availability Guide for additional information on configuring data sources for Oracle RAC databases:
See JDBC Component Schema in Creating WebLogic Domains Using the Configuration Wizard for more details about this screen.
Testing the JDBC Connections
Use the JDBC Component Schema Test screen to test the data source connections.
A green check mark in the Status column indicates a successful test. If you encounter any issues, see the error message in the Connection Result Log section of the screen, fix the problem, then try to test the connection again.
By default, the schema password for each schema component is the password you specified while creating your schemas.
For more information about this screen, see JDBC Component Schema Test in Creating WebLogic Domains Using the Configuration Wizard.
Selecting Advanced Configuration
Use the Advanced Configuration screen to complete the domain configuration.
On the Advanced Configuration screen, select:
-
Administration Server
Required to properly configure the listen address of the Administration Server.
-
Node Manager
Required to configure Node Manager.
-
Topology
Required to configure the Oracle Business Process Management Managed Server.
Configuring the Administration Server Listen Address
Use the Administration Server screen to select the Listen Address and configure the Administration Server ports.
Note:
The default port values will vary depening on how you conifigured your domain. The Enable SSL Listen Port is enabled by default, but the default values may change. For a list of default values, see Port Numbers by Product and Component.
- Provide a name for the Administration Server. The name field must not be null or empty and cannot contain any special characters.
- Select the drop-down list next to Listen Address and select the IP
address of the host where the Administration Server will reside or use the system name or
DNS name that maps to a single IP address. Do not use
All Local Addresses
. - Verify the port settings. When the domain type is set to Production, then
the Enable SSL Listen Port option is enabled by default. Do not specify any
server groups for the Administration Server.
Note:
You can change the port values as needed, but they must be unique. If the same port numbers are used for different ports, you will not be able to navigate to the next step in the Configuration Wizard.
For more information, see Specifying the Listen Address in Creating WebLogic Domains Using the Configuration Wizard.
Configuring Node Manager
Use the Node Manager screen to select the type of Node Manager you want to configure, along with the Node Manager credentials.
Select Per Domain Default Location as the Node Manager type, then specify Node Manager credentials.
For more information about this screen, see Node Manager in Creating WebLogic Domains Using the Configuration Wizard.
For more information about Node Manager types, see About Node Manager in Administering Node Manager for Oracle WebLogic Server.
Configuring Managed Servers for Oracle Business Process Management
Use the Managed Servers screen to configure Managed Servers.
On the Managed Servers screen, a Managed Server named soa_server1
is automatically created by default.
Note:
When deployed on a SOA server, the default Managed Server name issoa_server1
instead of bpm_server1
. In this guide, bpm_server1
is used to readily identify this Managed Server.
These server names are referenced in examples throughout this document.
For more information about this screen, see Managed Servers in Creating WebLogic Domains Using the Configuration Wizard.
Configuring a Cluster for Oracle Business Process Management
Use the Clusters screen to create a new cluster.
On the Clusters screen:
- Click Add.
- Specify
bpm_cluster1
in the Cluster Name field. - Leave the Cluster Address field blank.
By default, server instances in a cluster use unicast to communicate with one another. If you want to change your cluster communications to use multicast, see Considerations for Choosing Unicast or Multicast in Administering Clusters for Oracle WebLogic Server.
You can also use Oracle Fusion Middleware Control to create clusters. In this case, you can configure cluster communication (unicast or multicast) as you go through cluster creation steps. See Create and configure clusters in Oracle WebLogic Server Administration Console Online Help.
For more information about this screen, see Clusters in Creating WebLogic Domains Using the Configuration Wizard.
Defining Server Templates
If you are creating dynamic clusters for a high availability setup, use the Server Templates screen to define one or more server templates for the domain.
Note:
The default port values will vary depening on how you conifigured your domain. The Enable SSL Listen Port is enabled by default, but the default values may change. For a list of default values, see Port Numbers by Product and Component.
- Click Add to create
new_ServerTemplate_1
. The server template name will increment automatically when an additional server template is added (new_ServerTemplate_2
). - For Secure Production Mode, verify that the
Enable SSL Port option is selected. The
default SSL Listen Port does not increment automatically
when a new server template is added. You can change the
default to Enable Listen Port, but Oracle recommends that
retain the default to enable SSL. Enabling Listen Port
disables SSL Listen Port.
Note:
You can change the port values as needed using an integer in the range of 1 and 65535, but they must be unique. If the same port numbers are used for different ports, you will receive a port conflict error and you will not be able to start the server.
- The Administration Port does not increment when an
additional server template is added.
Note:
If the Listen ports are disabled, then instead of seeing a number you will see
Disabled
.
For steps to create a dynamic cluster for a high availability setup, see Using Dynamic Clusters in High Availability Guide.
Configuring Dynamic Servers
If you are creating dynamic clusters for a high availability setup, use the Dynamic Servers screen to configure the dynamic servers.
If you are not configuring a dynamic cluster, click Next to continue configuring the domain.
Note:
When you create dynamic clusters, keep in mind that after you assign the Machine Name Match Expression, you do not need to create machines for your dynamic cluster.To create a dynamic cluster for a high availability setup, see Using Dynamic Clusters in High Availability Guide.
Assigning Oracle Business Process Management Managed Servers to the Cluster
Use the Assign Servers to Clusters screen to assign Managed Servers to a new configured cluster. A configured cluster is a cluster you configure manually. You do not use this screen if you are configuring a dynamic cluster, a cluster that contains one or more generated server instances that are based on a server template.
Note:
All Managed Servers of a component type in the domain must belong to that cluster. For example, Oracle Business Process Management domains support only a single BPM cluster inside each domain.See About Dynamic Clusters for more on configured cluster and dynamic cluster terms.
On the Assign Servers to Clusters screen:
For more information about this screen, see Assign Servers to Clusters in Creating WebLogic Domains Using the Configuration Wizard.
Configuring Coherence Clusters
Use the Coherence Clusters screen to configure the Coherence cluster.
Leave the default port number as the Coherence cluster listen port. After configuration, the Coherence cluster is automatically added to the domain.
Note:
Setting the unicast listen port to 0
creates an offset for the Managed Server port numbers. The offset is 5000
, meaning the maximum allowed value that you can assign to a Managed Server port number is 60535
, instead of 65535
.
For Coherence licensing information, see Oracle Coherence Products in Licensing Information.
Creating a New Oracle Business Process Management Machine
Use the Machines screen to create new machines in the domain. A machine is required so that Node Manager can start and stop servers.
Tip:
If you plan to create a high availability environment and know the list of machines your target topology requires, you can follow the directions in this section to create all of the machines at this time. See Optional Scale Out Procedure in High Availability Guide.
Note:
If you are extending an existing domain, you can assign servers to any existing machine; you don’t need to create a new machine unless your situation requires it.
For more information about this screen, see Machines in Creating WebLogic Domains Using the Configuration Wizard.
Assigning Servers to Oracle Business Process Management Machines
Use the Assign Servers to Machines screen to assign the Administration Server and Managed Servers to the new machine you just created.
On the Assign Servers to Machines screen:
Figure 5-1 Assign Managed Servers to Machines

Description of "Figure 5-1 Assign Managed Servers to Machines"
Tip:
For more information about this screen, see Assign Servers to Machines in Creating WebLogic Domains Using the Configuration Wizard.
Reviewing Your Configuration Specifications and Configuring the Domain
The Configuration Summary screen shows detailed configuration information for the domain you are about to create.
Review each item on the screen and verify that the information is correct. To make any changes, go back to a screen by clicking the Back button or selecting the screen in the navigation pane. Domain creation does not start until you click Create.
For more details about options on this screen, see Configuration Summary in Creating WebLogic Domains Using the Configuration Wizard.
Writing Down Your Domain Home and Administration Server URL
The End of Configuration screen shows information about the domain you just configured.
Make a note of the following items because you need them later:
-
Domain Location
-
Administration Server URL
You need the domain location to access scripts that start Node Manager and Administration Server, and you need the URL to access the Administration Server.
Click Finish to dismiss the Configuration Wizard.
Starting the Servers
After configuration is complete, start Node Manager, then the WebLogic Administration Server and Managed Servers.
Note:
Depending on your existing security settings, you may need to perform additional configuration before you can start and manage a domain with secured production mode enabled. Specifically, you will need to add additional parameters when starting the Administration and Managed Servers. For more information, see Using Secured Production Mode Administering Security for Oracle WebLogic Server.
For more information on additional tools you can use to manage your domain, see Overview of Oracle Fusion Middleware Administration Tools in Administering Oracle Fusion Middleware.
Starting Node Manager
-
-
(UNIX) Go to the
DOMAIN_HOME/bin
directory. - (Windows) Go to the
DOMAIN_HOME\bin
directory.
-
-
Enter the following command:
-
(UNIX) Using
nohup
andnm.out
as an example output file:nohup ./startNodeManager.sh >
LOG_DIR
/nm.out&where
LOG_DIR
is the location of directory in which you want to store the log files. -
(Windows)
startNodeManager.cmd
Note:
On Windows operating systems, Oracle recommends that you configure Node Manager to run as a startup service. This allows Node Manager to start up automatically each time the system is restarted.
See Running Node Manager as a Startup Service in Administering Node Manager for Oracle WebLogic Server.
-
Starting the Administration Server
The procedures in this section describe how to start the Administration Server using the WLST command line or a script. You can also use the Oracle Fusion Middleware Control and the Oracle WebLogic Server Remote Console. See Starting and Stopping Administration and Managed Servers and Node Manager in Administering Oracle Fusion Middleware.
Note:
When using secured production mode, you must provide additional parameters to start the Administration Server. See Connecting to the Administration Server using WLST in Administering Security for Oracle WebLogic Server.
- (Optional) When using Production Mode, you can create a boot.properties file before starting the Administration Server and provide necessary permissions. This file can be created to bypass the need to provide a username and password when starting the Administration Server. For more information, see Creating a Boot Identity File for an Administration Server in Administering Server Startup and Shutdown for Oracle WebLogic Server.
-
Go to the
DOMAIN_HOME
/bin
directory. -
Enter the following command:
-
(UNIX)
./startWebLogic.sh
-
(Windows)
startWebLogic.cmd
If you selected Production Mode on the Domain Mode and JDK screen when you created the domain, and you did not create the optional boot.propeties file, you see a prompt for the Administrator user login credentials as provided on the Administrator Account screen.
-
- Open a browser and verify that the Administration Server is up
and running. The default port values will vary depening on how you
conifigured your domain. The Enable SSL Listen Port is enabled by default,
but the default values may change. For a list of default values, see Port Numbers by Product and
Component.
https://<Host_Name>:<port>
- Verify that all servers in the domain have unique port values. From the WebLogic Remote Console, you can review the Local Administration Port Override fields for each managed server and verify that each has a unique value. If one or more ports is using the same value, then you must change them before starting the managed servers. For more information about changing port values, see Connect to an Administration Server in the Oracle WebLogic Remote Console.
Note:
The WebLogic Server Administration Console has been removed. For comparable functionality, you should use the WebLogic Remote Console. For more information, see Oracle WebLogic Remote Console.Starting the Managed Servers
Starting SOA Managed Servers Using Secure Product Mode
-Djavax.net.ssl.trustStore=/u01/oracle/config/keystores/soahost1/trust.p12
-Djavax.net.ssl.trustStorePassword=<your_password>
SOA Managed Servers require the Keystores: Custom Identity Key Store Pass Phrase and the Custom Trust Key Store Pass Phrase, and the SSL Server Private Key Pass Phrase to be configured before starting the server. For detailed information, see Configuring Keystores.
- In Edit Tree, navigate to the newly created SOA Managed server. For example, WLS_SOA1.
- In the General tab, update and specify a unique number in the Local Administration Port Override field. Ensure that all the managed servers in the domain on the same machine have unique administration port values (>=1024).
- Click Save.
A message confirms that the changes are added to the shopping cart.
- Navigate to the Security tab, and then select Keystores.
- In the Keystores tab, specify the Custom Identity Key Store Pass Phrase and Custom Trust Key Store Pass Phrase.
- Click Save.
A message confirms that the changes are added to the shopping cart.
- Navigate to the SSL tab and specify the Server Private Key Pass Phrase.
- Click Save.
A message confirms that the changes are added to the shopping cart.
- Navigate to the Shopping Cart in the top-right corner of the WebLogic Remote Console window and click Commit Changes.
- Start the managed server. Once the pass
phrases have been configured, add the following
parameters to the command line:
Sample Command:
cd /domains/base_domain_1/bin ./startManagedWebLogic.sh soa_server1 https://host:<port> -Djavax.net.ssl.trustStore=/u01/oracle/config/keystores/soahost1/trust.p12 -Djavax.net.ssl.trustStorePassword=<your_password>
To start a WebLogic Managed Server that is not set to secure
product mode, you can use the startManagedWebLogic
script:
-
(UNIX)
NEW_DOMAIN_HOME/bin/startManagedWebLogic.sh managed_server_name
-
(Windows)
NEW_DOMAIN_HOME\bin\startManagedWebLogic.cmd managed_server_name
Note:
When using secured production mode, you must provide additional parameters to start the Managed Servers. See Starting Managed Servers using a Start Script in Administering Security for Oracle WebLogic Server.
Verifying the Configuration
After completing all configuration steps, you can perform additional steps to verify that your domain is properly configured.
To verify that the domain is configured properly, see Performing Additional Domain Configuration Tasks.
Writing Down Your Domain Home and Administration Server URL
The End of Configuration screen shows information about the domain you just configured.
Make a note of the following items because you need them later:
-
Domain Location
-
Administration Server URL
You need the domain location to access scripts that start Node Manager and Administration Server, and you need the URL to access the Administration Server.
Click Finish to dismiss the Configuration Wizard.