The hip-devel package depends on perl modules not distributed by default
on RHEL and SLES distriubutions, these can be installed from EPEL and
the `devel:languages:perl` repository respectively.
Ideally in the future these dependencies would be replaced with packages
available from default repositories, but in the meanwhile this should
be at least documented.
* Remove install instructions for unsuported RHEL 8.8 and 9.2
Current ROCm release does not support these versions of RHEL
* Centralize disclaimers and perquisites for installation
- Move the single-version to multi-version diclaimer to the install
overview page where single vs multi installs are discussed.
- Move the installation of kernel-headers and development packages
to the install preparation page. Unify it mainly from the quick start
content.
* s/Name/name/ in repository config files for RHEL
The repository name can be set as `name=><name>` instead of `Name`,
otherwise yum complains about the repo not having a name, e.g:
```output
Repository 'ROCm-5.3.3' is missing name in configuration, using id.
```
This is fixed with this commit.
* Clean up render/video group section on prerequisites
* Installation and Upgrade restructuring & fixes
- Fix the rocm package urls for RHEL in the install & upgrade guides
- RHEL8 and 9 have different URLs, add a tab-set similar to ubuntu
for them.
- Fix the package URL in the upgrade guide for SLES (previously pointed
to the amdgpu url)
- Change the apt-signing key download and conversion to the method used
in the quick start guide, which is the recommended by ubuntu maintainers
- Change the install steps from list items to rubrics with numbered entries
which is more readable and matches the style in the quick start guide
- Do not pass `--append` to `tee` in the upgrade guide, because it is
meant to overwrite.
- Split the one long tab-set to multiple tab-sets in the upgrade guide
to improve readability
Add empty cells to list tables to make them uniform (all rows have the
same number of cells), before this the tables errored out with:
> ERROR: Error parsing content block for the "list-table" directive:
> uniform two-level bullet list expected, but row 13 does not contain
> the same number of items as row 1 (3 vs 4)
and the table did not show up.
* ci: change markdown linting to use the NodeJs markdownlint
The original ruby based markdownlint has a few shortcomings not known
when it was introduced:
- no support for myst extensions
- no support for disabling specific rules for specific files or regions
These two combined make it very hard to use when used for this project
when it has false positives around myst extensions.
Luckily there's a NodeJS based version of markdownlint [1] supporting the
same ruleset that is more configurable:
- seems to support myst extensions better
- has an html comment based syntax to disable specific rules
The library seem to be better maintained too and with better tooling:
e.g. there's a vscode extension using the engine for local use:
markdownlint (DavidAnson.vscode-markdownlint).
[1]: https://github.com/DavidAnson/markdownlint
* docs: hotfix empty links
There are missing links in the docs, these should get fixed, but for now
they are just monkey patched to make CI happy.
* docs: fix links
---------
Co-authored-by: Nara Prasetya <nara@streamhpc.com>
* update the gpu-aware-mpi page
Three changes:
- add the ucx compatibility table
- add the --with-rocm=/opt/rocm option to the compilation of Open MPI
- add a section about how to compile and use UCC for collective
operations.
* Changing link to relative
* Update gpu_aware_mpi.md
---------
Co-authored-by: Saad Rahim <44449863+saadrahim@users.noreply.github.com>
* fix rocmcc link
* remove unused link
* remove unused linkcheck configs
* update amd smi section
add link to ami smi github
---------
Co-authored-by: Saad Rahim <44449863+saadrahim@users.noreply.github.com>
* update links to new docs and rename .sphinx dir to sphinx
* fix spelling and formatting
add new words to wordlist
remove empty headers
remove version number for ROCm in conf.py
fix typos
* add more formats to rtd config
