derek.holloway
7502bf64a4
CodeQL / Analyze (actions) (push) Canceled after 0s
CodeQL / Analyze (python) (push) Canceled after 0s
pre-commit / pre-commit (push) Canceled after 0s
Multi-Arch CI / setup (push) Canceled after 0s
Publish build_manylinux_x86_64 images / publish_build_manylinux_x86_64 (push) Canceled after 0s
Setup (Multi-Arch) / setup (push) Canceled after 0s
Multi-Arch CI / Linux::${{ fromJSON(needs.setup.outputs.linux_build_config || '{}').build_variant_label || 'skip' }} (push) Canceled after 0s
Publish TheRock Docker image / build-and-push-image (push) Canceled after 0s
Publish no_rocm_image_ubi10 image / publish_no_rocm_image_ubi10 (push) Canceled after 0s
Multi-Arch CI / Windows::${{ fromJSON(needs.setup.outputs.windows_build_config || '{}').build_variant_label || 'skip' }} (push) Canceled after 0s
Publish TheRock Docker image / build-and-push-image (push) Canceled after 0s
Multi-Arch CI / Manifest Diff (push) Canceled after 0s
TheRock Manifest Diff Report / Generate Manifest Diff Report (push) Canceled after 0s
Multi-Arch CI / CI Summary (push) Canceled after 0s
Publish no_rocm_image_ubuntu24_04 images / publish_no_rocm_image_ubuntu24_04 (push) Canceled after 0s
Publish no_rocm_image_ubuntu24_04_ocl_rt images / publish_no_rocm_image_ubuntu24_04_ocl_rt (push) Canceled after 0s
Publish TheRock Docker image / build-and-push-image (push) Canceled after 0s
Publish TheRock Docker image / build-and-push-image (push) Canceled after 0s
Publish no_rocm_image_ubuntu24_04 images / publish_no_rocm_image_ubuntu24_04_rocgdb (push) Canceled after 0s
Publish no_rocm_image_ubuntu24_04_rocgdb images / publish_no_rocm_image_ubuntu24_04_rocgdb (push) Canceled after 0s
Publish no_rocm_image_ubuntu24_04 images / publish_no_rocm_image_ubuntu24_04_ocl_rt (push) Canceled after 0s
Publish TheRock Docker image / build-and-push-image (push) Canceled after 0s
Unit Tests / Unit Tests :: ubuntu-24.04 (push) Canceled after 0s
Unit Tests / Unit Tests :: windows-2022 (push) Canceled after 0s
Publish no_rocm_image_ubuntu24_04 images / publish_no_rocm_image_ubuntu24_04_media (push) Canceled after 0s
Unit Tests / Unit Tests Summary (push) Canceled after 0s
Publish no_rocm_image_ubuntu24_04 images / publish_no_rocm_image_ubuntu24_04_openmpi (push) Canceled after 0s
72 lines
2.3 KiB
ReStructuredText
72 lines
2.3 KiB
ReStructuredText
.. meta::
|
|
:description: documentation of the installation, configuration, and use of the ROCm Data Center tool
|
|
:keywords: ROCm Data Center tool, RDC, ROCm, API, reference, data type, support
|
|
|
|
.. _rdc-use:
|
|
|
|
******************************************
|
|
Introduction to the RDC tool
|
|
******************************************
|
|
|
|
The ROCm Data Center tool (RDC) simplifies the administration and addresses key infrastructure challenges in AMD GPUs in cluster and datacenter environments. The main features are:
|
|
|
|
* GPU telemetry
|
|
* GPU statistics for jobs
|
|
* Integration with third-party tools
|
|
* Open source
|
|
|
|
You can use the RDC tool in standalone mode if all components are installed. However, the existing management tools can use the same set of features available in a library format.
|
|
|
|
For details on different modes of operation, refer to *Starting RDC* in :ref:`rdc-install`.
|
|
|
|
Target Audience
|
|
===============
|
|
|
|
The audience for the AMD RDC tool consists of:
|
|
|
|
* Administrators: RDC provides the cluster administrator with the capability of monitoring, validating, and configuring policies.
|
|
* HPC Users: Provides GPU-centric feedback for their workload submissions.
|
|
* OEM: Add GPU information to their existing cluster management software.
|
|
* Open source Contributors: RDC is open source and accepts contributions from the community.
|
|
|
|
Objective
|
|
=========
|
|
|
|
This documentation will:
|
|
|
|
#. Introduce the tool features in :ref:`rdc-features`
|
|
#. Describe integration with external tools in :ref:`rdc-3rd-party`
|
|
#. Provide an open source handbook in :ref:`rdc-handbook`
|
|
#. Introduce elements of the tool API in :ref:`api-intro`
|
|
|
|
Terminology
|
|
===========
|
|
|
|
.. list-table:: Terminologies and Abbreviations
|
|
|
|
* - **Terms**
|
|
- **Description**
|
|
|
|
* - RDC
|
|
- ROCm Data Center tool
|
|
|
|
* - Compute node (CN)
|
|
- One of many nodes containing one or more GPUs in the Data Center on which compute jobs are run
|
|
|
|
* - Management node (MN) or Main console
|
|
- A machine running system administration applications to administer and manage the Data Center
|
|
|
|
* - GPU Groups
|
|
- Logical grouping of one or more GPUs in a compute node
|
|
|
|
* - Fields
|
|
- A metric that can be monitored by the RDC, such as GPU temperature, memory usage, and power usage
|
|
|
|
* - Field Groups
|
|
- Logical grouping of multiple fields
|
|
|
|
* - Job
|
|
- A workload that is submitted to one or more compute nodes
|
|
|
|
|