Changes in this Release for Autonomous Health Framework Users Guide 18c
This preface lists changes in Oracle Autonomous Health Framework for Oracle Database 18c.
- New Features for Oracle ORAchk and Oracle EXAchk 12.1.0.2.7
- New Features for Oracle ORAchk and Oracle EXAchk 12.2.0.1.1
- New Features for Oracle ORAchk and Oracle EXAchk 12.2.0.1.2
- New Features for Oracle ORAchk and Oracle EXAchk 12.2.0.1.3
- New Features for Oracle ORAchk and Oracle EXAchk 12.2.0.1.4
- New Features for Oracle Trace File Analyzer
- New Features for Oracle Cluster Health Advisor
- New Features for Oracle Database Quality of Service (QoS) Management
New Features for Oracle ORAchk and Oracle EXAchk 12.1.0.2.7
These are new features for Oracle ORAchk and Oracle EXAchk 12.1.0.2.7.
- Simplified Enterprise-Wide Data Configuration and Maintenance
- Tracking Changes to File Attributes
- Find Health Checks that Require Privileged Users to Run
- Support for Broader Range of Oracle Products
- Easier to Run Oracle EXAchk on Oracle Exadata Storage Servers
- New Health Checks for Oracle ORAchk and Oracle EXAchk
Simplified Enterprise-Wide Data Configuration and Maintenance
This release contains several changes that simplify system and user configuration and maintenance, and upload health check collection results.
Bulk Mapping Systems to Business Units
Oracle Health Check Collections Manager provides an XML bulk upload option so that you can quickly map many systems to business units.
Related Topics
Selectively Capturing Users During Log In
By default, Oracle Health Check Collections Manager captures details of the users who log in using LDAP authentication and assigns Oracle Health Check Collections Manager role to the users.
Related Topics
Configuring Details for Upload of Health Check Collection Results
Configure Oracle ORAchk and Oracle EXAchk to automatically upload health check collection results to the Oracle Health Check Collections Manager database.
Related Topics
Viewing and Reattempting Failed Uploads
Use the new option -checkfaileduploads
to find failed uploads.
Related Topics
Tracking Changes to File Attributes
Use the Oracle ORAchk and Oracle EXAchk option –fileattr
to track changes to file attributes.
If run with the –fileattr
option, then Oracle ORAchk and Oracle EXAchk search all files within Oracle Grid Infrastructure and Oracle Database homes by default. Also, specify the list of directories, subdirectories, and files to monitor, and then compare snapshots for changes.
Find Health Checks that Require Privileged Users to Run
Use the new privileged user filter to identify health checks that require a privileged user to run.
Related Topics
Support for Broader Range of Oracle Products
Health check support has been broadened to include Linux operating system health checks (Oracle ORAchk only), External ZFS Storage Appliance health checks (Oracle EXAchk on Exalogic only), and Oracle Enterprise Manager Cloud Control 13.1.
Easier to Run Oracle EXAchk on Oracle Exadata Storage Servers
Run Oracle EXAchk from Oracle Exadata storage servers without SSH connectivity from the database server to the storage server.
Related Topics
New Health Checks for Oracle ORAchk and Oracle EXAchk
New health checks have been included for:
-
Oracle Exadata
-
Oracle SuperCluster
-
Oracle Exalogic
-
Oracle ZFS Storage
-
Oracle Enterprise Linux
-
Oracle Solaris Cluster
-
Oracle Database and Oracle Grid Infrastructure
-
Oracle Enterprise Manager Cloud Control Oracle Management Service (OMS) and Repository
Refer to My Oracle Support note 1268927.2, click the Health Check Catalog tab to download and view the list of health checks.
Related Topics
New Features for Oracle ORAchk and Oracle EXAchk 12.2.0.1.1
These are new features for Oracle ORAchk and Oracle EXAchk 12.2.0.1.1.
- Easier to Use and Upgrade Oracle Health Check Collections Manager
Oracle Health Check Collections Manager has been enhanced with a new easier to navigate interface based on the Oracle Application Express (APEX) 5 theme. - More Flexibility for Running Root Privileged Checks
Ability to change the location of script used for running root checks, a different location from other temp files. - Oracle ORAchk Specific New Features
Beginning with release 12.2.0.1.1, Oracle ORAchk adds support for the latest version of IBM AIX 7.2 and Oracle Database Appliances Small and Medium. - Oracle EXAchk Specific New Features
Beginning with release 12.2.0.1.1, Oracle EXAchk adds support for the newest Oracle Engineered Systems, Role Based Access Control (RBAC) for Oracle EXAchk on SuperCluster, and send email from storage cells.
Easier to Use and Upgrade Oracle Health Check Collections Manager
Oracle Health Check Collections Manager has been enhanced with a new easier to navigate interface based on the Oracle Application Express (APEX) 5 theme.
This new interface is available only if you have APEX 5 installed on your database. Oracle ORAchk and Oracle EXAchk continue to include the APEX 4 based Oracle Health Check Collections Manager application. However, all enhancements in new releases go into the APEX 5 Oracle Health Check Collections Manager application.
Upgrade Oracle Health Check Collections Manager from Oracle ORAchk or Oracle EXAchk. Oracle Health Check Collections Manager upgrades to the latest version of whichever application your database supports. You get the new theme interface only if you have APEX 5.
If the Oracle Health Check Collections Manager schema changes in the future and if Oracle ORAchk and Oracle EXAchk require Oracle Health Check Collections Manager upgrade, then Oracle ORAchk and Oracle EXAchk prompt you to upgrade Oracle Health Check Collections Manager.
During upgrade, Oracle Health Check Collections Manager goes offline and is not available to receive new collections. If any collection fails to upload during upgrade, then you can upload them again by viewing and reattempting to upload the failed uploads.
sql
script is applicable for the APEX version you are using:
-
APEX 4.x: CollectionManager_App.sql
-
APEX 5.x: Apex5_CollectionManager_App.sql
You can now sort all collection reports by any column no matter what APEX version you are using, making it easier to analyze results.
The Purge job feature has been improved to run daily rather than every three months to remove data older than three months.
Bulk mapping of business units is now easier as Oracle Health Check Collections Manager automatically creates any new business units found in the uploaded XML mapping file.
More Flexibility for Running Root Privileged Checks
Ability to change the location of script used for running root checks, a different location from other temp files.
A large number of the Oracle stack health checks do not require root
access. However, a subset of health checks need to run with root
privileges.
The script used to run these root privilege checks is root_orachk.sh
or root_exachk.sh
depending on the tool you are using. By default, this root script is created in the temporary directory, that is, $HOME
. You can change the location by setting the RAT_TMPDIR
environment variable.
RAT_ROOT_SH_DIR
environment variable:export RAT_ROOT_SH_DIR=/orahome/oradb/
sudo
remote access as follows:export RAT_ROOT_SH_DIR=/mylocation
/etc/sudoers
file as follows:oracle ALL=(root) NOPASSWD:/mylocation/root_orachk.sh
Oracle ORAchk Specific New Features
Beginning with release 12.2.0.1.1, Oracle ORAchk adds support for the latest version of IBM AIX 7.2 and Oracle Database Appliances Small and Medium.
-
Support for AIX 7.2
Oracle ORAchk adds support for the latest version of IBM AIX 7.2 in addition to the existing support for versions 5.2, 5.3, 6.1, and 7.1.
-
Support for New Oracle Database Appliances
Oracle ORAchk adds support for new Oracle Database Appliances Small and Medium in addition to the existing support for Oracle Database Appliance HA.
Oracle EXAchk Specific New Features
Beginning with release 12.2.0.1.1, Oracle EXAchk adds support for the newest Oracle Engineered Systems, Role Based Access Control (RBAC) for Oracle EXAchk on SuperCluster, and send email from storage cells.
-
Support for Newest Oracle Engineered Systems
Oracle EXAchk extends support to include some of the newest Oracle Engineered Systems and their software:-
Oracle MiniCluster – The latest addition to the Oracle Super Cluster family of Engineered Systems
-
Oracle Exalytics Software release 2.0 – The latest software release for the Oracle Exalytics In-Memory Machine
-
-
Oracle EXAchk on SuperCluster - Support for Role Based Access Control
When running Oracle EXAchk on Oracle SuperCluster you can use Role Based Access Control (RBAC) to run
root
privileged checks without requiring a root user.Ensure that you run the root checks as a user with a root equivalent access role.
-
Oracle EXAchk on Exadata – Send Email When Unable to Send from Storage Cells
If the Oracle Exadata storage cells are unable to send email, then you can use the
-usecompute
option to send the email from the database server instead.For example:
./exachk -testemail "NOTIFICATION_EMAIL=some.person@example.com,another.person@example.com" -usecompute
or
./exachk -sendemail "NOTIFICATION_EMAIL=some.person@example.com,another.person@example.com" -usecompute
New Features for Oracle ORAchk and Oracle EXAchk 12.2.0.1.2
These are new features for Oracle ORAchk and Oracle EXAchk 12.2.0.1.2.
- Enhanced Elastic Stack Integration
The existing Oracle ORAchk and Oracle EXAchk integration with the Elastic Stack (previously called ELK stack) has been enhanced. - Oracle Health Check Collections Manager Health Score Filter
A new filter, Health Score has been added to Oracle Health Check Collections Manager. - Support for Automated Platinum Service Requests for Qualified OEM Fault Events
Oracle EXAchk will now check the Oracle Platinum Services monitoring agent, the monitoring user, monitored databases, and their diagnostic directories.
Enhanced Elastic Stack Integration
The existing Oracle ORAchk and Oracle EXAchk integration with the Elastic Stack (previously called ELK stack) has been enhanced.
Many new field tags have been added to the Oracle ORAchk and Oracle EXAchk JSON output.
The extra tags allow dashboard filtering based on facts such as:
-
Engineered System type
-
Engineered System version
-
Hardware type
-
Node name
-
Operating system version
-
Rack identifier
-
Rack type
-
Database version
Use the Kibana dashboard to view health check compliance across the data center.
Now with these new field tags, you can also filter the results based on any combination of exposed system attributes.
Oracle Health Check Collections Manager Health Score Filter
A new filter, Health Score has been added to Oracle Health Check Collections Manager.
The Health Score filter enables you to filter the results to only show collections where the health score is less than or equal to the value specified.
The default value of the filter is 100, and therefore Oracle Health Check Collections Manager displays all the collections initially.
In addition, a number of other existing Oracle Health Check Collections Manager field labels have been renamed for ease of use.
Support for Automated Platinum Service Requests for Qualified OEM Fault Events
Oracle EXAchk will now check the Oracle Platinum Services monitoring agent, the monitoring user, monitored databases, and their diagnostic directories.
This helps to ensure quality of Oracle Platinum Services monitoring and that relevant diagnostics can be supplied for faster fault resolution.
New Features for Oracle ORAchk and Oracle EXAchk 12.2.0.1.3
These are new features for Oracle ORAchk and Oracle EXAchk 12.2.0.1.3.
- Upgrade to Oracle Database 12.2 with Confidence
This release includes lots of new checks to help you when upgrading Oracle Database to 12.2. - Improve Performance of SQL Queries
Many new checks focus on the known issues in 12c Optimizer as well as SQL Plan Management. - Customize Oracle Health Check Collections Manager Email Notifications and Sample Data Usage
Customize Oracle Health Check Collections Manager email notification based on one or more business units. - Prevent Oracle Clusterware Related Outages and Corruptions
New checks to verify network configuration and operating system patching. - Guard Against Exadata Critical Issue EX35
New checks detect an Exadata critical issue, which can cause node eviction. - Avoid an Oracle SuperCluster Critical Issue and Storage Problems
New checks are now available for a critical issue and storage problems affecting Oracle SuperCluster.
Upgrade to Oracle Database 12.2 with Confidence
This release includes lots of new checks to help you when upgrading Oracle Database to 12.2.
New Checks include both pre- and post-upgrade verification to prevent problems related to:
-
Operating system configuration
-
Oracle Grid Infrastructure and Oracle Database patch prerequisites
-
Oracle Database configuration
-
Cluster configuration
Improve Performance of SQL Queries
Many new checks focus on the known issues in 12c Optimizer as well as SQL Plan Management.
The new checks target the problems such as:
-
Wrong results returned
-
High memory and CPU usage
-
Errors such as
ORA-00600
orORA-07445
-
Issues with cursor usage
-
Other general SQL plan management problems
Customize Oracle Health Check Collections Manager Email Notifications and Sample Data Usage
Customize Oracle Health Check Collections Manager email notification based on one or more business units.
By default, existing users who have already configured notification will receive notification for all business units.
It is now possible to delete or reload the sample data that Oracle Health Check Collections Manager ships with.
Prevent Oracle Clusterware Related Outages and Corruptions
New checks to verify network configuration and operating system patching.
The Oracle Cluster Registry subnet records can become stale due to configuration changes. This can lead to various startup problems.
Additionally, vulnerability to certain operating system bugs can lead to corruption in clustered databases.
Guard Against Exadata Critical Issue EX35
New checks detect an Exadata critical issue, which can cause node eviction.
In addition, various other Exadata best practice recommendations have been added.
Avoid an Oracle SuperCluster Critical Issue and Storage Problems
New checks are now available for a critical issue and storage problems affecting Oracle SuperCluster.
These detect vulnerability to a critical issue affecting Oracle SuperCluster. As well as checks to prevent database memory corruption and storage related problems.
New Features for Oracle ORAchk and Oracle EXAchk 12.2.0.1.4
These are new features for Oracle ORAchk and Oracle EXAchk 12.2.0.1.4.
- Three Times Faster Performance
Oracle ORAchk and Oracle EXAchk have been rewritten with a focus on performance and extensibility. - Option to Run Only the Failed Checks
New option allows Oracle ORAchk and Oracle EXAchk to run only the checks that failed previously. - Microsoft Windows Support Without Requiring Cygwin
Since Oracle ORAchk has been rewritten in Python, Cygwin on Microsoft Windows is no more a requirement. - Run Multiple Instances at the Same Time
It is now possible to run multiple instances of Oracle ORAchk and Oracle EXAchk at the same time on the same machine. - Oracle ORAchk Support for Oracle Grid Infrastructure with no Database
Oracle ORAchk now supports Oracle Grid Infrastructure stand-alone checks where no database is installed. - New Oracle Stack Health Checks
This release of Oracle ORAchk and Oracle EXAchk includes many new Oracle Stack Health Checks.
Three Times Faster Performance
Oracle ORAchk and Oracle EXAchk have been rewritten with a focus on performance and extensibility.
Internal testing results show that this version runs up to 3 times faster than 12.2.0.1.3. Performance has improved in low-resource environments.
Option to Run Only the Failed Checks
New option allows Oracle ORAchk and Oracle EXAchk to run only the checks that failed previously.
To run only the checks that failed previously:
-
Generate a health check report
-
Fix the issues identified
-
Generate another health check report verifying only the issues that failed before
-failedchecks previous_result
Microsoft Windows Support Without Requiring Cygwin
Since Oracle ORAchk has been rewritten in Python, Cygwin on Microsoft Windows is no more a requirement.
Oracle ORAchk needs Python 2.7 software and libraries. The runtime provides details of what exactly the libraries it needs.
Run Multiple Instances at the Same Time
It is now possible to run multiple instances of Oracle ORAchk and Oracle EXAchk at the same time on the same machine.
As a result of this change the location of the root_orachk.sh
and root_exachk.sh
files have now changed. By default, they are created in the user's home directory.
If you run as non-root, then change this location in the /etc/sudoers
file, for example,
/etc/sudoers
entry:oracle ALL=(root) NOPASSWD:/home/oracle/.orachk/root_orachk.sh
/etc/sudoers
entry: oracle ALL=(root) NOPASSWD:/home/oracle/root_orachk.sh
RAT_ROOT_SH_DIR
.export RAT_ROOT_SH_DIR=/some/other/location
Oracle ORAchk Support for Oracle Grid Infrastructure with no Database
Oracle ORAchk now supports Oracle Grid Infrastructure stand-alone checks where no database is installed.
-nordbms
$ ./orachk -nordbms
$ ./exachk -nordbms
New Features for Oracle Trace File Analyzer
Oracle Trace File Analyzer includes the following new features:
-
Oracle Trace File Analyzer Service
Oracle Trace File Analyzer service helps DBAs and system administrators proactively monitor trace files across multiple member clusters on a centralized machine.
-
One Command Service Request Data Collections (SRDC)
Oracle Trace File Analyzer can run SRDC collections with a single command.
New Features for Oracle Cluster Health Advisor
Oracle Cluster Health Advisor includes the following new features:
-
Oracle Cluster Health Advisor Cross-Database Analysis Support
In consolidated and DBaaS private cloud deployments multiple databases share the same physical server and its resources. In its previous release, Oracle Cluster Health Advisor analyzed each hosted database instance individually.
Oracle Cluster Health Advisor could only detect whether the cause of a performance or availability issue was within itself or external. With the new cross-database analysis support, Oracle Cluster Health Advisor can target external issues to a specific database resulting in higher confidence diagnosis and improved corrective actions.
-
Oracle Cluster Health Advisor Cross-Cluster Analysis Support
In its previous release, Oracle Cluster Health Advisor analyzed each cluster node individually. Oracle Cluster Health Advisor could only detect whether the cause of a performance or availability issue was within itself, or external. With the new cross-cluster analysis support, Oracle Cluster Health Advisor can target external issues to a specific cluster node resulting in higher confidence diagnosis and improved corrective actions.
New Features for Oracle Database Quality of Service (QoS) Management
-
The ability to update an active policy set when adding new database services using
qosctl qos_admin_user -updatepolicyset
. This aids automatic provisioning especially in fleet or cloud environments.