Section A.4. Testing | Operating Systems Design and Implementation (3rd Edition)

[Page 634]

A.4. Testing

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

boot c0d0p3

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. Try the one announced by the setup script first. This is a good time to create a root password. See man passwd for help.

Compile the test suite
To test MINIX 3, at the command prompt (#) type
```
cd /usr/src/test make 
```
and wait until it completes all 40 compilations. Log out by typing CTRL-D,
Run the test suite
To test the system, log in as bin (required) and type
```
cd /usr/src/test ./run 
```
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. Note: 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.
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:
```
cd /usr/src/tools make 
```
to see the various options available. Now make a new bootable image by typing
```
su make clean time make image 
```
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
[Page 635]
```
make fdboot 
```
When you are asked to complete the path, type:
```
fd0 
```
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
```
make hdboot 
```
Shut down and reboot the new system
To boot the new system, first shut down by typing:
```
shutdown 
```
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:
```
help 
```
For more details, see www.minix3.org/manpages/man8/boot.8.html. You can now remove any CD-ROM or floppy disk and turn off the computer.
Booting Tomorrow
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:
```
shutdown 
```
to get back to the MINIX 3 boot monitor. Now type:
```
boot c0d0p0 
```
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:
```
boot c0d0p1 
```
and so on.
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 www.minix3.org/manpages/man8/boot.8.html.
[Page 636]
Finally, a fourth option is for you to install a multiboot loader such as LILO or GRUB (www.gnu.org/software/grub). 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 on the subject at www.minix3.org/doc.