Tutorial: CI for the Rails Guy or Gal
README for Tutorial Resources

-------------------------
Quick Start Instructions:
-------------------------
- Get the Tutorial Resources off of a DVD, USB Flash Drive or download from 
http://thewoolleyweb.com/ci_for_the_rails_guy_or_gal
- Install VMware and get a license key from https://www.vmware.com/tryvmware/
  - For Windows, install the free VMware player, or the VMware server if you want to create new VMs
  - For Mac, install VMware Fusion
- Install a RAR uncompress utility from /tools
- Uncompress the Virtual Machine /virtual_machines/Ubuntu_With_CI_Downloads.vmwarevm.rar
- Review instructional screenshots for opening a VM copy in /presentation/screenshots/03_virtual_machine_copy
- Open the uncompressed .vmx file "Ubuntu_With_CI_Downloads.vmx" in VMware
- Start following the Presentation in /presentation/ci_for_the_rails_guy_or_gal.pdf
- ID/Password are ci/password

----------------------
Detailed Instructions:
----------------------
Source on GitHub:

- The latest version of this presentation (but no big install files or virtual machine images) is available on GitHub: 
http://github.com/thewoolleyman/ci_for_the_rails_guy_or_gal

Tutorial Resource Directory Contents:

(NOTE: DVDs or USB Flash drives distributed during the tutorial may not have the larger files which will not be used, 
such as the Ubuntu ISO image, Ubuntu_Base, or OpenOffice installation files, but these are available on the website)

- presentation: Contains presentation in OpenOffice and PDF format
  - screenshots:   
    - 01a_mac_vmware_fusion_screenshots: Screenshots of Ubuntu VM Creation on Mac VMware Fusion
    - 01b_win_vmware_server_screenshots: Screenshots of Ubuntu VM Creation on Windows VMware Server
    - 02_ubuntu_vm_setup_screenshots: Screenshots of completing Ubuntu VM installation
    - 03_virtual_machine_copy: Screenshots of copying an existing VM
- tools: Software and other useful downloads
  - font: FreeSansBold.ttf font required for OpenOffice presentation to render correctly on some platforms, like Linux.
  - open_office: OpenOffice install packages for multiple platforms
  - stuffit: RAR extract program for Mac
  - ubuntu_cd_iso: ISO image of Ubuntu Desktop 7.10
  - vmware: Install packages and URL for getting a VMWare Evaluation Key, and some recent keys that may work
  - winrar: RAR extract program for Windows
- virtual machines: Virtual Machine Images
  - Ubuntu_Base.vmwarevm.rar: Base Ubuntu Install
  - Ubuntu_With_CI_Downloads.vmwarevm.rar: Base Ubuntu with VMWare Tools and all downloads required for tutorial, but no 
  steps completed
  - Completed_CI_Tutorial.vmwarevm.rar: Completed Tutorial with all steps already performed

A. Install VMware
- The /tools/vmware directory has installation packages and a pointer to the URL to sign up for a VMware Evaluation Key. 
 VMware Player and Server are for windows, and VMWare Fusion is for Mac.  VMware Player is free, but can only play 
existing VMs, not create new ones.  Recent (2 weeks before RailsConf 2008) trial keys are in this directory, but they 
may not work.
  - For Windows, install VMware Player or Server.  For server, you will start the client app, and connect to the local 
  server.
  - For Mac, install the VMware fusion .dmg file.

B. Install VMware Image

B.1 Instructions for starting with an existing VM Image

- Install VMware for your OS from /tools/vmware/...
- Copy desired VM image from /virtual_machines to the VMware 'Virtual Machines' directory
  - Use Ubuntu_With_CI_Downloads to do all the non-download steps yourself
  - Use CI_Completed to see all steps completed
- Extract (unrar) the image using the extract tool: stuffit for mac or winrar for windows
- Open the VM using steps in presentation/screenshots/03_virtual_machine_copy


B.2 Instructions for starting from scratch

-  Download Ubuntu ISO from /tools/ubuntu_cd_iso
- Follow instructions in tutorial and/or screenshots in /presentation/screenshots/01...

C. Completing Tutorial

- Use the Virtual Machine and follow instructions in presentation
- ID/Password are ci/password