prep revision 1.16
1	$NetBSD: prep,v 1.16 1998/09/27 19:32:59 is Exp $	
2
3You will need an AmigaDOS hard drive prep tool to prepare your hard
4drives for use with NetBSD/Amiga.  HDToolBox is provided with the
5system software and on floppy installation disks since Release 2.0
6of AmigaDOS, so we will provide instructions for its use.
7
8Preparing you hard disk with HDToolBox:
9
10	A full explanation of HDToolBox can be found with your
11	AmigaDOS manuals and is beyond the scope of this document.
12
13	The first time you partition a drive, you need to set its drive
14	type so that you have working geometry parameters. To do this
15	you enter the "Change drive type" menu, and either use "read
16	parameters from drive" or set them manually.
17
18	Note you will be modifying your HD's. If you mess something 
19	up here you could lose everything on all the drives that 
20	you configure.  It is therefore advised that you:
21
22		Write down your current configurations.  Do this
23		by examining each partition on the drive and the
24		drives parameters (from Change drive type.)
25
26		Back up the partitions you are keeping.
27
28	What you need to do is partition your drives; creating at least
29	root, swap and /usr partitions and possibly at least one more for
30	/usr/local if you have the space.
31
32	This should be done as the HDToolBox manual describes.  One thing
33	to note is that if you are not using a Commodore controller you
34	will need to specify the device your SCSI controller uses, e.g.
35	if you have a Warp Engine you would:
36
37		from cli,
38			hdtoolbox warpdrive.device
39
40		from wb set the tooltype,
41			SCSI_DEVICE_NAME=warpdrive.device
42
43	The important things you need to do above and beyond normal
44	partitioning includes (from Partition Drive section):
45
46		Marking all NetBSD partitions as non-bootable, with
47		two exceptions: the root partition, if you want to boot
48		NetBSD directly, or the swap partition, if you want
49		to boot the installation miniroot directly.
50
51		Changing the file system parameters of the partitions
52		to NetBSD ones.  This must be done from the
53		partitioning section and `Advanced options' must
54		be enabled.  To Make the needed changes:
55
56		- Click the `Adv. Options' button
57		- Click the `Change file system' button
58		- Choose `Custom File System'
59		- Turn off `Automount' if on.
60		- Set the dostype to one of these three choices:
61
62			root partition  : 0x4e425207
63			swap partition  : 0x4e425301
64			other partitions: 0x4e425507
65
66		Here `other' refers to other partitions you will
67		format for reading and writing under NetBSD (e.g.
68		/usr)
69
70		Make sure you hit the return key to enter this value
71		as some versions of HDToolBox will forget your entry
72		if you don't.
73
74		- Turn custom boot code off
75		- Set Reserved Blocks start and end to 0.
76		- Click Ok.
77
78		On the root (and, for installation, swap) partition,
79		set instead this:
80
81		- Turn custom boot code on
82		- Set Reserved Blocks start and end to 0.
83		- Set Number of Custom Boot Blocks to 16
84		- Set Automount This Partition on
85		- Click Ok.
86
87		Mask and maxtransfer are not used with NetBSD.
88
89	
90	Once this is done NetBSD/Amiga will be able to recognize your
91	disks and which partitions it should use.
92
93Transferring the miniroot file system:
94
95	The NetBSD/Amiga installation or upgrade now uses a "miniroot"
96	file system which is installed on the partition used by NetBSD
97	for swapping.  This removes the requirement of using a floppy
98	disk for the file system used by the installation or upgrade
99	process.  It also allows more utilities to be present on the
100	file system than would be available when using an 880K floppy
101	disk.
102
103	Once the hard disk has been prepared for NetBSD, the miniroot
104	file system (miniroot.fs) is transferred to the swap
105	partition configured during the hard disk prep (or the existing
106	swap partition in the case of an upgrade).  The xstreamtodev
107	utility provided in the "amiga/installation/misc" directory can
108	be used on AmigaDOS to transfer the file system for either a new
109	installation or an upgrade.  The file system can also be
110	transferred on an existing NetBSD system for an update by
111	using dd.  This should only be done after booting NetBSD
112	into single-user state.  It may also be possible to shutdown
113	to single-user, providing that the single-user state processes
114	are not using the swap partition.
115
116	On AmigaDOS, the command:
117		xstreamtodev --input=miniroot.fs --rdb-name=<swap partition>
118	where <swap partition> is the name you gave to the NetBSD
119	partition to be used for swapping.  If xstreamtodev is unable
120	to determine the SCSI driver device name or the unit number
121	of the specified partition, you may also need to include the
122	option "--device=<driver.name>" and/or "--unit=<SCSI unit number>".
123
124	To transfer the miniroot using NetBSD, you should be booted up
125	in single user state on the current NetBSD system, or use the
126	"shutdown now" command to shutdown to single-user state.  Then
127	copy the miniroot using dd:
128		dd if=miniroot.fs of=/dev/rsd0b
129	where /dev/rsd0b should be the device path of the swap partition
130	your system is configured to use.  Once the file is copied,
131	reboot back to AmigaDOS to boot the upgrade kernel.
132
133	CAVEAT: Once you have started installation once, whenever you abort it
134	and want to retry, you must reinstall the miniroot.fs on the swap
135	partition.
136