2 Installing Oracle WebCenter Portal

This chapter provides instructions for installing 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

  • Oracle WebCenter Portal schemas installed in the database using the Repository Creation 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 Components" 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 "Oracle WebCenter Portal." 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, which must be specified using the -jreLoc parameter:

  • If you installed Oracle WebLogic Server using a platform-specific .exe or .bin installer, a JRE was included with your installation in the Middleware home in the jdk60_version directory. You can point to this location to start the installer.

  • If you installed Oracle WebLogic Server using a generic .jar installer, then no JRE was included with the installation. You must point to the JRE that was installed separately on your system in order to start the installer.

For information about the log files created by the installer and the contents of each file, refer to Section D.2.1, "Installation Log Files".

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

If you want to install Oracle JDeveloper to use in conjunction with Oracle WebCenter Portal, read the information in this section.

The following topics are covered:

2.3.1 About Oracle JDeveloper

Oracle JDeveloper is a free integrated development environment (IDE) for building Web service-oriented applications, including Portal Framework 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 Portal Framework 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 Portal Framework applications are not rendered if there is a space in the path to the installation directory of Oracle JDeveloper.

To build Portal Framework applications using JDeveloper, you must install the Oracle WebCenter Portal extension bundle. This extension bundle is a JDeveloper add-in that provides the complete set of Oracle WebCenter Portal 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 Oracle WebCenter Portal extension bundle, see the section "Installing WebCenter Portal's Extension for Oracle JDeveloper" 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).