This page documents the general setup process for a server that is acting as virtual machine host, like those documented in the Buildbot Setup for Virtual Machines section.

1. Provision hardware with most recent Ubuntu LTS release

2. Add host to DNS

3. Apply updates (replace <host> with hostname)

ssh <host>.mariadb.net
sudo apt-get update
sudo apt-get dist-upgrade

4. install some favorite packages (these aren't necessarily required, but I like them)

sudo apt-get install tree renameutils vim-nox

5. a buildbot admin needs to add the new host to the allowed list of rsync clients on the VM master (whichever host is the official host of VM files) The VM master changes periodically, so check to make sure you have the correct one.

vi /etc/rsyncd.conf 

6. make a /kvm/ dir and rsync it with the VM master above. The dir often resides at /home/kvm/ (or wherever the storage drive is) and is then linked to /kvm/. The VMs rely on the /kvm/vms/ path, so the /kvm/ location is required.

vm_master="hostname"      # ask for this from a buildbot admin
mkdir /home/kvm
ln -sv /home/kvm /kvm
rsync --dry-run --delete --exclude=deprecated \\
  --exclude=iso --exclude=lost+found -avPL ${vm_master}::kvm/ /home/kvm/
# assuming the dry-run looks good, start the "real" rsync in a screen session
screen
rsync --delete --exclude=deprecated --exclude=iso --exclude=lost+found -avPL ${vm_master}::kvm/ /home/kvm/

7. detatch from screen session with Ctrl+a d

8. Configure vim.basic as the default editor (optional)

update-alternatives --config editor

9. install buildbot-slave, bzr, and kvm

sudo apt-get install bzr git buildbot-slave qemu kvm 
sudo apt-get install libsdl2-2.0-0 

10. add a default user, and then add the user to the appropriate groups

username="mydefaultusername"
sudo adduser ${username}
for group in sudo tty kvm;do
  sudo adduser ${username} ${group}
done

11. logout then back in as the default user and change the password

13. set up the /.ssh/authorized_keys file so you can login that way

14. create other standard users and set up their ssh keys (optional)

15. turn off password login (WARNING: be sure to have your ssh key setup before doing this!) and disallow all root logins and password logins (it is safer to only allow logins using ssh keys with regular users):

sudo perl -i -pe "s/#PasswordAuthentication yes/PasswordAuthentication no/" /etc/ssh/sshd_config
sudo perl -i -pe "s/PermitRootLogin yes/PermitRootLogin no/" /etc/ssh/sshd_config
sudo /etc/init.d/ssh restart

16. checkout mariadb-tools

mkdir ~/src
cd ~/src/
bzr branch lp:mariadb-tools

17. put runvm in the right place

sudo cp -v ~/src/mariadb-tools/buildbot/runvm /usr/local/bin/
ls -l /usr/local/bin/

18. add the buildbot user to the kvm and tty groups

sudo adduser buildbot kvm
sudo adduser buildbot tty

19. A buildbot admin will need to add this builder to the maria-master-private.cfg file on the ${buildmaster} and also add it to the c['slaves'] array in maria-master.cfg then create the buildslave using the hostname and whatever ${password} was agreed upon by you and the buildbot admin:

sudo buildslave create-slave /var/lib/buildbot/slaves/maria buildbot.askmonty.org ${host} ${password}

20. add the following to /etc/default/buildslave (replace ${hostname} with the name of the host)

HOME=/var/lib/buildbot
SLAVE_ENABLED[1]=1
SLAVE_NAME[1]="${hostname} maria slave"
SLAVE_USER[1]="buildbot"
SLAVE_BASEDIR[1]="$HOME/slaves/maria"
SLAVE_OPTIONS[1]=""
SLAVE_PREFIXCMD[1]=""

21. edit the admin and host files and add contact information and details on the builder:

sudo vi /var/lib/buildbot/slaves/maria/info/*

22. copy over the buildbot .ssh dir from terrier:

scp terrier.askmonty.org:buildbot-ssh.tar.gz .

cd /var/lib/buildbot
sudo tar -zxvf ~/buildbot-ssh.tar.gz
sudo chown -Rv buildbot: .ssh
sudo chmod -v 700 .ssh
sudo chmod -Rv go-r .ssh

23. Edit /etc/passwd and change the buildbot user's shell from /bin/false to /bin/bash

24. su to the buildbot user and copy in the /etc/skel files

sudo su - buildbot
cp -v /etc/skel/.bash* .
cp -v /etc/skel/.profile .
exit

25. change ownership of the buildbot/slaves dir to buildbot:buildbot

sudo chown -Rv buildbot:buildbot ~buildbot/slaves

26. move the /var/lib/buildbot directory to /home (or whatever location you want to use to store things) and then link it back

sudo mv -vi /var/lib/buildbot /home/;cd /var/lib/;sudo ln -sv /home/buildbot ./

27. update /etc/default/locale and change it to: LANG=en_US.UTF-8

sudo vi /etc/default/locale
sudo locale-gen

28. monitor the rsync, wait for it to finish

29. once the rsync is finished, test the runvm script

sudo su - buildbot
for i in '/kvm/vms/vm-xenial-amd64-serial.qcow2 6666 qemu64' '/kvm/vms/vm-xenial-i386-serial.qcow2 6666 qemu64' ; do \
  set $i; \
  runvm --user=buildbot --logfile=kernel_$2.log --base-image=$1 --port=$2 --cpu=$3 "$(echo $1 | sed -e 's/serial/testtest/')" \
    "sudo DEBIAN_FRONTEND=noninteractive apt-get update" \
    "sudo DEBIAN_FRONTEND=noninteractive apt-get install -y patch libaio1 debconf-utils unixodbc libxml2 libjudydebian1" \
    "= scp -P $2 /kvm/vms/my55.seed /kvm/vms/sources.append buildbot@localhost:/tmp/" \
    "sudo debconf-set-selections /tmp/my55.seed" \
    "sudo sh -c 'cat /tmp/sources.append >> /etc/apt/sources.list'"; \
done

30. Remove the "testtest" VMs we created above

rm -v /kvm/vms/*testtest*

31. Start the buildslave

sudo /etc/init.d/buildslave start

tail -f ~buildbot/slaves/maria/twistd.log

32. ssh to ${buildmaster} and add this new host to kvm_slaves in the maria-master.cfg file

sudo vi /etc/buildbot/maria-master.cfg

33. still on ${buildmaster}, test and then reload buildbot

cd /etc/buildbot
sudo -u buildbot PYTHONPATH=/usr/local/buildbot/lib/python python -c 'exec open("maria-master.cfg", "r")'
sudo /etc/init.d/buildmaster reload
sudo tail -f /var/lib/buildbot/maria/twistd.log