
Welcome to the ZipSlack(tm) 11.0 UMSDOS Linux installation.

This is a great way to install an up-to-date Slackware Linux system on a DOS
partition.  It'll use about 170 megabytes of drive space, which means you can
install this on a (larger than 100MB) Zip disk.  (more space will be used if
your drive uses large clusters, i.e. a one or more gigabyte pre-FAT32 DOS
partition)  And, it can also be installed to any FAT partition (including
FAT32) as a quick and easy way to get a base Linux system up and running
without having to repartition a hard drive.  However, to make it truly useful,
you might need to add additional libraries and packages from Slackware once
you are up and running.

This system includes:

2.4.33.3 Linux kernel, with support for many SCSI controllers.
Includes parallel port Zip support.

An easy to configure PPP setup script (pppsetup), network setup script
(netconfig), and a nice collection of network applications like mailx,
links, ssh, and more.

Slackware 'pkgtool', 'installpkg', 'rpm2targz', and other tools to let you
customize the system and add additional software that the ZipSlack
installation doesn't add by default for space considerations (like X).

Extra applications and utilities, such as:
   -- bash shell.
   -- A large set of kernel modules
   -- Midnight Commander file manager
   -- "Links" text based web browser
   -- Many networking related tools like lftp, nmap, nc, rsync, ssh,
      traceroute, wget, and more

Here's the list of packages ZipSlack installs:

aaa_base-11.0.0-noarch-1.tgz        man-1.6c-i486-2.tgz
aaa_base-11.0.0-noarch-2.tgz        man-pages-2.39-noarch-1.tgz
aaa_elflibs-11.0.0-i486-9.tgz       mc-4.6.1-i486-2.tgz
acl-2.2.39_1-i486-1.tgz             mdadm-2.5.3-i486-1.tgz
acpid-1.0.4-i486-2.tgz              minicom-2.1-i486-2.tgz
apmd-3.0.2-i386-1.tgz               mkinitrd-1.0.1-i486-3.tgz
attr-2.4.32_1-i486-1.tgz            module-init-tools-3.2.2-i486-2.tgz
bash-3.1.017-i486-1.tgz             mpg321-0.2.10-i486-2.tgz
bc-1.06-i486-3.tgz                  nc-1.10-i386-1.tgz
bin-11.0-i486-3.tgz                 ncftp-3.2.0-i486-2.tgz
bsd-games-2.13-i486-8.tgz           netpipes-4.2-i386-1.tgz
bzip2-1.0.3-i486-3.tgz              netwatch-1.0a-i386-1.tgz
cdparanoia-IIIalpha9.8-i486-2.tgz   nfs-utils-1.0.10-i486-3.tgz
cdrdao-1.2.1-i486-1.tgz             nmap-4.11-i486-1.tgz
cdrtools-2.01-i486-1.tgz            openssh-4.4p1-i486-1.tgz
coreutils-5.97-i486-1.tgz           openssl-solibs-0.9.8d-i486-2.tgz
cpio-2.5-i386-1.tgz                 pciutils-2.2.3-i486-2.tgz
cxxlibs-6.0.3-i486-1_zipslack.tgz   pcmcia-cs-3.2.8-i486-3.tgz
dcron-2.3.3-i486-5.tgz              pcmciautils-014-i486-2.tgz
devs-2.3.2-zipslack-2.tgz           pidentd-3.0.19-i486-1.tgz
dhcpcd-2.0.4-i486-2.tgz             pkgtools-11.0.0-i486-3.tgz
diffutils-2.8.1-i486-3.tgz          pkgtools-11.0.0-i486-4.tgz
dvd+rw-tools-6.1-i486-1.tgz         portmap-5.0-i486-2.tgz
e2fsprogs-1.38-i486-2.tgz           portmap-5.0-i486-3.tgz
elvis-2.2_0-i486-2.tgz              ppp-2.4.4-i486-1.tgz
etc-11.0-noarch-1.tgz               procps-3.2.7-i486-1.tgz
etc-5.1-noarch-13.tgz               raidtools-1.00.3-i386-1.tgz
findutils-4.2.28-i486-1.tgz         reiserfsprogs-3.6.19-i486-1.tgz
floppy-5.4-i386-3.tgz               rp-pppoe-3.8-i486-2.tgz
gawk-3.1.5-i486-3.tgz               rsync-2.6.8-i486-1.tgz
genpower-1.0.5-i486-1.tgz           screen-4.0.2-i486-1.tgz
gettext-0.15-i486-1.tgz             sed-4.1.5-i486-1.tgz
getty-ps-2.1.0b-i486-1.tgz          shadow-4.0.3-i486-13.tgz
glibc-solibs-2.3.6-i486-6.tgz       sharutils-4.6.3-i486-1.tgz
glibc-zoneinfo-2.3.6-noarch-6.tgz   slocate-3.1-i486-1.tgz
gpm-1.20.1-i486-2.tgz               smartmontools-5.36-i486-1.tgz
grep-2.5-i486-3.tgz                 sox-12.18.1-i486-1.tgz
groff-1.19.2-i486-1.tgz             sysfsutils-2.0.0-i486-2.tgz
gzip-1.3.5-i486-1.tgz               sysklogd-1.4.1-i486-9.tgz
hdparm-6.6-i486-1.tgz               syslinux-2.13-i486-1.tgz
hotplug-2004_09_23-noarch-5.tgz     sysvinit-2.84-i486-67.tgz
inetd-1.79s-i486-7.tgz              sysvinit-2.84-i486-69.tgz
infozip-5.52-i486-1.tgz             tar-1.15.1-i486-2.tgz
iptables-1.3.5-i486-2.tgz           tcpdump-3.9.4-i486-2.tgz
iptraf-2.7.0-i386-1.tgz             tcpip-0.17-i486-39.tgz
isapnptools-1.26-i386-1.tgz         tcsh-6.14.00-i486-2.tgz
jfsutils-1.1.11-i486-1.tgz          traceroute-1.4a12-i386-2.tgz
joe-3.5-i486-1.tgz                  udev-097-i486-10.tgz
kbd-1.12-i486-2.tgz                 umsdos-progs-1.13-i386-1.tgz
kernel-modules-2.4.33.3-i486-1.tgz  usbutils-0.72-i486-1.tgz
less-394-i486-1.tgz                 utempter-1.1.3-i486-1.tgz
lftp-3.5.4-i486-1.tgz               util-linux-2.12r-i486-4.tgz
lilo-22.7.1-i486-2.tgz              util-linux-2.12r-i486-5.tgz
links-2.1pre23-i486-1.tgz           wget-1.10.2-i486-2.tgz
loadlin-1.6c-i386-1.tgz             wireless-tools-28-i486-3.tgz
logrotate-3.7.4-i486-1.tgz          workbone-2.40-i386-3.tgz
lsof-4.76-i486-1.tgz                xfsprogs-2.8.10_1-i486-1.tgz
mailx-12.1-i486-1.tgz               ytalk-3.3.0-i486-1.tgz


INSTALLATION:

To install Slackware using ZipSlack, all you need to do is unzip the file
ZIPSLACK.ZIP on the DOS partition where you want Linux installed.  To do this,
you'll need an unzip utility.  If you don't already have an unzipper such as
PKZIP for DOS or Windows, http://www.pkware.com is a great place to get one.

Here's how you'd install on a Zip disk on drive D:\ -- first, fire up Windows
and start PKZIP for Windows.  

Then, from the "File" menu, select the "Open..." option.  In the dialog box,
browse for and select the file ZIPSLACK.ZIP.

If you're planning to put this on a Zip disk, make sure it's in your machine,
formatted, and ready to go. 

Next, you need to extract the files to a DOS partition.  From the "Extract" 
menu, select the "Extract Files..." choice.  In the "Extract" box, make sure
the "all files" choice is selected.  In the "Extract to:" box, make sure the
"Disk" choice is selected.  In the text box next to "Disk", you'll need to
fill in the path to where you want to extract the files.  (They'll be extracted
into a \linux subdirectory)  For example, if your drive is D:\ and that's
where you want to install, then you'll want to put D:\ in the box.  Otherwise,
fill in any DOS drive with enough free space to install.  When you've got
everything filled in correctly, hit the "Extract" button to extract the files.

Be sure to unzip zipslack.zip at the top of whatever partition you choose 
(the \ directory in DOS/Windows).  It will create a \LINUX directory there.
If you try to unzip it in a subdirectory or folder, it will not boot correctly.


BOOTING THE LINUX SYSTEM

There are probably countless ways to boot this system once you've unzipped it.
Here, I'll cover two.

Loadlin
-------

Loadlin is a DOS program designed to load the Linux kernel and boot it.  In the
\linux directory, you'll find these files:

LOADLIN.EXE:  The loadlin loader executable.
LINUX.BAT:    A simple DOS batch file to boot Linux using LOADLIN.EXE.
vmlinuz:      A Linux kernel with support for SCSI and IDE devices.

You can use the provided vmlinuz kernel (a generic kernel with support for many
devices that will work for most machines), or you can use another Linux kernel
of your choosing by copying it to \linux\vmlinuz over the existing file.
Slackware includes a large collection of precompiled kernels in its \kernels
directory, any of which will work.

To boot the system, you'll need to edit the LINUX.BAT file, and make sure the
root=/dev/XXXX statement on the loadlin line (the one that's not commented out
with 'rem') is set up to use the partition where you unzipped ZIPSLACK.ZIP, 
such as /dev/sda4.  If you're not sure which partition to use, just go ahead
and guess.  If you get it wrong, you'll still be able to use scrollback
(right shift key and PageUp) when the kernel halts to go back and look at your
partitions, noting the names Linux gives them.  With this information, you
should be able to edit the LINUX.BAT correctly.

Once LINUX.BAT is edited, you can try to boot the system by entering LINUX on
a prompt while in the \linux directory.  IMPORTANT:  You'll need to be in 
DOS mode for the boot to work.  A DOS prompt running under Windows9x will not
work!  What you need to do if you use Windows9x is shut the machine down,
selecting the "Restart in MS-DOS mode" selection.  Then, you'll be able to use
Loadlin.  I've also had great success booting with a "Startup disk" made from
Win95 (Add/Remove Programs in Control Panel, and then "Startup disk" tab) and
then switching into the \linux directory on the target drive and running 
LINUX.BAT.

If it doesn't work, the problem could be DOS memory management -- I had to run
both HIMEM.SYS and EMM386.EXE to get LOADLIN to load a large kernel, but it
also worked fine with no memory management.  I ran into problems when I tried
to run _just_ HIMEM.SYS.

You can also run LOADLIN directly.  Here is a sample boot command to boot Linux
on /dev/sda4 in read-write mode using the kernel file vmlinuz:

loadlin vmlinuz root=/dev/sda4 rw

Using a boot floppy
-------------------

The other way you can boot the system is by using a boot floppy.  There's
one provided (bootdisk.img) that uses the generic kernel, or you can use any
of the bootdisks included with Slackware.  

To write the image to a floppy disk, use the RAWRITE.EXE program:

rawrite bootdisk.img a:

Or, if you are already running Linux, use this sort of command:

cat bootdisk.img > /dev/fd0

To boot a Linux system in read-write mode on /dev/sda4, boot the bootdisk.  On
the 'boot:' prompt, you'd enter this command:

  mount root=/dev/sda4 rw


CONFIGURING THE SYSTEM

Once you've booted the system, log in as 'root'.  One of the first things you
should do is add a root password with the 'passwd' command.  Then, (if you want
some things like 'df' to work) you'll need to edit /etc/fstab to fix the entry
for your root partition.  Seasoned UNIX veterans will probably use 'vi' for
this, otherwise 'mcedit' is another option.

If you're on an ethernet connected to the Internet, you can run 'netconfig' to
configure your network access.  You may also need to edit /etc/rc.d/rc.modules
to load a kernel module that supports your ethernet card.

If you use PPP to connect to the Internet, you can configure your PPP
connection using 'pppsetup'.


COMPILING AND DEVELOPING SOFTWARE

Past versions of ZipSlack have also included development tools such as binutils,
gcc, make, and perl, but these things are now too large to include by default.
Luckily, it's still easy to add them if you have enough space to install them.
To add a complete development system you'll need to install the packages from the
Slackware D (development) and L (libraries) series using the installpkg package
utility.  For example, if you've mounted a Slackware CD on /mnt/cdrom:

cd /mnt/cdrom/slackware
installpkg d/*.tgz l/*.tgz

Note that this will add more than 300MB of software, so you'd better have the space
for it!  If you're looking to add a more modest development environment for C and
C++, you'll need at least these packages for good results:

d/binutils d/gcc d/gcc-g++ d/kernel-headers d/make l/glibc

This will require around 125MB of additional space.  

Note that the entire ZipSlack system may be extended using Slackware packages, and
you may even use installpkg to install all of them on top of a basic ZipSlack
system in order to get a fully complete Linux system with X and KDE.

==============

I hope this system makes it easier to get Linux up and running.  At around 70
megabytes (or so) most people can download this package in just a few hours.

Unfortunately, it looks as if this will be the final release of ZipSlack, as the
UMSDOS filesystem needed to run Linux on a FAT partition (directly, without the
use of a cumbersome and hard to expand image file) will not be part of future
kernels.  However, our crack team of rocket scientists are busy working
on replacement solutions.  :-)

Have fun!

---
Patrick Volkerding
volkerdi@slackware.com

