Connecting to DMOG
==================

Before following the process below, this guide assumes you have an account on the cluster. 
If that is not the case, you can request one by contacting ISHelp@hw.ac.uk

Interaction with DMOG is done remotely via SSH (Secure Shell). 
To connect to another machine using SSH you need to have a SSH client program installed on your machine. 
macOS, Linux, and newer versions of Windows come with a command-line (text-only) SSH client pre-installed. 
On older Windows versions there are various graphical SSH clients you can use like PuTTY or MobaXterm.

Using your favorite SSH client, just type:

.. code-block:: bash

   ssh <username>@dmog.hw.ac.uk

Note: the cluster is accessible within the University network. For remote access you need to log on 
to the `University VPN <https://heriotwatt.sharepoint.com/sites/is-servicecatalogue/SitePages/Virtual-Private-Network-(VPN).aspx>`_ , or request access to the SSH gateway via the self-service portal first.

VSCode via Slurm
----------------

To create a job on DMOG and have VSCode connect to the job to debug code etc:

#. You will need to have an SSH keypair set up for connecting to DMOG, so that you can connect without entering your password.

#. Within VSCode, install the 'Remote - SSH' extension.

#. Next, follow the steps shown here to create your SSH config file, start a slurm job, and connect to it via VS Code: :ref:`hwVSCode <vsCodeSlurm>`

.. note::
   If your connection to DMOG using VSCode suddenly stops working, this is usually due to exceeding your file storage quota. You can check this with:

   :ref:`hwQuota <hwQuota>`


Configure MobaXTerm for DMOG
----------------------------

MobaXTerm is an SSH/SCP/SFTP client available for Windows. As it has SCP/SFTP functionality built-in it simplifies copying files to/from DMOG.

It is available from here: `MobaXTerm <https://mobaxterm.mobatek.net/download.html>`_

Create a Work folder on the left by right-clicking User Sessions and selecting new folder:

.. image:: connecting/mobaxterm1.png
  :width: 300


Right-click the work folder and select New session:

.. image:: connecting/mobaxterm2.png
  :width: 300


In the new session window select SSH. In the Remote Host field enter dmog.hw.ac.uk

Check the box next to Specify Username and enter your DMOG username into the field

Bookmark Settings and enter DMOG into the Session Name field then click OK:

.. image:: connecting/mobaxterm3.png
  :width: 600


Double-click the DMOG session on the left of the window, you will be prompted for your DMOG password to log in. Note that whenever you are prompted for a password you will not be able to see what you are typing, not even \*s.

Once logged in, at the bottom left of the window check the box next to Follow Terminal Folder:

.. image:: connecting/mobaxterm4.png
  :width: 300


The area to the left of the Window will allow you to see the files in the folder you are currently inside, as well as create new folders, and upload files/folders to the folder you are currently in.

To upload files from your Windows PC to DMOG, you can either drag and drop files onto this panel on the left to, or use the Up arrow to select files to upload. You can also download files from DMOG to your computer by selecting them on the left panel and clicking the Down arrow.