THE ELKS DISTRIBUTION EDITION
=============================
INSTALLATION GUIDE
==================

Contents
--------

1. System Specification

2. Disribution Edition - Contents

3. Installation Procedure
	3.1 Prepare to Install
	3.2 Upgrade from an earlier version of EDE
	3.3 New install of EDE
		3.3.1 Prepare the Hard Drive with FreeDOS
		3.3.2 Install EDE
	3.4 Completion of Installation
	3.5 Package Installation

--------------------------------------------------------------------------------------------------

1. System Specification
-----------------------
The ELKS distribution edition has been developed and tested for installation on 286 and 386 PC's.

It has been configured for installation on a primary hard drive only.

It is suggested that 20Mb of hard drive space is available for installation.

--------------------------------------------------------------------------------------------------

2. Distribution Edition - Contents
----------------------------------

The EDE zip file contains the following files :-

FREEDOS.IMG
Is a freedos bootable floppy. This will be required for hard drive preparation.

INSTALL.IMG
Is the ELKS system install disk.

PACKAGE.IMG
Is the ELKS packages install disk.

DISK-LABELS.doc
Floppy disk labels for use with the Avery L7666 staionery.

INSTALL.txt
This installation guide

getty.c, isreboot.c, vtclear.c
Source code for special programs used by the EDE installation procedure.

--------------------------------------------------------------------------------------------------

3. Installation Procedure
-------------------------

3.1 Prepare to Install
----------------------

It is suggested that you produce floppy disk labels using DISK-LABELS.doc from the distribution. This will assist in clearly labeling your disks as you prepare for install.

Having unpacked the contents of the distribution you will need to create the 3 floppy disks from the image files. You will need 3 floppy disks for this purpose. The disks can be created using the RAWRITE command on DOS or, on linux, use the dd command as follows :-

- Insert floppy disk 1

- enter the command dd if=FREEDOS.IMG of=/dev/fd0

- When this is complete (it will take a few minutes), remove the floppy disk and label as "FreeDos Boot Disk"

- Insert floppy disk 2

- enter the command dd if=INSTALL.IMG of=/dev/fd0

- When this is complete (it will take a few minutes), remove the floppy disk and label as "Install Disk"

- Insert floppy disk 3

- enter the command dd if=PACKAGE.IMG of-/dev/fd0

- When this is complete (it will take a few minutes), remove the floppy disk and label as "Package Disk"

You are now ready to commence the installation of the ELKS Distribution Edition.

--------------------------------------------------------------------------------------------------

3.2 Upgrade from an earlier version of EDE
------------------------------------------

If you are upgrading from an earlier version of EDE then the installation could not be easier.

Boot the system from the disk labeled "Install Disk". The system will boot straight into the EDE upgrade procedure. The previous installation of ELKS will be detected and upgraded. 

You can now jump forward to section 3.4 to follow the notes for the completion of installation.

--------------------------------------------------------------------------------------------------

3.3 New install of EDE
----------------------

3.3.1 Prepare the Hard Drive with FreeDOS
-----------------------------------------

Insert the floppy disk labeled "FreeDos Boot Disk" and boot the system from this floppy.

You will witness the FreeDos startup procedure. Then you will see the following prompt on the screen :-

	Welcome to FreeDOS (http://www.freedos.org)!
	A:\>
At the "A:\>" prompt enter "fdisk" as follows :-

	Welcome to FreeDOS (http://www.freedos.org)!
	A:\>fdisk

On hitting the return key you will be presented with a screen as follows :-

	Fixed Disk Setup Program
                	GNU GPL Copyright Brian E. Reifsnyder 1998 - 2001

                                 	 FDISK Options

    	Current fixed disk drive: 1

    	Choose one of the following:

    	1.  Create DOS partition or Logical DOS Drive
    	2.  Set Active partition
    	3.  Delete partition or Logical DOS Drive
    	4.  Display partition information



    	Enter choice:  [1]
                    





	Esc to exit FDISK

Selection of option 4. to Display partition information should present a list of the current partitions set up on your hard drive. In the example shown there is currently a DOS partition set up that is using 80 Mb of the 100 Mb hard drive.


	Display Partition Information

	    Current fixed disk drive: 1

	    Partition  Status   Type    Volume Label  Mbytes   System   Usage
	    C: 1              PRI DOS                    70   FAT16      72%




	    Total disk space is      97  Mbytes (1 Mbyte = 1048576 bytes)

	Esc to continue

You should be able to see from this table if there is space on your system for an ELKS partition. 20Mb is recommended for EDE. It can be seen, in this example, that there is over 20Mb available. Hit the Escape key as instructed and the original menu will be redisplayed.

Fixed Disk Setup Program
                	GNU GPL Copyright Brian E. Reifsnyder 1998 - 2001

                                 	 FDISK Options

    	Current fixed disk drive: 1

    	Choose one of the following:

    	1.  Create DOS partition or Logical DOS Drive
    	2.  Set Active partition
    	3.  Delete partition or Logical DOS Drive
    	4.  Display partition information



    	Enter choice:  [1]
                    





	Esc to exit FDISK

Now select option 1 to "Create DOS partition or Logical DOS Drive". The following menu will be displayed :-

	Create DOS Partition or Logical DOS Drive

   	 Current fixed disk drive: 1

    	Choose one of the following:

    	1.  Create Primary DOS Partition
    	2.  Create Extended DOS Partition
    	3.  Create Logical DOS Drive(s) in the Extended DOS Partition




    	Enter choice:  [ ]




	Esc to return to FDISK options

You should always select option 1 for creating a primary dos drive. This may appear odd but EDE will rectify the position when it installs later. You will next be prompted regarding the partition size that you require. Using the example from this documentation :-

	Create Primary DOS Partition

    Current fixed disk drive: 1

    Do you wish to use the maximum available size for a Primary DOS Partition
    and make the partition active (Y/N).....................? [Y]

The default is to use all remaining space. You can do this, in this instance, ELKS will support up to around 32Mb. In this example, though, the value will be set to 20Mb as so :-

	Create Primary DOS Partition

    Current fixed disk drive: 1

    Partition  Status   Type    Volume Label  Mbytes   System   Usage
     C: 1              PRI DOS   NO NAME         70   FAT16       72%




    Total disk space is     97 Mbytes (1 Mbyte = 1048576 bytes)
    Maximum space available for partition is     27 Mbytes ( 27%)


    Enter partition size in Mbytes or percent of disk space (%) to
    create a Primary DOS Partition.................................: [    20]
                                                                          
                                                                     

The revised partition table will be displayed :-

	Create Extended DOS Partition

    	Current fixed disk drive: 1

    	Partition  Status   Type    Volume Label  Mbytes   System   Usage
     	C: 1              PRI DOS                   70   FAT16       72%
           2              EXT DOS                   20   Extended    20%



    	Total disk space is     97 Mbytes (1 Mbyte = 1048576 bytes)






    	Extended DOS Partition created


	Esc to continue

It is this new second partition that will, eventually, become the ELKS partition.


Now hit Esc as instructed. As the FDISK command being used is a FreeDOS version, it is likely that the screen will prompt for "Logical Drive" size as shown.

Create Logical DOS Drive in the Extended DOS Partition








    No logical drives defined






    Total Extended DOS Partition size is     20 Mbytes (1 Mbyte = 1048576 bytes)
    Maximum space available for partition is     19 Mbytes ( 95%)

    Enter logical drive size in Mbytes or percent of disk space (%)...[    19]
                                                                           


Esc to return to FDISK options

As the new partition is not to be used for FreeDOS you can hit Esc as instructed to return to the FDISK options. Ignore any warning messages on the FDISK menu :-

		FDISK Options

    	Current fixed disk drive: 1

 	Choose one of the following:

	1.  Create DOS partition or Logical DOS Drive
    	2.  Set Active partition
    	3.  Delete partition or Logical DOS Drive
    	4.  Display partition information



    	Enter choice:  [ ]
                


    	WARNING! No partitions are set active - disk 1 is not startable unless
    	a partition is set active

Esc to exit FDISK


And hit Esc to exit FDISK as instructed. The partition that we require for ELKS has now been created. We can now go on to install ELKS. The screen display will show :-

	System will now restart

    		Press any key when ready . . .

Replace the "FreeDOS Boot Disk", in the floppy drive, with the disk labeled "Install Disk" and hit any key as instructed.

--------------------------------------------------------------------------------------------------

3.3.2 Install EDE
-----------------

The system will now boot into the EDE installation. When boot is complete the following screen will display :-


THE
########## ####       #### ####     #####
 ##     ##  ##         ##   #      ##   ##
 ##      #  ##         ##  #      #      #
 ##         ##         ## #       ##
 ##   #     ##         ####        ##
 ######     ##         #####         ###
 ##  ##     ##         ## ##           ##
 ##   #     ##         ##  ##           ##
 ##      #  ##      #  ##   ##    #      #
 ##     ##  ##     ##  ##    ##   ##    ##
########## ########## ####  ####  # ####   DISTRIBUTION EDITION

HARD DRIVE CONFIGURATION
========================

Now entering fdisk. Please set up a type 80 partition to be around 20Mb
c/h/s=211/15/63Command (? for help):

The installation has taken us into the ELKS version of the FDISK command that we have been using in FreeDOS. Enter 'p' at the prompt and the following will be displayed :-

START                  END
Device    Boot  Head Sector Cylinder   Head Sector Cylinder  Type  Sector count
/dev/bda1  *      1    1      0         14   63      151       6        143577
/dev/bda2         0    1    152         14   63      195       5         41580
Command:


Or something similar. This is the partition for the demonstration disk used in this documentation.

"/dev/bda2", in this case, represents the partition that has been created for ELKS using FreeDOS fdisk. (The second partition). There are 2 things that we need to do to this partition before the EDE install can continue.

First, change the type of the partition. Currently it shows as type 5 as this is a FreeDOS dos partition. Enter the command "t" to reveal :-

START                  END
Device    Boot  Head Sector Cylinder   Head Sector Cylinder  Type  Sector count
/dev/bda1  *      1    1      0         14   63      151       6        143577
/dev/bda2         0    1    152         14   63      195       5         41580
Command:t

Set partition type:

Which partition to toggle(1-4):

Select "2" for partition 2 (in this case) or whatever number your new partition is.

You will then see :-

START                  END
Device    Boot  Head Sector Cylinder   Head Sector Cylinder  Type  Sector count
/dev/bda1  *      1    1      0         14   63      151       6        143577
/dev/bda2         0    1    152         14   63      195       5         41580
Command:t

Set partition type:

Which partition to toggle(1-4): 2
Set partition type to what? (l for list):

The partition type that we require is "80". (As was instructed at the start of fdisk - see above). Enter "80".

You will then return to the "command" prompt. "p" will display the partition table again and you will see that the type of your partition has now changed to "80"  as instructed :-

Command:p

                      START                  END
Device    Boot  Head Sector Cylinder   Head Sector Cylinder  Type  Sector count
/dev/bda1  *      1    1      0         14   63      151       6        143577
/dev/bda2         0    1    152         14   63      195      80         41580
Command:

The second thing that we need to do to our new ELKS partition is set it to be bootable. Don't worry about being able to boot your other partitions. EDE will handle that using BootKit. Enter "b" at the prompt and then select "2" for the partition to set. 

Command:b

Toggle bootable flag:

Which partition to toggle(1-4): 2


"p" will now show :-

Command:p

                      START                  END
Device    Boot  Head Sector Cylinder   Head Sector Cylinder  Type  Sector count
/dev/bda1  *      1    1      0         14   63      151       6        143577
/dev/bda2  *      0    1    152         14   63      195      80         41580
Command:

This is, in fact, an illegal format. Ther can only be one partition that is bootable. We need that one to be ELKS. As the "b" option was for "toggle" we can now switch off any unwanted boot flags. In this case we need to "toggle" partition 1 like so :-

Command:b

Toggle bootable flag:

Which partition to toggle(1-4): 1

And then the "p" command will show that all is now find with the partition table :-

Command:p

                      START                  END
Device    Boot  Head Sector Cylinder   Head Sector Cylinder  Type  Sector count
/dev/bda1         1    1      0         14   63      151       6        143577
/dev/bda2  *      0    1    152         14   63      195      80         41580
Command:

Finally, before the EDE installation can be completed, we need to write away our newly created partition table. Simply enter "w" at the Command prompt like so :-

START                  END
Device    Boot  Head Sector Cylinder   Head Sector Cylinder  Type  Sector count
/dev/bda1         1    1      0         14   63      151       6        143577
/dev/bda2  *      0    1    152         14   63      195      80         41580
Command:w

Successfully wrote 512 bytes to /dev/bda
Command:

The message informs us that the write has been successful. Now enter "q" at the command prompt to exit fdisk and complete the installation of EDE :-

		      START                  END
Device    Boot  Head Sector Cylinder   Head Sector Cylinder  Type  Sector count
/dev/bda1         1    1      0         14   63      151       6        143577
/dev/bda2  *      0    1    152         14   63      195      80         41580
Command:q

--------------------------------------------------------------------------------------------------

3.4 Completion of Installation
------------------------------

You will see a screen similar to the following :-



THE
########## ####       #### ####     #####
 ##     ##  ##         ##   #      ##   ##
 ##      #  ##         ##  #      #      #
 ##         ##         ## #       ##
 ##   #     ##         ####        ##
 ######     ##         #####         ###
 ##  ##     ##         ## ##           ##
 ##   #     ##         ##  ##           ##
 ##      #  ##      #  ##   ##    #      #
 ##     ##  ##     ##  ##    ##   ##    ##
########## ########## ####  ####  # ####   DISTRIBUTION EDITION


                      *****************************************
                      * Distribution Edition Version :  0.0.6 *
                      * Kernel Version               :  0.1.1 *
                      * ELKSCMD Version              : 010502 *
                      *****************************************

                      !                                !
                       ######

The "#" symbols will progress across the screen to show the installation is progressing. When the installation is complete the following screen will be displayed :-


THE
########## ####       #### ####     #####
 ##     ##  ##         ##   #      ##   ##
 ##      #  ##         ##  #      #      #
 ##         ##         ## #       ##
 ##   #     ##         ####        ##
 ######     ##         #####         ###
 ##  ##     ##         ## ##           ##
 ##   #     ##         ##  ##           ##
 ##      #  ##      #  ##   ##    #      #
 ##     ##  ##     ##  ##    ##   ##    ##
########## ########## ####  ####  # ####   DISTRIBUTION EDITION


                      *****************************************
                      * Distribution Edition Version :  0.0.6 *
                      * Kernel Version               :  0.1.1 *
                      * ELKSCMD Version              : 010502 *
                      *****************************************

                           Installation is complete
              Thankyou for Installing the Elks Distribution Edition
             Please remove any floppy disks and hit return to reboot.

As instructed, remove the floppy disk from the drive. If you wish to install packages then go to the package installation section of this guide (section 3.4). Otherwise hit return to reboot and you new EDE - ELKS system will boot from the hard drive. You will, first, see the prompt similar to the following :-

BootKit 0.8.0
Select Operating System to Boot
===============================
dos
elks

boot>

If you have multiple operating systems installed on your system it will look something like this. If your system is ELKS only then theb BootKit will list ELKS only. Type "elks" at the bootkit prompt to start up ELKS. Following the boot procedure you will see the EDE login screen as follows :-

THE
########## ####       #### ####     #####
 ##     ##  ##         ##   #      ##   ##
 ##      #  ##         ##  #      #      #
 ##         ##         ## #       ##
 ##   #     ##         ####        ##
 ######     ##         #####         ###
 ##  ##     ##         ## ##           ##
 ##   #     ##         ##  ##           ##
 ##      #  ##      #  ##   ##    #      #
 ##     ##  ##     ##  ##    ##   ##    ##
########## ########## ####  ####  # ####   DISTRIBUTION EDITION
---------------------------------------------------------------
EDE : 0.0.6  Kernel : 0.1.1 Candidate, elkscmd : 01052002.
---------------------------------------------------------------
login:

You can now log in and use your new ELKS system.

--------------------------------------------------------------------------------------------------










