7 Upgrading an Oracle WebCenter Environment

This chapter describes how to upgrade your Oracle WebCenter environment from Oracle Application Server 10g to Oracle Fusion Middleware 11g.

Upgrading this environment and your applications includes the following tasks:

Task 1: Decide Upon an Oracle WebCenter Topology
Task 2: If Necessary, Upgrade the Oracle Database That Hosts the Oracle WebCenter Schemas
Task 3: Use the Repository Creation Utility to Install the 11g Oracle WebCenter Schemas
Task 4: Install and Configure the Oracle WebCenter Middle Tiers
Task 5: Configure Any Required Java EE Features to Support Your Oracle WebCenter Applications
Task 6: Upgrade Back-End Components for WebCenter Services

7.1 Task 1: Decide Upon an Oracle WebCenter Topology

Before you begin the upgrade process, decide upon a topology for your new Oracle Fusion Middleware 11g environment.

For more information, see Section 3.3, "Information for Oracle WebCenter Users".

7.2 Task 2: If Necessary, Upgrade the Oracle Database That Hosts the Oracle WebCenter Schemas

If you are upgrading an Oracle WebCenter environment, you must ensure that the version of the database where you plan to install the Oracle WebCenter schemas is a supported by Oracle Fusion Middleware 11g.

You can install a new database, or upgrade your existing database to a supported version.

For instructions on verifying that your database meets the requirements of Oracle Fusion Middleware 11g, see "Upgrading and Preparing Your Databases" in the Oracle Fusion Middleware Upgrade Planning Guide.

7.3 Task 3: Use the Repository Creation Utility to Install the 11g Oracle WebCenter Schemas

If you are upgrading to Oracle WebCenter, use the Repository Creation Utility to install the schemas in the database you identified and prepared in Task 2: If Necessary, Upgrade the Oracle Database That Hosts the Oracle WebCenter Schemas.

For more information, refer to the following sections:

Running the Repository Creation Utility in Preparation for an Oracle WebCenter Upgrade
Selecting the Schemas Required for an Oracle WebCenter Upgrade

7.3.1 Running the Repository Creation Utility in Preparation for an Oracle WebCenter Upgrade

To start the Repository Creation Utility, you run the rcu command, which is in the root directory of the Repository Creation Utility CD-ROM or (if you have already installed the Oracle WebCenter software on disk) in the bin directory of the Oracle WebCenter Oracle home.

For more detailed instructions on how to obtain and run RCU, refer to the Oracle Fusion Middleware Repository Creation Utility User's Guide.

For more information about which schemas to select when running the Repository Creation Utility, refer to Section 7.3.2, "Selecting the Schemas Required for an Oracle WebCenter Upgrade".

For more information about the Oracle WebCenter schemas that are installed by the Repository Creation Utility, refer to "Metadata Repository Schemas" in the Oracle Fusion Middleware Administrator's Guide.

7.3.2 Selecting the Schemas Required for an Oracle WebCenter Upgrade

You can use RCU to install the schemas required for all of the Oracle Fusion Middleware software components that require a schema. However, there is no need to install all the schemas unless you plan to install a complete Oracle Fusion Middleware environment and you plan to use the same database for all the Oracle Fusion Middleware component schemas.

For a Oracle WebCenter upgrade, you must select the following schemas when you prompted by the Repository Creation Utility (as shown in Figure 7-1):

Select the Metadata Services schema in the AS Common Schemas category.

This schema supports Oracle Fusion Middleware Metadata Services (MDS), which is required by the Oracle WebCenter Spaces component.
Select the entire Oracle WebCenter category of schemas.

These are the schemas supported by the various Oracle WebCenter 11g

Figure 7-1 Selecting the Required Schemas for Oracle WebCenter

Description of "Figure 7-1 Selecting the Required Schemas for Oracle WebCenter"

7.4 Task 4: Install and Configure the Oracle WebCenter Middle Tiers

Before you upgrade to Oracle Fusion Middleware 11g, you must install an Oracle Fusion Middleware environment that is similar to the topology you set up for Oracle Application Server 10g.

For complete instructions on installing Oracle Fusion Middleware, refer to the following documentation resources:

Table 7-1 provides a high-level summary of the main steps you must perform when installing and configuring the Oracle WebCenter middle tiers, as well as specific references to the procedures you must follow for each step in the Oracle Fusion Middleware Installation Guide for Oracle WebCenter.

Note that the procedures described in this section assume you have downloaded the latest version of Oracle WebLogic Server and Oracle Fusion Middleware 11g. For more information, refer to "Obtaining the Latest Oracle WebLogic Server and Oracle Fusion Middleware 11g Software" in the Oracle Fusion Middleware Upgrade Planning Guide.

Table 7-1 Main Steps Required to Install and Configure the Oracle WebCenter Middle Tiers

Step #	Description	Section	Book
1	Install Oracle WebLogic Server and create the Middleware home	"Running the Installation Program in Graphical Mode"	Oracle Fusion Middleware Installation Guide for Oracle WebLogic Server
2	Install the Oracle WebCenter software and create the Oracle WebCenter Oracle home	"Installing Oracle WebCenter"	Oracle Fusion Middleware Installation Guide for Oracle WebCenter
3	Configure the Oracle SOA Suite domain	"Configuring Oracle WebCenter"	Oracle Fusion Middleware Installation Guide for Oracle WebCenter
4	Start the Oracle WebLogic Server domain	"Starting the Servers"	Oracle Fusion Middleware Installation Guide for Oracle SOA Suite and Oracle Business Process Management Suite
5	Verify the installation	"Verifying the Installation and Configuration"	Oracle Fusion Middleware Installation Guide for Oracle SOA Suite and Oracle Business Process Management Suite

7.5 Task 5: Configure Any Required Java EE Features to Support Your Oracle WebCenter Applications

Besides the Oracle WebCenter system components, which are installed during the Oracle WebLogic Server installation, you might have to configure additional Oracle WebLogic Server features to support the Oracle WebCenter applications you deploy.

For example, you may have to define application-required data sources, JMS resources, or other services. The resources and services provided by the Oracle WebLogic Server domain are common to all Java-based applications, including Oracle WebCenter applications.

For more information, see the Oracle Fusion Middleware Upgrade Guide for Java EE.

7.6 Task 6: Upgrade Back-End Components for WebCenter Services

Oracle WebCenter provides a set of WebCenter services that expose social networking and personal productivity features for inclusion in WebCenter applications. Some of these services, such as Documents and Discussions, rely on back-end components. This section describes the back-end servers that you may need to prepare for working with Oracle WebCenter 11g.

This section includes the following sections:

Upgrading Oracle WebCenter Discussions
Upgrading Oracle Content Server
Migrating Oracle WebCenter Wiki and Blog Server Data

7.6.1 Upgrading Oracle WebCenter Discussions

If your WebCenter Portal applications and WebCenter Spaces use the Discussions and Announcements services, you must install Oracle WebCenter Discussions Server 11g, and upgrade the database schema of your existing Oracle WebCenter Discussions 10.1.3.x server to Oracle WebCenter Discussions Server 11g.

Table 7-2 lists the tasks involved in upgrading Oracle WebCenter Discussions 10.1.3.x to Oracle WebCenter Discussions 11g.

Table 7-2 Tasks for Upgrading Oracle WebCenter Discussions

Step	Mandatory/Optional
Back up Oracle WebCenter Discussions database schema	Mandatory
Delete SSO-related system properties	Required only if SSO is configured
Install Oracle WebCenter Discussions 11g, if not already installed	Mandatory
Modify the database connection of Oracle WebCenter Discussions 11g server to read data from the data store used by Oracle WebCenter Discussions 10.1.3.x	Mandatory
Use Jive Forums Upgrade Console to upgrade the discussions server	Mandatory
Configure WS-Security	Required only if SAML is enabled
Reconfigure SSO	Required only if SSO needs to be enabled

This section describes how to upgrade from Oracle WebCenter Discussions 10.1.3.x to Oracle WebCenter Discussions 11g.

To prepare your Oracle WebCenter Discussions 10.1.3.x server for upgrade:

Back up your Oracle WebCenter Discussions database schema.

Tip:
To find out the path to your database schema, log on to the Oracle WebCenter Discussions Admin Console as an administrator. From the System link at the top of the console, navigate to the System Information page. On this page, the Datasource Info section displays various details of your database schema, including the connection URL and the user name.
Remove the SSO-related system properties, if configured.

Note:
In Oracle WebCenter Discussions 11g, Single Sign-On (SSO) configuration has changed from Oracle WebCenter Discussions 10.1.3.x. If SSO is configured for Oracle WebCenter Discussions 10.1.3.x server and SSO-related system properties have been set to Oracle-specific SSO custom classes, then to avoid any SSO-related errors, you must disable the SSO configuration before you install Oracle WebCenter Discussions 11g. After upgrading your discussions server, you must reconfigure SSO if you require SSO authentication.

To remove the SSO-related system properties:
1. Log on to the Oracle WebCenter Discussions Admin Console as an administrator by using the following URL format:
```
http://host:port/owc_discussions/admin
```
  Where host and port refer to the server and port number where your Oracle WebCenter Discussions 10g server is deployed.
2. On the System page of the Jive Forum Admin Console, in the navigation panel on the right, click System Properties.
3. On the Jive Properties page, under All Properties, delete the AuthFactory.className system property if it is set to the Oracle-specific custom class for SSO, oracle.jive.sso.OracleSSOAuthFactory.
4. Remove the UserManager.className system property if it is set to the Oracle-specific custom class for SSO, oracle.jive.sso.OracleSSOUserManager.

To upgrade Oracle WebCenter Discussions 10.1.3.x server to Oracle WebCenter Discussions 11g:

Ensure that Oracle WebCenter Discussions 11g is installed.

You can choose to install Oracle WebCenter Discussions Server 11g while installing Oracle WebCenter 11g or you can extend your WebCenter domain later to install this component. For information, see Oracle Fusion Middleware Installation Guide for Oracle WebCenter.
Modify the database connection of your Oracle WebCenter Discussions 11g server to read data from the data source used by your Oracle WebCenter Discussions 10.1.3.x server. To edit the database connection, either use the Oracle WebLogic Server Administration Console or export/import your Oracle WebCenter Discussions 10.1.3.x server's database schema.

To use the database export and import commands to configure your database connection, export your Oracle WebCenter Discussions 10.1.3.x server's database schema to a dump file. Then, import the contents of the dump file into the database schema installed during the RCU installation for Oracle WebCenter Discussions server 11g.

To edit the database connection by using the Oracle WebLogic Server Administration Console:
1. Log on to Oracle WebLogic Server Administration Console as an administrator. Use the following URL format:
```
http://host:port/console
```
  Where host and port refer to the host name and port number where your Oracle WebLogic Server is installed. By default, the port number is 7001.
2. In Oracle WebLogic Server Administration Console, under Domain Structure, navigate to Services > DataSources.
3. On the Summary of Data Sources page, in the Data Sources table, click the OWC_DiscussionsDS connection link.
4. On the Settings for DiscussionsDS page, click the Connection Pool tab.
  
  Modify the database connection of your Oracle WebCenter Discussions 11g server to read data from your Oracle WebCenter Discussions 10.1.3.x server data store.
5. In the URL field on the Connection Pool tab, change the JDBC URL to point to the database used by Oracle WebCenter Discussions 10.1.3.x.
6. In the Properties field, change the user name to the one used for connecting to the database of Oracle WebCenter Discussions 10.1.3.x.
7. In the Password field, change the password to the one used for connecting to the database of Oracle WebCenter Discussions 10.1.3.x.
8. Click Save.
Restart the WC_Collaboration managed server where your Oracle WebCenter Discussions 11g is deployed.
Log on to Oracle WebCenter Discussions 11g server as an administrator. Use the following URL format: http://host:port/owc_discussions.
In case the Jive Forums Upgrade Console displays, log on to the console as an administrator.
In Jive Forums Upgrade Console, select all the checkboxes to confirm that you have backed up your database and Jive Forum configuration files and to confirm the location of your jiveHome directory. (Figure 7-2)

Figure 7-2 Jive Forums Upgrade Console

Description of "Figure 7-2 Jive Forums Upgrade Console"
Click Start Upgrade to upgrade the database schema for your discussions server.

After all upgrade tasks have been completed, a confirmation message is displayed.
Restart the WC_Collaboration managed server where your Oracle WebCenter Discussions 11g is deployed.
Access your newly upgraded Oracle WebCenter Discussions server.
Configure Web Services Security (WS-Security) trust authentication on Oracle WebCenter Discussions and in your WebCenter applications if you plan to use this discussions server with WebCenter applications. WS-Security establishes a trust relationship between your WebCenter applications and Oracle WebCenter Discussions.

For information about how to configure WS-Security, see the "Configuring WS-Security" chapter in Oracle Fusion Middleware Administrator's Guide for Oracle WebCenter.
Reconfigure SSO for Oracle WebCenter Discussions, if required. For information, see the "Configuring Single Sign-On" chapter in Oracle Fusion Middleware Administrator's Guide for Oracle WebCenter.

7.6.2 Upgrading Oracle Content Server

Oracle WebCenter 11g supports Oracle Content Server 10.1.3.5.1 and Oracle Content Server 11g as external content repositories. If you already have Oracle Content Server 10g installed, you must upgrade it to either Oracle Content Server 10.1.3.5.1 or Oracle Content Server 11g.

Note:

It is strongly recommended that you use Oracle Content Server 11g as the content repository for Oracle WebCenter 11g to take advantage of the full set of features. If you use Oracle Content Server 10.1.3.5.1, you will have access only to a subset of features. For information, see section "Upgrading Oracle Universal Content Management 10g" in Oracle Fusion Middleware Patching Guide.

Refer to the following links depending on the version of Oracle Content Server you wish to upgrade to:

Note:

If you do not already have Oracle Content Server installed, install Oracle Content Server 11g. For information, refer to Oracle Fusion Middleware Installation Guide for Oracle Enterprise Content Management Suite.

Upgrading to Oracle Content Server 11g:
1. Upgrade your existing Oracle Content Server 10g installation to Oracle Content Server 11g. For information, see Oracle Fusion Middleware Upgrade Guide for Enterprise Content Management.
2. Configure Oracle Content Server 11g for Oracle WebCenter. For information, see the section "Oracle Content Server Prerequisites" in Oracle Fusion Middleware Administrator's Guide for Oracle WebCenter.
Upgrading to Oracle Content Server 10.1.3.5.1: To patch your existing Oracle Content Server 10g installation to Oracle Content Server 10.1.3.5.1, you must install the latest UpdateBundle and the Folders_g component. For this, you must:
1. Download the latest UpdateBundle, CS10gR35UpdateBundle component from the following location:
  
  http://support.oracle.com
2. Install the latest UpdateBundle, and then Folders_g.
  
  The update bundle contains zip files for various other components, including Folders_g. When you install the update bundle, the zip files are extracted to the following directory:
  
  content_server_install_home/custom/CS10gR35UpdateBundle/extras
  
  For installation information, see section "Uploading a Component" in the "Working with Content Server Components" guide available here:
  
  http://download.oracle.com/docs/cd/E10316_01/cs/cs_doc_10/documentation/developer/using_components_10en.pdf
3. Configure Oracle Content Server 10.1.3.5.1, if required. For information, see the section "Oracle Content Server 10.1.3.5.1 - Configuration" in Oracle Fusion Middleware Administrator's Guide for Oracle WebCenter.

7.6.3 Migrating Oracle WebCenter Wiki and Blog Server Data

To support the wiki and blog functionality, Oracle WebCenter 10g relies on Oracle WebCenter Wiki and Blog Server, whereas Oracle WebCenter 11g relies on Oracle Content Server 11g. If your Oracle WebCenter 10g environment has Oracle WebCenter Wiki and Blog Server configured, you must migrate all your wiki and blog data to Oracle Content Server 11g. For information, see Section 15.5.1, "Migrating Data from Oracle WebCenter Wiki and Blog Server."