====== Ubuntu - GPU - AMD GPU - Troubleshooting - System will not boot ======

===== Problem =====

Booting the system freeze immediately.  It may show:

<code>
/dev/nvme0n1p2:  clean...
...recovering journal
</code>

but does not continue.

----

===== Likely reason for the issue =====

<WRAP info>
**NOTE:** There is a missing kernel module.

  * Try to install the missing kernel modules.

</WRAP>

----

===== Fix =====

  - Force power off.
  - Wait 10 seconds
  - Restart.
  - Continually press and release **shift** button.
  - This should display the Grub menu.
  - Select the latest **Recovery** kernel to boot.
  - This should display a list of options.
  - Select **Root**.
  - Press **<Enter>** to get into a shell.


----

==== Add Kisak (optional) ====

<code bash>
sudo add-apt-respository ppa:kisak/kisak-mesa
sudo apt update
sudo apt upgrade
</code>

<WRAP info>
**NOTE:**  This will install the latest **stable** MESA-driver.

  * See:  https://launchpad.net/~kisak/+archive/ubuntu/kisak-mesa
</WRAP>

----

=== Force the use of the Kisak resposity for MESA ===

<code bash>
sudo vi /etc/apt/preferences.d/kisak-pin-2000 
</code>

and populate with:

<file bash>
Package: *
Pin: release o=LP-PPA-kisak-kisak-mesa
Pin-Priority: 2000
</file>

and update again:

<code bash>
sudo apt update
sudo apt upgrade
</code>

----

===== Download the latest firmware =====

<code>
mkdir /home/peter/amdgpu
cd /home/peter/amdgpu
git clone https://git.kernel.org/pub/scm/linux//kernel/git/firmware/linux-firmware.git
</code>

<WRAP info>
**NOTE:**  The **/home/peter/amdgpu** directory here is just a temporary directory.

  * The **git** command will download the firmware into a sub-directory named **linux-firmware** within the **/home/peter/amdgpu** directory.

  * If **git** command does not work, download the newest tar.gz file manually from https://git.kernel.org/pub/scm/linux//kernel/git/firmware/linux-firmware.git

</WRAP>

----

===== Backup the existing firmware directory =====

<code bash>
mkdir bak
sudo cp -R /lib/firmware/amdgpu bak
</code>

<WRAP info>
**NOTE:**  This backup can be used, just in case this is needed.
</WRAP>

----

===== Place the latest firmware into the firmware directory =====

<code bash>
sudo cp linux-firmware/amdgpu/* /lib/firmware/amdgpu
</code>

<WRAP info>
**NOTE:**  This will copy the amdgpu drivers from **/home/peter/amdgpu/linux-firmware** directory, to **/lib/firmware/amdgpu**.
</WRAP>

----

===== Rebuild the initramfs =====

<code bash>
sudo update-initramfs -c -k $(uname -r)
</code>

----

===== Reboot =====

<code bash>
sudo shutdown -r now
</code>

----

===== Housekeeping (Optional) =====

Remove the temporary directories that were created for this fix.

<code bash>
sudo rm -Rf /home/peter/amdgpu
</code>

----

===== References =====

https://git.kernel.org/pub/scm/linux//kernel/git/firmware/linux-firmware.git

https://launchpad.net/~kisak/+archive/ubuntu/kisak-mesa