en:software:howto_virtualbox_ubuntu [OST Wiki]

This page is read only. You can view the source, but not change it. Ask your administrator if you think this is wrong.
<WRAP center round alert 60%>
Unfortunately, there is no up to date version of the virtual machine at the moment :-( 
</WRAP>

====== The laboratory course computer for your home ("columba to go") ======

For students who wish to use the data reduction software on their own computer (at home), we offer a preconfigured virtual machine running Ubuntu 12.10. To install own software, use [[https://help.ubuntu.com/community/AptGet/Howto|apt-get]].

The virtual machine has these programs installed:
  * [[http://ds9.si.edu/site/Home.html|ds9]]
  * [[http://www.eso.org/sci/software/esomidas/|midas]]
  * [[en:software:howto_gdl_install|gdl]] with the [[http://idlastro.gsfc.nasa.gov| IDL Astronomy Library]]
  * [[http://www.winehq.org/|wine]]
  * [[http://www.fitswork.de/software/softw_en.php|Fitswork]]
  * [[http://kate-editor.org/|Kate]], [[http://www.vim.org/|vim]]
  * [[http://www.astro.physik.uni-potsdam.de/~htodt/wrplot/|wrplot]], [[http://www.gnuplot.info/|gnuplot]]
  * [[http://www.hs.uni-hamburg.de/DE/Ins/Per/Wichmann/Nightfall.html|nightfall]] 
  * ssh bookmarks for the physical laboratory course computers in Nautilus and Dolphin

/* , [[http://pendientedemigracion.ucm.es/info/Astrof/software/howto/howto-pgplot.html|pgplot]] */

Current version of the virtual box: November 30, 2013.

==== Getting the virtual box ====
Bring a USB stick with sufficient size (current size of the box ~ 3 GB) and ask the instructors. Alternatively, download the machine from our [[https://polaris.astro.physik.uni-potsdam.de/praktikum/|web site]] with the seminar talks (authorized access only).

==== Technical properties ====
The virtual machine was created with:
  * built with Oracle VM VirtualBox 4.3.4
  * 32bit
  * 1024 MB RAM (can and should be increased)
  * 1 CPU (can and should be increased)
  * PAE/NX needs to be activated
  * Hardware-Virtualisation and 3D acceleration disabled (can and should be activated)
  * 64 MB Graphics RAM (can and should be increased)
  * Network-NAT (to use the internet connection of the host system)
  * bidirectional clipboard (host and guest system have a common clipboard, this requires the "Guest" extension)

===== Software to run the virtual box =====

==== VirtualBox (suggested) ====

=== install VirtualBox ===

== Windows Hosts ==
The program can be downloaded [[http://www.virtualbox.org/wiki/Downloads|here]].

== Linux Hosts ==
See [[https://www.virtualbox.org/wiki/Linux_Downloads|here]].

=== Oracle VM VirtualBox Extension Pack ===
For support of USB2 and scaling-free window sizing additionally install the //VirtualBox Extension Pack// from the same page.
This should be installed before the virtual machine is imported. Then reboot the (virtual) computer.

=== Import the virtual machine ====

  * import Appliance 
  * click ''Select'' and find the location of the virtual machine, then import
  * after making technical changes (e.g. increasing the amount of RAM) to the virtual machine, the //VirtualBox Extension Pack// might need to be installed again.

==== VMware Player ====

=== Install VMware Player ===
Download (and install) the software applicable for your system from [[https://my.vmware.com/en/web/vmware/free#desktop_end_user_computing/vmware_workstation_player/12_0|here]].

<typo fs:80%;>Disclaimer VMware Player: VMware Player is free for private use. VMware Player Plus is liscensed for commercial use. If you want to learn the handling of virtual machines or try them out at home, you may use the free version VMware Player!</typo>

=== Import virtual machines ====

To be added...

=== VMWare Tools ===

To be added...

===== Troubleshooting =====
==== Ubuntu freezes at the logo ====
Sometimes Ubuntu fails to boot and freezes at the Ubuntu-logo. The reason could be that gnome or the X-server is broken (if the X server is started with ''startx'', there will be error messages like ''/etc/X11/xinit/xserverrc: 3: exec: ...''). Follow these steps to solve this issue (Note: you need to be online):
  - change to the [[https://wiki.ubuntu.com/RecoveryMode|Recovery Mode]] during the booting process (press the ''Shift'' or ''ESC'' button)
  - resume booting with ''resume''
  - Ubuntu boots without the desktop (just a shell) 
  - login with normal user, password
  - execute: ''sudo apt-get update'' (the sudo password is the normal praktikum password) 
  - execute: ''sudo apt-get install ubuntu-desktop''

Afterwards, start the desktop with ''startx''. It is however __recommend__ to reboot the machine with ''sudo reboot''. The machine should then start with the desktop. 

==== Update the distribution ====
First check if the system is using the latest version.
  sudo apt-get update                        # update the package sources
  sudo apt-get dist-upgrade                  # update the packages
**It's important to have the package "update-manager-core" installed.** Then prepare the update for the system:
  sudo update-manager --proposed
The update will start after clicking on "Update". On the next window one has to click on "Update system". The info window "The support for some programs has ceased" can be closed. A final confirmation window "Do you want to start the system update?" needs to be approved by clicking on "Start system update". The update process then proceeds with the download of the packages, which afterwards will be installed. The whole process might take a few hours.