This chapter describes how to extend and configure a domain with Oracle WebCenter Content, for use in a WebCenter Portal enterprise deployment.
Note:
Before starting the setup process, read the Oracle Fusion Middleware Release Notes for additional installation and deployment information.This chapter includes the following topics:
Overview of Extending the Domain to Include Oracle WebCenter Content
Propagating the Domain Configuration to SOAHOST2, WCPHOST1 and WCPHOST2 Using the unpack Utility
Configuring the Load Balancer to Route WebCenter Content Traffic
Verifying GridLink Data Source Configuration and ONS for WebCenter Content
Configuring Oracle HTTP Server for the WLS_WCC Managed Servers
Registering Oracle WebCenter Content with the WebCenter Portal Application
The Oracle WebCenter Content system is installed using the WL_HOME
and ORACLE_HOME
locations created in Chapter 6, "Installing the Software for an Enterprise Deployment" on a shared storage. WCPHOST1 and WCPHOST2 mount MW_HOME
and use the existing Oracle Weblogic Server, Oracle SOA Suite, Oracle WebCenter Portal, and Oracle WebCenter Content binary installations.
If you have not done so already, install Oracle WebCenter Content binaries into the Middleware Home before adding Oracle WebCenter Content to the domain. For details, see Section 6.3.2.3, "Installing Oracle WebCenter Content".
Extend the domain to include Oracle WebCenter Content. Table 13-1 lists the steps for configuring WebCenter Content and other tasks required for extending the domain with WebCenter Content Managed Servers.
Table 13-1 Steps for Extending the Domain with WebCenter Content
Step | Description | More Information |
---|---|---|
Extend the domain for WebCenter Content |
Extend the WebLogic Server domain you created in Chapter 8, "Creating a Domain for an Enterprise Deployment" |
Section 13.2, "Extending the Domain to Include Oracle WebCenter Content" |
Propagate the domain configuration |
Propagate the start scripts and classpath configuration from the Administration Server's domain directory to the Managed Server domain directories. |
|
Configure the load balancer to route WebCenter Content traffic |
Configure your load balancer with a rule that specifies how to route WebCenter Content traffic. |
Section 13.4, "Configuring the Load Balancer to Route WebCenter Content Traffic" |
Start Node Manager on WCPHOST1 and WCPHOST2 |
Start Node Manager on WCPHOST1 and on WCPHOST2. |
Section 13.5, "Starting Node Manager on WCPHOST1 and WCPHOST2" |
Restart the Administration Server for the domain |
Stop and then restart the Administration Server. |
|
Start the first WebCenter Content Managed Server and configure its Oracle WebCenter Content Server instance |
Start the WLS_WCC1 Managed Server and complete the initial Content Server configuration. |
|
Propagate the changes in the cwallet.sso file back to the Administration Server. |
Copy the updated cwallet.sso file to the Administration Server directory. |
Section 13.10, "Updating the cwallet File in the Administration Server" |
Start the second WebCenter Content Managed Server and configure its Content Server instance |
Configure the WLS_WCC2 Managed Server and complete the initial Content Server configuration. |
Section 13.11, "Starting and Configuring the WLS_WCC2 Managed Server" |
Enable service retries after an Oracle RAC failover |
Set the ServiceAllowRetry configuration parameter to |
Section 13.13, "Configuring Service Retries for Oracle WebCenter Content" |
Configure Oracle HTTP Server with the extended domain |
Configure the Oracle HTTP Server with the Managed Servers, set the frontend HTTP host and port, and set the WLS Cluster address for WCC_Cluster. |
Section 13.14, "Configuring Oracle HTTP Server for the WLS_WCC Managed Servers" |
Validate access to WebCenter Content through Oracle HTTP Server |
Verify the URLs to ensure that appropriate routing and failover is working from Oracle HTTP Server to WCC_Cluster. |
Section 13.15, "Validating Access Through Oracle HTTP Server" |
Back up the WebCenter Content configuration |
Back up the newly extended domain configuration. |
|
Set up Content Server for use with WebCenter Portal |
Configure Content Server for use with applications such as WebCenter Portal. |
Section 13.17, "Configuring Oracle WebCenter Content for WebCenter Portal" |
Register Content Server with WebCenter Portal applications. |
Connect the WebCenter Portal application to Content Server. |
Section 13.18, "Registering Oracle WebCenter Content with the WebCenter Portal Application" |
Extend the domain for Oracle WebCenter Content: Inbound Refinery |
Extend the WebLogic Server domain you created in Chapter 8, "Creating a Domain for an Enterprise Deployment". |
Section 13.19, "Installing and Configuring Inbound Refinery" |
You must extend the domain created in Chapter 8, "Creating a Domain for an Enterprise Deployment" to include Oracle WebCenter Content. Optionally, a new domain may be created containing only Oracle WebCenter Content.
Note:
Before performing these steps, back up the domain as described in the Oracle Fusion Middleware Administrator's Guide.To extend the domain to include Oracle WebCenter Content:
Ensure that the database where you installed the repository is running. For Oracle RAC databases, Oracle recommends that all instances are running, so that the validation check later on becomes more reliable.
Shut down all Managed Servers in the domain.
Change the directory to the location of the Oracle Fusion Middleware Configuration Wizard. This is within the Oracle Common home directory (notice that domain extensions are run from SOAHOST1 where the Administration Server resides).
cd ORACLE_COMMON_HOME/common/bin
Start the Configuration Wizard:
./config.sh
In the Welcome screen, select Extend an existing WebLogic domain, and click Next.
In the WebLogic Domain Directory screen, select the WebLogic domain directory (ORACLE_BASE/admin/domain_name/aserver/domain_name), and click Next.
In the Select Extension Source screen, do the following (as shown in Figure 13-1):
Select Extend my domain automatically to support the following added products.
Select the following product:
Oracle Universal Content Management - Content Server - 11.1.1.0 wcc
Click Next.
Note:
Do not select Oracle Universal Content Management - Inbound Refinery - 11.1.1.0. You will configure this feature later, as described in Section 13.19.6, "Configuring Inbound Refinery".Figure 13-1 Select Extension Source screen for Oracle WebCenter Content
In the Configure JDBC Component Schema screen (Figure 13-2), do the following:
Select UCM Schema.
For the RAC configuration, you can select Convert to GridLink or Convert to RAC multi data source (described in Appendix A, "Using Multi Data Sources with Oracle RAC").
For the instructions given here, select Convert to GridLink.
Click Next.
Figure 13-2 Configure JDBC Component Schema Screen for Oracle WebCenter Content
In the Configure GridLink RAC Component screen (Figure 13-3), do the following:
Select UCM Schema. Leave the other SOA and WebCenter Portal data sources as they are.
Enter values for the following fields, specifying the connect information for the GridLink Oracle RAC database that was seeded with RCU:
Driver: Select Oracle driver (Thin) for GridLinkConnections,Versions:10 and later.
Service Name: Enter the service name of the Oracle RAC database in lowercase letters, followed by the domain name. For example, wcpedg.example.com
.
Username: Enter the complete user name (including the prefix) for the database schema owner.
Password: Enter the password for the database schema owner.
Enable FAN: Select this option.
Enable SSL: Deselect this option.
If you select SSL, to enable Oracle Notification Service (ONS) notification encryption, provide appropriate Wallet File and Wallet Password details.
Service Listener: Enter the Oracle Single Client Access Name (SCAN) address and port for the Oracle RAC database being used. The protocol should be TCP
.
Oracle recommends that you use SCAN addresses to specify the Service Listener (and OSN Host) so you do not need to update a GridLink data source containing SCAN addresses if you add or remove Oracle RAC nodes. To determine the SCAN address, query the remote_listener
parameter in the database:
SQL>show parameter remote_listener; NAME TYPE VALUE ----- ------ ------- remote_listener string db-scan.example.com:1521
Note:
For database versions that do not support SCAN:For Oracle Database 11g Release 1 (11.1), enter the Virtual IP and port of each database's instance listener, for example:
custdbhost1-vip.example.com (Port 1521)
and
custdbhost2-vip.example.com (Port 1521)
For Oracle Database 10g, use multi data sources to connect to an Oracle RAC database. For information about configuring multi data sources see Appendix A, "Using Multi Data Sources with Oracle RAC".
ONS Host: Enter the SCAN address for the Oracle RAC database and the ONS remote port, as reported by the database:
[orcl@CUSTDBHOST1 ~]$ srvctl config nodeapps -s ONS exists: Local port 6100, remote port 6200, EM port 2016
Note:
For Oracle Database 11g Release 1 (11.1), enter the host name and port for the database's ONS service. For example:custdbhost1.example.com (Port 6200)
and
custdbhost2.example.com (Port 6200)
Figure 13-3 Configure RAC Multi Data Source Component Schema Screen for Oracle WebCenter Content
Leave all other SOA and WebCenter Portal schemas as they are.
Click Next.
In the Test JDBC Data Sources screen, select the UCM schema (or click Select All), then click Test Connections.
The Connection Results Log displays the results. Ensure that the connection to the database that contains the schema was successful. If not, click Previous to return to the previous screen, correct your entry, and then retry the test.
Click Next when all the connections are successful.
In the Optional Configuration screen, select the following:
Managed Servers, Clusters and Machines
Deployment and Services
Click Next.
In the Configure Managed Servers screen, rename UCM_server1 to WLS_WCC1, click Add to add a new server called WLS_WCC2, and give these servers the attributes listed in Table 13-2.
Do not modify any other servers that appear in this screen.
Name | Listen Address | Listen Port | SSL Listen Port | SSL Enabled |
---|---|---|---|---|
WLS_WCC1 |
WCPHOST1 |
16200 |
n/a |
No |
WLS_WCC2 |
WCPHOST2 |
16200 |
n/a |
No |
Click Next.
In the Configure Clusters screen, click Add to add the clusters as shown in Table 13-3. Do not modify the other clusters that appear in this screen; leave them as they are.
Name | Cluster Messaging Mode | Multicast Address | Multicast Port | Cluster Address |
---|---|---|---|---|
WCC_Cluster |
unicast |
n/a |
n/a |
Leave it empty. |
Click Next.
In the Assign Servers to Clusters screen, add the following. Do not modify the other assignments that appear in this screen; leave them as they are.
WCC_Cluster
WLS_WCC1
WLS_WCC2
Click Next.
In the Configure Machines screen, click the Unix Machine tab and ensure the following two new machines display:
Leave all other fields to their default values. Click Next.
In the Assign Servers to Machines screen, assign servers to machines as follows:
Assign WLS_WCC1 to WCPHOST1.
Assign WLS_WCC2 to WCPHOST2.
Click Next.
In the Target Deployments to Clusters or Servers screen, click Next.
In the Target Services to Clusters or Servers screen, click Next.
In the Configuration Summary screen, click Extend.
Click OK in the warning dialog about conflicts in ports for the domain.
In the Creating Domain screen, click Done.
Start the Administration Server to make these changes to take effect. See Section 13.6, "Restarting the Administration Server."
Log in to the Administration Console and manually retarget the following deployments to only one node of the cluster (repeat steps in Section 10.9, "Configuring Activity Graph") and then restart all the Managed Servers:
activitygraph-engines
oracle.webcenter.activitygraph.enginelib
oracle.webcenter.activitygraph.lib
To propagate the domain configuration:
Run the pack
command on SOAHOST1 to create a template pack as follows:
cd ORACLE_COMMON_HOME/common/bin ./pack.sh -managed=true -domain=ORACLE_BASE/admin/ domain_name/aserver/domain_name -template=edgdomaintemplateWCC.jar -template_name=edgdomaintemplateWCC
Note:
If the specified template packjar
file exists from previous pack/unpack operations, choose another name (such as edgdomaintemplateWCC2.jar
).Run the following command on SOAHOST1 to copy the template pack created in the previous step to SOAHOST2, WCPHOST1 and WCPHOST2:
Note:
Assuming that WCPHOST1 shares the ORACLE_HOME with WCPHOST2, the template will be present in the same directory in WCPHOST2; otherwise, copy it also to WCPHOST2.scp edgdomaintemplateWCC.jar oracle@SOAHOST2:ORACLE_BASE/product/fmw/oracle_common/common/bin scp edgdomaintemplateWCC.jar oracle@WCPHOST1:ORACLE_BASE/product/fmw/oracle_common/common/bin scp edgdomaintemplateWCC.jar oracle@WCPHOST2:ORACLE_BASE/product/fmw/oracle_common/common/bin
Run the unpack
command on SOAHOST2, WCPHOST1 and WCPHOST2 to unpack the propagated template.
Note:
Make sure to run the unpack command from the ORACLE_COMMON_HOME/common/bin directory, not from WL_HOME/common/bin.SOAHOST2> cd ORACLE_COMMON_HOME/common/bin SOAHOST2> ./unpack.sh -domain=ORACLE_BASE/admin/domain_name /mserver/domain_name -template=edgdomaintemplateWCC.jar -app_dir=ORACLE_BASE /admin/domain_name/mserver/applications -overwrite_domain=true WCPHOST1> cd ORACLE_COMMON_HOME/common/bin WCPHOST1> ./unpack.sh -domain=ORACLE_BASE/admin/domain_name /mserver/domain_name -template=edgdomaintemplateWCC.jar -app_dir=ORACLE_BASE /admin/domain_name/mserver/applications -overwrite_domain=true WCPHOST2> cd ORACLE_COMMON_HOME/common/bin WCPHOST2> ./unpack.sh -domain=ORACLE_BASE/admin/domain_name /mserver/domain_name -template=edgdomaintemplateWCC.jar -app_dir=ORACLE_BASE /admin/domain_name/mserver/applications -overwrite_domain=true
Note:
TheORACLE_BASE
/admin/
domain_name
/mserver/
directory must exist before you run unpack
. In addition, the ORACLE_BASE
/admin/
domain_name
/mserver/applications/
directory must be empty.In this WebCenter Portal enterprise deployment, the Load Balancer load-balances traffic across both Content Server instances. The Load Balancer forwards on a socket connection from WebCenter Portal to one of the Content Server instances (on WCPHOST1 or WCPHOST2).
Because the connection from WebCenter Portal to Content Server is a socket connection, rather than HTTP, once this socket is opened, it is reused (rather than a having new socket opened). This means that whichever Content Server instance gets the open socket first continues to be used and receives most of the traffic.
The Load Balancer should not have stickiness enabled. Although the WebCenter Portal client only opens one connection at a time, both Content Server instances should be available to serve requests. This is especially important if additional WebCenter Portal clients are also using these Content Server instances.
You must configure your Load Balancer with a rule that specifies how to route WebCenter Content traffic, for example:
(LBR) LBR_IP_ADDRESS:4444 -> WCPHOST1_IP_ADDRESS:4444 (WCPHOST1) -> WCPHOST1_IP_ADDRESS:4444 (WCPHOST2)
See also, Section 3.3, "Configuring the Load Balancers".
For information on how to configure the load balancer WebCenter Content socket (port 4444), see Section 13.9, "Configuring Content Server (on the WLS_WCC1 Managed Server)".
Perform these steps to start Node Manager on WCPHOST1 and WCPHOST2 if Node Manager has not started already:
On both WCPHOST1 and WCPHOST2, run the setNMProps.sh
script, which is located in the ORACLE_COMMON_HOME/common/bin directory, to set the StartScriptEnabled
property to 'true' before starting Node Manager:
WCPHOSTn> cd ORACLE_COMMON_HOME/common/bin WCPHOSTn> ./setNMProps.sh
Note:
You must use theStartScriptEnabled
property to avoid class loading failures and other problems.Note:
If Oracle WebCenter Content Server is sharingMW_HOME
in a local or shared storage with SOA and WebCenter Portal, as suggested in the shared storage configuration described in Chapter 3, "Preparing the Network for an Enterprise Deployment," it is not required to run setNMProps.sh
again. In this case, Node Manager has already been configured to use a start script.Run the following commands on both WCPHOST1 and WCPHOST2 to start Node Manager:
WCPHOSTn> cd WL_HOME/server/bin WCPHOSTn> ./startNodeManager.sh
Restart the Administration Server for these changes take effect. To restart the Administration Server, stop it first using the Administration Console and then start it again as described in Chapter 8, "Starting the Administration Server on SOAHOST1."
This section describes how to start the new WLS_WCC1 Managed Server.
To start the WLS_WCC1 Managed Server:
Start the WLS_WCC1 Managed Server using the Oracle WebLogic Server Administration Console as follows:
Expand the Environment node in the Domain Structure window.
Select Servers.
On the Summary or Servers page, click the Control tab.
Select WLS_WCC1, and then click Start.
Verify that the server status is reported as 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. See Section 16.9, "Troubleshooting Oracle WebCenter Portal Enterprise Deployments" for possible causes.
Before configuring Content Server or propagating WLS_WCC1, verify that the GridLink data sources you created earlier are correctly configured and that the Oracle Notification Service (ONS) setup is correct for the data source.
To verify the configuration of GridLink data sources and ONS for WebCenter Content:
Log in to the WebLogic Server Administration Console.
In the Domain Structure tree, expand Services, then select Data Sources.
Click the name of the GridLink data source that was created. For example, CSDS
.
Click Monitoring > Testing, select WLS_WCC1, and click Test Data Source.
The test should be successful if the configuration is correct.
Click the Statistics tab, and click WLS_WCC1.
Click the ONS tab and then the Testing tab.
Select a server, and click Test ONS.
If the configuration is correct, the ONS test is successful. If the ONS test fails, verify that the ONS service is running in the Oracle RAC database nodes:
[orcl@CUSTDBHOST1 ~]$ srvctl status scan_listener SCAN Listener LISTENER_SCAN1 is enabled SCAN listener LISTENER_SCAN1 is running on node CUSTDBHOST1 SCAN Listener LISTENER_SCAN2 is enabled SCAN listener LISTENER_SCAN2 is running on node CUSTDBHOST2 SCAN Listener LISTENER_SCAN3 is enabled SCAN listener LISTENER_SCAN3 is running on node CUSTDBHOST2 [orcl@CUSTDBHOST1 ~]$ srvctl config nodeapps -s ONS exists: Local port 6100, remote port 6200, EM port 2016 [orcl@CUSTDBHOST1 ~]$ srvctl status nodeapps | grep ONS ONS is enabled ONS daemon is running on node: CUSTDBHOST1 ONS daemon is running on node: CUSTDBHOST2
Repeat the ONS test from every WebLogic Server instance that uses the GridLink data source.
This section describes how to configure Content Server (on WLS_WCC1) for the WebCenter Portal enterprise deployment.
Note:
In this WebCenter Portal enterprise deployment, the Load Balancer balances traffic across both Content Servers. If you have not done so already, configure your Load Balancer with a rule that specifies how to route WebCenter Content traffic. For details, see Section 13.4, "Configuring the Load Balancer to Route WebCenter Content Traffic".To configure the Content Server:
Log in to Content Server at http://WCPHOST1:16200/cs
, using your Oracle WebLogic Server administration user name and password, to display a configuration page.
Note:
The Oracle WebCenter Content configuration files are on a shared disk so that all members of the cluster can access them. The shared disk location for the Oracle WebCenter Portal enterprise deployment is at ORACLE_BASE/admin/wc_domain/WCC_Cluster.Change the following values on the server configuration page (make sure to select the Is New Content Server Instance check box to see all options):
Content Server Instance Folder: Set this to ORACLE_BASE/admin/wc_domain/WCC_Cluster/cs.
Native File Repository Location: Set this to ORACLE_BASE/admin/wc_domain/WCC_Cluster/cs/vault.
WebLayout Folder: Set this to ORACLE_BASE/admin/wc_domain/WCC_Cluster/cs/weblayout.
User Profile Folder: Set this to ORACLE_BASE/admin/wc_domain/WCC_Cluster/cs/data/users/profiles.
Server Socket Port: Set this to 4444.
Incoming Socket Connection Address Security Filter: Set this to a pipe-delimited list of localhost and the server IPs:
127.0.0.1|WCPHOST1_IP_Address|WCPHOST2_IP_Address|WEBHOST1_IP_Address|WEBHOST2_IP_Address |LBR_IP_Address
Note:
For this step, use IP addresses, not hostnames.WebServer HTTP/HTTPS Address: Set this to wcpinternal.example.com.
Enter the Load Balancer address here so that requests to /cs
can use any available Content Server node.
Note:
If you have not done so already, add a rule to your Load Balancer that specifies how to route WebCenter Content traffic, for example:(LBR) LBR_IP_ADDRESS:4444 -> WCPHOST1_IP_ADDRESS:4444 (WCPHOST1) -> WCPHOST1_IP_ADDRESS:4444 (WCPHOST2)
See also, Section 13.4, "Configuring the Load Balancer to Route WebCenter Content Traffic".
Web Address is HTTPS: Deselect (uncheck) this check box.
Server Instance Name: Set this to WCC_Cluster1.
Server Instance Label: Set this to WCC_Cluster1.
Server Instance Description: Set this to Cluster WCC_Cluster1.
Auto_Number Prefix: Set this to WCC_Cluster1-
Click Submit when finished, and restart the Managed Server using the Oracle WebLogic Server Administration Console.
The Oracle WebCenter Content server updates the cwallet.sso
file located in ORACLE_BASE/admin/domain_name/mserver/domain_name/config/fmwconfig when it starts. You must propagate this change back to the Administration Server. To do this, copy the file to ORACLE_BASE/admin/domain_name/aserver/domain_name/config/fmwconfig in SOAHOST1 using the following command (all on a single line):
WCPHOST1> scp ORACLE_BASE/admin/domain_name/mserver/
domain_name/config/fmwconfig/cwallet.sso oracle@SOAHOST1:ORACLE_BASE
/admin/domain_name/aserver/domain_name/config/fmwconfig/
Note:
If any operation is performed in the WLS_WCCn servers that modifies thecwallet.sso
file in the ORACLE_BASE/admin/domain_name/mserver/domain_name/config/fmwconfig directory, the file must be immediately copied to the Administration Server domain directory on SOAHOST1 at ORACLE_BASE/admin/domain_name/aserver/domain_name/config/fmwconfig.Starting the WLS_WCC2 Managed Server
Start the WLS_WCC2 Managed Server using the Oracle WebLogic Server Administration Console as follows:
Using the Oracle WebLogic Server Administration Console as follows:
Expand the Environment node in the Domain Structure window.
Select Servers.
On the Summary of Servers page, click the Control tab.
Select WLS_WCC2 and then click Start.
Verify that the server status is reported as 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. See Section 16.9, "Troubleshooting Oracle WebCenter Portal Enterprise Deployments" for possible causes.
Configuring the WLS_WCC2 Managed Server
To configure the WLS_WCC2 Managed Server:
Log in to WLS_WCC2 at http://WCPHOST2:16200/cs
using your Oracle WebLogic Server administration user name and password to display a configuration page:
Note:
The WebCenter Content configuration files are on a shared disk so that all members of the cluster can access them. The shared disk location for the Oracle WebCenter Portal enterprise deployment is at ORACLE_BASE/admin/wc_domain/WCC_Cluster.Change the following values on the server configuration page:
Content Server Instance Folder: Set this to ORACLE_BASE/admin/wc_domain/WCC_Cluster/cs
Native File Repository Location: Set this to ORACLE_BASE/admin/wc_domain/WCC_Cluster/cs/vault
WebLayout Folder: Set this to ORACLE_BASE/admin/wc_domain/WCC_Cluster/cs/weblayout
User Profile Folder: Set this to ORACLE_BASE/admin/wc_domain/WCC_Cluster/cs/data/users/profiles.
Make sure that the Is new Content Server Instance? check box is not selected.
Click Submit when finished and restart the Managed Server using the Oracle WebLogic Server Administration Console.
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 on WCPHOST1 and WLS_WCC2 is on WCCPHOST2, 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 Section 13.13, "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.Set the following parameter in the Oracle Content Server config.cfg
file in order to enable login retries during an Oracle RAC failover:
ServiceAllowRetry=true
If this value is not set, you are required to manually retry any operation that was in progress when the failover began.
To add the ServiceAllowRetry
configuration parameter for Oracle WebCenter Content:
Go to the WebLogic Server Administration Console for Oracle WebCenter Content at http://WCPHOST1:16200/cs
, and log in using your Oracle WebLogic Server administration user name and password.
Open the Administration page, and then select Admin Server.
On the Content Admin Server page, click General Configuration on the left.
On the General Configuration page, add the following parameter in the Additional Configuration Variables box:
ServiceAllowRetry=true
Click Save and restart all WebCenter Content Managed Servers (WLS_WCCn).
Note:
The new parameter is included in theconfig.cfg
file, which is at the following location:
ORACLE_BASE/admin/wc_domain/WCC_Cluster/cs/config/config.cfg
You can also edit this file directly in a text editor. Do not forget to restart all WebCenter Content Managed Servers.
To enable Oracle HTTP Server to route to WCC_Cluster (which contains the WLS_WCC1 and WLS_WCC2 Managed Servers), you must set the WebLogicCluster
parameter to the list of nodes in the cluster:
On WEBHOST1 and WEBHOST2, add the directives highlighted in bold (Example 13-1) to the wcp_vh.conf
file located in the following directory:
ORACLE_BASE/admin/instance_name/config/OHS/component_name/moduleconf
Note that this assumes you created the wcp_vh.conf
file using the instructions in Section 7.6, "Defining Virtual Hosts".
The wcp_vh.conf
file will appear as it does in Example 13-1.
<VirtualHost *:7777> ServerName https://wcp.example.com:443 ServerAdmin you@your.address RewriteEngine On RewriteOptions inherit <Location /soa-infra> SetHandler weblogic-handler WebLogicCluster SOAHOST1VHN1:8001,SOAHOST2VHN1:8001 WLProxySSL ON WLProxySSLPassThrough ON </Location> # SOA inspection.wsil <Location /inspection.wsil> SetHandler weblogic-handler WebLogicCluster SOAHOST1VHN1:8001,SOAHOST2VHN1:8001 WLProxySSL ON WLProxySSLPassThrough ON </Location> # UMS prefs <Location /sdpmessaging/userprefs-ui> SetHandler weblogic-handler WebLogicCluster SOAHOST1VHN1:8001,SOAHOST2VHN1:8001 WLProxySSL ON WLProxySSLPassThrough ON </Location> # Default to-do taskflow <Location /DefaultToDoTaskFlow> SetHandler weblogic-handler WebLogicCluster SOAHOST1VHN1:8001,SOAHOST2VHN1:8001 WLProxySSL ON WLProxySSLPassThrough ON </Location> # Workflow <Location /workflow> SetHandler weblogic-handler WebLogicCluster SOAHOST1VHN1:8001,SOAHOST2VHN1:8001 WLProxySSL ON WLProxySSLPassThrough ON </Location> #Required if attachments are added for workflow tasks <Location /ADFAttachmentHelper> SetHandler weblogic-handler WebLogicCluster SOAHOST1VHN1:8001,SOAHOST2VHN1:8001 WLProxySSL ON WLProxySSLPassThrough ON </Location> # SOA composer application <Location /soa/composer> SetHandler weblogic-handler WebLogicCluster SOAHOST1VHN1:8001,SOAHOST2VHN1:8001 WLProxySSL ON WLProxySSLPassThrough ON </Location> # WebCenter Portal Application (previously called Spaces) <Location /webcenter> WebLogicCluster WCPHOST1:9000,WCPHOST2:9000 SetHandler weblogic-handler WLProxySSL ON WLProxySSLPassThrough ON </Location> <Location /webcenterhelp> WebLogicCluster WCPHOST1:9000,WCPHOST2:9000 SetHandler weblogic-handler WLProxySSL ON WLProxySSLPassThrough ON </Location> <Location /rss> WebLogicCluster WCPHOST1:9000,WCPHOST2:9000 SetHandler weblogic-handler WLProxySSL ON WLProxySSLPassThrough ON </Location> <Location /rest> WebLogicCluster WCPHOST1:9000,WCPHOST2:9000 SetHandler weblogic-handler WLProxySSL ON WLProxySSLPassThrough ON </Location> # Discussions <Location /owc_discussions> WebLogicCluster WCPHOST1:9002,WCPHOST2:9002 SetHandler weblogic-handler WLProxySSL ON WLProxySSLPassThrough ON </Location> # Portlets <Location /pagelets> WebLogicCluster WCPHOST1:9001,WCPHOST2:9001 SetHandler weblogic-handler WLProxySSL ON WLProxySSLPassThrough ON </Location> <Location /portalTools> WebLogicCluster WCPHOST1:9001,WCPHOST2:9001 SetHandler weblogic-handler WLProxySSL ON WLProxySSLPassThrough ON </Location> <Location /wsrp-tools> WebLogicCluster WCPHOST1:9001,WCPHOST2:9001 SetHandler weblogic-handler WLProxySSL ON WLProxySSLPassThrough ON </Location> # Personalization <Location /wcps> WebLogicCluster WCPHOST1:9003,WCPHOST2:9003 SetHandler weblogic-handler WLProxySSL ON WLProxySSLPassThrough ON </Location> #Activity Graph <Location /activitygraph-engines> WebLogicCluster WCPHOST1:9003 SetHandler weblogic-handler WLProxySSL ON WLProxySSLPassThrough ON </Location> #Oracle WebCenter Content <Location /cs> WebLogicCluster WCPHOST1:16200,WCPHOST2:16200 SetHandler weblogic-handler WLProxySSL ON WLProxySSLPassThrough ON </Location> <Location /adfAuthentication> WebLogicCluster WCPHOST1:16200,WCPHOST2:16200 SetHandler weblogic-handler WLProxySSL ON WLProxySSLPassThrough ON </Location> <Location /_ocsh> WebLogicCluster WCPHOST1:16200,WCPHOST2:16200 SetHandler weblogic-handler WLProxySSL ON WLProxySSLPassThrough ON </Location> </VirtualHost>
Note:
An additional virtual host is required if your enterprise deployment requires Microsoft Office integration or access to a Microsoft SharePoint server. For more information, see "Managing Microsoft Office Integration" in Administering Oracle WebCenter Portal.Restart Oracle HTTP Server on both WEBHOST1 and WEBHOST2.
WEBHOST1> ORACLE_BASE/admin/instance_name/bin/opmnctl restartproc ias-component=ohs1 WEBHOST2> ORACLE_BASE/admin/instance_name/bin/opmnctl restartproc ias-component=ohs2
Verify the following load balancer URLs to ensure that appropriate routing and failover is working from Oracle HTTP Server to WCC_Cluster:
While WLS_WCC2 is running, stop WLS_WCC1 using the Oracle WebLogic Server Administration Console.
Access http://wcp.example.com/cs
to verify it is functioning properly.
Start WLS_WCC1 from the Oracle WebLogic Server Administration Console.
Stop WLS_WCC2 from the Oracle WebLogic Server Administration Console.
Access http://wcp.example.com/cs
to verify it is functioning properly.
After you have verified that the extended domain is working, back up the installation. This is a quick backup for the express purpose of immediate restore in case of problems in the further steps. The backup destination is the local disk. You can discard this backup once the enterprise deployment setup is complete. At that point, the regular deployment-specific backup and recovery process can be initiated. The Oracle Fusion Middleware Administrator's Guide provides further details. For information on describing the Oracle HTTP Server data that must be backed up and restored, refer to the "Backup and Recovery Recommendations for Oracle HTTP Server" section in that guide. For information on how to recover components, see the "Recovery of Components" and "Recovery After Loss of Component" sections in the guide. For recommendations specific to recovering from the loss of a host, see the "Recovering Oracle HTTP Server to a Different Host" section in the guide. Also refer to the Oracle Database Backup and Recovery Guide Oracle Database Backup and Recovery User's Guide for information on database backup.
To back up the installation:
Back up the web tier. Run the commands from SOAHOST1:
Shut down the instance using opmnctl
.
ORACLE_BASE/admin/instance_name/bin/opmnctl stopall
Back up the Middleware Home on the web tier using the following command (as root):
tar -cvpf BACKUP_LOCATION/web.tar MW_HOME
Back up the Oracle Instance Home on the web tier using the following command:
tar -cvpf BACKUP_LOCATION/web_instance_name.tar ORACLE_INSTANCE
Start the instance using opmnctl:
cd ORACLE_BASE/admin/instance_name/bin opmnctl startall
Back up the database. This is a full database backup (either hot or cold) using Oracle Recovery Manager (recommended) or operating system tools such as tar for cold backups if possible.
Back up the Administration Server domain directory to save your domain configuration. The configuration files all exist in the ORACLE_BASE/admin/ domain_name directory:
Run the following command to create the backup:
SOAHOST1> tar -cvpf edgdomainback.tar ORACLE_BASE/admin/domain_name
This section describes tasks required for configuring Oracle WebCenter Content Server for use with WebCenter Portal. This section includes the following:
Section 13.17.1, "Enabling Mandatory Content Server Components"
Section 13.17.2, "Enabling and Configuring the Dynamic Converter Component"
Section 13.17.3, "Configuring Additional Content Server Features"
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.
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
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.
To register Oracle WebCenter Content Server with the WebCenter Portal application:
Note:
For more information about Content Server registration, see the "Managing Content Repositories" chapter in Oracle Fusion Middleware Administrator's Guide for Oracle WebCenter Portal.Log in to Enterprise Manager Fusion Middleware Control and navigate to the home page for your application.
For example, to navigate to the home page for WebCenter Portal, expand WebCenter > Portal > Spaces >WebCenter Portal
From the WebCenter Portal menu, select Settings, and then Service Configuration.
From the list of services on the WebCenter Service Configuration page, select Content Repository.
To connect to a new content repository, click Add.
Enter a unique name for this connection, specify the content repository type, and indicate whether this connection is the active (or default) connection for the application.
Connection Name
Enter a unique name for this content repository connection. The name must be unique (across all connection types) within the WebCenter Portal application.
Repository Type
Select the type of repository to which you want to connect: Oracle Content Server.
Active Connection
Make this the default content repository for your WebCenter Portal application.
You can connect your WebCenter Portal application to multiple content repositories; all connections are used. One connection must be designated the default (or active) connection.
Enter additional content repository details for WebCenter Portal:
Content Administrator
Enter a user name with administrative rights for this Content Server instance. This user is used to create and maintain folders for WebCenter Portal content and manage content access rights. Defaults to sysadmin
. Configure a valid administrative user here. Administrative privileges are required for this connection so that operations can be performed on behalf of WebCenter Portal users.
Root Folder
Enter the root folder under which all WebCenter Portal content is stored. Specify a content repository folder that does not yet exist and use the format: /foldername
. For example: /MyWebCenterPortal
. The Root Folder cannot be /, the root itself, and it must be unique across applications. The folder specified is created for you when the application starts up. Invalid entries include: /
, /foldername/
, /foldername/subfolder
.
Application Name
Enter a unique name for this WebCenter Portal application within this content repository. For example: MyWebCenterPortalApp
The name must begin with an alphabetical character, followed by any combination of alphanumeric characters or the underscore character. The string must be less than or equal to fourteen characters.
This name is used to separate data when multiple WebCenter Portal applications share the same content repository and should be unique across applications. It is also used to name document-related workflows, the security group in which all data created in that Portals application is stored, security roles, as well as to stripe user permissions and default attributes for a particular WebCenter Portal instance.
Enter connection details for the content repository:
RIDC Socket Type
Select Socket - Use an intradoc socket connection to connect to Content Server.
The client IP address must be added to the list of authorized addresses in the Content Server. In this case, the client is the machine on which Oracle WebCenter Portal is running.
Server Host
Enter the Load Balancer address, wcpinternal.example.com, so that requests to /cs
use any available Content Server node.
The IP address for the virtual host configured on the load balancer and the Self-IP of the load balancer must be added to the Content Server's Incoming Socket Connection Address Security Filter, as described earlier in Step 2 of Section 13.9, "Configuring Content Server (on the WLS_WCC1 Managed Server)".
Note:
If you have not done so already, add a rule to your Load Balancer that specifies how to route WebCenter Content traffic, for example:(LBR)10.110.10.135:4444 -> 10.110.10.23:4444 (WCPHOST1) -> 10.110.10.24:4444 (WCPHOST2)
Server Port
Enter the port on which the Content Server listens: 4444
Connection Timeout (ms)
Specify the length of time allowed to log in to Content Server (in milliseconds) before issuing a connection timeout message. If no timeout is set, there is no time limit for the login operation. Select a reasonable timeout depending on your environment. For example: 30000.
Authentication Method
Select Identity Propagation - In this enterprise deployment, Content Server and the WebCenter Portal application both use the same identity store to authenticate users.
Web Context Root
Enter /cs as the Web server context root for Content Server.
Administrator User Name
Enter a user name with administrative rights for this Oracle Content Server instance. This user will be used to fetch content type information based on profiles and track document changes for WebCenter Portal cache invalidation. Defaults to sysadmin
.
Administrator Password
Password for the Content Server administrator. Required when socketType
is set to web
.
Click OK to save this connection.
To start using the new (active) connection you must restart the Managed Server on which the WebCenter Portal application is deployed.
Inbound Refinery is required for Document Conversion by Oracle WebCenter Content.
For availability reasons, Oracle recommends configuring at least two Inbound Refinery Managed Servers, installed and configured on separate machines. Within the WebCenter Portal enterprise deployment topology, Inbound Refinery is installed and configured on the same machines as Oracle Webcenter Content Server.
Even though a server group named IBR_Cluster is created in the process of extending the domain with Inbound Refinery, each Inbound Refinery instance is completely independent, not part of a cluster. The server group is used for management purposes only.
This section includes the following topics:
Section 13.19.1, "Extending the Domain to Include Inbound Refinery"
Section 13.19.3, "Modify the Upload and Stage Directories to an Absolute Path"
Section 13.19.5, "Starting the Inbound Refinery Managed Servers"
You must extend the domain created in Section 8, "Creating a Domain for an Enterprise Deployment" to include Oracle WebCenter Content: Inbound Refinery (Inbound Refinery).
Note:
Before performing these steps, back up the domain as described in Oracle Fusion Middleware Administrator's Guide.To extend the domain to include Inbound Refinery:
Ensure that the database where you installed the repository is running. For Oracle RAC databases, Oracle recommends that all instances are running, so that the validation check later on becomes more reliable.
Shut down all Managed Servers in the domain.
Change the directory to the location of the Oracle Fusion Middleware Configuration Wizard. This is within the Oracle Common home directory (notice that domain extensions are run from SOAHOST1 where the Administration Server resides).
cd ORACLE_COMMON_HOME/common/bin
Start the Configuration Wizard:
./config.sh
In the Welcome screen, select Extend an existing WebLogic domain, and click Next.
In the WebLogic Domain Directory screen, select the WebLogic domain directory (ORACLE_BASE
/admin/
domain_name
/aserver/
domain_name
), and click Next.
In the Select Extension Source screen, do the following:
Select Extend my domain automatically to support the following added products.
Select the following product:
Oracle Universal Content Management - Inbound Refinery - 11.1.1.0 [wcc]
Click Next.
In the Configure JDBC Component Schema screen, nothing needs to be done. Inbound refineries do not have a schema in the database. Click Next to continue.
In the Optional Configuration screen, select the following:
Managed Servers, Clusters and Machines
Deployment and Services
Click Next.
In the Configure Managed Servers screen, add the required Managed Servers.
A server is created automatically. Rename this server to WLS_IBR1 and add a new server called WLS_IBR2. Give these servers the attributes listed in Table 13-5. Do not modify the other servers that are shown in this screen; leave them as they are.
Name | Listen Address | Listen Port | SSL Listen Port | SSL Enabled |
---|---|---|---|---|
WLS_IBR1 |
WCPHOST1 |
16250 |
n/a |
No |
WLS_IBR2 |
WCPHOST2 |
16250 |
n/a |
No |
Click Next.
In the Configure Clusters screen, click Add to add the clusters as shown in Table 13-6. Do not modify the other clusters that appear in this screen; leave them as they are.
Name | Cluster Messaging Mode | Multicast Address | Multicast Port | Cluster Address |
---|---|---|---|---|
IBR_Cluster |
unicast |
n/a |
n/a |
Leave empty |
Click Next.
Note:
All Inbound Refinery instances are completely independent. The server group IBR_Cluster is used for management purposes only.In Assign Servers to Clusters screen, assign the following servers to IBR_Cluster:
WLS_IBR1
WLS_IBR2
Do not modify any other assignments that appear in this screen. Click Next.
In the Configure Machines screen, click Next.
In the Assign Servers to Machines screen, assign servers to machines as follows:
Assign WLS_IBR1 to WCPHOST1.
Assign WLS_IBR2 to WCPHOST2.
Click Next.
In the Target Deployments to Clusters or Servers screen, ensure the following targets:
usermessagingserver and usermessagingdriver-email targeted only to SOA_Cluster.
The usermessaging-xmpp, usermessaging-smpp, and usermessaging-voicexml applications are optional.
wsm-pm application targeted only to WSM-PM_Cluster.
If you plan to deploy Web Services Manager to the SOA_Cluster, target the wsm-pm application to SOA_Cluster as well.
oracle.rules* and oracle.soa.* deployments targeted only to SOA_Cluster and Spaces_Cluster.
oracle oracle.sdp.*and oracle.soa.workflow.wc deployments targeted only to SOA_Cluster, Spaces_Cluster, and Portlet_Cluster.
Click Next.
In the Target Services to Clusters or Servers screen, click Next.
In the Configuration Summary screen, click Extend.
In the Creating Domain screen, click Done.
Start the Administration Server to make these changes to take effect. See Section 8.4.3, "Starting the Administration Server on SOAHOST1."
Log in to the Administration Console and manually retarget the following deployments to only one node of the cluster (repeat steps in Section 10.9, "Configuring Activity Graph") and then restart all the Managed Servers:
activitygraph-engines
oracle.webcenter.activitygraph.enginelib
oracle.webcenter.activitygraph.lib
To propagate the domain configuration:
Run the pack
command on SOAHOST1 to create a template pack using the following commands:
cd ORACLE_COMMON_HOME/common/bin ./pack.sh -managed=true -domain=ORACLE_BASE/admin/domain_name/aserver/domain_name -template=edgdomaintemplateIBR.jar -template_name=edgdomain_templateIBR
Note:
If the specified template packjar
file exists from previous pack/unpack operations, choose another name (such as edgdomaintemplateIBR2.jar
).Run the following command on SOAHOST1 to copy the template pack created in the previous step to WCPHOST2:
Note:
Assuming that WCPHOST1 shares the ORACLE_HOME with SOAHOST1, the template will be present in the same directory in WCPHOST1; otherwise, copy it also to WCPHOST1.
scp edgdomaintemplateIBR.jar oracle@WCPHOST2:ORACLE_BASE/product/fmw/oracle_common/common/bin
Run the unpack
command on WCPHOST1 to unpack the propagated template.
Note:
Make sure to rununpack
from the ORACLE_COMMON_HOME/common/bin directory, not from WL_HOME/common/bin.cd ORACLE_COMMON_HOME/common/bin ./unpack.sh -domain=ORACLE_BASE/admin/domain_name/mserver/domain_name -template=edgdomaintemplateIBR.jar -app_dir=ORACLE_BASE/admin/domain_name/mserver/applications -overwrite_domain=true
Note:
TheORACLE_BASE
/admin/
domain_name
/mserver/
directory must exist before you run unpack
. In addition, the ORACLE_BASE
/admin/
domain_name
/mserver/applications/
directory must be empty.Repeat step 3 for WCPHOST2.
After propagating domain changes, update the upload and stage directories. For detailed steps, see Section 8.5.2, "Modifying the Upload and Stage Directories to an Absolute Path".
Restart the Administration Server to make these changes take effect. To restart the Administration Server, stop it first using the Administration Console and then start it again as described in Section 8.4.3, "Starting the Administration Server on SOAHOST1."
To start the WLS_IBR1 on WCPHOST1 and WLS_IBR2 Managed Server on WCPHOST2:
Log in to the Oracle WebLogic Server Administration Console at: http://ADMINVHN:7001/console
In the Domain Structure window, expand the Environment node and then select Servers.
On the Summary of Servers page, open the Control tab.
Select WLS_IBR1 and WLS_IBR2 from the Servers column of the table.
Click Start.
An Inbound Refinery Managed Server needs to be accessed only once through HTTP in order to initialize its configuration. This can be done directly, at the Managed Server's listen address. An Inbound Refinery instance should not be placed behind an HTTP server.
All subsequent access to an Inbound Refinery Managed Server is through the socket listener. This listener is protected through the incoming socket connection address security filter configured in the next section.
Oracle recommends configuring each Oracle WebCenter Content Server with all Inbound Refinery instances. The process for configuring Oracle WebCenter Content is to add each Inbound Refinery instance as a provider. There are also post-installation steps that must be performed with for Inbound Refinery.
The following sections describe the procedures for post-installation configuration of Inbound Refinery:
To configure the Inbound Refinery settings:
Access the Inbound Refinery post-installation configuration screen at the following URL:
http://WCPHOST1:16250/ibr/
In the configuration screen, set the configuration settings as follows:
Inbound Refinery Instance Folder: Set this to ORACLE_BASE/admin/wc_domain/WCC_Cluster/ibr1. The directory path should be on a shared disk, but should be unique for each Inbound Refinery instance.
Native File Repository Location: Set this to ORACLE_BASE/admin/wc_domain/WCC_Cluster/ibr1/vault.
WebLayout Folder: Set this to ORACLE_BASE/admin/wc_domain/WCC_Cluster/ibr1/weblayout.
User Profile Folders: Set this to ORACLE_BASE/admin/wc_domain/WCC_Cluster/ibr1/data/users/profiles.
Socket Connection Address Security Filter: Set this to a pipe-delimited list of localhost and the server IPs:
127.0.0.1|WCPHOST1-IP|WCPHOST2-IP|WEBHOST1-IP|WEBHOST2-IP
This enables access from Oracle WebCenter Content Server. The values for WCPHOST1-IP and WCPHOST2-IP should be the IP addresses of the machines with the Content Server instance or instances that will send jobs to Inbound Refinery, not necessarily the IP address of Inbound Refinery. (In the reference topology used in this enterprise deployment guide, however, these IP addresses are the same.)
This field accepts wildcards in the value; for example, 192.0.2.*
. You can change this value later by setting SocketHostAddressSecurityFilter
in ORACLE_BASE
/admin/
domain_name
/mserver/
domain_name
/ucm/ibr/config/config.cfg
and restarting Inbound Refinery.
Server Socket Port: Enter an unused port number, such as 5555. This value is the number of the port for calling top-level services. Changing this field value changes the IntradocServerPort
entry in ORACLE_BASE
/admin/domain_name/mserver/domain_name/ucm/ibr/config/config.cfg. Take note of the port number as you need it later when configuring Oracle WebCenter Content.
Server Instance Name: Specify a name for the Inbound Refinery Managed Server instance. You can accept the default or change it to a more useful name if you want. Take note of the server name as you need it later when configuring Oracle WebCenter Content.
You can leave all other fields on the configuration page as they are.
Restart the Inbound Refinery Managed Server.
Repeat these steps for all the inbound refineries, using different names for the content folders.
For Inbound Refinery to work properly, you must specify the path to fonts used to generate font images. By default, the font path is set to the font directory in the JVM used by Inbound Refinery: MW_HOME/jdk160_version/jre/lib/fonts. However, the fonts included in the default directory are limited and may cause poor renditions. Also, in some cases if a non-standard JVM is used, then the JVM font path may be different than that specified as the default. If this is the case, an error message is displayed from both Inbound Refinery and Content Server. If this occurs, ensure the font path is set to the directory containing the fonts necessary to properly render your conversions. For more information, see the "Specifying the Font Path" section in Oracle WebCenter Content Administrator's Guide for Conversion.
To configure document conversion:
Log in to Inbound Refinery at the following URL:
http://WCPHOST1:16250/ibr/
Enable conversion components on Inbound Refinery. The core Inbound Refinery converts files to TIFF web-viewable files and JPEG image thumbnails. To use additional conversion types, you need to enable the necessary components:
Note:
For information about the conversion components, see the "Inbound Refinery Conversion Options and Related Components" section in Oracle Fusion Middleware Administrator's Guide for Conversion.Open the Administration tray or menu, then select Admin Server, and then Component Manager.
Select the components you want. For more information, consult the readme files and the documentation for each component.
Click Update.
Click OK to enable the components.
Restart the Inbound Refinery Managed Server.
Enable PDFExportConverter in Inbound Refinery. PDFExportConverter uses Outside In to convert documents directly to PDF files. The conversion can be cross-platform and does not require any third-party product. You can enable PDFExportConverter for Inbound Refinery as a server feature:
Open the Administration tray or menu, then select Admin Server, and then Component Manager.
Select PDFExportConverter.
Click Update.
Click OK to enable this feature.
Restart the Inbound Refinery Managed Server.
Set the primary web-viewable conversion to PDF Export:
Select Conversion Settings, then select Primary Web Rendition.
On the Primary Web-Viewable Rendition page, select Convert to PDF using PDF Export.
Click Update to save your changes.
Inbound Refinery will now use Outside In PDF Export to convert files directly to PDF without the use of third-party applications.
Restart the Administration Server and all Inbound Refinery Managed Servers.
To configure Oracle WebCenter Content with the Inbound Refinery instances, repeat the following steps to register each of the Inbound Refinery services that have been installed and configured (as described in Section 13.19.1, "Extending the Domain to Include Inbound Refinery").
Log in to Content Server at http://WCPHOST1:16200/cs
Select Administration, and then Providers.
In the Create a New Provider section of the Providers page, click Add in the outgoing row.
Enter the details for your Inbound Refinery instance, including, name, description, host, server port (IBRs intradoc port), context root, and instance name.
Provider Name: WLS_IBRn (can be any short declarative name with no spaces). It is a good idea to use the same value as the Instance Name value.
The Inbound Refinery instance name is obtained from the Inbound Refinery server. To find the instance name, log in to Inbound Refinery and select Administration, and then Configuration for instanceName.
Note:
if you miss this step, you will not see the Refinery Administration menu item in the Administration menu.Provider Description: Any text string.
Server Host Name: The name of the host machine where the Inbound Refinery instance is running: WCPHOST1
.
HTTP Server Address: The address of the Inbound Refinery instance: WCPHOST1:16250
.
Server Port: The value of the Server Socket Port field for the Inbound Refinery instance as specified in Section 13.19.6.1, "Configuring Inbound Refinery Settings.", for example 5555
. This is the IntradocServerPort
value in the Content Server's config.cfg file.
Instance Name: The server instance name for Inbound Refinery as specified in Section 13.19.6.1, "Configuring Inbound Refinery Settings." This is the IDC_Name
value in the Content Server's config.cfg file.
Relative Web Root: The web root of the Inbound Refinery instance: /ibr/
.
Under Conversion Options, check Handles Inbound Refinery Conversion Jobs.
Do not check Inbound Refinery Read Only Mode.
Click Add.
Restart WLS_IBRn.
Repeat steps 2-7 for all Inbound Refinery servers.
Select the file types to be sent to Inbound Refinery:
Select Administration, Refinery Administration, and then File Formats Wizard.
Check the boxes for the appropriate file types to send to the refinery.
Do not check HTML, and also do not check wiki and blog unless you have enabled their conversion through the WebCenterConversions component. See also, the "Selecting the File Formats To Be Converted" section in Administering Oracle WebCenter Portal.
Enable wiki and blog conversion to PDF.
For details, see the "Enabling the Conversion of Wikis and Blogs into PDFs" section in Administering Oracle WebCenter Portal.