3 Configuring Oracle WebCenter

This chapter describes how to configure Oracle WebCenter after the components have already been installed.

The following topics are covered:

Section 3.1, "Configuration Instructions"
Section 3.2, "Post-Configuration Tasks"
Section 3.3, "Working with Oracle WebCenter Components"

3.1 Configuration Instructions

After the installation is complete, you can configure the components using the Oracle Fusion Middleware Configuration Wizard.

If this is a new installation and you need to create a new domain, follow the instructions in Section 3.1.6, "Creating a New Domain". You can also run the Configuration Wizard to extend an existing domain, as described in Section 3.1.7, "Extending an Existing Domain".

3.1.1 Using Default Settings for Managed Servers

During the configuration, the Oracle Fusion Middleware Configuration Wizard automatically creates managed servers in the domain to host the Fusion Middleware system components. Oracle recommends that you use the default configuration settings for these managed servers. If you modify the default configuration settings, then you will have to perform some manual configuration steps before the Fusion Middleware environment can be started.

By default, the following Managed Servers are created:

WLS_Spaces - Hosts Oracle WebCenter Spaces
WLS_Portlet - Hosts Oracle WebCenter Portlets
WLS_Services - Hosts Oracle WebCenter Discussions and Oracle WebCenter Wiki and Blog Server

3.1.2 Shutting Down Running Managed Servers

Before you start the Configuration Wizard, you must shut down any managed servers that are currently running. If you do not, validation of your managed servers will fail due to port number conflicts from the managed servers that are currently running.

For more information, see "Starting and Stopping Oracle Fusion Middleware" in Oracle Fusion Middleware Administrator's Guide.

3.1.3 Running the Configuration Wizard with an Oracle RAC Database

If you are running the Configuration Wizard with a backend Oracle RAC database, Oracle recommends that you keep all the Oracle RAC instances configured for the service to be up and running. This will ensure that JDBC validation checks are reliable and minimize the possibility of accidental mis-configuration.

For more information, refer to Oracle Fusion Middleware High Availability Guide.

3.1.4 Starting the Oracle Fusion Middleware Configuration Wizard

Start the Configuration Wizard from the WebCenter_ORACLE_HOME/common/bin (on UNIX operating systems) or WebCenter_ORACLE_HOME\common\bin (on Windows operating systems) directory.

On UNIX operating systems:

./config.sh

On Windows operating systems:

config.cmd

If this is a new installation and you need to create a new WebLogic domain, follow the instructions in Section 3.1.6, "Creating a New Domain". You can also run the Configuration Wizard to extend an existing WebLogic domain, as described in Section 3.1.7, "Extending an Existing Domain".

If you are using a 32-bit operating system, Oracle JRockit SDK is installed as part of the Oracle WebLogic installation. This is the JDK that the Configuration Wizard will use by default. If you want to invoke the Configuration Wizard with the Sun JDK, do the following prior to starting the Configuration Wizard:

Set the JAVA_HOME environment variable to the location of the Sun JDK. For example, you can set it to the Sun JDK that was installed with Oracle WebLogic Server in the MW_HOME/jdk160_14_R27.6.4-18 (on UNIX operating systems) or MW_HOME\jdk160_14_R27.6.4-18 (on Windows operating systems) directory.
Set the JAVA_VENDOR environment variable to "Sun".

3.1.5 Creating a Configuration Log File

Log files of your configuration session are created in the WebCenter_ORACLE_HOME/common/bin (on UNIX operating systems) or WebCenter_ORACLE_HOME\common\bin (on Windows operating systems) directory. For more information about the Configuration Wizard log files, see Section D.2.2, "Configuration Log Files".

3.1.6 Creating a New Domain

Follow the instructions in "Creating a WebLogic Domain" in Oracle WebLogic Server Creating WebLogic Domains Using the Configuration Wizard to create a new WebLogic domain for your Oracle WebCenter components.

3.1.6.1 Select Domain Source Screen Notes

On Windows platforms, if you choose to install Oracle WebCenter Wiki and Blog Server to use the Wiki and Blog services in Oracle WebCenter, then you must modify the DOMAIN_HOME\bin\setDomainEnv.cmd.

Search for the following entry in the setDomainEnv.cmd file:

if "%WC_APPSDIR_ARGUMENT%"=="" { 
set %WC_APPSDIR_ARGUMENT%=-Dwc.apps.dir=%WC_APPS_DIR% 
set EXTRA_JAVA_PROPERTIES=%WC_APPSDIR_ARGUMENT% %EXTRA_JAVA_PROPERTIES% 
}

Replace the entry with the entry given below. The exact changes that you need to make are marked in bold.

if "%WC_APPSDIR_ARGUMENT%"=="" { 
set %WC_APPSDIR_ARGUMENT%=-Dwc.apps.dir=%WC_APPS_DIR% 
set EXTRA_JAVA_PROPERTIES=-Dwc.apps.dir=%WC_APPS_DIR% %EXTRA_JAVA_PROPERTIES% 
}

3.1.6.2 Configure Administrator Username and Password Screen Notes

The domain administrator you create for Oracle WebCenter is also the administrator for WebCenter Spaces, Oracle WebCenter Discussions, and Oracle WebCenter Wiki and Blogs Server. You can choose to grant domain administrative rights for these WebCenter components to a different user. For information about granting the administrator role to a nondefault user for:

WebCenter Spaces, see "Granting the WebCenter Spaces Administrator Role to a WebCenter Spaces User" in the Oracle Fusion Middleware Administrator's Guide for Oracle WebCenter.
Oracle WebCenter Discussions, see "Granting Administrator Role for Oracle WebCenter Discussions Server" in the Oracle Fusion Middleware Administrator's Guide for Oracle WebCenter.
Oracle WebCenter Wiki and Blog Server, see the "Managing Users and Roles" section in the Oracle Fusion Middleware Administrator's Guide for Oracle WebCenter.

3.1.7 Extending an Existing Domain

While creating your WebCenter domain, if you chose not to configure any of the following components, you can add them later by extending your domain: Oracle WebCenter Spaces, Oracle WebCenter Portlets, Oracle WebCenter Discussion Server, and Oracle WebCenter Wiki and Blogs Server. If this is a first time configuration or you do not want to add more components, you can skip this section and move to the next section.

Follow the instructions in "Extending WebLogic Domains" in Oracle WebLogic Server Creating WebLogic Domains Using the Configuration Wizard to extend an existing domain.

Note:

Before proceeding, make sure that schemas exist in your database for the components you are configuring when you extend the domain. For example, if you are planning to extend the domain and configure Oracle WebCenter Discussion Server, then make sure the prefix_DISCUSSIONS schema exists in your Oracle database before you continue.

3.2 Post-Configuration Tasks

This section contains general information that will help you verify your installation and configuration. Some components may require custom or manual configuration, and this information is also included in this section:

Section 3.2.1, "Starting the Servers"
Section 3.2.2, "Starting Managed Servers from the Administration Console"
Section 3.2.3, "Starting Node Manager"
Section 3.2.4, "Verifying the Installation"

3.2.1 Starting the Servers

To get your deployments up and running, you must start the Administration Server and various Managed Servers:

Run the startWebLogic.sh (on UNIX operating systems) or startWebLogic.cmd (on Windows operating systems) script in the directory where you created your new domain. The default location is MW_HOME/user_projects/domains/domain_name (on UNIX operating systems) or MW_HOME\user_projects\domains\domain_name (on Windows operating systems).

This information was provided on the Specify Domain Name and Location Screen in the Configuration Wizard.
Run the startManagedWebLogic.sh (on UNIX operating systems) or startManagedWebLogic.cmd (on Windows operating systems) script in the bin directory inside the directory where you created your domain.

This command also requires that you specify a server name. The servers that need to be started are:
- WLS_Spaces (Oracle WebCenter Spaces)
- WLS_Portlet (Oracle WebCenter Portlets)
- WLS_Services (Oracle WebCenter Web 2.0 Services)
For example, to start the Oracle WebCenter Spaces server on a UNIX operating system:
```
MW_HOME/user_projects/domains/domain_name/bin/startManagedWebLogic.sh WLS_Spaces
```
On Windows operating systems:
```
MW_HOME\user_projects\domains\domain_name\bin\startManagedWebLogic.cmd WLS_Spaces 
```

Before the server is started, you will be prompted for the WebLogic Server username and password. These were provided on the Configure Administrator Username and Password Screen in the Configuration Wizard.

If you do not know the names of the managed servers that need to be started, you can view the contents of the following file on UNIX operating systems:

MW_HOME/user_projects/domains/domain_name/startManagedWebLogic_readme.txt

On Windows operating systems:

MW_HOME\user_projects\domains\domain_name\startManagedWebLogic_readme.txt

Or, you can access the Administration Server console at the following URL:

http://host:admin_server_port/console

Supply the username and password that you specified on the Configure Administrator Username and Password Screen of the Configuration Wizard.

3.2.2 Starting Managed Servers from the Administration Console

In order to start a managed server from the Administration Console, you must first create a machine, then associate the managed server with that machine:

Login to the Administration Console.
Navigate to Environment > Machines.
Click New.
Enter a machine name (for example, Machine-WC).
In the Administration Console, navigate to Environment > Servers and select the managed server for which you want to associate this machine (Machine-WC). Use the drop-down list to associate the managed server with the machine.

Note:

This procedure only works if the managed servers are shut down. If the managed servers are up and running, then no values will appear in the drop-down list.

After this procedure, the managed server will start successfully and be accessible.

3.2.3 Starting Node Manager

Node Manager is a Java utility that runs as separate process from Oracle WebLogic Server and allows you to perform common operations for a Managed Server, regardless of its location with respect to its Administration Server. For example, Node Manager can be used for:

Starting servers on remote machines (via the Console).
Automatically restarting failed servers.
Automatic Service Migration when using consensus-based leasing.
Whole Server Migration.

While use of Node Manager is optional, it provides valuable benefits if your WebLogic Server environment hosts applications with high-availability requirements.

For more information about Node Manager, refer to Oracle Fusion Middleware Node Manager Administrator's Guide for Oracle WebLogic Server.

3.2.4 Verifying the Installation

Start your browser and enter the following URLs:

To access the Administration Server:
```
http://host:admin_server_port
```
This information was visible on the Creating Domain Screen (the last screen) of the Configuration Wizard.
To access the Administration Server console:
```
http://host:admin_server_port/console
```
You will be prompted for the username and password credentials that you specified on the Configure Administrator Username and Password Screen of the Configuration Wizard.
To access Enterprise Manager:
```
http://host:admin_server_port/em
```
To access WebCenter Spaces:
```
http://host:port/webcenter
```
The default port number for WebCenter Spaces is 8888.
To access WebCenter Rich Text Portlet:
```
http://host:port/richtextportlet/
```
To access WebCenter WSRP Tools:
```
http://host:port/wsrp-tools/
```
To access WebCenter OmniPortlet and Web Clipping Portlets:
```
http://host:port/portalTools/
```
The default port number for WebCenter Portlets is 8889.
To access WebCenter Discussions:
```
http://host:port/owc_discussions
```
The default port number for WebCenter Discussions is 8890.
To access WebCenter Wiki and Blog Server:
```
http://host:port/owc_wiki
```
The default port number for WebCenter Discussions is 8890.

3.3 Working with Oracle WebCenter Components

After creating or extending a domain, you must configure Oracle WebCenter components to prepare them to work with Oracle WebCenter. Depending on the WebCenter component you want to use, perform the tasks listed in Table 3-1.

For information about configuring Oracle Content Server, see Section 4.3.1, "Oracle Content Server 10.1.3.5.1 Requirements".

Table 3-1 Configuring Oracle WebCenter Components

Component Task Description Documentation

Component	Task Description	Documentation
Oracle WebCenter Spaces	If you want to access WebCenter Spaces, first start the `WLS_Spaces` managed server. Then, access the following URL and log on as an administrator: http://host:port/webcenter Where, host:port refers to the host name and port number of the system where Oracle WebCenter is installed. By default, Oracle WebCenter is installed on port 8888.	For information about getting started with Oracle WebCenter Spaces, see the "Getting WebCenter Spaces Up and Running" chapter in Oracle Fusion Middleware Administrator's Guide for Oracle WebCenter. For more information about starting and stopping managed servers, see "Starting and Stopping Oracle Fusion Middleware" in Oracle Fusion Middleware Administrator's Guide.
Oracle WebCenter Portlets	To work with the preconfigured portlets available in Oracle WebCenter, you must: Start the `WLS_Portlet` managed server. Register the required portlet producers to enable application developers or users to add portlets to application pages. If you want to access preconfigured portlets producer, use any of the following URLs depending on the portlet producer you wish to access: Rich Text portlet http://host:port/richtextportlet/ WSRP Tools http://host:port/wsrp-tools/ OmniPortlet and Web Clipping portlets http://host:port/portalTools Where, host:port refers to the host name and port number of the system where Oracle WebCenter Portlets is installed. By default, Oracle WebCenter Portlets is installed on port 8889.	For information about: Starting and stopping managed servers, see "Starting and Stopping Oracle Fusion Middleware" in Oracle Fusion Middleware Administrator's Guide. Registering, editing, deleting, and deploying portlet producers, see the "Managing Portlet Producers" chapter in Oracle Fusion Middleware Administrator's Guide for Oracle WebCenter.
Oracle WebCenter Discussions	To prepare Oracle WebCenter Discussions to work with Oracle WebCenter, perform the following tasks: Start the managed server `WLS_Services`. Configure Oracle WebCenter Discussions for Web Services Security (WS-Security) to prepare the server for custom WebCenter applications. Register connections to Oracle WebCenter Discussions. You can access Oracle WebCenter Discussions by using the following URL: http://host:port/owc_discussions Where, host:port refers to the host name and port number of the system where Oracle WebCenter Discussions is installed. By default, Oracle WebCenter Discussions is installed on port 8890. Note: You cannot start or stop Oracle WebCenter Discussions from Oracle WebLogic Server Administrator Console. To start or stop the discussion server, you must start or stop the `WLS_Services` managed server where Oracle WebCenter Discussions is deployed.	For information about: Starting and stopping managed servers, see "Starting and Stopping Oracle Fusion Middleware" in Oracle Fusion Middleware Administrator's Guide. Configuring WS-Security, see the "Configuring WS-Security for a Simple Topology" section in the Oracle Fusion Middleware Administrator's Guide for Oracle WebCenter. Registering connections, see the "Managing the Announcements and Discussions Services" chapter in the Oracle Fusion Middleware Administrator's Guide for Oracle WebCenter.
Oracle WebCenter Wiki and Blog Server	To prepare Oracle WebCenter Wiki and Blog Server to work with Oracle WebCenter, perform the following tasks: Start the managed server `WLS_Services`. Register connections to Oracle WebCenter Wiki and Blog Server. You can access Oracle WebCenter Wiki and Blog Server by using the following URL format: http://host:port/owc_wiki Where, host:port refers to the host name and port number of the system where Oracle WebCenter Wiki and Blog Server is installed. By default, this server is installed on port 8890. The `owc_wiki` refers to the Oracle WebCenter Wiki and Blog Server deployment directory.	For information about: Starting and stopping managed servers, see "Starting and Stopping Oracle Fusion Middleware" in Oracle Fusion Middleware Administrator's Guide. Registering connections, see the "Managing the Wiki and Blog Services" chapter in the Oracle Fusion Middleware Administrator's Guide for Oracle WebCenter.

Oracle WebCenter Spaces

If you want to access WebCenter Spaces, first start the WLS_Spaces managed server. Then, access the following URL and log on as an administrator:

http://host:port/webcenter

Where, host:port refers to the host name and port number of the system where Oracle WebCenter is installed. By default, Oracle WebCenter is installed on port 8888.

For information about getting started with Oracle WebCenter Spaces, see the "Getting WebCenter Spaces Up and Running" chapter in Oracle Fusion Middleware Administrator's Guide for Oracle WebCenter.

For more information about starting and stopping managed servers, see "Starting and Stopping Oracle Fusion Middleware" in Oracle Fusion Middleware Administrator's Guide.

Oracle WebCenter Portlets

To work with the preconfigured portlets available in Oracle WebCenter, you must:

Start the WLS_Portlet managed server.
Register the required portlet producers to enable application developers or users to add portlets to application pages.

If you want to access preconfigured portlets producer, use any of the following URLs depending on the portlet producer you wish to access:

Rich Text portlet
```
http://host:port/richtextportlet/
```
WSRP Tools
```
http://host:port/wsrp-tools/
```
OmniPortlet and Web Clipping portlets
```
http://host:port/portalTools
```

Where, host:port refers to the host name and port number of the system where Oracle WebCenter Portlets is installed. By default, Oracle WebCenter Portlets is installed on port 8889.

For information about:

Starting and stopping managed servers, see "Starting and Stopping Oracle Fusion Middleware" in Oracle Fusion Middleware Administrator's Guide.
Registering, editing, deleting, and deploying portlet producers, see the "Managing Portlet Producers" chapter in Oracle Fusion Middleware Administrator's Guide for Oracle WebCenter.

Oracle WebCenter Discussions

To prepare Oracle WebCenter Discussions to work with Oracle WebCenter, perform the following tasks:

Start the managed server WLS_Services.
Configure Oracle WebCenter Discussions for Web Services Security (WS-Security) to prepare the server for custom WebCenter applications.
Register connections to Oracle WebCenter Discussions.

You can access Oracle WebCenter Discussions by using the following URL:

http://host:port/owc_discussions

Where, host:port refers to the host name and port number of the system where Oracle WebCenter Discussions is installed. By default, Oracle WebCenter Discussions is installed on port 8890.

Note: You cannot start or stop Oracle WebCenter Discussions from Oracle WebLogic Server Administrator Console. To start or stop the discussion server, you must start or stop the WLS_Services managed server where Oracle WebCenter Discussions is deployed.

For information about:

Starting and stopping managed servers, see "Starting and Stopping Oracle Fusion Middleware" in Oracle Fusion Middleware Administrator's Guide.
Configuring WS-Security, see the "Configuring WS-Security for a Simple Topology" section in the Oracle Fusion Middleware Administrator's Guide for Oracle WebCenter.
Registering connections, see the "Managing the Announcements and Discussions Services" chapter in the Oracle Fusion Middleware Administrator's Guide for Oracle WebCenter.

Oracle WebCenter Wiki and Blog Server

To prepare Oracle WebCenter Wiki and Blog Server to work with Oracle WebCenter, perform the following tasks:

Start the managed server WLS_Services.
Register connections to Oracle WebCenter Wiki and Blog Server.

You can access Oracle WebCenter Wiki and Blog Server by using the following URL format:

http://host:port/owc_wiki

Where, host:port refers to the host name and port number of the system where Oracle WebCenter Wiki and Blog Server is installed. By default, this server is installed on port 8890. The owc_wiki refers to the Oracle WebCenter Wiki and Blog Server deployment directory.

For information about:

Starting and stopping managed servers, see "Starting and Stopping Oracle Fusion Middleware" in Oracle Fusion Middleware Administrator's Guide.
Registering connections, see the "Managing the Wiki and Blog Services" chapter in the Oracle Fusion Middleware Administrator's Guide for Oracle WebCenter.