= Installing ScrumPy =
There are a number of options for installing !ScrumPy depending on your operating system and level of technical experience. By modern standards the hardware requirements, at least for this work shop, are quite modest: a 64 bit machine with approximately 16 GB of disk space and 4GB RAM should easily suffice although more is better. Instalation on a 32 bit machine is possible but not reccomended.

== 1 Using virtual box (all operating systems) ==
=== (Option 1) ===
This option is the simplest but also the most resource heavy, and uses the virtual box software to run a separate ("guest") operating system in paralel to the native ("host") operating system. To do this you must first download and install the (free) virtual box software, available [[https://www.virtualbox.org/|Here: https://www.virtualbox.org/]] . Having done that you can then download the  virtual image file  [[https://mudsharkstatic.brookes.ac.uk/Download/Ubuntu20ScrumPy3.ova|here]] which contains a complete Ubuntu operating system with !ScrumPy pre-intalled. This is a large (4.7GB) file and may take some time to download Double-clicking the link may (offer to) launch virtual box, in which case take that option and folow the interactive instructions. Otherwise launch virtual box and click on the "import" icon and select the file you have just downloaded. Once the installation process is complete, you may delete the original ova file to save disk space if you wish.

Now check the ammount of disk space allocated to your new guest machine. From virtual box, navigate to file/VirtualMediaManager and click on the line wich reads "!Ubuntu20ScrumPy3-disk001.vdi" and adjust the slider at the bottom to give you 16GB visrtual disk space.

We will also be distributing the ova files on USB sticks during the meeting as well, but if you want to use this option, please install virtual box ''before arriving. ''

The guest operating system can now be launched by clicking on the appropiate icon in  virtual box.

=== Detailed Instructions ===
 1. Copy the ova file from the USB drive provided onto your computer or   it as described above.

 1. Start VirtualBox on your computer.  Select ''Import appliance''  and choose the ova from the ''File''  menu file.  Wait several minutes whilst this  configures.

 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, you will be promted for a password for teh use "ScrumPyDemo"; the pasword  is ''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.

=== (Option 2) ===
An alternative to installing the ova file is to install either debian (>=10) or Ubuntu (>= 18.04) onto virtual box using the relevant iso files and selecting Machine/new from the menu bar. Once installed, follow the instructions for native ScrumPy instalation.

== 2 Native Installation: ==
 . If you are running a Linux operating system, [[https://mudsharkstatic.brookes.ac.uk/Download/ScrumPy.tgz|download]]  the latest version   of !ScrumPy 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.

== Getting Started ==
 1. If you are using the virtual machine, check the keyboard bindings and screen resolution and adjust if neccessary using the icons in the top tool bar.
 1. Open a terminal window.  If you are running the virtual machine, use the icon in the top tool bar

 1. Create a directory for your models.

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