xref: /openbsd/distrib/notes/i386/install (revision 78b63d65)
1OpenBSDInstallPrelude
2
3If OpenBSD will be sharing the disk with DOS or another operating
4system, you should have already completed the section of these notes
5that instructed you on how to prepare your hard disk.  You should know
6the size of the OpenBSD area of the disk and its offset from the
7beginning of the disk.  You will need this information when setting up
8your OpenBSD partitions.  If your BIOS uses translated geometry, you
9should use this geometry for the remainder of the install.  This is
10only necessary if you are sharing the disk with other operating systems
11that use the translated geometry.
12
13There are several ways to install OpenBSD onto a disk.  The easiest way,
14should your computer support it, is to boot off the CD-ROM.  Otherwise,
15you can boot from a 3.5" 1.44MB floppy disk.
16
17OpenBSDInstallPart2
18
19	With either the CD-ROM or the floppy in the drive, reboot your
20	computer. You might have to play with your BIOS options to let the
21	computer boot from the installation media, rather than the hard
22	disk.
23
24	It will take a while to load the kernel from a floppy or slow
25	speed CD-ROM drive, most likely more than a minute.  If some
26	action doesn't eventually happen, or the spinning cursor has
27	stopped and nothing further has happened, either your boot floppy
28	is bad or you are having hardware problems. If trying another
29	floppy disk doesn't help, try booting after disabling your CPU's
30	internal and external caches (if any).  If it still doesn't work,
31	OpenBSD probably can't be run on your hardware.  This can probably
32	be considered a bug, so you might want to report it.
33	If you do, please {:-include-:} as many details about your system
34	configuration as you can.
35
36
37OpenBSDBootMsgs
38
39	You will next be asked for your terminal type.  You should just
40	hit return to select the default (vt220).
41
42	Now you will be asked whether you wish to do an "install"
43	or an "upgrade".  Enter 'i' for a fresh install or 'u' to
44	upgrade an existing installation.
45
46	You will be presented with a welcome message and asked if
47	you really wish to install (or upgrade).
48
49	The install program will then tell you which disks of that
50	type it can install on, and ask you which it should use.  The
51	name of the disk is typically "wd0" for IDE/RLL/ESDI/ST506
52	drives or "sd0" for SCSI drives.  Reply with the name of your
53	disk.
54
55	Next you will have to edit or create a disk label for the disk
56	OpenBSD is being installed on.  If there are any existing
57	partitions defined (for any operating system), and a disk label
58	is not found, you will first be given an opportunity to run
59	fdisk and create an OpenBSD partition.
60
61	If fdisk is being invoked on your behalf, it will start by
62	displaying the current partitions defined and then allow you
63	to modify this information, add new partitions and change
64	which partition to boot from by default.  If you make a mistake,
65	you will be allowed to repeat this procedure as necessary to
66	correct this.  Note that you should make OpenBSD be the active
67	partition at least until the install has been completed.
68
69	Next the disk label which defines the layout of the OpenBSD
70	file systems must be set up.  The installation script will
71	invoke an interactive editor allowing you to do this.  Note
72	that partition 'c' inside this disk label should ALWAYS
73	reflect the entire disk, including any non-OpenBSD portions.
74	If you are labeling a new disk, you will probably start
75	out with an 'a' partition that spans the disk.  In this case
76	You should delete 'a' before adding new partitions.
77	The root file system should be in partition 'a', and swap
78	is usually in partition 'b'.  If you have DOS or Linux
79	partitions defined on the disk, these will usually show up
80	as partition 'h', 'i' and so on.  It is recommended that
81	you create separate partitions for /usr, /tmp, and /var, and
82	if you have room for it, one for /home.  In doing this, remember
83	to skip 'c', leaving it as type "unused".  Create your next
84	partition as 'd' and continue from there with any additional
85	partitions.  If you have DOS or Linux partitions defined on the
86	disk, these will usually show up as partition 'h', 'i', and
87	so on.
88
89	When you are finished with disklabel you will be prompted for
90	the mount points for the partitions in the current label.
91	For help in the disk label editor, enter '?' or 'M' to view
92	the manual page (see the info on the ``-E'' flag).
93
94	Note that all OpenBSD partitions in the disk label must have an
95	offset that makes it start within the OpenBSD part of the disk,
96	and a size that keeps it inside of that portion of the disk.  This
97	is within the bounds of the 'c' partition if the disk is not being
98	shared with other operating systems, and within the OpenBSD fdisk
99	partition if the disk is being shared.
100
101	The swap partition (usually 'b') should have a type of "swap", all
102	other native OpenBSD partitions should have a type of "4.2BSD".
103	Block and fragment sizes are usually 8192 and 1024 bytes, but can
104	also be 4096 and 512 or even 16384 and 2048 bytes.
105
106	The install program will now label your disk and ask which file
107	systems should be created on which partitions.  It will auto-
108	matically select the 'a' partition to be the root file system.
109	Next it will ask for which disk and partition you want a file
110	system created on.  This will be the same as the disk name (e.g.
111	"wd0") with the letter identifying the partition (e.g. "d")
112	appended (e.g. "wd0d").  Then it will ask where this partition is
113	to be mounted, e.g. /usr.  This process will be repeated until
114	you enter "done".
115
116	At this point you will be asked to confirm that the file system
117	information you have entered is correct, and given an opportunity
118	to change the file system table.  Next it will create the new file
119	systems as specified, OVERWRITING ANY EXISTING DATA.  This is the
120	point of no return.
121
122	After all your file systems have been created, the install program
123	will give you an opportunity to configure the network.  The network
124	configuration you enter (if any) can then be used to do the install
125	from another system using HTTP or FTP, and will also be the
126	configuration used by the system after the installation is complete.
127
128	If you select to configure the network, the install program will
129	ask you for a name of your system and the DNS domain name to use.
130	Note that the host name should be without the domain part, and that
131	the domain name should NOT {:-include-:} the host name part.
132
133	Next the system will give you a list of network interfaces you can
134	configure.  For each network interface you select to configure, it
135	will ask for the IP address to use, the symbolic host name to use,
136	the netmask to use and any interface-specific flags to set.  The
137	interface-specific flags are usually used to determine which media
138	the network card is to use.  The flags usually carry the following
139	meaning:
140
141		-link0 -link1	Use BNC (coaxial) port [default]
142		link0 -link1	Use AUI port
143		link0 link1	Use UTP (twisted pair) port
144
145	After all network interfaces have been configured the install pro-
146	gram will ask for a default route and IP address of the primary
147	name server to use.  You will also be presented with an opportunity
148	to edit the host table.
149
150	At this point you will be allowed to edit the file system table
151	that will be used for the remainder of the installation and that
152	will be used by the finished system, following which the new file
153	systems will be mounted to complete the installation.
154
155	After these preparatory steps have been completed, you will be
156	able to extract the distribution sets onto your system.  There
157	are several install methods supported; FTP, HTTP, tape, CD-ROM,
158	or a local disk partition.  Note that installation from floppies
159	is not currently supported.
160
161OpenBSDFTPInstall
162
163OpenBSDHTTPInstall
164
165OpenBSDTAPEInstall
166
167OpenBSDCDROMInstall
168
169OpenBSDDISKInstall({:-"wdN" or -:},,{:- or MS-DOS-:})
170
171OpenBSDCommonFS
172
173OpenBSDCommonURL
174
175OpenBSDCongratulations
176