From 0e9ae23dfe1e7b2879fe8331d5e691142e4b0667 Mon Sep 17 00:00:00 2001 From: Jiri Eischmann Date: May 22 2024 14:34:27 +0000 Subject: [PATCH 1/3] Initial Nvidia driver installation docs --- diff --git a/user-docs/modules/ROOT/assets/images/mok-util-01.png b/user-docs/modules/ROOT/assets/images/mok-util-01.png new file mode 100644 index 0000000..d35a5ed Binary files /dev/null and b/user-docs/modules/ROOT/assets/images/mok-util-01.png differ diff --git a/user-docs/modules/ROOT/assets/images/mok-util-02.png b/user-docs/modules/ROOT/assets/images/mok-util-02.png new file mode 100644 index 0000000..a764bdf Binary files /dev/null and b/user-docs/modules/ROOT/assets/images/mok-util-02.png differ diff --git a/user-docs/modules/ROOT/assets/images/mok-util-03.png b/user-docs/modules/ROOT/assets/images/mok-util-03.png new file mode 100644 index 0000000..317fda1 Binary files /dev/null and b/user-docs/modules/ROOT/assets/images/mok-util-03.png differ diff --git a/user-docs/modules/ROOT/assets/images/mok-util-04.png b/user-docs/modules/ROOT/assets/images/mok-util-04.png new file mode 100644 index 0000000..6d41738 Binary files /dev/null and b/user-docs/modules/ROOT/assets/images/mok-util-04.png differ diff --git a/user-docs/modules/ROOT/assets/images/mok-util-05.png b/user-docs/modules/ROOT/assets/images/mok-util-05.png new file mode 100644 index 0000000..86ca83b Binary files /dev/null and b/user-docs/modules/ROOT/assets/images/mok-util-05.png differ diff --git a/user-docs/modules/ROOT/assets/images/mok-util-06.png b/user-docs/modules/ROOT/assets/images/mok-util-06.png new file mode 100644 index 0000000..161f501 Binary files /dev/null and b/user-docs/modules/ROOT/assets/images/mok-util-06.png differ diff --git a/user-docs/modules/ROOT/assets/images/mok-util-07.png b/user-docs/modules/ROOT/assets/images/mok-util-07.png new file mode 100644 index 0000000..7916631 Binary files /dev/null and b/user-docs/modules/ROOT/assets/images/mok-util-07.png differ diff --git a/user-docs/modules/ROOT/pages/nvidia-install.adoc b/user-docs/modules/ROOT/pages/nvidia-install.adoc new file mode 100644 index 0000000..5a84dd7 --- /dev/null +++ b/user-docs/modules/ROOT/pages/nvidia-install.adoc @@ -0,0 +1,36 @@ += Nvidia Driver Installation + +This page includes information about the Nvidia driver installation in Fedora Workstation. + +== Prerequisities + +* https://docs.fedoraproject.org/en-US/workstation-working-group/third-party-repos/[The third-party repositories] are enabled. If you have not enabled them, you can do it in GNOME Software: Menu/Software Repositories. + +== Nvidia Driver Installation using Software + +== Nvidia Driver Installation using DNF + +== Enrolling Self-signing Key after Reboot + +In order to successfully reboot to Fedora Workstation after the Nvidia driver installation, you have to enroll the self-signing key you created during installation in GNOME Software. During rebooting you'll be presented with the mokutil tool, follow the below steps to enroll the key: + +1. Press any key to continue. +image:mok-util-01.png[mok-util-01.png,title="mokutil start screen"] + +2. Choose Enroll MOK. +image:mok-util-02.png[mok-util-02.png,title="mokutil start screen"] + +3. Choose "View key 0" to view the key. +image:mok-util-03.png[mok-util-03.png,title="mokutil start screen"] + +4. Verify the information fits and press Enter. +image:mok-util-04.png[mok-util-04.png,title="mokutil start screen"] + +5. Choose Yes to enroll the key. +image:mok-util-05.png[mok-util-05.png,title="mokutil start screen"] + +6. Type the password you created for the key during installation. +image:mok-util-06.png[mok-util-06.png,title="mokutil start screen"] + +7. Choose Reboot to reboot into the OS with the Nvidia drivers enabled. +image:mok-util-07.png[mok-util-07.png,title="mokutil start screen"] From f1a4c0a576985dbb1e822c9c02c4356983a18b48 Mon Sep 17 00:00:00 2001 From: Jiri Eischmann Date: Jun 03 2024 13:50:08 +0000 Subject: [PATCH 2/3] Changing the title, removing content that is not necessary --- diff --git a/user-docs/modules/ROOT/pages/key-enrollment.adoc b/user-docs/modules/ROOT/pages/key-enrollment.adoc new file mode 100644 index 0000000..ccf400c --- /dev/null +++ b/user-docs/modules/ROOT/pages/key-enrollment.adoc @@ -0,0 +1,35 @@ += Self-signing Key Enrollment + +This page documents how to enroll a self-signing key you created during the Nvidia driver installation (typically in GNOME Software). + +== Prerequisite + +You've installed the Nvidia driver and created a key to self-sign it in GNOME Software (or a similar tool that supports it). + +== Enrolling Self-signing Key after Reboot + +In order to successfully reboot to Fedora Workstation after the Nvidia driver installation, you have to enroll the self-signing key you created during installation in GNOME Software. During rebooting you'll be presented with the mokutil tool, follow the below steps to enroll the key: + +1. Press any key to continue. +image:mok-util-01.png[mok-util-01.png,title="mokutil start screen"] + +2. Choose Enroll MOK. +image:mok-util-02.png[mok-util-02.png,title="mokutil start screen"] + +3. Choose "Continue" to proceed to the enrollment. +image:mok-util-03.png[mok-util-03.png,title="mokutil start screen"] + +//// +This step is commented out because the verification isn't currently supported. +4. Verify the information fits and press Enter. +image:mok-util-04.png[mok-util-04.png,title="mokutil start screen"] +//// + +4. Choose "Yes" to enroll the key. +image:mok-util-05.png[mok-util-05.png,title="mokutil start screen"] + +5. Type the password you created for the key during installation. +image:mok-util-06.png[mok-util-06.png,title="mokutil start screen"] + +6. Choose Reboot to reboot into the OS with the Nvidia drivers enabled. +image:mok-util-07.png[mok-util-07.png,title="mokutil start screen"] diff --git a/user-docs/modules/ROOT/pages/nvidia-install.adoc b/user-docs/modules/ROOT/pages/nvidia-install.adoc deleted file mode 100644 index 5a84dd7..0000000 --- a/user-docs/modules/ROOT/pages/nvidia-install.adoc +++ /dev/null @@ -1,36 +0,0 @@ -= Nvidia Driver Installation - -This page includes information about the Nvidia driver installation in Fedora Workstation. - -== Prerequisities - -* https://docs.fedoraproject.org/en-US/workstation-working-group/third-party-repos/[The third-party repositories] are enabled. If you have not enabled them, you can do it in GNOME Software: Menu/Software Repositories. - -== Nvidia Driver Installation using Software - -== Nvidia Driver Installation using DNF - -== Enrolling Self-signing Key after Reboot - -In order to successfully reboot to Fedora Workstation after the Nvidia driver installation, you have to enroll the self-signing key you created during installation in GNOME Software. During rebooting you'll be presented with the mokutil tool, follow the below steps to enroll the key: - -1. Press any key to continue. -image:mok-util-01.png[mok-util-01.png,title="mokutil start screen"] - -2. Choose Enroll MOK. -image:mok-util-02.png[mok-util-02.png,title="mokutil start screen"] - -3. Choose "View key 0" to view the key. -image:mok-util-03.png[mok-util-03.png,title="mokutil start screen"] - -4. Verify the information fits and press Enter. -image:mok-util-04.png[mok-util-04.png,title="mokutil start screen"] - -5. Choose Yes to enroll the key. -image:mok-util-05.png[mok-util-05.png,title="mokutil start screen"] - -6. Type the password you created for the key during installation. -image:mok-util-06.png[mok-util-06.png,title="mokutil start screen"] - -7. Choose Reboot to reboot into the OS with the Nvidia drivers enabled. -image:mok-util-07.png[mok-util-07.png,title="mokutil start screen"] From 86c1cda1ccbc3e6d9677ac370247a9d03ff74a54 Mon Sep 17 00:00:00 2001 From: Jiri Eischmann Date: Jun 03 2024 14:32:11 +0000 Subject: [PATCH 3/3] Fine-tuning the enrollment document and changing two screenshots to have the intented options selected --- diff --git a/user-docs/modules/ROOT/assets/images/mok-util-02.png b/user-docs/modules/ROOT/assets/images/mok-util-02.png index a764bdf..b4353fd 100644 Binary files a/user-docs/modules/ROOT/assets/images/mok-util-02.png and b/user-docs/modules/ROOT/assets/images/mok-util-02.png differ diff --git a/user-docs/modules/ROOT/assets/images/mok-util-03.png b/user-docs/modules/ROOT/assets/images/mok-util-03.png index 317fda1..86ab5fe 100644 Binary files a/user-docs/modules/ROOT/assets/images/mok-util-03.png and b/user-docs/modules/ROOT/assets/images/mok-util-03.png differ diff --git a/user-docs/modules/ROOT/pages/key-enrollment.adoc b/user-docs/modules/ROOT/pages/key-enrollment.adoc index ccf400c..2abbd3c 100644 --- a/user-docs/modules/ROOT/pages/key-enrollment.adoc +++ b/user-docs/modules/ROOT/pages/key-enrollment.adoc @@ -1,23 +1,23 @@ = Self-signing Key Enrollment -This page documents how to enroll a self-signing key you created during the Nvidia driver installation (typically in GNOME Software). +This page documents how to enroll a machine owner key that is created during the Nvidia driver installation (typically in GNOME Software). == Prerequisite -You've installed the Nvidia driver and created a key to self-sign it in GNOME Software (or a similar tool that supports it). +The Nvidia driver has been installed and a machine owner key to self-sign the driver has been created in GNOME Software (or in a similar tool that supports it). == Enrolling Self-signing Key after Reboot -In order to successfully reboot to Fedora Workstation after the Nvidia driver installation, you have to enroll the self-signing key you created during installation in GNOME Software. During rebooting you'll be presented with the mokutil tool, follow the below steps to enroll the key: +In order to successfully reboot to Fedora Workstation after the Nvidia driver installation, you have to enroll the machine owner key you created during installation in GNOME Software. During rebooting you'll be presented with the mokutil tool, follow the below steps to enroll the key: 1. Press any key to continue. -image:mok-util-01.png[mok-util-01.png,title="mokutil start screen"] +image:mok-util-01.png[mok-util-01.png,title="Shim UEFI key management"] -2. Choose Enroll MOK. -image:mok-util-02.png[mok-util-02.png,title="mokutil start screen"] +2. Select *Enroll MOK*. +image:mok-util-02.png[mok-util-02.png,title="Perform MOK management"] -3. Choose "Continue" to proceed to the enrollment. -image:mok-util-03.png[mok-util-03.png,title="mokutil start screen"] +3. Select *Continue* to proceed to the enrollment. +image:mok-util-03.png[mok-util-03.png,title="Enroll MOK"] //// This step is commented out because the verification isn't currently supported. @@ -25,11 +25,11 @@ This step is commented out because the verification isn't currently supported. image:mok-util-04.png[mok-util-04.png,title="mokutil start screen"] //// -4. Choose "Yes" to enroll the key. -image:mok-util-05.png[mok-util-05.png,title="mokutil start screen"] +4. Select *Yes* to enroll the key. +image:mok-util-05.png[mok-util-05.png,title="Enroll the key(s)?"] 5. Type the password you created for the key during installation. image:mok-util-06.png[mok-util-06.png,title="mokutil start screen"] -6. Choose Reboot to reboot into the OS with the Nvidia drivers enabled. -image:mok-util-07.png[mok-util-07.png,title="mokutil start screen"] +6. Select *Reboot* to reboot into the OS with the Nvidia drivers enabled. +image:mok-util-07.png[mok-util-07.png,title="Enroll the key(s) - Password"]