{
 "metadata": {
  "name": ""
 },
 "nbformat": 3,
 "nbformat_minor": 0,
 "worksheets": [
  {
   "cells": [
    {
     "cell_type": "markdown",
     "metadata": {},
     "source": [
      "# Workshops : supported technical environment\n",
      "\n",
      "Preparation of a technical environment that will be supported in Montr\u00e9al-Python's workshops.\n",
      "\n",
      "## Introduction\n",
      "\n",
      "These short instructions will able you to setup a fully functional and performant Python developer workstation on Ubuntu or Debian.\n",
      "\n",
      "We strongly recommand to have this workstation setup for all Montr\u00e9al-Python's workshop because :\n",
      "\n",
      "* the technical support in the workshops will be guaranteed for Ubuntu or Debian based Linux station\n",
      "\n",
      "If you want to have fun with the code in Montr\u00e9al-Python workshops without loosing your time with configuring your machine, offer yourself a development environment where Python is a first class citizen. Otherwise, come a bit earlier at the workshop, we'll help you set it up. It's simple. It's powerful.\n",
      "\n",
      "Prerequiste\n",
      "\n",
      "* None\n",
      "\n",
      "Objectives\n",
      "\n",
      "* Install VirtualBox on your machine\n",
      "* Install Ubuntu in VirtualBox\n",
      "\n",
      "## VirtualBox\n",
      "\n",
      "You're on Mac OS X or Windows? You don't already have a Linux distribution as a developer workstation? You can install one on your computer without interferring with your normal operating system. To do this, you'll install a virtual machine managed by Oracle VM VirtualBox software.\n",
      "\n",
      "1. Download the appropriate version of Virtualbox according to your operating system [approx. 100 Mb] : <br />\n",
      "[https://www.virtualbox.org/wiki/Downloads](https://www.virtualbox.org/wiki/Downloads)<br />\n",
      "(see \"VirtualBox platform packages\" bullet ; Windows host or OS X host for Mac)\n",
      "\n",
      "1. Install VirtualBox\n",
      "\n",
      "## Ubuntu\n",
      "\n",
      "Ubuntu is a Linux operating system based on Debian. Python is a first class citizen there. We prepared you a ready-to-install Ubuntu shipped with everything needed to make Python development. Let's download now these Ubuntu sources and install Ubuntu in the Virtualbox.\n",
      "\n",
      "2- Download the appropriate Ubuntu image at the following url: [http://montrealpython.org/data/Montreal-Python-32bit-Ubuntu-12_04.ova](http://montrealpython.org/data/Montreal-Python-32bit-Ubuntu-12_04.ova) [1,7 Go]\n",
      "\n",
      "* 32bit or 64bit? to verify on Windows : si the machine's properties (right-clic on My Computer icon, Properties)\n",
      "* 32bit or 64bit? to verify on Mac : apple key, then \"about this mac\"\n",
      "\n",
      "3- Open VirtualBox\n",
      "\n",
      "4- Clic on File -> Import appliance<br />\n",
      "\n",
      "* Follow the import wizard and choose the .ova file you've just downloaded before.\n",
      "* If needed, reduce the RAM allocated to the virtual machine. It's 1 Gb now, if it's too much, reduce to 768 Mb or 512 Mb. Minimum of 512 Mb recommended.\n",
      "\n",
      "5- Once Ubuntu is imported, on VirtualBox main screen, double-clic on the machine in the left pannel\n",
      "\n",
      "6- The user is `montreal-python`... the password is `montreal-python` as well\n",
      "\n",
      "Instructions to import the image with printscreens are available here : [http://docs.oracle.com/cd/E26217_01/E26796/html/qs-import-vm.html](http://docs.oracle.com/cd/E26217_01/E26796/html/qs-import-vm.html)\n",
      "\n",
      "## Conclusion\n",
      "\n",
      "You're now in your Python developer workstation, a Ubuntu that Montr\u00e9al-Python prepared for you. For your info, it's only a Ubuntu out-of-the-box with these extra Debian packages installed :\n",
      "\n",
      "* build-essential\n",
      "* python-dev\n",
      "* python-virtualenv\n",
      "* ipython\n",
      "* ipython-notebook\n",
      "* git\n",
      "* gitk\n",
      "\n",
      "You're now ready to code!"
     ]
    }
   ],
   "metadata": {}
  }
 ]
}