From d4e952ee61e79c80face2dfc47692c2f871cba11 Mon Sep 17 00:00:00 2001 From: Sarah Chastain Date: Thu, 18 Jul 2024 14:08:01 -0600 Subject: [PATCH 1/9] include CUDA version info in docs --- README.md | 6 +++++ docs/source/Getting-started-guide.rst | 33 +++++++++++++++++++++++++-- 2 files changed, 37 insertions(+), 2 deletions(-) diff --git a/README.md b/README.md index 955757048..1b62c5154 100644 --- a/README.md +++ b/README.md @@ -95,6 +95,12 @@ print "All done" **For a quick demo which you can run in-browser without installation, go to the following [link](https://colab.research.google.com/github/ledatelescope/bifrost/blob/master/BifrostDemo.ipynb).** +### CUDA + +CUDA is available at [link](https://developer.nvidia.com/cuda-downloads). You can check +[link](http://ledatelescope.github.io/bifrost/Getting-started-guide.html) to see +which versions of the CUDA toolkit have been confirmed to work with Bifrost. + ### C Dependencies If using Ubuntu or another Debian-based linux distribution: diff --git a/docs/source/Getting-started-guide.rst b/docs/source/Getting-started-guide.rst index 7fb0fd7ad..efdfc6965 100644 --- a/docs/source/Getting-started-guide.rst +++ b/docs/source/Getting-started-guide.rst @@ -58,8 +58,37 @@ try out a CPU-only version of Bifrost. Then, once you have that first experience, you can come back here for a speedup. If you are ready to work with a GPU, you will want to get the newest -`CUDA toolkit `__. Follow -the operating system-specific instructions to install. +`CUDA toolkit `__. Follow +the operating system-specific instructions to install. Note +the table below indicating what CUDA versions have been tested with +Bifrost and confirmed to be working. + +.. csv-table:: + :header: "OS","Linux Kernel","Driver Verson","GPU","Toolkit","Status" + :widths: 15,18,12,18,12,35 + + "Ubuntu 20.04","5.4.0-177-generic","520.61.05","RTX 2080Ti","11.0.3","Working" + "Ubuntu 20.04","5.4.0-177-generic","520.61.05","RTX 2080Ti","11.1.1","Working" + "Ubuntu 20.04","5.4.0-177-generic","520.61.05","RTX 2080Ti","11.2.2","Likely working" + "Ubuntu 20.04","5.4.0-177-generic","520.61.05","RTX 2080Ti","11.3.1","Working" + "Ubuntu 20.04","5.4.0-186-generic","470.239.06","Quadro K2200","11.4.4","Likely Working" + "Ubuntu 20.04","5.4.0-186-generic","470.239.06","Quadro K2200","11.5.2","CUDA_ERROR_UNSUPPORTED_PTX_VERSION" + "Ubuntu 20.04","5.4.0-186-generic","495.29.05","Quadro K2200","11.5.2","Likely Working" + "Ubuntu 18.04","4.15.0-88-generic","510.85.02","A4000","11.6.124","Working" + "Ubuntu 18.04","4.15.0-88-generic","510.85.02","RTX 2080Ti","11.6.124","Working" + "Ubuntu 20.04","4.4.0-174-generic","525.147.05","Titan RTX","11.6.55","Working" + "Debian 12","6.1.0-21-amd64","525.147.05 ","Quadro K2200","11.8.0","Won't Install CUDA" + "Ubuntu 20.04","5.4.0-186-generic","520.61.05","Quadro K2200","11.8.0","Likely Working" + "Debian 12","6.1.0-21-amd64","525.147.05 ","Quadro K2200","12.0.0","Likely Working" + "Ubuntu 20.04","5.4.0-147-generic","525.125.06","A5000","12.0.140","Working" + "Ubuntu 20.04","5.4.0-144-generic","525.125.06","A5000","12.0.140","Working" + "Ubuntu 20.04","5.4.0-144-generic","525.147.05","A4000","12.0.140","Working" + "Debian 12","6.1.0-21-amd64","525.147.05 ","Quadro K2200","12.1.0","CUDA_ERROR_UNSUPPORTED_PTX_VERSION" + "Debian 12","6.1.0-21-amd64","530.30.02","Quadro K2200","12.1.1","Likely Working" + "Debian 12","6.1.0-21-amd64","535.104.05","Quadro K2200","12.2.2","FFT bug: zeroed out data" + "Debian 12","6.1.0-21-amd64","545.23.08","Quadro K2200","12.3.2","Likely Working" + "Debian 12","6.1.0-21-amd64","550.54.15","Quadro K2200","12.4.1","Likely Working" + "Ubuntu 22.04","5.15.0-106-generic","555.42.06","GTX 980","12.5","Working" Other Dependencies ^^^^^^^^^^^^^^^^^^ From a6b5a4517a8b4f77ffe184c4ca2c6186dba66457 Mon Sep 17 00:00:00 2001 From: Sarah Chastain Date: Thu, 18 Jul 2024 14:09:48 -0600 Subject: [PATCH 2/9] Update README.md --- README.md | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/README.md b/README.md index 1b62c5154..5092fd461 100644 --- a/README.md +++ b/README.md @@ -97,9 +97,9 @@ go to the following [link](https://colab.research.google.com/github/ledatelescop ### CUDA -CUDA is available at [link](https://developer.nvidia.com/cuda-downloads). You can check -[link](http://ledatelescope.github.io/bifrost/Getting-started-guide.html) to see -which versions of the CUDA toolkit have been confirmed to work with Bifrost. +CUDA is available at https://developer.nvidia.com/cuda-downloads. You can check the +[Getting Started section](http://ledatelescope.github.io/bifrost/Getting-started-guide.html) +of the docs to see which versions of the CUDA toolkit have been confirmed to work with Bifrost. ### C Dependencies From 3d0a8c147f728fc263a3f032fd33725303e786ae Mon Sep 17 00:00:00 2001 From: Sarah Chastain Date: Thu, 18 Jul 2024 14:10:25 -0600 Subject: [PATCH 3/9] Update README.md wording --- README.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/README.md b/README.md index 5092fd461..feda6c0d3 100644 --- a/README.md +++ b/README.md @@ -98,8 +98,8 @@ go to the following [link](https://colab.research.google.com/github/ledatelescop ### CUDA CUDA is available at https://developer.nvidia.com/cuda-downloads. You can check the -[Getting Started section](http://ledatelescope.github.io/bifrost/Getting-started-guide.html) -of the docs to see which versions of the CUDA toolkit have been confirmed to work with Bifrost. +["Getting Started guide"](http://ledatelescope.github.io/bifrost/Getting-started-guide.html) +in the docs to see which versions of the CUDA toolkit have been confirmed to work with Bifrost. ### C Dependencies From 61fbe382ad5fe54672a9a7da724098217fdc596f Mon Sep 17 00:00:00 2001 From: jaycedowell Date: Mon, 22 Jul 2024 11:18:18 -0600 Subject: [PATCH 4/9] Upgrade 11.2.2 to 'working'. --- docs/source/Getting-started-guide.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/source/Getting-started-guide.rst b/docs/source/Getting-started-guide.rst index efdfc6965..54d7e0d51 100644 --- a/docs/source/Getting-started-guide.rst +++ b/docs/source/Getting-started-guide.rst @@ -69,7 +69,7 @@ Bifrost and confirmed to be working. "Ubuntu 20.04","5.4.0-177-generic","520.61.05","RTX 2080Ti","11.0.3","Working" "Ubuntu 20.04","5.4.0-177-generic","520.61.05","RTX 2080Ti","11.1.1","Working" - "Ubuntu 20.04","5.4.0-177-generic","520.61.05","RTX 2080Ti","11.2.2","Likely working" + "Ubuntu 20.04","5.4.0-177-generic","520.61.05","RTX 2080Ti","11.2.2","Working" "Ubuntu 20.04","5.4.0-177-generic","520.61.05","RTX 2080Ti","11.3.1","Working" "Ubuntu 20.04","5.4.0-186-generic","470.239.06","Quadro K2200","11.4.4","Likely Working" "Ubuntu 20.04","5.4.0-186-generic","470.239.06","Quadro K2200","11.5.2","CUDA_ERROR_UNSUPPORTED_PTX_VERSION" From a28591576a8cff61fa4cb13f071ae82547817b96 Mon Sep 17 00:00:00 2001 From: jaycedowell Date: Mon, 22 Jul 2024 11:19:17 -0600 Subject: [PATCH 5/9] Typo. --- docs/source/Getting-started-guide.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/source/Getting-started-guide.rst b/docs/source/Getting-started-guide.rst index 54d7e0d51..b3e0d0508 100644 --- a/docs/source/Getting-started-guide.rst +++ b/docs/source/Getting-started-guide.rst @@ -64,7 +64,7 @@ the table below indicating what CUDA versions have been tested with Bifrost and confirmed to be working. .. csv-table:: - :header: "OS","Linux Kernel","Driver Verson","GPU","Toolkit","Status" + :header: "OS","Linux Kernel","Driver Version","GPU","Toolkit","Status" :widths: 15,18,12,18,12,35 "Ubuntu 20.04","5.4.0-177-generic","520.61.05","RTX 2080Ti","11.0.3","Working" From bb055d27f1efa83e5e6943685388621eea0ff2eb Mon Sep 17 00:00:00 2001 From: jaycedowell Date: Mon, 22 Jul 2024 11:27:33 -0600 Subject: [PATCH 6/9] Wording. --- docs/source/Getting-started-guide.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/source/Getting-started-guide.rst b/docs/source/Getting-started-guide.rst index b3e0d0508..31a979598 100644 --- a/docs/source/Getting-started-guide.rst +++ b/docs/source/Getting-started-guide.rst @@ -77,7 +77,7 @@ Bifrost and confirmed to be working. "Ubuntu 18.04","4.15.0-88-generic","510.85.02","A4000","11.6.124","Working" "Ubuntu 18.04","4.15.0-88-generic","510.85.02","RTX 2080Ti","11.6.124","Working" "Ubuntu 20.04","4.4.0-174-generic","525.147.05","Titan RTX","11.6.55","Working" - "Debian 12","6.1.0-21-amd64","525.147.05 ","Quadro K2200","11.8.0","Won't Install CUDA" + "Debian 12","6.1.0-21-amd64","525.147.05 ","Quadro K2200","11.8.0","CUDA Install Failed" "Ubuntu 20.04","5.4.0-186-generic","520.61.05","Quadro K2200","11.8.0","Likely Working" "Debian 12","6.1.0-21-amd64","525.147.05 ","Quadro K2200","12.0.0","Likely Working" "Ubuntu 20.04","5.4.0-147-generic","525.125.06","A5000","12.0.140","Working" From 9baceaaf594fff1f2cf7d286c636d94a0f27f8a0 Mon Sep 17 00:00:00 2001 From: jaycedowell Date: Mon, 22 Jul 2024 11:36:05 -0600 Subject: [PATCH 7/9] likely working -> working; Issue warning about CUDA 11.8. --- docs/source/Getting-started-guide.rst | 14 +++++++------- 1 file changed, 7 insertions(+), 7 deletions(-) diff --git a/docs/source/Getting-started-guide.rst b/docs/source/Getting-started-guide.rst index 31a979598..63575bcc2 100644 --- a/docs/source/Getting-started-guide.rst +++ b/docs/source/Getting-started-guide.rst @@ -71,23 +71,23 @@ Bifrost and confirmed to be working. "Ubuntu 20.04","5.4.0-177-generic","520.61.05","RTX 2080Ti","11.1.1","Working" "Ubuntu 20.04","5.4.0-177-generic","520.61.05","RTX 2080Ti","11.2.2","Working" "Ubuntu 20.04","5.4.0-177-generic","520.61.05","RTX 2080Ti","11.3.1","Working" - "Ubuntu 20.04","5.4.0-186-generic","470.239.06","Quadro K2200","11.4.4","Likely Working" + "Ubuntu 20.04","5.4.0-186-generic","470.239.06","Quadro K2200","11.4.4","Working" "Ubuntu 20.04","5.4.0-186-generic","470.239.06","Quadro K2200","11.5.2","CUDA_ERROR_UNSUPPORTED_PTX_VERSION" - "Ubuntu 20.04","5.4.0-186-generic","495.29.05","Quadro K2200","11.5.2","Likely Working" + "Ubuntu 20.04","5.4.0-186-generic","495.29.05","Quadro K2200","11.5.2","Working" "Ubuntu 18.04","4.15.0-88-generic","510.85.02","A4000","11.6.124","Working" "Ubuntu 18.04","4.15.0-88-generic","510.85.02","RTX 2080Ti","11.6.124","Working" "Ubuntu 20.04","4.4.0-174-generic","525.147.05","Titan RTX","11.6.55","Working" "Debian 12","6.1.0-21-amd64","525.147.05 ","Quadro K2200","11.8.0","CUDA Install Failed" - "Ubuntu 20.04","5.4.0-186-generic","520.61.05","Quadro K2200","11.8.0","Likely Working" - "Debian 12","6.1.0-21-amd64","525.147.05 ","Quadro K2200","12.0.0","Likely Working" + "Ubuntu 20.04","5.4.0-186-generic","520.61.05","Quadro K2200","11.8.0","Known FIR and FFT Problems" + "Debian 12","6.1.0-21-amd64","525.147.05 ","Quadro K2200","12.0.0","Working" "Ubuntu 20.04","5.4.0-147-generic","525.125.06","A5000","12.0.140","Working" "Ubuntu 20.04","5.4.0-144-generic","525.125.06","A5000","12.0.140","Working" "Ubuntu 20.04","5.4.0-144-generic","525.147.05","A4000","12.0.140","Working" "Debian 12","6.1.0-21-amd64","525.147.05 ","Quadro K2200","12.1.0","CUDA_ERROR_UNSUPPORTED_PTX_VERSION" - "Debian 12","6.1.0-21-amd64","530.30.02","Quadro K2200","12.1.1","Likely Working" + "Debian 12","6.1.0-21-amd64","530.30.02","Quadro K2200","12.1.1","Working" "Debian 12","6.1.0-21-amd64","535.104.05","Quadro K2200","12.2.2","FFT bug: zeroed out data" - "Debian 12","6.1.0-21-amd64","545.23.08","Quadro K2200","12.3.2","Likely Working" - "Debian 12","6.1.0-21-amd64","550.54.15","Quadro K2200","12.4.1","Likely Working" + "Debian 12","6.1.0-21-amd64","545.23.08","Quadro K2200","12.3.2","Working" + "Debian 12","6.1.0-21-amd64","550.54.15","Quadro K2200","12.4.1","Working" "Ubuntu 22.04","5.15.0-106-generic","555.42.06","GTX 980","12.5","Working" Other Dependencies From ac9b7ab31ba02333bf87d23cd5390fc8c0b28267 Mon Sep 17 00:00:00 2001 From: jaycedowell Date: Mon, 22 Jul 2024 14:38:18 -0600 Subject: [PATCH 8/9] Remove entries that are install/version mis-match problems. --- docs/source/Getting-started-guide.rst | 3 --- 1 file changed, 3 deletions(-) diff --git a/docs/source/Getting-started-guide.rst b/docs/source/Getting-started-guide.rst index 63575bcc2..4f24cba3b 100644 --- a/docs/source/Getting-started-guide.rst +++ b/docs/source/Getting-started-guide.rst @@ -72,18 +72,15 @@ Bifrost and confirmed to be working. "Ubuntu 20.04","5.4.0-177-generic","520.61.05","RTX 2080Ti","11.2.2","Working" "Ubuntu 20.04","5.4.0-177-generic","520.61.05","RTX 2080Ti","11.3.1","Working" "Ubuntu 20.04","5.4.0-186-generic","470.239.06","Quadro K2200","11.4.4","Working" - "Ubuntu 20.04","5.4.0-186-generic","470.239.06","Quadro K2200","11.5.2","CUDA_ERROR_UNSUPPORTED_PTX_VERSION" "Ubuntu 20.04","5.4.0-186-generic","495.29.05","Quadro K2200","11.5.2","Working" "Ubuntu 18.04","4.15.0-88-generic","510.85.02","A4000","11.6.124","Working" "Ubuntu 18.04","4.15.0-88-generic","510.85.02","RTX 2080Ti","11.6.124","Working" "Ubuntu 20.04","4.4.0-174-generic","525.147.05","Titan RTX","11.6.55","Working" - "Debian 12","6.1.0-21-amd64","525.147.05 ","Quadro K2200","11.8.0","CUDA Install Failed" "Ubuntu 20.04","5.4.0-186-generic","520.61.05","Quadro K2200","11.8.0","Known FIR and FFT Problems" "Debian 12","6.1.0-21-amd64","525.147.05 ","Quadro K2200","12.0.0","Working" "Ubuntu 20.04","5.4.0-147-generic","525.125.06","A5000","12.0.140","Working" "Ubuntu 20.04","5.4.0-144-generic","525.125.06","A5000","12.0.140","Working" "Ubuntu 20.04","5.4.0-144-generic","525.147.05","A4000","12.0.140","Working" - "Debian 12","6.1.0-21-amd64","525.147.05 ","Quadro K2200","12.1.0","CUDA_ERROR_UNSUPPORTED_PTX_VERSION" "Debian 12","6.1.0-21-amd64","530.30.02","Quadro K2200","12.1.1","Working" "Debian 12","6.1.0-21-amd64","535.104.05","Quadro K2200","12.2.2","FFT bug: zeroed out data" "Debian 12","6.1.0-21-amd64","545.23.08","Quadro K2200","12.3.2","Working" From 70eb3395b8c7f1c8787e1867e49ba32b14b35b38 Mon Sep 17 00:00:00 2001 From: jaycedowell Date: Wed, 24 Jul 2024 10:00:51 -0600 Subject: [PATCH 9/9] More wording. --- docs/source/Getting-started-guide.rst | 9 ++++++--- 1 file changed, 6 insertions(+), 3 deletions(-) diff --git a/docs/source/Getting-started-guide.rst b/docs/source/Getting-started-guide.rst index 4f24cba3b..a12cd80bb 100644 --- a/docs/source/Getting-started-guide.rst +++ b/docs/source/Getting-started-guide.rst @@ -59,9 +59,12 @@ experience, you can come back here for a speedup. If you are ready to work with a GPU, you will want to get the newest `CUDA toolkit `__. Follow -the operating system-specific instructions to install. Note -the table below indicating what CUDA versions have been tested with -Bifrost and confirmed to be working. +the operating system-specific instructions to install. Be sure to install a +kernel driver that works with the version of toolkit that you are using since +version mismatches can lead to runtime errors. + +The table below indicates which CUDA toolkit and kernel driver versions Bifrost +has been tested against. .. csv-table:: :header: "OS","Linux Kernel","Driver Version","GPU","Toolkit","Status"