The installation routine follows the basic structure of the underlying OpenBSD setup. Please refer to the Install OpenBSD Install FAQ for advanced installation options. This guide follows a simple and good way to create a great appliance system.
The minimal requirements for setting up the Appliances are
The recommended configuration for the Appliances are
The first step after you have downloaded the ISO is to burn the ISO to a cd. There's plenty of options if you don't already have a cd writing application.
Please create the bootable cdrom using your favourite cd writing program.
The system will boot and you will see lots of blue messages displaying kernel boot messages. After the boot, you will see this prompt:
rootdev=0x1100 rrootdev=0x2f00 rawdev=0x2f02 erase ^?, werase ^W, kill ^U, intr ^C, status ^T (I)nstall, (U)pgrade or (S)hell? i
Please choose i if this is an initial install and u if you're upgrading from a previous version of the appliance. Please note that you can't upgrade from a general system to an appliance system.
Welcome to the OpenBSD/i386 4.4 install program.
This program will help you install OpenBSD. At any prompt except password
prompts you can escape to a shell by typing '!'. Default answers are shown
in []'s and are selected by pressing RETURN. At any time you can exit this
program by pressing Control-C, but exiting during an install can leave your
system in an inconsistent state.
Terminal type: [vt220] Enter
kbd(8) mapping? ('L' for list) [none] Enter
IS YOUR DATA BACKED UP? As with anything that modifies disk contents, this
program can cause SIGNIFICANT data loss.
It is often helpful to have the installation notes handy. For complex disk
configurations, relevant disk hardware manuals and a calculator are useful.
Proceed with install? [no] y
Please only use the appliance cd on a clean system. If you want to test it out before installing on a production system please install in VMware or similar first.
Cool! Let's get to it... You will now initialize the disk(s) that OpenBSD will use. To enable all available security features you should configure the disk(s) to allow the creation of separate filesystems for /, /tmp, /var, /usr, and /home. Available disks are: wd0. Which one is the root disk? (or done) [wd0] Enter
The OpenBSD installer does a very good job of finding the first bootable disk on your system. And please choose the correct one here if it's not already chosen.
Do you want to use *all* of wd0 for OpenBSD? [no] y You will now create an OpenBSD disklabel inside the OpenBSD MBR partition. The disklabel defines how OpenBSD splits up the MBR partition into OpenBSD partitions in which filesystems and swap space are created. The offsets used in the disklabel are ABSOLUTE, i.e. relative to the start of the disk, NOT the start of the OpenBSD MBR partition. disklabel: no disk label WARNING: Disk wd0 has no label. You will be creating a new one. # using MBR partition 1: type A6 off 3069360 (0x2ed5b0) size 36030960 (0x225c9f0) Treating sectors 3069360-39100320 as the OpenBSD portion of the disk. You can use the 'b' command to change this. Initial label editor (enter '?' for help at any prompt) >
You are now prompted to create the partitions on the system. This is where the Install OpenBSD Install FAQ is particularly helpful if you don't want to stick with the default. For this system, we'll create a '512 Mb' swap space (twice the internal memory) and the rest as a single root partition.
> z > a b offset: [63] Enter size: [bignum] 512m FS type: [swap] Enter > a a offset: [bignum] Enter size: [bignum] Enter FS type: [4.2BSD] Enter mount point: [none] Enter > q Write new label?: [y] Enter The next step *DESTROYS* all existing data on these partitions! Are you really sure that you're ready to proceed? [no] y
At this point the disk are being formatted which can take a couple of minutes if the disk is big.
The next thing we're being prompted for is hostname. The SSL certificate that will be created and used for all TLS and SSL enabled connections will use hostname.domain (configured during network setup) as it's 'Common Name (CN)'. As this is an appliance and most likely publicly reachable, you will want to have a name that is resolvable in you DNS and use the same name as your hostname.
System hostname (short form, e.g. 'foo'): mail
Next follows the network configuration
Configure the network? [yes] Enter
Available interfaces are: fxp0.
Which one do you wish to initialize? (or 'done') [fxp0] Enter
Symbolic (host) name for xl0? [mail] Enter
The default media for fxp0 is
media: Ethernet autoselect (100baseTX full-duplex)
Do you want to change the default media? [no] Enter
IPv4 address for fxp0? (or 'dhcp') 192.168.1.254
Netmask? [255.255.255.0] Enter
IPv6 address for fxp0? (or 'rtsol' or 'none') [none] Enter
No more interfaces to initialize.
DNS domain name? (e.g. 'bar.com') [my.domain] example.com
DNS nameserver? (IP address or 'none') [] 192.168.1.1
Use the nameserver now? [yes] Enter
Default route? (IP address, 'dhcp' or 'none') [dhcp] 192.168.1.1
Edit hosts with ed? [no] Enter
Do you want to do any manual network configuration? [no] Enter
Password for root account? (will not echo) pAssWOrd Password for root account? (again) pAssWOrd
Let's install the sets!
Location of sets? (cd disk ftp http or 'done') [cd] Enter
Available CD-ROMs are: cd0.
Which one contains the install media? (or 'done') [cd0] Enter
Pathname to the sets? (or 'done') [4.4/i386] Enter
Select sets by entering a set name, a file name pattern or 'all'. De-select
sets by prepending a '-' to the set name, file name pattern or 'all'. Selected
sets are labeled '[x]'.
[X] bsd
[ ] bsd.mp
[X] base44.tgz
[X] etc44.tgz
[X] man44.tgz
[X] site44.tgz
Set name? (or 'done') [bsd.mp] done
Please choose the default setting for the packages. If you have a multiprocessor system you can choose the bsd.mp package as well but you will need all the other packages.
At this point, the basic system is being installed and you will see install graphs counting up to 100%.
Setting some final OpenBSD installation options before moving on to some appliance specific installations
Start sshd(8) by default? [yes] Enter
Start ntpd(8) by default? [no] y
Do you expect to run the X Window System? [no] Enter
Change the default console to com0? [no] Enter
Saving configuration files......done.
Generating initial host.random file ......done.
What timezone are you in? ('?' for list) [Canada/Mountain] ?
Africa/ Chile/ GB-Eire Israel NZ-CHAT UCT
America/ Cuba GMT Jamaica Navajo US/
Antarctica/ EET GMT+0 Japan PRC UTC
Arctic/ EST GMT-0 Kwajalein PST8PDT Universal
Asia/ EST5EDT GMT0 Libya Pacific/ W-SU
Atlantic/ Egypt Greenwich MET Poland WET
Australia/ Eire HST MST Portugal Zulu
Brazil/ Etc/ Hongkong MST7MDT ROC posix/
CET Europe/ Iceland Mexico/ ROK posixrules
CST6CDT Factory Indian/ Mideast/ Singapore right/
Canada/ GB Iran NZ Turkey zone.tab
What timezone are you in? ('?' for list) [Canada/Mountain] US
What sub-timezone of 'US' are you in? ('?' for list) ?
Alaska Central Hawaii Mountain Samoa
Aleutian East-Indiana Indiana-Starke Pacific
Arizona Eastern Michigan Pacific-New
Select a sub-timezone of 'US' ('?' for list): Eastern
Setting local timezone to 'US/Eastern'...done.
During the appliance specific installation, you're not being prompted for anything. You will see a lot of packages getting installed, and quite a few other things are happening in the background. When everything is finished, you will see this prompt:
CONGRATULATIONS! Your OpenBSD install has been successfully completed! To boot the new system, enter halt at the command prompt! Once the system has halted, reset the machine and boot from the disk. # reboot