USAGE:(1)

NAME
usage: - ROCm Deployment Health Check tool

DESCRIPTION
usage: ./rdhc.py [options]

ROCm Deployment Health Check Tool

  options:

-h, --help
    show this help message and exit

--quick
    Run quick tests only (default)

--all
    Default tests + Compile and executes simple program for each component.

-v, --verbose
    Enable verbose output

-s, --silent
    Silent mode (errors only)

-j, --json FILE
    Export results to JSON file

-d, --dir DIR
    Directory path for temporary files. Must not already exist; will be created with mode 0700. Default: autogenerated secure temp directory in /tmp (not autocleaned). To reuse a directory, remove it first: rm -rf <dir>

--cleanup
    Remove auto-generated temp directory after tests complete (only applies when -d is not specified)

--rocm-install-prefix DIR
    ROCm installation prefix. If set, overrides ROCM_PATH; otherwise ROCM_PATH or /opt/rocm is used.

--skip-multinode-readiness
    Skip multinode/RDMA readiness (use on nodes without InfiniBand or RDMA stack).

--skip-atomic-operations
    Skip PCIe atomic operations check (use in containers or when lspci cannot read capabilities).

--skip-optional-cluster-checks
    Skip multinode readiness and atomic operations (same as both --skip-* flags above).

--kernel-params-warnings-only
    For kernel parameter checks (numa, iommu, pci realloc, etc.), treat failures as warnings (is_error=false) instead of counting errors.

Refer the README @<ROCM_INSTALL_PATH>/share/rdhc/README.md Usage examples: # Run quick test (default tests only) ./rdhc.py

# Run all tests including compile and execute the rocm-example program for each component ./rdhc.py --all

# Run all tests with verbose output ./rdhc.py --all -v

# Enable verbose output ./rdhc.py -v

# Run in silent mode (only errors shown) ./rdhc.py -s

# Export results to a specific JSON file ./rdhc.py --all --json rdhc-results.json

# Specify a directory for temp files (directory must not exist) ./rdhc.py --all -d /home/user/rdhc-dir/

# Auto-generate temp directory and clean it up after tests ./rdhc.py --all --cleanup

# Use a custom ROCm install prefix ./rdhc.py --rocm-install-prefix /usr/local/rocm

# Skip optional checks (e.g. single-node, containers without full PCI/RDMA) ./rdhc.py --skip-optional-cluster-checks # (or: --skip-multinode-readiness --skip-atomic-operations)

# Kernel cmdline/sysctl checks: failures as warnings only (no FAIL on mismatch) ./rdhc.py --kernel-params-warnings-only

NOTE: Some checks require root privileges (e.g., lspci -vvv for atomic operations). Run as root when necessary, or use --skip-atomic-operations if running unprivileged.

NOTE for Ubuntu 24.04 (Python 3.12) users: Due to enhanced security policies, you must use a virtual environment:

    # Create and activate virtual environment (one-time setup) python3 -m venv ~/rdhc-venv source ~/rdhc-venv/bin/activate pip3 install -r requirements.txt

    # Run the tool ./rdhc.py ./rdhc.py --all

rdhc: error: unrecognized arguments: --version