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 [https://support.mayfirst.org/wiki/install_debian_kvm_manager kvm-manager] scripts
 1. 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] ] ] ] 
}}}
 1. 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
   1. Rebuild the monkeysphere-controlled SSH authorized_keys files: 
{{{ 
monkeysphere-authentication update-users 
}}}
  1. SSH key way
   1. Add an SSH key to the /home/<guestname>/.ssh/authorized_keys file
 1. 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!
  1. Customize the iso with details for the server you are installing
   1. First edit /root/server-specifics.cfg - change values to match the server you are building
   1. Change into /usr/local/share/ISOs: {{{ cd /usr/local/share/ISOs }}}
   1. Run: 
{{{
di-maker install.iso /root/preseed.cfg /root/server-specifics.cfg /root/late-command
}}}
  1. 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
}}}
 
 1. Tell runit to start the guest automatically
{{{
update-server --add /etc/sv/kvm/SERVER-NAME
}}}
 1. Log into the new guest via ssh: {{{ ssh SERVER-NAME@HOST-NAME }}}
 1. Install an OS: everything should be handled by preseed file