From 289fd8c28eb9bfd79cc6d74bcba01fcd4bdc7659 Mon Sep 17 00:00:00 2001 From: tsutsui Date: Wed, 14 Jun 2000 10:34:29 +0000 Subject: [PATCH] The first cut of news68k install notes. Needs more enhancement. XXX How can we sync "contents" files on all ports? --- distrib/notes/news68k/Makefile | 3 + distrib/notes/news68k/contents | 288 +++++++++++++++++++++++++++++++++ distrib/notes/news68k/hardware | 48 ++++++ distrib/notes/news68k/install | 2 + distrib/notes/news68k/legal | 2 + distrib/notes/news68k/prep | 6 + distrib/notes/news68k/upgrade | 3 + distrib/notes/news68k/whatis | 3 + distrib/notes/news68k/xfer | 114 +++++++++++++ 9 files changed, 469 insertions(+) create mode 100644 distrib/notes/news68k/Makefile create mode 100644 distrib/notes/news68k/contents create mode 100644 distrib/notes/news68k/hardware create mode 100644 distrib/notes/news68k/install create mode 100644 distrib/notes/news68k/legal create mode 100644 distrib/notes/news68k/prep create mode 100644 distrib/notes/news68k/upgrade create mode 100644 distrib/notes/news68k/whatis create mode 100644 distrib/notes/news68k/xfer diff --git a/distrib/notes/news68k/Makefile b/distrib/notes/news68k/Makefile new file mode 100644 index 000000000000..bc790ed4f609 --- /dev/null +++ b/distrib/notes/news68k/Makefile @@ -0,0 +1,3 @@ +# $NetBSD: Makefile,v 1.1 2000/06/14 10:34:29 tsutsui Exp $ + +.include diff --git a/distrib/notes/news68k/contents b/distrib/notes/news68k/contents new file mode 100644 index 000000000000..865d48e0be89 --- /dev/null +++ b/distrib/notes/news68k/contents @@ -0,0 +1,288 @@ +.\" $NetBSD: contents,v 1.1 2000/06/14 10:34:30 tsutsui Exp $ +.\" +.\" Copyright (c) 1999, 2000 The NetBSD Foundation, Inc. +.\" All rights reserved. +.\" +.\" Redistribution and use in source and binary forms, with or without +.\" modification, are permitted provided that the following conditions +.\" are met: +.\" 1. Redistributions of source code must retain the above copyright +.\" notice, this list of conditions and the following disclaimer. +.\" 2. Redistributions in binary form must reproduce the above copyright +.\" notice, this list of conditions and the following disclaimer in the +.\" documentation and/or other materials provided with the distribution. +.\" 3. All advertising materials mentioning features or use of this software +.\" must display the following acknowledgement: +.\" This product includes software developed by the NetBSD +.\" Foundation, Inc. and its contributors. +.\" 4. Neither the name of The NetBSD Foundation nor the names of its +.\" contributors may be used to endorse or promote products derived +.\" from this software without specific prior written permission. +.\" +.\" THIS SOFTWARE IS PROVIDED BY THE NETBSD FOUNDATION, INC. AND CONTRIBUTORS +.\" ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED +.\" TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR +.\" PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE FOUNDATION OR CONTRIBUTORS +.\" BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR +.\" CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF +.\" SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS +.\" INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN +.\" CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) +.\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE +.\" POSSIBILITY OF SUCH DAMAGE. +.\" +.ds m \*[MACHINE] +.Ss2 NetBSD/\*m Subdirectory Structure +The \*m-specific portion of the +.Nx \*V +release is found in the +.Pa \*m +subdirectory of the distribution: +.ie \n[_FOR_RELEASE] .Pa \&.../NetBSD-\*V/\*m/ +.el .Pa Pf \&.../arch/\*m/snapshot/ Ar yyyymmdd/ +.Bl -tag -compact -width INSTALL.html +. It Pa INSTALL.html +. It Pa INSTALL.ps +. It Pa INSTALL.txt +. It Pa INSTALL.more +Installation notes; this file. The +.Pa \&.more No file contains underlined text using the +.Xr more 1 +conventions for indicating italic and bold display. +. It Pa binary/ +. Bl -tag -compact -width diskimage/ +. It Pa sets/ +\*m binary distribution sets; +see below. +. It Pa kernel/ +\*m installation kernels. +. It Pa security/ +\*m security distribution; see below. +. El +. It Pa installation/ +.\" BTW, .Bl ... .El is not allowed unless there is at least one .It. +. +.\"============================================ MD INSTALLATION SUBTREE +. +. Bl -tag -compact -width diskimage/ +. It Pa floppy/ +\*m boot and installation floppy; see below. +. It Pa kernel/ +.No contains a Pa netbsd-INSTALL.gz +installation kernel; this is the same installer kernel as in the +install image, but without the various boot program and filesystem +wrappers. It can be netbooted or diskbooted from a previous installation. +. El +. +.El +. +. +. +.if r_news68k \{\ +.Ss2 Bootable installation floppy +.Pp +There is a bootable image in the +.Nx +\*m distribution. +This is a single-file image containing the install kernel, +which includes ramdisk root filesystem image. +.\} +. +.Ss2 Binary Distribution Sets +The +.Nx +\*m +binary distribution sets contain the binaries which +comprise the +.Nx \*V +release for the \*m. There are eight binary distribution +.ie r_pc532 sets. +.el .No sets and the Em security No distribution set. +The binary distribution sets can be found in the +.Pa \*m/binary/sets +subdirectory +of the +.Nx \*V +distribution tree, and are as follows: +.Bl -tag -width mmmmmmmmmmm -compact +.Pp +.It Sy base +The +.Nx \*V +.No \*m Sy base No binary distribution. You +.Em must +install this distribution set. It contains the base +.Nx +utilities that are necessary for the +system to run and be minimally functional. It +includes shared library support, and excludes +everything described below. +.br +.if r_news68k .Em 12.9M gzipped, 40.1M uncompressed +.Pp +.It Sy comp +Things needed for compiling programs. This set +includes the system include files +.Pq Pa /usr/include +and the various system libraries (except the shared +libraries, which are included as part of the +.Sy base +set). This set also includes the manual pages for +all of the utilities it contains, as well as the +system call and library manual pages. +.br +.if r_news68k .Em 13M gzipped, 50M uncompressed +.Pp +.It Sy etc +This distribution set contains the system +configuration files that reside in +.Pa /etc +and in several other places. This set +.Em must +be installed if you are installing the system from scratch, but should +.Em not +be used if you are upgrading. (If you are upgrading, +it's recommended that you get a copy of this set and +.Em carefully +upgrade your configuration files by hand.) +.br +.if r_news68k .Em 56K gzipped, 330K uncompressed +.Pp +.It Sy games +This set includes the games and their manual pages. +.br +.if r_news68k .Em 2.8M gzipped, 7M uncompressed +. +.\" garden variety kern set description +. +.if !\n[arm32]:\n[atari]:\n[mac68k]:\n[sun3] \{\ +.Pp +.It Sy kern +This set contains a NetBSD/\*m \*V +.Tn GENERIC No kernel, named Pa /netbsd . +.No You Em must +install this distribution set. +.br +.if r_news68k .Em 532k gzipped, 1.1M uncompressed +.\} +.Pp +.It Sy man +This set includes all of the manual pages for the +binaries and other software contained in the +.Sy base +set. +Note that it does not include any of the manual pages +that are included in the other sets. +.br +.\" Contrary to popular belief, these aren't MI yet.... +.\" .Em 4.0M gzipped, 15.9M uncompressed +.if r_news68k .Em 3.9M gzipped, 15.6M uncompressed +.Pp +.It Sy misc +This set includes the (rather large) system dictionaries, +the typesettable document set, and other files from +.Pa /usr/share . +.br +.\" Contrary to popular belief, these aren't (quite!) MI yet.... +.\" .Em 2.1M gzipped, 8.5M uncompressed +.if r_news68k .Em 2.2M gzipped, 8.5M uncompressed +.Pp +.It Sy text +This set includes NetBSD's text processing tools, +including +.Xr groff 1 , +all related programs, and their manual pages. +.br +.if r_news68k .Em 1.3M gzipped, 4.5M uncompressed +.El +. +. +.el \{\ +.Pp +The \*m security distribution set is named +.Sy secr No and can be found in the +.D1 Pa \*m/binary/security +subdirectory of the +.Nx \*V +distribution tree. It contains security-related binaries +which depend on cryptographic source code. You do not need this +distribution set to use encrypted passwords in your password file; the +.Sy base +distribution includes a crypt library which can perform +only the one-way encryption function. The security distribution +includes a version of the Kerberos IV network security system, and +a Kerberized version of +.Xr telnet 1 +.No program. The Sy secr +distribution set can be found only on those sites which carry the complete +.Nx +distribution and which can legally obtain it. Because +of United States law, it may not be legal to distribute this set +to locations outside of the United States and Canada. +.br +.if r_alpha .Em 1M gzipped, 3M uncompressed +.if r_i386 . Em 798K gzipped, 2.4M uncompressed +.\} +. +. +.Pp +.Nx +maintains its own set of sources for the X Window System in order to +assure tight integration and compatibility. +These sources are based on XFree86, and tightly track XFree86 releases. +They are currently equivalent to XFree86 3.3.6. +Binary sets for the X Window system are distributed with +.Nx . +.if r_news68k \{\ +Unfortunately, there is no framebuffer support on NetBSD/news68k yet, +so we can only distribute the X clients this time. +.\} +The sets are: +.Bl -tag -width xcontribmmm +.It Sy xbase +The basic files needed for a complete X +client environment. This does not include +the X servers. +.br +.if r_news68k .Em 2.4M gzippeed, 7.7M uncompressed +.It Sy xcomp +The extra libraries and include files needed to compile X source code. +.br +.if r_news68k .Em 1.6M gzipped, 6.8M uncompressed +.It Sy xcontrib +Programs that were contributed to X. +.br +.if r_news68k .Em 179k gzipped, 670k uncompressed +.br +.\" Contrary to popular belief, these aren't MI yet.... +.\" .Em 5.5M gzipped, 6.8M uncompressed +. +. +.El +. +.\"============================ MI DISCUSSION OF BINARY SETS +. +.Pp +The \*m binary distribution sets are distributed as gzipped tar files +named with the extension +.Sy .tgz , No e.g. +.Pa base.tgz . +. +. +. +. +.Pp +The instructions given for extracting the source sets work equally +well for the binary sets, but it is worth noting that if you use that +method, the files are /-relative and +therefore are extracted +.Em below +the current directory. That +is, if you want to extract the binaries into your system, i.e. +replace the system binaries with them, you have to run the +.Ic tar xfp +command from /. +. +. +. +. diff --git a/distrib/notes/news68k/hardware b/distrib/notes/news68k/hardware new file mode 100644 index 000000000000..c8cddd778e0e --- /dev/null +++ b/distrib/notes/news68k/hardware @@ -0,0 +1,48 @@ +.\" $NetBSD: hardware,v 1.1 2000/06/14 10:34:30 tsutsui Exp $ +NetBSD/news68k \*V will run on single m68030-based Sony NEWS workstations. +They include the NWS-14x0, NWS-15x0, PWS-15x0, NWS-17x0, +and NWS-12x0 machines. NetBSD/news68k does not currently support +m68020-based machines (NWS-700, NWS-800) nor I/O processor based +machines (NWS-800, NWS-1800). +.Pp +NetBSD/news68k \*V does not support any framebuffers so +.Em you have to use serial console +to install NetBSD/news68k. +.Pp +NetBSD/news68k \*V does not support SCSI on NWS-12x0 machines, +so installations on NWS-12x0 must use a remote NFS filesystem. +.Pp +MIPS based NEWS workstations (NWS-3xxx or NWS-5000) are +supported by NetBSD/newsmips. +.Pp +The following NEWS hardware is supported: +.de section +. El +. Pp +. It Em \\$* +. br +. Bl -bullet -compact +.. +.de item +. It +\\$* +.. +.Bl -tag -width Disks +. It Em CPUs: +. br +. Bl -bullet -compact +. item 68020-based: none. +. item 68030-based: NWS-12x0, NWS-14x0, NWS-15x0, PWS-15x0, NWS-17x0 +. section RS232 interfaces: +. item built in Zilog 8530 Serial Communication Controllers (zsc). +. section Network interfaces: +. item built in LANCE Ethernet (le). +. section SCSI interfaces: +. item built in CXD1180 SCSI interface (si) +. item most SCSI devices +. El +.El +.Pp +If it's not on this list, there is no official support for it in this release. +More information can also be found at NetBSD/news68k homepage: +.Lk http://www.netbsd.org/Ports/news68k/ diff --git a/distrib/notes/news68k/install b/distrib/notes/news68k/install new file mode 100644 index 000000000000..d26819d5dbcc --- /dev/null +++ b/distrib/notes/news68k/install @@ -0,0 +1,2 @@ +.\" $NetBSD: install,v 1.1 2000/06/14 10:34:31 tsutsui Exp $ +.so ../common/sysinst diff --git a/distrib/notes/news68k/legal b/distrib/notes/news68k/legal new file mode 100644 index 000000000000..69d8e92b2fdb --- /dev/null +++ b/distrib/notes/news68k/legal @@ -0,0 +1,2 @@ +.\" $NetBSD: legal,v 1.1 2000/06/14 10:34:31 tsutsui Exp $ + diff --git a/distrib/notes/news68k/prep b/distrib/notes/news68k/prep new file mode 100644 index 000000000000..1643b21a100a --- /dev/null +++ b/distrib/notes/news68k/prep @@ -0,0 +1,6 @@ +.\" $NetBSD: prep,v 1.1 2000/06/14 10:34:31 tsutsui Exp $ +. +First and foremost, before beginning the installation process, +.Em make sure you have a reliable backup +of any data on your hard disk that you wish to keep. Mistakes in +partitioning your hard disk may lead to data loss. diff --git a/distrib/notes/news68k/upgrade b/distrib/notes/news68k/upgrade new file mode 100644 index 000000000000..0dc143b3e5eb --- /dev/null +++ b/distrib/notes/news68k/upgrade @@ -0,0 +1,3 @@ +.\" $NetBSD: upgrade,v 1.1 2000/06/14 10:34:32 tsutsui Exp $ +. +.so ../common/upgrade diff --git a/distrib/notes/news68k/whatis b/distrib/notes/news68k/whatis new file mode 100644 index 000000000000..0c739836f32f --- /dev/null +++ b/distrib/notes/news68k/whatis @@ -0,0 +1,3 @@ +.\" $NetBSD: whatis,v 1.1 2000/06/14 10:34:32 tsutsui Exp $ +This is the first public release of NetBSD for the Sony's m68k based +"NET WORK STATION" series of computers. diff --git a/distrib/notes/news68k/xfer b/distrib/notes/news68k/xfer new file mode 100644 index 000000000000..6ed52ba03902 --- /dev/null +++ b/distrib/notes/news68k/xfer @@ -0,0 +1,114 @@ +.\" $NetBSD: xfer,v 1.1 2000/06/14 10:34:32 tsutsui Exp $ +. +NOTE: NetBSD/news68k \*V does not support any framebuffers (yet) so +you have to use serial console on installation procedure. +.Pp +No matter which installation medium you choose, you'll need to have a +1.44M floppy disk. You'll put the boot floppy image onto this disk, +which contains software to install +.Nx +system. +.Pp +If you are using a UN*X-like system (such as NEWS-OS or other +.Nx +machines) to write the floppy images to disks, you should use the +.Xr dd 1 +command to copy the file system image(s) +(.fs file) directly to the raw floppy disk. It is suggested that you +read the +.Xr dd 1 +manual page or ask your system administrator to determine the correct +set of arguments to use; it will be slightly different from system to +system, and a comprehensive list of the possibilities is beyond the +scope of this document. +.Pp +If you have some i386 machine which runs +.Tn DOS +and use them to write the floppy image(s) to floppy disk, +you can use the +.Li rawrite +utility, provided in the +.Pa i386/utilities +directory of the +.Nx +distribution. It will write a file system image (.fs file) to a floppy +disk. +.Pp +Though NetBSD/news68k uses the floppy disk to boot for the initial +installation, NetBSD/news68k kernel does not support any +floppy device. Some other machines or systems are still required +to write floppy images even after NetBSD/news68k have been installed. +.Pp +SCSI devices on NWS-12x0 machines are not supported (yet), so they +can only run NetBSD/news68k as diskless. No file transfer is +needed, and all you have to do is to prepare files on the server. +More information about diskless setting can be found at +.Lk http://www.netbsd.org/Documentation/network/netboot/ +.Pp +The NEWS +.Tn PROM No Ns s +supports also tape boot and network boot, but NetBSD/news68k does not +support them currently. +.Pp +After the boot floppy is prepared, just type "bo fh" on the PROM prompt +to boot it. +.Pp +Installation is supported from several media types, including: +.Bl -bullet -compact +.It +NFS partitions +.It +FTP +.It +CD-ROM +.El +.Pp +The steps necessary to prepare the distribution sets +for installation depend on which installation medium you choose. +The steps for the various media are outlined below. +.Pp +.Bl -tag -width NFS\ Installation +. +.It Em NFS Installation +Place the NetBSD distribution sets you wish to install into a directory +on an NFS server, and make that directory mountable by the machine +on which you are installing or upgrading NetBSD. This will probably +require modifying the +.Pa /etc/exports +file on of the NFS server and resetting its mount daemon (mountd). +Both of these actions will probably require superuser +privileges on the server. +.Pp +You will need to know the IP address of your nameserver or of your NFS +server, and, if the server is not on a network directly connected to the +machine on which you're installing or upgrading NetBSD, you need to know +the IP address of the closest router . Finally, you need to know the IP +address of the NetBSD machine itself. The install program will ask you +to provide this information to be able to access the sets via NFS. +.Pp +If you are using a diskless setup to install NetBSD on your machine, +you can take advantage of the fact that the above has already been done +on your machine's server. So, you can conveniently put the NetBSD file +sets in your machine's root filesystem on the server where the install +program can find them. +.Pp +Once the NFS server is set up properly and you have the information +mentioned above, you can start the actual installation process. +. +.It Em FTP Installation +Determine an FTP site from which you can retrieve the NetBSD +distribution when you're about to install. You will need to know the +IP address of your nameserver or of your ftp site, and, if it's not on +a network directly connected to the machine on which you're installing +or upgrading NetBSD, you need to know the IP address of the closest +router. Finally, you need to know the IP address of the NetBSD machine +itself. The install program will ask you to provide this information to +be able to access the sets via ftp. +.Pp +Once you have this information, you can proceed to the actual +installation. +. +.It Em CD-ROM Installation +If you are installing from a CD-ROM, the distribution sets are +already in the proper format and no special handling is required. +.El