HIP can be installed either on AMD ROCm platform with HIP-Clang compiler, or a CUDA platform with nvcc installed.
Note: The version definition for the HIP runtime is different from CUDA. Users can use hipRuntimeGerVersion function, on the AMD platform it returns the HIP runtime version, while on the NVIDIA platform, it returns the CUDA runtime version. There is no mapping or correlation between the HIP version and CUDA version.
On AMD platform, see Prerequisite Actions in ROCm_Installation_Guide (https://docs.amd.com/) for the release. On NVIDIA platform, check system requirements in NVIDIA CUDA Installation Guide at https://docs.nvidia.com/cuda/cuda-installation-guide-linux/.
HIP is part of ROCM packages, it will be automatically installed following the ROCm Installation Guide on AMD public documentation site (https://docs.amd.com/) for the coresponding ROCm release.
By default, HIP is installed into /opt/rocm/hip.
Install Nvidia Driver
sudo apt-get install ubuntu-drivers-common && sudo ubuntu-drivers autoinstall
Or download the latest cuda-toolkit at https://developer.nvidia.com/cuda-downloads The driver will be installed automatically.
Add the ROCm package server to your system as per the OS-specific guide in ROCm Installation Guide (https://docs.amd.com/) for the release.
Install the “hip-runtime-nvidia” and “hip-dev” package. This will install CUDA SDK and the HIP porting layer.
apt-get install hip-runtime-nvidia hip-dev
By default HIP looks for CUDA SDK in /usr/local/cuda.
By default HIP is installed into /opt/rocm/hip.
Optionally, consider adding /opt/rocm/bin to your path to make it easier to use the tools.
Verify your installation#
Run hipconfig (instructions below assume default installation path) :
How to build HIP from source#
Developers can build HIP from source on either AMD or NVIDIA platforms, see detailed instructions at /developer_guide/build