This chapter describes how to install Oracle Web Tier Utilities Suite of products. During the install and configuration process, you will have the option to install and configure the following products:
Oracle HTTP Server (OHS)
Oracle Web Cache
Oracle Process Manager and Notification Server (OPMN) is installed and configured by default.
The following topics are covered:
Before performing any installation you should read the system requirements and certification documentation 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).
The system requirements document covers information such as hardware and software requirements, minimum disk space and memory requirements, and required system libraries, packages, or patches:
http://www.oracle.com/technology/software/products/ias/files/fusion_requirements.htm
The certification document covers supported installation types, platforms, operating systems, databases, JDKs, and third-party products:
http://www.oracle.com/technology/software/products/ias/files/fusion_certification.html
Note:
If you are installing the 32-bit version of the product, the system on which you are installing must also be a supported 32-bit system. Installing a 32-bit version of the product on a 64-bit system is not supported.If you are using a 64-bit JVM in your environment, ensure that all your Oracle Fusion Middleware components are using the 64-bit JVM. You cannot mix components using a 32-bit JVM with those using a 64-bit JVM.
Refer to the Oracle Fusion Middleware Certifications matrix for information on the platforms that support a 64-bit JDK:
http://www.oracle.com/technology/software/products/ias/files/fusion_certification.html
If you are installing Oracle Web Tier on a DHCP host, you must follow the configuration steps in this section for your platform.
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
On Windows systems, install a loopback adapter on the DHCP server (see Section 2.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.
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:
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
Subnet mask: Enter 255.255.255.0.
Record the values you entered, which you will need later in this procedure.
Leave all other fields empty.
Click OK.
In the "Local Area Connection 2 Properties" dialog, click OK.
Close Network Connections.
Restart the computer.
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.
You can install Oracle Portal, Forms, Reports and Discoverer 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 2.3, "Installing on DHCP Hosts" to install a loopback adapter and modify the hosts file on your system.
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 host name; 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 operating systems) or %SYSTEMROOT%\system32\drivers\etc\hosts (on Windows operating systems) 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.
This section contains information and instructions for installing Oracle Web Tier. The following topics are covered:
Section 2.6.5, "Installation Instructions for the "Install and Configure" Installation Type"
Section 2.6.6, "Installation Instructions for the "Install Only" Installation Type"
The Oracle Web Tier installer provides two installation options:
Installation Instructions for the "Install and Configure" Installation Type
Installation Instructions for the "Install Only" Installation Type
The Install and Configure option will install the product binaries in an Oracle Home directory and create and configure a working instance in an Oracle Instance directory. After this is complete, you should be able to begin configuring and managing your products using the Administration Console or Enterprise Manager.
Note:
For more information about Oracle Home and Oracle Instance directories, refer to "Installation Overview" in Oracle Fusion Middleware Installation Planning Guide.For more information, refer to Section 2.6.5, "Installation Instructions for the "Install and Configure" Installation Type"
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 operating systems) or Web_Tier_ORACLE_HOME\bin (on Windows operating 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.
For more information, refer to Section 2.6.6, "Installation Instructions for the "Install Only" Installation Type"
The installer writes logs files to the Oracle_Inventory_Location/log (on UNIX operating systems) or Oracle_Inventory_Location\logs (on Windows operating systems) directory. Refer to Section D.2.1, "Installation Log Files" for more information about the log files and their contents.
To start the installer, insert the CD-ROM and run the following command:
On UNIX operating systems:
% ./runInstaller
On Windows operating systems:
G:\ setup.exe
If you are installing on a UNIX system, and if this is the first time any Oracle product is being installed on your system with the Oracle Universal Installer, you will be asked to provide the location of an inventory directory. This is where the installer will set up subdirectories and maintain inventory data for each Oracle product that is installed on this system.
Follow the instructions in Table 2-1 to configure the inventory directory information. For more help, click on the screen name in the table below, or click the Help button in the GUI.
Table 2-1 Inventory Directory and Group Screens
| No. | Screen | Description and Action Required |
|---|---|---|
|
1 |
Specify the Oracle inventory directory and group permissions for that directory. The group must have write permissions to the Oracle inventory directory. Click OK to continue. |
|
|
2 |
Run the Click OK to continue. |
Follow the instructions in Table 2-2 to install and configure Oracle Web Tier.
Note:
Running the installer asroot user is not supported.If you need additional help with any of the installation screens, refer to Appendix A, "Oracle Web Tier Installation Screens" or click Help to access the online help.
Table 2-2 Install and Configure Flow
| No. | Screen | When Does This Screen Appear? | Description and Action Required |
|---|---|---|---|
|
1 |
Always |
Click Next to continue. |
|
|
2 |
Always |
Select Install and Configure. Click Next to continue. |
|
|
3 |
Always |
Click Next to continue. |
|
|
4 |
Always |
Specify the Middleware Home and Web Tier Oracle Home directory locations. The Web Tier Oracle Home directory will be created inside the Middleware Home directory. The Oracle Common Home will also be created automatically inside the Middleware Home directory. Click Next to continue. |
|
|
5 |
Always |
Select the component(s) you want to configure. select Associate Selected Components with WebLogic Domain if you want to associate these components with an existing WebLogic Domain. Click Next to continue. |
|
|
6 |
Only if Associate Selected Components with WebLogic Domain is selected on the Configure Components Screen. |
Specify the credentials for your existing WebLogic domain. Click Next to continue. |
|
|
7 |
Always |
Specify the Oracle Instance location and names for your components. Click Next to continue. |
|
|
8 |
If you selected Oracle Web Cache on the Configure Components Screen |
Specify the password for your Oracle Web Cache administrator. Click Next to continue. |
|
|
9 |
Always |
Select whether you want automatic or manual port configuration. NOTE - If you choose to use the See "Port Numbers" in Oracle Fusion Middleware Administrator's Guide for more information. Click Next to continue. |
|
|
10 |
Always |
If you choose to register for security updates, provide your Email address to be informed of the latest product issues. Click Next to continue. |
|
|
11 |
Always |
Verify the information on this screen. Click Install to begin the installation. |
|
|
12 |
Always |
None. |
|
|
13 |
Always |
Click Next to continue. |
|
|
14 |
Always |
Click Save to save your configuration information to a file. This information includes port numbers, installation directories, URLs, and component names which you may need to access at a later time. After saving your configuration information, click Finish to dismiss the installer. |
Follow the instructions in Table 2-3 to install Oracle Web Tier.
If you need additional help with any of the installation screens, refer to Appendix A, "Oracle Web Tier Installation Screens" or click Help to access the online help.
Table 2-3 Installation Flow for Install Only Option
| No. | Screen | Description and Action Required |
|---|---|---|
|
1 |
Click Next to continue. |
|
|
2 |
Select Install Software - Do Not Configure. Click Next to continue. |
|
|
3 |
Click Next to continue. |
|
|
4 |
Specify the Middleware Home and Web Tier Oracle Home directories. The Web Tier Oracle Home directory will be created inside the Middleware Home directory. The Oracle Common Home will also be created automatically inside the Middleware Home directory. Click Next to continue. |
|
|
5 |
If you choose to register for security updates, provide your email address to be informed of the latest product issues. Click Next to continue. |
|
|
6 |
Verify the information on this screen. Click Install to begin the installation. |
|
|
7 |
Click Next to continue. |
|
|
8 |
Click Finish to dismiss the installer. |
After the installation is complete, you must configure the components. This is done by running a separate configuration tool.
Web_Tier_ORACLE_HOME/bin/config.sh
Web_Tier_ORACLE_HOME\bin\config.bat
Note:
Make sure the Oracle Web Tier installer is not running; running the installer and Configuration Tool concurrently is not supported.By default, the configuration tool will use the Oracle JRockit SDK that can be found inside the Middleware Home directory. If you want to invoke the configuration tool with a Sun JDK, you must point to the specific JDK from the command line:
On UNIX operating systems:
Web_Tier_ORACLE_HOME/bin/config.sh -jreLoc Sun_JDK_Location
On Windows operating systems:
Web_Tier_ORACLE_HOME\bin\config.bat -jreLoc Sun_JDK_Location
You must specify the full path to your Sun JDK location.
After you have started the configuration tool, follow the instructions in Table 2-4.
| No. | Screen | When Does This Screen Appear? | Description and Action Required |
|---|---|---|---|
|
1 |
Always |
Click Next to continue. |
|
|
2 |
Always |
Select the component(s) you want to configure. select Associate Selected Components with WebLogic Domain if you want to associate these components with an existing WebLogic Domain. Click Next to continue. |
|
|
3 |
Only if Associate Selected Components with WebLogic Domain is selected on the Configure Components Screen. |
Specify the credentials for your existing WebLogic Domain. Click Next to continue. |
|
|
4 |
Always |
Specify the Oracle Instance location and names for your components. Click Next to continue. |
|
|
5 |
If you selected Oracle Web Cache on the Configure Components Screen |
Specify the password for your Oracle Web Cache administrator. Click Next to continue. |
|
|
6 |
Always |
Select whether you want automatic or manual port configuration. NOTE - If you choose to use the See "Port Numbers" in Oracle Fusion Middleware Administrator's Guide for more information. Click Next to continue. |
|
|
7 |
Always |
If you choose to register for security updates, provide your email address to be informed of the latest product issues. Click Next to continue. |
|
|
8 |
Always |
Verify the information on this screen. Click Configure to begin the configuration. |
|
|
9 |
Always |
Click Next to continue. |
|
|
10 |
Always |
Click Save to save your configuration information to a file. This information includes port numbers, installation directories, URLs, and component names which you may need to access at a later time. After saving your configuration information, click Finish to dismiss the installer. |
After installation and configuration are complete, there may be some post-installation tasks you need to perform, depending on your specific topology and configuration. The following topics are covered in this section:
By default, routing between Oracle HTTP Server and Oracle WebLogic Server is not configured. In order to allow requests to be proxied from Oracle HTTP Server to Oracle WebLogic Server, you must configure a plug-in.
For instructions on how to do this, see "mod_wl_ohs" in the Oracle Fusion Middleware Administrator's Guide for Oracle HTTP Server.
If you are using Oracle Web Cache with Oracle BAM, you must perform the configuration steps detailed in "Basic Tasks for Configuring and Monitoring Caching Rules" in Oracle Fusion Middleware Administrator's Guide for Oracle Web Cache.
Use the following Oracle BAM settings:
Expression Type : Regular Expression URL Expression : oracle.bam.web (or Event=viewReport, for the second rule) HTTP Methods : Select all Leave URL and POST Body Parameters empty. POST Body Expression : .* Caching Policy : Don't Cache Leave Comment as it is. Compression : Off Enabled : yes
You can perform any combination of the following tasks to verify that your installation was successful:
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 WebTier_ORACLE_HOME/oraInst.loc file. On Windows systems, the default location for the inventory directory is C:\Program Files\Oracle\Inventory\logs.
Check the domain server logs, which are located in the servers directory inside the domain home directory. For example, on UNIX systems:
Web_Tier_ORACLE_HOME/user_projects/domains/domain_name/servers/server_name
On Windows systems:
Web_Tier_ORACLE_HOME\user_projects\domains\domain_name\servers\server_name
Run the opmnctl status command from the INSTANCE_HOME/bin (on UNIX operating systems) or INSTANCE_HOME\bin (on Windows operating systems) directory in your instance home location. For example:
> ./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.
Run the opmnctl status -l command from the INSTANCE_HOME/bin (on UNIX operating systems) or INSTANCE_HOME\bin (on Windows operating systems) directory in your instance home location to obtain a list of ports used by the components. For example:
> ./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 2-5 to access the various pages from this configuration: