rocm-systems/projects/rdc/Docker/README.md

# Setup Instructions for AMDSMI and RDC Images

Follow these steps to set up both the AMDSMI and RDC images.

## Prerequisites

Ensure you have the necessary permissions and tools installed to clone repositories and build Docker images.

## Step 1: Clone Repositories

Download the latest AMDSMI and RDC repositories using the following commands:

### AMDSMI

```bash
git clone https://github.com/ROCm/amdsmi.git
```

### RDC 

```bash
git clone https://github.com/ROCm/rocm-systems.git --recursive
```

## Step 2: Build AMDSMI Base Image

1. Navigate to the `amdsmi` directory on your system.
2. Build the Docker image using the following command:

   ```bash
   docker build -t amdsmi-image .
   ```

## Step 3: Build RDC Image

1. Navigate to the `rocm-systems/projects/rdc` directory on your system.
2. Navigate into the `/Docker` directory.
3. Build the Docker image using the following command:

   ```bash
   docker build -t rdc-image .
   ```

## Step 4: Run RDC Image

To run the RDC image, use the following command:

```bash
docker run rdc-image
```

If the above command does not work, try the following:

1. Run the image with a bash entry point:

   ```bash
   docker run -it --entrypoint /bin/bash rdc-image
   ```

2. Once inside the container, run the following command:

   ```bash
   sudo /opt/rocm/bin/rdcd -u
   ```

## Step 5: Run AMDSMI Image (optional)

To be able to run AMDSMI commands inside of the image run the following:

```bash
sudo docker run --rm -ti \
        --privileged \
        --volume $(realpath ./):/src:rw \
        amdsmi-image
```
> [!IMPORTANT]
> Make sure that you are in the `amdsmi` directory before running.