4 Configuring Fusion Middleware Domains

The Configuration Wizard helps you install and configure the WebLogic Server in which other Fusion Middleware products are also installed in the same Oracle home.

This chapter includes the following sections:

Creating a WebLogic Domain for Fusion Middleware Products

The Configuration Wizard takes you through a series of screens that help you create a WebLogic Server domain. Additional screens appear depending on the components that you add for the domain, and on other factors.

To create a new WebLogic domain that includes Fusion Middleware products installed with WebLogic Server, start the Configuration Wizard as described in Starting the Configuration Wizard.

Note:

In situations where you cannot run the Configuration Wizard in GUI mode, Oracle recommends that you use a WLST script to create or extend a domain. See Creating and Using a Domain Template (Offline) in Understanding the WebLogic Scripting Tool.

The Configuration Wizard screens appear in a sequence, in the order listed in Table 4-1. For more information on each screen, refer to the related section in Configuration Wizard Screens, or click the link in the Screen column.

Table 4-1 Configuration Screens for Creating a New WebLogic Domain

Screen When Does This Screen Appear? Perform the Following Action

Configuration Type - No Profiles

When CONFIG_JVM_ARGS is not set to display domain profile options

Select Create a new domain.

In the Domain Location box, enter the path to the new domain, or click Browse to create the domain directory.

Click Next.

Configuration Type - Profiles

When CONFIG_JVM_ARGS is set to -Dcom.oracle.cie.config.showProfile=true

Select Create a new expanded domain or Create a new compact domain as appropriate.

In the Domain Location box, enter the path to the new domain, or click Browse to create the domain directory.

Click Next.

Templates

Always

Do one of the following:

  • Select Create Domain Using Product Templates, and then select the check box for each product to include in the domain.

  • Select Create Domain Using Custom Template, and then click Browse to locate the template on your local drive or network.

Click Next.

High Availability Options

Only if the templates that you have selected in the Templates screen are configured for high availability.

You can configure the following HA options:
  • Select Enable Automatic Service Migration to automatically migrate services from an unhealthy hosting server to a healthy active server. You can choose high-availability database leasing or non-database consensus leasing for migration.

    See Leasing and Service Migration in Administering Clusters for Oracle WebLogic Server.

  • Select the persistence type for Java Transaction API (JTA). You can choose to persist transaction logs (Tlogs) in a database or in a file-based store.

    See Using the Default Persistent Store in Administering Server Environments for Oracle WebLogic Server

  • Select the persistence type for JMS servers. You can use either a file store or a JDBC store.

    See JMS and JTA High Availability in High Availability Guide.

Click Next.

Application Location

Only if one or more of the selected templates define an application

Specify the directory in which the domain applications have to be stored.

Click Next.

Administrator Account

Always

Specify the username and password for the administrator account of the domain.

Click Next.

Domain Mode and JDK

Always

Select the startup mode to use.

Select the JDK to use in the domain or click Browse to navigate to the JDK you want to use.

Click Next.

Database Configuration Type

Only if the domain includes components that require the use of the Oracle Fusion Middleware Repository Creation Utility (RCU) to load database schemas

Select whether you want to use RCU parameters for schema configuration, or you want to configure the schemas manually.

If you elect to use RCU parameters, complete the fields on the screen and click Get RCU Configuration.

Click Next.

Schema configuration

Only if the domain includes components that require the use of the Oracle Fusion Middleware Repository Creation Utility (RCU) to load database schemas

See Configuring Schemas for information about these screens.

Data source configuration

Only if the domain includes components that require JDBC data sources or Oracle RAC multi-data sources

See Configuring Data Sources for information about these screens.

Credentials

Only when a selected template requires user provided credentials

Specify the username and password for each security store or key.

Click Next.

Keystore

Only when a selected template requires user provided key pairs or certificates

Select the security store/key to configure.

In the top table, enter the path for the trusted certificate to use.

In the bottom table, enter the path for the private key and the password for the private key.

Repeat for each store or key.

When done, click Next.

Java Keystore Info

Only when a selected template requires importing key pairs or certificates from a .jks file

Select the Java keystore (JKS) file location, keystore password, target keystore password, and other details to configure the JAVA keystore for importing into the target keystore. Define additional certificates and keys, if necessary.

Click Next.

Advanced Configuration

Always

Select the check box for each category (if any) for which you want to perform advanced configuration tasks

The available check boxes depend on the resources that are configured in the selected products or template.

Click Next.

Administration Server

Only if you have selected Administration Server on the Select Advanced Configuration screen

Change the settings for the Administration Server as needed.

Click Next.

Node Manager

Only if you have selected Node Manager on the Select Advanced Configuration screen

Select the Node Manager Type.

Enter the username and password for accessing the Node Manager.

Click Next.

Managed Servers

Only if you have selected Managed Servers, Clusters, and Coherence on the Select Advanced Configuration screen

Add, delete, clone, or reconfigure Managed Servers as needed.

Click Next.

Clusters

Only if you have selected Managed Servers, Clusters, and Coherence on the Select Advanced Configuration screen

Add, delete, or reconfigure clusters as needed.

Click Next.

Assign Servers to Clusters

Only if you have selected Managed Servers, Clusters, and Coherence on the Select Advanced Configuration screen, and your domain includes at least one cluster

Add servers to or remove servers from the clusters in your domain.

Click Next.

HTTP Proxy Applications

Only if you have selected Managed Servers, Clusters, and Coherence on the Select Advanced Configuration screen, and your domain includes at least one cluster, and at least one Managed Server that is not assigned to a cluster

For each cluster, specify whether you want to create an HTTP proxy application for the cluster. If you select the Create HTTP Proxy check box for a cluster, select the proxy server to use for that cluster.

Click Next.

Coherence Clusters

Only if you have selected Managed Servers, Clusters, and Coherence on the Advanced Configuration screen, and Coherence is installed with WebLogic Server

Accept the default cluster name or type a new name for the Coherence cluster.

Enter the port number to use as the Coherence cluster listen port.

Click Next.

Machines

Only if you have selected Managed Servers, Clusters, and Coherence on the Advanced Configuration screen

Select the Machine tab (Windows) or Unix Machine tab (UNIX).

Add machines as needed.

Configure the settings for each machine.

Click Next.

Assign Servers to Machines

Only if you have selected Managed Servers, Clusters, and Coherence on the Select Advanced Configuration screen, and there is at least one machine configured in the domain

Assign the Administration Server and Managed Servers to the appropriate machines.

Click Next.

Virtual Targets

Only if you have selected Topology on the Advanced Configuration screen

Add, configure, and delete virtual targets that you want to use to run WebLogic Server in a multitenant mode.

For an overview of multitenancy in Oracle WebLogic Server, see Oracle WebLogic Server Multitenant in Using Oracle WebLogic Server Multitenant.

For a definition of virtual targets, see Virtual Targets in Using Oracle WebLogic Server Multitenant.

Click Next.

Partitions

Only if you have selected Topology on the Advanced Configuration screen

Add the required number of partitions. Later, you have to assign virtual targets to each partition that you define.

For more information about virtual targets and partitions, see Configuring Virtual Targets: Overview and Configuring Domain Partitions: Overview in Using Oracle WebLogic Server Multitenant.

Click Next.

Assign Virtual Targets to Partitions

Only if you have defined virtual targets and partitions for the domain being configured

Associate a virtual target to a partition. A partition can have zero or more virtual targets.

Click Next.

Domain Frontend Host

Only if you have selected Domain Frontend Host Capture on the Advanced Configuration screen

Enable or disable the frontend host and, if enabled, specify or update the configuration for the frontend host.

Click Next.

System Components

Only if a system component, such as OHS or OID, is installed

Click Add to add system components to the domain.

Configure each system component.

Click Next.

OHS Server

Only if OHS is installed

Select an OHS server to configure.

Specify the settings for that server.

Repeat for each server.

Click Next.

ODI Server Configuration

Only if ODI is installed

Select the ODI server to configure.

Specify the settings for that server.

Repeat for each server.

Click Next.

ODI Server Configuration

Only if ODI is installed

Select an ODI server to configure.

Specify the settings for that server.

Repeat for each server.

Click Next.

Assign System Components to Machines

Only if a system component, such as OHS or OID, is installed

Assign the system component servers to the appropriate machines.

Click Next.

Deployments Targeting

Only if you have selected Deployments and Services on the Select Advanced Configuration screen, and a selected product or template contains J2EE applications or libraries

Select the target server or cluster on which you want to deploy applications or libraries.

Select the check box for each application or library you want to deploy on the selected target.

Note:

When you create a restricted JRF domain by using the config.cmd or config.sh command, you must target the Enterprise Manager (EM) related libraries to the cluster to access the Enterprise Manager Console.

Click Next.

Services Targeting

Only if you have selected Deployments and Services on the Select Advanced Configuration screen

Select the target server or cluster.

Select the check box for each service you want to target to it.

Click Next.

File Stores

Only if you have selected File Store on the Select Advanced Configuration screen

Change the settings for each JMS file store as needed, and select the synchronous write policy for each file store.

Click Next.

Configuration Summary

Always

Review the configuration for your domain by selecting a Summary View, and then selecting individual items in the list for that view.

If the domain is configured as you want it, click Create to create the domain.

To modify the configurations, click Previous to return to the appropriate screen for the settings you want to change.

Configuration Progress

Always

Shows the progress of the domain creation.

When the process completes, click Next.

Configuration Success

Always

Review the domain creation results.

Click Finish to exit the Configuration Wizard.

Note:

WebLogic Server Multitenant domain partitions and virtual targets are deprecated in WebLogic Server 12.2.1.4 and will be removed in the next release.

Configuring Schemas

The schema configuration screens appear in the Configuration Wizard only if the domain includes components that require the use of the Oracle Fusion Middleware Repository Creation Utility (RCU) to load database schemas.

Table 4-2 lists the sequences of schema-related screens. For more information on each screen, refer to the related section in Configuration Wizard Screens, or click the link in the Screen column.

Table 4-2 Schema Configuration Screens

Screen When Does This Screen Appear? Perform the Following Action

Database Configuration Type

Only if the domain includes components that require the use of the Oracle Fusion Middleware Repository Creation Utility (RCU) to load database schemas

Enter connection information to connect to the database server from which service table information is to be retrieved.

Click Next to continue.

JDBC Component Schema

Only if the domain includes components that require the use of the Oracle Fusion Middleware Repository Creation Utility (RCU) to load database schemas

There are two versions of this screen, depending on whether the selected templates contain multi-data source definitions or GridLink data source definitions

Configure the schema owner and password for each component schema listed on this screen. Changes to any of the fields on this screen are applied to all selected component schemas in the table.

For example, if all your schemas reside on the same database, select all the schemas in the table, then specify the appropriate database values for the schemas (DBMS/Service, Host Name, and Port).

If, for example, you have a different password for each schema, you must select each schema individually and specify the password for the selected schema.

Click Next to continue.

GridLink Oracle RAC Component Schema

Only if the domain includes components that require the use of the Oracle Fusion Middleware Repository Creation Utility (RCU) to load database schemas, and you selected the Convert to GridLink option

Configure the schema owner and password for each component schema listed on this screen. Changes to any of the fields on this screen are applied to all selected component schemas in the table.

For example, if all your schemas reside on the same database, select all the schemas in the table, then specify the appropriate database values for the schemas (including Service Name, Service Instance, ONS Host, wallet file, and wallet password).

If, for example, you have a different password for each schema, you must select each schema individually and specify the password for the selected schema.

Click Next to continue.

Oracle RAC Multi Data Source Component Schema

Only if the domain includes components that require the use of the Oracle Fusion Middleware Repository Creation Utility (RCU) to load database schemas, and you selected the Convert to RAC multi-data source option

Configure the schema owner and password for each component schema listed on this screen. Changes to any of the fields on this screen are applied to all selected component schemas in the table.

For example, if all your schemas reside on the same database, select all the schemas in the table, then specify the appropriate database values for the schemas (Service Name, Host Name, Instance Name, and Port).

If, for example, you have a different password for each schema, you must select each schema individually and specify the password for the selected schema.

Click Next to continue.

JDBC Component Schema Test

Only if the domain includes components that require the use of the Oracle Fusion Middleware Repository Creation Utility (RCU) to load database schema

Test the configurations that you specified for the data sources in the previous screen.

Click Next to continue.

After you configure the screens described in this section, return to Table 4-1 to continue with the sequence.

Configuring Data Sources

The data source configuration screens appear in the Configuration Wizard only if the domain includes components that require JDBC data sources or Oracle RAC multi-data sources.

Table 4-3 lists the sequences of schema-related screens. For more information on each screen, refer to the related section in Configuration Wizard Screens, or click the link in the Screen column.

Table 4-3 Data Source Configuration Screens

Screen When Does This Screen Appear? Perform the Following Action

JDBC Data Sources

Only if the domain includes components that require JDBC data sources

Select a data source to configure, and then do one of the following:

  • Configure the fields for the data source

  • Select the Configure selected data sources as RAC multi-data sources option

Click Next to continue.

GridLink Oracle RAC Data Sources

Only if the domain includes components that require JDBC data sources, and you selected the Convert to GridLink option for at least one data source on the Configure JDBC Data Source screen

Configure the fields for the Gridlink RAC data source, including the Service Name, Service Instance, ONS Host, wallet file, and wallet password.

Click Next to continue.

Oracle RAC Multi Data Sources

Only if the domain includes components that require JDBC data sources, and you selected the Convert to RAC multi-data source option for at least one data source on the Configure JDBC Data Source screen

Configure the fields for the Oracle RAC multi-data source, including the Oracle RAC host name, instance name, and port.

Click Next to continue.

JDBC Data Sources Test

Only if the domain includes components that require JDBC data sources

Select the data sources to test, and click Test Connection. Wait for one or more connection tests to complete.

Note:

In order to test connections, the database to which you are trying to connect must be running.

If you do not want to test connections, deselect all data sources.

Click Next to continue.

Database Scripts

Only if the selected products or template includes a set of SQL files organized by database type

Select the data sources for which you want to run the database scripts.

Select the database version.

Click Run Scripts.

After you run the necessary scripts, click Next to continue.

Updating a WebLogic Domain That Includes Fusion Middleware Products

The Configuration Wizard takes you through a series of screens that help you update the domain.

To update the domain, start the Configuration Wizard as described in Starting the Configuration Wizard.

Note:

In situations where you cannot run the Configuration Wizard in GUI mode, Oracle recommends that you use a WLST script to create or extend a domain. See Creating and Using a Domain Template (Offline) in Understanding the WebLogic Scripting Tool.

The Configuration Wizard displays a sequence of screens, in the order listed in Table 4-4. For more information on each screen, refer to the related section in Configuration Wizard Screens, or click the link in the Screen column.

Table 4-4 Configuration Screens for Updating an Existing WebLogic Domain

Screen When Does This Screen Appear? Perform the Following Action

Configuration Type

Always

Select Update an Existing Domain.

Select the domain directory from the Existing Domain Directory drop-down list, or click Browse to navigate to and select the domain directory.

Click Next to continue.

Templates

Always

Do one of the following:

  • Select Update Domain Using Product Templates, and then select the check box for each product to add to the domain.

  • Select Update Domain Using Custom Template, and then click Browse to locate the template on your local drive or network.

Click Next to continue.

High Availability Options

Only if the templates that you have selected in the Templates screen are configured for high availability.

At the time of updating a domain, this screen appears only if new templates are introduced and you have not configured the HA options for those templates. For example, if the new templates that you use to update the domain contain the “Automatic Service Migration (ASM)” parameter, and you have not defined the ASM parameter in the existing, the screen appears.

Select the applicable HA options for the domain you are updating.

Click Next.

Application Location

Only if one or more of the selected templates define an application

Specify the directory in which the domain applications have to be stored.

Click Next to continue.

Database Configuration Type

Only if the domain includes components that require the use of the Oracle Fusion Middleware Repository Creation Utility (RCU) to load database schemas

Select whether you want to use RCU parameters for schema configuration, or you want to configure the schemas manually.

If you elect to use RCU parameters, complete the fields on the screen and click Get Defaults.

Click Next.

Schema Configuration

Only if the selected products or template includes components that require the use of the Oracle Fusion Middleware Repository Creation Utility (RCU) to load database schemas

See Configuring Schemas for information about these screens.

Data Source Configuration

Only if the selected products or template includes components that require JDBC data sources or Oracle RAC multi-data sources

See Configuring Data Sources for information about these screens.

Credentials

Only when a selected template requires user provided credentials.

Specify the username and password for each security store or key.

Click Next.

Keystore

Only when a selected template requires user provided key pairs or certificates.

Select the security store or key to configure.

In the top table, enter the path for the trusted certificate to use.

In the bottom table, enter the path for private key and the password for the private key.

Repeat for each store or key.

When done, click Next.

Java Keystore Info

Only when a selected template requires importing key pairs or certificates from a .jks file.

Select the Java keystore (JKS) file location, keystore password, target keystore password, and other details to configure the JAVA keystore for importing into the WebLogic domain. Define additional certificates and keys, if necessary.

Click Next.

Advanced Configuration

Always

Select the check box for each category (if any) for which you want to perform advanced configuration tasks

The available check boxes depend on the resources that are configured in the selected products or template.

Note: When you extend a domain, you cannot change the Administration Server and Node Manager configurations. Therefore, these options are not available.

Click Next.

Managed Servers

Only if you have selected Managed Servers, Clusters, and Coherence on the Select Advanced Configuration screen

Add, delete, or reconfigure Managed Servers as needed.

Click Next.

Clusters

Only if you have selected Managed Servers, Clusters, and Coherence on the Select Advanced Configuration screen

Add, delete, or reconfigure clusters as needed.

Click Next.

Assign Servers to Clusters

Only if you have selected Managed Servers, Clusters, and Coherence on the Select Advanced Configuration screen, and your domain includes at least one cluster

Add servers to or remove servers from the clusters in your domain.

Click Next.

HTTP Proxy Applications

Only if you have selected Managed Servers, Clusters, and Coherence on the Select Advanced Configuration screen, and your domain includes at least one cluster, and at least one Managed Server that is not assigned to a cluster

For each cluster, specify whether you want to create an HTTP proxy application for the cluster. If you select the Create HTTP Proxy check box for a cluster, select the proxy server to use for that cluster.

Click Next to continue.

Machines

Only if you have selected Managed Servers, Clusters, and Coherence on the Select Advanced Configuration screen

Add, delete, or reconfigure machines as needed.

Click Next.

Domain Frontend Host

Only if you selected Domain Frontend Host Capture on the Advanced Configuration screen

Enable or disable the frontend host and, if enabled, specify or update the configuration for the frontend host.

Click Next.

Assign Servers to Machines

Only if you have selected Managed Servers, Clusters, and Coherence on the Select Advanced Configuration screen, and there is at least on machine configured in the domain

Assign the Administration Server and Managed Servers to the appropriate machines.

Click Next.

System Components

Only if a system component, such as OHS, is installed

Click Add to add system components to the domain.

Configure each system component.

Click Next.

OHS Server

Only if OHS is installed

Select a system component to configure.

Specify the settings for that component.

Click Next.

ODI Server Configuration

Only if ODI is installed

Select the ODI server to configure.

Specify the settings for that server.

Repeat for each server.

Click Next.

Assign System Components to Machines

Only if a system component, such as OHS, is installed

Assign the system component servers to the appropriate machines.

Click Next.

Deployments Targeting

Only if you have selected Deployments and Services on the Select Optional Configuration screen, and a selected product or template contains J2EE applications or libraries

Select the target server or cluster on which you want to deploy applications or libraries.

Select the check box for each application or library you want to deploy on the selected target.

Click Next.

Services Targeting

Only if you have selected Deployments and Services on the Select Optional Configuration screen

Select the target server or cluster.

Select the check box for each service you want to target to it.

Click Next.

Files Stores

Only if you have selected JMS File Store on the Select Optional Configuration screen

Change the settings for each JMS file store as needed, and select the synchronous write policy for each file store.

Click Next.

Configuration Summary

Always

Review the configuration for your domain by selecting a Summary View, and then selecting individual items in the list for that view.

If the domain is configured as you want it, click Update to extend the domain.

To modify the configurations, click Previous to return to the appropriate screen for the settings you want to change.

Configuration Progress

Always

Shows the progress of the domain creation.

When the process completes, click Next.

Configuration Success

Always

Click Finish to exit the Configuration Wizard.