| 1 | = Remote ISSM Internship Machine |
| 2 | URL: ec2-44-236-92-89.us-west-2.compute.amazonaws.com |
| 3 | |
| 4 | == Connecting to Remote Machine via VNC |
| 5 | 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. |
| 6 | |
| 7 | In order to use VNC to connect to this machine, you may need to install some additional software on your computer. |
| 8 | |
| 9 | === Windows |
| 10 | - Install *one* of the following clients if you do not have one installed already |
| 11 | |
| 12 | ==== TigerVNC Viewer |
| 13 | - Download the TigerVNC Viewer Windows 10 installer: https://sourceforge.net/projects/tigervnc/files/stable/1.11.0/tigervnc64-1.11.0.exe/download |
| 14 | - Run the installer (no configuration is necessary) |
| 15 | - Run TigerVNC Viewer |
| 16 | - 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, |
| 17 | |
| 18 | `ec2-XX-XXX-XX-XX.us-west-2.compute.amazonaws.com:5950` |
| 19 | |
| 20 | - Click the 'Connect' button |
| 21 | - Enter the VNC password that has been assigned to you |
| 22 | - On successful connection, you should see an Ubuntu Linux desktop and welcome dialog |
| 23 | |
| 24 | ==== MobaXTerm |
| 25 | - Download MobaXTerm |
| 26 | - Run MobaXTerm, right-click 'User Sessions' pane -> 'New Session' > 'VNC' |
| 27 | - Select 'Basic Vnc settings' and fill in the appropriate fields |
| 28 | - Remote hostname should be set to the URL listed at the top of this document |
| 29 | - Port should be set your assigned port number, such as 5950 |
| 30 | - Rename the session ('Bookmark settings' -> 'Session same') if desired |
| 31 | - Click the 'OK' button to finalize |
| 32 | |
| 33 | === Linux |
| 34 | - 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 |
| 35 | |
| 36 | === Mac |
| 37 | - If desired, use a third-party VNC client. Otherwise, use macOS's built-in VNC viewer, |
| 38 | - In Finder, select 'Go' -> 'Connect to Server...' |
| 39 | - 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, |
| 40 | |
| 41 | `vnc://ec2-XX-XXX-XX-XX.us-west-2.compute.amazonaws.com:5950` |
| 42 | |
| 43 | - Click the 'Connect' button |
| 44 | - Enter the VNC password that has been assigned to you |
| 45 | - On successful connection, you should see an Ubuntu Linux desktop and welcome dialog |
| 46 | |
| 47 | == Running MATLAB with ISSM |
| 48 | Running MATLAB with ISSM is as simple as double-clicking the 'MATLAB With ISSM' icon on the Desktop. |
| 49 | |
| 50 | On load, your current working directory will be ~/ISSM/examples. |