Oracle® Fusion Middleware

Quick Installation Guide for Oracle Web Tier

11g Release 1 (11.1.1)

E14317-01

May 2009

Oracle Fusion Middleware Quick Installation Guide for Oracle Web Tier 11g Release 1 (11.1.1)

E14317-01

This software and related documentation are provided under a license agreement containing restrictions on use and disclosure and are protected by intellectual property laws. Except as expressly permitted in your license agreement or allowed by law, you may not use, copy, reproduce, translate, broadcast, modify, license, transmit, distribute, exhibit, perform, publish, or display any part, in any form, or by any means. Reverse engineering, disassembly, or decompilation of this software, unless required by law for interoperability, is prohibited.

The information contained herein is subject to change without notice and is not warranted to be error-free. If you find any errors, please report them to us in writing.

If this software or related documentation is delivered to the U.S. Government or anyone licensing it on behalf of the U.S. Government, the following notice is applicable:

U.S. GOVERNMENT RIGHTS Programs, software, databases, and related documentation and technical data delivered to U.S. Government customers are "commercial computer software" or "commercial technical data" pursuant to the applicable Federal Acquisition Regulation and agency-specific supplemental regulations. As such, the use, duplication, disclosure, modification, and adaptation shall be subject to the restrictions and license terms set forth in the applicable Government contract, and, to the extent applicable by the terms of the Government contract, the additional rights set forth in FAR 52.227-19, Commercial Computer Software License (December 2007). Oracle USA, Inc., 500 Oracle Parkway, Redwood City, CA 94065.

This software is developed for general use in a variety of information management applications. It is not developed or intended for use in any inherently dangerous applications, including applications which may create a risk of personal injury. If you use this software in dangerous applications, then you shall be responsible to take all appropriate fail-safe, backup, redundancy, and other measures to ensure the safe use of this software. Oracle Corporation and its affiliates disclaim any liability for any damages caused by use of this software in dangerous applications.

Oracle is a registered trademark of Oracle Corporation and/or its affiliates. Other names may be trademarks of their respective owners.

This software and documentation may provide access to or information on content, products, and services from third parties. Oracle Corporation and its affiliates are not responsible for and expressly disclaim all warranties of any kind with respect to third-party content, products, and services. Oracle Corporation and its affiliates will not be responsible for any loss, costs, or damages incurred due to your access to or use of third-party content, products, or services.

This document describes how to install and configure Oracle Web Tier Utilities Suite on a single host.

The following topics are covered:

Section 1, "Installation Overview"
Section 2, "System Requirements and Certification"
Section 3, "Installing on a DHCP Host"
Section 4, "Installing on a Non-Networked Computer"
Section 5, "Installing on a Multihomed Computer"
Section 6, "Installation Types"
Section 7, "Installing and Configuring Oracle Web Tier"
Section 8, "Verifying the Installation"
Section 9, "Deinstalling Oracle Web Tier"
Section 10, "Additional Resources"
Section 11, "Documentation Accessibility"

1 Installation Overview

This guide contains instructions for installing and configuring Oracle Web Tier on a single host. Figure 1 illustrates the topology that will be created on your system at the conclusion of this procedure. It also describes the order in which you need to perform certain tasks:

Figure 1 Installation Topology and Order of Tasks

Description of "Figure 1 Installation Topology and Order of Tasks"

2 System Requirements and Certification

The information in this section is current at the time of publication. For the most current information, refer to:

Oracle Fusion Middleware System Requirements, Prerequisites, and Specifications, available on Oracle Technology Network (OTN):
```
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 Certification
```
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.

2.1 Memory Requirements

Table 1 lists the minimum memory requirements.

Table 1 Minimum Memory Requirements

Operating System	Minimum Physical Memory	Minimum Available Memory
Linux	2 GB	1 GB
UNIX	2 GB	1 GB
Windows	2 GB	1 GB

2.2 Installer Startup Requirements

When the installer is started, the requirements listed in Table 2 are checked. You will be notified if any of these requirements are not met:

Table 2 Installer Startup Requirements

Category	Minimum or Accepted Value
Platform	UNIX: Solaris 9, Solaris 10 HP-UX 11i (11.23), HP-UX 11i (11.31) Oracle Enterprise Linux 4, Oracle Enterprise Linux 5, Red Hat Linux 4, Red Hat Linux 5, SUSE 10 IBM AIX 5.3, IBM AIX 6.1 Windows: Windows XP SP2 (Win32 platforms only), Windows 2003, Windows 2008, Windows Vista
Temp Space	At least 150MB
Swap Space	At least 512MB
Monitor	At least 256 colors

3 Installing on a DHCP Host

If you are installing Oracle Web Tier on a DHCP host, you must follow the configuration steps in this section for your platform.

3.1 For UNIX Platforms

On UNIX systems, configure the host to resolve hostnames 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

After doing so, check that the hostname resolves to the loopback IP address by entering the following command:

/bin/ping hostname.domainname

3.2 For Windows x86 Platforms

On Windows systems, install a loopback adapter on the DHCP server (see Section 3.3, "Installing a Loopback Adapter (Windows Only)"). This assigns a local IP address to your computer.

After installing the adapter, add a line to the %SYSTEMROOT%\system32\drivers\etc\hosts file with the following format, immediately after the localhost line:

IP_address   hostname.domainname   hostname

Replace IP_address with the local IP address of the loopback adapter.

3.3 Installing a Loopback Adapter (Windows Only)

To install a loopback adapter on Windows 2003 or Windows XP:

Open the Windows Control Panel.

Windows 2003: Select Start > Control Panel > Add Hardware.

Windows XP: Select Start > Control Panel, then double-click Add Hardware.
In the "Welcome" window, click Next.
In 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.
If you are using Windows 2003, 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 "Properties" dialog box, click Use the following IP address and do the following:
1. IP Address: Enter a non-routable IP for the loopback adapter. Oracle recommends the following non-routable 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, which you will need later in this procedure.
4. Leave all other fields empty.
5. Click OK.
In the "Local Area Connection 2 Properties" dialog, click OK.
Close Network Connections.
Restart the computer.

3.4 Removing a Loopback Adapter (Windows Only)

To remove a loopback adapter on Windows 2003 or Windows XP:

Start the System Control panel.

Windows 2003: Select Start > Control Panel > System.

Windows XP: Select Start > Control Panel, then double-click System.
In 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.

4 Installing on a Non-Networked Computer

You can install Oracle Web Tier 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, "Installing on a DHCP Host" to install a loopback adapter and modify the hosts file on your system.

5 Installing on a Multihomed Computer

You can install Oracle Web Tier 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 hostname; additionally, you can set up aliases for each hostname.

The installer picks up the fully qualified domain name from the first entry in /etc/hosts (on UNIX) or %SYSTEMROOT%\system32\drivers\etc\hosts (on Windows) file. So if your file looks like the following:

127.0.0.1 localhost.localdomain localhost
10.222.333.444 myhost1.mycompany.com myhost1
20.222.333.444 devhost2.mycompany.com devhost2

myhost1.mycompany.com would be picked for configuration.

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

6 Installation Types

The Oracle Web Tier installer will present you with two types of installation:

Install and Configure
Install Software - Do Not Configure

The Install and Configure option will install the product binaries in an Oracle Home directory and create and configure your system components in an Oracle Instance directory. After this is complete, you should be able to access your products using the Administration Console or Enterprise Manager to begin configuring and managing your products.

Note:

For more information about Oracle Home and Oracle Instance directories, refer to "Oracle Fusion Middleware Directory Structure and Concepts" in Oracle Fusion Middleware Installation Planning Guide.

The Install Software - Do Not Configure option only installs the software binaries in an Oracle Home directory. You must then manually run the Configuration Tool from your Web_Tier_ORACLE_HOME/bin (on UNIX systems) or Web_Tier_ORACLE_HOME\bin (on Windows systems) directory to configure your products before you can use them. This option can be used to quickly create multiple instances of the software that share a common disk.

7 Installing and Configuring Oracle Web Tier

The instructions in this section describe how to install and configure a single instance of Oracle Web Tier on a single host by choosing the Install and Configure installation type. This will be a non-managed installation, meaning that the products installed will not be associated with a WebLogic domain and will not be managed by Enterprise Manager (EM).

All products in the Oracle Web Tier Utilities Suite will be installed and configured:

Oracle Process Manager Notification (OPMN)
Oracle HTTP Server (OHS)
Oracle Web Cache

To install the Oracle Web Tier Utilities Suite:

Insert the CD-ROM.
Start the installer.

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

On UNIX systems:
```
./runInstaller
```
On Windows systems:
```
setup.exe
```
Welcome Screen

Click Next.
Specify Installation Type Screen

Select Install and Configure.

Click Next.
Prerequisite Checks Screen

Click Next.
Specify Installation Location Screen

Specify the directory where you want to install the software. This will be your Oracle Home directory. Runtime components cannot write to this directory. This directory can be located anywhere on your system:
- If you specify a directory that does not already exist, then it will be created for you.
- If you specify a directory that already exists, then it must be an empty directory.
Click Next.
Configure Components Screen

Select Oracle Web Tier Utilities Suite.

Make sure Associate Selected Components with WebLogic Domain is not selected.

Click Next.
Specify Component Details Screen
- Instance Home Location: Specify the directory where you want to create your Oracle Instance. This will be your Oracle Instance directory; runtime components will write only to this location.
- Instance Name: Specify a unique name for this instance of Oracle Web Tier (for example, instance2). Valid instance names may only contain alphanumeric and underscore (_) characters, must begin with an alphabetic (a-z or A-Z) character, and must be 4 to 30 characters in length.
- OHS Component Name: Specify the name of your OHS component (for example, ohs1). This name may only contain alphanumeric and the hyphen (-) and underscore (_) characters, and must be 4 to 30 characters in length.
- Web Cache Component Name: Specify the name of your Web Cache component (for example, webcache1). This name may only contain alphanumeric and underscore (_) characters, must begin with an alphabetic (a-z or A-Z) character, and must be 4 to 30 characters in length.
Click Next.
Web Cache Administrator Password Screen

Specify the password for your Web Cache administrator. Valid passwords are 5 to 30 characters long, must begin with an alphabetic character, use only alphanumeric, underscore (_), dollar ($) or pound (#) characters and include at least one number.

Click Next.
Configure Ports Screen

Select Auto Port Configuration.

Click Next.
Specify Email for Security Updates Screen

Enter your E-mail address if you want to receive the latest product information and security updates. If you have a My Oracle account and wish to receive updates via this mechanism, select I wish to receive security updates via My Oracle Support, then enter your account password.

If you do not wish to register for Oracle Configuration Manager, leave all the fields on this screen blank. You will be asked to confirm that you do not wish to receive updates for your configuration. Click Yes to confirm your selection.

Click Next.
Installation Summary Screen

Click Install.
Installation Progress Screen

No action is required; the installer will advance to the next screen after installation is complete.
Configuration Screen

No action is required; the installer will advance to the next screen after configuration is complete.
Installation Completed Screen

At the end of the summary information, there is a section called Accessible URLs which give you the links needed to access the configured Oracle HTTP Server and Oracle Web Cache. Saving this information will make it easier for you to access these pages whenever you need to.

Click Save to save the summary information on this screen. You will be prompted to specify a name and location for your summary file.

Click Finish.

8 Verifying the Installation

You can perform any combination of the following tasks to verify that your installation was successful:

Verify the Installation Logs
Verifying OPMN Status
Checking Browser URLs

8.1 Verify the Installation Logs

Check for the presence of installation log files in logs directory inside your Oracle Inventory directory. On UNIX systems, if you do not know the location of your Oracle Inventory directory, you can find it in the ORACLE_HOME/oraInst.loc file. On Windows systems, the default location for the inventory directory is C:\Program Files\Oracle\Inventory\logs.

8.2 Verifying OPMN Status

Run the opmnctl status command from the bin directory in your instance home location. For example, on a UNIX system:

> cd $INSTANCE_HOME/bin
> ./opmnctl status

Processes in Instance: instance2
---------------------------------+--------------------+---------+---------
ias-component                    | process-type       |     pid | status  
---------------------------------+--------------------+---------+---------
webcache1                        | WebCache-admin     |   24057 | Alive   
webcache1                        | WebCache           |   24056 | Alive   
ohs1                             | OHS                |   23890 | Alive

This information shows the components configured for this installation. The status "Alive" means the component is up and running.

8.3 Checking Browser URLs

Run the opmnctl status -l command from the bin directory in your instance home location to obtain a list of ports used by the components. For example, on a UNIX system:

> cd $INSTANCE_HOME/bin
> ./opmnctl status -l

---------------------------------+--------------------+---------+----------+------------+----------+-----------+------
ias-component                    | process-type       |     pid | status   |        uid |  memused |    uptime | ports
---------------------------------+--------------------+---------+----------+------------+----------+-----------+------
webcache1                        | WebCache-admin     |   24057 | Alive    | 1067146469 |    43712 |  14:43:29 | http_admin:7799
webcache1                        | WebCache           |   24056 | Alive    | 1067146468 |    64072 |  14:43:29 | http_stat:7800,http_invalidation:7801,https_listen:7802,http_listen:7798
ohs1                             | OHS                |   23890 | Alive    | 1067146467 |    50260 |  14:43:39 | https:9999,https:4447,http:7777

Use the port numbers in this display to point your browser to the appropriate pages. Use the format:

http://system_name:port_number

Based on the information above, you would use the URLs in Table 3 to access the various pages from this configuration:

Table 3 Sample Web Tier URLs

Page	Sample URL
Oracle HTTP Server	`http://system_name:7777`
Oracle HTTP Server SSL	`https://system_name:4447`
Oracle Web Cache	`http://system_name:7798`
Oracle Web Cache SSL	`https://system_name:7802`
Oracle Web Cache Administration	`https://system_name:7799`
Oracle Web Cache Statistics	`https://system_name:7800`

9 Deinstalling Oracle Web Tier

You should always use the instructions provided in this section for removing the software. If you try to remove the software manually, you may experience problems when you try to reinstall the software again at a later time. Following the procedures in this section will ensure that the software is properly removed.

The Oracle Web Tier deinstaller gives you the following software removal options:

Deinstall Oracle Home
Deinstall ASInstances managed by WebLogic Domain
Deinstall Unmanaged ASInstances

This section describes how to remove the entire Oracle Home directory. For more information about the other deinstall types, refer to "Deinstalling Oracle Web Tier" in Oracle Fusion Middleware Installation Guide for Web Tier.

The deinstaller will attempt to remove the Oracle Home from which it was started. Before you choose to remove your Web Tier Oracle Home, make sure that it is not in use by an existing domain, and also make sure you stop all running processes that use this Oracle Home.

9.1 Starting the Deinstaller

To start the deinstaller, navigate to the Web_Tier_ORACLE_HOME/oui/bin (for UNIX) or Web_Tier_ORACLE_HOME\oui\bin (for Windows) directory and start the deinstaller.

On UNIX systems:

./runInstaller -deinstall

On Windows systems:

setup.exe -deinstall

On Windows systems, you can also start the deinstaller from the Start menu by selecting Programs > Oracle Web Tier 11g - Home1 > Uninstall.

9.2 Deinstallation Screens and Instructions

Follow the instructions below to remove the installed software.

Welcome Screen

Click Next.
Select Deinstallation Type Screen

Select Deinstall Oracle Home.

Click Next.
Deinstall Oracle Home Screen

Verify the Oracle Home you are about to deinstall.

Click Next to continue.
Deinstall Progress Screen

This screen shows the progress and status of the deinstallation. No action is required; the installer will automatically advance to the next screen when deinstallation is complete.
Deinstall Complete Screen

Click Finish.

10 Additional Resources

For additional information, refer to the Oracle Fusion Middleware Installation Guide for Web Tier, which is available on the Oracle Fusion Middleware Documentation CD-ROM.

Printed documentation is available for sale through your Oracle representative or in the Oracle Store at http://oraclestore.oracle.com.

To download free release notes, installation documentation, white papers, or other collateral, visit Oracle Technology Network (OTN). You must register online before using OTN; registration is free and can be done at http://www.oracle.com/technology/membership/.

If you already have a username and password for OTN, then you can go directly to the documentation section of OTN at http://www.oracle.com/technology/documentation.

10.1 Oracle Support Services

If you purchased Oracle Product Support, you can call Oracle Support Services for assistance. Oracle Support Services include phone assistance, version updates and access to our service offerings. You have access to phone support 24 hours a day, 7 days a week. In the U.S.A., you can call Product Support at 1-800-223-1711.

Make sure you have your CSI (CPU Support Identifier) number ready when you call. Keep the CSI number for your records, because it is your key to Oracle Support Services. The Oracle Store sends the CSI number to you in an e-mail alert when it processes your order. If you do not have your CSI number and you are in the U.S.A., you can look up your CSI number by accessing our online Order Tracker which provides detailed order information. Go to the Oracle Store and click on Order Tracker located above the top navigation bar.

For Oracle Support Services locations outside the U.S.A., call your local support center for information on how to access support. To find the local support center in your country, visit the Support Web Center at http://www.oracle.com/support.

At the Support Web Center you will find information on Oracle Support Services, such as:

Contact Information
Instructions for Accessing Electronic Services
Helpful Web Sites
Support Resources
Oracle Support Portfolio
Oracle Support Services news

With Oracle Product Support, you have round-the-clock access to My Oracle Support (formerly OracleMetaLink), Oracle Support Services premier Web support offering. My Oracle Support offers you access to installation assistance, product documentation, and a technical solution knowledge base.

It has technical forums, where you can post questions about your Oracle products and receive answers from Oracle Technical Support Analysts and other Oracle users. The questions and answers remain posted for the benefit of all users.

My Oracle Support options include:

Technical Assistance Request (TAR) access
Patch Downloads
Bug Database Query Access
Product Life-Cycle Information

You can access My Oracle Support at http://metalink.oracle.com.

10.2 Version Updates

If you do not have a currently supported license, you can purchase the most recent version of an Oracle product from the Oracle Store at http://oraclestore.oracle.com.

If you do have a currently supported license, you can place non-urgent requests for version update shipments through the iTAR feature on My Oracle Support. You will need to log the iTAR type as a U.S. Client Relations/Non-Technical Request.

You can also request Version Update shipments in the U.S.A. by calling Client Relations. When requesting a Version Update, provide the following information to the Client Relations Analyst:

CSI Number
Contact Information
Platform
Product Name
Shipping Address
Product Version Number

Outside the U.S.A., call your local Oracle Support Center.

10.3 Premium Services

For information on our Premium Services, including onsite support, OracleGOLD, remote services, and upgrade packages, visit the Support Web Center at http://www.oracle.com/support.

You can also call your Support Sales Representative in the U.S.A at 1-800-833-3536.

10.4 Quick Reference

For quick access to additional information, refer to Table 4:

Table 4 Links to Additional Information and Resources

I want to...	Contact Information or Web Site
Purchase additional products, full-use licenses, version updates, and documentation in the U.S.A.	`http://oraclestore.oracle.com`
Access technical resources for developers.	`http://www.oracle.com/technology`
Access installation documentation.	`http://www.oracle.com/technology/documentation`
Access information about technical support.	`http://www.oracle.com/support`
Locate local Oracle Support Centers outside the U.S.A.	`http://www.oracle.com/support`
Locate local Oracle offices outside the U.S.A.	`http://www.oracle.com/global`
Call Client Relations in the U.S.A.	1-800-223-1711
Speak with your sales representative in the U.S.A.	1-800-ORACLE-1
Locate TTY Access to technical support in the U.S.A.	1-800-446-2398

11 Documentation Accessibility

Our goal is to make Oracle products, services, and supporting documentation accessible to all users, including users that are disabled. To that end, our documentation includes features that make information available to users of assistive technology. This documentation is available in HTML format, and contains markup to facilitate access by the disabled community. Accessibility standards will continue to evolve over time, and Oracle is actively engaged with other market-leading technology vendors to address technical obstacles so that our documentation can be accessible to all of our customers. For more information, visit the Oracle Accessibility Program Web site at http://www.oracle.com/accessibility/.

Accessibility of Code Examples in Documentation

Screen readers may not always correctly read the code examples in this document. The conventions for writing code require that closing braces should appear on an otherwise empty line; however, some screen readers may not always read a line of text that consists solely of a bracket or brace.

Accessibility of Links to External Web Sites in Documentation

This documentation may contain links to Web sites of other companies or organizations that Oracle does not own or control. Oracle neither evaluates nor makes any representations regarding the accessibility of these Web sites.

Deaf/Hard of Hearing Access to Oracle Support Services

To reach Oracle Support Services, use a telecommunications relay service (TRS) to call Oracle Support at 1.800.223.1711. An Oracle Support Services engineer will handle technical issues and provide customer support according to the Oracle service request process. Information about TRS is available at http://www.fcc.gov/cgb/consumerfacts/trs.html, and a list of phone numbers is available at http://www.fcc.gov/cgb/dro/trsphonebk.html.