5
Running Enterprise Manager Console from a Web Browser

This chapter will describe how to run the Enterprise Manager Console and its management applications from a web browser.

Running the Oracle Enterprise Manager Console from a Web Browser

With Oracle Enterprise Manager, an administrator is not limited to managing targets from a particular machine where the product has been installed. Instead, administrators can deploy the Enterprise Manager Web Site in order to run the Enterprise Manager Console from any supported web browser.

All Enterprise Manager products and applications are web-enabled with the following exceptions:

• Oracle Diagnostics Pack
  • Oracle Capacity Planner
  • Oracle Trace Data Viewer
• Oracle Tuning Pack
  • Oracle Expert
  • Oracle Index Tuning Wizard
  • Oracle SQL Analyze
• Integrated Applications
  • Oracle Directory Manager
  • Oracle Net Manager

In order to run Oracle Enterprise Manager from a web browser, you must perform the following installation and configuration steps.

Client Install

Ensure that a supported web browser is installed on the client machines that will run web-enabled Enterprise Manager.

Supported web browsers are listed below:

• Netscape Navigator Release 4.7 for Windows NT, Windows 2000, Windows XP, and Windows 98
• Microsoft Internet Explorer Release 5.0 for Windows NT, Windows 2000, and Windows 98
• Microsoft Internet Explorer Release 5.5 for Windows NT, Windows 2000 and Windows 98
• Microsoft Internet Explorer Release 6.0 for Windows XP

Server-Side Install

1. Ensure that the Enterprise Manager web site component has been installed.

   By default, it is installed with the Management Server under the Oracle_Home/oem_webstage/ directory. In addition, the Enterprise Manager web site automatically installs a preconfigured Oracle HTTP server to act as its web server. The Oracle HTTP server is automatically started. This is the same HTTP server that is used by the Enterprise Manager Reporting web site.

2. Start the Oracle HTTP Server by performing the following steps:

   On Windows NT:

   To start the Oracle HTTP Server:

   1. From the Start menu, choose Settings > Control Panel.
   2. Double-click Services.
   3. Select the OracleHTTPServer_<Oracle_Home_Name> service.
   4. Click Start to start the Oracle HTTP Server.

   On UNIX:

   You can start the Oracle HTTP Server from the command line using the command:

   $Oracle_Home/Apache/Apache/bin/apachectl start

   To stop the Oracle HTTP Server, perform the following steps:

   On Windows NT:

   To stop the Oracle HTTP Server:

   1. From the Start menu, choose Settings > Control Panel.
   2. Double-click Services.
   3. Select the OracleHTTPServer_<Oracle_Home_Name> service.
   4. Click Stop to stop the Oracle HTTP Server.

   On UNIX:

   You can stop the Oracle HTTP Server from the command line using the command:

   $Oracle_Home/Apache/Apache/bin/apachectl stop

If you want to use a web server other than the default configured Oracle HTTP Server Release 1.3.22.0.0a for the browser-based Enterprise Manager, you must install and manually configure another supported web server. Additional supported web servers include:

• Oracle Internet Application Server Release 1.0.2.2.2 for Sun SPARC Solaris, Windows NT, and Windows 2000
• Apache Release 1.3.22 for Sun SPARC Solaris, Windows NT, and Windows 2000
• Microsoft Internet Information Server Release 4.0 for Windows NT
• Microsoft Internet Information Server Release 5.0 for Windows 2000

For examples on configuring the non-Oracle web servers for use with browser-based Enterprise Manager, refer to "Configuring the Web Server and Directory Mapping for Web Site".

Run the Browser-Based Oracle Enterprise Manager Console on the Client

Figure 5-1 The emwebsite.html Page

Text description of the illustration website.gif

After performing the above configuration steps, you are ready to start the browser-based Oracle Enterprise Manager.

1. Open your web browser and enter the following URL regardless of which web server you have installed.

   http://<webserver hostname>:<port number>/

   For example:

   http://znripley-sun.us.ovenbird.com:3339/

   Note: The default preconfigured Oracle HTTP Server's port number is 3339.

   The index (emwebsite.html) page will appear. The index page lets you start the Enterprise Manager Console, Enterprise Manager Reporting web site, and documentation, and access various web sites. For information on setting up the Enterprise Manager Reporting Web Site, see "Configuring Enterprise Manager Reporting".

2. From this index page, if you want to start the Console, enter the machine name for the Management Server to which you want to connect and click Launch Console. If you want to access published Enterprise Manager reports, enter the reporting web server hostname and port number (if it is different from the defaults) and click Access Report. You must have configured Enterprise Manager Reporting prior to clicking the button. For information on setting up the Enterprise Manager Reporting Web Site, see "Configuring Enterprise Manager Reporting".
3. If you are entering the URL for the first time, you must install the Oracle JInitiator plug-in 1.1.8.18o.

   On Netscape, you are automatically prompted to install the plug-in.

   Note: Once you are prompted to install the plug-in and you exit or cancel before installing it, you will no longer be prompted to install it the next time you start the browser-based Enterprise Manager. In this situation, to install the plug-in, select Download Plug-in on the index page to download the java plug-in.

   On Microsoft Internet Explorer, you can select Download Plug-in on the index page to download the plug-in.

4. Follow the instructions on the plug-in page to download the plug-in. Downloading the plug-in may take several minutes depending on your machine and network environment.
5. After installing the java plug-in, a dialog will appear, which explains the following:

   The Console applet has been started from the browser window. Closing the dialog will cause the applet to stop.

   You will not be able to close the Oracle Enterprise Console window without stopping the Console since the application has been started from this browser window.

   You can exit the emwebsite.html page without exiting the Console.

   In addition, the Oracle Enterprise Manager Console Login will appear.

   Note: Starting the browser-based Oracle Enterprise Manager for the first time may take several minutes, and if you are running a dial up connection, download times will typically be longer and vary based on the line speed. A progress dialog will appear the first time you start browser-based Oracle Enterprise Manager.

6. If you are logging in to Oracle Enterprise Manager for the first time, type in the default credentials (administrator name and password).

   Administrator = sysman

   Password = oem_temp

   These credentials are for the default Super Administrator account. The first time you start Enterprise Manager, you must login as this Super Administrator. After other administrator accounts have been created using the Super Administrator account, you can login as a different administrator.

   Note: If you are not able to connect to the Management Server specified, you must return to the index (emwebsite.html) page to enter a different Management Server machine name. You cannot simply enter a new Management Server machine name at the Oracle Enterprise Manager Console Login.

7. Bookmark the URL.

   Note: You can access only one URL for running browser-based Enterprise Manager applications. You cannot access browser-based Enterprise Manager applications from multiple URLs from a single machine.

Configuring the Web Server and Directory Mapping for Web Site

If you want to use a web server other than the default preconfigured Oracle HTTP server for browser-based Enterprise Manager, you must install and manually configure another supported web server.

To configure the Apache Server, Microsoft Internet Information Server, or Oracle Internet Application Server, refer to the following instructions.

Apache 1.3.22

1. Install the Enterprise Manager web site without the Oracle HTTP Server.
2. Install Apache 1.3.22. Consult your Apache-specific configuration documentation for detailed information.
3. Edit the httpd.conf located in the Apache home/conf/httpd.conf/.
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/ora92/oem_webstage/cgi-bin/"
   
   

   Note: /private/ora92/ 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/ora92/oem_webstage/" 
   
   

   Note: /private/ora92/ 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 "/private/ora92/oem_webstage/cgi-bin">

   AllowOverride all 
   Allow from all 
   </Directory> 
   
   

7. Stop and restart the web server.

   apachectl stop
   apachectl start
   

Internet Information Server (IIS)

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 the Oracle Enterprise Manager Web Site component is installed:

1. Install the Enterprise Manager web site without the Oracle HTTP Server.
2. Install Internet Information Server (IIS). Consult your Internet-Information-Server-specific configuration documentation for detailed information.
3. From the Windows NT Program Start Menu, select Microsoft Internet Information Server > Internet Service Manager to configure the Internet Information Server. The Microsoft Internet Service Manager window is displayed.
4. Choose Default Web Site and right mouse-click to display the associated submenu.
5. Click Properties to display the Properties sheet.
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 Action, 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.

14. Restart the web server.

Oracle Internet Application Server

1. Install the Enterprise Manager web site without the Oracle HTTP Server.
2. Stop all services from this installation.
3. Install the Oracle Internet Application Server in a different Oracle Home on the same machine. Refer to the Oracle9i Application Server Installation Guide in the Oracle9iAS platform-specific documentation for complete installation information.
4. From the Oracle Internet Application Server installation, locate oem.conf in its Oracle home/oem_webstage directory.
5. Edit all the directories in the oem_conf file to point to the corresponding directories under the 9.2 install.

   For example, change

   /private/oracle/ias10222/oem_webstage

   to

   /private/oracle/920rel10/oem_webstage

6. Search for EMWebSite.html and change it to emwebsite.html.
7. Stop and restart the Apache web server from the Oracle Internet Application installation.

   apachectl stop
   apachectl start
   
   

8. Open your web browser and enter the following URL:

   http://<webserver hostname>:<port number>/

   For example:

   http://znripley-sun.us.ovenbird.com:3339/

   This launches the 9.2 client connected to the ias10222 web server.