xfer revision 1.2
1	$NetBSD: xfer,v 1.2 1998/01/09 18:48:10 perry Exp $	
2
3Installation is supported from several media types, including:
4
5	Magneto-Optical disk (MO)
6	Tape
7	Remote NFS partition
8	FTP
9
10No matter which installation medium you choose, you'll need to have
11a floppy disk.  On the first, you'll put the install or upgrade floppy
12image, depending on whether you're installing NetBSD for the first time,
13or upgrading a previous installation.
14
15If you are using a UN*X-like system to write the floppy images to
16disks, you should use the "dd" command to copy the file system images
17(.fs files) directly to the raw floppy disks.  It is suggested that
18you read the dd(1) manual page or ask your system administrator to
19determine the correct set of arguments to use; it will be slightly
20different from system to system, and a comprehensive list of the
21possibilities is beyond the scope of this document.
22
23If you are using Human68k to write the floppy images to disks, you should
24use the "rawrite" utility, provided in the "x68k/utils" directory
25of the NetBSD distribution.  It will write the file system images (.fs
26files) to disks.
27
28Note that, when installing, the install floppy MUST not be write-protected.
29The install program needs to write some temporary files, and if the
30disk is write-protected, it can't.  If you're upgrading your system,
31the upgrade floppy may be write-protected.
32
33Obviously, the steps necessary to prepare the distribution sets for
34installation or upgrade depend on which installation medium you
35choose.  The steps for the various media are outlined below.
36
37To install or upgrade NetBSD using MO, the MO media MUST be of the
38IBM `Super-floppy' format.  The Human68k format is not recognized by this
39release of the NetBSD/x68k.  If you have a MS-DOS (or MS-Windows) machine
40with an MO drive connected, use it.  If you don't, and if you have
41a program to handle IBM format MO for Human68k, copy all the files in
42the subdirectory "x68k/binaries" and RENAME THEIR NAME IN UPPER CASE.
43
44To install or upgrade NetBSD using a tape, you need to do the
45following:
46
47	To install NetBSD from a tape, you need to make a tape that
48	contains the distribution set files, in "tar" format.  If
49	you're making the tape on a UN*X-like system, the easiest way
50	to do so is probably something like:
51
52		tar cf <tape_device> <dist_directories>
53
54	where "<tape_device>" is the name of the tape device that
55	describes the tape drive you're using (possibly /dev/rst0, or
56	something similar, but it will vary from system to system.
57	(If you can't figure it out, ask your system administrator.)
58	In the above example, "<dist_directories>" are the
59	distribution sets' directories, for the distribution sets you
60	wish to place on the tape.  For instance, to put the "base12"
61	and "etc12" distributions on tape (in order to do the absolute
62	minimum installation to a new disk), you would do the
63	following:
64
65		cd .../NetBSD-1.2		# the top of the tree
66		cd x68k/binary
67		tar cf <tape_device> base12 etc12
68
69	(Note that you still need to fill in "<tape_device>" in the
70	example.)
71
72	Once you have the files on the tape, you can proceed to the
73	next step in the installation or upgrade process.  If you're
74	installing NetBSD from scratch, go to the section on preparing
75	your hard disk, below.  If you're upgrading an existing
76	installation, go directly to the section on upgrading.
77
78To install or upgrade NetBSD using a remote partition, mounted via
79NFS, you must do the following:
80
81	NOTE:	This method of installation is recommended only for
82		those already familiar with using BSD network
83		configuration and management commands.  If you aren't,
84		this documentation should help, but is not intended to
85		be all-encompassing.
86
87	Place the NetBSD distribution sets you wish to install into a
88	directory on an NFS server, and make that directory mountable
89	by the machine on which you are installing or upgrading NetBSD.
90	This will probably require modifying the /etc/exports file on
91	of the NFS server and resetting its mount daemon (mountd).
92	(Both of these actions will probably require superuser
93	privileges on the server.)
94
95	You need to know the the numeric IP address of the NFS server,
96	and, if the server is not on a network directly connected to
97	the machine on which you're installing or upgrading NetBSD,
98	you need to know the numeric IP address of the router closest
99	to the NetBSD machine.  Finally, you need to know the numeric
100	IP address of the NetBSD machine itself.
101
102	Once the NFS server is set up properly and you have the
103	information mentioned above, you can proceed to the next step
104	in the installation or upgrade process.  If you're installing
105	NetBSD from scratch, go to the section on preparing your hard
106	disk, below.  If you're upgrading an existing installation, go
107	directly to the section on upgrading.
108
109To install or upgrade NetBSD by using FTP to get the installation
110sets, you must do the following:
111
112	NOTE:	This method of installation is recommended only for
113		those already familiar with using BSD network
114		configuration and management commands.  If you aren't,
115		this documentation should help, but is not intended to
116		be all-encompassing.
117
118	The preparations for this installation/upgrade method are
119	easy; all you make sure that there's some FTP site from which
120	you can retrieve the NetBSD distribution when you're about to
121	install or upgrade.  You need to know the numeric IP address
122	of that site, and, if it's not on a network directly connected
123	to the machine on which you're installing or upgrading NetBSD,
124	you need to know the numeric IP address of the router closest
125	to the NetBSD machine.  Finally, you need to know the numeric
126	IP address of the NetBSD machine itself.
127
128	Once you have this information, you can proceed to the next
129	step in the installation or upgrade process.  If you're
130	installing NetBSD from scratch, go to the section on
131	preparing your hard disk, below.  If you're upgrading an
132	existing installation, go directly to the section on
133	upgrading.
134
135If you are upgrading NetBSD, you also have the option of installing
136NetBSD by putting the new distribution sets somewhere in your existing
137file system, and using them from there.  To do that, you must do the
138following:
139
140	Place the distribution sets you wish to upgrade somewhere in
141	your current file system tree.  At a bare minimum, you must
142	upgrade the "base" binary distribution, and so must put the
143	"base12" set somewhere in your file system.  If you wish,
144	you can do the other sets, as well, but you should NOT upgrade
145	the "etc" distribution; the "etc" distribution contains system
146	configuration files that you should review and update by hand.
147
148	Once you have done this, you can proceed to the next step in
149	the upgrade process, actually upgrading your system.
150