12 Extending the Domain with Oracle WebCenter Portal

The following topics describes how to extend the enterprise deployment domain with the Oracle WebCenter Portal software.

12.1 Variables Used When Extending the Domain for WebCenter Portal

As you perform the tasks in this chapter, you will be referencing the following directory variables, which are defined in File System and Directory Variables Used in This Guide.

  • ORACLE_HOME

  • ASERVER_HOME

  • APPLICATION_HOME

  • DEPLOY_HOME

  • OHS_CONFIG_DIR

  • JAVA_HOME

In addition, you'll be referencing the following virtual IP (VIP) addresses and host names defined in Physical and Virtual IP Addresses Required by the Enterprise Topology:

  • ADMINVHN

  • WCPHOST1

  • WCPHOST2

  • DBHOST1

  • DBHOST2

  • SCAN Address for the Oracle RAC Database (DB-SCAN.examle.com)

12.2 Installing the Software for an Enterprise Deployment

The following sections describe how to install the software for an enterprise deployment.

12.2.1 Starting the Oracle WebCenter Portal Installer on WCPHOST1

To start the installation program:

  1. Log in to WCPHOST1.
  2. Go to the directory where you downloaded the installation program.
  3. Launch the installation program by invoking the java executable from the JDK directory on your system, as shown in the example below.
    JAVA_HOME/bin/java -d64 -jar fmw_12.2.1.0.0_wcportal_generic.jar
    

    Be sure to replace the JDK location in these examples with the actual JDK location on your system.

    For information about downloading the software and locating the actual installer file name for your product, see Identifying and Obtaining Software Downloads for an Enterprise Deployment.

When the installation program appears, you are ready to begin the installation.

12.2.2 Navigating the Installation Screens

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

Welcome

This screen introduces you to the product installer.

Auto Updates

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.

Installation Location

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.

Installation Type

Use this screen to select the type of installation and consequently, the products and feature sets you want to install.

Select WebCenter Portal.

Notes:

  • WebCenter Portal Worklist integration requires that the BPEL Services provided by SOA Suite share the same WebTier, SSO, and Identity Store.

  • For this Enterprise Deployment Guide, SOA Suite is installed and configured in the same WebLogic Server Domain and included in the WebTier, SSO, and Directory configurations.

  • Whether the installation has SOA Suite installed in the same or separate ORACLE_HOME, the WebCenter Portal SOA Composites option is required as a separate installation. For instructions about the installation see, Installing the Oracle WebCenter Portal SOA Composites.

Prerequisite Checks

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 following documents in the Roadmap for Verifying Your System Environment section in Planning Your Oracle Fusion Middleware Infrastructure Installation.

Security Updates

If you already have an Oracle Support account, use this screen to indicate how you would like to receive security updates.

If you do not have one and are sure you want to skip this step, clear the check box and verify your selection in the follow-up dialog box.

Installation Summary

Use this screen to verify the installation options you selected.

Click Install to begin the installation.

Installation Progress

This screen allows you to see the progress of the installation.

Click Next when the progress bar reaches 100% complete.

Installation Complete

Review the information on this screen, then click Finish to dismiss the installer.

12.2.3 Installing Oracle WebCenter Portal on the Other Host Computers

If you have followed the EDG shared storage recommendations, there is a separate shared storage volume for product installations on WCPHOST2, and you must also install the software on WCPHOST2. For more information, see Shared Storage Recommendations When Installing and Configuring an Enterprise Deployment.

12.3 Creating the Oracle WebCenter Portal Database Schemas

Before you can configure an Oracle WebCenter Portal domain, you must install the required schemas on a certified database for use with this release of Oracle Fusion Middleware.

The following topics describe how to install the required schemas.

12.3.1 Starting the Repository Creation Utility (RCU)

To start the Repository Creation Utility (RCU):

  1. Navigate to the ORACLE_HOME/oracle_common/bin directory on your system.
  2. Make sure the JAVA_HOME environment variable is set to the location of a certified JDK on your system. The location should be up to but not including the bin directory. For example, if your JDK is located in /u01/oracle/products/jdk:

    On UNIX operating systems:

    export JAVA_HOME=/u01/oracle/products/jdk
    
  3. Start RCU:

    On UNIX operating systems:

    ./rcu
    

12.3.2 Navigating the RCU Screens to Create the Schemas

Schema creation involves the following tasks.

Task 1   Introducing RCU

Click Next.

Task 2   Selecting a Method of Schema Creation

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.

Task 3   Providing Database Connection Details

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.

Task 4   Specifying a Custom Prefix and Selecting Schemas

Select Select existing prefix, and then select the prefix you used when you created the initial domain in Creating the Initial Infrastructure Domain for an Enterprise Deployment.

From the list of schemas, select WebCenter Portal . This will automatically select the required WebCenter Portal schemas. In addition, the following dependent schemas have already been installed with the Infrastructure and are grayed out:

  • Metadata Services

  • Audit Services

  • Audit Services Append

  • Audit Services Viewer

  • Oracle Platform Security Services

  • User Messaging Service

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.

Click Next to proceed, then click OK on the dialog window confirming that prerequisite checking for schema creation was successful.

Task 5   Specifying Schema Passwords

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.

Task 6   Specifying Custom Variables

For an enterprise deployment, Oracle recommends that you enter “Y” to enable partitioning of the Analytics data.

This feature partitions the analytics data by month. In a partitioned environment, the recommended method for purging data is simply to drop the month-based partitions that are no longer required.

For information about partitioning analytics data, see "Partitioning Oracle WebCenter Portal's Analytics Data" in the Oracle Fusion Middleware Administrator's Guide.

Task 7   Verifying the Tablespaces for the Required Schemas

On the Map Tablespaces screen, review the information, and then click Next to accept the default values.

Click OK in the confirmation dialog box.

Task 8   Completing Schema Creation

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

Task 9   Verifying the Schema Creation

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 WCPINFRA 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: FMW1221_WEBCENTER
Enter password: wcpinfra_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>

12.4 Extending the Enterprise Deployment Domain with Oracle WebCenter Portal

This section provides instructions for extending the existing enterprise deployment domain with the Oracle WebCenter Portal software.

Extending the domain involves the following:

12.4.1 Starting the Configuration Wizard

To start the Configuration Wizard:

  1. Shut down the domain completely before extending the domain. From the WebLogic Server Console, stop all managed servers and verify, and then stop the Administration Server.
  2. Navigate to the following directory and start the WebLogic Server Configuration Wizard.
    cd ORACLE_HOME/oracle_common/common/bin
    ./config.sh
    

12.4.2 Navigating the Configuration Wizard Screens to Extend the Domain with WebCenter Portal

Follow the instructions in this section to update and configure the domain for the topology.

Note:

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 configuration includes the following tasks.

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 Portal – 12.2.1.1.0 [wcportal]

  • Oracle WebCenter Pagelet Producer – 12.2.1.1.0 [wcportal]

  • Oracle WebCenter Portlet Producers - 12.2.1.1.0 [wcportal]

  • Oracle WebCenter Discussion Server - 12.2.1.1.0 [wcportal]

  • Oracle WebCenter Analytics Collector - 12.2.1.1.0 [wcportal]

In addition, the following additional templates should already be selected, because they were used to create the initial domain in Creating the Initial Infrastructure Domain for an Enterprise Deployment:

  • Oracle Enterprise Manager - 12.2.1.1.0 [em]

  • Oracle WSM Policy Manager - 12.2.1.0 [oracle_common]

  • Oracle JRF - 12.2.1.1.0 [oracle_common]

  • WebLogic Coherence Cluster Extension - 12.2.1.1.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 the Database Configuration Type

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 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 operation succeeded:

Connecting to the database server...OK
Retrieving schema data from database server...OK
Binding local schema components with retrieved data...OK

Successfully Done.

Tip:

For more information about the 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.

Task 4   Specifying JDBC Component Schema Information

On the JDBC Component Schema screen, select all the WebCenter Portal schemas 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.

Task 5   Providing the GridLink Oracle RAC Database Connection Details

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, 1521)

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, 6200).

Enable Fan

Select the Enable Fan check box to receive and process FAN events,

Task 6   Testing the JDBC Connections

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

Task 7   Selecting Advanced Configuration

To complete domain configuration for the topology, select the following options on the Advanced Configuration screen:

  • Topology

  • Deployments and Services

Task 8   Configuring Managed Servers

On the Managed Servers screen, new Managed Servers for Oracle WebCenter Portal, Portlets, and Collaboration appear in the list of servers along with the other Managed Servers that were created earlier. These servers are created automatically by the Oracle WebCenter Portal configuration template you selected earlier in the Configuration Wizard session.

Perform the following tasks to modify the default Managed Servers and create a second Managed Server for each server type:

  1. Select WC_Portal and rename it to WC_Portal1.

  2. Select Clone to create another managed server. Rename the new server to WC_Portal2.

  3. Repeat the above two steps to edit and create WC_Portlet1, WC_Portlet2, WC_Collaboration1 and WC_Collaboration2.

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_WSM1

WCPHOST1

7010

No

Disabled

WSMPM-MAN-SVR

JRF-MAN-SVR

WSM-CACHE-SVR

WLS_WSM2

WCPHOST2

7010

No

Disabled

WSMPM-MAN-SVR

JRF-MAN-SVR

WSM-CACHE-SVR

WC_Portal1

WCPHOST1

9001

No

Disabled

WebCenter Portal Managed Server

WebCenter Portal Analytics Managed Server

WC_Portal2

WCPHOST2

9001

No

Disabled

WebCenter Portal Managed Server

WebCenter Portal Analytics Managed Server

WC_Portlet1

WCPHOST1

9002

No

Disabled

WebCenter Portal Pagelet Producer Managed Server

WebCenter Portal Portlet Producer Managed Server

WC_Portlet2

WCPHOST2

9002

No

Disabled

WebCenter Portal Pagelet Producer Managed Server

WebCenter Portal Portlet Producer Managed Server

WC_Collaboration1

WCPHOST1

9003

No

Disabled

WebCenter Portal Discussions Managed Server

WC_Collaboration2

WCPHOST2

9003

No

Disabled

WebCenter Portal Discussions Managed Server

Task 9   Configuring a Cluster

In the Configure Clusters screen, add three new clusters:

  • Portal_Cluster

  • Portlet_Cluster

  • Collab_Cluster

For all three clusters, leave the default values for Cluster Address, Frontend Host, and Port.

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 10   Assigning Managed Servers to the Cluster

Use the Assign Servers to Clusters screen to assign Managed Servers to their respective cluster:

  1. In the Clusters pane, select the cluster to which you want to assign the servers; in this case, Portal_Cluster.

  2. In the Servers pane, assign WC_Portal1 to Portal_Cluster by doing one of the following:

    • Click once on WC_Portal1 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 WC_Portal1 to move it beneath the selected cluster in the clusters pane.

  3. Repeat to assign WC_Portal2 to Portal_Cluster.

  4. Repeat steps 1-3 to assign WC_Portlet1 and WC_Portlet2 to Portlet_Cluster.

  5. Repeat steps 1-3 to assign WC_Collaboration1 and WC_Collaboration2 to Collaboration_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 11   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 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.

Task 12   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 13   Assigning Servers to Machines

Use the Assign Servers to Machines screen to assign the Managed Servers you just created to the corresponding machines in the domain.

Assign WC_Portal1, WC_Portlet1, WC_Collaboration1 to WCPHOST1.

Assign WC_Portal2, WC_Portlet2, WC_Collaboration2 to WCPHOST2.

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 14   Creating Virtual Targets

Click Next to proceed to the next screen.

Task 15   Creating Partitions

Click Next to proceed to the next screen.

Task 16   Deployments Targeting

With the Oracle Web Services Manager Policy Manager deployed to a separate cluster, the default targeting of the WSM-PM application to the Portal, Collaboration, and Portlet clusters can be removed.

For each of the Portal_Cluster, Collaboration_Cluster, and Portlet_Cluster in the Targets panel:

Select the wsm-pm application entry within the Application folder and click the left arrow button to remove it from the targets list.

Task 17   Services Targeting

With the Oracle Web Services Manager Policy Manager deployed to a separate cluster, the default targeting of the WSM-PM service resources to the Portal, Collaboration, and Portlet clusters can be removed.

For each of the Portal_Cluster, Collaboration_Cluster, and Portlet_Cluster in the Targets panel:

Select and remove the following two resources from the targets list:

  • mds-owsm

  • WSM Startup Class

Task 18   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 19   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 20   Start the Administration Server

Start the Administration Server to ensure the changes you have made to the domain have been applied.

12.5 Propagating the Extended Domain to the Domain Directories and Machines

After you have extended the domain with the Oracle WebCenter Portal instances, and you have started the Administration Server on WCPHOST1, you must then propagate the domain changes to the domain directories and machines.
  1. Create a copy of the Managed Server domain directory and the Managed Server applications directory.
  2. Run the following pack command on WCPHOST1 to create a template pack:
    cd ORACLE_COMMON_HOME/common/bin
    
    ./pack.sh -managed=true 
              -domain=ASERVER_HOME 
              -template=/full_path/wcpdomaintemplateExtWCP.jar 
              -template_name=wcpdomain_templateExtWCP
    

    In this example:

    • Replace ASERVER_HOME with the actual path to the domain directory you created on the shared storage device.

    • Replace full_path with the complete path to the directory where you want the template jar file saved.

    • wcpdomaintemplateExtWCP.jar is a sample name for the JAR file you are creating, which will contain the domain configuration files, including the configuration files for the Oracle HTTP Server instances.

    • wcpdomain_templateExtWCP is the name assigned to the domain template file.

  3. Run the following unpack command on WCPHOST1 to propagate the template created in the preceding step to the MSERVER_HOME directory:
    cd ORACLE_COMMON_HOME/common/bin
    
    ./unpack.sh -domain=MSERVER_HOME 
                -template=/full_path/wcpdomaintemplateExtWCP.jar 
                -app_dir=APPLICATION_HOME 
                -overwrite_domain=true
    

    In this example:

    • Replace MSERVER_HOME with the complete path to the domain home to be created on the local storage disk. This is the location where the copy of the domain will be unpacked.

    • wcpdomaintemplateExtWCP.jaris the directory path and name of the template you created when you ran the pack command to pack up the domain on the shared storage device.

    • The -overwrite_domain=true argument is necessary when you are unpacking a managed server template into an existing domain and existing applications directories.

      For any file that is overwritten, a backup copy of the original is created. If any modifications had been applied to the start scripts and ear files in the managed server domain directory, they must be restored after this unpack operation.

    • Replace APPLICATION_HOME with the complete path to the Application directory for the domain on local storage.

    Tip:

    For more information about the pack and unpack commands, see "Overview of the Pack and Unpack Commands" in Creating Templates and Domains Using the Pack and Unpack Commands.

  4. Run the following command on WCPHOST1 to copy the template pack created in step 1 to WCPHOST2:
    scp /full_path/wcpdomaintemplateExtWCP.jar oracle@WCPHOST2:/full_path/
    
    
  5. Run the following unpack command on WCPHOST2 to deploy the domain template copied in the preceding step to the local MSERVER_HOME domain directory:
    cd ORACLE_COMMON_HOME/common/bin
    
    ./unpack.sh -domain=MSERVER_HOME 
                -template=/full_path/wcpdomaintemplateWCP.jar 
                -app_dir=APPLICATION_HOME 
                -overwrite_domain=true
    

    In this example:

    • Replace MSERVER_HOME with the complete path to the domain home to be created on the local storage disk. This is the location where the copy of the domain will be unpacked.

    • wcpdomaintemplateWCP.jaris the directory path and name of the template you created when you ran the pack command to pack up the domain on the shared storage device.

    • The -overwrite_domain=true argument is necessary when you are unpacking a managed server template into an existing domain and existing applications directories.

      For any file that is overwritten, a backup copy of the original is created. If any modifications had been applied to the start scripts and ear files in the managed server domain directory, they must be restored after this unpack operation.

    • Replace APPLICATION_HOME with the complete path to the Application directory for the domain on local storage.

    Tip:

    For more information about the pack and unpack commands, see "Overview of the Pack and Unpack Commands" in Creating Templates and Domains Using the Pack and Unpack Commands.

12.6 Restarting and Validating Pre-existing Managed Servers

Restart the managed servers for the pre-existing components now that the domain has been extended and unpacked to the MSERVER_HOME directories on all of the servers.
  1. From the WebLogic Server Console, restart the WLS_WSMn Managed Servers for the WebServices Manager Policy Manager.
  2. From another browser window, verify the WSM-PM application is responding by successfully loading the URL:
    http://wcpinternal.example.com/wsm-pm/validator
    

12.7 Modifying the Upload and Stage Directories to an Absolute Path

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:

  1. Log in to the Oracle WebLogic Server Administration Console.

  2. In the left navigation tree, expand Domain, and then Environment.

  3. Click Lock & Edit.

  4. Click Servers.

  5. For each new Managed Server in the Managed Server domain home directory:

    1. Click the name of the Managed Server.

    2. Click the Configuration tab, and then click the Deployment tab.

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

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

    5. Click Save.

    6. Return to the Summary of Servers screen.

  6. When you have modified these values for each Managed Server, click Activate Changes.

12.8 Starting and Validating the WC_Portal1, WC_Portlet1, WC_Collaboration1 Managed Servers

Now that you have extended the domain, restarted the Administration Server, and propagated the domain to the other hosts, you can start the newly configured Oracle WebCenter Portal servers.

This process involves three tasks:

12.8.1 Starting the Managed Servers on WCPHOST1

To start the WC_Portal1 Managed Server:

  1. Enter the following URL into a browser to display the Fusion Middleware Control login screen:
    http://ADMINVHN:7001/em
    
  2. Log in to Fusion Middleware Control using the Administration Server credentials.
  3. In the Target Navigation pane, expand the domain to view the Managed Servers in the domain.
  4. Select only the WC_Portal1 Managed Server and click Start Up on the Oracle WebLogic Server toolbar.

    Note:

    WebCenter Portal Servers depend on the policy access service to be functional. This implies that the WSM-PM Managed Servers in the domain need to be up and running and reachable before the WebCenter Portal servers are started.

  5. When the startup operation is complete, navigate to the Domain home page and verify that the WC_Portal1 Managed Server is up and running.
  6. Repeat the above steps to start the WC_Portlet1 and WC_Collaboration1 Managed Servers on WCPHOST1.

12.8.2 Adding the WCPAdmin Role to the Portal Administrators Group

Before you validate the Oracle WebCenter Portal configuration on WC_Portal1 Managed Server, grant the WebCenter Portal administrator role to the WCPAdministrators LDAP group.

To perform this task, refer to Configuring Roles for Administration of Oracle WebCenter Portal Products.

12.8.2.1 Granting the Administrator Role for WebCenter Portal Using WLST

To grant the WebCenter Portal Administrator role using WLST:
  1. Create a group in the LDAP store named WCPAdministrators.

    This group will be assigned the Administrator role in WebCenter Portal.

    For more information on how to create a user, see Provisioning an Enterprise Deployment Administration User and Group and Adding the New Administration User to the Administration Group.

  2. Navigate to your WebCenter Portal Oracle home directory and invoke the WLST script:
    (UNIX) MW_HOME/wc/common/bin/wlst.sh
    
    (Windows) MW_HOME\wc\common\bin\wlst.cmd
    
  3. Connect to the Administration Server for the target domain with the following command:
    wls:/offline>connect("user_name","password", "host_name:port_number")
    
  4. Grant the WebCenter Portal Administrator application role to the WCPAdministrators group in LDAP using the grantAppRole command.
    grantAppRole(appStripe="webcenter", appRoleName="s8bba98ff_4cbb_40b8_beee_296c916a23ed#-#Administrator", principalClass="weblogic.security.principal.WLSGroupImpl", principalName="WCPAdministrators")
    

    Where WCPAdministrators is the name of the portal administration group you created earlier.

  5. Restart the WC_Portal1 Managed Server.
    shutdown('WC_Portal1', block='true', force='true')
    start('WC_Portal1', block='true')
    
  6. To test the new account, log in to WebCenter Portal using the new account name.

    Open WebCenter Portal in your browser using http://WCPHOST1:9001/webcenter. After logging in, the Administration link should appear, and you should be able to perform all administrative operations.

12.8.2.2 Granting the Administrator Role for WebCenter Portal Using Fusion Middleware Control

This section describes how to grant WebCenter Portal's Administrator role to a user account other than the default weblogic account.

To grant WebCenter Portal's Administrator role using Fusion Middleware Control:
  1. Log into Fusion Middleware Control as weblogic_wcp and navigate to the home page for WebCenter Portal.

    Note:

    When administering WebCenter resources in the Enterprise Manager Fusion Middleware Control, it is recommended to use the WebCenter-specific administrative user created in LDAP (for example, weblogic_wcp). For more information, see Adding the New Administration User to the Administration Group.

  2. Expand the Target Navigation panel by clicking on the button with the four grey horizontal lines in the top-left of the Enterprise Manager screen.
  3. Navigate to the portal instance status view. Expand the WebCenter > Portal > Server navigation elements. Click on the first portal instance listed (for example, WebCenter Portal (WC_Portal1)).
  4. From the WebCenter Portal menu, select Security, and then select Application Roles.
    The Application Roles page displays.
  5. Search for WebCenter Portal's Administrator role:
    1. Change the search form's Role Name option from Starts With to Includes.

    2. In the text box next to the Includes option, enter #Administrator, then click the blue search (arrow) icon.

  6. Click the returned row to select the Administrators role.
  7. Click the Edit menu option to open the Edit Application Role view.
  8. Click the Add menu option.
    The form to add members is displayed.
  9. Change the search type from Application Role to Group.
  10. Use the Search function to search for the WCPAdministrators LDAP group created earlier in Provisioning an Enterprise Deployment Administration User and Group.
  11. Click to select the correct row of search results for the WCPAdministrators group.
  12. Click OK to add the selected group to the role.
  13. On the Edit Application Role page, verify the updated list of members includes the newly added group.
  14. Click OK to save the changes to the Application Role.
  15. Restart the WC_Portal1 Managed Server.
    When you log in to WebCenter Portal as a member of the WCPAdministrators group, the Administration link should appear and you should be able to perform all administrative operations.

12.8.2.3 Granting the Administration Role for WebCenter Discussions using WLST

The WCPAdministrators LDAP group also needs to be granted an administrative role for the WebCenter Portal Discussions Services. Use the WLST commands listed here to apply that role grant for the LDAP group.
  1. Navigate to your WebCenter Portal Oracle home directory and invoke the WLST script:
    (Unix) ORACLE_COMMON_HOME/common/bin/wlst.sh
    (Windows) ORACLE_COMMON_HOME/common/bin/wlst.cmd
    
  2. Connect to the Administration Server for the target domain with the following command:
    wls:/offline>connect("user_name","password", "ADMINVHN:7001")
    
  3. Grant the Discussions Administrator privileges to the WCPAdministrators LDAP group using the addDiscussionsServerAdmin command.
    addDiscussionsServerAdmin(appName='owc_discussions', server='WC_Collaboration1', name='WCPAdministrators', type='GROUP')
    

    Where WCPAdministrators is the name of the portal administration group you created earlier.

  4. Restart the Collab_Cluster via WLST.
    shutdown('WC_Collaboration1', block='true', force='true') 
    start('WC_Collaboration1', block='true')
    
  5. To test the new account, log in to WebCenter Discussions Admin using the weblogic_wcp account name. Open WebCenter Discussions administration application in your browser using http://WCPHOST1:9003/owc_discussions/admin. If you can log in, the grant was successful.

12.8.3 Starting and Validating the Managed Servers on WCPHOST2

After you have validated the successful configuration and startup of the Managed Servers on WCPHOST1, you can then start and validate the new Managed Servers on WCPHOST2, using the procedure in Starting and Validating the WC_Portal1, WC_Portlet1, WC_Collaboration1 Managed Servers.

For the validation URL, enter the following in your Web browser and log in using the enterprise deployment administration user (weblogic_wcp):

http://WCPHOST2:9001/webcenter/

12.9 Configuring Analytics

Out-of-the box, analytics collectors are configured to communicate with the local WebCenter Portal application in a 1-1 relationship (the collectors listen on localhost). No additional analytics collector configuration is required.

However, you must configure the WebCenter Portal applications to send event messages to localhost:

Note:

Clustered analytics collectors are not supported for collecting WebCenter Portal events.

To connect the WebCenter Portal application to the analytics collector:

  1. Connect to the Managed Server where the WebCenter Portal application is running using WLST, for example:
    ORACLE_COMMON_HOME/common/bin/wlst.sh
    connect("weblogic_admin_username", "weblogic_admin_pwd", "t3://ADMINVHN:7001")
    

    Connect to the host and port of the WC_Portal server.

  2. Create a connection between the WebCenter Portal application and the analytics collector and make it the default connection (default=1).

    Note:

    The commands in this section need to be executed only once for the clustered Webcenter application, even though there is a specific server name listed for the connection. When this configuration is set, it applies to all servers.

    For example:

    createAnalyticsCollectorConnection(appName="webcenter", server="WC_Portal1", connectionName="Collector31314", isUnicast=1, collectorHost="localhost", collectorPort=31314, isEnabled=1, timeout=30, default=1)
    

    See also, the createAnalyticsCollectorConnection section in the WebLogic Scripting Tool Command Reference.

  3. Verify the changes made:
    listDefaultAnalyticsCollectorConnection(appName="webcenter", server="WC_Portal1")
    

    See also the listDefaultAnalyticsCollectorConnection section in the WebLogic Scripting Tool Command Reference.

12.10 Configuring REST APIs

This section describes the procedure to configure REST APIs.

If you want to use WebCenter Portal REST APIs, confirm the server-side credential store configuration by executing the commands described in this section.

These credential entries should already be configured as part of the domain extension for WebCenter Portal.

To confirm the seed entries in the credential store that enable the REST security tokens to function properly, execute these WLST commands:

Note:

If the credential maps already exist, JPS-01007 exceptions messages will be returned. This confirms the configuration.
  1. Connect to the Administration Server using the command-line Oracle WebLogic Scripting Tool (WLST), for example:
    ORACLE_COMMON_HOME/common/bin/wlst.sh
    connect('weblogic_admin_username','weblogic_admin_pwd','t3://ADMINVHN:7001')
    
  2. Run the following WLST commands to configure the credential store:
    createCred(map="o.webcenter.jf.csf.map", key="keygen.algorithm", 
         user="keygen.algorithm", password="AES") 
    createCred(map="o.webcenter.jf.csf.map", key="cipher.transformation", 
         user="cipher.transformation", password="AES/CBC/PKCS5Padding")
    
Later on, you must configure REST policies in OAM.

12.11 Modifying System Configuration MBean Values for the WebCenter Portal Content Manager Component

The WebCenter Portal Content Manager component and task flows utilize the WebCenter Content remote UI (RUI) APIs to provide content integration capabilities. While these libraries are directly included with the Portal installation, specific MBean configuration settings need to be modified for fail-safe runtime within a High Availability architecture.

Modify and validate the following attributes for the ADFConfig:WccAdfConfiguration and ADFConfig:ADFcConfig application-defined MBeans on the portal application:

  • ADFConfig:ADFcConfig:

    • AdfScopeHaSupport

  • ADFConfig:WccAdfConfiguration:

    • ClusterCompatible

    • TemporayDirectory

The upload temporary directory specified must be configured to a common directory location on a shared disk volume across all portal nodes when the portal is clustered in a High Availability environment.

  1. Create a unique folder on the ORACLE_RUNTIME shared volume for the Portal Content Manager component upload location.
    mkdir -p ORACLE_RUNTIME/DOMAIN_NAME/Portal_Cluster/wccAdfUpload
    

    For example,

    mkdir -p /u01/oracle/runtime/wcedg/Portal_Cluster/wccAdfUpload
    
  2. Log in to Fusion Middleware Control as weblogic_wcp.
  3. From the WebLogic Domain menu, select System MBean Browser.
  4. Under Application Defined MBeans, navigate to the WccAdfConfiguration attribute: oracle.adf.share.config > Server: WC_Portal1 > Application: webcenter > ADFConfig > ADFConfig >ADFConfig > WccAdfConfiguration

    Note:

    This MBean value only needs to be set once from any of the portal server instances and will apply to all.
  5. Set the ClusterCompatible attribute to a value of: true.
  6. Set the Temporary Directory attribute to the directory created above on shared storage.

    The Temporary Directory attribute must be set to a directory so that the uploaded files stored under that directory can be accessed by both WCPHOST1 and WCPHOST2.

    For example,

    /u01/oracle/runtime/wcedg/Portal_Cluster/wccAdfUpload
    
  7. Under Application Defined MBeans, navigate to the ADFcConfiguration attribute: oracle.adf.share.config > Server: WC_Portal1 > Application: webcenter > ADFConfig > ADFConfig >ADFConfig > ADFcConfiguration.
  8. Verify the AdfScopeHASupport attribute value is set to true, update if necessary, then click apply if an update is required.
  9. Click Apply and verify that a confirmation message appears at the top of the page.
  10. Navigate to the adf-config MBean to invoke the save operation. Click oracle.adf.share.config > Server: WC_Portal1 > Application: webcenter > ADFConfig > ADFConfig
  11. Click the Operations tab.
  12. Click Save Operation.
  13. On the Operation:save page, click Invoke to commit all the MBean changes made since the last save operation. Verify a confirmation message appears at the top of the page.
  14. Restart all managed servers in the portal cluster.

12.12 Configuring Oracle HTTP Server for the Extended Domain

The following sections describe how to configure the Oracle HTTP Server instances so they route requests for both public and internal URLs to the proper clusters in the enterprise topology.

12.12.1 Configuring Oracle HTTP Server for the Oracle WebCenter Portal Clusters

To configure the Oracle HTTP Server instances in the Web tier so they route requests correctly to the Oracle WebCenter Portal clusters, use the following procedure to create an additional Oracle HTTP Server configuration file that creates and defines the parameters of the wcp.example.com virtual server.

This procedure assumes you performed the Oracle HTTP Server configuration tasks described in Configuring Oracle HTTP Server to Route Requests to the Application Tier.

To create the virtual host configuration file so requests are routed properly:

  1. Log in to WEBHOST1 and change directory to the configuration directory for the first Oracle HTTP Server instance (OHS1):
    cd OHS_DOMAIN_HOME/config/fmwconfig/components/OHS/ohs1/moduleconf/
    
  2. Create the wcp_vh.conf file and add the following directive:
    <VirtualHost WEBHOST1:7777>
        ServerName https://wcp.example.com:443
        ServerAdmin you@your.address
        RewriteEngine On
        RewriteOptions inherit
    </VirtualHost>
    
  3. Add the following directives inside the <VirtualHost> tags:
    # WebCenter Portal Application (previously called Spaces) 
    <Location /webcenter>
        WLSRequest ON
        WebLogicCluster WCPHOST1:9001,WCPHOST2:9001
        WLProxySSL ON
        WLProxySSLPassThrough ON
    </Location>
    
    <Location /webcenterhelp>
        WLSRequest ON
        WebLogicCluster WCPHOST1:9001,WCPHOST2:9001
        WLProxySSL ON
        WLProxySSLPassThrough ON
    </Location>
    
    <Location /rss>
        WLSRequest ON
        WebLogicCluster WCPHOST1:9001,WCPHOST2:9001
        WLProxySSL ON
        WLProxySSLPassThrough ON
    </Location>
    
    <Location /rest>
        WLSRequest ON
        WebLogicCluster WCPHOST1:9001,WCPHOST2:9001
        WLProxySSL ON
        WLProxySSLPassThrough ON
    </Location>
    
    # Discussions
    <Location /owc_discussions>
        WLSRequest ON
        WebLogicCluster WCPHOST1:9003,WCPHOST2:9003
        WLProxySSL ON
        WLProxySSLPassThrough ON
    </Location>
    
    <Location /portalTools>
        WLSRequest ON
        WebLogicCluster WCPHOST1:9002,WCPHOST2:9002
        WLProxySSL ON
        WLProxySSLPassThrough ON
    </Location>
    
    <Location /wsrp-tools> 
        WLSRequest ON
        WebLogicCluster WCPHOST1:9002,WCPHOST2:9002
        WLProxySSL ON
        WLProxySSLPassThrough ON
    </Location>
    
    </VirtualHost>
    
  4. Copy the wcp_vh.conf file into the configuration directory for the second Oracle HTTP Server instance (ohs2) on WEBHOST2:
    scp OHS_DOMAIN_HOME/config/fmwconfig/components/OHS/ohs1/moduleconf/wcp_vh.conf \
    WEBHOST2:/OHS_DOMAIN_HOME/config/fmwconfig/components/OHS/ohs2/moduleconf/wcp_vh.conf
    
  5. Log in to WEBHOST2 and change directory to the configuration directory for the second Oracle HTTP Server instance (ohs2):
    cd OHS_DOMAIN_HOME/config/fmwconfig/components/OHS/ohs2/moduleconf/
    
  6. Edit the wcp_vh.conf and change any references to WEBHOST1 to WEBHOST2 in the <VirtualHost> directives.
  7. Restart both Oracle HTTP servers.

12.12.2 Configuring the WebLogic Proxy Plug-In

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.

  1. Log in to the Oracle WebLogic Server Administration Console.
  2. In the Domain Structure pane, expand the Environment node.
  3. Click Clusters.
  4. Select the cluster to which you want to proxy requests from Oracle HTTP Server.

    The Configuration: General tab is displayed.

  5. Scroll down to the Advanced section and expand it.
  6. Click Lock & Edit in the Change Center.
  7. Set WebLogic Plug-In Enabled to yes.
  8. Click Save and click Activate Changes.
  9. Click Activate Changes in the Change Center.
  10. Restart all Managed Servers in all of the clusters that you modified in this chapter.

12.12.3 Validating the Oracle WebCenter Portal Public Services URLs Through the Load Balancer

To validate the configuration of the Oracle HTTP Server virtual hosts and to verify that the hardware load balancer can route public service requests through the Oracle HTTP Server instances to the application tier:

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

  2. Verify that you can access these URLs:
    • https://wcp.example.com/rss

    • https://wcp.example.com/rest/api/resourceIndex

    • https://wcp.example.com/portalTools

    • https://wcp.example.com/wsrp-tools

    • https://wcp.example.com/owc_discussions

12.12.4 Configuring HTTP Server for Internal WebCenter Services

To configure the Oracle HTTP Server instances in the Web tier so they route requests correctly to the internal Oracle WebCenter services, use the following procedure to edit existing wcpinternal_vh.conf file.

This procedure assumes you performed the Oracle HTTP Server configuration tasks described in Configuring Oracle HTTP Server to Route Requests to the Application Tier.

To edit the virtual host configuration file so requests are routed properly:

  1. Log in to WEBHOST1 and change directory to the configuration directory for the first Oracle HTTP Server instance (ohs1):
    cd OHS_DOMAIN_HOME/config/fmwconfig/components/OHS/ohs1/moduleconf/
    
  2. Edit the wcpinternal_vh.conf file and add the following directives near the end of the file just above the last line: </VirtualHost>
    # WebCenter Portal Application Services
    
    <Location /webcenter>
        WLSRequest ON     
        WebLogicCluster WCPHOST1:9001,WCPHOST2:9001     
        WLProxySSL OFF
        WLProxySSLPassThrough OFF 
    </Location>  
    
    <Location /webcenterhelp>    
        WLSRequest ON
        WebLogicCluster WCPHOST1:9001,WCPHOST2:9001     
        WLProxySSL OFF
        WLProxySSLPassThrough OFF 
    </Location>
    
    <Location /rss>
        WLSRequest ON
        WebLogicCluster WCPHOST1:9001,WCPHOST2:9001
        WLProxySSL OFF
        WLProxySSLPassThrough OFF
    </Location>
    
    <Location /rsscrawl>
        WLSRequest ON
        WebLogicCluster WCPHOST1:9001,WCPHOST2:9001
        WLProxySSL OFF
        WLProxySSLPassThrough OFF
    </Location>
    
    <Location /sesUserAuth>
        WLSRequest ON
        WebLogicCluster WCPHOST1:9001,WCPHOST2:9001
        WLProxySSL OFF
        WLProxySSLPassThrough OFF
    </Location>
    
    <Location /rest>
        WLSRequest ON
        WebLogicCluster WCPHOST1:9001,WCPHOST2:9001
        WLProxySSL OFF
        WLProxySSLPassThrough OFF
    </Location>
    
    # Discussions
    <Location /owc_discussions>
        WLSRequest ON
        WebLogicCluster WCPHOST1:9003,WCPHOST2:9003
        WLProxySSL OFF
        WLProxySSLPassThrough OFF
    </Location>
    
    # Portlets
    <Location /pagelets>
        WLSRequest ON
        WebLogicCluster WCPHOST1:9002,WCPHOST2:9002
        WLProxySSL OFF
        WLProxySSLPassThrough OFF
    </Location>
    
    <Location /portalTools>
        WLSRequest ON
        WebLogicCluster WCPHOST1:9002,WCPHOST2:9002
        WLProxySSL OFF
        WLProxySSLPassThrough OFF
    </Location>
    
    <Location /wsrp-tools>
        WLSRequest ON
        WebLogicCluster WCPHOST1:9002,WCPHOST2:9002
        WLProxySSL OFF
        WLProxySSLPassThrough OFF
    </Location>
    
    # Collector
    <Location /collector>
        WLSRequest ON
        WebLogicCluster WCPHOST1:9001,WCPHOST2:9001
        WLProxySSL OFF
        WLProxySSLPassThrough OFF
    </Location>
    
    </VirtualHost>
    
  3. Copy the wcpinternal_vh.conf file into the configuration directory for the second Oracle HTTP Server instance (ohs2) on WEBHOST2:
    scp OHS_DOMAIN_HOME/config/fmwconfig/components/OHS/ohs1/moduleconf/wcpinternal_vh.conf \
    WEBHOST2:/OHS_DOMAIN_HOME/config/fmwconfig/components/OHS/ohs2/moduleconf/wcpinternal_vh.conf
    
  4. Log in to WEBHOST2 and change directory to the configuration directory for the second Oracle HTTP Server instance (ohs2):
    cd OHS_DOMAIN_HOME/config/fmwconfig/components/OHS/ohs2/moduleconf/
    
  5. Edit the wcpinternal_vh.conf file and change any references from WEBHOST1 to WEBHOST2 in the <VirtualHost> directives.
  6. Restart both Oracle HTTP servers.

12.12.5 Validating the Oracle WebCenter Portal Internal Services URLs Through the Load Balancer

To validate the configuration of the Oracle HTTP Server virtual hosts and to verify that the hardware load balancer can route internal service requests through the Oracle HTTP Server instances to the application tier:

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

  2. Verify that you can access these URLs:
    • http://wcpinternal.example.com/rss

    • http://wcpinternal.example.com/rest/api/resourceIndex

    • http://wcpinternal.example.com/pagelets

    • http://wcpinternal.example.com/portalTools

    • http://wcpinternal.example.com/wsrp-tools

    • http://wcpinternal.example.com/owc_discussions

12.13 Configuring WebCenter Portal for External Services

This section describes how to configure external tools and services for WebCenter Portal applications using Fusion Middleware Control or WLST commands. For most external services, you must set up a connection between the WebCenter Portal application and the backend server.

12.13.1 Configuring Default Web Service Policies for WebCenter Portal, Discussions, and Portlet Producer Applications

After installing Oracle WebCenter Portal, you must attach the default Oracle Web Services Manager (OWSM) security policy to the following:

  • WebCenter Portal application (webcenter)

  • Discussions application (owc_discussions)

  • WebCenter Services Portlet Producer (services-producer)

  • WSRP Tools Producer (wsrp-tools)

These steps are required because security policies for these Web service end points are not configured out-of-the-box.

To attach the default Web service security policy:
  1. Ensure that WC_Portal1, WC_Portal2, WC_Collaboration1, WC_Collaboration2, WC_Portlet1, and WC_Portlet2 managed servers are up and running.
  2. Start the WebLogic Scripting Tool:
    WCPHOST1> ORACLE_COMMON_HOME/common/bin/wlst.sh
    
  3. Connect to the Administration Server as an administrator.

    For example

    connect("weblogic_wcp","admin password","t3://ADMINVHN:7001")
    

    For information, see the "Running Oracle WebLogic Scripting Tool (WLST) Commands" section in Oracle Fusion Middleware Administering Oracle WebCenter Portal.

  4. Run WLST commands to attach the default OWSM security policy (oracle/wss10_saml_token_service_policy) to each of the following:
    • WebCenter Portal application (webcenter)

    • Discussions application (owc_discussions)

    • WebCenter Services Portlet Producer (services-producer)

    • WSRP Tools Producer (wsrp-tools)

    Note:

    In the examples in this topic, configure the application path with the domain name and managed server names for your environment. The examples below use the domain name wcedg.

    1. To attach the default OWSM security policy to the discussions Web service on each server in the cluster (WC_Collaboration1 and WC_Collaboration2), run the following WLST commands:
      attachWebServicePolicy(application='/domain_name/WC_Collaboration1/owc_discussions', moduleName='owc_discussions', moduleType='web', serviceName='OWCDiscussionsServiceAuthenticated', subjectName='OWCDiscussionsServiceAuthenticated', policyURI='oracle/wss10_saml_token_service_policy')
      
      
    2. Run the following WLST commands to attach the default OWSM security policy to the WSRP Tools Producer's Web service end point on each server in the cluster (WC_Portlet1 and WC_Portlet2):
      attachWebServicePolicy(application='/domain_name/WC_Portlet1/wsrp-tools', moduleName='wsrp-tools', moduleType='web', serviceName='WSRP_v2_Service', subjectName='WSRP_v2_Markup_Service', policyURI='oracle/wss10_saml_token_service_policy')
      
      
  5. Restart the WC_Portal1, WC_Portal2, WC_Collaboration1, WC_Collaboration2, WC_Portlet1, and WC_Portlet2 managed servers.

12.13.2 Configuring the Discussions Server Connection

If you want to provide discussions or announcements in WebCenter Portal, you must connect the application to a discussions server. To configure a connection for the WebCenter Portal Enterprise Deployment, the following values are required:

  • Discussions Server URL: http://wcpinternal.example.com/owc_discussions

  • Discussions Admin User: WebCenter Portal Admin user name from LDAP (for example, weblogic_wcp)

  • Discussions Admin Password: WebCenter Portal Admin user password

  • Authenticated User Web Service Policy URI: WSS 1.0 SAML Token Client Policy

You can connect to a discussions server using Fusion Middleware Control or WLST commands.

For more information, see "Managing Announcements and Discussions" in Administering Oracle WebCenter Portal.

12.13.2.1 Creating a Discussions Server Connection Using Fusion Middleware Control

To connect your WebCenter Portal application to a discussions server using Fusion Middleware Control:
  1. Ensure that at least one of the managed servers on which your application is deployed is up and running.

    For example, check one of the WC_Portal managed servers.

  2. Log on to the Enterprise Manager Fusion Middleware Control Console at the following URL:
    http://ADMINVHN:7001/em
    
  3. Navigate to the home page for your WebCenter Portal application.

    For example, to navigate to the home page for the WebCenter Portal application, open Target Navigation and select WebCenter > Portal > Server and then WebCenter Portal (WC_Portal1).

  4. From the WebCenter Portal drop-down menu, select Settings, and then Service Configuration.
  5. Click Discussions and Announcements, and then Add.
  6. In the Add Discussion and Announcement Connection screen:
    • Connection Name: DFConnection

    • Active Connection: Select this check box to enable the connection

    • Server URL: http://wcpinternal.example.com/owc_discussions

    • Administrator User Name: Name of a WebCenter Portal admin user from LDAP (for example, weblogic_wc)

    • Authenticated User Web Service Policy URI: Select WSS 1.0 SAML Token Client Policy (oracle/wss10_saml_token_client_policy)

  7. Click OK to save the settings.
  8. Restart the managed servers on which the application is deployed.

    For the WebCenter Portal application, restart all the managed servers in the Portal_Cluster.

12.13.2.2 Creating a Discussions Server Connection using WLST

If you want to use the command line, rather than Fusion Middleware Control, then you can connect your WebCenter Portal application to a discussions server using the WebLogic Scripting Tool.

  1. Start the WebLogic Scripting Tool:
    WCPHOST1> ORACLE_COMMON_HOME/common/bin/wlst.sh
    
  2. In WLST, connect as the administrator.

    For example:

    connect("weblogic_wcp","admin password","ADMINVHN:7001")
    
  3. Use the createDiscussionForumConnection command to connect to the discussions server.

    For example:

    createDiscussionForumConnection(appName="webcenter",name="DFConnection",
    url="http://wcpinternal.example.com/owc_discussions",
    adminUser="weblogic_wcp",default=1,policyURIForAuthAccess="oracle/wss10_saml_token_client_policy",server="WC_Portal1")
    

    Where webcenter is the name of the WebCenter Portal application deployed on WC_Portal1 and weblogic_wc is the name of the discussions server admin user.

    For more information, see "createDiscussionForumConnection" in the WebCenter WLST Command Reference.

  4. Restart the managed servers on which the application is deployed.

    For the WebCenter Portal application, restart all the managed servers in the Portal_Cluster.

12.13.3 Registering Portlet Producers

Several out-of-the-box portlet producers can be registered with the WebCenter Portal application. In the WebCenter Portal Enterprise Deployment, the required producer URLs are as follows:

  • WSRP Producer URL: http://wcpinternal.example.com/wsrp-tools/portlets/wsrp2?WSDL

  • WebClipping Producer URL: http://wcpinternal.example.com/portalTools/webClipping/providers

  • OmniPortlet Producer URL: http://wcpinternal.example.com/portalTools/omniPortlet/providers

You can register portlet producers using Fusion Middleware Control or WLST commands.

12.13.3.1 Registering Out-of-the-Box Portlet Producers using Fusion Middleware Control

For details on how to register portlet producers using Fusion Middleware Control, see "Managing Portlet Producers" in Administering Oracle WebCenter Portal.

12.13.3.2 Registering Out-of-the-Box Portlet Producers Using WLST

To register out-of-the-box portlet producers using WLST:
  1. Start the WebLogic Scripting Tool:
    WCPHOST1> ORACLE_HOME/oracle_common/common/bin/wlst.sh
    
  2. In WLST, connect as the administrator.

    For example:

    connect("weblogic_wcp","admin password","t3://ADMINVHN:7001",server="WC_Portal1")
    
  3. Register all three out-of-the-box WSRP and PDK-Java producers.

    For example:

    registerOOTBProducers(producerHost='wcpinternal.example.com',producerPort=80, appName='webcenter', server='WC_Portal1')
    

    Where webcenter is the name of the WebCenter Portal application deployed on WC_Portal1.

    See also, "registerOOTBProducers" in the WebCenter WLST Command Reference.

12.13.4 Registering the Pagelet Producer

If you want to expose WSRP and Oracle JPDK portlets and OpenSocial gadgets as pagelets in WebCenter Portal, you must register the pagelet producer. In the WebCenter Portal Enterprise Deployment, the required pagelet producer URL is:

http://wcpinternal.example.com/pagelets

You can register the pagelet producer using Fusion Middleware Control or WLST commands.

12.13.4.1 Registering Pagelet Producer Using Fusion Middleware Control

To register Pagelet Producer using Fusion Middleware Control:

  1. Log in to Fusion Middleware Control as weblogic_wcp, and navigate to the WebCenter Portal home page.

    Note:

    When administering WebCenter resources in the Enterprise Manager Fusion Middleware Control, it is recommended to use the WebCenter-specific administrative user created in the remote LDAP authenticator (for example, weblogic_wcp). For more information, see Configuring Roles for Administration of an Enterprise Deployment.

    For more information, see “Navigating to the Home page for WebCenter Portal” in Administering Oracle WebCenter Portal .

  2. From the WebCenter Portal menu, select Register Producer.

  3. Enter connection details for Pagelet Producer, as shown in the following table.

    Field Description

    Connection Name

    A unique name to identify this Pagelet Producer instance within the application. The name must be unique across all WebCenter Portal connection types. The name specified here appears in Composer under the UI Components > Pagelet Producers folder (by default).

    Producer Type

    Select Pagelet Producer.

    Server URL

    The URL to Pagelet Producer. The URL must include a fully-qualified domain name. Use the following syntax:

    <protocol>://<host_name>:<port_number>/pagelets/

    For example:

    http://wcpinternal.example.com/pagelets/

    If pagelets contain secure data, the registered URL must use the https protocol. For example:

    https://wcp.example.com/pagelets/

    The context root can be changed from /pagelets/ if necessary; for details, see “Redeploying Pagelet Producer to a Different Context” in Administering Oracle WebCenter Portal.

    Note: In WebCenter Portal, if the Pagelet Producer URL is protected by OAM, the URL to the pagelet catalog must be excluded (mapped directly without access control), or the catalog will appear to be empty when using REST. The pagelet catalog URL is http://<host_name>:<port_number>/ pagelets/api/v2/ensemble/pagelets

  4. Click OK. The new producer appears in the connection table.

12.13.4.2 Registering Pagelet Producer Using WLST

To register out-of-the-box pagelet producers using WLST:

  1. Start the WebLogic Scripting Tool:

    WCPHOST1> ORACLE_COMMON_HOME/common/bin/wlst.sh

  2. In WLST, connect as the administrator.

    For example,

    connect("weblogic_wcp","admin password","t3://ADMINVHN:7001",server="WC_Portal1")

  3. Register the pagelet producer by entering the following command.

    registerPageletProducer(appName='webcenter', name='PageletProducer', url='http://wcpinternal.example.com/pagelets', server='WC_Portal1')

For command syntax and examples, see registerPageletProducer in WebCenter WLST Command Reference.

You can also use WLST to list or edit the current connection details.

For information on how to run WLST commands, see “Running Oracle WebLogic Scripting Tool (WLST) Commands” in Administering Oracle WebCenter Portal.

12.13.5 Configuring Search Services

You can configure Oracle Secure Enterprise Search (Oracle SES) services and crawlers using procedures in the "Managing Oracle SES Search" section in Oracle Fusion Middleware Administering Oracle WebCenter Portal.

Ensure that:

  • Oracle Secure Enterprise Search is registered with Oracle Internet Directory and the WebCenter Portal application is configured as an Oracle SES trusted entity, as described in the "Oracle SES - Configuration" section in Oracle Fusion Middleware Administrator's Guide for Oracle WebCenter Portal.

  • Connection exists between the WebCenter Portal application and Oracle Secure Enterprise Search, as described in the "Setting Up Oracle SES Connections" section in Oracle Fusion Middleware Administering Oracle WebCenter Portal.

Ensure that any new URLs are added to the wcpinternal.example.com host in the wcinternal_vh.conf file as follows:

<Location /rsscrawl>
    WLSRequest ON
    WebLogicCluster WCPHOST1:9001,WCPHOST2:9001
    WLProxySSL OFF
    WLProxySSLPassThrough OFF
</Location>

<Location /sesUserAuth>
    WLSRequest ON
    WebLogicCluster WCPHOST1:9001,WCPHOST2:9001
    WLProxySSL OFF
    WLProxySSLPassThrough OFF
</Location> 

12.13.6 Configuring Oracle WebCenter Portal Notifications for the SMTP Mail Server

In a WebCenter Portal Enterprise Deployment, if you choose to send notifications using mail, you must configure a connection to your corporate mail server and specify several unique parameters for the sent emails to appear correctly.

To ensure sufficient configuration for your mail server and business requirements, before completing this task, review Managing Mail in Administering Oracle WebCenter Portal for details on the required and optional configurations and parameters.

You can register a mail server using Fusion Middleware Control or WLST commands:

12.13.6.1 Registering Mail Servers Using Fusion Middleware Control

For details on how to register a mail server using Fusion Middleware Control, see Registering Mail Servers Using Fusion Middleware Control in Administering Oracle WebCenter Portal.

12.13.6.2 Registering Mail Servers Using WLST

Use the WLST command createMailConnection to create a mail server connection.
  1. Start the WebLogic Scripting Tool:
    ORACLE_HOME/oracle_common/common/bin/wlst.sh
    
  2. Connect to the Administration Server.

    For example:

    connect('weblogic_wcp','admin password','t3://ADMINVHN:7001')
    
  3. Register an External Application Connection for the mail server:
    createMailExtAppConnection(appName='webcenter', name='CorpMailServer', displayName='Corporate Mail Server', server='WC_Portal1')
    
  4. Register a Mail Server Connection:
    createMailConnection(appName='webcenter', name='NotificationSharedConn', smtpHost='mail.example.com', smtpPort=25, smtpSecured=0, 
    timeout=10, default=1,appId='CorpMailServer', server='WC_Portal1')
    

    Note:

    Additional capabilities are available and might be required depending on your mail server and business needs, such as the ability to notify distribution lists. For more information, see Managing Mail in Administering Oracle WebCenter Portal.

  5. Set the required mail server connection properties.

    These properties ensure that a specific mail address is the same in the external application and in the mail server. These properties are added to the mail connection and are used by mail for the From, Display Name, and Reply To fields.

    For example:

    setMailConnectionProperty(appName='webcenter', name='NotificationSharedConn', key='mail.user.emailAddress', value='john.doe@example.com')
    
    setMailConnectionProperty(appName='webcenter', name='NotificationSharedConn', key='mail.user.displayName', value='John Doe')
    
    setMailConnectionProperty(appName='webcenter', name='NotificationSharedConn', key='mail.user.replyToAddress', value='feedback@example.com')
    
  6. For Exchange 2007 only, create a universal distribution list. To do this, you must update the value of the mail.exchange.dl.group.type property from 2 (default value) to 8.

    Specify a value of 8 for the mail.exchange.dl.group.type mail property, as follows:

    setMailServiceProperty(appName='webcenter', property='mail.exchange.dl.group.type', value='8')
    

    If your application offers a self-registration page with the facility to mail user ID information on request, then you must ensure that public credentials are configured for the external application selected here. If public credentials are not defined, then mail cannot be sent to users on their request. WebCenter Portal offers this feature on its default self-registration page.

  7. Restart the Portal cluster:
    shutdown('Portal_Cluster', 'Cluster',force='true',block='true')    
    start('Portal_Cluster', 'Cluster',block='true')