Quick Install Instructions

If there are bugs found in this CD release, workaround information can
be found at http://www.OpenBSD.org/errata.html
Please refer to the following files on the three CDROM's for extensive
details on how to install OpenBSD 4.6 on your machine:

CD1:4.6/i386/INSTALL.i386

CD2:4.6/amd64/INSTALL.amd64
CD2:4.6/macppc/INSTALL.macppc

CD3:4.6/sparc64/INSTALL.sparc64

Other architectures are available on the FTP site, due to not fitting
onto the 3 CDs we are able to provide.

The installation procedure for OpenBSD has changed substanatially
compared to OpenBSD 4.5 and previous releases.  It is very much simpler,
but everyone may still wish to read the INSTALL.* files found in the
directory for each architecture.

i386:

Play with your BIOS options, and see if you can enable booting from CD1.
Many older PCs have ROM bugs with CD booting. If CD booting fails, write
CD1:4.6/i386/floppy46.fs to a floppy, then boot that. Use floppyB46.fs instead
for greater scsi controller support, or floppyC46.fs for better laptop support.
If you are mixing OpenBSD with another operating system, you will want to
read the INSTALL.i386 document.

AMD64:

If booting of CD2 fails, write CD2:4.6/amd64/floppy46.fs to a floppy,
then boot that.

MACPPC:

Use CD2.  At poweron, hold down the 'c' key until the display turns
on and shows "OpenBSD/macppc Boot". Or at the Open Firmware prompt type
"boot cd:,ofwboot /4.6/macppc/bsd.rd"

SPARC64:

To boot off CD3, type "boot cdrom".  Otherwise, write
CD3:4.6/sparc64/floppy46.fs to a floppy and boot it using "boot floppy"
or write CD3:4.6/sparc64/miniroot46.fs to the swap partition on the
disk and use the PROM to boot from that partition using "boot disk:b".

CD 2 track 2 is an audio track entitled "Planet of the Users" written
and arranged by Jonathan Lewis.  Lyrics by Ty Semaka.  Synth, drum and
bass programming by Jonathan Lewis.  Guitar by Russ Broom.  Vocals by
Duncan McDonald.

Source Code Use

CD#3 contains src.tar.gz.  Using this tree it is possible to get a
head-start on using the anoncvs servers as described at
http://www.OpenBSD.org/anoncvs.html. Using these files results in a much
faster initial CVS update than you could expect from a fresh checkout of
the full OpenBSD source tree. There are two ways of using the CD:

Copy the tree off it, (assuming the CD is mounted on /mnt):

# cd /usr/src
# tar xvfz /mnt/src.tar.gz

After this, /usr/src will be a checkout area where all cvs(1) commands
will work OK. Refer to http://www.OpenBSD.org/anoncvs.html for more
details.

CD#3 also contains the following:
Changelogs/      This is all of the CVS commit logs we have generated while
		 working on the project.
ports.tar.gz     Our ports tree. Refer to CD3:/PORTS
xenocara.tar.gz  A CVS checkout of our version of the X source tree.

Important man pages to read are config(8) and options(4), which will
describe in detail how kernels are built.

Further Notes:

To make a floppy on a Unix system, use "dd if=<file> of=/dev/<device> bs=32k"
(where device could be "floppy" or "rfd0c" or "rfd0a").  Use properly
formatted perfect floppies with NO BAD BLOCKS or you will lose.

Installing Packages

The OpenBSD CD-ROM ships with several applications pre-built for various
hardware architectures.  We call these things packages.  The number of
applications vary according to available disk space.  Check the
directory 4.6/packages/<arch> to see which packages are available for
your hardware architecture.

To install one or more of these packages you must
1) become the superuser (root)
2) mount the appropriate CD-ROM
3) use the ``pkg_add'' command to install the software

Example (in which we use su(1) to get superuser privileges, thus you
have to be in group "wheel", see the manual page for su(1)).

$ su
Password: <enter your root password>
# mkdir -p /cdrom
# mount /dev/cd0a /cdrom
# cd /cdrom/4.6/packages/<arch>
# pkg_add <package-name1> <package-name2> ...
# <add more packages if desired>
# umount /cdrom

Your hardware architecture can be determined by issuing the command
``arch''.  The response will be something like ``OpenBSD.sparc''.
``sparc'' is the architecture.  The various m68k architectures share packages.

Package names are usually the application name and version with .tgz
appended, e.g. emacs-21.4p8.tgz.  Some packages can not be placed on the
CD-ROM due to patent or other restrictions.  To obtain such packages use
the command:

# pkg_add ftp://ftp.openbsd.org/pub/OpenBSD/4.6/packages/<arch>/<package-name>

File System Layout

Starting with OpenBSD 4.6, the installer has automatic disk partitioning.
If your disk is large enough, it will give you a number of partitions
for different purposes.  It is better to have multiple partitions because
the installer will automatically turn on the 'nosetuid' and 'nodev' flags
for mountpoints which do not need these abilities, thus increasing your
system security.

OpenBSD is free software

You can do with it as you like, subject to very few conditions
(described at www.OpenBSD.org/policy.html).  But free software isn't
written without money. Network links, hardware costs, release
engineering and testing work; all these things take money and
significant effort on the part of those who have made this what it is.
Please reward the developers who have made OpenBSD what it is, YOU can
donate funds or hardware to get your name listed on our Donations page
www.OpenBSD.org/donations.html. Contact Theo de Raadt or send a donation
cheque in Canadian or US funds to:

OpenBSD
812 - 23rd Ave SE
Calgary, Alberta
Canada T2G 1N8

(Make the cheque out to "Theo de Raadt": cheques made out to "OpenBSD"
cannot be cashed)

No major funding or cost-sharing of the project comes from any company
or educational institution. Theo works full-time on improving OpenBSD
and paying bills, many other developers expend spend significant
quantities of time as well.

For those unable to make their contributions as straightforward gifts,
the OpenBSD Foundation (http://www.openbsdfoundation.org) is a Canadian
not-for-profit corporation that can accept larger contributions and
issue receipts.  In some situations, their receipt may qualify as a
business expense writeoff, so this is certainly a consideration for
some organizations or businesses.  There may also be exposure benefits
since the Foundation may be interested in participating in press releases.
In turn, the Foundation then uses these contributions to assist OpenBSD's
infrastructure needs.  Contact the foundation directors at
directors@openbsdfoundation.org for more information.

Ongoing operating funds for the project are generated by sales of CDs,
tshirts, and posters, so if you like yours, please buy one for a friend.

Please be generous, and OpenBSD will keep making a release every 6
months.  This is our 26th release on CDROM, and we certainly hope we
can continue!

- Thanks to everyone who has purchased an OpenBSD CD-ROM.