FreeBSD 2.1.5 Usage Instructions: Under MSDOS type VIEW to start. Under other operating systems, read the README.TXT file in the root directory. For Technical information & support: Email: info@freebsd.org. WEB: http://www.freebsd.org/ Technical Support: support@cdrom.com Thanks to: Andrew A. Chernov, Bruce Evans, David Greenman, Garrett A. Wollman, Gary Palmer, Joerg Wunsch, John Dyson, Jordan K. Hubbard, Justin Gibbs, Peter Wemm, Poul-Henning Kamp, Rich Murphey, Satoshi Asami and Soren Schmidt. Special thanks to Satoshi Asami, David Greenman, and Jordan K. Hubbard. This CDROM contains software developed by the University of California, Berkeley, and its contributors; by the Free Software Foundation; by the University of Illinois; by the Massachusetts Institute of Technology; by the University of Vermont and State Agricultural College; by Carnegie Mellon University; and by a large number of contributors, whose names are listed on the CDROM in the file /COPYRIGHT.FreeBSD. FreeBSD is a registered trademark ¨ of FreeBSD, Inc. and Walnut Creek CDROM This CDROM is copyright © 1996 Walnut Creek CDROM Original BSD Daemon copyright © 1988 Marshall Kirk McKusick All Right Reserved. Preprinted With Permission. Cover design by: Ellen Y. Hsu Cover Daemon artwork by: Tatsumi Hosokawa To order or to register your product: 1-800-786-9907 ¥ +1-510-674-0783 ¥ Fax +1-510-674-0821 orders@cdrom.com ¥ http://www.cdrom.com/ QUICK INSTALLATION GUIDE FOR FREEBSD 2.1.5 This manual documents the process of installing FreeBSD on your machine. Please also see the Hardware Guide in the root directory of the CDROM for hardware-specific installation instructions (how to configure your hardware, what sorts of things to watch out for, etc.) before starting a new installation. 1.0 DOS userÕs Question and Answer section 1.1 Help! I have no space! Do I need to delete everything first? If your machine is already running DOS and has little or no free space available for FreeBSDÕs installation, all is not lost! You may find the FIPS utility, provided in the tools/ subdirectory on the FreeBSD CDROM to be quite useful. FIPS allows you to split an existing DOS partition into two pieces, preserving the original partition and allowing you to install onto the second free piece. You first ÒdefragÓ your DOS partition, using the DOS 6.xx DEFRAG utility or the Norton Disk tools, then run FIPS. It will prompt you for the rest of the information it needs. Afterwards, you can reboot and install FreeBSD on the new partition. Also note that FIPS will create the second partition as a ÒcloneÓ of the first, so youÕll actually see that you now have two DOS Primary partitions where you formerly had one. DonÕt be alarmed! You can simply delete the extra DOS Primary partition (making sure itÕs the right one by examining its size! :) See the Distributions menu for an estimation of how much free space youÕll need for the kind of installation you want. 1.2 Can I use compressed DOS filesystems from FreeBSD? No. If you are using a utility such as Stackerª or DoubleSpaceª or Windows 95 compressed file system option, FreeBSD will only be able to use whatever portion of the filesystem you leave uncompressed. The rest of the filesystem will show up as one large file (the stacked/dblspaced file!). DO NOT REMOVE THAT FILE as you will probably regret it greatly! It is probably better to create another uncompressed DOS primary partition and use this for communications between DOS and FreeBSD if such is your desire. 1.3 Can I mount my DOS extended partitions? Yes. DOS extended partitions are mapped in at the end of the other ÒslicesÓ in FreeBSD, e.g. your D: drive might be /dev/sd0s5, your E: drive /dev/sd0s6, and so on. This example assumes, of course, that your extended partition is on SCSI drive 0. For IDE drives, substitute ÒwdÓ for ÒsdÓ appropriately. You otherwise mount extended partitions exactly like you would mount any other DOS drive, e.g.: mount -t msdos /dev/sd0s5/dos_d 1.4 Can I run DOS binaries under FreeBSD? Not yet! WeÕd like to add support for this someday, but are still lacking anyone to actually do the work. Ongoing work with LinuxÕs DOSEMU utility may bring this much closer to being a reality sometime soon. Send mail to hackers@freebsd.org if youÕre interested in joining this effort! There is, however, a neat utility called pcemu in the ports collection which emulates an 8088 and enough BIOS services to run DOS text mode applications. It requires the X Window System (provided as XFree86 3.1.2) to operate. 2.0 Before installing from CDROM: If your CDROM is an unsupported type, then please skip to the next section, which describes how to install from a DOS partition. There is not a lot of preparatory work that needs to be done to successfully install from one of Walnut Creek's FreeBSD CDROMs (other CDROM distributions may work as well, though we cannot say for certain as we have no hand or say in how they're created). You can either boot into the CD installation directly from DOS using Walnut Creek's supplied Òinstall.bat'' batch file or you can make a boot floppy with the Òmakeflp.bat'' command. For the easiest interface of all (from DOS), type view. This will bring up a DOS menu utility that leads you through all the available options. If youÕre creating the boot floppy from a UNIX machine, you may find that dd if=floppies/boot.flp of=/dev/rfd0 or dd if=floppies/boot.flp of=/dev/floppy works well, depending on your hardware and operating system environment. Once youÕve booted from DOS or floppy, you should then be able to select CDROM as the media type in the Media menu and load the entire distribution from CDROM. No other types of installation media should be required. After your system is fully installed and you have rebooted from the hard disk, you can mount the CDROM at any time by typing: mount /cdrom . Before removing the CD again, also note that itÕs necessary to first type umount /cdrom . DonÕt just remove it from the drive! SPECIAL NOTE: Before invoking the installation, be sure that the CDROM is in the drive so that the ÒprobeÓ can find it! This is also true if you wish the CDROM to be added to the default system configuration automatically during the install (whether or not you actually use it as the installation media). Finally, if you would like people to be able to FTP install FreeBSD directly from the CDROM in your machine, youÕll find it quite easy. After the machine is fully installed, you simply need to add the following line to the password file (using the vipw command): ftp:*:99:99::0:0:FTP:/cdrom:/nonexistent Anyone else at your site will now be able to chose a Media type of FTP and type in: ftp:// after picking ÒOtherÓ in the ftp sites menu to install from the CD in your machine! 2.1 Before installing from a DOS partition: To prepare for installation from an MS-DOS partition you should simply copy the files from the distribution into a directory called ÒFREEBSDÓ. For example, to do a minimal installation of FreeBSD from DOS using files copied from the CDROM, you might do something like this: C> MD C:\FREEBSD C> XCOPY /S E:\DISTS\BIN C:\FREEBSD\BIN Assuming that ÔC:Õ was where you had free space and ÔE:Õ was where your CD was mounted. For as many ÔDISTSÕ as you wish to install from DOS (and you have free space for), install each one in a directory under C:\FREEBSD Ñ the BIN dist is only the minimal requirement. 3.0 Installing FreeBSD Once youÕve taken note of the appropriate preinstallation steps, you should be able to install FreeBSD without any further trouble. Should the installation fail at some stage, then you may wish to go back and re-read the relevant preparation section (section 2.x). Perhaps thereÕs a helpful hint there that you missed the first time? If youÕre having hardware trouble or FreeBSD refuses to boot at all, then read the Hardware Guide (in the top level directory of the CDROM) for a list of possible solutions. The FreeBSD boot floppy contains all the on-line documentation you should need to be able to navigate through an installation. If it doesnÕt, then IÕd like to know what you found most confusing so that I can fix it in future releases! It is the objective of the FreeBSD installation program (sysinstall) to be self-documenting enough that painful Òstep-by-stepÓ guides are no longer necessary. You may also find the following Òtypical installation sequenceÓ to be useful reading: ¥ Boot the boot floppy. After a boot sequence which can take anywhere from from 30 seconds to 3 minutes, depending on the speed of your hardware, you should be presented with a menu of initial choices. If the floppy doesnÕt boot at all, or the boot hangs at some stage, go read the Q&A section of the Hardware Guide for some possible causes. ¥ Press F1. You should see some basic usage instructions on the menu system and general navigation within it. If you havenÕt used this installation system before then PLEASE read this thoroughly! ¥ Select the Novice installation and follow the instructions. Even if youÕre moderately familiar with UNIX, chose the Novice install! ÒNoviceÓ in this context means new to the FreeBSD installer, not computers in general! The other installation types (Custom and Express) assume that youÕve installed FreeBSD using this version of the installation utility and know exactly what you are doing! Novice users and 25 year veterans of UNIX alike can benefit from the tips provided by the Novice install, so donÕt be proud - be a novice! :) Installation type overview: Custom installation: You can do anything you like in this menu without altering your system except for ÒCommit,Ó which will perform any pending actions you may have selected. Some of the menu options will also have direct ÔWriteÕ commands available for committing an operation immediately, but they should only be used if youÕre absolutely sure itÕs necessary. ItÕs generally safer to stack up your changes and then commit them all at once so that youÕre left with the option of changing your mind up to the very last moment. In particular, the (W)rite options in the fdisk and label screens will not work for a new installation! TheyÕre meant for tweaking existing installations, not doing new ones. Use the final commit option as there is no advantage whatsoever to be gained in writing the information out stage by stage in a new installation. If youÕre confused at any point, the F1 key will pull up what is hopefully some helpful information for the screen youÕre in. Express installation: This installation will invoke all the appropriate steps in order as if youÕd selected them one by one from the custom installation menu. It assumes that you know what you are doing and have run the installation at least once before. If this is not the case, the Novice installation method is recommended. Novice installation: As previously mentioned, the Novice installation leads you through the required stages in the proper order and presents you with various helpful prompts in between. Once the system is installed, it will also present you with the opportunity to perform a variety of Òpost installÓ actions. A quick synopsis of the stages involved in a novice installation follows: ¥ FreeBSD. If youÕre dedicating an entire drive to FreeBSD, the ÔAÕ command is probably all you need to type here, otherwise move to a partition marked ÔUnusedÕ (or delete an existing one) and use the ÔCÕ command to create a FreeBSD partition in its place. ¥ Next, with the ÔLabel EditorÕ, you can specify how the space in any FreeBSD partitions should be used by FreeBSD. You can also mount any non-FreeBSD partitions (such as DOS) in this screen. If you want the standard layout, simply type ÔAÕ for the defaults. ¥ Next, the ÔDistributionsÕ menu allows you to specify how much of FreeBSD youÕd like to load. A good choice is the ÒUserÓ distribution for a small system or the ÒDeveloperÓ distribution for someone wanting a more programmer-oriented configuration. If none of the existing collections seem applicable, select Custom to choose the component distributions yourself. ¥ Next, the ÔMediaÕ menu allows you to specify what kind of media you wish to install from. You should select ÔCDROMÕ. ¥ Finally, youÕll be prompted to commit all of these actions at once (nothing has been written to your disk so far, nor will it until you give the final confirmation). All new or changed partition information will be written out, file systems will be created and/or non-destructively labeled (depending on how you set their ÒnewfsÓ flags in the Label Editor) and all selected distributions will be extracted. ¥ After the system is fully installed, youÕll then have the option to configure the system in various ways, install a WEB server, etc. At this point, youÕre generally done with the sysinstall utility and can reboot the system. If you elected to install the boot manager, you should now see a small boot menu with an ÔF?Õ prompt. Press the function key corresponding to the BSD partition and you should boot up into FreeBSD off the hard disk. If this fails to happen for some reason, see the Q & A section of the Hardware Guide for possible clues! The most likely problem is a mis-matched hard disk geometry, which will have to be corrected with a second pass through the install, using the (G) command in the fdisk menu to properly set the geometry the next time. Should you wish to re-enter this installation later, you will find it under /stand/sysinstall on the installed system. Good luck! If you really get stuck, you may send mail to our support mailing list -questions@FreeBSD.org. WeÕll do our best to help you! 3.1 Repairing an existing FreeBSD installation. FreeBSD 2.1.5 now features a ÒFixitÓ option in the top menu of the boot floppy. To use it, you will also need a fixit.flp image floppy, generated in the same fashion as the boot floppy. To use it, simply boot the boot floppy, chose the ÒFixitÓ item and insert the fixit floppy when asked. You will then be placed into a shell with a wide variety of comments available for checking, repairing and examining file systems and their contents. Some administration experience is required to use this option! Jordan