From 6691732d28ec324ff9d659b6856f45a286807871 Mon Sep 17 00:00:00 2001 From: Ethan Stewart Date: Tue, 30 Jun 2020 15:03:22 -0500 Subject: [PATCH] Update docs for 11.6-2 release. --- README.md | 7 +++---- bin/README.md | 10 +++++++--- docs/NOROOTINSTALL.md | 16 ++++++++-------- docs/RELEASESOURCEINSTALL.md | 10 +++++----- docs/RHELINSTALL.md | 6 +++--- docs/SLES15INSTALL.md | 4 ++-- docs/SOURCEINSTALL.md | 6 +++--- docs/UBUNTUINSTALL.md | 8 ++++---- 8 files changed, 35 insertions(+), 32 deletions(-) diff --git a/README.md b/README.md index 6fd37fa23..e65c402f6 100644 --- a/README.md +++ b/README.md @@ -1,4 +1,4 @@ -AOMP - V 11.6-1 +AOMP - V 11.6-2 ============== This is README.md for https://github.com/ROCM-Developer-Tools/aomp. @@ -8,8 +8,8 @@ This is the base repository for AOMP. Use this github repository for documentation, and [examples](https://github.com/ROCm-Developer-Tools/aomp/tree/master/examples). -The last [release is AOMP 11.6-1](https://github.com/ROCm-Developer-Tools/aomp/releases). -Currently AOMP 11.6-2 is under development. +The last [release is AOMP 11.6-2](https://github.com/ROCm-Developer-Tools/aomp/releases). +Currently AOMP 11.7-0 is under development. Attention Users! Please use this repository for [issues](https://github.com/ROCm-Developer-Tools/aomp/issues). @@ -96,6 +96,5 @@ Software License Agreement. See the [release notes](https://github.com/ROCm-Developer-Tools/aomp/releases) in github. Here are some limitations. ``` - - Dwarf debugging is turned off for GPUs. -g will turn on host level debugging only. - Some simd constructs fail to vectorize on both host and GPUs. ``` diff --git a/bin/README.md b/bin/README.md index be799abfa..35606ecd0 100644 --- a/bin/README.md +++ b/bin/README.md @@ -26,6 +26,7 @@ build_openmp.sh - Builds the OpenMP libraries and device RTL. build_pgmath.sh - Builds the pgmath support for flang. build_flang.sh - Builds flang for aomp. build_flang_runtime.sh - Builds the flang runtime for aomp. +build_ocl.sh - Builds OpenCL. ``` These scripts install into $HOME/rocm/aomp (or $AOMP if set). @@ -146,6 +147,9 @@ Developers may update a component and then run these scripts in the following or ./build_flang_runtime.sh ./build_flang_runtime.sh install + + ./build_ocl.sh + ./build_ocl.sh install ``` Once you have a successful development build, individual components can be incrementally rebuilt without rebuilding the entire system or the entire component. For example, if you change a file in the llvm-project repository. Run this command to incrementally build llvm, clang, and lld and update your installation. ``` @@ -159,10 +163,10 @@ WARNING: When the build scripts are run with NO arguments (that is, you do not s The install location is defined by the $AOMP environment variable. The value of AOMP needs to be reserved as a symbolic link. That is, the physical installation will be in directory $AOMP concatonated with the version string. The install script will make a symbolic link from the physical directory to the symbolic directory $AOMP. -For example, when building AOMP version 11.6-1 with the default value for AOMP=$HOME/rocm/aomp, -the install scripts will put all files and directories in $HOME/rocm/aomp_11.6-1 and create a symbolic link as follows. +For example, when building AOMP version 11.6-2 with the default value for AOMP=$HOME/rocm/aomp, +the install scripts will put all files and directories in $HOME/rocm/aomp_11.6-2 and create a symbolic link as follows. ``` -ln -sf ${AOMP}_11.6-1 ${AOMP} +ln -sf ${AOMP}_11.6-2 ${AOMP} ``` This symbolic link makes it easy to switch between versions of AOMP for testing. diff --git a/docs/NOROOTINSTALL.md b/docs/NOROOTINSTALL.md index 9c35a8ffa..0baa258d9 100644 --- a/docs/NOROOTINSTALL.md +++ b/docs/NOROOTINSTALL.md @@ -7,13 +7,13 @@ Once installed go to [TESTINSTALL](TESTINSTALL.md) for instructions on getting s To install the debian package without root access into your home directory, you can run these commands.
On Ubuntu 18.04 LTS (bionic beaver): ``` - wget https://github.com/ROCm-Developer-Tools/aomp/releases/download/rel_11.6-1/aomp_Ubuntu1804_11.6-1_amd64.deb - dpkg -x aomp_Ubuntu1804_11.6-1_amd64.deb /tmp/temproot + wget https://github.com/ROCm-Developer-Tools/aomp/releases/download/rel_11.6-2/aomp_Ubuntu1804_11.6-2_amd64.deb + dpkg -x aomp_Ubuntu1804_11.6-2_amd64.deb /tmp/temproot ``` On Ubuntu 16.04: ``` - wget https://github.com/ROCm-Developer-Tools/aomp/releases/download/rel_11.6-1/aomp_Ubuntu1604_11.6-1_amd64.deb - dpkg -x aomp_Ubuntu1604_11.6-1_amd64.deb /tmp/temproot + wget https://github.com/ROCm-Developer-Tools/aomp/releases/download/rel_11.6-2/aomp_Ubuntu1604_11.6-2_amd64.deb + dpkg -x aomp_Ubuntu1604_11.6-2_amd64.deb /tmp/temproot ``` Move to $HOME and set variables: ``` @@ -30,13 +30,13 @@ To install the rpm package without root access into your home directory, you can ``` For Red Hat: ``` - wget https://github.com/ROCm-Developer-Tools/aomp/releases/download/rel_11.6-1/aomp_REDHAT_7-11.6-1.x86_64.rpm - rpm2cpio aomp_REDHAT_7-11.6-1.x86_64.rpm | cpio -idmv + wget https://github.com/ROCm-Developer-Tools/aomp/releases/download/rel_11.6-2/aomp_REDHAT_7-11.6-2.x86_64.rpm + rpm2cpio aomp_REDHAT_7-11.6-2.x86_64.rpm | cpio -idmv ``` For SLES15-SP1: ``` - wget https://github.com/ROCm-Developer-Tools/aomp/releases/download/rel_11.6-1/aomp_SLES15_SP1-11.6-1.x86_64.rpm - rpm2cpio aomp_SLES15_SP1-11.6-1.x86_64.rpm | cpio -idmv + wget https://github.com/ROCm-Developer-Tools/aomp/releases/download/rel_11.6-2/aomp_SLES15_SP1-11.6-2.x86_64.rpm + rpm2cpio aomp_SLES15_SP1-11.6-2.x86_64.rpm | cpio -idmv ``` Move to $HOME and set variables: ``` diff --git a/docs/RELEASESOURCEINSTALL.md b/docs/RELEASESOURCEINSTALL.md index baa2dc70e..050127acc 100644 --- a/docs/RELEASESOURCEINSTALL.md +++ b/docs/RELEASESOURCEINSTALL.md @@ -101,8 +101,8 @@ Remember,the aomp spack configuration file is currently missing dependencies, so To build and install aomp from the release source tarball run these commands: ``` - wget https://github.com/ROCm-Developer-Tools/aomp/releases/download/rel_11.6-1/aomp-11.6-1.tar.gz - tar -xzf aomp-11.6-1.tar.gz + wget https://github.com/ROCm-Developer-Tools/aomp/releases/download/rel_11.6-2/aomp-11.6-2.tar.gz + tar -xzf aomp-11.6-2.tar.gz cd aomp nohup make & ``` @@ -117,9 +117,9 @@ If you set the environment variable AOMP, the Makefile will install to that dire Otherwise, the Makefile will install into /usr/local. So you must have authorization to write into /usr/local if you do not set the environment variable AOMP. Let's assume you set the environment variable AOMP to "$HOME/rocm/aomp" in .bash_profile. -The build_aomp.sh script will install into $HOME/rocm/aomp_11.6-1 and create a symbolic link from $HOME/rocm/aomp to $HOME/rocm/aomp_11.6-1. +The build_aomp.sh script will install into $HOME/rocm/aomp_11.6-2 and create a symbolic link from $HOME/rocm/aomp to $HOME/rocm/aomp_11.6-2. This feature allows multiple versions of AOMP to be installed concurrently. -To enable a backlevel version of AOMP, simply set AOMP to $HOME/rocm/aomp_11.5-0. +To enable a backlevel version of AOMP, simply set AOMP to $HOME/rocm/aomp_11.6-1. ## Build AOMP with spack @@ -128,7 +128,7 @@ Currently the aomp configuration is not yet in the spack git hub so you must cre ``` wget https://github.com/ROCm-Developer-Tools/aomp/blob/master/bin/package.py - spack create -n aomp -t makefile --force https://github.com/ROCm-Developer-Tools/aomp/releases/download/rel_11.6-1/aomp-11.6-1.tar.gz + spack create -n aomp -t makefile --force https://github.com/ROCm-Developer-Tools/aomp/releases/download/rel_11.6-2/aomp-11.6-2.tar.gz spack edit aomp spack install aomp ``` diff --git a/docs/RHELINSTALL.md b/docs/RHELINSTALL.md index 9509f3bf8..e7d7dde43 100644 --- a/docs/RHELINSTALL.md +++ b/docs/RHELINSTALL.md @@ -8,12 +8,12 @@ sudo yum install perl-Digest-MD5 ``` ### Download and Install ``` -wget https://github.com/ROCm-Developer-Tools/aomp/releases/download/rel_11.6-1/aomp_REDHAT_7-11.6-1.x86_64.rpm -sudo rpm -i aomp_REDHAT_7-11.6-1.x86_64.rpm +wget https://github.com/ROCm-Developer-Tools/aomp/releases/download/rel_11.6-2/aomp_REDHAT_7-11.6-2.x86_64.rpm +sudo rpm -i aomp_REDHAT_7-11.6-2.x86_64.rpm ``` If CUDA is not installed the installation may cancel, to bypass this: ``` -sudo rpm -i --nodeps aomp_REDHAT_7-11.6-1.x86_64.rpm +sudo rpm -i --nodeps aomp_REDHAT_7-11.6-2.x86_64.rpm ``` Confirm AOMP environment variable is set: ``` diff --git a/docs/SLES15INSTALL.md b/docs/SLES15INSTALL.md index c70048275..0482706df 100644 --- a/docs/SLES15INSTALL.md +++ b/docs/SLES15INSTALL.md @@ -1,8 +1,8 @@ # AOMP SUSE SLES-15-SP1 Install AOMP will install to /usr/lib/aomp. The AOMP environment variable will automatically be set to the install location. This may require a new terminal to be launched to see the change. ``` -wget https://github.com/ROCm-Developer-Tools/aomp/releases/download/rel_11.6-1/aomp_SLES15_SP1-11.6-1.x86_64.rpm -sudo rpm -i aomp_SLES15_SP1-11.6-1.x86_64.rpm +wget https://github.com/ROCm-Developer-Tools/aomp/releases/download/rel_11.6-2/aomp_SLES15_SP1-11.6-2.x86_64.rpm +sudo rpm -i aomp_SLES15_SP1-11.6-2.x86_64.rpm ``` Confirm AOMP environment variable is set: ``` diff --git a/docs/SOURCEINSTALL.md b/docs/SOURCEINSTALL.md index 059c529f3..6cf0415b0 100644 --- a/docs/SOURCEINSTALL.md +++ b/docs/SOURCEINSTALL.md @@ -1,4 +1,4 @@ -# Source Install V 11.6-2 (DEV) +# Source Install V 11.7-0 (DEV) Build and install from sources is possible. However, the source build for AOMP is complex for several reasons. - Many repos are required. The clone_aomp.sh script ensures you have all repos and the correct branch. @@ -99,7 +99,7 @@ Create a /etc/yum.repos.d/rocm.repo file with the following contents: ``` Choose a Build Version (Development or Release) -The development version is the next version to be released. It is possible that the development version is broken due to regressions that often occur during development. If instead, you want to build from the sources of a previous release such as 11.6-1 that is possible as well. +The development version is the next version to be released. It is possible that the development version is broken due to regressions that often occur during development. If instead, you want to build from the sources of a previous release such as 11.6-2 that is possible as well. For the Development Branch: ``` @@ -109,7 +109,7 @@ The development version is the next version to be released. It is possible that For the Release Branch: ``` - git checkout rel_11.6-1 + git checkout rel_11.6-2 git pull export AOMP_CHECK_GIT_BRANCH=0 //Tags will be used to checkout various repos. This will ignore the detached head state to avoid build errors. ``` diff --git a/docs/UBUNTUINSTALL.md b/docs/UBUNTUINSTALL.md index c83e9dc70..e3f9e4648 100644 --- a/docs/UBUNTUINSTALL.md +++ b/docs/UBUNTUINSTALL.md @@ -3,13 +3,13 @@ AOMP will install to /usr/lib/aomp. The AOMP environment variable will automatic On Ubuntu 18.04 LTS (bionic beaver), run these commands: ``` -wget https://github.com/ROCm-Developer-Tools/aomp/releases/download/rel_11.6-1/aomp_Ubuntu1804_11.6-1_amd64.deb -sudo dpkg -i aomp_Ubuntu1804_11.6-1_amd64.deb +wget https://github.com/ROCm-Developer-Tools/aomp/releases/download/rel_11.6-2/aomp_Ubuntu1804_11.6-2_amd64.deb +sudo dpkg -i aomp_Ubuntu1804_11.6-2_amd64.deb ``` On Ubuntu 16.04, run these commands: ``` -wget https://github.com/ROCm-Developer-Tools/aomp/releases/download/rel_11.6-1/aomp_Ubuntu1604_11.6-1_amd64.deb -sudo dpkg -i aomp_Ubuntu1604_11.6-1_amd64.deb +wget https://github.com/ROCm-Developer-Tools/aomp/releases/download/rel_11.6-2/aomp_Ubuntu1604_11.6-2_amd64.deb +sudo dpkg -i aomp_Ubuntu1604_11.6-2_amd64.deb ``` The AOMP bin directory (which includes the standard clang and llvm binaries) is not intended to be in your PATH for typical operation.