Annotation of www/23.html, Revision 1.41
1.1 deraadt 1: <!DOCTYPE HTML PUBLIC "-//IETF//DTD HTML Strict//EN">
2: <html>
3: <head>
1.33 deraadt 4: <title>OpenBSD 2.3</title>
1.41 ! tb 5: <meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1">
! 6: <meta name="description" content="OpenBSD 2.3">
1.26 jufi 7: <meta name="copyright" content="This document copyright 1996-2001 by OpenBSD.">
1.41 ! tb 8: <meta name="viewport" content="width=device-width, initial-scale=1">
! 9: <link rel="stylesheet" type="text/css" href="openbsd.css">
1.39 sthen 10: <link rel="canonical" href="http://www.openbsd.org/23.html">
1.1 deraadt 11: </head>
12:
1.29 david 13: <body bgcolor="#ffffff" text="#000000" link="#23238E">
1.1 deraadt 14:
1.41 ! tb 15: <h2>
! 16: <a href="index.html">
! 17: <font color="#0000ff"><i>Open</i></font><font color="#000084">BSD</font></a>
! 18: <font color="#e00000">2.3</font>
! 19: </h2>
1.1 deraadt 20:
1.33 deraadt 21: <a href=images/openbsd23_cover.gif>
1.41 ! tb 22: <img align=left src=images/cd23-s.gif height=90 width=90 hspace=20 vspace=60></a>
1.1 deraadt 23: <p>
1.7 deraadt 24: Released May 19, 1998.<br>
1.33 deraadt 25: Copyright 1997-1998, Theo de Raadt.<br>
26: <font color=#e00000>ISBN 0-9683637-1-7</font>.
1.1 deraadt 27: <p>
28: <ul>
1.8 deraadt 29: <li><strong>Order a CDROM from our ordering system.</strong>
1.33 deraadt 30: <li>See the information on <a href=ftp.html>The FTP page</a> for
31: a list of mirror machines
32: <li>Go to the <font color=#e00000>pub/OpenBSD/2.3/</font> directory on
33: one of the mirror sites
1.16 deraadt 34: <li>Have a look at <a href=errata23.html>The 2.3 Errata page</a> for a list
1.1 deraadt 35: of bugs and workarounds.
36: </ul>
1.41 ! tb 37: All applicable copyrights and credits are in the src.tar.gz,
! 38: sys.tar.gz, xenocara.tar.gz, ports.tar.gz files, or in the
! 39: files fetched via ports.tar.gz.
! 40: <br clear="all">
1.1 deraadt 41:
1.41 ! tb 42: <hr>
1.33 deraadt 43: <a name="install"></a>
44: <p>
45: <h3><font color="#0000e0">How to install</font></h3>
1.1 deraadt 46: <p>
1.9 deraadt 47: Following this are the instructions which you would have on a piece of
1.33 deraadt 48: paper if you had purchased a CDROM set instead of doing an alternate
49: form of install. The instructions for doing an FTP (or other style
50: of) install are very similar; the CDROM instructions are left intact
51: so that you can see how much easier it would have been if you had
52: purchased a CDROM instead.
1.1 deraadt 53: <p>
1.33 deraadt 54:
1.1 deraadt 55: <hr>
1.25 jsyn 56: Please refer to the following files on the two CDROMs for extensive
1.1 deraadt 57: details on how to install OpenBSD 2.3 on your machine:
58: <p>
59: <dl>
60: <li> CD1:2.3/i386/INSTALL.i386
61: <li> CD1:2.3/arc/INSTALL.arc
62: <li> CD1:2.3/mac68k/INSTALL.mac68k
63: <li> CD1:2.3/pmax/INSTALL.pmax
64: <li> CD1:2.3/sparc/INSTALL.sparc
65: <li> CD1:2.3/hp300/INSTALL.hp300
66: <p>
67: <li> CD2:2.3/amiga/INSTALL.amiga
68: <li> CD2:2.3/alpha/INSTALL.alpha
69: <li> CD2:2.3/mvme68k/INSTALL.mvme68k
70: <li> CD2:2.3/powerpc/INSTALL.powerpc
71: </dl>
72: <hr>
73: <p>
74: Quick installer information for people familiar with OpenBSD, and the
75: use of the new "disklabel -E" command. If you are at all confused when
76: installing OpenBSD, read the relevant INSTALL.* file as listed above!
77: <p>
78: <h3><font color=#e00000>i386:</font></h3>
79: <p>
80: Play with your BIOS options, and see if you can enable booting off a
1.4 deraadt 81: CD; try using CD1. If not, write CD1:2.3/i386/floppy23.fs to a
1.1 deraadt 82: floppy, then boot that. If you are mixing OpenBSD with another
83: operating system, you will surely need to read the INSTALL.i386
84: document.
85: <p>
86: To make a floppy under MS-DOS, use /2.3/tools/rawrite.exe. Under
1.22 wvdputte 87: Unix, use "dd if=<file> of=/dev/<device> bs=32k" (where device could
1.1 deraadt 88: be "floppy" or "rfd0c" or "rfd0a"). Use properly formatted perfect
89: floppies with NO BAD BLOCKS or you will lose.
90: <p>
91: <h3><font color=#e00000>ARC:</font></h3>
92: <p>
93: Using CD1, tell the BOOT ROM to load the file CD1:\2.3\arc\bsd.rd. If
94: that does not work, create a MS-DOS filesystem using your vendor's arc
95: setup program, copy CD1:2.3/arc/bsd.rd to there and attempt to boot
96: it.
97: <p>
98: <h3><font color=#e00000>SPARC:</font></h3>
99: <p>
100: To boot off CD1, type "boot cdrom 2.3/sparc/bsd.rd", or
101: "b sd(0,6,0)2.3/sparc/bsd.rd" depending on your ROM version.
1.4 deraadt 102: Alternatively, write CD1:2.3/sparc/floppy23.fs to a floppy and boot it
1.1 deraadt 103: using "boot fd()" or "boot floppy" depending on your ROM version.
104: Finally, a third alternative is to write CD1:2.3/sparc/kc.fs and
1.14 ryker 105: CD1:2.3/sparc/inst.fs to two separate floppies. Then insert "kc.fs",
1.1 deraadt 106: and boot as described above. As soon as the floppy drive ejects a
107: floppy, insert "inst.fs". Answer a bunch of questions. Reboot from
108: the "kc.fs" floppy. This time, when the floppy is ejected simply
109: re-insert "kc.fs" again and answer a different set of questions.
110: <p>
111: <h3><font color=#e00000>PMAX:</font></h3>
112: <p>
1.4 deraadt 113: Write the simpleroot23.fs onto the start of the disk using dd on another
1.1 deraadt 114: machine. After moving the disk drive, use "boot -f rz(0,0,0)/bsd"
115: (2100/3100) or "boot 5/rz0a/bsd" (5000). Alternatively, install via
116: network as described in detail in INSTALL.pmax.
117: <p>
118: <h3><font color=#e00000>AMIGA:</font></h3>
119: <p>
120: Create BSD partitions according to INSTALL.amiga's preparation section.
121: Mount the CD2 under AmigaOS as device CD0: Next, execute the following
122: CLI command: "CD0:2.3/amiga/utils/loadbsd CD0:2.3/amiga/bsd.rd".
123: <p>
124: <h3><font color=#e00000>HP300:</font></h3>
125: <p>
126: You can boot over the network by following the instructions in
127: INSTALL.hp300.
128: <p>
129: <h3><font color=#e00000>ALPHA:</font></h3>
130: <p>
131: Your alpha must use SRM firmware (not ARC). If you have a CDROM, you
132: can try "boot -fi 2.3/alpha/bsd.rd dkaX" (use "show device" to find your
133: CDROM drive identifier). Otherwise, write CD2:2.3/alpha/floppy.fs to a
134: floppy and boot that by typing "boot dva0". If this fails, you can place
135: bsd.rd on some other device and boot it, or use the provided simpleroot.
136: <p>
137: <h3><font color=#e00000>MAC68K:</font></h3>
138: <p>
139: Boot MacOS as normal and partition your disk with the appropriate A/UX
140: configurations. Then, extract the Macside utilities from
141: CD1:2.3/mac68k/utils onto your hard disk. Run Mkfs to create your
142: filesystems on the A/UX partitions you just made. Then, use the
143: BSD/Mac68k Installer to copy all the sets in CD1:2.3/mac68k/ onto your
144: partitions. Finally, you will be ready to configure the BSD/Mac68k
145: Booter with the location of your kernel and boot the system.
146: <p>
147: <h3><font color=#e00000>MVME68K:</font></h3>
148: <p>
149: Theo has no real idea. In the rush to get everything else done, the
150: install stuff for the mvme68k was never completed. Enough pieces are
151: included so that a really skilled person could find a way to install
152: it; perhaps using netbooting. Good luck!
153: <hr>
154: <p>
155: <h3><font color=#e00000>NOTES ABOUT THE SOURCE CODE:</font></h3>
156: <p>
157: src.tar.gz contains a source archive starting at /usr/src. This file
158: contains everything you need except for the kernel sources, which are
1.14 ryker 159: in a separate archive. To extract:
1.1 deraadt 160: <p>
161: <pre>
162: # mkdir -p /usr/src
163: # cd /usr/src
164: # tar xvfz /tmp/src.tar.gz
165: </pre>
166: <p>
167: srcsys.tar.gz contains a source archive starting at /usr/src/sys.
168: This file contains all the kernel sources you need to rebuild kernels.
169: To extract:
170: <p>
171: <pre>
172: # mkdir -p /usr/src/sys
1.18 deraadt 173: # cd /usr/src
1.1 deraadt 174: # tar xvfz /tmp/srcsys.tar.gz
175: </pre>
176: <p>
177: Both of these trees are a regular CVS checkout. Using these trees it
178: is possible to get a head-start on using the anoncvs servers as
179: described at <a href=anoncvs.html>http://www.OpenBSD.org/anoncvs.html</a>.
180: Using these files
181: results in a much faster initial CVS update than you could expect from
182: a fresh checkout of the full OpenBSD source tree.
183: <p>
184: <hr>
185: <p>
186: <h3><font color=#e00000>PORTS TREE</font></h3>
187: <p>
188: A ports tree archive is also provided. To extract:
189: <p>
190: <pre>
191: # cd /usr
192: # tar xvfz /tmp/ports.tar.gz
193: # cd ports
194: # ls
195: ...
196: </pre>
197: <p>
198: The ports/ subdirectory is a checkout of the OpenBSD ports tree. Go
1.31 jasper 199: read <a href=faq/faq15.html>http://www.OpenBSD.org/faq/faq15.html</a>
1.1 deraadt 200: if you know nothing about ports
201: at this point. This text is not a manual of how to use ports.
202: Rather, it is a set of notes meant to kickstart the user on the
203: OpenBSD ports system.
204: <p>
205: Certainly, the OpenBSD ports system is not complete. This is because
206: the full integration of ports into the OpenBSD environment is a very
207: young project as of this release. We believe the ports that are
208: provided here are stable, but it is most important to realize that
1.14 ryker 209: ports will continue to grow a great deal in functionality in the
1.1 deraadt 210: future.
211: <p>
212: As we said, ports will be growing a lot in the future. The ports/
213: directory represents a CVS (see the manpage for cvs(1) if you aren't
214: familiar with CVS) checkout of our ports. As with our complete source
215: tree, we will soon be making ports available via anoncvs. So, in
216: order to keep current with the, you must make the ports/ tree
217: available on a read-write medium and update the tree with a command
218: like:
219: <p>
220: <pre>
1.30 deraadt 221: # cd [portsdir]/; cvs -d anoncvs@server.openbsd.org:/cvs update -Pd
1.1 deraadt 222: </pre>
223: <p>
224: [Of course, you must replace the local directory and server name here
225: with the location of your ports collection and a nearby anoncvs
226: server.]
227: <p>
228: Again, it's important to see the webpage for specific instructions as
229: this is a very new service which hasn't yet been ironed out
230: completely.
231: <p>
232: Finally, despite ports' youth, help is never far. If you're
233: interested in seeing a port added, would like to help out, or just
234: would like to know more, the mailing list ports@openbsd.org is a good
235: place to know.
1.23 jufi 236:
237: </body>
238: </html>