Skip to content

Commit

Permalink
Update docs/changelog for 13.0-4.
Browse files Browse the repository at this point in the history
  • Loading branch information
estewart08 committed Jun 18, 2021
1 parent d0b61eb commit 64b1822
Show file tree
Hide file tree
Showing 10 changed files with 79 additions and 40 deletions.
6 changes: 3 additions & 3 deletions README.md
Original file line number Diff line number Diff line change
@@ -1,4 +1,4 @@
AOMP - V 13.0-3
AOMP - V 13.0-4
==============

This is README.md for https://github.com/ROCM-Developer-Tools/aomp.
Expand All @@ -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 13.0-3](https://github.com/ROCm-Developer-Tools/aomp/releases).
Currently AOMP 13.0-4 is under development.
The last [release is AOMP 13.0-4](https://github.com/ROCm-Developer-Tools/aomp/releases).
Currently AOMP 13.0-5 is under development.

Attention Users! Please use this repository for [issues](https://github.com/ROCm-Developer-Tools/aomp/issues).
Do not put issues in any of the source code repositories.
Expand Down
21 changes: 15 additions & 6 deletions bin/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -60,7 +60,7 @@ These are some important environment variables and their default values.
| AOMP_REPOS | $HOME/git/aomp13 | The base directory for all AOMP build repositories
| AOMP_STANDALONE_BUILD | 1 | Build all components, do NOT use installed ROCm
| AOMP_VERSION | 13.0 | Will change to 13.1 when LLVM 13 stablizes.
| AOMP_VERSION_MOD | 3 | This imples the next release will be AOMP_13.0-3.
| AOMP_VERSION_MOD | 4 | This imples the next release will be AOMP_13.0-4.
| AOMP_VERSION_STRING | $AOMP_VERSION-$AOMP_VERSION_MOD |
| GFXLIST | gfx700 gfx701 gfx801 gfx803 | List of AMDGPU gpus to build for
| | gfx900 gfx902 gfx906 gfx908 |
Expand Down Expand Up @@ -113,6 +113,15 @@ run the master build script that steps through the build of all aomp components:
```
./build_aomp.sh
```
There are options to select a subset of components to build and install.
1) Start with openmp and continue to the end of the component list.
```
./build_aomp.sh continue openmp
```
2) Select a subset of components to build.
```
./build_aomp.sh select openmp flang flang_runtime
```
The default AOMP source build is a standalone build of all components needed for compilation and execution with the exception of the kfd Linux kernel module for AMD GPUs or the CUDA SDK for Nvidia GPUs.

## AOMP and the ROCM Compiler
Expand Down Expand Up @@ -240,17 +249,17 @@ The install location is defined by the $AOMP environment variable. The value of
That is, the physical installation will be in directory name formed by concatonating the version string to the value of $AOMP.
The "build_project.sh install" script will make a symbolic link from the physical directory to the symbolic directory $AOMP.
The default value for AOMP is $HOME/rocm/aomp.
For example, when building AOMP version 13.0-3 the install scripts will put all files and directories
in $HOME/rocm/aomp_13.0-3 and create a symbolic link as follows:
For example, when building AOMP version 13.0-4 the install scripts will put all files and directories
in $HOME/rocm/aomp_13.0-4 and create a symbolic link as follows:

```
ln -sf ${AOMP}_13.0-3 ${AOMP}
ln -sf ${AOMP}_13.0-4 ${AOMP}
```
All testing for AOMP uses the environment variable AOMP to locate the installation. This makes it easy to switch between versions of AOMP for testing by simply changing the environment variable AOMP. You do NOT need to change the symbolic link.
For example, if the aomp symbolic link currently points to aomp_13.0-3 and you want to test aomp_13.0-2, do this:
For example, if the aomp symbolic link currently points to aomp_13.0-4 and you want to test aomp_13.0-3, do this:

```
export AOMP=$HOME/rocm/aomp_13.0-2
export AOMP=$HOME/rocm/aomp_13.0-3
```

The aomp package installs in /usr/lib/aomp_\<version_string\> and symlinks /usr/lib/aomp to the versioned directory. To test the installed package, set AOMP to /usr/lib/aomp or /usr/lib/aomp_\<version_string\>.
Expand Down
34 changes: 32 additions & 2 deletions bin/debian/changelog
Original file line number Diff line number Diff line change
@@ -1,4 +1,4 @@
aomp (13.0-3) UNRELEASED; urgency=medium
aomp (13.0-4) UNRELEASED; urgency=medium

* Initial release of aomp is 0.3-2
* Please see example in /usr/lib/aomp/examples/vmuldemo
Expand Down Expand Up @@ -592,4 +592,34 @@ aomp (13.0-3) UNRELEASED; urgency=medium
* hip_host_register
* 36 Clang lit tests failing
* RAJA build failure
-- Greg Rodgers <[email protected]> Mon, 07 Jun 2021 20:21:27 -0500
*
* 13.0-4
* These are the release notes for AOMP_13.0-4. The source code base for this release is the upstream LLVM 13
* monorepo main branch as of April 1, 2021 with hash value 0889181625bb570e463362ab8f53f9a14c886b2e.
* Updates from the aomp-stg-open repo were added as one commit per file difference as of April 6, 2021.
* Features:
* Support larger CU masks up to 128 bit or up to 128 CUs.
* Provide warning when HIP tries to use OpenMP offloading that this is not supported and target constructs
* will be ignored.
*
* Fixes:
* Fixed examples/cloc/vector_copy_hip and vector_copy_hip_omp to use __HIP_PLATFORM_AMD__ from depracated
* __HIP_PLATFORM_HCC__.
* Fixed examples/hip/device_lib.
* Fixed examples/hip/writeIndex.
* Fixed test/hip-openmp/aomp_hip_launch_test. Bug in driver.cpp and new name for a.out file.
* Fixed test/hip-openmp/hip_host_register.
* Fixed hipcc when using noroot installs.
* Fixed host compilation picking up the wrong libomp.so on some systems.
* Fixed RPATH to include lib64.
* Fixed RAJA build issue.
* Fixed issue where targetID was not handled properly with march/fopenmp-targets.
*
* Build changes:
* Turn on ROCT_ENABLE for openmp default build in addtion to openmp_debug build.
* Update list of gfx names to include gfx90a.
* Update list of NVPTX GPU names to : 30,35,37,50,52,53,60,61,62
*
* Known Regressions:
* 9 Clang lit test failures
-- Greg Rodgers <[email protected]> Thu, 17 Jun 2021 14:01:06 -0500
4 changes: 2 additions & 2 deletions docs/CENTOSINSTALL.md
Original file line number Diff line number Diff line change
Expand Up @@ -5,8 +5,8 @@ AOMP will install to /usr/lib/aomp. The AOMP environment variable will automatic

### Download and Install
```
wget https://github.com/ROCm-Developer-Tools/aomp/releases/download/rel_13.0-3/aomp_CENTOS_8-13.0-3.x86_64.rpm
sudo rpm -i aomp_CENTOS_8-13.0-3.x86_64.rpm
wget https://github.com/ROCm-Developer-Tools/aomp/releases/download/rel_13.0-4/aomp_CENTOS_8-13.0-4.x86_64.rpm
sudo rpm -i aomp_CENTOS_8-13.0-4.x86_64.rpm
```
Confirm AOMP environment variable is set:
```
Expand Down
20 changes: 10 additions & 10 deletions docs/NOROOTINSTALL.md
Original file line number Diff line number Diff line change
Expand Up @@ -8,13 +8,13 @@ To install the debian package without root access into your home directory, you

On Ubuntu 20.04:
```
wget https://github.com/ROCm-Developer-Tools/aomp/releases/download/rel_13.0-3/aomp_Ubuntu2004_13.0-3_amd64.deb
dpkg -x aomp_Ubuntu2004_13.0-3_amd64.deb /tmp/temproot
wget https://github.com/ROCm-Developer-Tools/aomp/releases/download/rel_13.0-4/aomp_Ubuntu2004_13.0-4_amd64.deb
dpkg -x aomp_Ubuntu2004_13.0-4_amd64.deb /tmp/temproot
```
On Ubuntu 18.04 LTS (bionic beaver):
```
wget https://github.com/ROCm-Developer-Tools/aomp/releases/download/rel_13.0-3/aomp_Ubuntu1804_13.0-3_amd64.deb
dpkg -x aomp_Ubuntu1804_13.0-3_amd64.deb /tmp/temproot
wget https://github.com/ROCm-Developer-Tools/aomp/releases/download/rel_13.0-4/aomp_Ubuntu1804_13.0-4_amd64.deb
dpkg -x aomp_Ubuntu1804_13.0-4_amd64.deb /tmp/temproot
```
Move to $HOME and set variables:
```
Expand All @@ -31,18 +31,18 @@ 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_13.0-3/aomp_REDHAT_7-13.0-3.x86_64.rpm
rpm2cpio aomp_REDHAT_7-13.0-3.x86_64.rpm | cpio -idmv
wget https://github.com/ROCm-Developer-Tools/aomp/releases/download/rel_13.0-4/aomp_REDHAT_7-13.0-4.x86_64.rpm
rpm2cpio aomp_REDHAT_7-13.0-4.x86_64.rpm | cpio -idmv
```
For SLES15-SP1:
```
wget https://github.com/ROCm-Developer-Tools/aomp/releases/download/rel_13.0-3/aomp_SLES15_SP1-13.0-3.x86_64.rpm
rpm2cpio aomp_SLES15_SP1-13.0-3.x86_64.rpm | cpio -idmv
wget https://github.com/ROCm-Developer-Tools/aomp/releases/download/rel_13.0-4/aomp_SLES15_SP1-13.0-4.x86_64.rpm
rpm2cpio aomp_SLES15_SP1-13.0-4.x86_64.rpm | cpio -idmv
```
For CentOS:
```
wget https://github.com/ROCm-Developer-Tools/aomp/releases/download/rel_13.0-3/aomp_CENTOS_8-13.0-3.x86_64.rpm
rpm2cpio aomp_CENTOS_8-13.0-3.x86_64.rpm | cpio -idmv
wget https://github.com/ROCm-Developer-Tools/aomp/releases/download/rel_13.0-4/aomp_CENTOS_8-13.0-4.x86_64.rpm
rpm2cpio aomp_CENTOS_8-13.0-4.x86_64.rpm | cpio -idmv
```
Move to $HOME and set variables:
```
Expand Down
12 changes: 6 additions & 6 deletions docs/RELEASESOURCEINSTALL.md
Original file line number Diff line number Diff line change
Expand Up @@ -14,8 +14,8 @@ To build AOMP from source you must: 1. Install certain distribution packages, 2.
To build and install aomp from the release source tarball run these commands:

```
wget https://github.com/ROCm-Developer-Tools/aomp/releases/download/rel_13.0-3/aomp-13.0-3.tar.gz
tar -xzf aomp-13.0-3.tar.gz
wget https://github.com/ROCm-Developer-Tools/aomp/releases/download/rel_13.0-4/aomp-13.0-4.tar.gz
tar -xzf aomp-13.0-4.tar.gz
cd aomp13
nohup make &
```
Expand All @@ -30,17 +30,17 @@ 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_13.0-3 and create a symbolic link from $HOME/rocm/aomp to $HOME/rocm/aomp_13.0-3.
The build_aomp.sh script will install into $HOME/rocm/aomp_13.0-4 and create a symbolic link from $HOME/rocm/aomp to $HOME/rocm/aomp_13.0-4.
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_13.0-2.
To enable a backlevel version of AOMP, simply set AOMP to $HOME/rocm/aomp_13.0-3.

## Build AOMP with spack

Assuming your have installed the [prerequisites](SOURCEINSTALL_PREREQUISITE.md), use these commands to fetch the source and build aomp. Currently the aomp configuration is not yet in the spack git hub so you must create the spack package first.

```
wget https://github.com/ROCm-Developer-Tools/aomp/blob/aomp-13.0-3/bin/package.py
spack create -n aomp -t makefile --force https://github.com/ROCm-Developer-Tools/aomp/releases/download/rel_13.0-3/aomp-13.0-3.tar.gz
wget https://github.com/ROCm-Developer-Tools/aomp/blob/aomp-13.0-4/bin/package.py
spack create -n aomp -t makefile --force https://github.com/ROCm-Developer-Tools/aomp/releases/download/rel_13.0-4/aomp-13.0-4.tar.gz
spack edit aomp
spack install aomp
```
Expand Down
6 changes: 3 additions & 3 deletions docs/RHELINSTALL.md
Original file line number Diff line number Diff line change
Expand Up @@ -8,12 +8,12 @@ sudo yum install perl-Digest-MD5 perl-URI-Encode
```
### Download and Install
```
wget https://github.com/ROCm-Developer-Tools/aomp/releases/download/rel_13.0-3/aomp_REDHAT_7-13.0-3.x86_64.rpm
sudo rpm -i aomp_REDHAT_7-13.0-3.x86_64.rpm
wget https://github.com/ROCm-Developer-Tools/aomp/releases/download/rel_13.0-4/aomp_REDHAT_7-13.0-4.x86_64.rpm
sudo rpm -i aomp_REDHAT_7-13.0-4.x86_64.rpm
```
If CUDA is not installed the installation may cancel, to bypass this:
```
sudo rpm -i --nodeps aomp_REDHAT_7-13.0-3.x86_64.rpm
sudo rpm -i --nodeps aomp_REDHAT_7-13.0-4.x86_64.rpm
```
Confirm AOMP environment variable is set:
```
Expand Down
4 changes: 2 additions & 2 deletions docs/SLES15INSTALL.md
Original file line number Diff line number Diff line change
@@ -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_13.0-3/aomp_SLES15_SP1-13.0-3.x86_64.rpm
sudo rpm -i aomp_SLES15_SP1-13.0-3.x86_64.rpm
wget https://github.com/ROCm-Developer-Tools/aomp/releases/download/rel_13.0-4/aomp_SLES15_SP1-13.0-4.x86_64.rpm
sudo rpm -i aomp_SLES15_SP1-13.0-4.x86_64.rpm
```
Confirm AOMP environment variable is set:
```
Expand Down
4 changes: 2 additions & 2 deletions docs/SOURCEINSTALL.md
Original file line number Diff line number Diff line change
@@ -1,4 +1,4 @@
# Source Install V 13.0-3 (DEV)
# Source Install V 13.0-4 (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.
Expand Down Expand Up @@ -29,7 +29,7 @@ The development version is the next version to be released. It is possible that

<b>For the Release Branch:</b>
```
git checkout aomp-13.0-3
git checkout aomp-13.0-4
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.
```
Expand Down
8 changes: 4 additions & 4 deletions docs/UBUNTUINSTALL.md
Original file line number Diff line number Diff line change
Expand Up @@ -3,14 +3,14 @@ AOMP will install to /usr/lib/aomp. The AOMP environment variable will automatic

On Ubuntu 20.04, run these commands:
```
wget https://github.com/ROCm-Developer-Tools/aomp/releases/download/rel_13.0-3/aomp_Ubuntu2004_13.0-3_amd64.deb
sudo dpkg -i aomp_Ubuntu2004_13.0-3_amd64.deb
wget https://github.com/ROCm-Developer-Tools/aomp/releases/download/rel_13.0-4/aomp_Ubuntu2004_13.0-4_amd64.deb
sudo dpkg -i aomp_Ubuntu2004_13.0-4_amd64.deb
```

On Ubuntu 18.04 LTS (bionic beaver), run these commands:
```
wget https://github.com/ROCm-Developer-Tools/aomp/releases/download/rel_13.0-3/aomp_Ubuntu1804_13.0-3_amd64.deb
sudo dpkg -i aomp_Ubuntu1804_13.0-3_amd64.deb
wget https://github.com/ROCm-Developer-Tools/aomp/releases/download/rel_13.0-4/aomp_Ubuntu1804_13.0-4_amd64.deb
sudo dpkg -i aomp_Ubuntu1804_13.0-4_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.
Expand Down

0 comments on commit 64b1822

Please sign in to comment.