This page documents the procedure for creating a new KVM guest on a mayfirst server.

This document is not complete! Do not use it to actually create a new KVM guest yet.

Creating a new KVM guest

1. Install the ​kvm-manager scripts
2. Run kvm-creator to create the new LV for the guest and the needed directory and files in /etc/sv/kvm/:

   USAGE: kvm-creator create|destroy|demo guestname [volumegroup [disksize [ram [tap [mac] ] ] ] 
   

3. If you are installing an operating system to the new KVM guest:
   1. Put the iso in the /usr/local/share/ISOs directory. Be sure to verify the checksums on downloaded ISOs!
   2. Create a symlink called cd.iso in the /home/<guestname>/vms/<guestname>/ directory with a target of the desired ISO:

      ln -s /home/<guestname/vms/<guestname>/cd.iso /usr/local/share/ISOs/<some-installer>.iso
      

4. Add at least one user to the access list for the new KVM guest's serial console
   1. Monkeysphere way:
      1. Add a uid to the /home/<guestname>/.monkeysphere/authorized_user_ids file
      2. Rebuild the monkeysphere-controlled SSH authorized_keys files:

         monkeysphere-authentication update-users 
         

   2. SSH key way
      1. Add an SSH key to the /home/<guestname>/.ssh/authorized_keys file
5. START THE NEW KVM GUEST
6. Log into the new guest via SSH
7. Install an OS
   1. CREATE A BOOT PARTITION? BY DEFAULT, USE A KERNEL FROM OUTSIDE THE GUEST?
   2. NETWORK SETUP? This appears to be as easy as claiming an IP from the ​IP allocation list and using this during the OS setup, though this process may be incorrect, even if it works.
   3. Generally the <guestname> LV should be used inside the KVM guest as a single PV