RollYourOwnVMWareImage

Creating Your Own "Official" HBMobile Development Image

This is a brief overview of how to build your own "Official" HBMobile Development Image.

Install the VMWare Server software

If you haven't done so already, visit the the VMWare Download site and retrieve the installer for the VMWare Server. Please note that you're expected to agree to a EULA and request a license string before the software will run (though there's no fee associated with this license.)

Download the Xubuntu 7.10 Gutsy Gibbon Linux Install Disk

You're free to choose a completely different distribution if you want, but I've turned into quite the Debian/Ubuntu fan lately, so the instructions here will apply to those who like (X)Ubuntu. I'm using Xubuntu because it seems slightly "zippier" than the full Ubuntu distro on virtualized hardware. You can download an ISO image from the Xubuntu download page.

Start the VMWare Server and Create a New Image

1. After launching the VMWare Server, you'll be asked what VMWare host you want to be connected to. select LocalHost.
2. Start the VM creation process by selecting the File >> New >> Virtual Machine... menu item.
3. When queried whether to use a "Typical" or "Custom" VM configuration, select Custom.
4. When queried which class of Guest Operating System you'll be installing, select Linux from the radio button selection and Other Linux 2.6.x kernel from the drop down selection list.
5. Choose a meaningful name. I name my images like: XUnnn_HBMOBILEyyy where nnn is the version of Xubuntu and yyy is the version of the image I'm working with.
6. The new VM wizard will ask if you wish to "Make this virtual machine private." I usually select the default, which is to make it private.
7. It will also ask which user to run the VM as. I choose the default, User that powers on the Virtual Machine.
8. I don't have two processors in my laptop, but I imagine it would be nice to utilize them both if the VM migrated to a machine that did, so when the wizard asks the number of virtual processors, I select Two.
9. You are free to give the VM as much memory as you think it needs. I generally select 256Mb when creating the images.
10. I have encountered minor problems when using bridged networking, so I usually select network address translation (NAT).
11. For an I/O Adapter Type, I select a LSI Logic SCSI type.
12. Next, I tell the wizard I want to Create a new virtual disk.
13. The disk should be a SCSI (Recommended) type.
14. I usually select the default size, which is 8.0 Gb on my machine. But most importantly, uncheck the Allocate all disk space now check-box. Otherwise, the virtual disk it creates will be difficult to compress.
15. I like to name the Disk file the same name as the virtual machine and place it in the same folder with the VM.

Mount and Install Linux from the Xubuntu Disk Image

1. Open the Virtual Machine Settings dialog box with the VM >> Settings... menu item.
2. Highlight the CD-ROM (IDE 1:0) device in the device list on the Hardware tab.
3. Select the "Use ISO Image" radio button in the Connection section of the dialog.
4. Enter the path to Xubuntu ISO image you downloaded earlier or click the browse button and select it with the file chooser.
5. Click OK
6. In the main VMWare Server Console, click the green "Start" button. It may take several minutes, but the Xubuntu LiveCD / Install desktop should come up.
7. On the left side of the screen is a column of icons. Double-click the "Install" icon at the bottom.
8. Xubuntu can be configured with several languages and keyboard settings. The options I chose were:

   • English Language Install
   • In a time zone near Los Angeles
   • US English / US English keyboard layout
   • Do a Guided partitioning on SCSI (0,0,0)
   • Do not import existing user accounts

9. When the wizard asks for information about me, I enter:

   • What is your name? Homebrew Mobile Phone Developer
   • What name do you want to use to log in? mobo
   • Choose a password... hbmobile
   • name of this computer? sheriff-mobo

10. Hit the "Install" button on the "Ready to Install" dialog. At this point, the disk will spin and the lights will blink and in about 20 minutes (depending on how beefy your host system is) the install will be complete.
11. When the install completes, you'll see a dialog box asking you to "Continue Using the Live CD" or "Restart Now". Unmount the Xubuntu Install Disk before restarting the virtual machine. You do this by going back to the settings dialog box at the "VM >> Settings..." menu item, clicking on the CD-ROM device and selecting the "Use physical drive" radio button to the right of the device list. (If you find that your mouse is trapped inside the virtual machine, hit the Control and Alt keys simultaneously, this will allow the mouse pointer to escape the virtual Xubuntu desktop.

Login and Configure the mobo Account

1. After rebooting, you should see a standard Xubuntu login panel. Login with the username "mobo" and the password "hbmobile".
2. Open a terminal window by selecting the clicking on the "Applications" button in the upper left corner of the virtual screen, dragging down to "Accessories", and then over and down to the "Terminal" menu item.
3. From the command line, issue these commands:

   mkdir Projects
cd Desktop
wget http://hbmobile.org/mobo.html
cd ..
sudo apt-get install build-essential libncurses5-dev bison flex texinfo zlib1g-dev gettext libssl-dev libc6-dev make g++ gcc automake1.9 subversion libpng12-dev libjpeg62-dev libfreetype6-dev pkg-config fbset libdbus-1-dev libdbus-glib-1-2 libdbus-glib-1-dev libglib-2.0-dev
sudo ln -s /bin/zcat /bin/gzcat
sudo rm /bin/sh
sudo ln -s /bin/bash /bin/sh

   After you enter this last command, the system will ask for a password, enter the "mobo password" which is "hbmobile" (without the quotes.)
4. Continue on with these commands:

   cd Projects
svn co http://svn.gumstix.com/gumstix-buildroot/trunk gumstix-buildroot


5. Edit the Login Windows Preferences by clicking on the "Applications" button in the upper left hand corner of the screen, dragging down to "Settings" and then over and down to the "Login Window" menu item. When the Login Windows Preferences dialog box appears, click on the "Security" tab. Check the "Enable Automatic Login" checkbox and select the user "mobo" from the drop down list below the check box; then click on the Close button.
6. Start the Firefox browser by clicking on the Firefox logo in the upper left of the screen. Set the default page by clicking on the "Edit >> Preferences" menu item. In the Home Page text box, enter:

   file:///home/mobo/Desktop/mobo.html

   Then click the "Close" button.

Halt the System and Package the Virtual Machine

Now that everything is configured, you can shut down the Linux virtual machine by selecting clicking on the "Applications" button in the upper left corner of the screen and dragging down to the "Quit" menu item; then hit the "Shutdown" button. You're now ready to distribute your VMWare Image!

The VMWare web site indicates that only the .vmx and .vmdk files are required for distribution with a new virtual machine, so quit the VMWare Server Console and archive these two files.