3 Installing Oracle Enterprise Content Management Suite

This chapter explains how to install the Oracle Enterprise Content Management Suite component of Oracle Fusion Middleware, in these topics:

Preparing for Installation
Installing Oracle Enterprise Content Management Suite in Oracle Fusion Middleware
Applying Patch 12369706 for Oracle Information Rights Management

3.1 Preparing for Installation

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.

3.1.1 Meeting System Requirements

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
```
http://www.oracle.com/technology/software/products/ias/files/fusion_requirements.htm
```
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
```
http://www.oracle.com/technology/software/products/ias/files/fusion_certification.html
```
This document contains information related to supported installation types, platforms, operating systems, databases, JDKs, and third-party products.

Notes:

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.
For a 64-bit Linux operating system, you should use the 32-bit Java Runtime Environment (JRE) on a client machine for the Oracle I/PM Advanced Viewer.

3.1.2 Installing Oracle WebLogic Server in a Middleware Home

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 or Oracle Technology Network (OTN) web site.

For information about downloading Oracle WebLogic Server, see Section 1.2, "Software Downloads for Oracle ECM Installation and Configuration."

The 32-bit executable files from which you can install Oracle WebLogic Server 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 supported JDK must be installed on your system before you install Oracle WebLogic Server because it is needed to run the JAR file.

On a Windows operating system, the JDK must be installed in a directory without spaces in the directory path (not underneath the \Program Files directory).

For a list of supported JDKs for your operating system, see the Oracle Fusion Middleware Supported System Configurations page on Oracle Technology Network at
```
http://www.oracle.com/technology/software/products/ias/files/fusion_certification.html
```
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 running XWindows, you need to set your system's DISPLAY environment variable to a valid X Server to redirect the display to a system with suitable graphic capabilities.
- If you installed a JDK for your system, set the JAVA_HOME environment variable to the installation location.
- If you are installing Oracle WebLogic Server on a 64-bit system and using a 32/64-bit hybrid JDK (such as the HP JDK for HP-UX or SUN JDK for Solaris SPARC), you need to use the -d64 flag when you run the installer.
  
  To validate that your JAVA_HOME environment variable refers to a 64-bit JDK when you use a 32/64-bit hybrid JDK, run either of the following commands, in which JAVA_HOME is the value of the environment variable:
```
JAVA_HOME/bin/java -version

JAVA_HOME/bin/java -d64 -version
```
To run the installer on a 32-bit Linux operating system, use this command:
```
./wls1034_linux32.bin
```
To run the installer on a 32-bit Windows operating system, use this command:
```
wls1034_win32.exe
```
To run the installer on a 64-bit UNIX operating system, use either of these commands, in which JAVA_HOME is the location of the JDK:
```
JAVA_HOME/bin/java -jar wls1034_generic.jar
```
```
JAVA_HOME/bin/java -d64 -jar wls1034_generic.jar
```
To run the installer on a 64-bit Windows operating system, use this command:
```
JAVA_HOME\bin\java -jar wls1034_generic.jar
```
Welcome screen

Click Next.
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.

The default Oracle Middleware home is /Oracle/Middleware on a UNIX operating system or \Oracle\Middleware on a Windows operating system. For more information, see "Middleware Home and WebLogic Home Directories" in Oracle Fusion Middleware Installation Planning Guide.

Click Next.
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.

Click Next.
Choose Install Type screen

Select Typical to install Oracle WebLogic Server, Oracle Coherence, and the Sun and JRockit JDKs.

Click Next.

If you are prompted for a JDK location on a 64-bit system, specify a JDK:
1. Browse to the JDK location.
2. Select the directory that contains the bin directory
3. Click Next.
Choose Product Installation Directories screen

Specify a location for your Oracle WebLogic Server home directory, which WL_HOME represents in path names in this document. The default location for WL_HOME follows:
- UNIX path: MW_HOME/wlserver_10.3
- Windows path: MW_HOME\wlserver_10.3
You can also change the installation directory for Oracle Coherence. The default location follows:
- UNIX path: MW_HOME/coherence_3.6
- Windows path: MW_HOME\coherence_3.6
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.

Click Next.
Choose Shortcut Location (Windows operating system only)

If you are installing on a Windows operating system, you need to specify a location for creating a shortcut to Oracle products.

Click Next.
Installation Summary screen

Click Next.
Installation Progress screen

No action is required on this screen.
Installation Complete screen

Deselect Run Quickstart.

Click Done.

For more information about installing Oracle WebLogic Server, see Oracle Fusion Middleware Installation Guide for Oracle WebLogic Server.

3.1.3 Install and Configure Java Access Bridge (Windows Operating System Only)

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
```
http://www.oracle.com/technetwork/java/javase/tech/index-jsp-136191.html
```
Install Java Access Bridge.
Copy the access-bridge.jar and jaccess-1_4.jar files from your installation location to the jre\lib\ext directory.
Copy the WindowsAccessBridge.dll, JavaAccessBridge.dll, and JAWTAccessBridge.dll files from your installation location to the jre\bin directory.
Copy the accessibility.properties file to the jre\lib directory.

For more information about accessibility, see "Using Oracle Fusion Middleware Accessibility Options" in Oracle Fusion Middleware Administrator's Guide.

3.1.4 Configure a DHCP Host

If you are installing Oracle Enterprise Content Management Suite on a DHCP host, follow the configuration steps in this section for your operating system.

3.1.4.1 Configuring a DHCP Host on a UNIX Operating System

Configure the host to resolve host names to the loopback IP address by modifying the /etc/hosts file on a UNIX operating system 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 ping command:

/bin/ping hostname.domainname

On a Solaris operating system, you could use the following ping command:

/usr/sbin/ping hostname.domainname

3.1.4.2 Configuring a DHCP Host on a Windows Operating System

On a Windows operating system, install a loopback adapter on the DHCP server (see Section 3.1.4.3, "Installing a Loopback Adapter on a Windows Operating 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

Replace 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.

3.1.4.3 Installing a Loopback Adapter on a Windows Operating System

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 operating 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:
- Manufacturer: Microsoft
- Network Adapter: Microsoft Loopback Adapter
Click Next.
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:
1. 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
```
2. Subnet mask: Enter 255.255.255.0.
3. Record the values you entered. You will need them later in this procedure.
4. Leave all other fields empty.
5. Click OK.
In the Local Area Connection 2 Properties dialog box, click OK.
Close the Network Connections control panel.
Restart your computer.

3.1.4.4 Removing a Loopback Adapter from a Windows Operating System

You can remove a loopback adapter through Control Panel.

To remove a loopback adapter from a Windows operating 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.
Click OK.

3.1.5 Installing on a Non-Networked Computer

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.

3.1.6 Installing on a Multihomed Computer

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 the hosts file:

UNIX path: /etc/hosts
Windows path: %SYSTEMROOT%\system32\drivers\etc\hosts

For example, the installer would pick up myhost1.example.com for configuration if your file contains the following entries:

127.0.0.1 localhost.localdomain localhost
10.148.56.76 myhost1.example.com myhost1
10.148.56.77 devhost2.example.com devhost2

For specific network configuration of a system component, refer to the individual component's configuration documentation.

3.2 Installing Oracle Enterprise Content Management Suite in Oracle Fusion Middleware

You can install Oracle Enterprise Content Management Suite before or after you create schemas for the suite's applications. 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:

Oracle Universal Content Management (Oracle UCM)
Oracle Inbound Refinery (Oracle IBR)
Oracle Imaging and Process Management (Oracle I/PM)
Oracle Information Rights Management (Oracle IRM)
Oracle Universal Records Management (Oracle URM)

Note:

For Oracle IRM, you need to apply a patch after you install Oracle Enterprise Content Management Suite. For information about the Oracle IRM patch, see Section 3.3, "Applying Patch 12369706 for Oracle Information Rights Management."

After you install Oracle Enterprise Content Management Suite and create application schemas, you can deploy any of these products to an Oracle WebLogic Server domain, as applications, by creating or extending an Oracle WebLogic Server domain. For information about application schemas, see Chapter 2, "Creating Schemas for Oracle Enterprise Content Management Suite."

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 /usr/local/packages directory.

Install this package on the Solaris operating system that will run Oracle I/PM. You can download GCC from the Sunfreeware web site at

http://www.sunfreeware.com

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 3.4.2.

3.2.1 Creating a Symbolic Link to the chmod Command on a Solaris System

Before installing Oracle Enterprise Content Management Suite on a Solaris operating system, you need to create a symbolic link to the chmod command.

To create a symbolic link to the chmod command:

Execute the following command as root:

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.

3.2.2 Locating Installation Log Files

The location of the installation log file depends on your operating system:

UNIX location: USER_HOME/oraInventory/logs/installdate_time
Windows location: USER_HOME\oraInventory\logs\installdate_time

3.2.3 Starting the Installer

You can start the Oracle Enterprise Content Management Suite installer from Disk 1 of the suite's media:

UNIX command: ecm_media_loc/Disk1/runInstaller -jreLoc jre_location

If you do not specify the JRE location, you will be prompted for it.
Windows command: ecm_installer_loc/Disk1/setup.exe -jreLoc jre_location

If you double-click setup.exe, you will be prompted for the JRE location. After you enter the path, click Enter to start the Oracle ECM installation.

The installer requires the location of a Java Runtime Environment (JRE) on your system. A JRE was installed with Oracle Fusion Middleware. Table 3-1 shows the default JRE locations.

Table 3-1 Default JRE Locations

Operating System	Production Environment	Development Environment
UNIX	`MW_HOME/jrockit_160_20_`string`/jre`	`MW_HOME/jdk160_21/jre`
Windows	`MW_HOME\jrockit_160_20_`string`\jre`	`MW_HOME\jdk160_21\jre`

You can either use the -jreLoc option or allow the installer to prompt for the directory containing the bin/java directory

Note:

Starting the installer as the user root is not supported.

3.2.4 Providing the Location of the Inventory Directory on a UNIX System

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 the 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 the 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.

This dialog box asks you to run the following script as the root user:
```
inventory_directory/createCentralInventory.sh 
```
If you do not have root access on the machine but want to continue with the installation, select Continue installation with local inventory.

3.2.5 Installing Oracle Enterprise Content Management Suite

After you have started the installer, as described in Section 3.2.3, follow the instructions in Table 3-2 to install Oracle Enterprise Content Management Suites.

If you need additional help with any of the installation screens, see Appendix A, "Oracle Enterprise Content Management Suite Installation Screens," or click Help to access the online help.

Note:

Running the installer as the user root is not supported.

Table 3-2 Installation Procedure for Oracle Enterprise Content Management Suite

Step	Screen	Actions
1	Welcome	Click Next to begin the installation process.
2	Install Software Updates	Specify any software updates to install before you install Oracle Enterprise Content Management Suite. To get updates from My Oracle Support (formerly OracleMetaLink), you can select Search My Oracle Support for Updates, specify a user name and password, and then click Search for Updates. Before you search, you can click Proxy Settings to change the settings for the proxy server and Test Connection to test the credentials. To get updates that you have saved to your computer, you can select Search Local Directory for Updates, specify a directory, and then click Search for Updates. If you do not want to update any software, select Skip Software Updates, and then click Next to continue the installation.
3	Prerequisite Checks	If the installer displays an error message in the bottom section of the screen, fix the error, and then click Retry to start the prerequisite checking again for all applications. Repeat this until the prerequisite checks complete with no errors. If you want to stop the installation process while you fix a prerequisite error, click Abort. If you want to continue the installation without fixing an error, click Continue. Click Next to continues the installation after the prerequisite checks complete with no errors.
4	Specify Installation Location	Specify the Middleware home (`MW_HOME`) and ECM Oracle home (`ECM_ORACLE_HOME`) locations. Enter values into the following fields: Oracle Middleware Home: Select the Middleware home directory, which was created during the installation of Oracle WebLogic Server. The default Oracle Middleware home is `/Oracle/Middleware` on a UNIX operating system or `\Oracle\Middleware` on a Windows operating system. 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 ECM Oracle home directory for Oracle Enterprise Content Management Suite. Run-time components cannot write to this directory. The default ECM Oracle home is `MW_HOME`/Oracle_ECM1 on a UNIX operating system or `MW_HOME`\Oracle_ECM1 on a Windows operating system. 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 Directories" in Oracle Fusion Middleware Installation Planning Guide Click Next to continue.
5	Installation Summary	Verify the information on this screen. If you want to change the configuration, you can return to a previous screen by clicking a link in the navigation tree on the left or by clicking Back until you get to the screen. After you edit the configuration, you can continue the installation from the previous screen. Click Save if you want to save a response file. You will be prompted for a name and location for the response file, which will contain information specific to your installation. After the installer creates the response file, you can use it exactly as is to replicate the installation on other systems, or you can modify the response file in a text editor. Click Install to start the software installation.
6	Installation Progress	Monitor the progress of your installation. If the installer prompts you to go to `Disk 2`, specify the location of `Disk 2`, and click OK to resume the installation. If you want to stop the installation, click Cancel. After the progress reaches 100%, click Next to go to the last screen.
7	Installation Completed	Click Save to save the installation configuration, and then click Finish to exit the installer.

3.3 Applying Patch 12369706 for Oracle Information Rights Management

The 11.1.1.5.0 Oracle IRM Server Management Console has an issue that requires a patch to be applied to the installed or updated system. When rights are being selected for a context, the Properties, Edit, and Remove buttons are always disabled and cannot be used. Selecting one or more rights will not enable the buttons. Patch 12369706 fixes this issue.

This patch can be downloaded from My Oracle Support (formerly OracleMetaLink) at https://support.oracle.com.

To apply Patch 12369706 for Oracle IRM:

Log in to https://support.oracle.com.
Click the Patches & Updates tab.
Enter the patch number, 12369706, in the Patch Name or Number field, under Patch Search.
Click Search.
Follow the installation instructions provided with the patch.

For general information about patching, see the Oracle Fusion Middleware Patching Guide.