Skip to content
This repository has been archived by the owner on Jun 18, 2021. It is now read-only.

Latest commit

 

History

History
151 lines (107 loc) · 4.05 KB

freebsd-image.md

File metadata and controls

151 lines (107 loc) · 4.05 KB
Raw

FreeBSD OpenStack image creation

See Remy van Elst's guide to creating images, which this document is based upon, with some modifications. The instructions are updated for new releases, so it would be worth looking at these when updating these instructions for a new release where some of the details may have changed.

Follow the local setup instructions before starting.

ISO image creation

Download ISO image, then run:

openstack image create --file ~/Downloads/FreeBSD-11.1-RELEASE-amd64-disc1.iso --disk-format iso --container-format bare "FreeBSD-11.1-RELEASE-amd64-dvd1.iso"

Set image_id using id of created image.

Installation

openstack volume create --size 16 "FreeBSD-11.1-root"

Set volume_id using id of created volume.

Next, boot the installer:

openstack server create "--image=$image_id" --key-name "$ssh_key" --flavor "m1.small" --block-device-mapping "vdb=$volume_id:::0" "FreeBSD-11.1-RELEASE-install"

Set install_vm_id using id of created VM.

Now go to the OpenStack console for this VM, and run through the installation sequence:

  • Perform standard FreeBSD install
  • Keyboard: UK keymap
  • Hostname: freebsd111
  • Distribution select: No package sets (keep minimal)
  • Partitioning: Auto (UFS)
  • Partition: Entire disk; delete swap and root partitions, recreate root partition using full disk capacity
  • Partition scheme: GPT
  • Root password: freebsd111 (temporary)
  • Network configuration: vtnet0, IPv4 DHCP, IPv6 SLAAC, default resolver setup
  • Clock: UTC
  • Timezone: UTC
  • System configuration: sshd, dumpdev
  • System hardening: Stack guard, Clean /tmp, Disable remote syslog, Disable sendmail
  • Add user accounts: None
  • Open shell
    • add ifconfig vtnet0 mtu 1450 to /etc/rc.local to work around #187094
    • run shutdown -p now

Now stop and remove the installation VM, retaining the volume:

# Seems pointless if already stopped; can be skipped
openstack server stop "$install_vm_id"

openstack server remove volume "$install_vm_id" "$volume_id"

openstack server delete "$install_vm_id"

Post-installation setup of cloudinit

Make the volume bootable:

cinder --os-volume-api-version 2 set-bootable "$volume_id" true

List available networks:

openstack network list

Set net_id using id for required network (must permit outgoing external connections for downloading packages).

Now, start up a new VM using our installation volume:

nova boot --block-device "source=volume,id=$volume_id,dest=volume,shutdown=preserve,bootindex=0" --poll --flavor "m1.small" --security-group "$security_group" --nic "net-id=$net_id" --key-name "$ssh_key" FreeBSD-11.1-RELEASE-configure

Set configure_vm_id using id of created VM.

Log into VM as root using the OpenStack console. Set up a minimal Python installation and configure booting:

pkg install vim-lite py27-setuptools ca_root_nss
touch /firstboot
rehash
easy_install eventlet
easy_install iso8601
cat <<EOF >>/boot/loader.conf
console="comconsole,vidconsole"
autoboot_delay="15"
EOF

Next, install cloudinit itself:

fetch https://raw.github.com/pellaeon/bsd-cloudinit-installer/master/installer.sh
chmod +x installer.sh
./installer.sh

Finally, tidy up:

set history = 0
history -c
dd if=/dev/zero of=/bla
rm /bla
shutdown -p now

Remove the configuration VM:

openstack server delete "$configure_vm_id"

Create OpenStack image

Finally, create an OpenStack image from this volume:

openstack image create --volume "$volume_id" "FreeBSD-11.1-RELEASE"

This will be used to create new VMs.

Test

Create a VM using our new image:

openstack server create --image="FreeBSD-11.1-RELEASE" --security-group "$security_group" --nic "net-id=$net_id" --key-name "$ssh_key" --flavor "m1.medium"  "test-freebsd-11.1"

You should be able to log in and do whatever you like.