#+title: Provisioning a Proxmox VM
#+author: Kevin Muller, Hans van Zijst & Nicolas Jeannerod
#+date: <2024-10-25 Fri>

* 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 [Netbox](https://netbox.protagio.org) to see which addresses are free
* Upload your ISO
- Upload your ISO
- In the node you want, `local` storage. ISO images. Upload. You can also download from URL.
* Creating the VM
- Click “Create VM” at the top right corner.
- Tick “advanced” at the bottom.
** General
- Node :: which actual machine you want to run; same as the ISO
- 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
- Storage :: local, means storage of the node.
- Choose what you want.
** 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
- Disk size (GiB) :: 40
- SSD emulation :: check
- 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
** Network
- Bridge ::
  When creating the VM, select the provisioning bridge (`vnet1306`). Once created, switch
- Firewall :: uncheck, we will handle the firewall on the VM itself
** Confirm
* Install and start the VM
- You see the VM on the left side.
- Click, go to console, start it.
- Install it
- Once the VM has been installed:
  - Go to the VM, Hardware, remove the CD/DVD Drive.
  - Switch bridge to public ~vnet1305~
- Datacenter > SDN > VNets
* Remove the VM
- Click on the VM. Make sure it is shut down.
- Shutdown sends a sigshutdown. If the machine doesn't listen to it, use the tiny arrow, choose Stop, check overrule and click.
- More > Remove. Enter the ID. Purge from job. Destroy unreference disks.
* Move to other 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).