Difference between revisions of "Yambo Virtual Machine"

From The Yambo Project
Jump to navigation Jump to search
Line 19: Line 19:
[[File:yambo_VM.png|link=http://www.yambo-code.org/educational/VirtualMachine/YAMBO_Quantum_Mobile.ova]]
[[File:yambo_VM.png|link=http://www.yambo-code.org/educational/VirtualMachine/YAMBO_Quantum_Mobile.ova]]


Note that this image has a large size of 5-7 GBytes. Don't attempt to download it from a poor wireless connection. Having downloaded the VM Image, it needs to be '''imported''' into VirtualBox.
Note that this image has a large size of 4 GBytes. Don't attempt to download it from a poor wireless connection. Having downloaded the VM Image, it needs to be '''imported''' into VirtualBox.


* Start VirtualBox
* Start VirtualBox
Line 45: Line 45:
[[File:QM5.png|400px|irtualBox Window after Import]]
[[File:QM5.png|400px|irtualBox Window after Import]]


* Open a terminal window (black icon with '>' on the left) and read the ''RELEASE_NOTES.txtx''.
* Open a terminal window (black icon with '>' on the left) and read the ''RELEASE_NOTES.txt''.
 
== Updating the Yambo tutorial files ==
 
Now that the Yambo VM is running open a terminal window (black icon with '>' on the left) and
 
* read the ''RELEASE_NOTES.txt''.
* enter the YAMBO_TUTORIALS folder and update the files by typing
 
>git pull
>./setup.pl -install

Revision as of 12:02, 23 January 2020

Virtual Box Download and Installation Instructions

VirtualBox is a software to run a ('virtualized') operating system as a client of a host operating system. The host operating system is what you boot your computer into. The client operating system (called a 'virtual machine', or a 'software appliance') has been prepared by us specifically for this School.

Download and Install VirtualBox Software

Go to Virtualbox Home and click on the big button to download the latest Version, select your host system on the next page and start the download of the package.

  • For Windows users the download provides an `.exe` file that can be started by double-clicking on its icon
  • For Mac users the download provides a disk image `.dmg` file that also can be started by double-clicking
  • For Linux users more choices are available, depending on distribution. There is also the option to use a repository for Debian-based Linux distributions.

This should be all. If something goes wrong, try to reboot your host and try to re-install on the freshly booted machine. (In the past, it was often found (at least on MacOSX) that upgrades of VirtualBox do not work when having run VirtualBox clients before.)

Download and Install the Virtual Machine

Download the virtual machine image clicking on the following link

Yambo VM.png

Note that this image has a large size of 4 GBytes. Don't attempt to download it from a poor wireless connection. Having downloaded the VM Image, it needs to be imported into VirtualBox.

  • Start VirtualBox
  • Goto Menu Item "File", then "Import Appliance" (File->Import Appliance)
  • In the topmost field, type in the name of the downloaded Appliance File or search for it via the finder that opens when clicking the button to the right.

Screenshot before Import

Screenshot Image selection

Screenshot during Import

  • Proceed until the virtual machine has been successfully created.

Starting the Virtual Machine

After import, the VirtualBox window looks roughly so:

irtualBox Window after Import

  • Double-Click on the Virtual Machine Icon of the VirtualBox program.
  • Within a few seconds, the window of the virtual machine will open and eventually

you will see the graphical window of a running VM, into which you are automatically logged in as user `max`.

irtualBox Window after Import

  • Open a terminal window (black icon with '>' on the left) and read the RELEASE_NOTES.txt.

Updating the Yambo tutorial files

Now that the Yambo VM is running open a terminal window (black icon with '>' on the left) and

  • read the RELEASE_NOTES.txt.
  • enter the YAMBO_TUTORIALS folder and update the files by typing
>git pull
>./setup.pl -install