From 28639160cece6be1bd07847cc25f681c74107a49 Mon Sep 17 00:00:00 2001 From: Ben Gras Date: Tue, 20 Sep 2005 09:24:02 +0000 Subject: [PATCH] New setup manpage --- man/man8/setup.8 | 375 ++++++++++++++++++++++++++++++++++++++++++----- 1 file changed, 335 insertions(+), 40 deletions(-) diff --git a/man/man8/setup.8 b/man/man8/setup.8 index 7bab7b775..70976b8b3 100644 --- a/man/man8/setup.8 +++ b/man/man8/setup.8 @@ -1,26 +1,166 @@ -.de IT -.nr a +1 1 -.ti -0.25i -.if \\na<10 \\0\\na.~\\fB\\$1\\fP -.if \\na>9 \\na.~\\fB\\$1\\fP -.PP -.. -.de Cb +.TH SETUP 8 +.SH NAME +setup \- Install MINIX 3 on a hard disk +.SH SYNOPSIS +setup +.SH DESCRIPTION +.tr ~ +.nr a 0 +1 +.de CB .sp 0.5v \s-1\\f5\\c .. -.de Ce +.de CE \\fR\\s0\\c .sp 0.5v .. -.tr ~ -.TH SETUP 8 -.SH NAME -setup \- install MINIX 3 on the hard disk -.SH SYNOPSIS -\fBsetup\fR -.SH DESCRIPTION -.in +0.25i +.de IT +.ti -0.25i +.if \\na<10 \\0\\n+a.~\\fB\\$1\\fP +.if \\na>9 \\n+a.~\\fB\\$1\\fP +.PP +.. +.PP +This appendix explains how to install MINIX 3. +Standard MINIX 3 requires a Pentium (or compatible) with at least +16-MB of RAM, at least 200-MB of free disk space, an IDE CD-ROM and an +IDE hard disk. Serial ATA, USB, and SCSI disks are not supported at present. +For USB CD-ROMS, see the Website: \fIwww.minix3.org\fR. + +\fBPREPARATION\fR +.PP +If you already have the CD-ROM (e.g., from the book), you can skip steps 1 and +2, but it is wise to check \fIwww.minix3.org\fR to see if a newer version +is available. +If you want to run MINIX 3 on a simulator instead of native, see Part V first. +If you do not have an IDE CD-ROM, +either get the special USB CD-ROM boot image or use a simulator. + +.IT "Download the MINIX 3 CD-ROM image" +Download the MINIX 3 CD-ROM image from the MINIX 3 Website +at \fIwww.minix3.org\fR. + +.IT "Create a bootable MINIX 3 CD-ROM" +Decompress the downloaded file. +You will get a CD-ROM image file with extension \fI.iso\fR and this manual. +The \fI.iso\fR file is a bit-for-bit CD-ROM image. +Burn it to a CD-ROM to make a bootable CD-ROM. +.PP +If you are using \fIEasy CD Creator 5\fR, select \*(OQRecord CD from CD image\*(CQ from the File +menu and change the file type from \fI.cif\fR to \fI.iso\fR in the dialog box that +appears. Select the image file and click \*(OQOpen.\*(CQ Then click \*(OQStart Recording.\*(CQ +.PP +If you are using \fINero Express 5\fR, choose \*(OQDisc Image or Saved Project\*(CQ and +change the type to \*(OQImage Files,\*(CQ select the image file and click \*(OQOpen.\*(CQ +Select your CD recorder and click on \*(OQNext.\*(CQ +.PP +If you are running Windows and do not have a CD-ROM burning program, take a look at +.br +\fIalexfeinman.brinkster.net/isorecorder.htm\fR +.br +for a free one and use it to create +a CD image. + +.IT "Determine which Ethernet Chip you have" +.PP +MINIX 3 supports several Ethernet chips for networking over LAN, ADSL, and +cable. These include Intel Pro/100, RealTek 8029 and 8139, AMD LANCE, +and several 3Com chips. +During setup +you will be asked which Ethernet chip you have, if any. Determine that now by +looking at your documentation. Alternatively, if you are using Windows, go to +the device manager as follows: +.sp 1 +.ta 0.9i +Windows 2000: +.br +Start> Settings> Control Panel> System> Hardware> Device Mgr +.sp 1 +Windows XP: +.br +Start> Control Panel> System> Hardware> Device Mgr\s0 +.ll -1i +.sp 1 +System requires double clicking; the rest are single. Expand the + next to +\*(OQNetwork adapters\*(CQ to see what you have. Write it down. If you do not have +a supported chip, you can still run MINIX 3, but without Ethernet. + +.IT "Partition your hard disk" +.PP +You can boot the computer from your CD-ROM if +you like and MINIX 3 will start, but to do anything useful, you have to create a +partition for it on your hard disk. +But before partitioning, be sure to \fBback up your data to an external med\%ium +like CD-ROM or DVD\fR as a safety precaution, just in case something goes wrong. +Your files are valuable; protect them. +.PP +Unless you are sure you are an expert on disk partitioning with much experience, it is strongly suggested that you +read the online tutorial on disk partitioning +at \fIwww.minix3.org/doc/partitions.html.\fR +If you already know how to manage partitions, create a contiguous chunk of free +disk space of at least 200 MB (even better: 400 MB or more). +If you do not know how to manage partitions but have a partitioning program +like \fIPartition Magic\fR, use it to create a region of free disk space of at +least 200 MB. Also make sure there is at least one primary partition (i.e., +Master Boot Record slot) free. +The MINIX 3 setup script will guide you through creating a MINIX partition in the +free space, which can be on either the first or second IDE disk. +.PP +If you are running Windows 95, 98, ME, or 2000 \fIand\fR your disk consists of a single +FAT partition, you can use the \fIpresz134.exe\fR program on the CD-ROM +(also available at \fIzeleps.com\fR) to reduce its size to leave room for MINIX. +In all other cases, please read the online tutorial cited above. +.PP +\fBWARNING: If you make a mistake during disk partitioning, you can lose all the data +on the disk, so be sure to back it up to CD-ROM or DVD before starting. +Disk partitioning requires great care, so proceed with caution.\fR + +\fBBOOTING\fR +.nr a 0 +.PP +By now you should have allocated at least 200 MB of free space on your disk. +If you have not done so yet, please do it now unless there is an existing +200-MB (or larger) partition you are willing to convert to MINIX 3. + +.IT "Boot from the CD-ROM" +Insert the CD-ROM into your CD-ROM drive and boot the computer from it. +If you have 16 MB of RAM or more, choose \*(OQRegular;\*(CQ +if you have only 8 MB choose \*(OQsmall.\*(CQ +If the computer boots from the hard disk instead of the CD-ROM, boot again and enter the +BIOS setup program to change the order of boot devices, putting the CD-ROM before +the hard disk. + +.IT "Login as root" +When the \fIlogin\fR prompt appears, login as \fIroot.\fR +After a successful login as root, you will see the shell prompt (#). +At this point you are running fully-operational MINIX 3. If you type: +.CB l + ls /usr/bin | more +.CE +you can see what software is available. +Hit space to scroll the list. +To see what program \fIfoo\fR does, type: +.CB l + man foo +.CE +The manual pages are also available at +.br +\fIwww.minix3.org/manpages\fR. + +.IT "Start the setup script" +To start the installation of MINIX 3 on the hard disk, type +.CB l + setup +.CE +After this and all other commands, be sure to type ENTER (RETURN). +When the installation script ends a screen with a colon, hit ENTER to +continue. If the screen suddenly goes blank, press CTRL-F3 to select +software scrolling (should only be needed on very old computers). +Note that CTRL-key means depress the CTRL key and while holding it down, +press \*(OQkey.\*(CQ + +\fBINSTALLING TO THE HARD DISK\fR +.nr a 0 .PP These steps correspond to the steps on the screen. @@ -34,60 +174,84 @@ on UNIX systems. .IT "Select your Ethernet chip" You will now be asked which of the available Ethernet driver you want -installed (or none). Please choose one of the options. +in\%stalled (or none). Please choose one of the options. -.IT "Create a partition for MINIX 3" +.IT "Basic minimal or full install?" +If you are tight on disk space, select M for a minimal installation +which includes all the binaries but only the system sources installed. +200 MB is enough for a bare-bones system. If you have 400 MB or more, +choose F for a full installation. + +.IT "Create or select a partition for MINIX 3" You will first be asked if you are an expert in MINIX 3 disk partitioning. If so, you will be placed in the \fIpart\fR program to give you full power to edit the Master Boot Record (and enough rope to hang yourself). If you are not an expert, press ENTER for the default action, which is an -automated step-by-step guide to creating a disk partition. +automated step-by-step guide to formatting a disk partition for MINIX 3. -\fBSubstep 2.1: Select a disk to install MINIX 3\fR +\fBSubstep 4.1: Select a disk to install MINIX 3\fR .PP An IDE controller may have up to four disks. The \fIsetup\fR script will now look for each one. Just ignore an error messages. When the drives are listed, select one. and confirm your choice. -If you have two hard disks and install MINIX 3 to the second one and have +If you have two hard disks and you decide to install MINIX 3 to the second one and have trouble booting from it, please see \fIwww.minix3.org/doc/using2disks.html\fR for the solution. -\fBSubstep 2.2: Select a disk region\fR +\fBSubstep 4.2: Select a disk region\fR .PP -You must now choose a region to install MINIX 3 into. You have three choices: +Now choose a region to install MINIX 3 into. You have three choices: .sp 0.5v (1) Select a free region (2) Select a partition to overwrite - (3) Delete an existing partition to free up space and merge with adjacent free space + (3) Delete an existing partition to free up space and merge with adjacent free +space .sp 0.5v For choices (1) and (2), type the region number. For (3) type -.Cb +.sp -0.25v +.CB l delete -.Ce -then give the region number when asked. +.CE +.sp -0.25v +then give the region number when asked. +This region will be overwritten and its previous contents lost forever. -\fBSubstep 2.3: Confirm your choices\fR +\fBSubstep 4.3: Confirm your choices\fR .PP You have now reached the point of no return. You will be asked if you want to continue. \fBIf you do, the data in the selected region will be lost forever.\fR If you are sure, type: -.Cb +.CB l yes -.Ce +.CE and then ENTER. To exit the setup script without changing the partition table, hit CTRL-C. +.IT "Reinstallation choice" +If you chose an existing MINIX 3 partition, in this step you will be +offered a choice between a Full install, which erases everything in the +partition, and a Reinstall, which does not affect your existing \fI/home\fR +partition. This design means that you can put your personal files on +\fI/home\fR and reinstall a newer version of MINIX 3 when it is available +without losing your personal files. + +.IT "Select the size of /home" +The selected partition will be divided into three subpartitions: root, \fI/usr\fR, +and \fI/home\fR. The latter is for your own personal files. Specify how much of the +partition should be set aside for your files. +You will be asked to confirm your choice. + .IT "Select a block size" Disk block sizes of 1-KB, 2-KB, 4-KB, and 8-KB are supported, but to use a size larger than 4-KB you have to change a constant and recompile -the system. If your memory is 16 MB or more, use the default (4 KB); with -smaller memories, use 1 KB. +the system. If your memory is 16 MB or more, use the default (4 KB); +otherwise, use 1 KB. .IT "Wait for bad block detection" -The setup script will now scan for bad disk blocks. This will take +The setup script will now scan each partition for bad disk blocks. This will take several minutes, possibly 10 minutes or more on a large partition. Please be patient. -If you are absolutely certain there are no bad blocks, you can kill the scan +If you are absolutely certain there are no bad blocks, you can kill each scan by hitting CTRL-C. .IT "Wait for files to be copied" @@ -95,12 +259,143 @@ When the scan finishes, files will be automatically copied from the CD-ROM to the hard disk. Every file will be announced as it is copied. When the copying is complete, MINIX 3 is installed. Shut the system down by typing -.Cb +.CB l shutdown -.Ce +.CE Always stop MINIX 3 this way to avoid data loss as MINIX 3 keeps some files on the RAM disk and only copies them back to the hard disk at shutdown time. -.SH "SEE ALSO" -.BR boot(8), -.BR usage (8) + + +\fBTESTING\fR +.nr a 0 +.PP +This section tells you how to test your installation, rebuild the system after +modifying it, and boot it later. To start, boot your new MINIX 3 system. +For example, if you used controller 0, disk 0, partition 3, type +.CB l + boot c0d0p3 +.CE +and log in as root. Under very rare conditions the drive number seen by the +BIOS (and used by the boot monitor) may not agree with the one used by +MINIX 3, in which case try other drive numbers. +This is a good time to create a root password. See \fIman passwd\fR for help. + +.IT "Compile the test suite" +To test MINIX 3, at the command prompt (#) type +.CB l + cd /usr/src/test +.br + make +.CE +and wait until it completes all 40 compilations. +Log out by typing CTRL-D, + +.IT "Run the test suite" +To test the system, log in as bin (required) and type +.CB l + cd /usr/src/test +.br + ./run +.CE +to run the test programs. They should all run correctly but they can take +20 min on a fast machine and over an hour on a slow one. +\fINote\fR: It is necessary to compile the test suite when running as root +but execute it as bin in order to see if the setuid bit works correctly. + +.IT "Rebuild the entire operating system" +If all the tests work correctly, you can now rebuild the system. +Doing so is not necessary since it comes prebuilt, but +if you plan to modify the system, you will need to know how to rebuild it. +Besides, rebuilding the system is a good test to see if it works. Type: +.CB l + cd /usr/src/tools +.br + make +.CE +to see the various options available. Now make a new bootable image by typing +.CB l + su + make clean + time make image +.CE +You just rebuilt the operating system, including all the kernel and user-mode +parts. That did not take very long, did it? +If you have a legacy floppy disk drive, you can make a +bootable floppy for use later by inserting a formatted floppy and typing +.CB l + make fdboot +.CE +When you are asked to complete the path, type: +.CB l + fd0 +.CE +This approach does not currently work with USB floppies since there is no MINIX 3 USB +floppy disk driver yet. +To update the boot image currently installed on the hard disk, type +.CB l + make hdboot +.CE + +.IT "Shut down and reboot the new system" +To boot the new system, first shut down by typing: +.CB l + shutdown +.CE +This command saves certain files and returns you to the MINIX 3 boot monitor. +To get a summary of what the boot monitor can do, while in it, type: +.CB l + help +.CE +For more details, see \fIwww.minix3.org/manpages/man8/boot.8.html\fR. +You can now remove any CD-ROM or floppy disk and turn off the computer. + +.IT "Booting Tomorrow" +.PP +If you have a legacy floppy disk drive, the simplest way to boot MINIX 3 is by +inserting your new boot floppy and turning on the power. It takes only a few seconds. +Alternatively, boot from the MINIX 3 CD-ROM, login as bin and type: +.CB l + shutdown +.CE +to get back to the MINIX 3 boot monitor. Now type: +.CB l + boot c0d0p0 +.CE +to boot from the operating system image file on +controller 0, driver 0, partition 0. +Of course, if you put MINIX 3 on drive 0 partition 1, use: +.CB l + boot c0d0p1 +.CE +and so on. +.PP +A third possibility for booting is to make the MINIX 3 partition the active one, +and use the MINIX 3 boot monitor to start MINIX 3 or any other operating system. +For details +see \fIwww.minix3.org/manpages/man8/boot.8.html\fR. +.PP +Finally, a fourth option is for you to install a multiboot loader such as +LILO or GRUB (\fIwww.gnu.org/software/grub\fR). +Then you can boot any of your operating systems easily. +Discussion of multiboot loaders is beyond the scope of this guide, but there +is some information of the subject at \fIwww.minix3.org/doc\fR. + +\fBUSING A SIMULATOR\fR +.nr a 0 +.PP +A completely different approach to running MINIX 3 is to run it +on top of another operating system instead of native on the bare +metal. Various virtual machines, simulators, and emulators are +available for this purpose. Some of the most popular ones are: + + \(bu VMware (www.vmware.com) +.br + \(bu Bochs (www.bochs.org) +.br + \(bu QEMU (www.qemu.org) +.sp 1v +See the documentation for each of them. Running a program on a +simulator is similar to running it on the actual machine, so you +should go back to Part I and acquire the latest CD-ROM and continue +from there. -- 2.44.0