NCSAET2017/VMhelp - Revision history

Rhaas: /* Getting and Installing the ETK2017 Machine */

2023-01-24T01:20:37Z

‎Getting and Installing the ETK2017 Machine

Rhaas: fix syntax error

2019-06-14T14:29:47Z

fix syntax error

Rhaas: /* Getting and Installing the ETK2017 Machine */

2017-07-24T18:29:45Z

‎Getting and Installing the ETK2017 Machine

Rhaas: update VM image url

2017-07-24T18:29:22Z

update VM image url

Rhaas: /* Exchanging data between host and virtual machine */

2017-07-24T14:07:02Z

‎Exchanging data between host and virtual machine

Rhaas: add instructions from CGWAS

2017-07-24T14:05:06Z

add instructions from CGWAS

New page

Getting the virtual machine going requires two steps. First you will install the free Oracle VirtualBox software. Then you will download the ETK2017 machine image and set it up inside VirtualBox.
Downloading and Installing VirtualBox

* Linux: You can download binary packages for many Linux distributions from [https://www.virtualbox.org/wiki/Linux_Downloads]. But most Linux distributions will allow you to install VirtualBox via their package management system. For Ubuntu, for example, the required packages are virtualbox, virtualbox-dkms, and virtualbox-qt.
* Mac OS: Download the OS X VirtualBox package [http://download.virtualbox.org/virtualbox/5.1.24/VirtualBox-5.1.24-117012-OSX.dmg]. Open the package, run the installer and follow the instructions.
* Windows: Download the Windows package: [http://download.virtualbox.org/virtualbox/5.1.24/VirtualBox-5.1.24-117012-Win.exe]. Run the installer and follow the instructions.

The online user manual might be helpful for a detailed explanation of how to install and setup VirtualBox.

== Getting and Installing the ETK2017 Machine ==

Now download the ETK2017 machine: [https://drive.google.com/open?id=0B4gNfWainf-5VnJtcVVTMXV6Ums ETK2017 Virtual Machine Image]. (2 GB, expands to 8GB, requires ~2GB of RAM to run)
At the school, we will provide copies of the ETK2017 virtual machine image on USB flash storage devices. This will make it faster to install the official version.

Next, you will need to install the virtual machine (also called "appliance") inside VirtualBox. Full instructions can be found on the VirtualBox webpage. In a nutshell:

* Open the VirtualBox GUI manager
* Click on the "File/Import Appliance..." menu
* In the dialog box click on "Open Appliance" and open the download ova file
* Click on Next accepting all defaults. This will create a new virtual machine.
* (Optional) Click on the "Shared folder" panel in the in the right-hand half of the VirtualBox Manager to add a local folder to share with the virtual machine. It should be visible automatically when you (re)start the VM and will appear in the ''media'' folder on the Desktop. If not please click on the <code>MountSharedFolder.sh</code> file in the VM's Desktop.
* (Optional) assign more CPU cores and memory to the VM by clicking on the "System" setting.
* Start the appliance.
* (Optional) in the VM on its Desktop there is a file <code>ExpandDisk.sh</code>. Double click on it and it will increase the VM disk to 32GB from its current 8GB.

We recommend that you keep the original .ova file around. It will serve as your backup and can be used to restore the system should you require a full reset of the software setup.

Inside of the VM itself you will also find a directory /home/et-backup which contains a read-only copy of the school files that you can use to restore your files in case you would start from scratch.

=== Username and password ===

The user name and password are both <code>et</code> and this user can become <code>root</code> using <code>sudo<code>.

=== Exchanging data between host and virtual machine ===

* Clipboard content copied and pasted via Ctrl-C (or Command-C on OSX) and Ctrl-V is shared among host and virtual machine.
* Depending on the version of virtualbox used on the host you can use "Shared folders". To do so (if you did not already create one when setting up the virtual machine) use the "Devices/Shared Folders Settings..." menu to create one. You can make it available inside of the virtual machine it by either rebooting your virtual machine or by using the MountSharedFolders.sh script that you can find on the Desktop of your virtual machine. The shared folder will appear in the media folder on the Desktop.
* The virtual machine is reachable via ssh (and scp) by doing ssh -p 2222 et@127.0.0.1 and using the password <code>et</code>. OSX and Linux usually include an ssh client in their default installation, for Windows you can use PuTTY and WinSCP.
* On Windows you can try to access the VM as a network shared directory (this is highly experimental though).
* If all else fails you can send yourself emails and use a web-based email client or services like dropbox to transfer data.

@@ Line 10: / Line 10: @@
 == Getting and Installing the ETK2017 Machine ==
-Now download the ETK2017 machine (2 GB to download, expands to 8GB, requires ~2GB of RAM to run): [https://drive.google.com/open?id=0B4gNfWainf-5bVBvRkNmUWlwSTA ETK2017 ETK2017.ova].
+Now download the ETK2017 machine (2 GB to download, expands to 8GB, requires ~2GB of RAM to run): [https://drive.google.com/file/d/0B4gNfWainf-5bVBvRkNmUWlwSTA/view ETK2017 ETK2017.ova].
 At the school, we will provide copies of the ETK2017 virtual machine image on USB flash storage devices. This will make it faster to install the official version.

@@ Line 10: / Line 10: @@
 == Getting and Installing the ETK2017 Machine ==
-Now download the ETK2017 machine: [https://drive.google.com/open?id=0B4gNfWainf-5bVBvRkNmUWlwSTA ETK2017 ETK2017.ova]. (2 GB to download, expands to 8GB, requires ~2GB of RAM to run)
+Now download the ETK2017 machine (2 GB to download, expands to 8GB, requires ~2GB of RAM to run): [https://drive.google.com/open?id=0B4gNfWainf-5bVBvRkNmUWlwSTA ETK2017 ETK2017.ova].
 At the school, we will provide copies of the ETK2017 virtual machine image on USB flash storage devices. This will make it faster to install the official version.

@@ Line 31: / Line 31: @@
 === Username and password ===
-The user name and password are both <code>et</code> and this user can become <code>root</code> using <code>sudo<code>.
+The user name and password are both <code>et</code> and this user can become <code>root</code> using <code>sudo</code>.
 === Exchanging data between host and virtual machine ===

@@ Line 36: / Line 36: @@
 * Clipboard content copied and pasted via Ctrl-C (or Command-C on OSX) and Ctrl-V is shared among host and virtual machine.
 * Depending on the version of virtualbox used on the host you can use "Shared folders". To do so (if you did not already create one when setting up the virtual machine) use the "Devices/Shared Folders Settings..." menu to create one. You can make it available inside of the virtual machine it by either rebooting your virtual machine or by using the MountSharedFolders.sh script that you can find on the Desktop of your virtual machine. The shared folder will appear in the media folder on the Desktop.
-* The virtual machine is reachable via ssh (and scp) by doing ssh -p 2222 et@127.0.0.1 and using the password <code>et</code>. OSX and Linux usually include an ssh client in their default installation, for Windows you can use PuTTY and WinSCP.
+* The virtual machine is reachable via <code>ssh</code> (and <code>scp</code>) by doing <code>ssh -p 2222 et@127.0.0.1</code> and using the password <code>et</code>. OSX and Linux usually include an <code>ssh</code> client in their default installation, for Windows you can use <code>[http://www.putty.org/ PuTTY]</code> and <code>[https://winscp.net/eng/index.php WinSCP]</code>.
 * On Windows you can try to access the VM as a network shared directory (this is highly experimental though).
 * If all else fails you can send yourself emails and use a web-based email client or services like dropbox to transfer data.