E
Configuring the Webserver and Directory Mapping

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

• Apache 1.3.9 on Solaris

• Oracle Application Server 4.0.8 on Windows NT and Solaris

• Internet Information Server (IIS) 4.0 on Windows NT

Apache 1.3.9 on Solaris

1. Install the Enterprise Manager web site without the Oracle Application Server Listener.

2. Install Apache 1.3.9. 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"
   

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

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.

   You must uncomment the following lines to use server side includes or CGI outside ScriptAliased directories:

   # 
   # To use CGI scripts: 
   AddHandler cgi-script .exe
   

Oracle Application Server 4.0.8 on Windows NT and Solaris

Note: The steps below do not apply to the Oracle Application Server Listener that is packaged with Enterprise Manager by default; they only apply to the Oracle Application Server that you install separately from Oracle Enterprise Manager.

1. Install the Enterprise Manager web site without the Oracle Application Server Listener.

2. Install Oracle Application Server 4.0.8. Consult your Oracle-Application-Server-specific configuration documentation for detailed information.

3. Invoke your web browser and point to the Oracle Application Server V4.0 administration page at the URL http://<webserver>:<admin-port>/

   e.g. http://myserver.mydomain:8888/

4. Expand the main section "Website40" site.

5. In the "HTTP Listener" section, associate the virtual directories to the physical directories on the "Directory" page.

   File-system directory	Flag	Virtual Directory
   <drive>:\oem_webstage\	NR	/oem_webstage/
   <drive>:\oem_webstage\cgi-bin\	CR	/oem_webstage/cgi-bin/

6. After setting up the virtual directories, you must stop and restart the corresponding webserver listener.

Note: If you are using Oracle Application Server 4.0.8, you must use Microsoft® Internet Explorer 5.0 or Netscape Navigator® 4.51 or later browsers. If you attempt to use Microsoft® Internet Explorer 4 with Oracle Application Server 4.0.8, the following error occurs when launching the Console: exception: Sun.applet.AppletSecurityException: checkpropsaccess.key

Internet Information Server (IIS) 4.0

1. Install the Enterprise Manager web site without the Oracle Application Server Listener.

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. Right-click and choose service properties; then, tab to directories. Click Add.

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

9. Specify the following settings:

   Alias: /oem_webstage

   Path: c:/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: c:\oem_webstage\cgi-bin

    Access: Read, Execute

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

    Alias: java-plugin

    Path: c\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.

14. Verify that the plug-in is installed on the system where you are running your web browser. It is located in the directory c:\oem_webstage\java-plugin.