OVA Detailed documentation for: SPICE_training.ova

Login credentials:
User: spiceuser
Password: SPICE

- Created with Windows 10 host
- [comments]
[some installations might not be necessary but are included because of good experience...]


0. PREREQUISITE
	1. Downloads:
		- https://www.virtualbox.org/
			--> Download virtual box (5.1.30)
		- http://releases.ubuntu.com/14.04/
			--> ubuntu-14.04.5-desktop-amd64.iso (1.0 GB)
	2. Install VM box:
		- execute the first downloaded file
			--> always click "next"

I. INITIAL START OF VM
	1. Open the VM box Manager and click "new"
		--> Name: SPICE_training [whatever you like]; Type: Ubuntu; Version: Ubuntu(64-bit)
		--> Memory size: 4096 MB
		--> Hard disk: Create a virtual hard disk now
		--> Hard disk file type: VDI
		--> Storage on physical hard disk: Dynamically allocated
		--> File location and size: 20,00 GB
	2. VM box Mangager: SPICE_training
		--> click "start"
		[an error message can appear for a short time but it will go away]
		--> Select start-up disk: -> browse to the second downloaded file -> select it and click "start"
		--> Welcome: Install Ubuntu
		[you can move the installation window if it doesn't fit inside the displayed window]
		[if messages appear on the top of the window, click them away "do not show this message again"]
		--> Preparing to install Ubuntu: check "Download updates while installing"
		--> Installation type: Erase disk and install Ubuntu -> install now
		--> Popup window: "Write changes to disk" -> continue
		--> Where are you?:  Madrid [whatever you like]
		--> Keyboard Layout: English(US) -> continue
		--> Your name: spiceuser; Computer name: spiceuser-VirtualBox; username: spiceuser; password: SPICE; log in automatically
		--> Installation complete: Restart now
		--> wait-for-state stop/waiting: hit "return"
	3. Useful basic settings:
		--> Keyboard shortcut -> close
		--> Ubuntu 16.04.3 LTS Upgrade Available: Don't Upgrade -> ok
		--> Launcher [left bar] -> click "System Settings" -> "Brightness and Lock" -> "turn screen off when inactivate for" -> never -> close window
		--> Launcher "Ubuntu Software Center" ->right click "Unlock from Launcher"
		--> Launcher "LibreOffice Writer" ->right click "Unlock from Launcher"
		--> Launcher "LibreOffice Calc" ->right click "Unlock from Launcher"
		--> Launcher "LibreOffice Impress" ->right click "Unlock from Launcher"
		--> Launcher "Search" -> type: terminal -> select it
		--> Launcher "terminal" -> right click "Lock to Launcher" -> close it		
		--> Launcher "Software Updater" [should show up after a while]: -> Install now -> password [SPICE] -> authenticate -> restart now -> restart
		--> VM Box [over top bar] "Devices" -> Insert Guest Additions CD image -> Run -> password "SPICE" -> "return"
		--> VM Box "Devices" -> shared clipboard -> bidirectional		
		--> Launcher "VBOXADDITIONS" -> right click "Unlock from Launcher"
		--> restart [top right corner -> shut down -> restart]

II. SETUP WORKING ENVIRONMENT
	[If not indicated differently, all commands are executed in the terminal window]
	[use ctrl+c -> ctrl+shift+v to insert the commands easily, commands are seperated using ";"]
	[If you get any "Do you want to continue message, type "y" or "yes" as descriped in the message itself and press "return" == "ENTER"]
	1. Remove/Install programs using the command line:
		--> sudo apt-get update; [get all links/sources right]
		--> sudo apt-get purge unity-webapps-common; sudo apt-get install unity-webapps-common; sudo apt-get update; [remove amazon app]
		--> sudo apt install python3.4-venv; python3 -m venv myvenv; [install virtual environment]
		--> source myvenv/bin/activate [activate virtual environment. Make sure it is always activated e.g. after restart...]
		--> sudo apt-get update
		--> sudo apt-get install python-pip; sudo apt-get update; pip install --upgrade pip; sudo apt-get update; [install pip]
		--> sudo pip install --upgrade setuptools; sudo apt-get update; [update setuptools]
		--> sudo apt-get install build-essential libssl-dev libffi-dev python3-dev; sudo apt-get update; [install some libaries] 
		--> pip install -U pip setuptools wheel; pip install -U numpy==1.14.0 six certifi; pip install spiceypy==2.0.0; sudo apt-get update; [install spiceypy][if 1.14.0 is not working, just ignore this and use only "numpy"]
		--> sudo add-apt-repository ppa:ubuntu-desktop/ubuntu-make; keyboard: "return" ; sudo apt-get update; [install pycharm]
		--> sudo apt-get install ubuntu-make; umake ide pycharm, keyboard: "return" ; sudo apt-get update;
		--> pip install pytest
		--> pip install spiops
	2. Install cosmographia:
		--> Launcher "firefox" -> https://naif.jpl.nasa.gov/naif/cosmographia_components.html
			--> SPICE-enhanced Cosmographia for Linux (64-bit) -> download
		--> cd Downloads; chmod +x cosmo-installer-3.0-linux; ./cosmo-installer-3.0-linux
		--> Next
		--> Installation folder: /home/cosmoview/project/cosmographia-3.0 [it is not the default one]
		--> Select components: check "Extras"
		--> Accept the licenses and install
		--> unckeck "Open Cosmographia" -> Finish

		--> https://naif.jpl.nasa.gov/naif/toolkit_FORTRAN_PC_Linux_gfortran_64bit.html  -> download toolkit.tar.Z, importSpice.csh
		--> https://naif.jpl.nasa.gov/naif/toolkit_C_PC_Linux_GCC_64bit.html -> download cspice.tar.Z, importCSpice.csh
		--> https://naif.jpl.nasa.gov/pub/naif/self_training/packaged_docs/ -> download Self-training_Package_PDF.zip
		--> sudo apt-get install csh; sudo apt-get install default-jdk; sudo apt-get install gfortran; sudo apt-get update;
		--> mv Downloads/cspice.tar.Z Desktop/cspice.tar.Z
		--> mv Downloads/importCSpice.csh Desktop/importCSpice.csh
		--> mv Downloads/toolkit.tar.Z Desktop/toolkit.tar.Z
		--> mv Downloads/importSpice.csh Desktop/importSpice.csh
		--> cd Desktop;
		--> /bin/csh -f importSpice.csh
		--> /bin/csh -f importCSpice.csh
		--> rm cspice.tar importCSpice.csh toolkit.tar importSpice.csh; cd
		--> unzip Downloads/Self-training_Package_PDF.zip -d Desktop/tutorials

Create some bash scripts in home/flp/ directory:
cosmographia.sh:

#!/bin/bash
source myvenv/bin/activate
cd cosmographia-3.0
./Cosmographia.sh -style=gtk
cd

jupyter.sh

#!/bin/bash
source myvenv/bin/activate
cd Desktop
jupyter notebook
cd

		--> chmod 755 jupyter.sh; chmod 755 cosmographia.sh

create readme.txt  (Desktop)
Minimal manual:

- Run Cosmographia: 1. open terminal(or new tab)  2. source cosmographia.sh

- Run Jupyter Notebook: 1. open terminal(or new tab) 2.  ./jupyter.sh

create readme.txt: (desktop)
Minimal manual:
- Run Cosmographia: 1. open terminal(or new tab)  2. source cosmographia.sh
- Run Jupyter Notebook: 1. open terminal(or new tab) 2.  ./jupyter.sh

		--> echo 'export PATH=$PATH:/home/spiceuser/Desktop/toolkit/exe'  >> ~/.profile
		--> echo 'export PATH=$PATH:/home/spiceuser/Desktop/cspice/exe'  >> ~/.profile

		--> sudo apt-get install git-all; sudo apt-get update;
		- open firefox: https://git-lfs.github.com/ --> Download
		--> cd; cd Downloads; tar -zxf [downloaded file, eg. git-lfs-linux-amd64-2.3.4.tar.gz]
		--> cd git-lfs-2.3.4 (or similar); sudo ./install.sh; cd;

		--> https://naif.jpl.nasa.gov/pub/naif/toolkit_docs/Lessons/ -> Download: spice_lessons_py_unix.zip
		--> unzip Downloads/spice_lessons_py_unix.zip -d Desktop/lessons
		--> cd Downloads; sudo rm -r *;


######################## SPICE_training.ova ########################