ROCm-docker/quick-start.md

Install rocm-kernel

• Installing ROCK kernel on Ubuntu 14.04
  • This step will eventually go away as newer linux kernel images trickle down into upcoming distros. Our kernel module developers (AMDGPU and AMDKFD) are contributing source back into the mainline linux kernel. This step of installing a ROCm specific kernel image is temporary.

wget -qO - http://packages.amd.com/rocm/apt/debian/rocm.gpg.key | sudo apt-key add -
sudo sh -c 'echo deb [arch=amd64] http://packages.amd.com/rocm/apt/debian/ trusty main  \
    > /etc/apt/sources.list.d/rocm.list'
sudo apt-get update && sudo apt-get install rocm-kernel

Build ROCm container using docker CLI

• Clone and build the container

git clone https://github.com/RadeonOpenCompute/ROCm-docker
cd ROCm-docker
sudo docker build -t rocm/rocm-terminal rocm-terminal
sudo docker run -it --rm --device="/dev/kfd" rocm/rocm-terminal

Build ROCm container using docker-compose

• Clone and build the container using docker-compose

git clone https://github.com/RadeonOpenCompute/ROCm-docker
cd ROCm-docker
sudo docker-compose run --rm rocm

Verify successful build of ROCm-docker container

• Verify a working container-based ROCm software stack
• After step #2 or #3, a bash login prompt to a running docker container should be available
  • hcc --version should display version information of the AMD heterogeneous compiler
• Execute sample application
  • cd /opt/rocm/hsa/sample
  • sudo make
  • ./vector-copy
• Text displaying successful creation of a GPU device, successful kernel compilation and successful shutdown should be printed to stdout