wm: doc

Download patch

ref: d5d7f0105acf53c8663759506db038da6621104c
parent: 613a22d34666ce68190b2f2c5695fbc1c58a016e
author: jrmu <jrmu@inter9>
date: Sun Jun 16 09:24:12 EDT 2024

Cleaned up and separated vmm setup from install doc

--- a/install.ms
+++ b/install.ms
@@ -10,20 +10,35 @@
 .
 .AE
 
-.SH
-Install
-.LP
 .ihtml img <img src="https://wiki.ircnow.org/uploads/9/plan9-desktop.png">
 .ihtml img
 
+.SH
+Download the ISO
 .LP
-In /etc/vm.conf: 
+This installation assumes you (or your admin) has
+.ihtml a <a href="https://wiki.ircnow.org/?n=Vmm.Configure">
+configured vmm
+.ihtml a
+properly.
 
+Inside your home folder, download the 9front ISO: 
+
+$ ftp https://9front.org/iso/9front-10522.amd64.iso.gz
+$ sha256 9front-10522.amd64.iso.gz
+SHA256 (9front-10522.amd64.iso.gz) = 89f1e35bf735bfc9aeca38286a9a6607f3a40292befa4a30133157790f2edbcc
+89f1e35bf735bfc9aeca38286a9a6607f3a40292befa4a30133157790f2edbcc      9front-10522.amd64.iso.gz
+$ gunzip 9front-10522.amd64.iso.gz
+$ ln -sf 9front-10522.amd64.iso $USER.iso
+
+.LP
+Inside /etc/vm.conf, make sure your virtual machine's cdrom is set to $USER.iso: 
+
 .CW
 vm "$USER" {
     owner $USER
     memory 2048M
-    cdrom "/home/iso/9front-10522.amd64.iso"
+    cdrom "/home/$USER/$USER.iso"
     disk /home/$USER/$USER.qcow2 
     interface {
         locked lladdr aa:bb:cc:dd:ee:ff
@@ -31,31 +46,19 @@
     }
 }
 .R
-Download the 9front ISO: 
 
-# ftp https://9front.org/iso/9front-10522.amd64.iso.gz
-# mv 9front-10522.amd64.iso.gz /home/iso/
-# cd /home/iso
-# sha256 9front-10522.amd64.iso.gz
-SHA256 (9front-10522.amd64.iso.gz) = 89f1e35bf735bfc9aeca38286a9a6607f3a40292befa4a30133157790f2edbcc
-89f1e35bf735bfc9aeca38286a9a6607f3a40292befa4a30133157790f2edbcc      9front-10522.amd64.iso.gz
-$ gunzip 9front-10522.amd64.iso.gz
-$ doas chown -R iso:iso /home/iso/
+Stop your existing virtual machine:
 
-Create a user account and make sure to set the folder as go-rx: 
+.CW
+$ vmctl stop $USER
+.R
 
-$ doas su $USER
-$ doas chmod -R go-rx /home/$USER
+You may need to delete any existing data, then create a new qcow2 image, then start the virtual machine:
 
-In the home folder:
-
+.CW
+$ rm $USER.qcow2
 $ vmctl create -s 20G $USER.qcow2
-
-Then log out of the user with ^D, then as admin user in group wheel: 
-
-$ doas vmctl reload
 $ vmctl start -c $USER
-host# vmctl start -c jrmu
 Connected to /dev/ttyp9 (speed 115200)
 Boot failed: not a bootable disk
 
@@ -98,6 +101,9 @@
 /dev/sdF0:
 /dev/sdF0/data
 bootargs is (tcp, tls, il, local!device)[local!/dev/sd00/data]
+
+Select the default by pressing enter.
+
 user[glenda]:
 
 init: starting /bin/rc
@@ -475,12 +481,10 @@
 can't reset
 
 
-At this point, plan9 is unable to reboot on its own, so type `~~.` then: 
+At this point, plan9 is unable to reboot on its own. We escape the serial console, then stop and restart the machine. First, type ~~. then: 
 
-
-
-    $ doas vmctl stop username-plan9
-    $ doas vmctl start -c username-plan9
+$ doas vmctl stop $USER
+$ doas vmctl start -c $USER