## page was renamed from mudshark.brookes.ac.uk/Meetings/Nepal2016/ScrumPyInstall
## page was renamed from mudshark.brookes.ac.uk/Meetings/Nepal2016/ScrumPyVM
= 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_20.06.16.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. 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 ==
 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.