Notes on how I installed Ubuntu Breezy Badger
as a VMware Workstation guest OS.

1. General Notes

1. The Host OS is WinXP Pro-SP2 running on a PIV 2.0 GHz Processor with 1024 Mb RAM
2. VMware Workstation Version: 5.5.0 build-18007 (RC2)
3. Menu items and labels for GUI elements will be in single quotes. (i.e.: 'Sound Driver')
4. Keyboard keys will be in square brackets. (i.e.: [Enter])
5. GUI buttons will be in French braces. (i.e.: {Install})
6. Text to be typed will be in double quotes. (i.e.: "vi ifcfg-eth0")
7. The order shown here is one that I have crafted to cleanly install Ubuntu Breezy Badger as easily as possible
8. This order is by no means the only order or method of achieving this end. Feel free to substitute or switch around as you feel like, but I won't be able to help as much as I would if you follow this guide.
9. Upgrading the kernel will "break" the VMware Tools installation. You may need to repeat section 5 and possibly perform section 6 to re-install.

2. Download the .iso image from Ubuntu

1. From http://www.ubuntulinux.org/download/ chose a mirror location to download from.
2. Select 'PC (Intel x86) install CD '
   • At the time of this writing, there are other versions of Breezy Badger available for different processors and methods of downloading.
   • While the '64-bit PC (AMD64) install CD' will run in VMware Workstation 5.5, that requires a slightly different process, and is not covered here.
3. Download the image to your hard drive.
   • At the time of this writing, Ubuntu had 1 download .iso image.

3. Create a typical guest machine

Using the New Virtual Machine Wizard, create a new virtual machine as follows:

1. From the 'Home' tab in the main VMware Workstation window, Press the 'New Virtual Machine' icon
2. Press {Next}
3. For Virtual Machine Configuration choose 'Typical' then press {Next}
4. Guest Operating System
   1. Guest OS = 'Linux'
   2. Version = 'Ubuntu'
   3.  Press {Next}
5. Name the virtual machine
   1. Choose a name
   2. Select where you want the files for this virtual machine
   3. Press {Next}
6. Network Connection
   1. Choose the network connection you want to use.
      • I choose bridged because I have a home router that supports DHCP, but see the VMware instructions for information on the other types
   2. Press {Next}
7. Disk Capacity
   1. Choose how big you want the HDD to appear to the Guest OS
      • I always set 16 GB since I don't allocate the hard drive space now
   2. Choose whether you want to allocate all the drive space now
   3. Choose whether you want to split the virtual disk into 2GB files
   4. Press {Finish}

4. Install Ubuntu

1. Set the virtual CD to the downloaded .iso file
2. Start the virtual machine
3. Click inside the Guest OS window to take control
4. Press [Enter] to install Linux
5. Choose your language and press [Enter]
6. Choose your location and press [Enter]
7. Choose your keyboard layout and press [Enter]
8. Type in a host name and press [Enter]
9. Choose to 'Erase entire disk: SCSI1 ...' and press [Enter]
10. Select 'Yes' using the arrow keys to write the changes to disk and press [Enter]
11. This will be the first of 3 long pauses while the initial unpacking and installation is carried out.
12. Select your time zone and press [Enter]
13. Type the name of a user and press [Enter]
14. Press [Enter] to accept the suggested user name
15. Type the password and press [Enter]
16. Re-type the password and press [Enter]
17. When asked to removed the installation CD:
    1. Exit out of the Guest OS by pressing [CTRL]-[ALT]
    2. In the VMware menus, select 'VM | Removable Devices | CD-ROM... | Disconnect'
    3. Re-enter the Guest OS by clicking the mouse in the terminal window
    4. Select 'Continue' using the arrow keys to reboot and press [Enter]
18. After re-booting, there will be the second of three long pauses for package installation
19. Setup screen resolutions
    1. Select the resolution '1024x768' using the arrow keys and press [Space] to deselect it
    2. Select the resolution '640x480' using the arrow keys and press [Space] to deselect it
    3. Press [Tab] to select 'Ok' and press [Enter]
20. This will be the third of three long pauses for further package installation
21. Login to Ubuntu using the user name and password previously set up.
22. If a windows pops up w/ 'New Updates Available', select {Tell me more about this later}

5. Install and setup VMware Tools

1. If you have an icon on your desktop titled 'Ubuntu 5.10 i386':
   1. Right click on the icon
   2. Select 'Eject'
2. Exit out of the Guest OS by pressing [CTRL]-[ALT]
3. In the VMware menus, select 'VM | Install VMWare Tools'
4. Press {Install}
5. Re-enter the Guest OS by clicking the mouse in the terminal window
6. Wait until Ubuntu auto-mounts the CD.
7. Start a root terminal session as follows
   1. Press [CTRL]-[ALT]-[Space] together, release the [Space] only then press [F2]
   2. Login as your user
8. Type "sudo -H -s"
9. Enter your password a second time
10. Type "cd /tmp"
11. Type "tar zxf /media/cdrom0/VMwareTools-5.5.0-18007.tar.gz"
12. Type "cd vmware-tools-distrib"
13. Type "./vmware-install.pl"
14. Accept the default answers to all the questions by pressing [Enter]
15. When asked, choose the screen resolution you want the Guest OS to run at by choosing a number next to the desired resolution
    1. Type that number
    2. Press [Enter]
       • This resolution will be the maximum resolution that Ubuntu will see as supported
       • This resolution will also be the default resolution until you change it inside of Ubuntu
16. Type "init 6" to restart the Guest OS
17. After the re-boot, login to your user
18. In the top row of menus, select 'Applications | Accessories | Terminal'
19. Type in "vmware-toolbox &" and press {OK}
20. Select the 'Options' tab in the 'VMware Tools Properties' window
21. Make sure the option for 'Time synchronization between the virtual machine and the host operating system' is selected
22. Press {Close}
23. Exit the Terminal session by typing "exit"
24. Restart the Guest OS
25. OPTIONAL: Setup a Bookmark to the shared host directories
    1. In the top row of menus, select 'Places | Computer'
    2. Select 'Bookmarks | Add Bookmark'
    3. Select 'Bookmarks | Edit Bookmarks'
    4. Select the bookmark called 'Computer'
    5. In the 'Location' field type "/mnt/hgfs"
    6. In the 'Name' Field type "Host Shares"
    7. Press {Close}

The install is now complete. Upgrading the kernel will "break" the VMware Tools installation. You may need to repeat the previous section after  performing the following section  to re-install.

6. Install kernel source code and gcc

1. Start a root terminal session as follows
   1. Press [CTRL]-[ALT]-[Space] together, release the [Space] only then press [F2]
   2. Login as your user
   3. Inspect the information that now shows under your login
   4. It will have a line that starts with the word 'Linux' followed by the name you gave when the install asked for a host name
   5. After the host name is shown the version of the Linux Kernel installed, followed by a number, then followed by the date
   6. It will look similar to '2.6.12-9-386'
   7. Write down the Linux Kernel version
   8. Press [CTRL]-[ALT]-[Space] together, release the [Space] only then press [F7] to return to the X-Window session
2. In the top row of menus, select 'System | Administration | Synaptic Package Manager'
3. Enter the password for the user when asked
4. If a Message Box pops up titled 'Warning' and refers to errors with the package list:
   1. Press {OK}
   2. Press {Close} to exit the 'Quick Introduction'
   3. From the Synaptic Package Manager menus, select 'Settings | Repositories'
   4. Press {Add}
   5. Press {OK}
   6. Press {OK}
   7. Press {Yes}
5. Press {Close} to exit the 'Quick Introduction'
6. Press {Search}
7. Search for "linux-headers"
8. Select 'linux-headers-u.v.w.x.-y-z', where  u,v,w,x,y and z match the kernel version that you wrote down earlier
   1. Select 'Mark for installation'
   2. If a window pops up titled 'Mark Additional Required Packages' press {Mark}
9. Press {Search}
10. Search for "gcc"
11. Select 'gcc'
    1. Select 'Mark for installation'
    2. If a window pops up titled 'Mark Additional Required Packages' press {Mark}
12. Press {Apply}
13. Press {Apply}
14. Press {Close}
15. Close the 'Synaptic Package Manager'