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