|Oracle® Fusion Middleware Installation Guide for Oracle Enterprise Content Management Suite
11g Release 1 (11.1.1)
Part Number E14495-02
This chapter explains how to install the Oracle Enterprise Content Management Suite component of Oracle Fusion Middleware.
This chapter includes the following sections:
Before you install Oracle Enterprise Content Management Suite, you need to verify that your system meets the installation requirements and set environment variables. If your system does not have Oracle WebLogic Server installed, you need to install it in a new Middleware home. To provide accessibility on a Windows operating system, you can also install Java Access Bridge.
Before performing any installation, you should read the system requirements and certification documents to ensure that your environment meets the minimum installation requirements for the products you are installing. Both of these documents are available on Oracle Technology Network (OTN):
"Oracle Fusion Middleware System Requirements and Specifications" at
This document contains information related to hardware and software requirements, minimum disk space and memory requirements, and required system libraries, packages, or patches.
"Oracle Fusion Middleware Supported System Configurations" at
This document contains information related to supported installation types, platforms, operating systems, databases, JDKs, and third-party products.
Note:For the 32-bit version of the product, the system on which you are installing must be a supported 32-bit system. Installing a 32-bit version of the product on a 64-bit system is not supported.
Oracle Enterprise Content Management Suite requires a Middleware home with Oracle WebLogic Server on your system. If your system does not already have Oracle WebLogic Server, you can install it in a new Middleware home directory, before or after installation of the database and creation of the schemas.
To install Oracle WebLogic Server in a Middleware home:
Insert the Oracle WebLogic Server DVD, or download the installer from the Oracle E-Delivery Web site at
You can download one of the following executable files:
wls1032_linux32.bin (for Linux x86 systems)
wls1032_solaris32.bin (for 32-bit Solaris systems)
wls1032_win32.exe (for 32-bit Windows systems)
wls1032_generic.jar (for all 64-bit systems)
The 32-bit executable files are bundled with the appropriate JDK version. If you use the 64-bit installer, you will need to invoke the installer with a supported JDK for your platform. This JDK must be installed on your system before you install Oracle WebLogic Server. The JDK must be installed in a directory without spaces in the directory path (not underneath the
/Program Files directory in a Windows operating system). For a list of supported JDKs for your operating system, see the Oracle Fusion Middleware Supported System Configurations page on Oracle Technology Network at
Either run your installer file directly from the DVD, or copy the file to your local system and run it locally, after considering these notes:
Before running the installer on a UNIX operating system that is not Linux, set your system's
DISPLAY environment variable to a valid X Server.
JAVA_HOME environment variable to the installation location of the supported JDK you installed for your system.
If you are installing Oracle WebLogic Server on a 64-bit system, use the
-d64 flag when using a 32/64-bit hybrid JDK (such as the HP JDK for HP-UX and SUN JDK for Solaris SPARC).
For a 32/64-bit hybrid JDK, to validate that your
JAVA_HOME environment variable refers to a 64-bit JDK, execute
/bin/java -version (or
/bin/java -d64 -version), in which
JAVA_HOME is the value of the environment variable.
To run the installer on a 32-bit Linux operating system, use this command:
To run the installer on a 32-bit Windows operating system, use this command:
To run the installer on a 64-bit UNIX operating system, use either of these commands:
JAVA_HOME/bin/java -jar wls1032_generic.jar
JAVA_HOME/bin/java -d64 -jar wls1032_generic.jar
To run the installer on a 64-bit Windows operating system, use this command:
JAVA_HOME\bin\java -jar wls1032_generic.jar
Choose Middleware Home Directory screen
Select Create a new Middleware Home.
Specify a location for your new Middleware home directory, which
MW_HOME represents in path names. If this directory already exists on your system, the directory must be empty. If it does not already exist, then the installer creates it.
Note:Record this location because you will need to provide it during the installation of Oracle Enterprise Content Management Suite.
For more information, see "Middleware Home and WebLogic Home Directories" in Oracle Fusion Middleware Installation Planning Guide.
Register for Security Updates screen
Select whether or not to receive the latest product and security updates. If you choose not to receive anything, you need to verify your selection.
Choose Install Type screen
Select Typical, and click Next.
Choose Product Installation Directories screen
Specify a location for your Oracle WebLogic Server home directory, which
WL_HOME represents in path names. The default location for
/wlserver_10.3 (UNIX system) or
\wlserver_10.3 (Windows system). For more information about home directories, see "Middleware Home and WebLogic Home Directories" in Oracle Fusion Middleware Installation Planning Guide.
You can also specify a JDK. To specify a JDK for a 64-bit operating system, you must select Custom and the installed 64-bit JDK.
Choose Shortcut Location (Windows system only)
If you are installing on a Windows operating system, you need to specify a location for creating a shortcut to Oracle products.
Installation Summary screen
Installation Progress screen
No action is required on this screen.
Installation Complete screen
Deselect Run Quickstart.
For more information about installing Oracle WebLogic Server, see Oracle Fusion Middleware Installation Guide for Oracle WebLogic Server.
If you are installing on a Windows operating system, you can install and configure Java Access Bridge for Section 508 Accessibility:
Download Java Access Bridge from the Java SE Desktop Accessibility page of the Sun Developer Network at
Install Java Access Bridge.
jaccess-1_4.jar files from your installation location to the
JAWTAccessBridge.dll files from your installation location to the
accessibility.properties file to the
For more information about accessibility, see "Using Oracle Fusion Middleware Accessibility Options" in Oracle Fusion Middleware Administrator's Guide.
If you are installing Oracle Enterprise Content Management Suite on a DHCP host, you must follow the configuration steps in this section for your operating system.
On a UNIX operating system, configure the host to resolve host names to the loopback IP address by modifying the
/etc/hosts file to contain the following entries:
127.0.0.1 hostname.domainname hostname 127.0.0.1 localhost.localdomain localhost
To check that the host name resolves to the loopback IP address, ping the domain. For example, on a Linux operating system you could use the following
On a Solaris operating system, you could use the following
On a Windows x86 operating system, install a loopback adapter on the DHCP server (see Section 188.8.131.52, "Installing a Loopback Adapter on a Windows System"). This assigns a local IP address to your computer.
After installing the adapter, add a line immediately after the
localhost line in the
%SYSTEMROOT%\system32\drivers\etc\hosts file, with the following format:
IP_address hostname.domainname hostname
IP_address with the local IP address of the loopback adapter,
hostname with the name of the host, and
domainname with the name of the domain.
On a Windows operating system, you can install a loopback adapter on the DHCP server to assign a local IP address to your computer.
To install a loopback adapter on a Windows system:
Open Control Panel.
Select Add Hardware.
In the "Welcome" window, click Next.
On the "Is the hardware connected?" window, select Yes, I have already connected the hardware, then click Next.
In the "The following hardware is already installed on your computer" window, in the list of installed hardware, select Add a new hardware device, then click Next.
In the "The wizard can help you install other hardware" window, select Install the hardware that I manually select from a list, then click Next.
In the "From the list of hardware types, select the type of hardware you are installing" window, select Network adapters, then click Next.
In the "Select Network Adapter" window, make the following selections:
Network Adapter: Microsoft Loopback Adapter
In the "The wizard is ready to install your hardware" window, click Next.
In the "Completing the Add Hardware Wizard" window, click Finish.
Restart your computer.
Right-click My Network Places on the desktop and choose Properties. This displays the Network Connections control panel.
Right-click the connection that was just created. This is usually named Local Area Connection 2. Choose Properties.
On the General tab, select Internet Protocol (TCP/IP), then click Properties.
In the Internet Protocol (TCP/IP) Properties dialog box, click Use the following IP address, and then do the following steps:
IP Address: Enter a nonroutable IP for the loopback adapter, such as one of the following nonroutable addresses:
192.168.x.x (x is any value between 1 and 255) 10.10.10.10
Subnet mask: Enter
Record the values you entered because you will them need later in this procedure.
Leave all other fields empty.
In the Local Area Connection 2 Properties dialog box, click OK.
Close the Network Connections control panel.
Restart the computer.
You can remove a loopback adapter through Control Panel.
To remove a loopback adapter from a Windows system:
Start the System control panel.
Select Start > Control Panel > System.
On the Hardware tab, click Device Manager.
In the Device Manager window, expand Network adapters. You should see Microsoft Loopback Adapter.
Right-click Microsoft Loopback Adapter and select Uninstall.
You can install Oracle Enterprise Content Management Suite on a non-networked computer, such as a laptop. Because a non-networked computer has no access to other computers, you have to install all the components that you need on the computer.
In addition, you must follow the instructions in Section 3.1.4, "Configure a DHCP Host" to install a loopback adapter and modify the
hosts file on your system.
You can install Oracle Enterprise Content Management Suite on a multihomed computer. A multihomed computer is associated with multiple IP addresses. This is typically achieved by having multiple network cards on the computer. Each IP address is associated with a host name; additionally, you can set up aliases for each host name.
The installer picks up the fully qualified domain name from the first entry in
/etc/hosts file (UNIX system) or
%SYSTEMROOT%\system32\drivers\etc\hosts file (Windows system). For example, the installer would pick up myhost1.mycompany.com for configuration if your file contains the following entries:
127.0.0.1 localhost.localdomain localhost 10.148.56.76 myhost1.mycompany.com myhost1 10.148.56.77 devhost2.mycompany.com devhost2
For specific network configuration of a system component, refer to the individual component's configuration documentation.
When you install Oracle Enterprise Content Management Suite, you perform a base installation of the following products in an ECM Oracle home directory on your system:
After installation, you can deploy either or both of these products to an Oracle WebLogic Server domain, as applications.
Note:For document conversions on a Solaris SPARC platform, Oracle I/PM requires the GNU Compiler Collection (GCC) package 3.4.2 or later in the
Install this package on the Solaris operating system that will run Oracle I/PM. You can download GCC from the Sunfreeware Web site at
You also need to set the LD_LIBRARY_PATH environment variable to
/usr/local/packages/gcc-3.4.2/lib before starting the Oracle I/PM Managed Server. If you are using a later version of GCC, set that version instead of
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 the machine.
To provide the location of an inventory directory on a UNIX system:
On the Specify Inventory Directory screen, specify the location of the inventory directory.
This screen appears only on a UNIX operating system, for the first installation by Oracle Universal Installer. The installer will use the inventory directory to keep track of all Oracle products installed on the machine.
Take the action requested in the Inventory Location Confirmation dialog box.
If you do not have
root access on the machine but want to continue with the installation, select Continue installation with local inventory.
Before installing Oracle Enterprise Content Management Suite on a Solaris operating system, you need to create a symbolic link to the
To create a symbolic link to the chmod command:
Log in as the
Execute the following command as
ln -s /usr/bin/chmod /usr/local/bin/chmod
Log out, and then log back in with a different user name to start the installation.
Running the installer as the
root user is not supported.
The location of the installation log file depends on your operating system:
time (UNIX directory)
time (Windows directory)
Table 3-1 summarizes the steps for installing Oracle Enterprise Content Management Suite. The procedure following the table provides more detailed instructions.
During the installation, if you need additional help with any of the screens, click the name of the screen in the instructions to see its description in Appendix A, "Oracle Enterprise Content Management Suite Installation Screens," or click Help on the screen in the installer to access the online help.
Note:Running the installer as the
rootuser is not supported.
Start the Oracle Enterprise Content Management Suite installer, which is on Disk 1 of the suite's media.
If you are installing the suite from a ZIP file, you need to unzip the file to a directory.
On a UNIX operating system:
cd ecm_media_loc/Disk1 ./runInstaller [-jreLoc jre_location]
On a Windows operating system:
cd ecm_installer_loc setup.exe [-jreLoc jre_location]
Click Next to continue.
Click Next to continue.
Specify the Middleware home (
Click Next to continue.
Verify the information on this screen.
Click Install to begin the installation.
When the installation is 100% complete, click Next to go to the last screen.
Click Save to save the installation configuration, and then click Finish.
To install Oracle Enterprise Content Management Suite:
Start the Oracle Enterprise Content Management Suite installer.
This installer requires the location of a Java Runtime Environment (JRE) on your system. A JRE was installed with Oracle Fusion Middleware. The default JRE location for a production environment is
/jrockit_160_14_R27.6.5-32/jre (UNIX directory) or
\jrockit_160_14_R27.6.5-32\jre (Windows directory), where
MW_HOME is the Middleware home directory. The default JRE location for a development environment is
/jdk160_14_R27.6.5-32/jre (UNIX directory) or
\jdk160_14_R27.6.5-32\jre (Windows directory).
For a 64-bit installation, you can either use the
-jreLoc option or allow the installer to prompt for the directory containing
To start the installer on a UNIX operating system:
cd ecm_media_loc/Disk1 ./runInstaller [-jreLoc jre_location]
Note:Starting the installer as the user
rootis not supported.
To start the installer on a Windows operating system:
cd ecm_installer_loc setup.exe [-jreLoc jre_location]
On the Welcome screen, click Next to begin the installation.
On the Prerequisite Checks screen, after the prerequisite checking is complete with no errors, click Next.
If the screen display an error message in the bottom section, fix the error, and then click Retry to start the prerequisite checking again. Repeat this until the prerequisite checking is complete with no errors.
If you want to stop the installation process while you fix a prerequisite error, click Abort.
If you want to ignore an error or warning message and continue with the installation, click Continue.
On the Specify Installation Location screen, enter values into the following fields, and then click Next.
Oracle Middleware Home: Select the Middleware home directory.
Oracle Home Directory: Specify the directory where you want to install Oracle Enterprise Content Management Suite.
If you specify a directory that already exists, it must be empty and inside the Middleware home directory.
If you specify a new directory, the installer creates it inside the Middleware home directory.
The installation directory becomes the Oracle home directory for Oracle Enterprise Content Management Suite. Run-time components cannot write to this directory.
Note:This document refers to this directory as the ECM Oracle home to avoid confusion with the Oracle home directories of other Java components of Oracle Fusion Middleware. For more information, see "Oracle Home and Oracle Common Home Directory" in Oracle Fusion Middleware Installation Planning Guide.
On the Installation Summary screen, click Save if you want to save the response file, and then click Install to start the installation.
If you want to change the configuration, you can return to a previous screen by clicking its name in the navigation tree on the left or Back. After you edit the configuration, you can continue the installation from the previous screen.
On the Installation Progress screen, you can monitor the progress of your installation.
If you want to stop the installation, click Cancel.
After the progress reaches 100%, click Next to go to the last screen.
On the Installation Completed screen, click Save if you want to save the installation configuration, and click Finish to exit the installer.