2 Installing Oracle WebCenter Portal

This chapter describes how to install Oracle WebCenter Portal.

The following topics are covered:

2.1 Preparing to Install

Oracle WebCenter Portal requires the following software and schemas installed before the install:

  • Oracle WebLogic Server

  • WebCenter Portal schemas installed in the database using the Repository Configuration Utility (RCU).

Before you begin, make sure you have completed pre-installation tasks listed in Table 1-3.

2.2 Installing Oracle WebCenter Portal

By default, all Oracle WebCenter Portal products (see Section 1.3, "Oracle WebCenter Portal Products" for a complete list) are installed onto your system. After the products are installed, you can run the Oracle Fusion Middleware Configuration Wizard to configure the product(s) of your choice.

This section contains the following topics:

2.2.1 Obtaining the Software

Depending on your specific needs, there are multiple places where you can obtain Oracle Fusion Middleware software. For details, refer to the Oracle Fusion Middleware Download, Installation, and Configuration ReadMe Files page, where you can find the ReadMe file for your specific release.

Select one of the download locations and download "SOA Suite." This will be saved to your system as a .zip archive file.

After you download the archive file, unpack the archive file into a directory of your choice on the machine where you will be performing the installation.

2.2.2 Starting the Installer

To start the installer, go to the directory where you unpacked the archive file and switch to the Disk1 directory.

On UNIX operating systems:

cd unpacked_archive_directory/Disk1
./runInstaller -jreLoc JRE_LOCATION

On Windows operating systems:

cd unpacked_archive_directory\Disk1
setup.exe -jreLoc JRE_LOCATION

The installer requires the full path to the location of a Java Runtime Environment (JRE) on your system. When you installed Oracle WebLogic Server, a JRE was installed on your system in the jdk160_27 directory inside the Middleware home. You can use this location as the JRE_LOCATION to start the installer.

If you choose to start the installer without using the -jreLoc parameter, see Section, "Specifying the JRE Location From the Command Line". Specifying the JRE Location From the Command Line

If you do not specify the JRE location with the -jreLoc option, you will be prompted to provide the location of your JRE before the installer is started. For example, on a UNIX operating system:

Starting Oracle Universal Installer...
Checking if CPU speed is above 300 MHz.    Actual 2999 MHz    Passed
Checking Temp space: must be greater than 150 MB.   Actual 66070 MB    Passed
Checking swap space: must be greater than 512 MB.   Actual 4047 MB    Passed
Checking monitor: must be configured to display at least 256 colors.    Actual 256    Passed
Preparing to launch Oracle Universal Installer from /tmp/OraInstall2010-02-23_10-57-58AM. Please wait ...
Please specify JRE/JDK location ( Ex. /home/jre ), <location>/bin/java should exist :

Specify the absolute path to the JRE on your system before you continue. Viewing the Installation Log Files

After the installation is complete, review the installation log files. The installer writes logs files to the Oracle_Inventory_Location/log (on UNIX operating systems) or Oracle_Inventory_Location\logs (on Windows operating systems) directory. Refer to Section D.2.1, "Installation Log Files" for more information about the log files and their contents.

2.2.3 Configuring Your Oracle Inventory (UNIX Only)

If you are installing on a UNIX operating system, and if this is the first time any Oracle product is being installed on your system with the Oracle Universal Installer, you will be asked to provide the location of an inventory directory. This is where the installer will set up subdirectories and maintain inventory data for each Oracle product that is installed on this system.

Follow the instructions in Table 2-1 to configure the inventory directory information. For more details, click on the screen name in the table, or click the Help button in the GUI.

Table 2-1 Inventory Directory and Group Screens

Screen Description and Action Required

Specify Inventory Directory

Specify the Oracle inventory directory and group permissions for that directory. The group must have write permissions to the Oracle inventory directory.

Inventory Location Confirmation

Run the createCentralInventory.sh script as root.

2.2.4 Following the Installation Screens and Instructions

Table 2-2 lists the screens displayed in Oracle Universal Installer. Follow the instructions in Table 2-2 to install Oracle WebCenter Portal. For details about a screen, click the screen name in the table.

If you need additional help with any of the installation screens, refer to Appendix A, "Oracle WebCenter Portal Installation Screens" or click Help in the GUI to access the online help.

Table 2-2 Oracle WebCenter Portal Installation Screens

Screen Description and Action Required


This page introduces you to the Oracle Fusion Middleware installer.

Install Software Updates

Select the method you want to use for obtaining software updates, or select Skip Software Updates if you do not want to get updates.

If updates are found, the installer will automatically attempt to apply them at this point; make sure that the server you are using to perform the installation is connected to the Internet.

Some updates will require that the installer be restarted; if this happens, the Install Software Updates screen will not be seen the next time.

Prerequisite Checks

Verify that your system meets all necessary prerequisites.

Specify Installation Location

Specify Oracle Middleware home and Oracle home locations.

The Oracle Common home (oracle_common) directory will automatically be created inside the Middleware home; do not use oracle_common as the name of your Oracle home directory.

Application Server

Select the application server and specify its location.

Installation Summary

Verify the information on this screen, then click Install to begin the installation.

Installation Progress

This screen shows the progress of the installation.

When the progress shows 100% complete, click Next to continue.

Installation Complete

Click Save to save your configuration information to a file. This information includes port numbers, installation directories, URLs, and component names which you may need to access at a later time.

After saving your configuration information, click Finish to dismiss the installer.

2.3 Installing Oracle JDeveloper

Refer to the following sections for information about Oracle JDeveloper:

2.3.1 About Oracle JDeveloper

Oracle JDeveloper is a free integrated development environment (IDE) for building Web service-oriented applications, including WebCenter Portal applications, using industry standards for Java, XML, SQL, and Web Services. It supports the complete development life cycle with integrated features for modeling, coding, debugging, testing, profiling, tuning, and deploying applications.

JDeveloper works in tandem with popular open-source frameworks and tools with built-in features for Struts, Ant, JUnit, XDoclets, and CVS, and includes an Extensions SDK that lets developers add capabilities to, and customize, the development environment.

To install Oracle JDeveloper on your development, refer to the Oracle Fusion Middleware Installation Guide for Oracle JDeveloper.

2.3.2 Special Instructions When Installing Oracle JDeveloper for Oracle WebCenter Portal Application Development

This section provides important information to consider when you are installing Oracle JDeveloper with Oracle WebCenter Portal.

Typically, you install Oracle JDeveloper on your development machine and connect to a remote Oracle WebCenter Portal domain to deploy and test your applications.


Oracle JDeveloper and Oracle WebCenter Portal must not be installed in the same Middleware home directory. You must create a separate Middleware home for each product.


When you install Oracle JDeveloper on a Windows operating system, be sure that you choose a directory that does not contain spaces. For example, do not use C:\My Home as the installation directory for Oracle JDeveloper. Pages in WebCenter Portal applications are not rendered if there is a space in the path to the installation directory of Oracle JDeveloper.

To build WebCenter Portal applications using JDeveloper, you must install the WebCenter extension bundle. The WebCenter extension bundle is a JDeveloper add-in that provides the complete set of WebCenter capabilities and features to the JDeveloper Studio Edition. For information about obtaining and installing Oracle JDeveloper, see the Oracle JDeveloper page on OTN at the following URL:


For information about installing the WebCenter extension bundle, see the section "Installing the WebCenter Extension Bundle" in Oracle WebCenter Framework Developer's Guide.


Oracle strongly recommends that you set an environment variable for the user home directory (used by JDeveloper to store the runtime files) that is referenced by JDeveloper. By setting this variable, you can avoid receiving long path name errors that are known to occur in some circumstances.

For detailed instructions on setting this variable on Windows, Linux, UNIX, and Mac OS X operating systems, see "Setting the User Home Directory" in Oracle Fusion Middleware Installation Guide for Oracle JDeveloper (Oracle Fusion Applications Edition).