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:
Andres Rodriguez
2016-04-18 15:56:37 -04:00
parent 67dc88974f
commit aea605f0ef

View File

@@ -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