In this second post in the “Git for the SalesLogix Developer” series, we will be taking a look at how to install and configure Git. This tutorial will give you everything you need to know if you are new to Git so you can get it all set up and ready to use. In a later post we’ll look at how to use Git, but it all starts with knowing how to get started. If you haven’t yet read my first introduction post in the series, go read it first.
Basic Git Tools
In my last post, I detailed some of the tools you’ll be using as you work with Git. To narrow that down a bit more, in this series, we will be using the following tools:
- Git Extensions (this also installs mSysGit, which is the core Git system for Windows)
- Github (we’ll be using Github for hosting our repositories or projects)
- Git Extensions for SalesLogix
There are other tools out there, but in an attempt to choose the path of least resistance for a typical SalesLogix developer, these are the tools I have chosen to use for this series (and these are the tools we use for our daily Git/development workflow at Customer FX).
Video of the Installation Process
Some times it is just easier to watch someone else do something. I have put together a video that will walk you through the entire installation process from start to finish. Take a look (note, I recorded this during a thunderstorm so there are some occasional clicks/pops in the audio I wasn’t able to edit out):
To set up Git on a workstation you will perform the following steps. If you’d like, you can jump below to watch a video of the entire installation process.
- Download and install Git Extensions (use the install labeled “complete”)
- Choose to install for All Users
- When you see the option to install mSysGit, click the button to launch the mSysGit install (see options below)
- For option titled “Adjusting your PATH environment”, choose the second option titled “Run Git from the Windows Command Prompt”
- For option titled “Choosing SSH executable”, choose to use “(Tortoise)Plink” or “PuTTY”
- Leave all other options as defaults
- If Visual Studio is installed, choose option to install Visual Studio plugin for appropriate version of Visual Studio
- For option titled “Select SSH client” choose PuTTY (plink.exe)
- Choose to install for All Users
- If you already have an SSH key pair for your account, skip to step 5, otherwise continue with step 3 to create a new SSH key pair.
- Open “Git GUI” from the “Git” program group
- Go to “Help”, then select “Show SSH Key”
- Click “Generate Key”
- Copy text (this is your public key)
- Go to your account on Github.com, click the Account link and go to the section titled “SSH Public Keys” and click “Add another public key”
- Paste in the public key and give it a name
- Open Git Extensions
- Open the Settings dialog, go to the Global Settings tab and enter your name & e-mail for “User name” and “User e-mail” (these are used for commits you make so others on the project know who made the change). Close the settings dialog.
- Go to the “Remotes” menu, then “PuTTY” then select “Generate or import key”
- In the PuTTY Key Generator dialog, select “Conversions” and “Import Key”
- Browse to your private key created in step 3 by browsing to “C:Documents and SettingsUser Name.sshid_rsa”
- Enter your passphrase for your private key
- Click “Save Public Key” and save in the .ssh folder and name it “putty_public”
- Click “Save Private Key” and save in the .ssh folder and name it “putty_private”
- If you already have a public/private key pair, copy these to “C:UsersUser Name.ssh” on Win7/Vista or to “C:Documents and SettingsUser Name.ssh” on Win2003/XP so they are available for use
- In Git Extensions, go to “Remotes”, then “PuTTY” then select “Start authentication agent” and a new icon will appear in the system tray
- Right-click the icon in the tray and select “Add key” and browse to the “putty_private.ppk” file in your .ssh folder.
- Go to the installation page for Git Extensions for SalesLogix. Click the link in step 3 to go to the install, then click the “Install” button to start the installation
- When the install wizard appears, you can configure a proxy if you need to (the installer checks for newer versions of Git Extensions for SalesLogix whenever you close the Application Architect and will use the proxy info to check for the update)
- If you’d like you can disable automatic updates
- Click “Install”
Next time we will start looking at how to actually use Git when developing in SalesLogix. For now, take some time to install and configure Git on your own machine so you’ll be ready.