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