Readme and Release notes for release 6.1.0.4 Engineering and Scientific Subroutine Library
------------------------------------------------------------------------------------------
10/22/2021


Installing an ESSL update on Linux
---------------------------------
If you want to upgrade an existing install of ESSL 6.1.0:
    1) Copy the tar file to a directory with write access and change to that
       directory
           cd < tarDirectory >
    2) Extract the files and executable from the tar file with the following
       command:
           tar -xzvf ESSL-6.1.0.4-ppc64LE-Linux.tar.gz
    3) Issue RPM commands for the RPMs you wish to upgrade
           rpm -Uvh essl.3264.rte-6.1.0-4.ppc64le.rpm
           rpm -Uvh essl.3264.rtecuda-6.1.0-4.ppc64le.rpm
           rpm -Uvh essl.6464.rte-6.1.0-4.ppc64le.rpm

If you want to install ESSL 6.1.0 including this upgrade using automatic license
acceptance:
    1) Copy the tar file to a directory with write access and change to that
       directory
           cd < tarDirectory >
    2) Extract the files and executable from the tar file with the following
       command:
           tar -xzvf ESSL-6.1.0.4-ppc64LE-Linux.tar.gz
    3) Copy the RPMs to the directory which contains all the ESSL 6.1.0 RPMs that
       you wish to install. See "Determining which product RPMs to install"
       section of the ESSL for Linux on POWER, Version 6 Release 1 Installation
       Guide for information on which RPMs are required and which are optional
    4) cd to the directory with the RPMs
    5) export IBM_ESSL_LICENSE_ACCEPT=yes
    6) rpm -Uvh essl*6.1.0-*.rpm

If you want to install ESSL 6.1.0 using xCAT Kits:
    1) Copy the file ESSL_xCATkit-6.1.0.4-ppc64LE-Linux.NEED_PRODUCT_PKGS.tar.bz2
       to a directory with write access and change to that directory
          cd <tarDirectory>
    2) Do NOT uncompress or untar the tar file. The file is the xCAT partial kit
       tar file.
    3) Download the corresponding ESSL product and service level package files
       to any directory on your system. This directory does not need to be the
       same as the one with the partial kit tar file.
    4) Install the xCAT-buildkit RPM onto your management node if it is not
       already installed.
    5) Build the complete Kits tar file such as
          /opt/xcat/bin/buildkit addpkgs \
                  ESSL_xCATkit-6.1.0.4-ppc64LE-Linux.NEED_PRODUCT_PKGS.tar.bz2 \
                  -p < ESSLPackageDirectory >
    6) Then follow the instruction in the ESSL for Linux on POWER, Version 6
       Release 1 Installation Guide to install ESSL 6.1.0 inlcuding this upgrade.
      For additional information, refer to the ESSL for Linux on POWER, Version 6
      Release 1 Installation Guide.

Package Content
---------------
1) ESSL-6.1.0.4-ppc64LE-Linux.tar.gz
2) ESSL_xCATkit-6.1.0.4-ppc64LE-Linux.NEED_PRODUCT_PKGS.tar.bz2


APAR changes included
---------------------
PH00316 = 16 PROCESSES CALLING THE ESSL CUDA LIBRARY AND SHARING ONE P100 GPU ON
          A 8335-GTB (POWER8) SERVER COULD EXHAUST GPU MEMORY
PH00393 = SUPPORT STRSM ROUTINE IN ESSLSMPCUDA  LIBRARY ON V100 GPU
PH03901 = ESSLSMPCUDA PERFORMANCE IMPROVEMENTS ON IBM AC922 8335-GTX
PH03903 = SCFTD FAILURES WITH 32GB NVIDIA V100 GPUS
PH27023 = POTENTIAL UNDETECTED DATA CORRUPTION FOR SOME ESSL AND PARALLEL ESSL
          FFT SUBROUTINES
PH40081 = POTENTIAL UNDETECTED DATA CORRUPTION USING THE ESSL SINGLE THREADED
          LIBRARIES SZAXPY SUBROUTINE ON POWER9