This chapter describes how to extend the enterprise deployment domain with the Oracle WebCenter Content software.
This chapter provides information on installing the WebCenter Content, extending the domain for WebCenter Content and completing post-configuration and verification tasks.
Parent topic: Configuring the Enterprise Deployment
This section provides instructions for installing WebCenter Content in an enterprise deployment domain.
This section contains the following procedures.
To start the installation program:
When the installation program appears, you are ready to begin the installation.
The installation program displays a series of screens, in the order listed in the following table.
If you need additional help with any of the installation screens, click the screen name.
Screen | Description |
---|---|
Installation Inventory Screen |
If you did not create a central inventory when you installed the Oracle Fusion Middleware Infrastructure software, then this dialog box appears. Edit the Inventory Directory field so it points to the location of your local inventory, and then click OK. |
This screen introduces you to the product installer. |
|
Use this screen to automatically search My Oracle Support for available patches or automatically search a local directory for patches that you’ve already downloaded for your organization. |
|
Use this screen to specify the location of your Oracle home directory. For more information about Oracle Fusion Middleware directory structure, see "Selecting Directories for Installation and Configuration" in Planning an Installation of Oracle Fusion Middleware. |
|
This screen verifies that your system meets the minimum necessary requirements. If there are any warning or error messages, you can refer to one of the documents in the Roadmap for Verifying Your System Environment section in Planning Your Oracle Fusion Middleware Infrastructure Installation. |
|
Use this screen to verify the installation options you selected. Click Install to begin the installation. |
|
This screen allows you to see the progress of the installation. Click Next when the progress bar reaches 100% complete. |
|
Review the information on this screen, then click Finish to dismiss the installer. |
If you have followed the EDG shared storage recommendations, there is a separate shared storage volume for product installations on WCCHOST2, and you must also install the software on WCCHOST2. For more information, see Shared Storage Recommendations When Installing and Configuring an Enterprise Deployment.
After you complete the installation, you can verify it by successfully completing the following tasks.
Review the contents of the installation log files to make sure that no problems were encountered. For a description of the log files and where to find them, see "Understanding Installation Log Files" in Installing Software with the Oracle Universal Installer.
The contents of your installation vary based on the options you selected during the installation.
The addition of Oracle WebCenter Content will add the following directory and sub-directories:
/u01/oracle/products/fmw/wccontent common plugins ucm wccadf /u01/oracle/products/fmw/wccapture capture common plugins
For more information about the directory structure you should see after installation, see "What are the Key Oracle Fusion Middleware Directories?" in Understanding Oracle Fusion Middleware.
You can also view the contents of your Oracle home using the viewInventory
script. For more information, see "Viewing the contents of an Oracle home" in Installing Software with the Oracle Universal Installer.
Before you can configure an Oracle WebCenter Content domain, you must install the required schemas in a certified database for use with this release of Oracle Fusion Middleware.
Follow the instructions in this section to install the schemas.
To start the Repository Creation Utility (RCU):
After you start the RCU, you can then use the wizard screens to select and install the required schemas for your Oracle Fusion Middleware product. Schema creation involves the following tasks.
Click Next.
If you have the necessary permission and privileges to perform DBA activities on your database, select System Load and Product Load. This procedure assumes that you have the necessary privileges.
If you do not have the necessary permission or privileges to perform DBA activities in the database, you must select Prepare Scripts for System Load on this screen. This option will generate a SQL script, which can be provided to your database administrator. See "Understanding System Load and Product Load" in Creating Schemas with the Repository Creation Utility.
Provide the database connection details for RCU to connect to your database.
In the Host Name field, enter the SCAN address of the Oracle RAC Database.
Enter the DBMS/Service details.
Enter the Schema Owner and Schema Password details.
Click Next to proceed, then click OK on the dialog window confirming that connection to the database was successful.
Select existing prefix, and select the prefix you created while configuring the initial domain.
From the list of schemas, expand the WebCenter Content schema section and select only the Oracle WebCenter Content Server -- Complete schema.
The custom prefix is used to logically group these schemas together for use in this domain only; you must create a unique set of schemas for each domain as schema sharing across domains is not supported.
Tip:
For more information about custom prefixes, see "Understanding Custom Prefixes" in Creating Schemas with the Repository Creation Utility.
For more information about how to organize your schemas in a multi-domain environment, see "Planning Your Schema Creation" in Creating Schemas with the Repository Creation Utility.
Tip:
You must make a note of the custom prefix you choose to enter here; you will need this later on during the domain creation process.
Click Next to proceed, then click OK in the dialog window confirming that prerequisite checking for schema creation was successful.
Specify how you want to set the schema passwords on your database, then specify 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.
On the Map Tablespaces screen, review the information, and then click Next to accept the default values.
Click OK in the confirmation dialog box.
Navigate through the remainder of the RCU screens to complete schema creation. When you reach the Completion Summary screen, click Close to dismiss RCU.
To verify that the schemas were created successfully, and to verify the database connection details, use SQL*Plus or another utility to connect to the database, using the OCS schema name and the password you provided.
For example:
./sqlplus SQL*Plus: Release 11.2.0.4.0 Production on Fri Nov 1 08:44:18 2013 Copyright (c) 1982, 2013, Oracle. All rights reserved. Enter user-name: WCPEDG_OCS Enter password: ocs_password Connected to: Oracle Database 11g Enterprise Edition Release 11.2.0.4.0 - 64bit Production With the Partitioning, OLAP, Data Mining and Real Application Testing options SQL>
This section provides instructions for extending the existing enterprise deployment domain with the Oracle WebCenter Content software.
Extending the domain involves the following tasks.
Follow the instructions in this section to extend the domain for the topology.
Note:
You can use the 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 extension and configuration includes the following tasks:
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 domain home you created as part of the initial domain.
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.
On the Templates screen, make sure Update Domain Using Product Templates is selected, then select the following templates:
Oracle Universal Content Management - Content Server - 12.2.1.1.0 [wccontent]
In addition, the following additional templates should already be selected, because they were used to create the initial Infrastructure domain:
Oracle Enterprise Manager - 12.2.1.1.0 [em]
Oracle JRF - 12.2.1.1.0 [oracle_common]
WebLogic Coherence Cluster Extension - 12.2.1.1.0 [wlserver]
In addition, the following templates are also already selected, because they were used to extend the domain with WebCenter Portal:
Oracle WebCenter Portal – 12.2.1 [wcportal]
Oracle WebCenter Pagelet Producer – 12.2.1 [wcportal]
Oracle WebCenter Portlet Producer - 12.2.1 [wcportal]
Oracle WebCenter Discussion Server - 12.2.1 [wcportal]
Oracle WebCenter Analytics Collector - 12.2.1 [wcportal]
Tip:
More information about the options on this screen can be found in Templates in Creating WebLogic Domains Using the Configuration Wizard.
On the Database Configuration Type screen, select RCU Data.
All fields are pre-populated, because you already configured the domain to reference the Fusion Middleware schemas that are required for the Infrastructure domain.
Verify and ensure that credentials in all the fields are the same that you have provided while configuring the Oracle Fusion Middleware Infrastructure.
Click Get RCU Configuration after you finish verifying the database connection information. The following output in the Connection Result Log indicates that the operating 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 RCU Data option, see "Understanding the Service Table Schema" in Creating Schemas with the Repository Creation Utility.
For more information about the other options on this screen, see "Datasource Defaults" in Creating WebLogic Domains Using the Configuration Wizard.
On the JDBC Component Schema screen, select all the UCM schemas (for WebCenter Content) in the table.
When you select the schemas, the fields on the page are activated and the database connection fields are populated automatically.
Click Convert to GridLink and click Next.
On the GridLink Oracle RAC Component Schema screen, provide the information required to connect to the RAC database and component schemas, as shown in the following table.
Element | Description and Recommended Value |
---|---|
SCAN, Host Name, and Port |
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, |
ONS Host and Port |
In the ONS Host field, enter the SCAN address for the Oracle RAC database. In the Port field, enter the ONS Remote port (typically, |
Enable Fan |
Verify that the Enable Fan check box is selected, so the database can receive and process FAN events. |
Use the JDBC Component Schema Test screen to test the data source connections you have just configured.
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.
Tip:
For more information about the other options on this screen, see "Test Component Schema" in Creating WebLogic Domains Using the Configuration Wizard.
To complete domain configuration for the topology, select the following options on the Advanced Configuration screen:
Managed Servers, Clusters and Coherence
JMS File store
On the Managed Servers screen, a new Managed Server for Oracle WebCenter Content appears in the list of servers.
Perform the following tasks to modify the default Oracle WebCenter Content Managed Server and create a second Managed Server:
Rename the default Managed Server to WLS_WCC1
.
Click Add to create a new Managed Server and name it WLS_WCC2
.
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 information in the following table to fill in the rest of the columns for each Oracle WebCenter Content Managed Server.
Server Name | Listen Address | Listen Port | Enable SSL | SSL Listen Port | Server Groups |
---|---|---|---|---|---|
WLS_WCC1 |
WCCHOST1 |
16200 |
Unchecked |
Disabled |
UCM-MGD-SVR |
WLS_WCC2 |
WCCHOST2 |
16200 |
Unchecked |
Disabled |
UCM-MGD-SVR |
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.
In this task, you create a cluster of Managed Servers to which you can target the Oracle WebCenter Content software.
Use the Clusters screen to create a new cluster:
Click the Add button.
Specify WCC_Cluster
in the Cluster Name field.
Leave the Cluster Address field blank.
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.
Use the Assign Servers to Clusters screen to assign WLS_WCC1
and WLS_WCC2
to the new cluster, WCC_Cluster
:
In the Clusters pane, select the cluster to which you want to assign the servers; in this case, WCC_Cluster
.
In the Servers pane, assign WLS_WCC1 to WCC_Cluster
by doing one of the following:
Click once on the WLS_WCC1
Managed Server to select it, then click on the right arrow to move it beneath the selected cluster in the Clusters pane.
Double-click on WLS_WCC1
to move it beneath the selected cluster in the clusters pane.
Repeat to assign WLS_WCC2
to WCC_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.
Use the Coherence Clusters screen to configure the Coherence cluster that is automatically added to the domain. Leave the port number value at 9991, 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.
Use the Machines screen to add two new machines:
Click the Add button.
Enter WCCHOST1 in the Name field.
Enter the host name of WCCHOST1 for the Node Manage Listener address. Leave the Node Manager port to the default value of 5556
.
Repeat the above steps for WCCHOST2.
Under the Unix Machine tab, verify the names of the machines you created when creating the initial Infrastructure domain, as shown in the following table.
Click Next to proceed.
Name | Node Manager Listen Address | Node Manager Listen Port |
---|---|---|
WCCHOST1 |
The value of the WCCHOST1 host name variable. For example, |
5556 |
WCCHOST2 |
The value of the WCCHOST2 host name variable. For example, |
5556 |
Use the Assign Servers to Machines screen to assign the Oracle WebCenter Content Managed Servers you just created to the corresponding machines in the domain.
Assign WLS_WCC1 to WCCHOST1, and assign WLS_WCC2 to WCCHOST2.
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.
In the JMS File Stores screen, assign the following directory for each of the WebCenter Content Persistence stores including Content Server JMS file stores:
ORACLE_RUNTIME/domain_name/WCC_Cluster/jms
Note:
Create thejms
folder before starting the managed servers.In this example, replace RUNTIME_HOME with the value of the variable for you environment. Replace WCC_Cluster with the name you assigned to the WebCenter Content cluster.
Select Direct-Write from the drop-down list for Synchronous Write Policy (for both the stores).
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 extension 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.
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.
Start the Administration Server to ensure the changes you have made to the domain have been applied.
Several configuration and validation steps must be performed to bring the content servers online. Complete the following sections in the order listed.
upload
and stage
directories for the new Managed Servers.After configuring the domain and unpacking it to the Managed Server domain directories on all the hosts, verify and update the upload
and stage
directories for the new Managed Servers.
This step is necessary to avoid potential issues when performing remote deployments and for deployments that require the stage mode.
To update these directory paths for all the Managed Servers in the Managed Server domain home directory:
Log in to the Oracle WebLogic Server Administration Console.
In the left navigation tree, expand Domain, and then Environment.
Click Lock & Edit.
Click Servers.
For each new Managed Server in the Managed Server domain home directory:
Click the name of the Managed Server.
Click the Configuration tab, and then click the Deployment tab.
Verify that the Staging Directory Name is set to the following:
MSERVER_HOME/servers/server_name/stage
Replace MSERVER_HOME
with the directory path for the MSERVER_HOME directory; replace server_name with the name of the Server you are editing.
Update the Upload Directory Name to the following value:
ASERVER_HOME/servers/AdminServer/upload
Replace ASERVER_HOME
with the directory path for the ASERVER_HOME directory.
Click Save.
Return to the Summary of Servers screen.
When you have modified these values for each Managed Server, click Activate Changes.
After you unpack the extended domain on WCCHOST1, you can start the Node Manager from the Managed Server directory on WCCHOST1.
For information about additional Node Manager configuration options, see Administering Node Manager for Oracle WebLogic Server.
http://admin.example.com/console
.Running
in the Administration Console. If the server is shown as Starting or Resuming
, wait for the server status to change to Started
. If another status is reported (such as Admin
or Failed
), check the server output log files for errors.Content Server updates the cwallet.sso
file located in the MSERVER_HOME/config/fmwconfig
directory when it starts. This change needs to be propagated back to the Administration Server.
When adding WebCenter Content to a WebCenter Portal enterprise deployment, you will have to copy the cwallet file from the WC Content host (WCCHOST1) to the WC Portal host (WCPHOST1) where the Administration Server is running.
To do this, copy the file to ASERVER_HOME/config/fmwconfig
on WCPHOST1 using the following command (all on a single line):
scp -p \ WCCHOST1:/MSERVER_HOME/config/fmwconfig/cwallet.sso \ WCPHOST1:/ASERVER_HOME/config/fmwconfig/cwallet.sso
Note:
If any operation is performed in a WLS_WCCn server that modifies thecwallet.sso
file in the MSERVER_HOME/config/fmwconfig/
directory, the file will have to be immediately copied to the Administration Server domain configuration directory on WCPHOST1 at ASERVER_HOME/config/fmwconfig
.After you have propagated the domain configuration to WCCHOST2, you can start the Node Manager for the MSERVER_HOME domain directory.
Running
in the Administration Console. If the server is shown as Starting or Resuming
, wait for the server status to change to Started
. If another status is reported (such as Admin
or Failed
), check the server output log files for errors.Using a text editor, add the following options to each cluster node's MSERVER_HOME/ucm/cs/bin/intradoc.cfg
file, where the directories specified are on a direct-bus-attached-controlled local disk and not a remote file system, such as a UNIX/Linux mounted NFS or clustered file system (like OCFS2, GFS2, or GPFS):
TraceDirectory=MSERVER_HOME/servers/WLS_WCCN/logs EventDirectory=MSERVER_HOME/servers/WLS_WCCN/logs/event/ ArchiverDoLocks=true DisableSharedCacheChecking=true
The trailing N should match your nodes' server names, like WLS_WCC1 is for WCCHOST1 and WLS_WCC2 is for WCCHOST2, and so on.
These changes will take effect after a restart of all WebCenter Content Managed Servers, at the end of the procedure described in Configuring Service Retries for Oracle WebCenter Content.
Note:
The directories can reside in any local disk path that you have determined to have enough space to hold the WebCenter Content logs and any trace that you may configure. The preceding paths are a suggestion.The following parameter should be set in the Content Server config.cfg
file to enable login retries during an Oracle RAC failover:
ServiceAllowRetry=true
If this value is not set, users will need to manually retry any operation that was in progress when the failover began.
You must configure the Credential map to grant the Content Server administrative roles to the WCPAdministrators
LDAP group.
The WCPAdministrators
LDAP group is created in the Provisioning an Enterprise Deployment Administration User and Group section completed earlier. This configuration of credential map ensures consistent use of the LDAP administrative user for all configuration, administration, and maintenance tasks.
WCPAdministrators
group:The following sections provide instructions for configuring Oracle HTTP Server for the WebCenter Content Cluster.
wcp.example.com
virtual server. To configure Oracle HTTP Server for the WLS_WCC Managed Servers:Before you can validate that requests are routed correctly through the Oracle HTTP Server instances, you must set the WebLogic Plug-In Enabled
parameter for the clusters you just configured.
https://wcp.example.com
/cs
to verify that it is functioning properly.https://wcp.example.com
/cs
to verify that it is functioning properly.This section describes tasks required for configuring Oracle WebCenter Content Server for use with WebCenter Portal.
For WebCenter Portal, you must enable the following Content Server components:
WebCenterConfigure - Enable it to configure an instance of Content Server for WebCenter Portal and Portal Framework applications.
Folders_g or FrameworkFolders - Enable either of these components to specify the folder service configured on Content Server.
Folders_g - Provides a hierarchical folder interface to content in Content Server. For an Oracle WebCenter Portal instance patched from an earlier release that used the Folders_g component, you can continue to use Folders_g or choose to migrate to the FrameworkFolders interface. Oracle recommends that you migrate to the FrameworkFolders interface for better performance and so that you can use any new Content Server features.
FrameworkFolders - Provides a hierarchical folder interface similar to a conventional file system, for organizing and locating some or all of the content in the repository. FrameworkFolders is a scalable, enterprise solution and is intended to replace Folders_g as the folder service for Content Server. For new installations of Oracle WebCenter Portal, it is recommended that you enable the FrameworkFolders component on Content Server.
Note:
Make sure you enable AutoSuggestConfig component before you enable FrameworkFolders component.For detailed steps, see Enabling Mandatory Components in Administering Oracle WebCenter Portal.
Note:
If Oracle WebCenter Portal is configured to use the Folders_g component, and Folders_g is not enabled, the following exception displays:
SEVERE: UCM feature folders is not installed on server. at
oracle.webcenter.content.integration.spi.ucm.UCMBridge.getBridge(UCMBridge.java:349) ....
If Oracle WebCenter Portal is configured to use the FrameworkFolders component, and FrameworkFolders is not enabled, the following message is displayed:
Foldering service from content server Folders_g and Portal Server Configuration FrameworkFolders do not match
This task is optional, but strongly recommended.
This configuration is required for the Slide Previewer capability in WebCenter Portal, which makes use of the HTML renditions generated on the fly by the Dynamic Converter.
The configuration for the Dynamic Converter consists of two steps: enabling the Dynamic Converter, and defining the file types for which the Dynamic Converter is available. For detailed steps, see the Configuring the Dynamic Converter Component section in Administering Oracle WebCenter Portal.
There are several other Content Server features that, while not mandatory, can provide additional functionality in your WebCenter Portal enterprise deployment. For example, you can enable features such as Site Studio, OracleTextSearch, and so on.
To find out more, and for detailed steps, see the Configuration Roadmap for Content Server section in Administering Oracle WebCenter Portal.
Perform the following steps to register Oracle WebCenter Content Server with the WebCenter Portal application.
Note:
For more information about Content Server registration, see the Configuring Back-end Data Repositories for Tools and Services section in Oracle Fusion Middleware Administrator's Guide for Oracle WebCenter Portal.