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

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.

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.

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:

1. 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."

   You can use one of the following executable files to install Oracle WebLogic Server:

   • wls_linux32.bin (for a Linux x86 operating system)

   • wls_solaris32.bin (for 32-bit Solaris operating system)

   • wls_win32.exe (for 32-bit Windows operating system)

   • wls_generic.jar (for any 64-bit operating system)

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

2. 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, execute 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:

   ./wls_linux32.bin
   

   To run the installer on a 32-bit Windows operating system, use this command:

   wls_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 wls_generic.jar
   

   JAVA_HOME/bin/java -d64 -jar wls_generic.jar
   

   To run the installer on a 64-bit Windows operating system, use this command:

   JAVA_HOME\bin\java -jar wls_generic.jar
   

3. Welcome screen

   Click Next.

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

   Click Next.

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

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

7. Choose Product Installation Directories screen

   Specify a location for your Oracle WebLogic Server home directory, which WL_HOME will represent in path names in this document. The default location for WL_HOME follows:

   • UNIX operating system

     MW_HOME/wlserver_10.3
     

   • Windows operating system

     MW_HOME\wlserver_10.3
     

   You can also change the installation directory for Oracle Coherence. The default location follows:

   • UNIX operating system

     MW_HOME/coherence_3.5
     

   • Windows operating system

     MW_HOME\coherence_3.5
     

   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.

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

9. Installation Summary screen

   Click Next.

10. Installation Progress screen

    No action is required on this screen.

11. 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:

1. Download Java Access Bridge from the Java SE Desktop Accessibility page of the Sun Developer Network at

   http://java.sun.com/javase/technologies/accessibility/accessbridge/
   

2. Install Java Access Bridge.

3. Copy the access-bridge.jar and jaccess-1_4.jar files from your installation location to the jre\lib\ext directory.

4. Copy the WindowsAccessBridge.dll, JavaAccessBridge.dll, and JAWTAccessBridge.dll files from your installation location to the jre\bin directory.

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

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 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:

1. Open Control Panel.

2. Select Add Hardware.

3. In the "Welcome" window, click Next.

4. On the "Is the hardware connected?" window, select Yes, I have already connected the hardware, then click Next.

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

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

7. In the "From the list of hardware types, select the type of hardware you are installing" window, select Network adapters, then click Next.

8. In the "Select Network Adapter" window, make the following selections:

   • Manufacturer: Microsoft

   • Network Adapter: Microsoft Loopback Adapter

9. Click Next.

10. In the "The wizard is ready to install your hardware" window, click Next.

11. In the "Completing the Add Hardware Wizard" window, click Finish.

12. Restart your computer.

13. Right-click My Network Places on the desktop and choose Properties. This displays the Network Connections control panel.

14. Right-click the connection that was just created. This is usually named Local Area Connection 2. Choose Properties.

15. On the General tab, select Internet Protocol (TCP/IP), then click Properties.

16. 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 because you will need them later in this procedure.

    4. Leave all other fields empty.

    5. Click OK.

17. In the Local Area Connection 2 Properties dialog box, click OK.

18. Close the Network Connections control panel.

19. 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:

1. Start the System control panel.

   Select Start > Control Panel > System.

2. On the Hardware tab, click Device Manager.

3. In the Device Manager window, expand Network adapters. You should see Microsoft Loopback Adapter.

4. Right-click Microsoft Loopback Adapter and select Uninstall.

5. 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 operating system

  /etc/hosts
  

• Windows operating system

  %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

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)

After installation, you can deploy any 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 /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 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:

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

2. 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.2 Creating a Symbolic Link to 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:

1. Log in as the root user.

2. Execute the following command as root:

   ln -s /usr/bin/chmod /usr/local/bin/chmod
   

3. 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.3 Locating Installation Log Files

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

• UNIX operating system

  USER_HOME/oraInventory/logs/installdate_time
  

• Windows operating system

  USER_HOME\oraInventory\logs\installdate_time
  

3.2.4 Installing Oracle Enterprise Content Management Suite

You can deploy and configure one or more of these applications any time later by creating or extending an Oracle WebLogic Server domain.

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 root user is not supported.

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

Step	Screen	Actions
1	None	Start the Oracle Enterprise Content Management Suite installer, which is on Disk 1 of the suite's media: UNIX operating system cd ecm_media_loc/Disk1 ./runInstaller -jreLoc jre_location If you do not specify the JRE location, you will be prompted for it. Windows operating system cd ecm_installer_loc setup.exe -jreLoc jre_location Double clicking setup.exe does not work because you need to specify the JRE location. If you are installing the suite from a ZIP file, you need to unzip the file to a directory first. Disk 1 will be a subdirectory of the suite's media directory.
2	Welcome	Click Next to continue.
3	Prerequisite Checks	Click Next to continue.
4	Specify Installation Location	Specify the Middleware home (MW_HOME) and ECM Oracle home (ECM_ORACLE_HOME) locations. The ECM Oracle home directory must be inside the Middleware home directory. Click Next to continue.
5	Installation Summary	Verify the information on this screen. Click Install to begin the installation.
6	Installation Progress	When the installation is 100% complete, click Next to go to the last screen.
7	Installation Completed	Click Save to save the installation configuration, and then click Finish.

To install Oracle Enterprise Content Management Suite:

1. Start the Oracle Enterprise Content Management Suite installer.

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

   Table 3-2 Default JRE Locations

   Operating System	Production Environment	Development Environment
   UNIX	MW_HOME/jrockit_160_17_Rnn.n.n-nnn/jre	MW_HOME/jdk160_18/jre
   Windows	MW_HOME\jrockit_160_17_Rnn.n.n-nnn\jre	MW_HOME\jdk160_18\jre

   
   

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

   • UNIX operating system

     cd ecm_media_loc/Disk1
     ./runInstaller -jreLoc jre_location
     

     
     

     Note: Starting the installer as the user root is not supported.

     
     

   • Windows operating system

     cd ecm_installer_loc 
     setup.exe -jreLoc jre_location
     

2. On the Welcome screen, click Next to begin the installation.

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

4. On the Specify Installation Location screen, enter values into the following fields, and then click Next.

   • Oracle Middleware Home: Select the Middleware home directory, which was created during the installation of Oracle WebLogic Server.

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

   
   

5. 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 click Save, you will be prompted for a name and location for the response file, which contains information specific to your installation. After the response file is created, 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.

   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.

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

7. On the Installation Completed screen, click Save if you want to save the installation configuration, and click Finish to exit the installer.