4359ad3c2d
syntactic conversion -- the semantics should be exactly the same. I haven't yet converted section 5 (advanced stuff), appendix A (device naming) or appendix B (credits), and mdoc, even the souped-up version used for INSTALL, seems to be lacking a fourth-level header macro, which this wants. Of course, the presence of fourth-level headers does somewhat indicate that this whole area wants cleaning up lots.
510 lines
13 KiB
Plaintext
510 lines
13 KiB
Plaintext
.\" $NetBSD: prep,v 1.2 2002/04/14 14:40:13 bjh21 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. Repartitioning your hard disk is an excellent way to
|
|
destroy important data.
|
|
.Ss2 Software requirements
|
|
You will need the following RiscOS software:
|
|
.Bl -bullet
|
|
.It
|
|
A program that will unpack sparchives. We recommend that you
|
|
get David Pilling's !SparkPlug. A self-extracting version of this
|
|
can be found at David Pilling's W3 site
|
|
.Pq Lk http://www.pilling.demon.co.uk/free.html .
|
|
.It
|
|
A program that can uncompress gzip files, because the current bootloader
|
|
can't read gzip'ed kernels (yet!).
|
|
.Bl -bullet
|
|
.It
|
|
The included command line gzip program
|
|
.Pa installation/misc/gzip_ff8
|
|
(!) which is a mirror a version
|
|
that Laurent Domisse has patched to work on SA. This is
|
|
also available from:
|
|
.Lk http://www.users.dircon.co.uk/~arcangel/files/index.html .
|
|
Just set the type of the file to
|
|
.Ql ff8 .
|
|
.It
|
|
SparkFS from David Pilling (commercial) (v1.28 for SA-110).
|
|
.It
|
|
!Gzip from HENSA (micros.hensa.ac.uk); is it still alive
|
|
though?
|
|
.El
|
|
.It
|
|
A program to report your disk's geometry:
|
|
.Bl -bullet
|
|
.It
|
|
Not really needed, you can simply boot the installation
|
|
kernel and look for the geometry in the boot messages.
|
|
.It
|
|
Sergio Monesi's fsck suite (a good thing to have around
|
|
anyway). Available from:
|
|
.Lk http://cdc8g5.cdc.polimi.it/~pel0015/fsck.html
|
|
.It
|
|
!Zap (The read disk facility). Available from HENSA.
|
|
.It
|
|
The partition software/formatter for your desired installation
|
|
target:
|
|
.Bl -bullet
|
|
.It
|
|
IDE disks on motherboard interface: !HForm
|
|
.It
|
|
IDE disks on Simtec interface: UNKNOWN
|
|
.It
|
|
IDE disks on ICS interface: UNKNOWN
|
|
.It
|
|
IDE disks on RapIDE interface: UNKNOWN
|
|
.It
|
|
Acorn SCSI cards: ScsiDM
|
|
.It
|
|
Power-tec SCSI cards: !PowerMgr
|
|
.It
|
|
Cumana SCSI-2: !SCSIMgr
|
|
.It
|
|
oak SCSI-1 card: UNKNOWN
|
|
.It
|
|
MCS Connect32 SCSI: UNKNOWN
|
|
.It
|
|
Morley SCSI: UNKNOWN
|
|
.El
|
|
.El
|
|
.It
|
|
An installation kernel for your platform:
|
|
.Pp
|
|
RiscPC/A7000(+)/NC's : INSTALL kernel
|
|
.It
|
|
The Bootloader and RiscOS tools:
|
|
.Pa BtNetBSD.tar.gz
|
|
or
|
|
.Pa BtNetBSD.zip
|
|
as found in the
|
|
.Pa installation/misc
|
|
directory. (This should be pre-extracted if you're installing from CD-ROM).
|
|
.It
|
|
The
|
|
.Nx*M
|
|
distribution sets (Will be on the CD-ROM, or
|
|
available from your nearest
|
|
.Nx
|
|
ftp site).
|
|
.It
|
|
A hardcopy of this document
|
|
.El
|
|
.Ss2 Preliminary steps
|
|
Unpack your BtNetBSD archive in whatever way, set the type of
|
|
the
|
|
.Pa Settype
|
|
file in the
|
|
.Pa BtNetBSD
|
|
directory to
|
|
.Ql Obey
|
|
and run
|
|
it. This will make the files RISC OS typed correctly. this is
|
|
also explained in a bit more detail in the enclosed
|
|
.Pa README
|
|
file.
|
|
.Ss2 Preparing your hard disk
|
|
Terms:
|
|
.Bl -tag -width "File system"
|
|
.It Device
|
|
The actual physical hard disk
|
|
.It Partition
|
|
A section of a device.
|
|
.It File system
|
|
A structured partition that is able to hold files.
|
|
.It Disc
|
|
A RiscOS file system in a partition. There can be
|
|
more than one Disc per Device.
|
|
.El
|
|
.Pp
|
|
You will have to decide which device you wish to install
|
|
.Nx
|
|
on.
|
|
You will also have to decide whether you want to split the device
|
|
between one or more RiscOS discs and
|
|
.Nx
|
|
or dedicate a whole
|
|
Device for
|
|
.Nx .
|
|
.Pp
|
|
In making this decision you should consider the possibility that if
|
|
.Nx
|
|
is incorrectly configured on a shared device then your shared
|
|
data is at risk.
|
|
.Pp
|
|
It is still recommended that if you decide to dedicate a device to
|
|
.Nx
|
|
that you set aside a small RISC OS partition at the beginning
|
|
of the device. This is a useful place to store the RiscOS side of
|
|
.Nx ,
|
|
and will make the use of UnixFS easier to configure. If you
|
|
do decide to create a minimal RiscOS partition at the beginning of
|
|
the device, a size of 10-20 MB is recommended (some partitioning
|
|
software has problems with partitions smaller than this).
|
|
.Pp
|
|
The point is that you will have to repartition your device to make
|
|
room for a separate partition after the RISC OS one for
|
|
.Nx .
|
|
This
|
|
means backing up your device, re-partitioning it and then copying all
|
|
the data back afterwards. We recommend that you only copy the needed
|
|
data back and put off installing the rest until you have
|
|
.Nx
|
|
up
|
|
and running. This way you will save yourself a lot of work if
|
|
something goes wrong and you have to start all over again.
|
|
.Ss2 Sharing your device
|
|
2.1.1 Acorn IDE
|
|
.Pp
|
|
Use !HForm for this interface. This is a program that is delivered
|
|
with your computer and is located in the
|
|
.Pa Utilities
|
|
directory on your
|
|
hard disk.
|
|
.Pp
|
|
With this software you only have the possibility of using one
|
|
partition for RISC OS, so you have to set the rest aside for
|
|
.Nx .
|
|
.Pp
|
|
Use this procedure to set up your device:
|
|
.Bl -bullet
|
|
.It
|
|
Start !HForm by double-clicking on its icon.
|
|
.It
|
|
Choose the "custom" or "other" option when prompted (usually
|
|
the last).
|
|
.It
|
|
Use the default values for the geometry but do not enter the
|
|
full number of cylinders. Just enter the number you want to
|
|
use for RISC OS. Make a note of this number.
|
|
.It
|
|
Continue to accept the default answers until you're asked
|
|
whether you want to format or initialize, choose initialize.
|
|
.It
|
|
Go to the section about running
|
|
.Ic bb_riscbsd .
|
|
.El
|
|
.Pp
|
|
2.1.2 Cumana SCSI-2 card
|
|
.Pp
|
|
It is recommended that you use a newer version of !SCSIMgr (newer
|
|
than v1.55) since this will be easier to use when you want to leave
|
|
part of the device unused by RISC OS. You should check for the latest
|
|
version of this software at the following URL:
|
|
.Lk http://www.cumana.demon.co.uk
|
|
.Pp
|
|
You need to create one or more RISC OS partitions, and you do it in
|
|
in the following way:
|
|
.Bl -bullet
|
|
.It
|
|
Run !SCSIMgr by double-clicking on it.
|
|
.It
|
|
Select the device you wish to repartition.
|
|
.It
|
|
Click on the clear icon in the partitions subwindow.
|
|
.It
|
|
This will give you a dialogue box where you can specify the
|
|
size of the RISC OS partitions. Do not select all since you
|
|
want to use part of it for
|
|
.Nx .
|
|
.It
|
|
Enter the amount of the device you wish to reserve for
|
|
RiscOS. This will be the whole device size less the amount
|
|
you want to reserve for
|
|
.Nx .
|
|
Make a note of this number.
|
|
.It
|
|
If you like, split the RISC OS portion of the device into
|
|
several partition (you should only "see" the RiscOS portion).
|
|
.It
|
|
Click on Execute when you are happy with the partitions. This
|
|
will create your partitions, and wipe your device.
|
|
.It
|
|
Go to the section about running
|
|
.Ic bb_riscbsd .
|
|
.El
|
|
.Pp
|
|
2.1.3 Alsystems Power-tec SCSI-2 card
|
|
.Pp
|
|
You must use the !PowerMgr program to partition the device.
|
|
.Pp
|
|
The RISC OS partitions should be called
|
|
.Ql RiscOs: ,
|
|
and the
|
|
.Nx
|
|
one should be called
|
|
.Ql Empty: .
|
|
.Pp
|
|
Here is the procedure you should use:
|
|
.Bl -bullet
|
|
.It
|
|
Start !PowerMgr by double-clicking on its icon.
|
|
.It
|
|
Click on advanced in the main window
|
|
.It
|
|
Click on Define/create partitions
|
|
.Bl -bullet
|
|
.It
|
|
Click on the device you want to set up for NetBSD.
|
|
.It
|
|
Set up the RISC OS partitions as
|
|
.Ql RiscOs:
|
|
and the remaining one as
|
|
.Ql Empty: .
|
|
.It
|
|
Click on each figure and press RETURN.
|
|
.It
|
|
Click on partition drive.
|
|
.It
|
|
Click on yes to warning as you really want to wipe
|
|
the device.
|
|
.It
|
|
Click on yes to proceed, this will lead you to the
|
|
partition init.
|
|
.El
|
|
.It
|
|
Partition init
|
|
.Bl -bullet
|
|
.It
|
|
Set a tick on all
|
|
.Ql RiscOs:
|
|
partitions, give them a name and set LFAU to auto.
|
|
.It
|
|
Unset the tick on your
|
|
.Ql Empty:
|
|
partition.
|
|
.It
|
|
Click on Inititialize selected partitions.
|
|
.It
|
|
Click on yes to proceed init as you want to wipe the
|
|
selected partitions.
|
|
.It
|
|
Click on yes to proceed to configure.
|
|
.El
|
|
.It
|
|
Configure
|
|
.Bl -bullet
|
|
.It
|
|
Here you should set up the RISC OS partitions as you
|
|
like them. Normally the default will be ok.
|
|
.It
|
|
Click on configure. This will configure your computer
|
|
and give you access to the Discs.
|
|
.El
|
|
.It
|
|
You
|
|
.Em must not
|
|
run
|
|
.Ic bb_riscbsd .
|
|
.El
|
|
.Pp
|
|
2.1.4 Acorn SCSI card
|
|
.Pp
|
|
You can only have one RISC OS partition with this card. The rest has
|
|
to be set aside for
|
|
.Nx .
|
|
|
|
This card does not have a friendly WIMP-based interface on the SCSI
|
|
management program, but the command line version is very good. You
|
|
should run this in a task window (press CTRL-F12):
|
|
.Bd -ragged
|
|
.Li *dir Ar location_of_scsidm
|
|
.br
|
|
.Li *scsidm
|
|
.Ed
|
|
You will get the following prompt:
|
|
.Dl scsidm>
|
|
Now you should enter the following commands:
|
|
.Bl -tag -width Ic
|
|
.It Ic probe
|
|
(to see which devices are available)
|
|
.It Ic device Ar no
|
|
(replace
|
|
.Ar no
|
|
with the no of your device)
|
|
.It Ic section
|
|
(to divide the device between RISC OS and
|
|
.Nx )
|
|
.Bl -bullet
|
|
.It
|
|
Answer yes to the question:
|
|
.Dl Include RISCiX partitions?
|
|
.It
|
|
Enter the size of the RISC OS area in blocks
|
|
(sectors)
|
|
.It
|
|
SCSIDM will round this up to the nearest cylinder
|
|
boundary.
|
|
.It
|
|
Answer yes to the question:
|
|
.Bd -ragged -offset indent
|
|
.Li "Do you really want to section device" Ar no Ns Li "?"
|
|
.Ed
|
|
.It
|
|
This will section the device into two partitions.
|
|
.El
|
|
.It Ic quit
|
|
.El
|
|
.Pp
|
|
Go to the section on running
|
|
.Ic bb_riscbsd .
|
|
.Pp
|
|
2.1.5 Other interfaces
|
|
.Pp
|
|
It may not be possible to partition devices on other interface. If
|
|
you are using a different interface you have 2 options:
|
|
.Bl -bullet
|
|
.It
|
|
Try to work out how to partition devices on it
|
|
.It
|
|
Use the entire device for
|
|
.Nx
|
|
.El
|
|
.Ss2 Using a whole device for NetBSD
|
|
.Pp
|
|
As a safety precaution
|
|
.Nx*M
|
|
looks for a filecore bootblock
|
|
at the beginning of any device it labels. If it finds one and it
|
|
looks as though it is in use then
|
|
.Nx*M
|
|
will not touch it.
|
|
.Pp
|
|
Because of this, if you've ever used your device for RiscOS, you will
|
|
need to invalidate this bootblock.
|
|
.Pp
|
|
To do this you need to:
|
|
.Bl -bullet
|
|
.It
|
|
Be absolutely sure you want to do this.
|
|
.It
|
|
Run
|
|
.Ic bb_trash
|
|
and follow the instructions.
|
|
.El
|
|
.Pp
|
|
Ensure that this device is now not configured for RiscOS.
|
|
.Pp
|
|
You are now ready to boot
|
|
.Nx
|
|
and continue the installation.
|
|
.Ss2 Running bb_riscbsd
|
|
.Pp
|
|
When you run this program, you will first be asked whether you are
|
|
installing to an ADFS drive or a SCSI drive. You can just press
|
|
.Ql A
|
|
or
|
|
.Ql S
|
|
respectively. (The
|
|
.Ic bb_riscbsd
|
|
program assumes that you are using a
|
|
non-Acorn SCSI card, so if you are using an Acorn card, then you may
|
|
have to edit this program and replace
|
|
.Ql SCSI_DiscOp
|
|
with
|
|
.Ql SCSIFS_DiscOp . )
|
|
.Pp
|
|
Then you will be asked which disc you want to install
|
|
.Nx
|
|
on. This
|
|
.Em must
|
|
be the first disc on the device.
|
|
.Ic bb_riscbsd
|
|
will now scrutinize the device and see how it has been laid out.
|
|
.Pp
|
|
It will then tell you how much of the device is occupied by RiscOS in
|
|
cylinders, and you will then be asked for the
|
|
.Nx
|
|
starting
|
|
cylinder. Normally you should just enter the number given to you
|
|
since the RISC OS starting cylinder is 0 and therefore the last
|
|
cylinder in use is one less than the figure given. If no figure is
|
|
displayed, then your partitioning software failed to fill in the
|
|
bootblock completely (it doesn't have to do this for you but most do)
|
|
or you selected the wrong device. If you are convinced that this is
|
|
the correct device then you must calculate a cylinder offset using
|
|
the numbers noted down during partitioning (if it is not a whole
|
|
number
|
|
.Em always
|
|
round up, you might waste a little of the device but
|
|
it'll be safer).
|
|
.Pp
|
|
Make a note of this number.
|
|
.Pp
|
|
.Ic bb_riscbsd
|
|
will make a backup of the original bootblock, but it
|
|
can be non-trivial to put it back.
|
|
.Ss2 Booting
|
|
.Pp
|
|
Now that your device is ready for the installation you need to
|
|
unpack the bootloader archive. Pick either
|
|
.Pa BtNetBSD.tgz
|
|
or
|
|
.Pa BtNetBSD.zip
|
|
depending on which type of archive you can extract easiest. (if you're
|
|
installing from CD-ROM then this should be unpacked already), copy the
|
|
directory to your hard disk. In the archive you'll find the tools
|
|
mentioned in this document as well as the bootloader
|
|
.Pa !BtNetBSD
|
|
itself.
|
|
.Ss2 Configuring the !BtNetBSD bootloader before installation
|
|
Open the
|
|
.Pa !BtNetBSD
|
|
application and edit the
|
|
.Pa fastboot
|
|
file to specify
|
|
the installation kernel location; an example is already given.
|
|
.Pa
|
|
You can also set other details like tweaking with the amount of memory in
|
|
the WimpSlot of the bootloader when this is too much. Remember however that
|
|
this shouldn't be set too low for it can crash the bootloader.
|
|
.Pa
|
|
When you think you've filled in the proper details save the file again
|
|
and proceed.
|
|
.Ss2 Running !BtNetBSD
|
|
.Pp
|
|
Double click on the !BtNetBSD icon (or the !Run file in it) to start it
|
|
up.
|
|
.Pp
|
|
.Nx
|
|
should now start to boot, install
|
|
.Nx
|
|
as per the
|
|
.Nx
|
|
installation notes.
|
|
.Pp
|
|
When you finish the installation you can restarted the computer as
|
|
instructed.
|
|
.Ss2 Configuring !BtNetBSD after installation
|
|
.Pp
|
|
Open the
|
|
.Pa !BtNetBSD
|
|
application again and edit the
|
|
.Pa fastboot
|
|
file again to fill in the normal kernel name.
|
|
.Pp
|
|
Specify the device
|
|
.Nx NetBSD
|
|
should be looking for its kernel in. This is the
|
|
.Ql "Run <BtNetBSD$Dir>.native.mountufs ADFS 4"
|
|
line that is there by default. See this document for other names.
|
|
.Pp
|
|
Set the kernel as
|
|
.Pa UnixFS:$.netbsd .
|
|
.Pp
|
|
Save the file and run !BtNetBSD again (see above).
|
|
.Pp
|
|
Finally, when you are happy with your
|
|
.Nx
|
|
installation, do whatever
|
|
is necessary to restore order to the partition you took space away from.
|
|
This will most likely involve restoring files, but might involve some
|
|
other
|
|
.Dq house-work .
|
|
.Pp
|
|
Your hard disk is now prepared to have
|
|
.Nx
|
|
installed on it, and you should proceed with the installation instructions.
|