Oracle Enterprise Manager Web Site Release Notes Release 9.0.2 Part Number A96638-01 |
|
Oracle Enterprise Manager Web Site Release Notes
April 2002
Part No. A96638-01
This document summarizes the differences between the Oracle Enterprise Manager Web site and its documented functionality.
The following release notes apply to all the management components and their Enterprise Manager Home Pages.
The following table describes the minimum browser requirements for each supported platform. If your browser does not meet the minimum browser requirement, the Enterprise Manager displays an error message and you must update your browser version before proceeding.
When you are using the Oracle Enterprise Manager Web Site, you must have cookies enabled for your Web browser. For more information, see the online help for your browser.
Oracle strongly recommends that you use the Secure Socket Layer (SSL) protocol and HTTPS for all connections to the Oracle Enterprise Manager Web Site in your production environment. For complete instructions about configuring the Oracle Enterprise Manager Web Site for SSL, see the Oracle9iAS Administrator's Guide.
The Oracle Enterprise Manager Web site requires Java Development Kit (JDK) 1.3.1. If you are using an earlier version of the JDK, or if the JDK 1.3.1 is not in the current path, you will notice errors similar to the following example in the Oracle Enterprise Manager Web site error logs:
-Xmx128m: illegal argument usage: java [-options] class
To avoid this problem, be sure the location of your JDK 1.3.1 /bin
directory is included in the PATH environment variable before starting the Enterpirse Manager Web site.
For security reasons, always exit your browser after you finish using the Oracle Enterprise Manager Web Site. This will ensure that other users cannot access the configuration and administration features provided by Enterprise Manager.
To run the Oracle Enterprise Manager Web Site, you must properly configure the X Server software on your UNIX system.
Specifically, you must define the DISPLAY environment variable. This variable is required for the X Server software.
To set the variable:
If you are using ksh
or other Born-shell, issue the following commands:
$ DISPLAY=<hostname>:0.0; export DISPLAY
If you are using csh
or tcsh
, issue the following commands:
% setenv DISPLAY <hostname>:0.0
In the examples, replace <hostname>
with the name of a valid host running the X Server software.
You allow remote access by entering the following command:
% xhost +
If you install multiple Oracle9iAS instances on the same host (for example, if you install an Infrastructure and an application server instance on the same host), you must perform the installations from the same account. Otherwise, the Enterprise Manager Web site will not be able to manage either of the instances.
For example, suppose you log in as oracle
and install Instance A. Later, you log in to the same host as jsmith
and install Instance B.
When you restart the Enterprise Manager Web site and display the instance Home Pages, you will notice that the status of some components is "unknown." In addition, you may receive "permission denied" errors when you try to start or stop the Web site.
To recover from this situation you must log in as jsmith
and uninstall Instance B, then log in as oracle
and reinstall Instance B.
Incorrect data may appear on a property page if you do the following:
Enterprise Manager shows the unapplied changes rather than the initial property settings. To see the initial configuration settings, click Revert at the bottom of the page to revert back to the data in the configuration files.
To refresh the configuration data so it matches the current state of the configuration files, click the Refresh Data icon next to the timestamp. For more information, see the topic "Refreshing Pages" in the Oracle Enterprise Manager Web Site online help. (Bug #2185719)
Sometimes, when you display the metrics for a component, some of the metrics are unavailable. Most often this occurs just after you start the Oracle Enterprise Web Site or the component you are monitoring. If some metrics appear as unavailable, click the Refresh Data icon next to the time stamp. For more information, see the topic "Refreshing Pages" in the Oracle Enterprise Manager Web Site online help.
If you click the browser's refresh button on a confirmation, warning, or error page, you are prompted by the browser to perform the operation again. For example, Internet Explorer 5.5 displays the following message:
This page cannot be refreshed without resending the information. Click Retry to send the information again, or click Cancel to return to the page that you were trying to view.
If you click Retry, the operation you just performed will attempt to execute again, but it should fail with an error. Acknowledge the error and you will be brought back to the page that caused the operation.
If Enterprise Manager displays a confirmation or error page, do not click the browser's refresh button; instead use the browser's back button to return to the previous page.
Also, avoid using the browser's back button to go back to a confirmation, warning, or error page.
Do not use multibyte, accented, or special characters when you are entering data into Oracle Enterprise Manager Web Site text input fields, such as those used when you are entering a name for an Oracle Containers for J2EE (OC4J) instance or when you are modifying component configuration fields.
For example, avoid using the following characters in text entry fields:
Note in particular that J2EE application names with "%%
" or "%<hex digit>
" are problematic.
The Oracle Enterprise Manager Web Site pages are set to expire after 20 minutes. For example, if you display a component Home Page and then leave your computer for more than 20 minutes, Enterprise Manager displays a "Session Expired" message if you attempt to apply any configuration changes. Click OK to dismiss the error message and continue working. You will need to reenter any configuration changes that were entered but not applied.
There are situations that can cause the Oracle Enterprise Manager Web site to time out or hang. For example, a timeout can occur if the Enterprise Manager Web site on one of the application server instances in a cluster was shut down improperly with the UNIX kill
command.
To recover from a timeout or hang situation, stop the Enterprise Manager Web site, make sure that the Distributed Configuration Management (DCM) software for each application server instance is shut down completely, and then restart the Oracle Enterprise Manager Web site.
Note that only one Enterprise Manager Web site runs on each host, but an instance of DCM runs on every application server instance. For example, if you installed Instance A and Instance B on a single host, do the following:
cd <instance_A_home>/dcm/bin/
dcmctl shutdown -force
cd <instance_B_home>/dcm/bin
dcmctl shutdown -force
For more information about starting, stopping, and restarting Oracle9iAS components, see the Oracle9i Application Server Administrator's Guide.
If you use a UNIX system utility such as top, you may notice that the swap space statistics reported by the top utility do not match those provided on the Host Home Page. This is because some versions of the top utility include not only disk-based swap space, but swap space reserved in your computer's physical memory when they calculate the swap space statistics. In fact, more recent versions of the top utility report swap space values that closely match the values shown on the Host Home Page. You can also obtain similar results using the swap -s
command.
If you install multiple Application Server instances on a host, you should restart the Oracle Enterprise Manager Web site after each consecutive application server installation. This allows the Enterprise Manager Web site to gather information about the new installations.
For example, if you install an Oracle9iAS Infrastructure and then install an Application Server installation type on the same host, you should restart the Oracle Enterprise Manager Web site before you redisplay the Home Pages for your site.
If you use the Enterprise Manager Web site to change the orasso schema password, the Oracle HTTP Server will not be restarted automatically. As a result, you will not be able to use the Single Sign-On Home Page.
To fix the problem, use the command line to manually restart the Oracle HTTP Server to update the orasso password.
For more information about starting, stopping, and restarting Oracle9iAS components, see the Oracle9i Application Server Administrator's Guide.
When using the Enterprise Manager Web Site, users may experience delays while pages are being rendered or refreshed under certain conditions. For example, users may experience these delays if the server host resources are being used to near maximum capacity. Be sure to review the minimum system requirements for each installation type described in the Oracle9i Application Server Installation Guide.
When you add an Oracle9iAS instance to a farm by clicking Use Infrastructure on the Oracle9iAS Instance Home Page, you must restart the Oracle Enterprise Manager Web site. Otherwise, the Instance Home Page will not indicate that the instance is part of the Oracle9iAS farm.
For more information about associating your Oracle9iAS instance with an Infrastructure, see the Oracle9i Application Server Administrator's Guide or the topic "About Using the Oracle9iAS Infrastructure" in the Oracle Enterprise Manager Web Site online help.
To associate an application server instance with an Oracle9iAS Infrastructure, you use the Use Infrastructure link and the Use Infrastructure wizard. If while adding the instance to the Infrastructure, a problem occurs and the Use Infrastructure feature fails, you may end up in a situation where the instance is not associated with an Infrastructure, but the Use Infrastructure command is unavailable.
To redisplay the Use Infrastructure command on the Oracle9iAS Instance Home Page, do the following:
<ORACLE_HOME>/config/ias.properties
InfrastructureUse=true
false
:
InfrastructureUse=false
The next time you display the Oracle9iAS Instance Home Page, the Use Infrastructure link should be available on the page.
If you change the TCP/IP address of the host computer after installing Oracle9iAS, you will likely have trouble restarting the Oracle Enterprise Manager Web site.
If you are using the J22EE and Web Cache install type, without an Infrastructure, you can remedy the problem as follows:
emctl stop
The emctl command is located in the $ORACLE_HOME/bin
directory.
rm -rf $ORACLE_HOME/dcm/repository rm $ORACLE_HOME/dcm/config/dcm.conf
emctl start
This should create a new dcm.conf
file with the proper IP address.
The following release notes apply when you are creating and managing Oracle9iAS clusters.
Using EM you can add an application server instance to a cluster by clicking Join Cluster button on the Farm Home Page, or by clicking Add Instance button from the Cluster Home Page.
If the instance you are trying to add to a cluster is not clusterable or is incompatible with the cluster, you will receive the following error message:
Instance "instance-name" cannot be added to cluster "cluster-name". Instances containing non-clusterable components cannot be added to any cluster. The joining instance must have the same components configured as the cluster. Also, instances containing non-distributable applications cannot be added to an empty cluster.
An instance to be added to a cluster can only have the following types of components configured: HTTP Server, OC4J, WebCache.
To pinpoint the exact reason(s) the instance cannot be added to the cluster, you can use the DCM command line utility (dcmctl) from the instance you are trying to add, as follows:
$ORACLE_HOME/dcm/bin/dcmctl shell
isClusterable
command to see if the instance can be clustered:
dcmctl> isClusterable -v -i <instance_name>
Include the optional instance name parameter because the user is not necessarily running on the instance that is not clusterable.
isCompatible
command to see if the instance is compatible with the cluster:
dcmctl> isCompatible -v -cl <clusterName> -i <instance name>
After you add the first application server instance to an Oracle9iAS cluster, subsequent instances added to the cluster are modified automatically to match the configuration settings of the original instance. However, configuration settings on the HTTP Server and OC4J component pages may not be updated immediately after you add the instance to the cluster.
To update the configuration settings for the HTTP Server and OC4J component pages, click the Refresh Data icon next to the time stamp on the page. For more information about the Refresh Data icon, see the topic "Refreshing Pages" in the Oracle Enterprise Manager Web Site online help.
When you make OC4J or HTTP Server configuration changes or you deploy OC4J applications in an Oracle9iAS cluster, those changes and actions are automatically applied to the other application server instances in the cluster.
However, in some cases, when you view the configuration settings for one of the other application server instances, you may temporarily see the previous configuration information. To see the updated configuration information, click the Refresh Data icon to refresh the data on the page.
If the Distributed Configuration Management (DCM) software is not running on one or more of the application servers in an Oracle9iAS cluster, you will receive the following error if you make changes to one of the application server instances in the cluster or attempt to start, stop, or restart the cluster:
The operation failed.. The distributed configuration management daemon is not running on one of the iAS instances in the cluster. This is typically run as part of the "Enterprise Management Daemon" or as a separate DCM daemon.
The changes you made to the application server instance will be applied to the other instances in the cluster as soon as the Oracle Enterprise Manager Web site (including DCM) in started successfully on the other instances.
When you are configuring an application server instance that is part of a cluster, use relative paths when entering file names and path names in any configuration fields. For example, use paths that are relative to the Oracle Home. This will ensure that the path names will be valid on multiple hosts in the cluster.
If you change the schema for an application instance that belongs to a cluster, the new schema connect string will not be applied automatically to the other application server instances in the cluster. You must use the Configure Schema link on the Home Page for each instance in the cluster.
The following release notes apply specifically to the Oracle Containers for J2EE (OC4J) Home Page and its related pages.
If you deploy an application manually, by editing the server.xml file on the Advanced Properties page, Enterprise Manager displays errors as the application is deployed. To workaround this problem, acknowledge all the errors, wait for the application to deploy, and then click the Refresh Data icon next to the time stamp on the page.
For more information about the Refresh Data icon, see the topic "Refreshing Pages" in the Oracle Enterprise Manager Web site online help.
Note: In general, Oracle recommends that you use the Enterprise Manager Web Site to deploy your applications; otherwise, errors will be generated during the deployment.
If you visit the pages of a deployed application, and then redeploy the application using the same name, the data on some of the pages for the application will reflect the condition of the application the first time you deployed it.
To be sure the information displayed reflects the state of the most recently deployed application, close and reopen your browser or click the Refresh Data icon next to the time stamp on the page.
For more information about the Refresh Data icon, see the topic "Refreshing Pages" in the Oracle Enterprise Manager Web site online help.
When you redeploy an application in OC4J, the redeploy action overwrites the existing web module URL mapping with the maping specified in application.xml's <context-root>. As a result, if you change the URL mapping in the deploy wizard, you will have to change it again if you redeploy the application later.
When you specify the location of required files associated with a J2EE application, you must specify absolute paths when you deploy the application.
For example, if you are selecting an XML user manager in the OC4J Deploy Application Wizard, you must enter an absolute path to the principals.xml
file; otherwise, you cannot select Security Role Mappings later in the wizard.
If you cannot specify an absolute path to the file (for example, if you have included the principals.xml file in your .ear file), you can set the Security Role Mappings later, after you deploy the application, using the Application Security properties page.
For more information about setting security options for your J2EE application, see the topic "Establishing Security Role Mappings for Application Security" in the Oracle Enterprise Manager Web Site online help.
When you use the OC4J Deploy Application Wizard, only security roles mentioned in application.xml
can be mapped using the Security Role Mappings page. Security roles defined in web.xml
or ejb-jar.xml
cannot be mapped using the Security Role Mappings page.
While choosing to use the JAZN-XML user manager, you must must specify a file that exists and conforms to the jazn-data.xml template. (Bug 2262786)
If you make changes to the users or groups for an application that's using the JAZN-XML user manager, the target OC4J instance needs to be restarted before the changes will take effect.
For more information about starting, stopping, and restarting Oracle9iAS components, see the Oracle9i Application Server Administrator's Guide.
You do not need to restart the OC4J instance if you are using the Principals user manager (XML user manager).
If you add users for one OC4J application and then you attempt to add users for a second OC4J application, Enterprise Manager shows a list of users for the first application. The Add User page shows the cached Group Memberships from the first application you modified.
To workaround this problem:
Enterprise Manager shows the correct group memberships for the second application.
As an alternative, you can also workaround this problem by existing and restarting the the browser or opening a second Web browser before editing the users for another OC4J appication.(Bug 2290349)
The online help topic "About the OC4J Default Instances" does not include the complete set or final names of the OC4J default instances that are installed and configured automatically by the Oracle9iAS installation procedure. For example, the topic describes the "home" instance, which is actually the "OC4J_home" instance.
When publishing a webservice from the deployment wizard, EM displays the Web Service Details page. This page contains a URL to Service field that contains the URL of the Web Service. This URL includes the host that OC4J is running on as well as the port that the HTTP Server is listening on. If you have changed the port that the HTTP Server is listening on since you installed Oracle9iAS, you should edit the value in this field to contain the correct port.
The following release notes apply specifically to the Oracle HTTP Server Home Page and its related pages.
If you attempt to use the Enterprise Manager Web Site to start the HTTP Server, but the HTTP Server does not start, check for troubleshooting information as follows:
Enterprise Manager displays the HTTP Server error log. Review the entries in this file for possible error conditions.
If you need more information to determine why the HTTP Server doesn't start, use the operating system command line to locate and review the contents of the following log file:
<ORACLE_HOME>/opmn/logs/HTTP Server.1
Access logs for a virtual host should be listed in the Logging section of the Virtual Host Properties page. However, sometimes no access logs are listed on the Virtual Host Properties page.
To check the access log for a virtual host, refer to the access log for the HTTP Server instance. To check the HTTP Server access log, navigate to the Logging section of the HTTP Server Properties page.
If you have trouble printing the Status Metrics or Response and Load Metrics pages while using Netscape Navigator on a Sun Solaris system, try the following:
If you still can't print the monitoring pages, try printing to a file instead of the printer.
You cannot print the Error Log page when using Netscape Navigator for Sun Solaris. To print the Error Log page, you must use a different browser or platform.
Some pages are difficult to use with the default font size of 18. For example, to see the entire contents of the Error Log page, you may have to use two scroll bars. To avoid these types of issues, change the browser's Fixed Width Font Size to a smaller size.
The memory usage statistics displayed for Oracle HTTP Server do not take into account shared memory. If apache has many child processes, the memory usage of apache will be displayed as a much higher number than the actual usage.
To see the actual memory usage, give the memory script set uid
privileges as follows:
chown root $ORACLE_HOME/sysman/admin/scripts/pmapinfo.ksh chmod 6750 $ORACLE_HOME/sysman/admin/scripts/pmapinfo.ksh
Editing large configuration files such as httpd.conf,
using the Advanced Properties page, does not work with certain versions of Netscape on Solaris. In some cases, the edit field that should contain the configuration file is empty. As a workaround, try upgrading your version of Netscape or using a different browser to edit the configuration file.
The following release notes apply to the Oracle Syndication Server Home Page and its related pages.
If you are viewing data on a Syndication Server property page or configuration page, and then you display the same page for a different instance of Oracle9iAS, the page data may not be updated correctly. In other words, you may see the data that applies to the first Oracle9iAS instance. To see the correct data, click the Refresh Data icon next to the time stamp of the page.
For more information about the Refresh Data icon, see the topic "Refreshing Pages" in the Oracle Enterprise Manager Web site online help.
Before using the Configure Component link on theOracle9iAS Home Page to configure JServ, you must first uncomment the single line that includes jserv.conf
in Oracle HTTP Server configuration file:
<ORACLE_HOME>/Apache/Apache/conf/httpd.conf
The Oracle9iAS Containers for J2EE Services Guide provides instructions for managing JAAS. However, after the Services Guide was published, the user interface screens used for managing JAAS were updated.
Refer to the following instructions for late-breaking information about managing JAAS using the Oracle Enterprise Manager Web site.
To configure JAAS:
$ORACLE_HOME/sysman/j2ee/config/jazn.xml
jazn.xml
file includes valid entries for the following properties:
<property name="ldap.service" value="ldap://localhost:389"/> <property name="ldap.user" value="cn=oracleadmin"/> <property name="policymgr.provider" value="LDAP"/>
ldap.password
property by entering the password you used for Oracle Internet Directory server login. Be sure to include an exclamation point (!) before the password so it will be encrypted.
<property name="ldap.password" value="!manager1234"/>
To access the JAAS provider pages using the Oracle Enterprise Manager Web site:
Enterprise Manager displays the OJAAS Security page.From this page, you can:
For more information, see the Oracle9iAS Containers for J2EE Services Guide.
When you use the emctl
command to start the Oracle Enterprise Manager Web Site, you have to configure the environment properly; otherwise, the Web Site may display corrupted multibyte characters as square boxes.
Please follow the steps below to configure the environment properly. The steps below use the Japanese environment as an example:
If you are using ksh or other Born-shell, issue the following commands:
$ LC_ALL=ja; export LC_ALL
$ LANG=ja; export LANG
If you are using csh or tcsh, issue the following commands:
% setenv LC_ALL ja
% setenv LANG ja
% locale
LANG=ja
LC_CTYPE="ja"
LC_NUMERIC="ja"
LC_TIME="ja"
LC_COLLATE="ja"
LC_MONETARY="ja"
LC_MESSAGES="ja"
LC_ALL=ja
(Bug #2218514)
Some of the data provided by the Enterprise Manager Web site is presented in graphical charts. Often, however, these graphical charts cannot be read by users of assistive technology, such as screen readers.
To accommodate the use of screen readers, the Enterprise Manager Web site can be configured to display an equivalent text-based table of data for each chart.
To generate text-based tables for the graphical charts:
$ORACLE_HOME/sysman/webapps/emd/WEB-INF/web.xml
web.xml
file:
<context-param> <param-name>enableChartDescription</param-name> <param-value>true</param-value> </context-param>
Oracle is a registered trademark, and Oracle9i is a trademark or registered trademark of Oracle Corporation. Other names may be trademarks of their respective owners.
Copyright © 2002 Oracle Corporation.
All Rights Reserved.
|
Copyright © 2002 Oracle Corporation. All Rights Reserved. |
|