Running a virtual machine on OpenBSD vmm
----------------------------------------

Last edited: $Date: 2018/03/09 19:51:05 $

## vmm virtual machine monitor

Vmm is the virtual machine monitor that lets you run virtual
machines on the native OpenBSD hypervisor.

## Preparation of the host

We will create the following setup:

* Installation files on the host's httpd server 
* NAT to 192.168.30.xxx for the virtual machines
* DHCP server on the host
* Boot from /bsd.rd on the host (installation image) 

## Setting up httpd with the installation files

	mkdir -p /var/www/htdocs/openbsd
	cp  /etc/examples/httpd.conf /etc
	vi /etc/httpd.conf

Contents of file /etc/httpd.conf:

	#
	# Macros
	#
	ext_addr="*"

	#
	# Global Options
	#
	# prefork 3

	#
	# Servers
	#

	# A minimal default server
	server "default" {
		listen on $ext_addr port 80
		directory { auto index, index "index.txt" }
	}

	# Include MIME types instead of the built-in ones
	types {
		include "/usr/share/misc/mime.types"
	}


Now go to /var/www/htdocs/openbsd and use ftp to download from
an OpenBSD mirror ftp server the installation set to this 
directory.

	INSTALL.amd64
	SHA256
	SHA256.sig
	base62.tgz
	bsd
	bsd.mp
	bsd.rd
	comp62.tgz
	index.txt
	man62.tgz
	xbase62.tgz
	xfont62.tgz
	xserv62.tgz
	xshare62.tgz
 
Check with a webbrowser that you can see these files in
http://<ip-number>/openbsd/

If the httpd daemon is not running, you can start it with

	/etc/rc.d/httpd -f start


Now that we have set up the install files, we go to setup
the virtual machine environment.

The configuration of the host starts with setting up
the network.

## Setting up the host network

We are going to setup up NAT (network address translation)
so the virtual machines can sit in their own network.

First, we must allow for forwarding the network. For this
we add a line to /etc/sysctl.conf:

	net.inet.ip.forwarding=1

Next, we are going to setup the packet filter configuration,
in the file /etc/pf.conf. Add the following lines to
/etc/pf.conf:

	ext_if="iwn0"
	int_if="{ vether0 tap0 }"
	set block-policy drop
	set loginterface egress
	match in all scrub (no-df random-id max-mss 1440)
	match out on egress inet from !(egress:network) to any nat-to (egress:0)
	pass out quick inet
	pass in on $int_if inet
	pass in on egress inet proto tcp from any to (egress) port 22

The first line points to interface iwn0, this is for the wireless
NIC on our laptop. If you have a wired network interface, change this
accordingly, e.g., to "em0".

vether0 is the virtual network for our virtual machines.

Now we setup /etc/hostname.vether0                                                                                                                                                   
	inet 192.168.30.1 255.255.255.0 NONE

and /etc/dhcpd.conf

	shared-network VMM-NETWORK {
	    subnet 192.168.30.0 netmask 255.255.255.0 {
		range 192.168.30.110 192.168.30.200;

		option subnet-mask 255.255.255.0;
		option broadcast-address 192.168.30.255;
		option routers 192.168.30.1;
		option domain-name-servers 192.168.1.1;

		host vm1 {
		    hardware ethernet 02:20:91:01:23:40;
		    fixed-address vm1.example.com;
		}
	   }
	}


In /etc/hosts we can give the fixed-address of vm1.example.com:

	192.168.30.100  vm1.example.com;


## Virtual machine daemon

We are almost done with the configuration of the host. Next we
setup /etc/vm.conf

	switch "local" {
	    add vether0
	    add tap0
	    add tap1
	    add tap2
	}

	vm "vm1.vm" {
	    memory 1024M
	    boot "/bsd.rd"
	    disk "usr/local/vmm/vm1.img"
	    interface {
		switch "local"
		lladdr 02:20:91:01:23:40;
	    }
	}

And finaly, /etc/rc.conf.local. Add the following lines to
your /etc/rc.conf.local configuration file:

	dhcpd_flags=vether0
	vmd_flags=


## Create the virtual machine disk image

	vmctl create /usr/local/vmm/vm1.img -s 2G

## Install the virtual machine

Now, start all the daemons, we did this by rebooting our laptop.
The virtual machine is booted from /bsd.rd, this is the standard
installation ramdisk. Connect to the vm with

	vmctl console 1

and hit the space bar. You are now promted from the installation
script to choose to install or enter a shell. 
If your httpd daemon does not start automaticly, don't forget
to start it. 

When the installation is done, change the boot file from 
/bsd.rd to /bsd, reboot the virtual machine. You can now connect
over ssh instead of over the serial console. 


$Id: vmmvm.txt,v 1.4 2018/03/09 19:51:05 matto Exp $