F
Configuring the Webserver and Directory Mapping

If you are installing the Oracle Enterprise Manager Web Site without the Oracle HTTP Server that is packaged with Enterprise Manager by default, configure your supported webserver with the instructions below.

• Apache 1.3.9 and higher on Unix

• Internet Information Server (IIS) 4.0 on Windows NT or Windows 2000

Apache 1.3.9 or Higher on Unix

1. Install the Enterprise Manager web site without the Oracle HTTP Server.

2. Install Apache 1.3.9 or higher. Consult your Apache-specific configuration documentation for detailed information.

3. Edit the httpd.conf in the Apache home -> conf ->httpd.conf/. Stop and restart the web listener.

4. ScriptAlias controls which directories contain server scripts. ScriptAliases are essentially the same as Aliases, except that documents in the realname directory are treated as applications and run by the server when requested rather than as documents sent to the client.

   The same rules about trailing "/" apply to ScriptAlias directives as to Alias.

   ScriptAlias /oem_webstage/cgi-bin
   "/private/oemv2/oem_webstage/cgi-bin"
   

Note: /private/oemv2/ is your Oracle Home.

5. Add as many aliases as you need (with no limit). The format is

   Alias fakename realname
   

Note that if you include a trailing "/" on fakename, then the server requires that it is present in the URL. In this example, "/icons" is not aliased. "/icons/" is aliased.

Alias /icons/ "/usr/local/apache/icons/" 
Alias /oem_webstage "/private/oemv2/oem_webstage/" 

Note: /private/oemv2/ is your Oracle Home.

6. Change "/apache/cgi-bin" to where your ScriptAliased CGI directory exists, if you have that configured.

   <Directory "usr/local/apache/cgi-bin"> to

   <Directory "/oem_webstage/cgi-bin">

   AllowOverride all 
   Allow from all 
   </Directory> 
   

   AddHandler allows you to map certain file extensions to "handlers", actions unrelated to filetype. These can be either built into the server or added with the Action command.

   Internet Information Server (IIS) 4.0

   To use the Internet Information Server, you will need to create three virtual directories pointing to the oem_webstage directory and two subdirectories inside of that directory. The oem_webstage directory is created automatically by the installation procedure when you install the Oracle Enterprise Manager Web Site components during one of the following installations:

   • Oracle8i Enterprise Edition 8.1.7.0.0-> Custom

   • Oracle8i Management and Integration 8.1.7.0.0-> Oracle Management Server

   • Oracle8i Management and Integration 8.1.7.0.0-> Custom

   1. Install the Enterprise Manager web site without the Oracle HTTP Server.

   2. Install Internet Information Server (IIS) 4.0. Consult your Internet-Information-Server-specific configuration documentation for detailed information.

   3. From the Windows NT Program Start Menu, select Microsoft Internet Information Server 4.0->Internet Service Manager to configure the Internet Information Server. The "Microsoft Internet Service Manager" screen is displayed.

   4. Click on "Default Web Site" and right mouse-click to display the associated submenu.

   5. Click on "Properties" to display the Properties sheet of the Default Web Site.

   6. Verify that the IP address of the node is correctly set in the Properties sheet. Then click "Ok".

   7. Select New, Virtual Directory.

   8. Enter the name of the virtual directory. For example, oem_webstage.

   9. Specify the following settings:

      Alias: /oem_webstage

      Path: ORACLE_HOME\oem_webstage

      Access: Read, Execute

   10. After saving the settings, expand the "Default Web Site" to display the new virtual directory.

   11. Select the new oem_webstage virtual directory.

   12. Click on the Action button, select New, Virtual Directory to create a additional virtual directory with the following settings:

       Alias: cgi-bin

       Path: ORACLE_HOME\oem_webstage\cgi-bin

       Access: Read, Execute

   13. Create an additional virtual directory with alias "\oem_webstage\java-plugin" and directory ORACLE_HOME\oem_webstage\java-plugin with the following settings:

       Alias: java-plugin

       Path: ORACLE_HOME\oem_webstage\java-plugin

       Access: Read-only

       Note: Make sure you do not enable execute permissions; otherwise, you will not be able to download the plug-in.