README's & Makefile

Author: ssenator

README.centos7.sysprep

@@ -0,0 +1,36 @@
+# 5.11 fails due to #20198
+#  "cannot create network; /dev/vboxnet does not exist" 
+
+# SKIP THIS STEP until this bug: https://www.virtualbox.org/ticket/20198 allows using the linux 5.11 kernel
+#1. update to latest:
+#	# dnf distro-sync
+#	# reboot
+1. add epel repository (to get vagrant & its plugins)
+  yum install epel-release
+
+2. install infrastructure software
+	vagrant
+	vagrant-libvirt
+	VirtualBox prerequisite RPMS
+	   # yum install kernel-devel kernel-devel-$(uname -r) kernel-headers kernel-headers-$(uname -r) make patch gcc
+	   # yum install python2.7 binutils gcc make patch libgomp glibc-headers glibc-devel kernel-headers kernel-devel dkms qt5-qtx11extras libxkbcommon
+	   # wget -q https://www.virtualbox.org/download/oracle_vbox.asc -O oracle_vbox.asc
+	   # rpm --import oracle_vbox.asc
+	   ###create /etc/yum.repos.d/virtualbox.repo
+	   ###from: https://download.virtualbox.org/virtualbox/rpm/fedora/virtualbox.repo
+           --- oracle-virtualbox.repo ---
+[oracle-virtualbox]
+name=Oracle Linux / RHEL / CentOS-$releasever / $basearch - VirtualBox
+baseurl=http://download.virtualbox.org/virtualbox/rpm/el/$releasever/$basearch
+enabled=1
+gpgcheck=1
+repo_gpgcheck=1
+gpgkey=https://www.virtualbox.org/download/oracle_vbox.asc
+           --- virtualbox.repo ---
+	   # yum install VirtualBox
+3. a. set permissions & ownership on /run/libvirt/*sock*
+   b. ensure in libvirt, libvirtd, wheel, root, qemu, kvm, vboxusers groups
+3. ensure sufficient space
+4. pull git repo clone
+5. set link to space directory in repo clone
+6. build/run

README.fc32.sysprep

@@ -0,0 +1,36 @@
+# 5.11 fails due to #20198
+#  "cannot create network; /dev/vboxnet does not exist" 
+
+# SKIP THIS STEP until this bug: https://www.virtualbox.org/ticket/20198 allows using the linux 5.11 kernel
+#1. update to latest:
+#	# dnf distro-sync
+#	# reboot
+
+2. install infrastructure software
+	vagrant
+	vagrant-libvirt
+	VirtualBox prerequisite RPMS
+	   # dnf install python2.7 binutils gcc make patch libgomp glibc-headers glibc-devel qt5-qtx11extras libxkbcommon
+	   # dnf install kernel-headers kernel-devel dkms
+	VirtualBox
+           ###https://download.virtualbox.org/virtualbox/6.1.18/VirtualBox-6.1-6.1.18_142142_fedora32-1.x86_64.rpm
+	   # wget -q https://www.virtualbox.org/download/oracle_vbox.asc -O oracle_vbox.asc
+	   # rpm --import oracle_vbox.asc
+	   ###create /etc/yum.repos.d/virtualbox.repo
+	   ###from: https://download.virtualbox.org/virtualbox/rpm/fedora/virtualbox.repo
+           --- virtualbox.repo ---
+[virtualbox]
+name=Fedora $releasever - $basearch - VirtualBox
+baseurl=http://download.virtualbox.org/virtualbox/rpm/fedora/$releasever/$basearch
+enabled=1
+gpgcheck=1
+repo_gpgcheck=1
+gpgkey=https://www.virtualbox.org/download/oracle_vbox.asc
+           --- virtualbox.repo ---
+	   # yum install VirtualBox
+3. a. set permissions & ownership on /run/libvirt/*sock*
+   b. ensure in libvirt, libvirtd, wheel, root, qemu, kvm, vboxusers groups
+3. ensure sufficient space
+4. pull git repo clone
+5. set link to space directory in repo clone
+6. build/run

README.fc33.sysprep

@@ -0,0 +1,41 @@
+# 5.11 fails due to #20198
+#  "cannot create network; /dev/vboxnet does not exist" 
+
+1. update to latest:
+	# dnf distro-sync
+	# reboot
+
+2. install infrastructure software
+	# dnf install vagrant vagrant-libvirt libvirt-client
+	# dnf install libvirt-daemon-config-network libvirt-daemon-kvm qemu-kvm virt-manager virt-viewer
+	# dnf install libguestfs-tools python3-libguestfs virt-top
+	#
+	VirtualBox prerequisite RPMS
+	   # dnf install python2.7 binutils gcc make patch libgomp glibc-headers glibc-devel qt5-qtx11extras libxkbcommon
+	Depending on what kernel is running, you may need to do:
+     # yum install "kernel-devel-*$(uname -r)"
+	   # dnf install kernel-headers kernel-devel dkms
+	VirtualBox
+		 retrieve VirtualBox installer
+		 % wget https://download.virtualbox.org/virtualbox/6.1.18/VirtualBox-6.1.18-142142-Linux_amd64.run
+		# chmod +x VirtualBox-6.1.18-142142-Linux_amd64.run
+		# ./VirtualBox-6.1.18-142142-Linux_amd64.run
+		add user to vboxusers group
+
+3. a. set permissions & ownership on /run/libvirt/*sock*
+   b. ensure in libvirt, libvirtd, wheel, root, qemu, kvm groups
+4. ensure sufficient space
+5. Start nfs service
+   edit /etc/nfs.conf, making sure that nfsd and at least one nfs protocol version is enabled, preferably 4.2
+   # systemctl enable nfs-server ; systemctl start nfs-server
+   # systemctl enable libvirtd ; systemctl start libvirtd
+   # systemctl status nfs-server
+   # systemctl status libvirtd
+   # firewall-cmd --permanent --add-service=nfs
+   # firewall-cmd --permanent --zone=libvirt --add-port=2049/tcp
+   # firewall-cmd --reload
+6. pull git repo clone; install git and git-lfs if they aren't already
+7. set link to space directory in repo clone
+8. build/run
+   When switching virtualization providers you may need to either reboot the node or explicitly remove any
+   virtual bridge interfaces that have been left behind. Both libvirt and virtualbox assume they own 'virbr*'

requires/auth/Makefile

@@ -1,6 +1,6 @@
 
 TARGETS			 = sudo-auth sudo-modify-exports modify-exports sudo-enable-nfs-through-firewall
-TARGETS_OPTIMISTIC	 = modify-exports sudo-auth sudo-modify-exports
+TARGETS_OPTIMISTIC	 = modify-exports sudo-auth sudo-modify-exports invoker-userid-in-virt-groups
 
 SUDO_CHECK		:= $(shell sudo id -n -u)
 SUDO_NEED		 = root
@@ -39,3 +39,9 @@ sudo-enable-nfs-through-firewall:
 		sudo firewall-cmd --zone=trusted --add-interface=vboxnet0			; \
 		sudo firewall-cmd --zone=trusted --add-service=nfs				; \
 	fi
+
+invoker-userid-in-virt-groups:
+	:
+	$(warn verify that invoker's groupid includes libvirt & kvm (if PROVIDER=libvirt) or vboxusers (if virtualbox))
+	$(warn verify that /etc/libvirt/libvirtd.conf unix_sock_group = "libvirt")
+	$(warn verify that /etc/libvirt/libvirtd.conf unix_sock_rw_perms = "0770")