ampl.md

-## connect to ampl virtual machine from os x
-create an account to connect to the machine : ask Jonathan (jonathan.lambrechts@uclouvain.be)
+# Using ampl virtual machine
+Summary :
+- create an account to connect to the machine : ask Jonathan (jonathan.lambrechts@uclouvain.be)
+- connect to the virtual machine following one of the procedure described bellow (depending of your platform)
+- transfer file to the virtual machine
+- run ample (see last section)
 
+## connecting to the virtual machine
+### from windows
+This section describes the use of mobaxterm, if you are familiar with other ssh tools (like putty and winscp) you can use them. It is also possible to enable the "linux subsystem" of windows 10 and follow the "from macOS or linux" section.
+- download and install mobaxterm home edition : https://mobaxterm.mobatek.net/download-home-edition.html
+- create a new session using the menu "sessions->new session" then choose the "ssh" session type.
+- set "remote host" to "leech.mema.ucl.ac.be", tick "specify username" and type your login. set the port to "2223"
+- select the "Network settings tab" and tick the "Connect through SSH gateway" option. In "Geteway SSH server", put "braque.mema.ucl.ac.be" and put your login in the "User" field
+- click on "OK", enter your password two times and you are done.
+- next time, to re-open a new session, just double-click on the "leech" session in the left panel.
+
+### from macOS or linux
 add those lines in your "~/.ssh/config
 ```
 Host *
@@ -32,7 +47,10 @@ you can now connect to the ampl virtual machine simply with
 ```
 ssh AMPL_MEMA
 ```
-## transfer files from os x
+## transferring files to/from the virtual machine
+### from windows
+- Once mobaxterm is connected to leech, you can use the left panel to transfer files.
+### from macOS
 Install fuse and sshfs from [osxfuse](https://osxfuse.github.io/), then create a local directory and mount the remote machine :
 ```
 mkdir ampl_mema
@@ -43,8 +61,9 @@ When you are done, unmount the remote directory with
 ```
 umount ampl_mema
 ```
-## run ampl
-it is recommended to run ampl inside a `screen` session, so that you can close your terminal and re-connect to your session with `screen -r` [more info about screen here](https://linuxize.com/post/how-to-use-linux-screen/). To launch a scree session, simply type
+## running ampl
+ampl is launched inside the ssh session you have established.
+It is recommended to run ampl inside a `screen` session, so that you can close your terminal and re-connect to your session with `screen -r` [more info about screen here](https://linuxize.com/post/how-to-use-linux-screen/). To launch a scree session, simply type
 ```
 screen
 ```