AHF Release 25.1

Parent topic: 2025 AHF Releases

Automated Problem Analysis for Node Evictions, Instance Evictions, and Database Slow Performance

AHF now automatically identifies new causes of node eviction, instance eviction, and database slow performance, providing a detailed summary of the problem, cause, and recommended resolution within the Insights report.

Since version 24.4, AHF has had the capability to detect issues and present a summary along with resolutions (Node Eviction Detection and Resolution). The Problem Summary page is accessible under the Detected Problems panel in Insights.

This release introduces the ability to automatically detect the following additional issues:

Node evictions caused by:
  • NIC flow control misconfiguration
Instance evictions caused by:
  • Increasing memory of existing database processes
  • Increasing memory of existing non-database processes
  • Misconfiguration of RDS/IB network settings
Slow database performance caused by:
  • Archiver configuration
  • Insufficient redo log size
To generate a diagnostic collection:
  1. Run tfactl diagcollect and follow the prompts to select the relevant issue.
  2. Transfer the resulting zip file to a machine with a browser.
  3. Open the Insights report and review the Detected Problems section for a detailed analysis.

This streamlined detection process simplifies troubleshooting and helps resolve performance issues faster.

For more information, see:

Parent topic: AHF Release 25.1

Manage Credentials, SSH keys, and Updates with ahf Command Line Interface

The AHF CLI simplifies the management of SSH keys, credentials, and updates.

Secure SSH Key Storage

SSH Keys are often required for secure access to resources automatically. However, storing these keys on systems can pose potential security risks.

AHF can now generate and securely store SSH keys for remote components used by Oracle Orachk and Oracle Exachk. These keys are encrypted and stored within the AHF wallet, ensuring they are protected from unauthorized access. AHF automatically detects the configured SSH keys for a remote system and uses them to login.

  • To create and add SSH key with password: 
    ahf security add-credentials --node NODE --user-name USER --type ssh-key --generate-ssh-key --password
  • To add SSH key from a file path with password: 
    ahf security add-credentials --node NODE --user-name USER --type ssh-key --ssh-key-file <FILEPATH> --password
  • To add an already added SSH key with password: 
    ahf security add-credentials --node NODE --user-name USER --type ssh-key --ssh-key-file <FILEPATH> --password
    ahf security add-credentials --node NODE --user-name USER --type ssh-key --generate-ssh-key --password
  • To create and add SSH key for passwordless setup: 
    ahf security add-credentials --node NODE --user-name USER --type ssh-key --generate-ssh-key
  • To add SSH key from a file path for passwordless setup: 
    ahf security add-credentials --node NODE --user-name USER --type ssh-key --ssh-key-file <FILEPATH>
  • To add SSH key from a file path where the key is already added to remote host: 
    ahf security add-credentials --node NODE --user-name USER --type ssh-key --ssh-key-file <FILEPATH>
  • To remove SSH key: 
    ahf security remove-credentials --node NODE --user-name USER --type ssh-key
  • To check SSH key: 
    ahf security check-credentials --node NODE --user-name USER --type ssh-key
  • To get stored SSH key: 
    ahf security get-credentials --node NODE --user-name USER --type ssh-key

Credential Management

This release introduces improvements to the ahf security command category, streamlining the management of credentials used to log in to remote machines or nodes.

To add and store password for a node or a list of nodes, use:
ahf security add-credentials --type password [--node NODE] [--nodes NODES-LIST] [--user-name USER] [--exacli]
To remove the stored password for a node or a list of nodes, use:
ahf security remove-credentials --type password [--node NODE] [--nodes NODES-LIST] [--user-name USER] [--exacli]
To get the stored password for a node or a list of nodes, use:
ahf security get-credentials --type password [--node NODE] [--nodes NODES-LIST][--user-name USER] [--exacli]
To check if a password is set for a node or a list of nodes, use:
ahf security check-credentials --type password [--node NODE] [--nodes NODES-LIST] [--user-name USER] [--exacli]

Update Configuration Management

The AHF commands for managing update configurations have been replaced with new SDK CLI commands. You are encouraged to transition to the new SDK CLI commands, as the existing ahfctl commands will be deprecated and be removed in a future release.

The legacy ahfctl command line, which is also slated for deprecation, currently provides the following commands for managing AHF updates:
The following new commands are implemented within the ahf configuration command category, offering a simplified way to manage AHF update configurations. However, to ensure compatibility with future releases and to benefit from enhanced functionality, you must adopt the new SDK CLI commands for update management.
  • To set AHF update configuration parameters, run:
    ahf configuration set --type update [--all] [--software-stage SOFTWARE_STAGE] [--auto-update AUTO_UPDATE] [--file-system-type FILE_SYSTEM_TYPE] [–frequency FREQUENCY] [--service-name SERVICE_NAME] [--update-time UPDATE_TIME]
  • To get AHF update configuration parameter details, run:
    ahf configuration get --type update --all
  • To unset AHF update configuration parameters, run:
    ahf configuration unset [--all] [--software-stage SOFTWARE_STAGE] [--auto-update AUTO_UPDATE] [--file-system-type FILE_SYSTEM_TYPE] [–frequency FREQUENCY] [--service-name SERVICE_NAME] [--update-time UPDATE_TIME]

Related Topics

Parent topic: AHF Release 25.1

CPU Resource Limiting on Oracle Linux 9

AHF now supports CPU resource limiting using cgroups v2, which is the default on Oracle Linux 9.

By default, AHF’s CPU usage is automatically restricted through the Linux cgroups feature, ensuring it does not consume excessive CPU resources out of the box. Users can easily adjust the CPU allocation for AHF to meet their specific needs. Oracle Linux 9 introduces the new cgroups v2 as its default, and starting with AHF 25.1, both cgroups v1 and v2 are fully supported by AHF.

To manage AHF’s CPU resource usage, you can use the ahfctl setresourcelimit command. For more information, see ahfctl setresourcelimit.

Parent topic: AHF Release 25.1

Support for Exadata X11M and Exadata System Software 25.1

AHF 25.1 now provides full support for Exadata X11M and Exadata System Software 25.1.

In January 2025, Oracle introduced Exadata X11M, offering unparalleled flexibility for deployment across on-premises, Cloud@Customer, Oracle Cloud, and multicloud environments.

Exadata has been the cornerstone for thousands of organizations, including the majority of the world’s largest financial, telecom, and retail businesses, powering their most critical and demanding Oracle Database workloads.

The 13th generation Exadata platform builds on decades of engineering excellence to support mission-critical AI, analytics, and OLTP workloads globally. At the same price point as its predecessor, Exadata X11M delivers extreme performance, scalability, and availability for all Oracle Database workloads.

Exadata System Software 25.1: The latest release of Exadata System Software, 25.1, continues to elevate the platform’s capabilities. Building on the successes of Exadata System Software 24ai and earlier versions, 25.1 introduces key enhancements that further solidify Exadata as the premier platform for Oracle Database, whether deployed on-premises or in the cloud.

AHF 25.1 fully supports both Exadata X11M and Exadata System Software 25.1. To learn more about Exadata X11M and Exadata System Software 25.1, see:

Parent topic: AHF Release 25.1

New Oracle Orachk and Oracle Exachk Best Practice Checks

Release 25.1 includes the following new Oracle Orachk and Oracle Exachk best practice checks.

Oracle Exachk Specific Best Practice Checks

  • Exadata Critical Issue EX92

All checks can be explored in more detail via the Health Check Catalogs:

Related Topics

Parent topic: AHF Release 25.1