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