17 Extending the Domain to Include WebCenter Content User Interface
You need to perform certain tasks in order to extend the enterprise deployment domain to include Oracle WebCenter Content User Interface software.
This chapter provides information on modifying system-level setting through MBeans and configuring http server with the WebCenter Content user interface cluster.
- Extending the Domain for WebCenter Content User Interface
The instructions for extending the existing enterprise deployment domain with the Oracle WebCenter Content user interface software are detailed in this section. - Propagating the Domain Configuration to WLS_WCCUI1 and WLS_WCCUI2
You need to perform the following steps in order to propagate the domain configuration to the WebCenter Content user interface Managed Servers. - Modifying System-Level Settings Through MBeans
To ensure high availability, modify system-level configuration settings for WebCenter Content user interface through the System Configuration page in Fusion Middleware Control. The settings on this page configure the WebCenter Content user interface MBeans for the domain. - Configuring Oracle HTTP Server with the WebCenter Content User Interface Cluster
Configure Oracle HTTP Server with the WebCenter Content User Interface Cluster, set the front-end HTTP Host and Port for the cluster, and validate access through the load balancer. - Completing the Workflow Configuration
To complete the workflow configuration for the WebCenter Content user interface, you need to restart the Managed Servers and verify the configuration. TheUseDatabaseWfInQueue
configuration variable enables the WebCenter Content user interface to filter workflows assigned to a user. TheEmailNotificationType
configuration variable specifies where the links in notification emails point for workflows and subscriptions in different Content Server user interfaces, and its default value isNativeWebUI
.
Parent topic: Configuring the Enterprise Deployment
Extending the Domain for WebCenter Content User Interface
The instructions for extending the existing enterprise deployment domain with the Oracle WebCenter Content user interface software are detailed in this section.
Extending the domain involves the following tasks.
- Starting the Configuration Wizard
Start the Configuration Wizard as the first step to extend the existing enterprise deployment domain. - Navigating the Configuration Wizard Screens to Extend the Domain
Starting the Configuration Wizard
Start the Configuration Wizard as the first step to extend the existing enterprise deployment domain.
Note:
If you added any customizations directly to the start scripts in the domain, those are overwritten by the configuration wizard. To customize server startup parameters that apply to all servers in a domain, you can create a file called setUserOverridesLate.sh
and configure it, for example, add custom libraries to the WebLogic Server classpath, specify Additional JAVA command line options for running the servers, or specify additional environment variables. Any customizations you add to this file are preserved during domain upgrade operations, and are carried over to remote servers when using the pack
and unpack
commands.
To start the Configuration Wizard:
Navigating the Configuration Wizard Screens to Extend the Domain
Follow the instructions in the following sections to create and configure the domain for the topology with static or dynamic clusters.
Extending the Domain with Static Clusters
Follow the instructions in this section to create and configure the domain for the topology.
Note:
You can use the same procedure described in this section to extend an existing domain. If your needs do not match the instructions given in the procedure, be sure to make your selections accordingly, or refer to the supporting documentation for additional details.
Domain creation and configuration includes the following tasks:
-
Task 1, "Selecting the Domain Type and Domain Home Location"
-
Task 4, "Providing the GridLink Oracle RAC Data Sources Details"
-
Task 6, "Providing the GridLink Oracle RAC Component Schema Details"
-
Task 22, "Reviewing Your Configuration Specifications and Configuring the Domain"
-
Task 23, "Writing Down Your Domain Home and Administration Server URL"
- Task 1 Selecting the Domain Type and Domain Home Location
-
On the Configuration Type screen, select Update an existing domain.
In the Domain Location field, select the value of the
ASERVER_HOME
variable, which represents the complete path to the Administration Server domain home you created in Creating the Initial Infrastructure Domain for an Enterprise Deployment.For more information about the directory location variables, see File System and Directory Variables Used in This Guide.
Tip:
More information about the other options on this screen can be found in Configuration Type in Creating WebLogic Domains Using the Configuration Wizard.
- Task 2 Selecting the Configuration Template
-
On the Templates screen, make sure Update Domain Using Product Templates is selected, then select the following templates:
-
Oracle WebCenter Content - Web UI - 12.2.1.3.0 [wccontent]
In addition, the following additional templates should already be selected, because they were used to create the initial domain:
-
Oracle Universal Content Mnagement - Content Server - 12.2.1.3.0 [wccontent]
-
Oracle SOA Suite - 12.2.1.3.0 [soa]
-
Oracle Universal Content Management - Inbound Refinery - 12.2.1.3.0 [wccontent]
-
Oracle WebCenter Enterprise Capture - 12.2.1.3.0 [wccapture]
-
Oracle Enterprise Manager - 12.2.1.3.0 [em]
-
Oracle WSM Policy Manager - 12.2.1.3.0 [oracle_common]
-
Oracle JRF - 12.2.1.3.0 [oracle_common]
-
WebLogic Coherence Cluster Extension - 12.2.1.3.0 [wlserver]
-
Tip:
More information about the options on this screen can be found in Templates in Creating WebLogic Domains Using the Configuration Wizard.
-
- Task 3 Specifying JDBC Data Sources Information
-
Click Convert to GridLink, update the required database details, and then click Next.
- Task 4 Providing the GridLink Oracle RAC Data Sources Details
-
On the GridLink Oracle RAC Data Sources screen, perform the following tasks.
In the SCAN, Host Name, and Port section:
-
Select the SCAN check box.
-
In the Host Name field, enter the Single Client Access Name (SCAN) Address for the Oracle RAC database.
-
In the Port field, enter the SCAN listening port for the database (for example,
1521
).
In the ONS Host and Port section:
-
In the ONS Host field, enter the SCAN address for the Oracle RAC database.
-
In the Port field, enter the ONS Remote port (typically,
6200
).
Click Next.
-
- Task 5 Testing the JDBC Data Sources
-
Click Next to continue.
- Task 6 Providing the GridLink Oracle RAC Component Schema Details
-
Click Next to continue.
- Task 7 Testing the JDBC Component Schema
-
Click Next to continue.
- Task 8 Specifying Credentials for wccadfConnectUser
-
On the Credentials screen, enter the WebLogic user name(not
weblogic_wcc
) and password.Click Next to continue.
- Task 9 Selecting Advanced Configuration
-
To complete domain configuration for the topology, select the following options on the Advanced Configuration screen:
Topology
- Task 10 Configuring Managed Servers
-
On the Managed Servers screen, a new Managed Server appears in the list of servers.
Perform the following tasks to modify the default Managed Server and create a second Managed Server:
-
Rename the default Managed Server to
WLS_WCCUI1
. -
Click Add to create a new Managed Server and name it
WLS_WCCUI2
.Tip:
The server names recommended here will be used throughout this document; if you choose different names, be sure to replace them as needed.
-
Use the following table to fill in the rest of the columns for each Oracle WebCenter Content user interface Managed Server.
Tip:
More information about the options on the Managed Server screen can be found in Managed Servers in Creating WebLogic Domains Using the Configuration Wizard.
Server Name Listen Address Listen Port Enable SSL SSL Listen Port Server Groups WLS_WCCUI1
WCCHOST1
16225
No
Disabled
UCM-ADF-MGD-SVR
WLS_WCCUI2
WCCHOST2
16225
No
Disabled
UCM-ADF-MGD-SVR
-
- Task 11 Configuring a Cluster
-
In this task, you create a cluster of Managed Servers to which you can target the Oracle WebCenter Content software.
You will also set the Frontend Host property for the cluster, which ensures that, when necessary, WebLogic Server will redirect Web services callbacks and other redirects to
wcc.example.com
on the load balancer rather than the address in the HOST header of each request.For more information about the
wcc.example.com
virtual server address, see Configuring Virtual Hosts on the Hardware Load Balancer.Use the Clusters screen to create a new cluster:
-
Click the Add button.
-
Specify
WCCUI_Cluster
in the Cluster Name field. -
From the Dynamic Server Groups drop-down list, select
Unspecified
.
Note:
By default, server instances in a cluster communicate with one another using unicast. If you want to change your cluster communications to use multicast, refer to "Considerations for Choosing Unicast or Multicast" in Administering Clusters for Oracle WebLogic Server.
Tip:
More information about the options on this screen can be found in Clusters in Creating WebLogic Domains Using the Configuration Wizard.
-
- Task 12 Assigning Server Templates
-
Click Next to proceed to the next screen.
- Task 13 Configuring Dynamic Servers
-
Verify that all dynamic server options are disabled for clusters that are to remain as static clusters.
-
Confirm that the Dynamic Cluster, Calculated Listen Port, and Calculated Machine Names checkboxes on this screen are unchecked.
-
Confirm the Server Template selection is Unspecified.
-
Click Next.
-
- Task 14 Assigning Managed Servers to the Cluster
-
Use the Assign Servers to Clusters screen to assign
WLS_WCCUI1
andWLS_WCCUI2
to the new cluster,WCCUI_Cluster
:-
In the Clusters pane, select the cluster to which you want to assign the servers; in this case,
WCCUI_Cluster
. -
In the Servers pane, assign WLS_WCCUI1 to
WCCUI_Cluster
by doing one of the following:-
Click the
WLS_WCCUI1
Managed Server once to select it, then click on the right arrow to move it beneath the selected cluster in the Clusters pane. -
Double-click
WLS_WCCUI1
to move it beneath the selected cluster in the clusters pane.
-
-
Repeat to assign
WLS_WCCUI2
toWCCUI_Cluster
.
Tip:
More information about the options on this screen can be found in Assign Servers to Clusters in Creating WebLogic Domains Using the Configuration Wizard.
-
- Task 15 Configuring Coherence Clusters
-
Use the Coherence Clusters screen to configure the Coherence cluster that is automatically added to the domain. Leave the port number value at
0
, as it was defined during the initial Infrastructure domain creation.Note:
For Coherence licensing information, refer to Oracle Coherence in Oracle Fusion Middleware Licensing Information.
- Task 16 Verifying the Existing Machines
-
Under the Unix Machine tab, verify the names of the machines you created when creating the initial Infrastructure domain.
Click Next to proceed.
- Task 17 Assigning Servers to Machines
-
Use the Assign Servers to Machines screen to assign the Oracle WebCenter Content user interface Managed Servers you just created to the corresponding machines in the domain.
Assign
WLS_WCCUI1
toWCCHOST1
, and assignWLS_WCCUI2
toWCCHOST2
.Tip:
More information about the options on this screen can be found in Assign Servers to Machines in Creating WebLogic Domains Using the Configuration Wizard.
- Task 18 Configuring Virtual Targets
-
Click Next to proceed to the next screen.
- Task 19 Configuring Partitions
-
Click Next to proceed to the next screen.
- Task 20 Reviewing Configuration Summary
-
Click Update to proceed to the next screen.
- Task 21 Reviewing Configuration Progress
-
After all the processes are complete, click Next to proceed to the next screen.
- Task 22 Reviewing Your Configuration Specifications and Configuring the Domain
-
The Configuration Summary screen contains the detailed configuration information for the domain you are about to create. Review the details of each item on the screen and verify that the information is correct.
You can go back to any previous screen if you need to make any changes, either by using the Back button or by selecting the screen in the navigation pane.
Domain creation will not begin until you click Update.
Tip:
More information about the options on this screen can be found in Configuration Summary in Creating WebLogic Domains Using the Configuration Wizard.
- Task 23 Writing Down Your Domain Home and Administration Server URL
-
The Configuration Success screen will show the following items about the domain you just configured:
-
Domain Location
-
Administration Server URL
You must make a note of both items as you will need them later; the domain location is needed to access the scripts used to start the Node Manager and Administration Server, and the URL is needed to access the Administration Server.
Click Finish to dismiss the configuration wizard.
-
- Task 24 Start the Administration Server
-
Start the Administration Server to ensure the changes you have made to the domain have been applied.
After you have completed extending the domain with static clusters, go to Propagating the Domain Configuration to WLS_WCCUI1 and WLS_WCCUI2.
Extending the Domain with Dynamic Clusters
Follow the instructions in this section to create and configure the domain for the topology with Dynamic Clusters.
Note:
You can use the same procedure described in this section to extend an existing domain with Dynamic Clusters. If your needs do not match the instructions given in the procedure, be sure to make your selections accordingly, or refer to the supporting documentation for additional details.
Domain creation and configuration includes the following tasks:
-
Task 1, "Selecting the Domain Type and Domain Home Location"
-
Task 4, "Providing the GridLink Oracle RAC Data Sources Details"
-
Task 6, "Providing the GridLink Oracle RAC Component Schema Details"
-
Task 22, "Reviewing Your Configuration Specifications and Configuring the Domain"
-
Task 23, "Writing Down Your Domain Home and Administration Server URL"
- Task 1 Selecting the Domain Type and Domain Home Location
-
On the Configuration Type screen, select Update an existing domain.
In the Domain Location field, select the value of the
ASERVER_HOME
variable, which represents the complete path to the Administration Server domain home you created in Creating the Initial Infrastructure Domain for an Enterprise Deployment.For more information about the directory location variables, see File System and Directory Variables Used in This Guide.
Tip:
More information about the other options on this screen can be found in Configuration Type in Creating WebLogic Domains Using the Configuration Wizard.
- Task 2 Selecting the Configuration Template
-
On the Templates screen, make sure Update Domain Using Product Templates is selected, then select the following templates:
-
Oracle WebCenter Content - Web UI - 12.2.1.3.0 [wccontent]
In addition, the following additional templates should already be selected, because they were used to create the initial domain:
-
Oracle Universal Content Mnagement - Content Server - 12.2.1.3.0 [wccontent]
-
Oracle SOA Suite - 12.2.1.3.0 [soa]
-
Oracle Universal Content Management - Inbound Refinery - 12.2.1.3.0 [wccontent]
-
Oracle WebCenter Enterprise Capture - 12.2.1.3.0 [wccapture]
-
Oracle Enterprise Manager - 12.2.1.3.0 [em]
-
Oracle WSM Policy Manager - 12.2.1.3.0 [oracle_common]
-
Oracle JRF - 12.2.1.3.0 [oracle_common]
-
WebLogic Coherence Cluster Extension - 12.2.1.3.0 [wlserver]
-
Tip:
More information about the options on this screen can be found in Templates in Creating WebLogic Domains Using the Configuration Wizard.
-
- Task 3 Specifying JDBC Data Sources Information
-
Click Convert to GridLink, update the required database details, and then click Next.
- Task 4 Providing the GridLink Oracle RAC Data Sources Details
-
On the GridLink Oracle RAC Data Sources screen, perform the following tasks.
In the SCAN, Host Name, and Port section:
-
Select the SCAN check box.
-
In the Host Name field, enter the Single Client Access Name (SCAN) Address for the Oracle RAC database.
-
In the Port field, enter the SCAN listening port for the database (for example,
1521
).
In the ONS Host and Port section:
-
In the ONS Host field, enter the SCAN address for the Oracle RAC database.
-
In the Port field, enter the ONS Remote port (typically,
6200
).
Click Next.
-
- Task 5 Testing the JDBC Data Sources
-
Click Next to continue.
- Task 6 Providing the GridLink Oracle RAC Component Schema Details
-
Click Next to continue.
- Task 7 Testing the JDBC Component Schema
-
Click Next to continue.
- Task 8 Specifying Credentials for wccadfConnectUser
-
On the Credentials screen, enter the WebLogic user name (not
weblogic_wcc
) and password.Click Next to continue.
- Task 9 Selecting Advanced Configuration
-
To complete domain configuration for the topology, select the following options on the Advanced Configuration screen:
Topology
- Task 10 Configuring Managed Servers
-
On the Managed Servers screen, a new Managed Server appears in the list of servers.
Perform the following tasks to modify the default Managed Server and create a second Managed Server:
-
Delete the default Managed Server.
-
Click Next to proceed to the next screen.
-
- Task 11 Configuring a Cluster
-
In this task, you create a cluster of Managed Servers to which you can target the Oracle WebCenter Content software.
You will also set the Frontend Host property for the cluster, which ensures that, when necessary, WebLogic Server will redirect Web services callbacks and other redirects to
wcc.example.com
on the load balancer rather than the address in the HOST header of each request.For more information about the
wcc.example.com
virtual server address, see Configuring Virtual Hosts on the Hardware Load Balancer.Use the Clusters screen to create a new cluster:
-
Click the Add button.
-
Specify
WCCUI_Cluster
in the Cluster Name field. -
From the Dynamic Server Groups drop-down list, select WCCADF-DYN-CLUSTER.
Note:
By default, server instances in a cluster communicate with one another using unicast. If you want to change your cluster communications to use multicast, refer to "Considerations for Choosing Unicast or Multicast" in Administering Clusters for Oracle WebLogic Server.
Tip:
More information about the options on this screen can be found in Clusters in Creating WebLogic Domains Using the Configuration Wizard.
-
- Task 12 Assigning Server Templates
-
Use the Server Templates screen to add a template:
-
Specify
WCCADF-server-template
in the Name field. -
Specify
16225
in the Listen Port field. -
Leave the Enable SSL option unchecked.
-
From the Cluster drop-down list, select
Unspecified
. -
Click Next to proceed to the next screen.
-
- Task 13 Configuring Dynamic Servers
-
Use the Dynamic Clusters screen to configure the required clusters:
-
Specify
WCCUI_Cluster
in the Cluster Name field. -
Specify
WLS_WCCUI
in the Server Name Prefix field. -
From the Server Template drop-down list, select
WCCADF-server-template
. -
Specify
2
in the Maximum Dynamic Server Count field. -
Specify
WCCHOST*
in the Machine Name Match Expression field. -
Select the Calculated Machine Names and Dynamic Cluster fields.
-
Select the Calculated Listen Ports field.
-
Click Next to proceed to the next screen.
-
- Task 14 Assigning Managed Servers to the Cluster
-
Click Next to proceed to the next screen.
- Task 15 Configuring Coherence Clusters
-
Use the Coherence Clusters screen to configure the Coherence cluster that is automatically added to the domain. Leave the port number value at
0
, as it was defined during the initial Infrastructure domain creation.Note:
For Coherence licensing information, refer to Oracle Coherence in Oracle Fusion Middleware Licensing Information.
- Task 16 Verifying the Existing Machines
-
Under the Unix Machine tab, verify the names of the machines you created when creating the initial Infrastructure domain.
Click Next to proceed to the next screen.
- Task 17 Assigning Servers to Machines
-
Click Next to proceed to the next screen.
- Task 18 Configuring Virtual Targets
-
Click Next to proceed to the next screen.
- Task 19 Configuring Partitions
-
Click Next to proceed to the next screen.
- Task 20 Reviewing Configuration Summary
-
Click Update to proceed to the next screen.
- Task 21 Reviewing Configuration Progress
-
After all the processes are complete, click Next to proceed to the next screen.
- Task 22 Reviewing Your Configuration Specifications and Configuring the Domain
-
The Configuration Summary screen contains the detailed configuration information for the domain you are about to create. Review the details of each item on the screen and verify that the information is correct.
You can go back to any previous screen if you need to make any changes, either by using the Back button or by selecting the screen in the navigation pane.
Domain creation will not begin until you click Update.
Tip:
More information about the options on this screen can be found in Configuration Summary in Creating WebLogic Domains Using the Configuration Wizard.
- Task 23 Writing Down Your Domain Home and Administration Server URL
-
The Configuration Success screen will show the following items about the domain you just configured:
-
Domain Location
-
Administration Server URL
You must make a note of both items as you will need them later; the domain location is needed to access the scripts used to start the Node Manager and Administration Server, and the URL is needed to access the Administration Server.
Click Finish to dismiss the configuration wizard.
-
- Task 24 Start the Administration Server
-
Start the Administration Server to ensure the changes you have made to the domain have been applied.
Propagating the Domain Configuration to WLS_WCCUI1 and WLS_WCCUI2
You need to perform the following steps in order to propagate the domain configuration to the WebCenter Content user interface Managed Servers.
Modifying System-Level Settings Through MBeans
To ensure high availability, modify system-level configuration settings for WebCenter Content user interface through the System Configuration page in Fusion Middleware Control. The settings on this page configure the WebCenter Content user interface MBeans for the domain.
For information about how to modify system-level settings in Fusion Middleware control, see Modifying System Configuration Settings in Oracle Fusion Middleware Administering Oracle WebCenter Capture.
-
To set the
AdfScopeHaSupport
parameter, complete the following steps:-
From the WebLogic Domin menu, select System MBean Browser.
-
From the left navigation, go to Application Defined MBeans > oracle.adf.share.config > Domain:WCC server name > Application: Oracle WebCenter Content - Web UI > ADFConfig > ADFConfig > ADFConfig > ADFcConfiguration.
-
Set the
AdfScopeHaSupport
parameter totrue
. -
Click Apply.
-
-
To set the
ClusterCompatible
andTemporaryDirectory
parameters, complete the following steps:-
From the WebLogic Domin menu, select System MBean Browser.
-
From the left navigation, go to Application Defined MBeans > oracle.adf.share.config > Domain:WCC server name > Application: Oracle WebCenter Content - Web UI > ADFConfig > ADFConfig > ADFConfig > WccAdfConfiguration.
-
Set the
ClusterCompatible
parameter totrue
. -
Set the
TemporaryDirectory
parameter to/u01/oracle/config/domains/WCCDomain/WCCUI_Cluster/tempdir
. -
Click Apply.
-
-
To set the
PropConnectionUrl
parameter, complete the following steps:-
From the WebLogic Domin menu, select System MBean Browser.
-
From the left navigation, go to Application Defined MBeans > oracle.adf.share.connections > Domain:WCC server name > Application: Oracle WebCenter Content - Web UI > ADFConnections > ADFConnections > WccConnection > WccAdfServerConnection.
-
Set the
PropConnectionUrl
parameter toidc://wccinternal.example.com:6300
. -
Click Apply.
-
-
To set the
ApplicationUrl
parameter, complete the following steps:-
From the WebLogic Domin menu, select System MBean Browser.
-
From the left navigation, go to Application Defined MBeans > oracle.adf.share.connections > Domain:WCC server name > Application: Oracle WebCenter Content - Web UI > ADFConfig > ADFConfig > ADFConfig > WccAdfConfiguration.
-
Set the
ApplicationUrl
parameter tohttps://wcc.example.com:443
. -
Click Apply.
-
Configuring Oracle HTTP Server with the WebCenter Content User Interface Cluster
Configure Oracle HTTP Server with the WebCenter Content User Interface Cluster, set the front-end HTTP Host and Port for the cluster, and validate access through the load balancer.
This section contains the following tasks.
Configuring Oracle HTTP Server for the WLS_WCCUI Managed Servers
Setting the Front-End HTTP Host and Port for the WebCenter Content User Interface Cluster
Validating Access Through the Load Balancer
- While WLS_WCCUI2 is running, stop WLS_WCCUI1 from the WebLogic Server Administration Console.
- Access
https://wcc.example.com/wcc
to verify that it is functioning properly. (You will not be able to retrieve reports or data because the Capture server is down.) - Start WLS_WCCUI1 from the WebLogic Server Administration Console.
- Stop WLS_WCCUI2 from the WebLogic Server Administration Console.
- Access
https://wcc.example.com/wcc
to verify that it is functioning properly.
Completing the Workflow Configuration
To complete the workflow configuration for the WebCenter Content user interface, you need to restart the Managed Servers and verify the configuration. The UseDatabaseWfInQueue
configuration variable enables the WebCenter Content user interface to filter workflows assigned to a user. The EmailNotificationType
configuration variable specifies where the links in notification emails point for workflows and subscriptions in different Content Server user interfaces, and its default value is NativeWebUI
.