Deos BSP Kit Hack

From DDCIDeos
Revision as of 22:16, 22 August 2009 by Mdiethelm@ddci.com (talk | contribs) (We are done, so remove status and describe steps needed to test and ship.)
Jump to navigationJump to search

Overview

This How To is a temporary hack. It describes how to rig and ship a copy of Windows XP, and compatible Deos build tools into a virtual machine that can be booted within Sun's free VirtualBox virtualization engine. Essentially, it encapsulates a development environment used by DDC-I internal Deos maintainers, as such an environment is the closest thing we have to a Deos Board Support Package Kit. The results can be provided to customers until a more capable, OpenArbor-centric BSP Kit comes along.

Preconditions

  • Sun's Virtual Box software has been installed on the machine that will be used to create the BSP Kit Hack.
  • You have a Windows XP Professional installation disk mounted in the CDROM drive.
  • You have a Microsoft Windows XP product key.

Install XP in Virtual Box

  1. Launch Virtual Box, and skip the registration page if asked.
  2. Press the "New" button (Ctrl+N)
  3. On "Create New Virtual Machine" dialog, press next.
  4. On the VM Name and OS Type Dialog:
    1. Name: "DDC-I_Deos_BSP_Kit"
    2. Operating System: Microsoft Windows
    3. Version: Windows XP
    4. Press next.
  5. Accept the recommended base memory and press next.
  6. Ensure "Boot Hard Disk" is checked, and the "Create new hard disk"selection is checked. Press next.
  7. The "Welcome to the Create New Virtual Disk Wizard" should appear. Press next.
    1. Choose "Dynamically expanding storage," and press next.
    2. The virtual machine name chosen above should appear in the name field.
    3. Set the disk size to 4.50 GB.
    4. Press next.
    5. Press the finish button.
  8. Look over the resulting summary. If all matches the steps above, press finish. If the settings look wrong, time to go back and do it again.
  9. Ensure "DDC-I_Deos_BSP_Kit" is selected.
    1. Click on "CD/DVD-ROM"
    2. Check "Mount CD/DVD Drive."
    3. Ensure drive containing XP installation disk is selected in "Host CD/DVD Drive."
    4. Press OK.
  10. Press Start. The virtual machine will launch and launch the Windows setup program.
    1. After Windows startup finishes, er, starting up, press Enter to continue.
    2. Press F8
    3. Press Enter to install into unpartitioned space.
    4. Format the partition as NTFS.
    5. After pressing Enter, Windows setup will copy files, reboot, and copy more files. Go have a nap.
    6. Select Next on Regional and Language Options dialog.
    7. On the Personalize Your Software dialog:
      1. Name: DeosBSP
      2. Organization: DDC-I BSP Maintainer
      3. Press Next.
    8. Enter the Windows XP Product Key, and press Next.
    9. On the Computer Name and Administrator Password dialog:
      1. Computer name: DeosBSP
      2. Leave the Administrator password and confirm password fields blank
      3. Press Next.
    10. Set Time zone to Phoenix (or whatever), and press Next.
    11. On Network Settings dialog, choose "Typical settings."
    12. Accept WORKGROUP as the default workgroup name, and press Next (or Finish, or OK, or whatever it says).
    13. More boring install and setup, followed by a final reboot into Windows XP.
    14. On the Welcome to Windows XP wizard:
      1. Press Next
      2. Turn on Automatic Updates, and press Next.
      3. Yes, this computer will connect through a local area network, press Next.
      4. Yes, activate Windows over the Internet now, press Next.
      5. No, do not register with Microsoft at this time, press Next.
      6. For Your Name: BSP
      7. Press Next, then Finish.
    15. Allow Automatic Updates to install
    16. From Virtual Box menu, choose Devices, Install Guest Additions.
      1. Accept all defaults, and let it install.
      2. Take the reboot
    17. After reboot, shutdown the Windows XP VM.
  11. From Virtual Box, ensure "DDC-I_Deos_BSP_Kit" is selected, and click on CD/DVD-ROM
    1. Uncheck "Mount CD/DVD Drive."
    2. Click OK.
  12. Restart the VM. We now need to remove some applications to save space and install some third party ones.
    1. Click Start, Control Panel, Security Center
      1. Turn Firewall Off
      2. Turn Automatic Updates Off
      3. Set Virus Protection to Not Monitored
      4. Close the dialog
    2. Back in Control Panel, choose Add Remove Programs
      1. Choose Add/Remove Windows Components
      2. Deselect Accessories and Utilities
      3. Deselect MSN Explorer
      4. Deselect Networking Services
      5. Deselect Outlook Express
      6. Deselect Windows Media Player
      7. Deselect Windows Messenger
      8. Press Next, then Finish
    3. Select Yes to restart
  13. Back inside the Windows XP VM:
    1. Use Internet Explorer to go to mozilla.com and download Firefox
    2. Install Firefox and set as default browser. Whew!
    3. Shut down the Windows XP VM

Install Deos Cygwin

We are now ready to install Deos Cygwin into the Windows XP VM, but first, you may want to make a copy of your VirtualBox directory. This will enable you to backtrack if needed. 

$ cp -R VirtualBox VirtualBox_XP_Install_Snapshot

If not already, launch VirtualBox, boot back into the Windows XP VM, and:

  • Install Cygwin into the XP VM via the DESK How To. Note: Do not install VMWare Player!
  • Maintainers usually need the latest packages, so update the Cygwin installation with experimental packages per the Deos Software Release How To. Don't forget the maintainer-tools package, and do not install VMware Player!. Also, do not install any Honeywell BSPs such as CMU-MKII, etc.
  • The Deos Integration Tool requires the Microsoft DLL MSVCR71.dll, so you'll need to get that from somewhere, perhaps an existing XP machine. Copy it to C:\WINDOWS\system32.
  • Using Control Panel, set the DDCIFLEX_LICENSE_FILE to point to C:\all_prods.lic. You can then copy a license file there for testing. It will be removed later before you ship of course, but the environment variable can remain and will be mentioned in the User's Guide.

Install Deos BSP Files

  • From the DESK Console within the Windows XP VM, checkout Deos BSP sources.
$ mkdir Deos && cd Deos
$ svn co https://deos.ddci.com/scm/Deos/products/bsp/ep8280/branches/mainline/ ep8280
$ svn co https://deos.ddci.com/scm/Deos/products/bsp/MacMini-ppc/branches/mainline/ MacMini-ppc
$ svn co https://deos.ddci.com/scm/Deos/products/bsp/fitpc-1/branches/mainline/ fitpc-1
$ svn co https://deos.ddci.com/scm/Deos/products/network/network-drivers/Lance-PNP/branches/mainline/ Lance-PNP
$ svn co https://deos.ddci.com/scm/Deos/products/network/network-drivers/etsec/branches/mainline/ etsec
  • Not all bootstrap scripts were captured into SCM with execute privilege. So, you'll need to fix that in order to be able to execute them.
$ cd Deos
$ chmod  755 `find . -type f -name "bootstrap"`

Cleanup

Some files we don't want to make it into customer's hands, either because they contain IP we don't want to share, or may contain references or links back to our servers.

  • Delete the Cygwin setup.exe program.
  • Remove Flexnet license keys if you installed them.
  • Remove any VPN settings you may have needed.
  • Flush Firefox caches and history.
  • Make really clean to erase your tracks, leaving sources for the customer's benefit.
  • Delete ~/.subversion to ensure customers can't check out from our repository.
cd ~
rm -fr .subversion
  • Delete .svn directories.
# From each BSP source directory...
$ rm -fr `find . -type d -name ".svn"`

Prepare To Ship

  • Create an MD5 checksum of the VirtualBox image file, similar to shown in this example.
$ md5 DDC-I_Deos_BSP_Kit.vdi > DDC-I_Deos_BSP_Kit.vdi.md5sum.txt
  • Create a subdirectory under smb://RAIDBOX/Deos/DDC-I_Deos_BSP_Kit_Hack of the form DDC-I_Deos_BSP_Kit_<YYYYMMDD>_<version>.
  • Copy the virtualbox image, md5 checksum file, and the User Guide in PDF form to the freshly created subdirectory.
  • Send an email asking someone independent from yourself to test your work by proof reading the User Guide and following its instructions. Preferably this would be someone using a workstation similar to what will be used by the customer, e.g. a Windows XP box.

Ship It

  • Send an email to QA (Stephen Hunter) asking them to copy the folder created above to the "Ship" area. Include in the email a test report, e.g. a statement describing what the independent test results were.
  • Whomever does the actual media creation and ship should also include a physical copy of the Windows XP license used to do the XP install earlier in this How To.
Retrieved from "https://ddci.zapto.org/ddciWiki/index.php?title=Deos_BSP_Kit_Hack&oldid=966"