mirror of
https://github.com/ROCm/ROCm.git
synced 2026-01-09 14:48:06 -05:00
readme: add instruction to remove pre-release packages
Add a new section that outlines how to remove pre-release packages to avoid conflicts during installation.
This commit is contained in:
57
README.md
57
README.md
@@ -45,6 +45,8 @@ packages in both repositories have been signed to ensure package integrity.
|
|||||||
Directions for each repository are given below:
|
Directions for each repository are given below:
|
||||||
|
|
||||||
#### Debian repository - apt-get
|
#### Debian repository - apt-get
|
||||||
|
|
||||||
|
##### Add the ROCm apt repository
|
||||||
For Debian based systems, like Ubuntu, configure the Debian ROCm repository as
|
For Debian based systems, like Ubuntu, configure the Debian ROCm repository as
|
||||||
follows:
|
follows:
|
||||||
|
|
||||||
@@ -53,27 +55,62 @@ wget -qO - http://atlpackages01.amd.com:81/rocm/apt/debian/rocm.gpg.key | sudo a
|
|||||||
sudo sh -c 'echo deb [arch=amd64] http://atlpackages01.amd.com:81/rocm/apt/debian/ trusty main > /etc/apt/sources.list.d/rocm.list'
|
sudo sh -c 'echo deb [arch=amd64] http://atlpackages01.amd.com:81/rocm/apt/debian/ trusty main > /etc/apt/sources.list.d/rocm.list'
|
||||||
```
|
```
|
||||||
|
|
||||||
Finally, update the apt-get repository list and install the rocm-rel driver
|
##### Install or Update
|
||||||
package and the rocm-dev development package:
|
Next, update the apt-get repository list and install/update the rocm package:
|
||||||
|
|
||||||
|
>**Warning**: Before proceeding, make sure to completely
|
||||||
|
>[uninstall any pre-release ROCm packages](https://github.com/RadeonOpenCompute/ROCm#removing-pre-release-packages):
|
||||||
|
|
||||||
```shell
|
```shell
|
||||||
sudo apt-get update
|
sudo apt-get update
|
||||||
sudo apt-get install rocm-rel
|
sudo apt-get install rocm
|
||||||
sudo apt-get install rocm-dev
|
|
||||||
```
|
```
|
||||||
|
|
||||||
|
##### Un-install
|
||||||
To un-install the entire rocm-dev development package execute:
|
To un-install the entire rocm-dev development package execute:
|
||||||
|
|
||||||
```shell
|
```shell
|
||||||
sudo apt-get autoremove rocm-dev
|
sudo apt-get autoremove rocm
|
||||||
```
|
```
|
||||||
The rocm driver package can be un-installed in a similar way, but the kernel
|
|
||||||
images will remain on the system because apt-get will never remove old kernels
|
##### Installing development packages for cross compilation
|
||||||
by default (refer to the file /etc/apt/apt.conf.d/01autoremove-kernels). Kernel
|
It is often useful to develop and test on different systems. In this scenario,
|
||||||
images can be removed manually using dpkg or apt-get directly on the package
|
you may prefer to avoid installing the ROCm Kernel to your development system.
|
||||||
names.
|
|
||||||
|
In this case, install the development subset of packages:
|
||||||
|
|
||||||
|
```shell
|
||||||
|
sudo apt-get update
|
||||||
|
sudo apt-get install rocm-dev
|
||||||
|
```
|
||||||
|
|
||||||
|
>**Note:** To execute ROCm enabled apps you will require a system with the full
|
||||||
|
>ROCm driver stack installed
|
||||||
|
|
||||||
|
##### Removing pre-release packages
|
||||||
|
If you installed any of the ROCm pre-release packages from github, they will
|
||||||
|
need to be manually un-installed:
|
||||||
|
|
||||||
|
```shell
|
||||||
|
sudo apt-get purge libhsakmt
|
||||||
|
```
|
||||||
|
```shell
|
||||||
|
for package in $(dpkg -l | grep 'kfd\|rocm' | grep linux | grep -v libc | awk '{print $2}');do
|
||||||
|
echo "=== Removing $package ==="
|
||||||
|
sudo apt-get purge $package
|
||||||
|
done
|
||||||
|
```
|
||||||
|
|
||||||
|
If possible, we would recommend starting with a fresh OS install.
|
||||||
|
|
||||||
#### RPM repository - dnf (yum)
|
#### RPM repository - dnf (yum)
|
||||||
|
|
||||||
|
##### Add the AMD apt repository
|
||||||
|
##### Install or Update
|
||||||
|
##### Un-install
|
||||||
|
##### Installing development packages for cross compilation
|
||||||
|
|
||||||
|
|
||||||
#### Closed Source Components
|
#### Closed Source Components
|
||||||
The ROCm platform relies on a few closed source components to provide legacy
|
The ROCm platform relies on a few closed source components to provide legacy
|
||||||
functionality like HSAIL finalization and debugging/profiling support. These
|
functionality like HSAIL finalization and debugging/profiling support. These
|
||||||
|
|||||||
Reference in New Issue
Block a user