README.md 2.91 KB
Newer Older
Todor Kondic's avatar
Todor Kondic committed
1
2
3
4
5
6
7
8
9
10
11
12
# Environmental Cheminformatics Educational Platform: Plan B

This repository contains a collection of ansible scripts which can be
used to provision an Ubuntu/Debian based virtual machine in a public
cloud. The scripts have been written for a specific Digital Ocean
_droplet_, but can easily be adapted for something else.


## Access

The desktop environment on the compute node *alien-one* is accessible
through VNC protocol. Any VNC viewer can be used. If in doubt, try the
Todor Kondic's avatar
Todor Kondic committed
13
cross-platform TigerVNC viewer [available from here for
Todor Kondic's avatar
Todor Kondic committed
14
15
16
17
18
Windows](https://bintray.com/tigervnc/stable/download_file?file_path=vncviewer-1.11.0.exe),
or as a package from your GNU/Linux distribution.



Todor Kondic's avatar
Todor Kondic committed
19
**Before** connecting, you need: 
Emma Schymanski's avatar
Emma Schymanski committed
20
	- A X509 certificate file (`*.pem`).
Todor Kondic's avatar
Todor Kondic committed
21
	- The IP address of the server.
Todor Kondic's avatar
Todor Kondic committed
22
	- Your username and password.
Todor Kondic's avatar
Todor Kondic committed
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37

### Connection instructions

1. Open the VNC viewer.
2. Click `Options`.
3. Switch to `Security` tab.
4. Make sure that at least `TLS with X509 certificates` is checked.
5. Make sure that at least `None` is checked in the `Authentication` section.
6. Set the `Path to X509 certificate` to the location of the X509
   certificate file.
7. Now, click `OK` to accept changes and close the `Options` tab.
8. Fill in the IP address of the server in field `VNC server` and
   append `:5950` to it. So, the `VNC server` entry should look like
   this `XXX.XXX.XXX.XXX:5950`.
9. Click `Connect`.
Emma Schymanski's avatar
Emma Schymanski committed
38
10. When at the login screen, ensure you are using the `Xfce Session` (settings wheel, bottom right) before entering your password.
Emma Schymanski's avatar
Emma Schymanski committed
39
11. Pro-tip: User experience may be better in fullscreen (`F8` and select `fullscreen`)
Todor Kondic's avatar
Todor Kondic committed
40

Todor Kondic's avatar
Todor Kondic committed
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
## Using Environmental Cheminformatics programs

### Getting started with Shinyscreen

Shinyscreen is ECI's mass spectrum inspection program. It was written
in R and exists as a R package. In order to run it, it is necessary to
start a R session. 

While most students get to know R through R Studio, this development
environment (DE) is by no means the only one that can run R (indeed,
you do not even need a DE to run R: try it yourself, start a command
console and type `R` in there). The default choice of R DE on
`alien-one` currently is GNU Emacs with its *Emacs Speaks Statistics
(ESS)* mode.

Steps:
Todor Kondic's avatar
Todor Kondic committed
57

Emma Schymanski's avatar
Emma Schymanski committed
58
59
60
61
62
63
1. Fire up emacs
2. `Alt-x` and `R` gets you an R session
3. Enter `library(shinyscreen)`
4. Enter `options(browser="chromium")`
5. Enter `launch()` 

Todor Kondic's avatar
Todor Kondic committed
64
65
66
67
68
69
70
71
72
73
74
75

Alternatively, there there are two icons on your desktop that will
start Shinyscreen immediately without a R session. One starts the
stable version of Shinyscreen (used in this course). The other runs a
development version (you can try it out if you feel adventurous).


### Material needed for the practical

The *mzML* data files are in `/mnt/exchange` directory.

#### Just in case
Emma Schymanski's avatar
Emma Schymanski committed
76
77
78
1. Raw files `*.mzML` can be downloaded from [here](https://zenodo.org/record/3666069) 
2. Input files for Shinyscreen from [here](https://git-r3lab.uni.lu/eci/isb401/-/tree/master/shinyscreen_files)

Todor Kondic's avatar
Todor Kondic committed
79

Todor Kondic's avatar
Todor Kondic committed
80
81