This document has been written by
Dipl.-Inf. (FH) Johann N. Loefflmann
(http://www.jonelo.de, mailto:jonelo@jonelo.de)
June 30, 2007


How to install Puppy Linux on a VMware image
============================================
If you want to install the latest Puppy Linux on a VMware image
by your own, just follow the instructions.


Step 1 - Preparation
--------------------
1.1.  Download and install VMware Player on your computer
      http://www.vmware.com/products/player/

1.2.  Download and extract the LiveCD Virtual Appliance
      http://www.vmware.com/vmtn/appliances/directory/284
   
1.3.  Delete livecd.iso (it's an empty file)

1.4.  Download the Live iso image from
      http://www.puppylinux.com/cd-puppy.htm
      I have used puppy-2.16.1-seamonkey-fulldrivers.iso

1.5.  Rename the file called puppy-2.16.1-seamonkey-fulldrivers.iso
      (or whatever the name is) to livecd.iso


Step 2 - Install Puppy Linux by using the Live CD iso
-----------------------------------------------------
2.1.  Boot the Live CD by using the .vmx file and the VMware Player.
   
2.2.  During the first boot of the Live CD select your
      keyboard layout and select the X server
      I have selected german keyboard layout (because I have
      a german keyboard) and the Xvesa, because Xorg didn't work.

2.3.  Select 800x600x16 (x24 didn't work). x16 means 16-bit
      color which is 65,546 colors.

2.4.  Open the console and create a partition with
      cfdisk /dev/hda
      (New, Primary, Bootable, Write, Quit)
   
2.5.  Format the partition with
      mkfs -f ext3 /dev/hda1

2.6.  Check with the program called parted whether everything
      is ok, enter 'print' followed by 'exit'. Parameters should be
      Type: primary, File system: ext3, Flags: boot
    
2.7.  Select Menu/Setup/Puppy universal installer
      See also http://www.puppylinux.com/hard-puppy.htm

2.8.  Select internal drive "hda VMware Virtual IDE Hard Drive"

2.9.  Select Install Puppy to hda1

2.10. When you are being asked where the Puppy files are, say
      on CD

2.11. Select Normal Install (Option 2)

2.12. Wait until the Grub install dialog appears, select "Install Grub"

2.13. Accept the defaults, except at the MBR question
      Select "MBR, Install to Master Boot Record"
    
2.14. Exit the Live CD by selecting Menu -> Shutdown -> Power-off computer
      Select "Do not Save" at the last dialog.
      Wait until the VMware Player is entirely closed.


Step 3 - Configure the installed Puppy Linux
--------------------------------------------
3.1.  Edit the .vmx file
      replay
      ide1:0.present = "TRUE"    
      with
      ide1:0.present = "FALSE"

3.2.  Remove the livecd.iso file

3.3.  Start the .vmx file and select the Xserver, keyboard layout and
      the resolution/color depth again as you did it already at
      steps 2.2, 2.3 and 2.4.

3.4.  Do any configuration you like (configure the network for
      example)


Step 4 - Optimize the VMware image (optional)
---------------------------------------------
4.1   Boot Puppy Linux again and copy vmshrink from Ken Kato
      to the VMware image
      http://chitchat.at.infoseek.co.jp/vmware/vmtools.html#vmw
   
4.2   Change the permission of the file to make it executable
      chmod 755 vmshrink
     
4.3   Fill the disk with zeros, remove them again and run vmshrink
      cat /dev/zero > /fill; sync; sleep 1; sync; rm /fill; sync; vmshrink