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

These are new features for Oracle ORAchk and Oracle EXAchk 12.1.0.2.7.

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.

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.

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.

Viewing and Reattempting Failed Uploads

Use the new option -checkfaileduploads to find failed uploads.

Managing Oracle Health Check Collection Purges

Oracle Health Check Collections Manager now by default purges collections that are older than three months.

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.

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.

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.

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.

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.

If you are installing Oracle Health Check Collections Manager for the first time, then install through the APEX workspace. Use whichever Oracle Health Check Collections Manager 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.

You can choose to have the root script created outside of the standard temporary directory in a custom directory by setting the RAT_ROOT_SH_DIR environment variable:
export RAT_ROOT_SH_DIR=/orahome/oradb/
You can use a specific location for sudo  remote access as follows:
export RAT_ROOT_SH_DIR=/mylocation
Then add an entry in the /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.

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.

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 or ORA-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.

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

Use the failed checks option by passing in the HTML report, zip, or directory.
-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,

Previous /etc/sudoers entry:
oracle ALL=(root) NOPASSWD:/home/oracle/.orachk/root_orachk.sh
New /etc/sudoers entry:
oracle ALL=(root) NOPASSWD:/home/oracle/root_orachk.sh
You can also change the location of those scripts by setting the environment variable 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.

To run Oracle Grid Infrastructure checks in an environment with no Oracle Database has been installed, use the option:
-nordbms
For example:
$ ./orachk -nordbms
$ ./exachk -nordbms

New Oracle Stack Health Checks

This release of Oracle ORAchk and Oracle EXAchk includes many new Oracle Stack Health Checks.

The Health Check Catalog is also contained within the download.

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

Oracle Database Quality of Service (QoS) Management includes the following new feature:
  • 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.