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