Setup Instructions

To participate in a Software Carpentry workshop, you will need working copies of the software described below. Please make sure to install everything (or at least to download the installers) before the start of your workshop.

If you do not have an account on the Open Science Grid, please sign up, either in advance of the course or first thing in the morning. It takes 5-10 minutes to complete the sign up process and about 30 minutes to get your account activated.

Overview

Editor

Make sure you install, or have available, a text editor that you are comfortable with using. Since we will be using a remote shell for writing batch jobs, we encourage using an editor such as nano, emacs or vi.

The Bash Shell

Bash is a commonly-used shell. Using a shell gives you more power to do more tasks more quickly with your computer.

Git

Git is a state-of-the-art version control system. It lets you track who made changes to what when and has options for easily updating a shared or public version of your code on github.com.

Python

Python is becoming very popular in scientific computing, and it's a great language for teaching general programming concepts due to its easy-to-read syntax. We teach with Python version 2.7, since it is still the most widely used. Installing all the scientific packages for Python individually can be a bit difficult, so we recommend an all-in-one installer.

Secure Shell & Secure Copy

ssh (secure shell) is an encrypted remote login tool. It lets you connect to remote resources, such as the OSG Connect login node and interact with the machine via UNIX shell. Similarly, scp (secure copy) is a tool that facilitates encrypted file transfer. We will use both to interact with OSG Connect.

Setup for Windows

Editor

nano is the editor installed by the Software Carpentry Installer, it is a basic editor integrated into the lesson material.

Git Bash

Install Git for Windows by download and running the installer. This will provide you with both Git and Bash in the Git Bash program.

Software Carpentry Installer

This installer requires an active internet connection

After installing Python and Git Bash:

  • Download the installer.
  • If the file opens directly in the browser select File→Save Page As to download it to your computer.
  • Double click on the file to run it.

Python

  • Download and install Anaconda.
  • Use all of the defaults for installation except make sure to check Make Anaconda the default Python.

Setup for Mac OS X

Editor

If you are unfamiliar with UNIX text editors we recommend nano, which should be preinstalled.

Bash

The default shell in all versions of Mac OS X is bash, so no need to install anything. You access bash from the Terminal (found in /Applications/Utilities). You may want to keep Terminal in your dock for this workshop.

Git

Install Git for Mac by downloading and running the installer. For older versions of OS X (10.5-10.7) use the most recent available installer available here. Use the Leopard installer for 10.5 and the Snow Leopard installer for 10.6-10.7.

Python

  • Download and install Anaconda.
  • Use all of the defaults for installation except make sure to check Make Anaconda the default Python.

Secure Shell

ssh, scp

Setup for Linux

Editor

Editors such as nano and vim are usually preinstalled. If you are unfamiliar with these, choose nano.

Bash

The default shell is usually bash, but if your machine is set up differently you can run it by opening a terminal and typing bash. There is no need to install anything.

Git

If Git is not already available on your machine you can try to install it via your distro's package manager (e.g. apt-get or yum).

Secure Shell

ssh, scp, rsync

Python

We recommend the all-in-one scientific Python installer Anaconda. (Installation requires using the shell and if you aren't comfortable doing the installation yourself just download the installer and we'll help you at the workshop.)

  1. Download the installer that matches your operating system and save it in your home folder.
  2. Open a terminal window.
  3. Type
    bash Anaconda-
    and then press tab. The name of the file you just downloaded should appear.
  4. Press enter. You will follow the text-only prompts. When there is a colon at the bottom of the screen press the down arrow to move down through the text. Type yes and press enter to approve the license. Press enter to approve the default location for the files. Type yes and press enter to prepend Anaconda to your PATH (this makes the Anaconda distribution the default Python).

Setup using a virtual machine

As an alternative, you can use a virtual machine (VM) rather than installing all the software above. To use a VM:

  1. Install VirtualBox.
  2. Download our VM image. Warning: this file is 2.4 GByte, so please download it before coming to your workshop.
  3. Load the VM into VirtualBox by selecting "Import Appliance" and loading the .ova file.

Check your setup

To check your account on OSG using web shell:

  • Once you finished your Sign Up, the account activation may take about 30 minutes.
  • open WebShell
  • type in your username and password as prompted
  • if everthing is fine you will land on your home directory

To check that you have the correct version of Python:

  • Download swc-installation-test-1.py
  • Open up a bash shell
  • Change into the directory where you put the script
  • Run the script:
    python swc-installation-test-1.py

To check that you have the necessary software and tools:

  • Download swc-installation-test-2.py
  • Open up a bash shell
  • Change into the directory where you put the script
  • Run the script:
    python swc-installation-test-2.py