3.2.1. Using Master Package - 5.2 English - 57404

Complete the following steps to install the AOCL library suite:

1. Download the AOCL tar packages from the Download (https://www.amd.com/en/developer/aocl.html#downloads) section to the target machine.

2. Use the command tar -xvf <aocl-linux-<compiler>-5.2.0.tar.gz> to untar the package. The installer file install.sh is available in aocl-linux-<compiler>-5.2.0.

3. Run ./install.sh to install the AOCL package (all libraries) to the default INSTALL_PATH: /home/<username>/aocl/5.2.0/<compiler>, where the compiler value is aocc or gcc.

   Use install.sh to print the usage of the script. A few supported options are:

   Table 3.1 install.sh Script Options#

   Option	Description
   -h	Print the help.
   -t	Custom target directory to install libraries.
   -l	Library to be installed.
   -i	Select LP64/ILP64 libraries to be set as default.

4. To install the AOCL package in a custom location, use the installer with the option: -t <CUSTOM_PATH>. For example, ./install.sh -t /home/<username>.

5. You can use the master installer to install the individual library out of the master package. The library names used are blis, compression, crypto, aocl-da, dlp, fftw, fftz, libflame, libm, rng, scalapack, secrng and sparse. You can do one of the following:

   • To install a specific library, use the option: -l <library name>. For example, ./install.sh -l blis.

     • By default, AOCL-FFTW library is installed. To install AOCL-FFTZ instead, use: ./install.sh -l fftz.

   • Install the individual library in a path of your choice. For example, ./install.sh -t /home/amd -l libm.

6. AOCL libraries support the following two integer types:

   • LP64 libraries and header files are installed respectively in the following paths: - /INSTALL_PATH/lib_LP64 - /INSTALL_PATH/include_LP64

   • ILP64 libraries and header files are installed respectively in the following paths: - /INSTALL_PATH/lib_ILP64 - /INSTALL_PATH/include_ILP64

   Note

   • AOCL-Compression supports only LP64

   • AOCL-FFTW supports LP64 and ILP64 in single binary using a different set of APIs.

   By default, LP64 libraries and header files are available in /INSTALL_PATH/lib and /INSTALL_PATH/include respectively.

   Suffix ./install.sh with -i <lp64/ilp64> to:

   • Set the LP64 libraries as the default libraries, use the installer with the option: -i lp64. For example, ./install.sh -t /home/amd -l blis -i lp64.

     This installs only AOCL-BLAS library in the path /home/amd and sets LP64 AOCL-BLAS libraries as the default.

   • Set ILP64 libraries as the default use the installer with the option: -i ilp64. For example, ./ install.sh -i ilp64.

     This installs all AOCL libraries in the default path and sets ILP64 libraries as the default.