From 584884a8d42d1f656a8668a8d588e1440c6ec280 Mon Sep 17 00:00:00 2001 From: Paul Maconi Date: Nov 11 2024 01:49:31 +0000 Subject: [PATCH 1/6] Add link to disk image download URL and address language in the procedure in response to feeback from Emmanuel Seyman. --- diff --git a/docs/modules/ROOT/pages/virtualization/vm-install-diskimg-proxmox.adoc b/docs/modules/ROOT/pages/virtualization/vm-install-diskimg-proxmox.adoc index 7a226a9..beabed9 100644 --- a/docs/modules/ROOT/pages/virtualization/vm-install-diskimg-proxmox.adoc +++ b/docs/modules/ROOT/pages/virtualization/vm-install-diskimg-proxmox.adoc @@ -2,7 +2,7 @@ Paul Maconi :page-authors: {author}, {author_2} :revnumber: F41 -:revdate: 2024-11-02 +:revdate: 2024-11-10 :page-aliases: pages/virtualization-vm-install-fedoraserver-cockpit.adoc @@ -19,7 +19,7 @@ Paul Maconi [abstract] -This document outlines a method for installing Fedora Server from the qcow2 image as a virtual machine in the Proxmox Virtual Environment, henceforth simply Proxmox. VMs can be spun up very quickly after importing the disk image, saving much time and frustration. The setup used when writing this document may not match what yours, so certain details like file paths for the disk images may vary. +This document outlines a method for installing link:https://fedoraproject.org/server/download[Fedora Server from the qcow2 image] as a virtual machine in the Proxmox Virtual Environment, henceforth simply Proxmox. VMs can be spun up very quickly after importing the disk image, saving much time and frustration. The setup used when writing this document may not match what yours, so certain details like file paths for the disk images may vary. == Why Fedora Server on Proxmox @@ -44,7 +44,7 @@ Note: This document assumes that you have ssh access to a Proxmox node and that Before we create the VM, we will need to find and upload our disk image to the Proxmox node. In the screenshot below you can see that we explored the system to determine that it is using centralized NFS storage mounted at /mnt/pve/nfs-kraken, and we made a directory at some point called osimages to contain our disk images. -Once we sorted out the path, we uploaded the file via scp into the Proxmox node. `scp [image_filename] root@[node_name]:/path/to/images/[image_filename]` +Once you create a directory to house your disk images, you will need to upload the disk image file via scp into the Proxmox node. `scp [image_filename] root@[node_name]:/path/to/images/[image_filename]` image::virtualization/vm-proxmox-01.png[Upload Image File] From 2215139873c81c289c8e3a67577ac6461f299f60 Mon Sep 17 00:00:00 2001 From: Paul Maconi Date: Nov 11 2024 01:50:50 +0000 Subject: [PATCH 2/6] update .gitignore to ignore the preview.pid --- diff --git a/.gitignore b/.gitignore index 9f3ebf5..f4cbf72 100644 --- a/.gitignore +++ b/.gitignore @@ -1,3 +1,4 @@ build cache public +preview.pid From ef00a68eef9b8a18048094f21e50a96a3aea2594 Mon Sep 17 00:00:00 2001 From: Paul Maconi Date: Nov 11 2024 01:53:29 +0000 Subject: [PATCH 3/6] make server download url open in a new tab --- diff --git a/docs/modules/ROOT/pages/virtualization/vm-install-diskimg-proxmox.adoc b/docs/modules/ROOT/pages/virtualization/vm-install-diskimg-proxmox.adoc index beabed9..906ccb5 100644 --- a/docs/modules/ROOT/pages/virtualization/vm-install-diskimg-proxmox.adoc +++ b/docs/modules/ROOT/pages/virtualization/vm-install-diskimg-proxmox.adoc @@ -19,7 +19,7 @@ Paul Maconi [abstract] -This document outlines a method for installing link:https://fedoraproject.org/server/download[Fedora Server from the qcow2 image] as a virtual machine in the Proxmox Virtual Environment, henceforth simply Proxmox. VMs can be spun up very quickly after importing the disk image, saving much time and frustration. The setup used when writing this document may not match what yours, so certain details like file paths for the disk images may vary. +This document outlines a method for installing link:https://fedoraproject.org/server/download[Fedora Server from the qcow2 image^] as a virtual machine in the Proxmox Virtual Environment, henceforth simply Proxmox. VMs can be spun up very quickly after importing the disk image, saving much time and frustration. The setup used when writing this document may not match what yours, so certain details like file paths for the disk images may vary. == Why Fedora Server on Proxmox From 85bfcb6574a2b26aa431fb6afd5a8f052107a69f Mon Sep 17 00:00:00 2001 From: Paul Maconi Date: Nov 11 2024 14:50:06 +0000 Subject: [PATCH 4/6] convert terminal screenshots to text code blocks --- diff --git a/docs/modules/ROOT/pages/virtualization/vm-install-diskimg-proxmox.adoc b/docs/modules/ROOT/pages/virtualization/vm-install-diskimg-proxmox.adoc index 906ccb5..ca6e750 100644 --- a/docs/modules/ROOT/pages/virtualization/vm-install-diskimg-proxmox.adoc +++ b/docs/modules/ROOT/pages/virtualization/vm-install-diskimg-proxmox.adoc @@ -46,13 +46,68 @@ Before we create the VM, we will need to find and upload our disk image to the P Once you create a directory to house your disk images, you will need to upload the disk image file via scp into the Proxmox node. `scp [image_filename] root@[node_name]:/path/to/images/[image_filename]` -image::virtualization/vm-proxmox-01.png[Upload Image File] +[,shell] +---- +aggraxis@whirlwind:~$ cd Desktop/osimages/ +aggraxis@whirlwind:~/Desktop/osimages$ ls +Fedora-Server-KVM-41-1.4.x86_64.qcow2 +aggraxis@whirlwind:~/Desktop/osimages$ ssh root@pve-m-0 +root@pve-m-0's password: +Linux pve-m-0 6.8.12-2-pve #1 SMP PREEMPT_DYNAMIC PMX 6.8.12-2 (2024-09-05T10:03Z) x86_64 + +The programs included with the Debian GNU/Linux system are free software; +the exact distribution terms for each program are described in the +individual files in /usr/share/doc/*/copyright. + +Debian GNU/Linux comes with ABSOLUTELY NO WARRANTY, to the extent +permitted by applicable law. +Last login: Sat Nov 9 11:03:50 2024 +root@pve-m-0:~# ls -alh /mnt/pve/nfs-kraken/osimages/ +drwxrwxrwx 1 1026 users 462 Nov 11 08:20 . +drwxrwxrwx 1 root root 294 Apr 16 2024 .. +-rwxrwxrwx 1 1026 users 1.6G Apr 20 2024 fedora-coreos-39.20240322.3.1-qemu.x86_64.qcow2 +-rwxrwxrwx 1 1026 users 1.6G May 9 2024 fedora-coreos-40.20240416.3.1-qemu.x86_64.qcow2 +-rwxrwxrwx 1 1026 users 574M Apr 16 2024 Fedora-Server-KVM-39-1.5.x86_64.qcow2 +-rwxrwxrwx 1 1026 users 629M Apr 24 2024 Fedora-Server-KVM-40-1.14.x86_64.qcow2 +-rwxrwxrwx 1 1027 users 913M Aug 30 13:44 rhel-9.4-x86_64-kvm.qcow2 +root@pve-m-0:~# exit +logout +Connection to pve-m-0 closed. +aggraxis@whirlwind:~/Desktop/osimages$ scp Fedora-Server-KVM-41-1.4.x86_64.qcow2 root@pve-m-0:/mnt/pve/nfs-kraken/osimages/Fedora-Server-KVM-41-1.4.x86_64.qcow2 +root@pve-m-0's password: +Fedora-Server-KVM-41-1.4.x86_64.qcow2 100% 659MB 110.7MB/s 00:05 +aggraxis@whirlwind:~/Desktop/osimages$ +---- === Verify the image is in place While not completely necessary, we logged back in to the Proxmox node and verified that the file had actually uploaded to the target directory. We'll come back to this path later when it is time to import the disk image to a VM. -image::virtualization/vm-proxmox-02.png[Locate Image File] +[,shell] +---- +aggraxis@whirlwind:~/Desktop/osimages$ ssh root@pve-m-0 +root@pve-m-0's password: +Linux pve-m-0 6.8.12-2-pve #1 SMP PREEMPT_DYNAMIC PMX 6.8.12-2 (2024-09-05T10:03Z) x86_64 + +The programs included with the Debian GNU/Linux system are free software; +the exact distribution terms for each program are described in the +individual files in /usr/share/doc/*/copyright. + +Debian GNU/Linux comes with ABSOLUTELY NO WARRANTY, to the extent +permitted by applicable law. +Last login: Mon Nov 11 08:18:31 2024 from 192.168.218.217 +root@pve-m-0:~# ls -alh /mnt/pve/nfs-kraken/osimages/ +total 5.8G +drwxrwxrwx 1 1026 users 462 Nov 11 08:20 . +drwxrwxrwx 1 root root 294 Apr 16 2024 .. +-rwxrwxrwx 1 1026 users 1.6G Apr 20 2024 fedora-coreos-39.20240322.3.1-qemu.x86_64.qcow2 +-rwxrwxrwx 1 1026 users 1.6G May 9 2024 fedora-coreos-40.20240416.3.1-qemu.x86_64.qcow2 +-rwxrwxrwx 1 1026 users 574M Apr 16 2024 Fedora-Server-KVM-39-1.5.x86_64.qcow2 +-rwxrwxrwx 1 1026 users 629M Apr 24 2024 Fedora-Server-KVM-40-1.14.x86_64.qcow2 +-rwxrwxrwx 1 1024 users 660M Nov 11 08:20 Fedora-Server-KVM-41-1.4.x86_64.qcow2 +-rwxrwxrwx 1 1027 users 913M Aug 30 13:44 rhel-9.4-x86_64-kvm.qcow2 +root@pve-m-0:~# +---- === VM Creation: General @@ -134,11 +189,26 @@ Now that the VM itself has been built, we need to log in to the Proxmox node via *** The format may vary depending on where you are storing the VM. The test articule uses an NFS mount, and qcow2 formatted images are preferred in this usage scenario. -image::virtualization/vm-proxmox-11.png[VM Disk Import Start] +[,shell] +---- +root@pve-m-0:~# cd /mnt/pve/nfs-kraken/osimages/ +root@pve-m-0:/mnt/pve/nfs-kraken/osimages# qm disk import 106 Fedora-Server-KVM-41-1.4.x86_64.qcow2 nfs-kraken --format qcow2 +importing disk 'Fedora-Server-KVM-41-1.4.x86_64.qcow2' to VM 106 ... +Formatting '/mnt/pve/nfs-kraken/images/106/vm-106-disk-1.qcow2', fmt=qcow2 cluster_size=65536 extended_l2=off preallocation=metadata compression_type=zlib size=7516192768 lazy_refcounts=off refcount_bits=16 +transferred 0.0 B of 7.0 GiB (0.00%) +transferred 76.7 MiB of 7.0 GiB (1.07%) +transferred 148.4 MiB of 7.0 GiB (2.07%) +--SNIP-- +transferred 7.0 GiB of 7.0 GiB (99.33%) +transferred 7.0 GiB of 7.0 GiB (100.00%) +transferred 7.0 GiB of 7.0 GiB (100.00%) +Successfully imported disk as 'unused0:nfs-kraken:106/vm-106-disk-1.qcow2' +root@pve-m-0:/mnt/pve/nfs-kraken/osimages# +---- + +When the import process finishes you should get a success message like the one shown above. This process was done on a storage array with rotational hard disks, and it still only took a few seconds to complete. -When the import process finishes you should get a success message like the one show in the image below. This process was done on a storage array with rotational hard disks, and it still only took a few seconds to complete. -image::virtualization/vm-proxmox-12.png[VM Disk Import End] === VM Configuration: Disk From b145f643f6cfbcb811ced3aa3fb1f0b00b9b14e5 Mon Sep 17 00:00:00 2001 From: Paul Maconi Date: Nov 11 2024 15:01:38 +0000 Subject: [PATCH 5/6] formatting --- diff --git a/docs/modules/ROOT/pages/virtualization/vm-install-diskimg-proxmox.adoc b/docs/modules/ROOT/pages/virtualization/vm-install-diskimg-proxmox.adoc index ca6e750..f037388 100644 --- a/docs/modules/ROOT/pages/virtualization/vm-install-diskimg-proxmox.adoc +++ b/docs/modules/ROOT/pages/virtualization/vm-install-diskimg-proxmox.adoc @@ -73,7 +73,8 @@ drwxrwxrwx 1 root root 294 Apr 16 2024 .. root@pve-m-0:~# exit logout Connection to pve-m-0 closed. -aggraxis@whirlwind:~/Desktop/osimages$ scp Fedora-Server-KVM-41-1.4.x86_64.qcow2 root@pve-m-0:/mnt/pve/nfs-kraken/osimages/Fedora-Server-KVM-41-1.4.x86_64.qcow2 +aggraxis@whirlwind:~/Desktop/osimages$ scp Fedora-Server-KVM-41-1.4.x86_64.qcow2 \ +root@pve-m-0:/mnt/pve/nfs-kraken/osimages/Fedora-Server-KVM-41-1.4.x86_64.qcow2 root@pve-m-0's password: Fedora-Server-KVM-41-1.4.x86_64.qcow2 100% 659MB 110.7MB/s 00:05 aggraxis@whirlwind:~/Desktop/osimages$ @@ -192,9 +193,13 @@ Now that the VM itself has been built, we need to log in to the Proxmox node via [,shell] ---- root@pve-m-0:~# cd /mnt/pve/nfs-kraken/osimages/ -root@pve-m-0:/mnt/pve/nfs-kraken/osimages# qm disk import 106 Fedora-Server-KVM-41-1.4.x86_64.qcow2 nfs-kraken --format qcow2 +root@pve-m-0:/mnt/pve/nfs-kraken/osimages# qm disk import 106 \ +Fedora-Server-KVM-41-1.4.x86_64.qcow2 nfs-kraken --format qcow2 importing disk 'Fedora-Server-KVM-41-1.4.x86_64.qcow2' to VM 106 ... -Formatting '/mnt/pve/nfs-kraken/images/106/vm-106-disk-1.qcow2', fmt=qcow2 cluster_size=65536 extended_l2=off preallocation=metadata compression_type=zlib size=7516192768 lazy_refcounts=off refcount_bits=16 +Formatting '/mnt/pve/nfs-kraken/images/106/vm-106-disk-1.qcow2', +fmt=qcow2 cluster_size=65536 extended_l2=off preallocation=metadata +compression_type=zlib size=7516192768 lazy_refcounts=off +refcount_bits=16 transferred 0.0 B of 7.0 GiB (0.00%) transferred 76.7 MiB of 7.0 GiB (1.07%) transferred 148.4 MiB of 7.0 GiB (2.07%) diff --git a/preview.pid b/preview.pid index 79a65ce..e66344f 100644 --- a/preview.pid +++ b/preview.pid @@ -1 +1 @@ -17997 +3183 From fbe26ed25958a6eda3a691e15cca6123659a7c5e Mon Sep 17 00:00:00 2001 From: Paul Maconi Date: Nov 11 2024 15:07:58 +0000 Subject: [PATCH 6/6] remove preview.pid --- diff --git a/preview.pid b/preview.pid deleted file mode 100644 index e66344f..0000000 --- a/preview.pid +++ /dev/null @@ -1 +0,0 @@ -3183