diff --git a/.gitignore b/.gitignore new file mode 100644 index 0000000..e0af02d --- /dev/null +++ b/.gitignore @@ -0,0 +1,9 @@ +# ---> Vim +# Swap +[._]*.s[a-v][a-z] +!*.svg # comment out if you don't need vector files +[._]*.sw[a-p] +[._]s[a-rt-v][a-z] +[._]ss[a-gi-z] +[._]sw[a-p] + diff --git a/Proxmox_documentation.pdf b/proxmox/Proxmox_documentation.pdf similarity index 100% rename from Proxmox_documentation.pdf rename to proxmox/Proxmox_documentation.pdf diff --git a/proxmox/proxmox-provisioning.org b/proxmox/proxmox-provisioning.org new file mode 100644 index 0000000..37b3cc2 --- /dev/null +++ b/proxmox/proxmox-provisioning.org @@ -0,0 +1,84 @@ +#+title: Provisioning a Proxmox VM +#+author: Kevin Muller, Hans van Zijst & Nicolas Jeannerod +#+date: <2024-10-25 Fri> + +* Quick links +- Fediversity Proxmox :: http://192.168.51.81:8006/ +* Basic terminology +- Node :: physical host +* Preparing the machine configuration +- It is nicer if the machine is a QEMU guest. On NixOS: + #+begin_src nix + services.qemuGuest.enable = true + #+end_src +- Choose static IPs for your machine. The IPv4 and IPv6 subnets available for + Fediversity testing are: + - 95.215.187.0/24. Gateway is 95.215.187.1. + - 2a00:51c0:13:1305::/64. Gateway is 2a00:51c0:13:1305::1. +- Check [[https://netbox.protagio.org][Netbox]] to see which addresses are free +* Upload your ISO +- In the left view, expand under the node that you want and click on “local”. +- Select “ISO Images”, then click “Upload”. +- Note: You can also download from URL. +- Note: You should click on “local” and not “local-zfs”. +* Creating the VM +- Click “Create VM” at the top right corner. +** General +- Node :: which node will host the VM; has to be the same +- VM ID :: Has to be unique, probably best to use the "xxxx" in "vm0xxxx" (yet to be decided) +- Name :: Usually "vm" + 5 digits, e.g. "vm02199" +- Resource pool :: Fediversity +** OS +- Use CD/DVD disc image file (iso) :: + - Storage :: local, means storage of the node. + - ISO image :: select the image previously uploaded +No need to touch anything else +** System +- BIOS :: OVMF (UEFI) +- EFI Storage :: ~linstor_storage~; this is a storage shared by all of the Proxmox machines. +- Pre-Enroll keys :: MUST be unchecked +- Qemu Agent :: check +** Disks +- Tick “advanced” at the bottom. +- Disk size (GiB) :: 40 (depending on requirements) +- SSD emulation :: check (only visible if “Advanced” is checked) +- Discard :: check, so that blocks of removed data are cleared +** CPU +- Sockets :: 1 (depending on requirements) +- Cores :: 2 (depending on requirements) +- Enable NUMA :: check +** Memory +- Memory (MiB) :: choose what you want +- Ballooning Device :: leave checked (only visible if “Advanced” is checked) +** Network +- Bridge :: ~vnet1306~. This is the provisioning bridge; we will change it later. +- Firewall :: uncheck, we will handle the firewall on the VM itself +** Confirm +* Install and start the VM +- Start the VM a first time. + - Select the VM in the left panel. You might have to expand the node on which it is hosted. + - Select “Console” and start the VM. +- Install the VM as you would any other machine. +- [[Shutdown the VM]]. +- After the VM has been installed: + - Select the VM again, then go to “Hardware”. + - Double click on the CD/DVD Drive line. Select “Do not use any media” and press OK. + - Double click on Network Device, and change the bridge to ~vnet1305~, the public bridge. +- Start the VM again. +* Remove the VM +- [[Shutdown the VM]]. +- On the top right corner, click “More”, then “Remove”. +- Enter the ID of the machine. +- Check “Purge from job configurations” +- Check “Destroy unreferenced disks owned by guest” +- Click “Remove”. +* Move the VM to another node +- Make sure there is no ISO plugged in. +- Click on the VM. Click migrate. Choose target node. Go. +- Since the storage is shared, it should go pretty fast (~1 minute). +* Shutdown the VM +- Find the VM in the left panel. +- At the top right corner appears a “Shutdown” button with a submenu. +- Clicking “Shutdown” sends a signal to shutdown the machine. This might not work if the machine is not listening for that signal. +- Brutal solution: in the submenu, select “Stop”. +- The checkbox “Overrule active shutdown tasks” means that the machine should be stopped even if a shutdown is currently ongoing. This is particularly important if you have tried to shut the machine down normally just before.