= Out of Date - Come Back Soon For Latest Version of Installing ScrumPy =
There are two options for installing !ScrumPy:

== Native Installation: ==
 . If you are running a Linux operating system, ( Debian >=7.0, Ubuntu >=14.04, centos >=8) [[http://mudshark.brookes.ac.uk/ScrumPy|download the latest version]]  and refer to the installation instructions. It is also possible to install !ScrumPy on other versions of Linux, depending on your technical  knowledge - ask the instructors. Then jump to [[http://mudshark.brookes.ac.uk/Meetings/Pune2016/ScrumPyVM#GettingStarted|Getting started]].

== ScrumPy in a Virtual Machine: ==
For  all other operating systems, !ScrumPy   can be run in  a guest virtual machine on  your computer, provided you  have  about 7GB of free disk space. Note  that the virtual machine  includes a  Linux operating system so that it is  completely  stand-alone.

In order  to do this you will first need to  install !VirtualBox. For linux or mac  we recommend installing !VirtualBox  from your standard repository (aka  "App store"). Windows users can find  it on the  [[https://www.virtualbox.org/|virtualbox website]].   Install !VirtualBox,   then follow the instructions below.  If you use  Windows,  defragmenting  your disk before proceeding will improve  subsequent  performance,  though it's not essential.  Though most recent Windows PCs  will be 64 bit, older ones may have a 32 bit operating system; take  note if this is the case.

=== Instructions ===
 1. Copy the large !ScrumPy.ova file from the USB drive provided onto your computer.  It is also available for [[http://mudsharkstatic.brookes.ac.uk/Download/opt/ScrumPy_vm_Jun2018.ova|download]] from our server, but this will tale a long time and is not recommended.

 1. Start !VirtualBox on your computer.  Select ''Import appliance'' from the ''File'' menu and choose the !ScrumPy.ova file.  Wait several minutes whilst this configures.  If you are running a 32 bit Windows with !VirtualBox, then ask one of us for the 32 bit !ScrumPy.ova file.

 1. !ScrumPy will appear on the !VirtualBox Manager window.

 1. '''Important -  adjust the amount of memory allocated to the virtual machine:'''
  1. Highlight the new virtual machine in the virtual box window

  1. Click the "settings" button.

  1. Click the "system" button in the window which now appears.

  1. On the "motherboard" tab adjust the "Base memory" slider to the maximum ''recommended'' amount ie keep it in the green zone.

  1. Ideally, you should allocate at least 1GB. If you have less than this  you will need to share with a fellow student, for one of the practicals.

 1. '''Networking''' - In the same window select the "Network" button. Select the adapter 1 tab and click on the advanced button. Make sure the "Cable connected" button is ticked.

 1. If  !VirtualBox  produces an error message at this point, you need to enable   virtualisation in your machine's BIOS. Ask one of the demonstrators if   this is the case.
 1. Wait whilst Linux operating system starts up.  At the login screen, give your user name as ''scrumpy'' and password as ''scrumpy''

=== Note ===
The virtual machine comes with an ordinary root account (not sudo). The default password for this account is also ''scrumpy''.   Obviously these are extremely insecure, so having logged in for the   first time it is important that you change both these passwords,   especially if you use the machine on an institutional network.

==== Changing Passwords ====
Instructions to follow.

== Getting Started ==
**TODO** setting screen resolution in the virtual machine.

 1. Open a terminal window.  If you are running the virtual machine, click on ''Terminal'' under the ''Applications/Accessories'' menu item, or on the computer icon on the menu bar if it appears.

 1. Create a directory for your models.

 1. Type "!ScrumPy", and it will start.  Continue to the practical instructions for what to do next.

 1. If the characters appearing in the terminal window do not correspond to  the keys you are pressing, go to the system settings, select keyboard  settings and change the keyboard to match that of your computer.  The  virtual machine has been set up with a UK keyboard layout.