= Remote ISSM Internship Machine
URL: ec2-44-236-92-89.us-west-2.compute.amazonaws.com

== Connecting to Remote Machine via VNC
We have a virtual machine running on AWS that you can use to run a preinstalled copy of ISSM under MATLAB or Python. This machine uses a VNC server to allow you to interact with it as if it were your own, desktop computer.

In order to use VNC to connect to this machine, you may need to install some additional software on your computer.

=== Windows
- Install *one* of the following clients if you do not have one installed already

==== TigerVNC Viewer
- Download the TigerVNC Viewer Windows 10 installer: https://sourceforge.net/projects/tigervnc/files/stable/1.11.0/tigervnc64-1.11.0.exe/download
- Run the installer (no configuration is necessary)
- Run TigerVNC Viewer
- Set 'VNC server' to the URL listed at the top of this page suffixed with ":<port>" where port is the VNC port number that has been assigned to you. For example, if your VNC port number is 5950, set this field to,

`ec2-XX-XXX-XX-XX.us-west-2.compute.amazonaws.com:5950`

- Click the 'Connect' button
- Enter the VNC password that has been assigned to you
- On successful connection, you should see an Ubuntu Linux desktop and welcome dialog

==== MobaXTerm
- Download MobaXTerm
- Run MobaXTerm, right-click 'User Sessions' pane -> 'New Session' > 'VNC'
- Select 'Basic Vnc settings' and fill in the appropriate fields
	- Remote hostname should be set to the URL listed at the top of this document
	- Port should be set your assigned port number, such as 5950
- Rename the session ('Bookmark settings' -> 'Session same') if desired
- Click the 'OK' button to finalize

=== Linux
- See 'Windows' instructions for TigerVNC Viewer, but use the following link: https://sourceforge.net/projects/tigervnc/files/stable/1.11.0/tigervnc64-1.11.0.exe/download

=== Mac
- If desired, use a third-party VNC client. Otherwise, use macOS's built-in VNC viewer,
	- In Finder, select 'Go' -> 'Connect to Server...'
	- In the select menu field, enter the URL listed at the top of this page prefixed with "vnc://" and suffixed with ":<port>" where port is the VNC port number that has been assigned to you. For example, if your VNC port number is 5950, set this field to,

	`vnc://ec2-XX-XXX-XX-XX.us-west-2.compute.amazonaws.com:5950`

	- Click the 'Connect' button
	- Enter the VNC password that has been assigned to you
	- On successful connection, you should see an Ubuntu Linux desktop and welcome dialog

== Running MATLAB with ISSM
Running MATLAB with ISSM is as simple as double-clicking the 'MATLAB With ISSM' icon on the Desktop.

On load, your current working directory will be ~/ISSM/examples.