3 Configuring the Oracle Fusion Middleware Infrastructure Domain

Use the steps in the following order to create and configure the WebLogic Server domain for Oracle Fusion Middleware Infrastructure.

This section contains the following topics:

3.1 Creating Database Schemas

Before you configure a Fusion Middleware Infrastructure domain, you must install the following schemas on a certified database to use them with this Oracle Fusion Middleware release.

  • Metadata Services (MDS)

  • Audit Services (IAU)

  • Audit Services Append (IAU_APPEND)

  • Audit Services Viewer (IAU_VIEWER)

  • Oracle Platform Security Services (OPSS)

  • User Messaging Service (UMS)

  • WebLogic Services (WLS)

  • Service Table (STB)

Follow the instructions in this topic to create database schemas:

3.1.1 Installing and Configuring a Certified Database

Verify that you installed and configured a certified database and that it is up and running.

For more information, see Installing a Database and Database Schemas in Oracle Fusion Middleware Planning an Installation of Oracle Fusion Middleware.

3.1.2 Starting the Repository Creation Utility (RCU)

You start RCU from the /oracle_common/bin directory.

To start the Repository Creation Utility:

  1. Navigate to the ORACLE_HOME/oracle_common/bin directory.
  2. Start RCU:

    On UNIX operating systems:

    ./rcu
    

    On Microsoft Windows operating systems:

    rcu.bat
    

3.1.3 Navigating RCU Screens to Create Schemas

Follow this series of steps to create schemas for the Oracle Fusion Middleware Infrastructure domain.

3.1.3.1 Introducing RCU

Click Next on the Welcome to Repository Creation Utility screen.

3.1.3.2 Selecting a Schema Creation Method

If you have the permission and privileges to perform DBA actions on your database, select System Load and Product Load on the Create Repository screen.

(The procedure in this document assumes that you have the necessary privileges.)

If you do not have the necessary permission or privileges to perform DBA actions, you must select Prepare Scripts for System Load. This option generates a SQL script that you can give to your database administrator. See Understanding System Load and Product Load in Oracle Fusion Middleware Creating Schemas with the Repository Creation Utility.

Tip:

For more about options on this screen, see Create repository in Oracle Fusion Middleware Creating Schemas with the Repository Creation Utility.

3.1.3.3 Providing Database Credentials

On the Database Connection Details screen, enter database connection details for RCU to connect to your database.

Click Next then click OK on the dialog window to confirm a successful database connection.

For more information about options on this screen, see Database Connection Details in Oracle Fusion Middleware Creating Schemas with the Repository Creation Utility.

3.1.3.4 Specifying a Custom Prefix and Selecting Schemas

On the Select Components screen, enter a custom prefix you want to use for your schemas, then select AS Common Schemas.

All schemas in this section are automatically selected. The custom prefix logically groups these schemas together for this domain.

Tip:

For more on custom prefixes, see Understanding Custom Prefixes in Oracle Fusion Middleware Creating Schemas with the Repository Creation Utility.

For more on how to organize schemas in a multi-domain environment, see Planning Your Schema Creation in Oracle Fusion Middleware Creating Schemas with the Repository Creation Utility.

Make a note of the custom prefix that you enter; you need the prefix when you create a domain.

Click Next then click OK on the dialog window to confirm that prerequisite checking for schema creation is successful.

3.1.3.5 Specifying Schema Passwords

On the Schema Passwords screen, specify how you want to set the schema passwords on your database, then enter and confirm your passwords.

Tip:

You must make a note of the passwords you set on this screen; you will need them later on during the domain creation process.

3.1.3.6 Completing Schema Creation

Navigate through the remaining RCU screens to complete schema creation. When you reach the Completion Summary screen, click Close to dismiss RCU.

For more information about RCU and its features and concepts, see About Repository Creation Utility.

3.2 Configuring Your WebLogic Domain

This topic describes how to create a WebLogic domain using the Configuration Wizard.

There are other ways to create a domain; see Additional Tools for Creating, Extending, and Managing WebLogic Domains in Oracle Fusion Middleware Creating WebLogic Domains Using the Configuration Wizard.

To configure a WebLogic domain, follow these steps:

3.2.1 Starting the Configuration Wizard

To start domain configuration, navigate to the ORACLE_HOME/oracle_common/common/bin directory and start the WebLogic Server Configuration Wizard.

On UNIX operating systems:

./config.sh

On Microsoft Windows operating systems:

config.cmd

On Windows operating systems, you can also start the Configuration Wizard from the Start menu: Select All Programs, then Oracle, then OracleHome. Select WebLogic Server 12c (12.2.version), then Tools, then Configuration Wizard.

3.2.2 Navigating Configuration Wizard Screens to Configure the Domain

In addition to creating and configuring a domain, you can use this procedure to extend an existing domain. If your settings don't match those in the procedure, change your selections as you need to or see supporting documentation for more details.

To configure multiple products in one domain, see Installing Multiple Products in the Same Domain in Oracle Fusion Middleware Planning an Installation of Oracle Fusion Middleware.

3.2.2.1 Selecting the Domain Type and Domain Home Location

You must select a Domain home directory location, optimally outside the Oracle home directory.

To specify the Domain type and Domain home directory:

  1. On the Configuration Type screen, select Create a New Domain.
  2. In the Domain Location field, specify your Domain home directory.

Oracle recommends that you locate your Domain home in accordance with the directory structure in What are the Key Oracle Fusion Middleware Directories? in Oracle Fusion Middleware Understanding Oracle Fusion Middleware. The Domain home resides outside Oracle home directory. This directory structure helps avoid issues when you upgrade or reinstall software.

Tip:

For more on the Domain home directory, see Choosing a Domain Home in Oracle Fusion Middleware Planning an Installation of Oracle Fusion Middleware.

For more about reinstalling the software, see About Reinstalling the Software.

For more about other options on this screen, see Configuration Type in Oracle Fusion Middleware Creating WebLogic Domains Using the Configuration Wizard.

3.2.2.2 Selecting Configuration Templates

A domain template defines the full set of resources within a WebLogic domain, including the Administration Server, clusters, servers, applications, services, security options, and other options.

On the Templates screen, make sure Create Domain Using Product Templates is selected, then select the following templates:

  • Oracle Enterprise Manager - 12.2.1.2.0 [em]]

    Selecting this template automatically selects the following dependencies:

    • Oracle JRF - 12.2.1.2.0 [oracle_common]

    • WebLogic Coherence Cluster Extension - 12.2.1.2.0 [wlserver]

  • Oracle WSM Policy Manager - 12.2.1.2.0 [oracle_common]

Tip:

For more information about options on this screen, see Templates in Oracle Fusion Middleware Creating WebLogic Domains Using the Configuration Wizard.

3.2.2.3 Selecting the Application Home Location

On the Application Location screen, select a location to store applications associated with your domain. This location is the Application home directory.

Oracle recommends that you locate your Application home in accordance with the directory structure that What are the Key Oracle Fusion Middleware Directories? in Oracle Fusion Middleware Understanding Oracle Fusion Middleware describes. Oracle recommends that you locate the Application home outside the Oracle home directory. This directory structure helps avoid issues when you upgrade or reinstall your software.

Tip:

For more information about the Application home directory, see Choosing an Application Home in Oracle Fusion Middleware Planning an Installation of Oracle Fusion Middleware.

For more information about reinstalling the software, see About Reinstalling the Software.

For more information about the options on this screen, see Application Location in Oracle Fusion Middleware Creating WebLogic Domains Using the Configuration Wizard.

3.2.2.4 Configuring the Administrator Account

Use the Administrator Account screen to specify the user name and password for the default WebLogic Administrator account for the domain.

Oracle recommends that you make a note of the user name and password that you specify; you need these credentials later to boot and connect to the domain's Administration Server.

3.2.2.5 Specifying the Domain Mode and JDK

Use the Domain Mode and JDK screen to specify the domain mode and Java Development Kit (JDK).

  • Select Production in the Domain Mode field.

  • Select the Oracle Hotspot JDK in the JDK field.

Select Production Mode to give your environment a higher degree of security. Doing this means that you must enter a user name and password to deploy applications and to start the Administration Server.

Tip:

For details about options on this screen, including differences between development mode and production mode, see Domain Mode and JDK in Oracle Fusion Middleware Creating WebLogic Domains Using the Configuration Wizard.

In production mode, you can create a boot identity file to bypass the need to enter credentials when you start the Administration Server. See Creating a Boot Identity File for an Administration Server in Oracle Fusion Middleware Administering Server Startup and Shutdown for Oracle WebLogic Server.

3.2.2.6 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, fill in the following fields:

Field Description

DBMS/Service

Enter the database DBMS name, or service name if you selected a service type driver.

Example: orcl.exampledomain.com

Host Name

Enter the name of the server hosting the database.

Example: examplehost.exampledomain.com

Port

Enter the port number on which the database listens.

Example: 1521

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 prefix_STB, where prefix is the custom prefix that you defined in the RCU.

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.

Tip:

For more information about the schema installed when the RCU is run, see About the Service Table Schema in Oracle Fusion Middleware Creating Schemas with the Repository Creation Utility.

For more information about this screen, see Database Configuration Type in Oracle Fusion Middleware Creating WebLogic Domains Using the Configuration Wizard.

3.2.2.7 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.

Tip:

For high availability environments, see the following sections in Oracle Fusion Middleware High Availability Guide for additional information on configuring data sources for Oracle RAC databases:

For more information about this screen, see JDBC Component Schema in Oracle Fusion Middleware Creating WebLogic Domains Using the Configuration Wizard.

3.2.2.8 Testing JDBC Connections

Use the JDBC Component Schema Test screen to test datasource connections that you just configured.

A green check mark in the Status column indicates a successful test. If you encounter issues, see the error message in the Connection Result Log section of the screen, fix the problem, then test the connection again.

Tip:

See JDBC Component Schema Test in Oracle Fusion Middleware Creating WebLogic Domains Using the Configuration Wizard for more information about the other options on this screen.

3.2.2.9 Selecting Advanced Configuration

Use the Advanced Configuration screen to complete the domain configuration.

To complete domain configuration, select these options:

  • Administration Server

    Required to properly configure the Administration Server’s listen address

  • Node Manager

    Required to configure Node Manager

  • Topology

    Required to configure the Managed Servers and cluster, and for configuring the machine and targeting Managed Servers to the machine.

    Tip:

    To configure dynamic clusters, see:

You do not need to select:

  • Domain Frontend Host Capture

  • Deployments and Services

  • JMS File Store

3.2.2.10 Configuring the Administration Server Listen Address

Use the Administration Server screen to select the IP address of the host.

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.

Do not specify any server groups for the Administration Server.

Note:

Use Mozilla Firefox to access Internet Protocol Version 6 (IPv6) URLs. You must enter the Global IPv6 address to create a domain and access URLs. (You should not use the local IPv6 address.)

3.2.2.11 Configuring Node Manager

Use the Node Manager screen to select the Node Manager type 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.

Tip:

See Node Manager in Oracle Fusion Middleware Creating WebLogic Domains Using the Configuration Wizard for details about options on this screen.

See Node Manager Overview in Oracle Fusion Middleware Administering Node Manager for Oracle WebLogic Server for details about the types of Node Manager.

3.2.2.12 Configuring Managed Servers

In this screen, you create Managed Servers.

To create two new Managed Servers:

  1. Click the Add button to create a new Managed Server.
  2. Specify infra_server_1 in the Server name column.

    Installation and configuration procedures use infra_server_# for Managed Servers names. If you use different names, substitute infra_server_# with them.

  3. In the Listen Address drop-down list, select the IP address of the host on which the Managed Server will reside. Do not use "All Local Addresses."
  4. In the Server Groups drop-down list, select JRF-MAN-SVR and WSMPM-MAN-SVR. These server groups ensure that Oracle JRF and Oracle Web Services Manager (OWSM) services target Managed Servers you are creating.

    See About Server Groups for more on server groups.

  5. Repeat this process to create a second Managed Server named infra_server_2.

    You must configure a second Managed Server to configure the standard topology for high availability. If you are not creating a highly available environment, this step is optional.

    For more about the high availability standard topology, see Understanding the Fusion Middleware Standard HA Topology in Oracle Fusion Middleware High Availability Guide.

    For more about the next steps to prepare for high availability after your domain is configured, see High Availability Configuration Tasks.

Tip:

For details about options on this screen, see Managed Servers in Oracle Fusion Middleware Creating WebLogic Domains Using the Configuration Wizard.

3.2.2.13 Configuring a Cluster

To create a new cluster:

  1. Click the Add button.
  2. Enter infra_cluster_1 in the Cluster Name field.
  3. Leave the cluster Address field blank.

By default, server instances in a cluster use unicast to communicate with each other. To change your cluster communications to use multicast, see Considerations for Choosing Unicast or Multicast in Oracle Fusion Middleware Administering Clusters for Oracle WebLogic Server.

You can create new clusters using Fusion Middleware Control and configure cluster communication (unicast or multicast) as you go through cluster creation steps. See Create and Configure Clusters in Administration Console Online Help.

Tip:

For more information on options on this screen, see Clusters in Oracle Fusion Middleware Creating WebLogic Domains Using the Configuration Wizard.

3.2.2.14 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 domain.

To continue configuring the domain, click Next.

For steps to create a dynamic cluster for a high availability setup, see Using Dynamic Clusters in Oracle Fusion Middleware High Availability Guide.

3.2.2.15 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.

For steps to create a dynamic cluster for a high availability setup, see Using Dynamic Clusters in Oracle Fusion Middleware High Availability Guide.

3.2.2.16 Assigning Managed Servers to the Cluster

To assign infra_server_1 and infra_server_2 to the new cluster infra_cluster_1, use the Assign Servers to Clusters screen:

  1. In the Clusters pane, select the cluster that you want to assign servers to; in this case, infra_cluster_1.
  2. In the Servers pane, take one of the following steps to assign infra_server_1 to infra_cluster_1:
    • Click once on infra_server_1 to select it, then click on the right arrow to move it beneath the selected cluster (infra_cluster_1) in the Clusters pane.

    • Double-click on infra_server_1 to move it beneath the selected cluster (infra_cluster_1) in the clusters pane.

  3. Repeat to assign infra_server_2 to infra_cluster_1.

Tip:

For more about options on this screen, see Assign Servers to Clusters in Oracle Fusion Middleware Creating WebLogic Domains Using the Configuration Wizard.

3.2.2.17 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.

Note:

For Coherence licensing information, see Oracle Coherence Products in Licensing Information.

3.2.2.18 Creating a New Machine

You create a new machine in the domain using the Machines screen. You assign servers to this machine in the next screen.

Tip:

If you plan to create a high availability environment and know the list of machines that your target topology requires, you can follow the steps in this topic to create all machines at this time. For more information, see Optional Scale Out Procedure in Oracle Fusion Middleware High Availability Guide.

To create a new machine in the domain:

  1. Click the Add button to create a new machine.
  2. Specify infra_machine_1 in the Name field.
  3. In the Node Manager Listen Address field, select the IP address of the machine where you are configuring Managed Servers. You must select a specific interface, not "localhost," so that Coherence cluster addresses can calculate dynamically.
  4. Verify the port in the Node Manager Listen Port field.

    Examples in the procedures may use port number 5556. You must replace this port number with your own port number as needed.

Note:

If you extend 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.

Tip:

See Machines in Oracle Fusion Middleware Creating WebLogic Domains Using the Configuration Wizard for more information about these options.

3.2.2.19 Assigning Servers to Machines

In this screen, assign the domain servers to the machine you just created.

To assign the Administration Server and Managed Servers to the new machine:

  1. In the Machines pane, select the machine you want to assign the servers to; in this case, infra_machine_1.
  2. In the Servers pane, take one of the following steps to assign AdminServer to infra_machine_1:
    • Click once on AdminServer to select it, then click on the right arrow to move it beneath the selected machine (infra_machine_1) in the Machines pane.

    • Double-click on AdminServer to move it beneath the selected machine (infra_machine_1) in the Machines pane.

  3. Repeat to assign both infra_server_1 and infra_server_2 to infra_machine_1. Click Next.

Tip:

For more information about options on this screen, see Assign Servers to Machines in Oracle Fusion Middleware Creating WebLogic Domains Using the Configuration Wizard.

3.2.2.20 Virtual Targets

If you have a WebLogic Server Multitenant (MT) environment, you use the Virtual Targets screen to add or delete virtual targets. For this installation (not a WebLogic Server MT environment), you do not enter any values; just select Next.

Tip:

For more information about this screen, see Virtual Targets in Oracle Fusion Middleware Creating WebLogic Domains Using the Configuration Wizard.

3.2.2.21 Partitions

The Partitions screen is used to configure partitions for virtual targets in WebLogic Server Multitenant (MT) environments. Select Next without selecting any options.

Tip:

For more information about this screen, see Partitions in Oracle Fusion Middleware Creating WebLogic Domains Using the Configuration Wizard.

3.2.2.22 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.

Tip:

For more information about this screen, see Configuration Summary in Oracle Fusion Middleware Creating WebLogic Domains Using the Configuration Wizard.

3.2.2.23 Writing Down Your Domain Name and Administration Server URL

The Configuration Success screen shows information about the domain you just configured.

  • Domain Location

  • Administration Server URL

You must make a note of both items because you need them later; you need the Domain Location to access scripts that start Node Manager and Administration Server. You need Admin Server URL to access the Administration Server.

Click Finish to dismiss the Configuration Wizard.

3.2.3 About Server Groups

Server groups target Fusion Middleware applications and services to one or more servers by mapping defined application service groups to each defined server group.

Any application services that map to a server group automatically target all servers assigned to that group. For more information, see Application Service Groups, Server Groups, and Application Service Mappings in Oracle Fusion Middleware Domain Template Reference.

Note:

The WSM-CACHE-SVR server group configures Nonce caching for Oracle Web Services automatically, and is suitable for most applications. Nonce is a unique number that can be used only once in a SOAP request and prevents replay attacks. Nonce caching scales with the number of added Managed Servers running Web service applications.

For advanced caching configurations, see Caching the Nonce with Oracle Coherence in Oracle Fusion Middleware Securing Web Services and Managing Policies with Oracle Web Services Manager.

3.3 Starting the Servers

When you finish configuration, take the following steps to access tools to manage your domain.

Note:

For more on tools you can use to manage a domain, see Overview of Oracle Fusion Middleware Administration Tools in Oracle Fusion Middleware Administering Oracle Fusion Middleware.

3.3.1 Starting Node Manager

To start the per-domain Node Manager:
  1. Go to the DOMAIN_HOME/bin directory.

  2. Enter the following command:

    • (UNIX) Using nohup and nm.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 Oracle Fusion Middleware Administering Node Manager for Oracle WebLogic Server.

3.3.2 Starting the Administration Server

After you finish configuration, you need to start the Administration Server to manage your domain.

To start the Administration Server:

On UNIX operating systems, go the DOMAIN_HOME/bin directory and run:

./startWebLogic.sh

On Windows operating systems, run:

startWebLogic.cmd

If you chose Production Mode on the Domain Mode and JDK screen in Specifying the Domain Mode and JDK, you see a prompt for Administrator user login credentials. You provided these in the Administrator Account screen in Configuring the Administrator Account.

Tip:

For more information about starting the Administration Server, see Starting and Stopping Administration Servers in Oracle Fusion Middleware Administering Oracle Fusion Middleware.

In production mode, you can create a boot identity file to bypass the need to enter credentials when starting the Administration Server. See Creating a Boot Identity File for an Administration Server in Oracle Fusion Middleware Administering Server Startup and Shutdown for Oracle WebLogic Server.

To verify that the Administration Server is up and running, open the Administration Server Console. The URL is on the Configuration Success screen in Writing Down Your Domain Name and Administration Server URL.

Note:

Make sure that the database hosting your product schemas is up and running and accessible by the Administration Server.

http://administration_server_host:administration_server_port/console

The default Administration Server port number is 7001.

For more information about using the Administration Console, see Getting Started Using Oracle WebLogic Server Administration Console in Oracle Fusion Middleware Administering Oracle Fusion Middleware.

3.3.3 Starting Managed Servers

You start the Managed Servers from Oracle Fusion Middleware Control.

To start Managed Servers:

  1. Log in to Oracle Fusion Middleware Control:
    http://administration_server_host:administration_server_port/em
    

    The Administration Server host and port number were in the URL on the Configuration Success screen (Writing Down Your Domain Name and Administration Server URL). The default Administration Server port number is 7001.

    You specified login credentials on the Administrator Account screen (Specifying a Custom Prefix and Selecting Schemas).

  2. From the Target Navigation pane, click the arrows to expand the domain until you see Managed Servers (infra_server_1 and infra_server_2).
  3. Select the first Managed Server (infra_server_1).
  4. Next to the WebLogic Server menu, select Start Up.
  5. Repeat Steps 3 and 4 to start infra_server_2.
  6. In the Target Navigation page, select your domain name to see that all servers are up and running.

Tip:

For more information about managing Oracle Fusion Middleware using Oracle Enterprise Manager Fusion Middleware Control, see Manage Infrastructure in Administering Oracle Fusion Middleware with Fusion Middleware Control .

3.4 Verifying Your Configuration

Oracle recommends that you verify that your domain is configured properly.

See Basic Administrative Tasks for a New Domain to verify your configuration. Familiarize yourself with tasks that this topic describes and run them.