#Develop With Passion® - Presentation Setup

##The following setup should take between 20-30 minutes to complete depending on your skill level and familiarity with unix based environments.

##The two main programs you will need to install are:

• Ruby
• Git

#Required Setup

The following is the setup that you WILL need to perform to configure all necessary prerequisites to be able to enjoy the week. If you have any questions, please do not hesitate to ask!!

##If you are running on windows - make sure that you have configured windows to show all hidden files and folders

##Get setup at Github

• Sign up for a free account at github.com. My recommendation is to use an all lowercase username.

##Install Ruby

• Unix based OS

  • Install Ruby by using rvm
  • After installing rvm open up a shell and type in: rvm install 1.9.3

• Windows based OS

  • Install the latest version of Ruby from here
  • Make sure you select the following options:
    • Add Ruby Executables to your path
    • Associate .rb and .rbw files with this Ruby installation
  • Once the install has completed, verify your installation by opening up a command prompt and typing in: ruby -v. You should see:
    • ruby 1.9.3 [version and date information]

##Install Git

• OSX

  • Install brew using the following instructions:
  • After brew is successfully installed, install git by typing the following command in a terminal window:
    • brew install git

• Unix

  • Install git using the instructions outlined here

• Windows

  1. Install the latest version of Git for windows from here
  • Configure according to the following screenshots:

  

##Setup your git ssh authentication key

1. Open up a git bash prompt
2. Enter the following command:
   ssh-keygen -t rsa -C your_email_address
   Accept the defaults for the remaining prompts (leave the passphrase blank).
3. Navigate to the folder where your ssh key was created (by default your profile folder)
4. Open the file id_rsa.pub and copy the contents to the clipboard.
5. Login to your account at github.
6. Navigate to your ssh settings
7. Click on the link: Add Another Public Key:
8. Give your key a title and paste the public key that is in your clipboard from step 4 into the Key text entry:

##Verify that your git ssh authentication works

1. Open up a git bash prompt

2. Enter the following command: ssh -v git@github.com

3. You may be prompted to cache the server identity (type yes)

4. If you have setup your ssh settings correctly the bottom part of the command output should look similar to the following:

##Clone this setup repository

1. Open up a shell (Terminal on osx, git bash on windows, or equivalent unix based shell) and type the following commands:

• cd ~/ [enter]
• mkdir camug_nov_2012 [enter]
• cd camug_nov_2012 [enter]
• git clone http://github.com/camug2012nov/setup.git [enter]

At the completion of the last command you should have a copy of this repository on your local machine.

##Update git and bash configuration details

The following steps will ensure that you have your git environment configured in the correct way for class. If you already have existing git configuration that you use on a regular basis, either make your changes manually to match the recommended settings, or create a backup of your existing configuration and restore it after the class.

Open up a shell (Terminal on osx, git bash on windows, or equivalent unix based shell) and type the following commands:

1. cd ~/camug2012nov/setup [enter]
2. ./copy_config [enter]
3. Edit the following file in your favourite editor: ~/.gitconfig
   • change the email and name settings under the [user] section. Save your changes

##Fork the presentation repository

1. Login to your account at github
2. Search for the username camug2012nov: (Username in screenshot is for example purposes only)
   
3. Click on the camug2012nov user (screenshot is for example purposes only)
   
4. Click on the code repository (screenshot is for example purposes only):
5. Click on the fork button to create your own copy of this repository
   

Checkout your local copies of the code

1. Open up a shell (Terminal on osx, git bash on windows, or equivalent unix based shell) and type the following commands:

• cd ~/camug2012nov [enter]

• git clone git@github.com:[your github user name]/code.git [enter]

  Assuming your github username is jp the command would look as follows:

  git clone git@github.com:jp/code.git [enter]