377 lines
16 KiB
Plaintext
377 lines
16 KiB
Plaintext
$NetBSD: install,v 1.6 1998/11/04 14:21:30 minoura Exp $
|
|
|
|
Installing NetBSD is a relatively complex process, but if you have
|
|
this document in hand and are careful to read and remember the
|
|
information which is presented to you by the install program, it
|
|
shouldn't be too much trouble.
|
|
|
|
Before you begin, you should know the geometry of your hard disk, i.e.
|
|
the sector size (note that sector sizes other than 512 bytes are not
|
|
currently supported), the number of sectors per track, the number of
|
|
tracks per cylinder (also known as the number of heads), and the
|
|
number of cylinders on the disk. The NetBSD kernel will try to
|
|
discover these parameters on its own, and if it can it will print them
|
|
at boot time. If possible, you should use the parameters it prints.
|
|
(You might not be able to because you're sharing your disk with
|
|
another operating system, or because your disk is old enough that the
|
|
kernel can't figure out its geometry.)
|
|
|
|
You should now be ready to install NetBSD. It might be handy for you
|
|
to have a pencil, some paper, and a calculator handy.
|
|
|
|
The following is a walk-through of the steps you will take while
|
|
getting NetBSD installed on your hard disk. If any question has a
|
|
default answer, it will be displayed in brackets ("[]") after the
|
|
question. If you wish to stop the installation, you may hit Control-C
|
|
at any time, but if you do, you'll have to begin the installation
|
|
process again from scratch.
|
|
|
|
Boot your machine using of boot floppy. If the boot prompt
|
|
does not appear in a reasonable amount of time, you either
|
|
have a bad boot floppy or a hardware problem. Try writing the
|
|
boot floppy image to a different disk, and using that. If it
|
|
still doesn't work, NetBSD probably can't be run on your
|
|
hardware. This can probably be considered a bug, so you might
|
|
want to report it. If you do, please include as many details
|
|
about your system configuration as you can.
|
|
|
|
It will take a while to load the kernel from the floppy,
|
|
probably around a minute or so.
|
|
|
|
You will then be presented with the NetBSD kernel boot
|
|
messages. You will want to read them, to determine your
|
|
disk's name and geometry. Its name will be something like
|
|
"sd0" and the geometry will be printed on a line that
|
|
begins with its name. As mentioned above, you will need your
|
|
disk's geometry when creating NetBSD's partitions. You will
|
|
also need to know the name, to tell the install tools what
|
|
disk to install on.
|
|
|
|
While booting, you will probably see several warnings. You
|
|
should be warned that no swap space is present, and that
|
|
init(8) cannot find /etc/rc. Do not be alarmed, these are
|
|
completely normal. When you reach the prompt asking you for a
|
|
shell name, just hit return.
|
|
|
|
You will be presented with a welcome message and a prompt,
|
|
asking if you wish to proceed with the installation process.
|
|
If you wish to proceed, enter "y" and hit return.
|
|
|
|
The install program will then tell you which disks it can
|
|
install on, and ask you which it should use.
|
|
Reply with the name of your disk.
|
|
|
|
You will then be asked to name your disk's disklabel. The
|
|
default response is "mysd", and for most purposes it will be
|
|
OK. If you choose to name it something different, make sure
|
|
the name is a single word and contains no special characters.
|
|
You don't need to remember this name.
|
|
|
|
You will be prompted for your disk's geometry information,
|
|
i.e. the number of bytes per sector, cylinders on the disk,
|
|
tracks per cylinder (heads), and sectors per track. Enter
|
|
them when they are requested. If you make a mistake, hit
|
|
Control-C and when you get to the shell prompt, restart the
|
|
install process by running the "install" command. Once you
|
|
have entered this data, the install program will tell you the
|
|
total size of your disk, in both sectors, and cylinders.
|
|
Remember this number; if you're installing on the whole disk,
|
|
you'll need it again soon.
|
|
|
|
When describing your partitions, you will have the option of
|
|
entering data about them in units of disk sectors or
|
|
cylinders. If you choose to enter the information in units of
|
|
sectors, remember that, for optimal performance, partitions
|
|
should begin and end on cylinder boundaries. You will be
|
|
asked about which units you wish to use, and you should reply
|
|
with "c" for cylinders, or "s" for sectors.
|
|
|
|
You will be asked to enter the size of your NetBSD root
|
|
partition. It should be at least 15M, but if you are going to
|
|
be doing development, 20M is a more desirable size. This
|
|
size should be expressed in units of sectors or cylinders,
|
|
depending on which you said you wanted to use.
|
|
|
|
Next, you will be asked for the size of your swap partition.
|
|
You should probably allocate twice as much swap space as you
|
|
have real memory. Systems that will be heavily used should
|
|
have more swap space allocated, and systems that will be
|
|
lightly used can get by with less. If you want the system to
|
|
be able to save crash dumps when it panics, you will need at
|
|
least as much swap space as you have RAM. Again, this number
|
|
should be expressed in units of sectors or cylinders, as
|
|
appropriate.
|
|
|
|
The install program will then ask you for information about
|
|
the rest of the partitions you want on your disk. For most
|
|
purposes, you will want only one more partition, "/usr".
|
|
(Machines used as servers will probably also want /var as a
|
|
separate partition. That can be done with these installation
|
|
tools, but is not covered here.) The install program will
|
|
tell you how much space there is left to be allocated in the
|
|
NetBSD area of the disk, and, if you only want one more
|
|
partition ("/usr"), you should enter it at the prompt when the
|
|
installer asks you how large the next partition should be.
|
|
It will then ask you for the name of the mount point for that
|
|
partition. If you're doing a basic installation, that is
|
|
"/usr".
|
|
|
|
YOU ARE NOW AT THE POINT OF NO RETURN. Nothing has been
|
|
written to your disk yet, but if you confirm that you want to
|
|
install NetBSD, your hard drive will be modified, and its
|
|
contents may be scrambled at the whim of the install program.
|
|
This is especially likely if you have given the install
|
|
program incorrect information. If you are sure you want to
|
|
proceed, enter "yes" at the prompt.
|
|
|
|
The install program will now label your disk and make the file
|
|
systems you specified. The filesystems will be initialized to
|
|
contain NetBSD bootstrapping binaries and configuration files.
|
|
It will also create an /etc/fstab for your system, and mount
|
|
all of the file systems under /mnt. (In other words, your root
|
|
partition will be mounted on /mnt, your /usr partition on
|
|
/mnt/usr, and so on.) There should be no errors in this
|
|
section of the installation. If there are, restart from the
|
|
beginning of the installation process.
|
|
|
|
You will be placed at a shell prompt ("#"). The remaining
|
|
tasks are to copy the kernel from the kernel copy floppy to
|
|
the hard drive's root filesystem and install the distribution
|
|
sets. The flow of installation differs depending on your
|
|
hardware resources, and on what media the distribution sets
|
|
reside.
|
|
|
|
To install from removable hard disk:
|
|
The first thing you should do is pick a temporary
|
|
directory where the distribution files can be stored.
|
|
To do this, enter the command "Set_tmp_dir", and enter
|
|
the name of the temporary directory. (Don't forget
|
|
that your disk is mounted under /mnt; you should
|
|
probably pick a directory under /mnt/usr.) The
|
|
default is /mnt/usr/distrib.
|
|
|
|
Insert the media onto the drive. Check the device
|
|
name of your drive from the boot message. The device
|
|
name is something like "sd2" depending on the SCSI
|
|
disk drives connected to your machine. Note that the
|
|
boot message can be displayed with the command
|
|
"more /kern/msgbuf".
|
|
|
|
Mount the disk on the temporary directory with a
|
|
command like:
|
|
|
|
mount -t msdos /dev/sd2c <tmp_dir>
|
|
|
|
if your removable drive's name is sd2.
|
|
|
|
Run the "Extract" command once for each distribution
|
|
set you wish to install. For instance, if you wish to
|
|
install the "base" distribution set, followed by the
|
|
"kern" distribution set, and finally the "etc"
|
|
distribution set, use the commands:
|
|
Extract base
|
|
Extract kern
|
|
Extract etc
|
|
|
|
For each extraction, it will ask you if the extraction
|
|
should be verbose. If you reply affirmatively, it
|
|
will print out the name of each file that's being
|
|
extracted.
|
|
|
|
To install from floppy:
|
|
The first thing you should do is pick a temporary
|
|
directory where the distribution files can be stored.
|
|
To do this, enter the command "Set_tmp_dir", and enter
|
|
the name of the temporary directory. (Don't forget
|
|
that if your disk is still mounted under /mnt; you
|
|
should probably pick a directory under /mnt/usr.)
|
|
|
|
After you have picked a temporary directory, enter the
|
|
"Load_fd" command, to load the distribution sets from
|
|
your floppies.
|
|
|
|
You will be asked which floppy drive to use. Enter
|
|
"0" (zero) if you're using the first floppy drive
|
|
(i.e. what DOS would call "A:"), or enter "1" if
|
|
you're using the second.
|
|
|
|
You will be prompted to insert a floppy into the drive,
|
|
to have its contents copied to your hard disk. Do so,
|
|
and hit return to begin copying. When that is done,
|
|
read the remainder of the floppies that contain the
|
|
distribution sets that you want to install, one by
|
|
one. When the last is read, and you are being
|
|
prompted for another, hit Control-C.
|
|
|
|
Run the "Extract" command once for each distribution
|
|
set you wish to install. For instance, if you wish to
|
|
install the "base" distribution set, followed by the
|
|
"kern" distribution set, and finally the "etc"
|
|
distribution set, use the commands:
|
|
Extract base
|
|
Extract kern
|
|
Extract etc
|
|
|
|
For each extraction, it will ask you if the extraction
|
|
should be verbose. If you reply affirmatively, it
|
|
will print out the name of each file that's being
|
|
extracted.
|
|
|
|
(Note: if you know that you will be running low on
|
|
disk space when installing NetBSD, you can load and
|
|
extract one distribution set at a time. To do this,
|
|
load only the floppies which contain the files for the
|
|
first distribution set, extract them, and then change
|
|
to the temporary directory and remove them with the
|
|
command "rm set_name.??".)
|
|
|
|
Once you are finished extracting all of the sets that
|
|
you wish to install, you should proceed to the
|
|
instructions below (after the last install medium
|
|
type-specific instructions), that explain how you
|
|
should configure your system.
|
|
|
|
To install from tape:
|
|
The first thing you should do is pick a temporary
|
|
directory where the distribution files can be stored.
|
|
To do this, enter the command "Set_tmp_dir", and enter
|
|
the name of the temporary directory. (Don't forget
|
|
that your disk is mounted under /mnt; you should
|
|
probably pick a directory under /mnt/usr.) The
|
|
default is /mnt/usr/distrib.
|
|
|
|
After you have picked a temporary directory, enter the
|
|
"Load_tape" command, to load the distribution sets from
|
|
tape.
|
|
|
|
You will be asked which tape drive to use. The
|
|
default is "rst0", which is correct if you're using
|
|
the SCSI tape drive with the lowest SCSI ID number.
|
|
(For the SCSI tape drive with the next lowest SCSI ID
|
|
number, you should use "rst1", and so on.)
|
|
|
|
You will be prompted to hit return when you have
|
|
inserted the tape into the tape drive. When you do,
|
|
the contents of the tape will be extracted into the
|
|
temporary directory, and the names of the files being
|
|
extracted will be printed.
|
|
|
|
After the tape has been extracted, to go the directory
|
|
containing the first distribution set you wish to
|
|
install. (Depending on how you made the tape, it's
|
|
probably a subdirectory of the temporary directory you
|
|
specified above.) Once there, run the "Set_tmp_dir"
|
|
command again, and accept its default answer by
|
|
hitting return at the prompt.
|
|
|
|
Use the "Extract" command to extract the distribution
|
|
set. For instance, if you're extracting the "base"
|
|
set, use the command:
|
|
Extract base
|
|
You will be asked if you wish the extraction to be
|
|
verbose. If you reply affirmatively, the name of each
|
|
file being extracted will be printed.
|
|
|
|
Repeat the previous two steps for each distribution
|
|
set you wish to install. Change to the set's
|
|
directory, run "Set_tmp_dir", and then run
|
|
"Extract <set_name>" to extract the set.
|
|
|
|
Once you are finished extracting all of the sets that
|
|
you wish to install, you should proceed to the
|
|
instructions below (after the last install medium
|
|
type-specific instructions), that explain how you
|
|
should configure your system.
|
|
|
|
To install via FTP or NFS:
|
|
The first thing you should do is pick a temporary
|
|
directory where the distribution files can be stored.
|
|
To do this, enter the command "Set_tmp_dir", and enter
|
|
the name of the temporary directory. (Don't forget
|
|
that your disk is mounted under /mnt; you should
|
|
probably pick a directory under /mnt/usr.) The
|
|
default is /mnt/usr/distrib.
|
|
|
|
Configure the SLIP interface, with the following
|
|
command sequence:
|
|
|
|
slattach -h -s <speed> tty00
|
|
ifconfig sl0 <my_ipaddr> <peer_ipaddr>
|
|
|
|
where "<speed>" is the network speed, and "<my_ipaddr>"
|
|
is the numeric IP address of the machine you are going
|
|
to install NetBSD/x68k, while "<peer_ipaddr>" is the
|
|
address of the peer machine connected with your machine.
|
|
You might have to configure the peer SLIP interface
|
|
with similar sequence (depending on the peer system).
|
|
|
|
For instance, the sequence
|
|
|
|
slattach -h -s 38400 tty00
|
|
ifconfig sl0 192.168.0.1 192.168.0.10
|
|
|
|
configures the SLIP interface for the network between
|
|
your machine (with IP address 192.168.0.1) and the peer
|
|
(192.168.0.10) with speed 38400 bps. Note that IP
|
|
addresses 192.168.*.* are the private IP addresses
|
|
described in RFC 1597.
|
|
|
|
If you are NFS-mounting the distribution sets, mount
|
|
them on the temporary directory with a command like:
|
|
|
|
mount -t nfs <serv_ipaddr>:<dist_dir> <tmp_dir>
|
|
|
|
where <serv_ipaddr> is the server's numeric IP address,
|
|
<dist_dir> is the path to the distribution files on
|
|
the server, and <tmp_dir> is the name of the local
|
|
temporary directory.
|
|
|
|
Once this is done, proceed as if you had loaded the
|
|
files from tape, changing to the appropriate
|
|
directories, running "Set_tmp_dir", and running
|
|
"Extract" as appropriate.
|
|
|
|
If you are retrieving the distribution sets using ftp,
|
|
change into the temporary directory, and execute the
|
|
command:
|
|
|
|
ftp <serv_ipaddr>
|
|
|
|
where <serv_ipaddr> is once again the server's numeric
|
|
IP address. Get the files with FTP, taking care to
|
|
use binary mode when transferring the files.
|
|
|
|
Once you have all of the files for the distribution
|
|
sets that you wish to install, you can proceed using
|
|
the instructions above, as if you had installed from a
|
|
floppy. (Note that as with the floppy install, if
|
|
you're short on disk space, you can transfer only one
|
|
set at a time, extract it, then delete it, to save
|
|
space.)
|
|
|
|
Once you have finished extracting all of the distribution sets
|
|
that you wish to install, and are back at the "#" prompt, you
|
|
are ready to configure your system. The configuration utility
|
|
expects that you have installed the "base" and "etc"
|
|
distribution sets. If you have not, you will not be able to
|
|
run it successfully (nor will you have a functional system, in
|
|
any case). To configure your newly-installed NetBSD system,
|
|
run the command "Configure". It will ask you for the system's
|
|
host name, domain name, and other network configuration
|
|
information. It will set up your configuration files and make
|
|
the device nodes for the newly-installed system.
|
|
|
|
|
|
Congratulations, you have successfully installed NetBSD _VER. When you
|
|
reboot into NetBSD, you should log in as "root" at the login prompt.
|
|
There is no initial password, but if you're using the machine in a
|
|
networked environment, you should create yourself an account and
|
|
protect it and the "root" account with good passwords.
|
|
|
|
Some of the files in the NetBSD _VER distribution might need to be
|
|
tailored for your site. In particular, the /etc/sendmail.cf file will
|
|
almost definitely need to be adjusted, and other files in /etc
|
|
including /etc/rc.conf will probably need to be modified, as well. If
|
|
you are unfamiliar with UN*X-like system administration, it's
|
|
recommended that you buy a book that discusses it.
|