Skip to content

Commit 02c1c6a

Browse files
authored
Updates for PETSc and Standardizing OMPI/UCX for Future ROCm compatibility, updating legal details with licensing info table. (#26)
1 parent e7b352d commit 02c1c6a

File tree

22 files changed

+236
-173
lines changed

22 files changed

+236
-173
lines changed

README.md

Lines changed: 4 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -9,9 +9,9 @@ Each builds provides parameters to specify different source code branches, relea
99
| X86_64 CPU(s) | AMD Instinct MI200 GPU(s) <br> AMD Instinct MI100 GPU(s) | Ubuntu 20.04 <br> Ubuntu 22.04 <BR> RHEL8 <br> RHEL9 <br> SLES 15 sp4 | ROCm v5.x compatibility |[Docker Engine](https://docs.docker.com/engine/install/) <br> [Singularity](https://sylabs.io/docs/) |
1010

1111
For ROCm installation procedures and validation checks, see:
12-
* [ROCm Documentation](https://docs.amd.com/)
12+
* [ROCm Documentation](https://rocm.docs.amd.com)
1313
* [AMD Lab Notes ROCm installation notes](https://github.com/amd/amd-lab-notes/tree/release/rocm-installation).
14-
* [Testing the ROCm Installation](https://rocmdocs.amd.com/en/latest/Installation_Guide/Installation-Guide.html#testing-the-rocm-installation)
14+
* [ROCm Examples](https://github.com/amd/rocm-examples)
1515

1616
## Applications:
1717
- [AMD Base Docker Container for GPU-Aware MPI in ROCm applications](/base-gpu-mpi-rocm-docker/)
@@ -24,4 +24,6 @@ For ROCm installation procedures and validation checks, see:
2424
- [PETSc in Docker](/petsc-docker/)
2525
- [PyFR in Docker](/pyfr-docker/)
2626
- [rocHPL](/rochpl/)
27+
- [docker](/rochpl/docker/)
28+
- [spack](/rochpl/spack/)
2729
- [Specfem3D - Cartesian](/specfem3d/)

base-gpu-mpi-rocm-docker/Dockerfile

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -2,7 +2,7 @@ ARG IMAGE="rocm/dev-ubuntu-22.04:5.4.2"
22

33
FROM ${IMAGE}
44

5-
ARG UCX_BRANCH="v1.14.0"
5+
ARG UCX_BRANCH="v1.14.1"
66
ARG OMPI_BRANCH="v4.1.5"
77
ARG APT_GET_APPS=""
88

base-gpu-mpi-rocm-docker/README.md

Lines changed: 13 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -18,9 +18,9 @@ env CC=$ROCM_PATH/bin/amdclang \
1818
| X86_64 CPU(s) | AMD Instinct MI200 GPU(s) <br> AMD Instinct MI100 GPU(s) | Ubuntu 20.04 <br> Ubuntu 22.04 <BR> RHEL8 <br> RHEL9 <br> SLES 15 sp4 | ROCm v5.x compatibility |[Docker Engine](https://docs.docker.com/engine/install/) <br> [Singularity](https://sylabs.io/docs/) |
1919

2020
For ROCm installation procedures and validation checks, see:
21-
* [ROCm Documentation](https://docs.amd.com/)
21+
* [ROCm Documentation](https://rocm.docs.amd.com)
2222
* [AMD Lab Notes ROCm installation notes](https://github.com/amd/amd-lab-notes/tree/release/rocm-installation).
23-
* [Testing the ROCm Installation](https://rocmdocs.amd.com/en/latest/Installation_Guide/Installation-Guide.html#testing-the-rocm-installation)
23+
* [ROCm Examples](https://github.com/amd/rocm-examples)
2424

2525
## Docker Container Build
2626
These instructions use Docker to create an HPC Application Container.
@@ -60,7 +60,7 @@ Possible `build-arg` for the Docker build command
6060
> The `*-complete` version has all the components required for building and installation.
6161
6262
- #### UCX_BRANCH
63-
Default: `v1.14.0`
63+
Default: `v1.14.1`
6464
Branch/Tag found: [UXC repo](https://github.com/openucx/ucx)
6565

6666
- #### OMPI_BRANCH
@@ -128,7 +128,16 @@ singularity shell mycontainer.sif
128128
## Licensing Information
129129
Your access and use of this application is subject to the terms of the applicable component-level license identified below. To the extent any subcomponent in this container requires an offer for corresponding source code, AMD hereby makes such an offer for corresponding source code form, which will be made available upon request. By accessing and using this application, you are agreeing to fully comply with the terms of this license. If you do not agree to the terms of this license, do not access or use this application.
130130

131-
The application is provided in a container image format that includes the following separate and independent components: Ubuntu (License: Creative Commons CC-BY-SA version 3.0 UK license), CMAKE (License: BSD 3), OpenMPI (License: BSD 3-Clause), OpenUCX (License: BSD 3-Clause), ROCm (License: Custom/MITx11/Apache V2.0/UIUC NCSA). Additional third-party content in this container may be subject to additional licenses and restrictions. The components are licensed to you directly by the party that owns the content pursuant to the license terms included with such content and is not licensed to you by AMD. ALL THIRD-PARTY CONTENT IS MADE AVAILABLE BY AMD “AS IS” WITHOUT A WARRANTY OF ANY KIND. USE OF SUCH THIRD-PARTY CONTENT IS DONE AT YOUR SOLE DISCRETION AND UNDER NO CIRCUMSTANCES WILL AMD BE LIABLE TO YOU FOR ANY THIRD-PARTY CONTENT. YOU ASSUME ALL RISK AND ARE SOLELY RESPONSIBLE FOR ANY DAMAGES THAT MAY ARISE FROM YOUR USE OF THIRD-PARTY CONTENT.
131+
The application is provided in a container image format that includes the following separate and independent components:
132+
|Package | License | URL|
133+
|---|---|---|
134+
|Ubuntu| Creative Commons CC-BY-SA Version 3.0 UK License |[Ubuntu Legal](https://ubuntu.com/legal)|
135+
|CMAKE|OSI-approved BSD-3 clause|[CMake License](https://cmake.org/licensing/)|
136+
|OpenMPI|BSD 3-Clause|[OpenMPI License](https://www-lb.open-mpi.org/community/license.php)<br /> [OpenMPI Dependencies Licenses](https://docs.open-mpi.org/en/v5.0.x/license/index.html)|
137+
|OpenUCX|BSD 3-Clause|[OpenUCX License](https://openucx.org/license/)|
138+
|ROCm|Custom/MIT/Apache V2.0/UIUC OSL|[ROCm Licensing Terms](https://rocm.docs.amd.com/en/latest/release/licensing.html)|
139+
140+
Additional third-party content in this container may be subject to additional licenses and restrictions. The components are licensed to you directly by the party that owns the content pursuant to the license terms included with such content and is not licensed to you by AMD. ALL THIRD-PARTY CONTENT IS MADE AVAILABLE BY AMD “AS IS” WITHOUT A WARRANTY OF ANY KIND. USE OF SUCH THIRD-PARTY CONTENT IS DONE AT YOUR SOLE DISCRETION AND UNDER NO CIRCUMSTANCES WILL AMD BE LIABLE TO YOU FOR ANY THIRD-PARTY CONTENT. YOU ASSUME ALL RISK AND ARE SOLELY RESPONSIBLE FOR ANY DAMAGES THAT MAY ARISE FROM YOUR USE OF THIRD-PARTY CONTENT.
132141

133142
## Disclaimer
134143
The information contained herein is for informational purposes only, and is subject to change without notice. In addition, any stated support is planned and is also subject to change. While every precaution has been taken in the preparation of this document, it may contain technical inaccuracies, omissions and typographical errors, and AMD is under no obligation to update or otherwise correct this information. Advanced Micro Devices, Inc. makes no representations or warranties with respect to the accuracy or completeness of the contents of this document, and assumes no liability of any kind, including the implied warranties of noninfringement, merchantability or fitness for particular purposes, with respect to the operation or use of AMD hardware, software or other products described herein. No license, including implied or arising by estoppel, to any intellectual property rights is granted by this document. Terms and limitations applicable to the purchase or use of AMD’s products are as set forth in a signed agreement between the parties or in AMD's Standard Terms and Conditions of Sale.

cp2k-docker/Dockerfile

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -3,8 +3,8 @@ ARG IMAGE="rocm/dev-ubuntu-20.04:5.4.3-complete"
33
FROM ${IMAGE}
44

55
ARG CP2K_BRANCH="v2023.1"
6-
ARG UCX_BRANCH="v1.14.0"
7-
ARG OMPI_BRANCH="v4.1.4"
6+
ARG UCX_BRANCH="v1.14.1"
7+
ARG OMPI_BRANCH="v4.1.5"
88
ARG GPU_VER="Mi250"
99

1010
# Update and Install basic Linux development tools

cp2k-docker/README.md

Lines changed: 20 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -18,7 +18,7 @@ The latest CP2K review, as of **May 2020**, can be found at **[The Journal of Ch
1818
For ROCm installation procedures and validation checks, see:
1919
* [ROCm Documentation](https://docs.amd.com)
2020
* [AMD Lab Notes ROCm installation notes](https://github.com/amd/amd-lab-notes/tree/release/rocm-installation)
21-
* [Testing the ROCm Installation](https://rocmdocs.amd.com/en/latest/Installation_Guide/Installation-Guide.html#testing-the-rocm-installation)
21+
* [ROCm Examples](https://github.com/amd/rocm-examples)
2222

2323
## Build CP2K Container
2424
This section describes the instructions for building a Docker container with CP2K.
@@ -46,11 +46,11 @@ Possible `build-arg` for the Docker build command
4646
Branch/Tag found: [CP2K repo](https://github.com/cp2k/cp2k)
4747

4848
- #### UCX_BRANCH
49-
Default: `v1.14.0`
50-
Branch/Tag found: [UCX repo](https://github.com/openucx/ucx)
49+
Default: `v1.14.1`
50+
Branch/Tag found: [UXC repo](https://github.com/openucx/ucx)
5151

5252
- #### OMPI_BRANCH
53-
Default: `v4.1.4`
53+
Default: `v4.1.5`
5454
Branch/Tag found: [OpenMPI repo](https://github.com/open-mpi/ompi)
5555

5656
- #### GPU_VER
@@ -378,7 +378,22 @@ singularity exec \
378378

379379
Your use of this application is subject to the terms of the applicable component-level license identified below. To the extent any subcomponent in this container requires an offer for corresponding source code, AMD hereby makes such an offer for corresponding source code form, which will be made available upon request. By accessing and using this application, you are agreeing to fully comply with the terms of this license. If you do not agree to the terms of this license, do not access or use this application.
380380

381-
The application is provided in a container image format that includes the following separate and independent components: Ubuntu (License: Creative Commons CC-BY-SA version 3.0 UK license), CP2K (GNU GPL version 2 or, at your option, any later version), CMAKE (License: BSD 3), OpenMPI (License: BSD 3-Clause), OpenUCX (License: BSD 3-Clause), ROCm (License: Custom/MIT/Apache V2.0/UIULC OSL), OpenBLAS (License: BSD 3-Clause), COSMA (License: BSD 3-Clause), Libxsmm (License: BSD 3-Clause), Libxc (License: MPL v2.0), SpLA (License: BSD 3-Clause). Additional third-party content in this container may be subject to additional licenses and restrictions. The components are licensed to you directly by the party that owns the content pursuant to the license terms included with such content and is not licensed to you by AMD. ALL LINKED THIRD-PARTY CONTENT IS MADE AVAILABLE BY AMD “AS IS” WITHOUT A WARRANTY OF ANY KIND. USE OF THE CONTAINER IS DONE AT YOUR SOLE DISCRETION AND UNDER NO CIRCUMSTANCES WILL AMD BE LIABLE TO YOU FOR ANY THIRD-PARTY CONTENT. YOU ASSUME ALL RISK AND ARE SOLELY RESPONSIBLE FOR ANY DAMAGES THAT MAY ARISE FROM YOUR USE OF THE CONTAINER.
381+
The application is provided in a container image format that includes the following separate and independent components:
382+
|Package | License | URL|
383+
|---|---|---|
384+
|Ubuntu| Creative Commons CC-BY-SA Version 3.0 UK License |[Ubuntu Legal](https://ubuntu.com/legal)|
385+
|CMAKE|OSI-approved BSD-3 clause|[CMake License](https://cmake.org/licensing/)|
386+
|OpenMPI|BSD 3-Clause|[OpenMPI License](https://www-lb.open-mpi.org/community/license.php)<br /> [OpenMPI Dependencies Licenses](https://docs.open-mpi.org/en/v5.0.x/license/index.html)|
387+
|OpenUCX|BSD 3-Clause|[OpenUCX License](https://openucx.org/license/)|
388+
|ROCm|Custom/MIT/Apache V2.0/UIUC OSL|[ROCm Licensing Terms](https://rocm.docs.amd.com/en/latest/release/licensing.html)|
389+
|CP2K|GNU GPL Version 2|[CP2k](https://www.cp2k.org/)<br />[CP2K License](https://github.com/cp2k/cp2k/blob/master/LICENSE)|
390+
|OpenBlas|BSD 3-Clause|[OpenBlas](https://www.openblas.net/)<br /> [OpenBlas License](https://github.com/xianyi/OpenBLAS/blob/develop/LICENSE)|
391+
|COSMA|BSD 3-Clause|[COSMA License](https://github.com/eth-cscs/COSMA/blob/master/LICENSE)|
392+
|Libxsmm|BSD 3-Classe|[Libxsmm License](https://libxsmm.readthedocs.io/en/latest/LICENSE/)|
393+
|Libxc|MPL v2.0|[Libxc License](https://github.com/ElectronicStructureLibrary/libxc)|
394+
|SpLA|BSD 3-Clause|[SpLA License](https://github.com/eth-cscs/spla/blob/master/LICENSE)|
395+
396+
Additional third-party content in this container may be subject to additional licenses and restrictions. The components are licensed to you directly by the party that owns the content pursuant to the license terms included with such content and is not licensed to you by AMD. ALL LINKED THIRD-PARTY CONTENT IS MADE AVAILABLE BY AMD “AS IS” WITHOUT A WARRANTY OF ANY KIND. USE OF THE CONTAINER IS DONE AT YOUR SOLE DISCRETION AND UNDER NO CIRCUMSTANCES WILL AMD BE LIABLE TO YOU FOR ANY THIRD-PARTY CONTENT. YOU ASSUME ALL RISK AND ARE SOLELY RESPONSIBLE FOR ANY DAMAGES THAT MAY ARISE FROM YOUR USE OF THE CONTAINER.
382397

383398
## Disclaimer
384399
The information contained herein is for informational purposes only, and is subject to change without notice. In addition, any stated support is planned and is also subject to change. While every precaution has been taken in the preparation of this document, it may contain technical inaccuracies, omissions and typographical errors, and AMD is under no obligation to update or otherwise correct this information. Advanced Micro Devices, Inc. makes no representations or warranties with respect to the accuracy or completeness of the contents of this document, and assumes no liability of any kind, including the implied warranties of noninfringement, merchantability or fitness for particular purposes, with respect to the operation or use of AMD hardware, software or other products described herein. No license, including implied or arising by estoppel, to any intellectual property rights is granted by this document. Terms and limitations applicable to the purchase or use of AMD’s products are as set forth in a signed agreement between the parties or in AMD's Standard Terms and Conditions of Sale.

gromacs-docker/Dockerfile

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -4,8 +4,8 @@ FROM ${IMAGE}
44

55
ARG GROMACS_BRANCH="develop_2022_amd"
66
ARG MPI_ENABLED="off"
7-
ARG UCX_BRANCH="v1.13.1"
8-
ARG OMPI_BRANCH="v4.1.4"
7+
ARG UCX_BRANCH="v1.14.1"
8+
ARG OMPI_BRANCH="v4.1.5"
99

1010
# Update and Install basic Linux development tools
1111
RUN rm /etc/apt/sources.list.d/* \
@@ -82,7 +82,7 @@ RUN if [ "$MPI_ENABLED" = "on" ] ; then \
8282
&& cd build \
8383
&& ../configure --prefix=/opt/ompi --with-ucx=/opt/ucx \
8484
--enable-mca-no-build=btl-uct \
85-
--with-pmix CC=gcc \
85+
--with-pmix=internal \
8686
--enable-mpi \
8787
--enable-mpi-fortran=yes \
8888
--disable-debug \

gromacs-docker/README.md

Lines changed: 17 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -24,9 +24,9 @@ For more information on the ROCm™ open software platform and access to an acti
2424
>Note:
2525
>The GROMACS application container assumes that the server contains the required x86-64 CPU(s) and at least one of the listed AMD GPUs. Also, the server must have one of the required operating systems and the listed ROCm driver version installed to run the Docker container. The server must also have a Docker Engine installed to run the container. Please visit the Docker Engine install web site at https://docs.docker.com/engine/install/ to install the latest Docker Engine for the operating system installed on the server. If Singularity use is planned, please visit https://sylabs.io/docs/ for the latest Singularity install documentation.
2626
For ROCm installation procedures and validation checks, see:
27-
* [ROCm Documentation](https://docs.amd.com/)
27+
* [ROCm Documentation](https://rocm.docs.amd.com)
2828
* [AMD Lab Notes ROCm installation notes](https://github.com/amd/amd-lab-notes/tree/release/rocm-installation).
29-
* [Testing the ROCm Installation](https://rocmdocs.amd.com/en/latest/Installation_Guide/Installation-Guide.html#testing-the-rocm-installation)
29+
* [ROCm Examples](https://github.com/amd/rocm-examples)
3030

3131
## AMD's Implementation of Gromacs with HIP Docker Build
3232
Instructions on how to build a Docker Container with AMD's implementation of Gromacs.
@@ -56,12 +56,12 @@ Possible `build-arg` for the Docker build command
5656
If this option is set to off, UCX and Open MPI will not be installed, and the following two options will not be used.
5757

5858
- #### UCX_BRANCH
59-
Default: `v1.13.1`
60-
Branch/Tag found: [UXC repo](https://github.com/openucx/ucx).
59+
Default: `v1.14.1`
60+
Branch/Tag found: [UXC repo](https://github.com/openucx/ucx)
6161

6262
- #### OMPI_BRANCH
63-
Default: `v4.1.4`
64-
Branch/Tag found: [OpenMPI repo](https://github.com/open-mpi/ompi).
63+
Default: `v4.1.5`
64+
Branch/Tag found: [OpenMPI repo](https://github.com/open-mpi/ompi)
6565

6666
### Building AMD's implementation of Gromacs with HIP Container
6767
Download the [Dockerfile](/gromacs-docker/Dockerfile)
@@ -200,7 +200,17 @@ Optimal performance for each benchmark and GPU/GCD configuration can be tuned by
200200
## Licensing Information
201201
Your access and use of this application is subject to the terms of the applicable component-level license identified below. To the extent any subcomponent in this container requires an offer for corresponding source code, AMD hereby makes such an offer for corresponding source code form, which will be made available upon request. By accessing and using this application, you are agreeing to fully comply with the terms of this license. If you do not agree to the terms of this license, do not access or use this application.
202202

203-
The application is provided in a container image format that includes the following separate and independent components: Ubuntu (License: Creative Commons CC-BY-SA version 3.0 UK license), Gromacs (License: LGPL 2.1), CMAKE (License: BSD 3), OpenMPI (License: BSD 3-Clause), OpenUCX (License: BSD 3-Clause), ROCm (License: Custom/MIT/Apache V2.0/UIUC NCSA). Additional third-party content in this container may be subject to additional licenses and restrictions. The components are licensed to you directly by the party that owns the content pursuant to the license terms included with such content and is not licensed to you by AMD. ALL THIRD-PARTY CONTENT IS MADE AVAILABLE BY AMD “AS IS” WITHOUT A WARRANTY OF ANY KIND. USE OF THE CONTAINER IS DONE AT YOUR SOLE DISCRETION AND UNDER NO CIRCUMSTANCES WILL AMD BE LIABLE TO YOU FOR ANY THIRD-PARTY CONTENT. YOU ASSUME ALL RISK AND ARE SOLELY RESPONSIBLE FOR ANY DAMAGES THAT MAY ARISE FROM YOUR USE OF THE CONTAINER.
203+
The application is provided in a container image format that includes the following separate and independent components:
204+
|Package | License | URL|
205+
|---|---|---|
206+
|Ubuntu| Creative Commons CC-BY-SA Version 3.0 UK License |[Ubuntu Legal](https://ubuntu.com/legal)|
207+
|CMAKE|OSI-approved BSD-3 clause|[CMake License](https://cmake.org/licensing/)|
208+
|OpenMPI|BSD 3-Clause|[OpenMPI License](https://www-lb.open-mpi.org/community/license.php)<br /> [OpenMPI Dependencies Licenses](https://docs.open-mpi.org/en/v5.0.x/license/index.html)|
209+
|OpenUCX|BSD 3-Clause|[OpenUCX License](https://openucx.org/license/)|
210+
|ROCm|Custom/MIT/Apache V2.0/UIUC OSL|[ROCm Licensing Terms](https://rocm.docs.amd.com/en/latest/release/licensing.html)|
211+
|Gromacs|LGPL 2.1|[Gromacs](https://www.gromacs.org/)<br /> [Gromacs License](https://github.com/gromacs/gromacs/blob/main/COPYING)|
212+
213+
Additional third-party content in this container may be subject to additional licenses and restrictions. The components are licensed to you directly by the party that owns the content pursuant to the license terms included with such content and is not licensed to you by AMD. ALL THIRD-PARTY CONTENT IS MADE AVAILABLE BY AMD “AS IS” WITHOUT A WARRANTY OF ANY KIND. USE OF THE CONTAINER IS DONE AT YOUR SOLE DISCRETION AND UNDER NO CIRCUMSTANCES WILL AMD BE LIABLE TO YOU FOR ANY THIRD-PARTY CONTENT. YOU ASSUME ALL RISK AND ARE SOLELY RESPONSIBLE FOR ANY DAMAGES THAT MAY ARISE FROM YOUR USE OF THE CONTAINER.
204214

205215
The GROMACS source code and selected set of binary packages are available here: www.gromacs.org. GROMACS is Free Software, available under the GNU Lesser General Public License (LGPL), version 2.1. You can redistribute it and/or modify it under the terms of the LGPL as published by the Free Software Foundation; either version 2.1 of the License, or (at your option) any later version.
206216

hpcg-docker/Dockerfile

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -3,8 +3,8 @@ ARG IMAGE="rocm/dev-ubuntu-20.04:5.3-complete"
33
FROM ${IMAGE}
44

55
ARG ROCHPCG_BRANCH="master"
6-
ARG UCX_BRANCH="v1.13.1"
7-
ARG OMPI_BRANCH="v4.1.4"
6+
ARG UCX_BRANCH="v1.14.1"
7+
ARG OMPI_BRANCH="v4.1.5"
88

99
# Update and Install basic Linux development tools
1010
RUN rm /etc/apt/sources.list.d/* \
@@ -70,7 +70,7 @@ RUN cd /tmp \
7070
&& cd build \
7171
&& ../configure --prefix=/opt/ompi --with-ucx=/opt/ucx \
7272
--enable-mca-no-build=btl-uct \
73-
--with-pmix CC=gcc \
73+
--with-pmix=internal \
7474
--enable-mpi \
7575
--enable-mpi-fortran=yes \
7676
--disable-debug \

0 commit comments

Comments
 (0)