THE FREEDOS BETA 8 Hot ("Nikita") DISTRIBUTION CD-ROM BASED INSTALLATION INFORMATION Updated by Jeremy Davis 23 August 2002 -------------------------------------------------------------------------- This FreeDOS CD-ROM is intended to allow one to boot the FreeDOS kernel and then either install FreeDOS to a hard drive, or run FreeDOS (use the included programs) directly from the CD. Please visit http://www.freedos.org for more information about FreeDOS The CD image (or CD-ROM) may be useful in emulation environments (such as Bochs [bochs.sourceforge.net] or vmware [www.vmware.com]) however it has not been tested using them and as such is not guarentteed to work. Please read the other installation documents before attempting to install FreeDOS: DOCS\INSTALL.TXT (a general overiew aimed more at those installing FreeDOS using the floppy based distribution) and DOCS\INSTALL2.TXT (more detailed information about the steps to perform during installation, written for when booting from the installation floppy of the floppy based distribution, but most included information applies to installation from this CD as well. A What is on this CD (Layout) B How do I run (or install) FreeDOS from this CD C Creating a custom boot floppy to use with this CD D Creating a custom CD E Reporting problems -------------------------------------------------------------------------- A What is on this CD (Layout) -------------------------------------------------------------------------- This CD contains a complete (except for the source install sets) FreeDOS installation in \FREEDOS\FDOS\ which is used by the installation routines. Additionally, all install sets have been extracted into \FREEDOS\INSTALL\DISKSETS\ (so you may omit any instructions that specify to unzip install sets such as BASE1.ZIP, UTIL1.ZIP, ...) thus you may use :\FREEDOS\INSTALL\DISKSETS\ as the source for installation purposes. AUTORUN.INF Windows stuff for when people view CD-ROM README.1ST General readme that should be read \isolinux\ Contains the bootable CD files such as ISOLINUX \FREEDOS\ Contains most of the FreeDOS related files INSTALL.BAT Installs FreeDOS from this CD-ROM READ.ME Basic information about this distribution AUTORUN\ Startup files and additional AUTORUN data DISKIMGS\ Contains a generic* CD-ROM based installation disk images (*requires you to add your own CD-ROM drivers) DOCS\ Contains important readmes, installation information, ... EXTRAS\ Contains additional DOS programs that may be of interest FDOS\ Contains FreeDOS installed, used when running from CD-ROM INSTALL\ Contains files used when installing from this CD-ROM DISKSETS\ Contains all the disksets, used to install to hd DOCS\ Localizable documentation used during installation INSTALL\ The install program itself and its data -------------------------------------------------------------------------- B How do I run (or install) FreeDOS from this CD -------------------------------------------------------------------------- To run FreeDOS from the CD, boot [either directly from the CD or using a floppy boot disk with DOS CD-ROM drivers] and make sure that :\FREEDOS\FDOS\BIN is in your PATH environment variable (where is the drive letter of your CD-ROM drive). If you use xkeyb you may also want to add :\FREEDOS\FDOS\BIN\KEY to your PATH. Note: when booting directly from the CD or using a custom boot floppy as escribed in Section C, the path should already be setup and FreeDOS ready to run. (where A:\ is your current drive and R: should be your CD-ROM drive) A:\>set PATH=R:\FREEDOS\FDOS\BIN;R:\FREEDOS\FDOS\BIN\KEY;%PATH% \FREEDOS\AUTORUN\AUTORUN.BAT may be ran to initiate installing FreeDOS from this CD-ROM. If it fails to find your CD-ROM drive with this CD in it, then manually set the cdrom environment variable to the appropriate drive letter including the color (:) before executing AUTORUN.BAT. The installation must be performed using FreeCom. If you booted using a different command interpreter (such as one for another DOS) then you may need to run \FDOS\BIN\COMMAND.COM /E:512 before begining the installation. R:\>set cdrom=R: R:\>\FREEDOS\AUTORUN\AUTORUN.BAT If you are having difficulties (your computer freezes or other odd behaviour) when running FreeDOS from the CD (or during installation). You may wish to use the DOS CD-ROM driver for your specific CD drive. To aid in doing this, when booting from the CD, options 3 and 4 allow you to boot using drivers available on a diskette in your 1st floppy drive. For ATAPI (IDE) drives [or any drive that only requires a single driver file] place your driver on the floppy in a directory named DRIVER and rename it to ATAPICDD.SYS. For SCSI drives [or any drive that requires two drivers loaded] the diskette should contain the files \DRIVER\ASPI8DOS.SYS and \DRIVER\ASPICD.SYS. The CD-ROM driver (ATAPICDD.SYS or ASPICD.SYS) is loaded with /D:FDCD0001 specified as the CD device name to use (FDCD0001 is later passed to SHSUCDEX). Note: These are actually referenced as B:\DRIVER\ since the 1st floppy is usually available as the B: drive when booting from the CD-ROM. -------------------------------------------------------------------------- C Creating a custom boot floppy to use with this CD -------------------------------------------------------------------------- If you are unable to boot from the CD-ROM, you may still use it to install FreeDOS by creating a boot floppy. To aid in this, there is a generic FreeDOS CD installation boot disk image on the CD that can be written to a disk and used for this purpose. \FREEDOS\DISKIMGS\FDCD_144.DSK You may use one of the image writing programs available in \FREEDOS\EXTRAS\RAWRITE\ to create the floppy, or if you have a computer that can boot the CD, then one of the options is to write this image to a floppy. i Write it to a floppy ii Copy the CD-ROM driver for your CD-ROM drive to the floppy iii Either rename the driver to ATAPICDD.SYS or edit config.sys and change ATAPICDD.SYS to your driver's filename iv OPTIONAL: Copy KERNEL32.SYS to KERNEL.SYS to use the EXPERIMENTAL Fat32 enabled kernel (KERNEL16.SYS is the standard kernel) v Boot using the floppy (with the FreeDOS CD in your CD drive) vi Continue installation just as though you booted directly from the CD -------------------------------------------------------------------------- D Creating a custom CD -------------------------------------------------------------------------- To create this CD-ROM I used the information from http://www.nu2.nu/bootcd/ (Bart's way to create bootable CD-Roms). To modify this image to suit please visit the above site and read the information there. Briefly, you will need 'cdrpack' v1.3 (though later versions will probably also work fine) and the 'multi_memdisk_addon' zip archive. For Microsoft Windows Operating System, the above page currently provides links for all required files, but you should be able to perform similar steps from other Operating Systems if a port of cdrecord/mkisofs is available. Unzip the above archives into a directory, copy the contents of this CD image to cds\multi_memdisk\disk1\ including replacing the 'isolinux' subdirectory. Bart's page currently includes ISOLINUX 1.67 and MEMDISK 1.67, however this image uses a later version of these programs (see isolinux/SYSLINUX.ZIP for the archive I obtained them from). Edit the makefiles to set the values for fields such as volumeid (the CD's label) and preparer (your name). [Upon request I (Jeremy) will send you my current setup if possible.] Make your changes and then run run.bat in cds/ to build your custom image (and write it to a CDR if you have a CD-Writer available). If you have a recent CD drive (or a DVD drive) I would suggest using a CD-RW for testing purposes, and then writing to a CD-R once you are satisfied. UPDATE: Please look in isolinux/BUILDCD for tools to aid in creating your customized ISO image. Under Windows it should be a simple five step procedure: 1) copy all the files on the CD to a subdirectory [folder] on your hard drive using Explorer (the GUI) or from the command line e.g. XCOPY R: C:\TEMP\FDCD /S /H 2) make your customizations, removing read-only attributes as needed [copying a file from CD may automatically set it to read-only, so to alter or replace you may need to correct this] 3) change to C:\TEMP\FDCD\isolinux\BUILDCD\ (substituting C:\TEMP\FDCD with the actual path you copied the files to e.g. CD C:\TEMP\FDCD\isolinux\BUILDCD 4) run makeiso.bat which will remove any read-only settings for isolinux files and creates the new ISO image 5) test the ISO image (boot it, view it, etc.) to ensure everything works alright Files you probably will want to change: cds\multi_memdisk\disk1\isolinux\FD16BOOT.IMG and cds\multi_memdisk\disk1\isolinux\FD32BOOT.IMG These are the boot disk images (identical except for KERNEL.SYS) used when booting directly from the CD-ROM. You may want to alter them to include your CD drive's driver. Remember do not distribute copyrighted files without the copyright owner's permission. cds\multi_memdisk\disk1\isolinux\isolinux.cfg and cds\multi_memdisk\disk1\isolinux\bootmsg.txt To add more boot disks or modify the message displayed when booting from the CD. For more information visit the sites below: --------------------------------------------- ELTORITO.SYS DOS CD-ROM driver (c) 2000-2001 by Gary Tong and Bart Lagerweij http://www.nu2.nu/eltorito/ --------------------------------------------- ISOLINUX and MEMDISK copyright 2001 H. Peter Anvin http://syslinux.zytor.com/ --------------------------------------------- -------------------------------------------------------------------------- E Reporting problems -------------------------------------------------------------------------- If you run into problems there are several avenues you may try. If the problem is in one of the Base FreeDOS programs you should report the problem using bugtrack. http://www.freedos.org/bugs/ Other related issues may also be reported there. For problems related to the distribution (program XYZ is missing, please don't include program ZZ3, document NNN should say 'dkdkdk', etc.) please email me: jeremyd@computer.org {No unsolicited Junk email please!} For general FreeDOS related issues, try the FreeDOS mailing lists: http://www.freedos.org/freedos/join/. -------------------------------------------------------------------------- FreeDOS is a trademark of Jim Hall. It was claimed as a trademark to prevent its possible abuse or misuse. The name FreeDOS may be used by the FreeDOS community to refer to programs that are part of the FreeDOS operating system, or to associate their programs with FreeDOS.