The first cut of news68k install notes. Needs more enhancement.
XXX How can we sync "contents" files on all ports?
This commit is contained in:
tsutsui
parent
09e4bbfffd
commit
289fd8c28e
3
distrib/notes/news68k/Makefile
Normal file
3
distrib/notes/news68k/Makefile
Normal file
@ -0,0 +1,3 @@
|
||||
# $NetBSD: Makefile,v 1.1 2000/06/14 10:34:29 tsutsui Exp $
|
||||
|
||||
.include <bsd.prog.mk>
|
||||
288
distrib/notes/news68k/contents
Normal file
288
distrib/notes/news68k/contents
Normal file
@ -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 /.
|
||||
.
|
||||
.
|
||||
.
|
||||
.
|
||||
48
distrib/notes/news68k/hardware
Normal file
48
distrib/notes/news68k/hardware
Normal file
@ -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/
|
||||
2
distrib/notes/news68k/install
Normal file
2
distrib/notes/news68k/install
Normal file
@ -0,0 +1,2 @@
|
||||
.\" $NetBSD: install,v 1.1 2000/06/14 10:34:31 tsutsui Exp $
|
||||
.so ../common/sysinst
|
||||
2
distrib/notes/news68k/legal
Normal file
2
distrib/notes/news68k/legal
Normal file
@ -0,0 +1,2 @@
|
||||
.\" $NetBSD: legal,v 1.1 2000/06/14 10:34:31 tsutsui Exp $
|
||||
|
||||
6
distrib/notes/news68k/prep
Normal file
6
distrib/notes/news68k/prep
Normal file
@ -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.
|
||||
3
distrib/notes/news68k/upgrade
Normal file
3
distrib/notes/news68k/upgrade
Normal file
@ -0,0 +1,3 @@
|
||||
.\" $NetBSD: upgrade,v 1.1 2000/06/14 10:34:32 tsutsui Exp $
|
||||
.
|
||||
.so ../common/upgrade
|
||||
3
distrib/notes/news68k/whatis
Normal file
3
distrib/notes/news68k/whatis
Normal file
@ -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.
|
||||
114
distrib/notes/news68k/xfer
Normal file
114
distrib/notes/news68k/xfer
Normal file
@ -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
|
||||
Loading…
Reference in New Issue
Block a user