[src/netbsd-1-5]: src/distrib/notes/x68k Pull up revision 1.17 (requested by ...

[he <he%NetBSD.org@localhost>]

details:   https://anonhg.NetBSD.org/src/rev/777009f97264
branches:  netbsd-1-5
changeset: 491289:777009f97264
user:      he <he%NetBSD.org@localhost>
date:      Sat Apr 21 20:56:46 2001 +0000

description:
Pull up revision 1.17 (requested by minoura):
  Update installation notes to reflect the state of the installation
  system for 1.5.1 on x68k.

diffstat:

 distrib/notes/x68k/install |  548 +--------------------------------------------
 1 files changed, 1 insertions(+), 547 deletions(-)

diffs (truncated from 560 to 300 lines):

diff -r ed7f2b6aaaba -r 777009f97264 distrib/notes/x68k/install
--- a/distrib/notes/x68k/install        Sat Apr 21 20:56:32 2001 +0000
+++ b/distrib/notes/x68k/install        Sat Apr 21 20:56:46 2001 +0000
@@ -1,4 +1,4 @@
-.\"    $NetBSD: install,v 1.11.4.2 2000/11/04 06:49:16 lukem Exp $
+.\"    $NetBSD: install,v 1.11.4.3 2001/04/21 20:56:46 he Exp $
 .\"
 .\" Copyright (c) 1999, 2000 The NetBSD Foundation, Inc.
 .\" All rights reserved.
@@ -32,550 +32,4 @@
 .\" POSSIBILITY OF SUCH DAMAGE.
 .\"
 .
-Installing
-.Nx
-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.
-.Pp
-There are two kind of installer for
-.Nx*M ;
-standard,
-.Ic sysinst
-installer, and small,
-.Ic script
-installer.
-.Pp
-The former is the recommended, but it requires at least 5 MB of memory.
-If you have less memory, you have to chose the latter.
-.Pp
 .so ../common/sysinst
-.
-.Ss2 Running the script installation program
-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
-.Nx
-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.)
-.Pp
-You should now be ready to install
-.Nx .
-It might be handy for you
-to have a pencil, some paper, and a calculator handy.
-.Pp
-The following is a walk-through of the steps you will take while
-getting
-.Nx
-installed on your hard disk. If any question has a
-default answer, it will be displayed in brackets
-.Pq Dq []
-after the
-question. If you wish to stop the installation, you may press
-.Key CONTROL-C
-at any time, but if you do, you'll have to begin the installation
-process again from scratch.
-.(enum
-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,
-.Nx
-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.
-.Pp
-It will take a while to load the kernel from the floppy,
-probably around a minute or so.
-.It
-You will then be presented with the
-.Nx
-kernel boot
-messages. You will want to read them, to determine your
-disk's name and geometry. Its name will be something like
-.Li 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
-.Nx 's
-partitions. You will
-also need to know the name, to tell the install tools what
-disk to install on.
-.It
-You will be presented with a welcome message and a prompt
-asking whether you are going to
-.Ic install
-.Nx
-or
-.Ic upgrade
-an existing system.  Select
-.Ic install
-to start installation.
-.It
-You will be presented a prompt asking if you wish to proceed
-with the installation process.  If you wish to proceed,
-enter
-.Sq Ic y
-and press
-.Key RETURN .
-.It
-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.
-.It
-You will then be asked to name your disk's disklabel. The
-default response is
-.Sq Ic 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.
-.It
-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, press
-.Key CONTROL-C
-and when you get to the shell prompt, restart the
-install process by running the
-.Ic 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.
-.It
-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
-.Sq Ic c
-for cylinders, or
-.Sq Ic s
-for sectors.
-.It
-You will be asked to enter the size of your
-.Nx
-root partition
-.Pq Pa / .
-It should be at least 20 MB, but if you are going to
-be doing development, 25 MB 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.
-.It
-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.
-.It
-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,
-.Pa /usr .
-(Machines used as servers will probably also want
-.Pa /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
-.Pq Pa /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
-.Pa /usr .
-.It
-.Em You are now at the
-.Em point of no return .
-Nothing has been
-written to your disk yet, but if you confirm that you want to
-install
-.Nx ,
-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
-.Sq Ic yes
-at the prompt.
-.It
-The install program will now label your disk and make the file
-systems you specified. The file systems will be initialized to
-contain
-.Nx
-bootstrapping binaries and configuration files.
-It will also create an
-.Pa /etc/fstab
-for your system, and mount all of the file systems under
-.Pa /mnt .
-(In other words, your
-.Pa /
-(root) partition will be mounted on
-.Pa /mnt ,
-your
-.Pa /usr
-partition on
-.Pa /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.
-.It
-You will be placed at a shell prompt
-.Pq Sq Li # .
-The remaining
-tasks are to copy the kernel from the kernel copy floppy to
-the hard drive's root file system and install the distribution
-sets. The flow of installation differs depending on your
-hardware resources, and on what media the distribution sets
-reside.
-.enum)
-.(tag indent
-.It Em To\ install\ from\ removable\ hard disk
-.Pp
-The first thing you should do is pick a temporary
-directory where the distribution files can be stored.
-To do this, enter the command
-.Ic Set_tmp_dir ,
-and enter
-the name of the temporary directory. (Don't forget
-that your disk is mounted under
-.Pa /mnt ;
-you should
-probably pick a directory under
-.Pa /mnt/usr . )
-The default is
-.Pa /mnt/usr/distrib .
-.Pp
-Insert the media onto the drive. Check the device
-name of your drive from the boot message. The device
-name is something like
-.Li sd2
-depending on the SCSI
-disk drives connected to your machine. Note that the
-boot message can be displayed with the command
-.Ic more /kern/msgbuf .
-.Pp
-Mount the disk on the temporary directory with a
-command like:
-.Pp
-.Dl # Ic "mount -t msdos /dev/sd2c" Ar tmp_dir
-.Pp
-if your removable drive's name is
-.Li sd2 .
-.Pp
-Run the
-.Ic Extract
-command once for each distribution
-set you wish to install. For instance, if you wish to
-install the
-.Sy base
-distribution set, followed by the
-.Sy kern
-distribution set, and finally the
-.Sy etc
-distribution set, use the commands:
-.Pp
-.Dl # Ic "Extract base"
-.Dl # Ic "Extract kern"
-.Dl # Ic "Extract etc"
-.Pp
-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.
-.It Em To install from floppy
-.Pp
-The first thing you should do is pick a temporary
-directory where the distribution files can be stored.
-To do this, enter the command
-.Ic Set_tmp_dir ,
-and enter
-the name of the temporary directory. (Don't forget
-that if your disk is still mounted under
-.Pa /mnt ;
-you should probably pick a directory under
-.Pa /mnt/usr . )
-.Pp
-After you have picked a temporary directory, enter the
-.Ic Load_fd
-command, to load the distribution sets from
-your floppies.