HPE Application Tuner Express (HPE-ATX)


HPE Application Tuner Express (HPE-ATX) is a utility for HPE customers running Linux to achieve maximum performance when running on multi-socket servers. Using this tool, you can align application execution with the data in memory resulting in increased performance. HPE-ATX is designed to improve performance of NUMA unaware applications without requiring any changes to the application itself. It helps multi-process and multi-threaded applications running on multi socket machines to achieve better NUMA placement of processes and threads that are related and share memory segments.


HPE-ATX is available for any HPE Gen8 or later x84_64 server running Red Hat Enterprise Linux (RHEL), CentOS Linux, Oracle Linux, SUSE Linux Enterprise Server (SLES) and Ubuntu Server LTS operating systems. For Oracle Linux and CentOS Linux please use the Red Hat Enterprise Linux (RHEL) installation rpm.



Documentation


Instructions for how to use the HPE-ATX repository on the HPE Software Delivery Repository (SDR).


Information on tested HPE-ATX performance improvements can be found in the HPE-ATX Performance Proof Points document.


Documentation on how to install and license HPE-ATX can be found in the Installing HPE-ATX document.


Documentation on how to run HPE-ATX can be found in the Using HPE-ATX document.



Downloading


HPE-ATX is available for download from the HPE My License Portal at:


         https://myenterpriselicense.hpe.com/cwp-ui/evaluation/HPE-ATX


HPE-ATX is also avalable from the HPE Software Delivery Repository at:


         https://downloads.linux.hpe.com/SDR/project/hpe-atx/repo.html


For Oracle Linux and CentOS Linux please use the Red Hat Enterprise Linux (RHEL) installation rpm.


From the HPE Support Center click the ‘Obtain software’ link, which will redirect to the HPE My License Portal HPE-ATX web page. Follow the instructions for downloading HPE-ATX.



Release Information

Version: 1.0.2
Upgrade Requirement: Optional - Users should update to this version if their system is affected by one of the documented fixes or if there is a desire to utilize any of the enhanced functionality provided by this version.
Reboot Requirement: No: Reboot is not required after installation for updates to take effect and hardware stability to be maintained.
Enhancements: - Added support for Ubuntu Server 16.04 LTS and Ubuntu Server 18.04 LTS.
- Added support for Red Hat Enterprise Linux 8.
- Added support for Oracle Linux 7 and Oracle Linux 8.
- Added support for CentOS Linux 6, CentOS Linux 7 and CentOS Linux 8.
- Added free-memory based launch policies memfree_tree and memfree_flat and --memfree option.
Fixes: None
End User License Agreements:
HPE Software License Agreement v1



Server and Operating System Support

Supported Servers: All HPE Gen8 and later x84_64 servers running any of the operating systems below.
Minimum OS Versions: Red Hat Enterprise Linux 8 / CentOS Linux 8 / Oracle Linux 8
Red Hat Enterprise Linux 7 / CentOS Linux 7 / Oracle Linux 7
Red Hat Enterprise Linux 6.5+ / CentOS Linux 6.5+
SUSE Linux Enterprise Server 15
SUSE Linux Enterprise Server 12
SUSE Linux Enterprise Server 11 SP3+
Ubuntu Server 18.04 LTS
Ubuntu Server 16.04 LTS



Installing


If subscribing to the HPE-ATX respository on the HPE Software Delivery Respository follow the instructions at this URL:


         https://downloads.linux.hpe.com/SDR/project/hpe-atx/repo.html


Otherwise, after downloading HPE-ATX, login as the system administrator (root), download the HPE-ATX package to a directory on your hard drive and change to that directory. For CentOS Linux and Oracle Linux use the equivalent RHEL rpm installation package.


If a prior version of HPE-ATX has been installed remove the old package with the command:


             rpm -e hpe-atx                         # RHEL / CentOS / SLES / Oracle Linux


             dpkg -P hpe-atx                        # Ubuntu


To install the new package type:


         rpm -ivh hpe-atx-<version>.rpm           # RHEL / CentOS / SLES / Oracle Linux


         dpkg -i hpe-atx-<version>.deb            # Ubuntu


Alternatively you can use the yum/zypper/apt-get installation tools which also installs any required dependencies:


         yum install hpe-atx-<version>.rpm        # RHEL / CentOS / Oracle Linux


         zypper install hpe-atx-<version>.rpm     # SLES


         apt-get install hpe-atx-<version>.deb    # Ubuntu


Additional documentation on how to install HPE-ATX can be found in the Installing HPE-ATX document.



Licensing


HPE-ATX requires licenses on a per-socket basis. When you install HPE-ATX, a free instant-on trial license valid for 60 days is installed. With this instant-on trial license, you can use the product even if you do not have a permanent license. You must obtain a permanent license before the 60 day trial period expires.


Before ordering the license, determine the number of active sockets on the server and order a license for the number of sockets on your server (irrespective of the number of cores). You will also need to specify the serial number of the server when ordering the license. For servers such as Superdome X the serial number is the Complex Serial Number and is the same on all nPars configured in the server - you only need to buy one license for the server with all active sockets and can apply the same license on all nPars.


You can find the serial number of the server by executing the following command on your server:


         cat /sys/devices/virtual/dmi/id/product_serial


IMPORTANT: If you plan to upgrade to a new OS version, you can use the same license that you are currently using. For example, if you are upgrading from Red Hat Enterprise Linux 6 to Red Hat Enterprise Linux 7, you can use the same license from Red Hat Enterprise Linux 6 on Red Hat Enterprise Linux 7.


Obtaining a permanent license

Before your 60 day instant-on trial license expires, you must obtain and install a permanent license to continue to use HPE-ATX beyond the 60 day trial period.


To obtain a permanent license refer to your sales representative or your contract administrator.


Installing the permanent license

After you have obtained the permanent license, follow these steps to install the new license:


1. Ensure that the file /usr/lib64/hpeovlic-atx/LicFile.txt exists.


NOTE: HPE recommends that you back up this file before installing the license.


2. Place the permanent license key in a file on the system.


3. Install the license with the following command:


         hpe-atx -a <absolute-path-to-the-new-license-file>


On successful license installation the following message will be displayed:


         hpe-atx: New license installed


For more information, see the hpe-atx(8) manpage.


Verifying the permanent license

To verify the permanent license is installed:


1. Run the following command:


         hpe-atx -s


Information about the current license being used will be displayed


2. To see a list of all valid licenses installed run the following command:


         hpe-atx -S


For more information, see the hpe-atx(8) manpage.


Additional documentation on HPE-ATX licensing can be found in the Installing HPE-ATX document.



Availability


Product: HPE-ATX
Version: 1.0.2
Software Specification: Red Hat Enterprise Linux 8 / CentOS Linux 8 / Oracle Linux 8 (Z7550-02599)
Red Hat Enterprise Linux 7 / CentOS Linux 7 / Oracle Linux 7 (Z7550-02598)
Red Hat Enterprise Linux 6 / CentOS Linux 6 (Z7550-02600)
SUSE Linux Enterprise Server 15 (Z7550-02603)
SUSE Linux Enterprise Server 12 (Z7550-02602)
SUSE Linux Enterprise Server 11 (Z7550-02601)
Ubuntu Server 18.04 LTS (Z7550-02605)
Ubuntu Server 16.04 LTS (Z7550-02604)

Additional License Authorization