|
Size: 5200
Comment:
|
Size: 5044
Comment:
|
| Deletions are marked like this. | Additions are marked like this. |
| Line 2: | Line 2: |
| 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 reccomende | 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. |
| Line 5: | Line 5: |
| 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/Nottingham2022/debiain10vm%20Clone.ova|here]]which contains a complete debian operating system with !ScrumPy pre-intalled. | === (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/Nottingham2022/debiain10vm%20Clone.ova|here]] which contains a complete debian operating system with !ScrumPy pre-intalled. This is a large (8GB) 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. The guest operating system can now be launched by clicking on the appropiate icon |
| Line 7: | Line 8: |
| 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. | |
| Line 8: | Line 10: |
| === Detailed Instructions === 1. Copy the ova file from the USB drive provided onto your computer or [[https://mudsharkstatic.brookes.ac.uk/Nottingham2022/debiain10vm%20Clone.ova|download]] it as described above. |
|
| Line 9: | Line 13: |
== Native Installation: == . If you are running a Linux operating system, ( CHECK CURRENTLY SUPPORTED) [[http://Gitlab|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 XX GB 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. Start VirtualBox on your computer. Select ''Import appliance'' from the ''File'' menu and choose the ScrumPy.ova file. Wait several minutes whilst this configures. |
| Line 39: | Line 26: |
| 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. 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. |
| Line 41: | Line 28: |
| 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. '''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. |
| Line 43: | Line 30: |
| 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. 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. |
| Line 47: | Line 34: |
| 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. | 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. |
| Line 49: | Line 36: |
| ==== Changing Passwords ==== Instructions to follow. |
=== (Option 2) === An alternative to installing the ova file is to install either debian (>=10) or Ubuntu (>= 20.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, ( CHECK CURRENTLY SUPPORTED) [[http://Gitlab|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]]. |
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 Here: https://www.virtualbox.org/ . Having done that you can then download the virtual image file here which contains a complete debian operating system with ScrumPy pre-intalled. This is a large (8GB) 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. The guest operating system can now be launched by clicking on the appropiate icon
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.
Detailed Instructions
Copy the ova file from the USB drive provided onto your computer or download it as described above.
Start VirtualBox on your computer. Select Import appliance from the File menu and choose the ScrumPy.ova file. Wait several minutes whilst this configures.
ScrumPy will appear on the VirtualBox Manager window.
Important - adjust the amount of memory allocated to the virtual machine:
- Highlight the new virtual machine in the virtual box window
- Click the "settings" button.
- Click the "system" button in the window which now appears.
On the "motherboard" tab adjust the "Base memory" slider to the maximum recommended amount ie keep it in the green zone.
- 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.
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.
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.
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.
(Option 2)
An alternative to installing the ova file is to install either debian (>=10) or Ubuntu (>= 20.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, ( CHECK CURRENTLY SUPPORTED) 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 Getting started.
Getting Started
**TODO** setting screen resolution in the virtual machine.
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.
- Create a directory for your models.
Type "ScrumPy", and it will start. Continue to the practical instructions for what to do next.
- 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.