[src/trunk]: src/distrib/notes/next68k install documentation for the next68k ...

[dbj <dbj%NetBSD.org@localhost>]

details:   https://anonhg.NetBSD.org/src/rev/e3ec4db4151c
branches:  trunk
changeset: 472190:e3ec4db4151c
user:      dbj <dbj%NetBSD.org@localhost>
date:      Sat Apr 24 18:47:14 1999 +0000

description:
install documentation for the next68k port, contributed by Matt Debergalis

diffstat:

 distrib/notes/next68k/hardware |  42 ++++++++++++++++++++++++
 distrib/notes/next68k/install  |  73 ++++++++++++++++++++++++++++++++++++++++++
 distrib/notes/next68k/legal    |   7 ++++
 distrib/notes/next68k/prep     |   3 +
 distrib/notes/next68k/upgrade  |  34 +++++++++++++++++++
 distrib/notes/next68k/whatis   |   3 +
 distrib/notes/next68k/xfer     |  44 +++++++++++++++++++++++++
 7 files changed, 206 insertions(+), 0 deletions(-)

diffs (234 lines):

diff -r 056335ac2da0 -r e3ec4db4151c distrib/notes/next68k/hardware
--- /dev/null   Thu Jan 01 00:00:00 1970 +0000
+++ b/distrib/notes/next68k/hardware    Sat Apr 24 18:47:14 1999 +0000
@@ -0,0 +1,42 @@
+.\"    $NetBSD: hardware,v 1.1 1999/04/24 18:47:14 dbj Exp $
+NetBSD/next68k \*V will run on 68040-based non-turbo NeXT workstations.
+This include the NeXTstation and NeXTstation Color slabs, and the
+non-Turbo NeXT Cube.  NetBSD/next68k does not currently support 68030
+machines or Turbo (33 MHz) machines.  NetBSD/next68k \*V does not
+have complete scsi support, so installations must use a remote NFS
+filesystem.
+.Pp
+The following NeXT 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 68030-based: none.
+.              item 68040-based: NeXTstation, NeXTstation color, NeXT Cube.
+.      section RS232 interfaces:
+.              item built in A and B serial ports (zsc).
+.      section Network interfaces:
+.              item built in ethernet (xe).
+.      section Displays:
+.              item NeXT monochrome display (nextdisplay).
+.      section Input devices:
+.              item NeXT non-adb keyboard (nextkbd).
+.      section Miscellaneous:
+.              item Battery-backed real-time clock.
+.      El
+.El
+.Pp
+.Bl -tag -width (***)
+.El
+If it's not on this list, there is no official support for it in this release.
diff -r 056335ac2da0 -r e3ec4db4151c distrib/notes/next68k/install
--- /dev/null   Thu Jan 01 00:00:00 1970 +0000
+++ b/distrib/notes/next68k/install     Sat Apr 24 18:47:14 1999 +0000
@@ -0,0 +1,73 @@
+.\"    $NetBSD: install,v 1.1 1999/04/24 18:47:14 dbj Exp $    
+.\"
+.\" Copyright (c) 1999 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.
+.\"
+Begin by creating an area in the server's filesystem for the
+NetBSD/next68k image.  This area must be exported read-write to the NeXT
+workstation.  In the simplest form of installation, the entire image is
+exported as a single partition, mounted on / by the target.  This
+corresponds to a local disk install with just one partition.  It is also
+possible to export /usr or other partitions seperately.  /usr can be
+exported read-only, and multiple machines can all share the same /usr
+partition.
+.Pp
+To extract the sets into the exported area:
+.Bd -literal -offset indent
+cd /path/to/exported/filesystem
+pax -zrvpe -f /path/to/base.tgz
+.Ed
+and repeat for any other sets you wish to install.  You'll almost
+certainly need the etc.tgz set.
+.Pp
+Edit the files in the etc directory to reflect reality.  rc.conf and
+fstab will certainly need to be edited.
+.Pp
+cd into the dev directory in the exported area and run
+.Bd -literal -offset indent
+sh ./MAKEDEV all
+.Ed
+to create the various device nodes.
+.Pp
+Create an empty swap file, and place it somewhere where it can also
+be exported to the target.
+.Pp
+Edit the server's /etc/exports file to export the root and swap
+partitions to the target.  Both must be read-write, and allow full root
+privileges.
+.Pp
+You'll also need to set up a tftp server and bootp server to enable
+netbooting.  These services don't have to run on the same machine that
+exports the target image, but it is often convenient to do so.  More
+information on configuring these services can be found at
+.Lk http://www.netbsd.org/Documentation/network/netboot/
+Note that your bootptab requires the tag "vm=auto" for bootpd
+to work with the NeXT.
diff -r 056335ac2da0 -r e3ec4db4151c distrib/notes/next68k/legal
--- /dev/null   Thu Jan 01 00:00:00 1970 +0000
+++ b/distrib/notes/next68k/legal       Sat Apr 24 18:47:14 1999 +0000
@@ -0,0 +1,7 @@
+.\"$NetBSD: legal,v 1.1 1999/04/24 18:47:14 dbj Exp $
+
+This product includes software developed by Darrin B. Jewell.
+
+This product includes software developed by Matt DeBergalis.
+
+This product includes software developed by Rolf Grossmann.
diff -r 056335ac2da0 -r e3ec4db4151c distrib/notes/next68k/prep
--- /dev/null   Thu Jan 01 00:00:00 1970 +0000
+++ b/distrib/notes/next68k/prep        Sat Apr 24 18:47:14 1999 +0000
@@ -0,0 +1,3 @@
+.\"    $NetBSD: prep,v 1.1 1999/04/24 18:47:15 dbj Exp $
+No preparation is necessary, since the NetBSD/next68k sets must be
+installed on a server.
diff -r 056335ac2da0 -r e3ec4db4151c distrib/notes/next68k/upgrade
--- /dev/null   Thu Jan 01 00:00:00 1970 +0000
+++ b/distrib/notes/next68k/upgrade     Sat Apr 24 18:47:14 1999 +0000
@@ -0,0 +1,34 @@
+.\"    $NetBSD: upgrade,v 1.1 1999/04/24 18:47:15 dbj Exp $
+.\"
+.\" Copyright (c) 1999 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.
+.\"
+NetBSD/\*m does not currently support an upgrade procedure.
diff -r 056335ac2da0 -r e3ec4db4151c distrib/notes/next68k/whatis
--- /dev/null   Thu Jan 01 00:00:00 1970 +0000
+++ b/distrib/notes/next68k/whatis      Sat Apr 24 18:47:14 1999 +0000
@@ -0,0 +1,3 @@
+.\"    $NetBSD: whatis,v 1.1 1999/04/24 18:47:15 dbj Exp $
+This is the first public release of NetBSD for the NeXT series of
+computers.
diff -r 056335ac2da0 -r e3ec4db4151c distrib/notes/next68k/xfer
--- /dev/null   Thu Jan 01 00:00:00 1970 +0000
+++ b/distrib/notes/next68k/xfer        Sat Apr 24 18:47:14 1999 +0000
@@ -0,0 +1,44 @@
+.\"    $NetBSD: xfer,v 1.1 1999/04/24 18:47:15 dbj Exp $       
+.\"
+.\" Copyright (c) 1999 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.
+.\"
+Because NetBSD/next68k must run diskless, the distribution must be
+installed to a remote machine that NFS exports to the NeXT machine.  As
+a result, there is no automated install procedure.  Begin by retrieving
+the netbsd set files onto the serving machine.  These can be found at
+ftp.NetBSD.ORG.  You may want to keep the following information handy:
+.Bd -ragged
+IP Address: ftp.NetBSD.ORG
+Login: anonymous
+Password: \*<your e-mail address\*>
+Server path: /pub/NetBSD/NetBSD-_VER/next68k/binary/sets
+.Ed