CUBIC Wiki

This page is read only. You can view the source, but not change it. Ask your administrator if you think this is wrong.
====== CLUSTER MANUAL ======


====== Cluster Access ======
What's on this page:\\
  - VPN connection
  - Log in with SSH
  - GUI access


After you have registered up for HPC access, you will be provided with a local ''USERID'' and ''PASSWORD'', different from your college login credentials, which you can use to log into psychp01 using ''ssh'' (secure shell).\\
To access the cluster, you need to be in the campus network.\\
If you are connecting form a Windows computer on campus, you are already in the campus network.\\
If you are on campus and connecting from a Linux or Apple computer or if you are off campus, you will need VPN access to the campus network and then connect to psychp01.\\
If you don't have VPN access, please submit a ticket to the IT help desk.

Importantly, everybody (students and staff) need to connect to the staff VPN portal to access the cluster.  The address for the staff VPN is:

  staff-vpn.royalholloway.ac.uk.

Students should be able to connect with the staff VPN portal using their student credentials.


===== 1. VPN Connection =====

  - Windows PC:
    - //On campus//:
      - Establish an ''ssh'' connection

    - //Off campus//:
      - Connect to VPN
      - Establish an ''ssh'' connection

  - Mac or Linux:
    - //Both on and off campus//:
      - Connect to VPN
      - Establish an ''ssh'' connection


For Windows, you will need to have installed an ''SSH'' client.

Finally, there is also a GUI option, which, however, is not for computing purposes.

See [[cluster-vpn_install|here]] for a step-by-step guide to install the VPN client GlobalProtect.


===== 2. Log in with SSH =====
==== Access to psychp01 through Command Line (Linux and OSX) ====

An ''ssh'' client (Secure SHell) allows you to connect to psychp01 from your terminal. An ''ssh'' client provides secure encrypted communications between two hosts over an insecure network.\\
If you already have ''ssh'' installed on your UNIX-like system (Linux or Apple OSX), have a user account and password, login may be as easy as opening a terminal and typing ''ssh'' //cluster_name// into a terminal window. For instance:

  ssh psychp01.rhul.ac.uk


If your username on the cluster differs from your username on the local machine, use the ''-l'' option to specify the username on the machine to which you connect. For example:

  ssh cluster_name -l your_cluster_username

or alternatively,

  ssh your_cluster_username@psychp01.rhul.ac.uk

Hence, if my cluster username is “gbellucci”, I would type the following to access the cluster:

  ssh gbellucci@psychp01.rhul.ac.uk

If you need X-forwarding (see X11 Forwarding in [[cluster-linux|Linux Quickstart]]), you must log in like this:

  ssh -X cluster_name

For Interactive sessions, for example MATLAB, you should add -Y to your ''ssh'' command:

  ssh -Y username@psychp01.rhul.ac.uk

where the command -Y enables trusted X11 forwarding.\\
Once you have hit entered, you will be asked to provide your //password//. Once you entered your password, you will be connected to the cluster. You will see some basics information about the cluster printed out in the terminal like:


  Linux psychp01 5.10.0-24-amd64 #1 SMP Debian 5.10.179-5 (2023-08-08) x86_64
  The programs included with the Debian GNU/Linux system are free software;
  the exact distribution terms for each program are described in the
  individual files in /usr/share/doc/ */copyright.
  Debian GNU/Linux comes with ABSOLUTELY NO WARRANTY, to the extent
  permitted by applicable law.
  Last login: Fri Oct 6 19:08:37 2023 from 10.40.65.14


At the beginning of your terminal line, you will see your username and the server name like that:

  username@psychp01:~\$ 

When you are done, you can close the connection just by typing ''exit'' in the command line. Please see page 15 of the pdf version of the manual [[cluster-guide|here]] for a short video that demonstrates that.



==== SSH clients for Windows ====
On Windows, you can use PuTTYgen that comes with PuTTY. More information on [[https://www.ssh.com/academy/ssh/putty/windows/puttygen|ssh.com]]. Further, the cmder console emulator works nicely with Windows 10/11 and is available open source [[https://cmder.app/|here]]. Please download the full version to get built-in installation of git-for-windows along with it. If you have any queries, please get in touch with the IT.\\
At the [[https://www.openssh.com/|OpenSSH page]], you will find several SSH alternatives for both Windows and Mac.\\
Please note that Mac OS X comes with its own implementation of OpenSSH, so you don’t need to install any third-party software to take advantage of the extra security SSH offers. Just open a terminal window and jump in.\\
To learn more about using SSH, please also consult the OpenSSH page and take a look at the manual page on your system by typing the following on your terminal:

  man ssh


===== 3. GUI access =====
Alternatively, for allowing GUI access, the cluster comes installed with Remote Desktop Protocol (RDP). From a Windows and Apple computer, use the [[https://apps.apple.com/us/app/microsoft-remote-desktop/id1295203466?mt=12|Microsoft Remote Desktop App]]. From Linux computers use [[https://remmina.org/|Remmina]]. You should use the server location as psychp01.rhul.ac.uk and use the local userid and password provided by Psychology IT for logging in through RDP. The advantage of RDP is that your desktop will be preserved between logins, across network disconnects, etc, until the cluster is reset.\\
__IMPORTANT__: Be aware that the GUI access could be useful for visual inspections (but see [[cluster-linux#displaying_images_in_command_line|Displaying images in command line]] to inspect images without GUI access). However, you should not run anything from the GUI. All analyses need to be run using the [[cluster-batch|batch system]]. Processes that do not use the batch system will be killed.



[[{:backward_arrow.png?40|width: 12em}cluster-linux|Linux QuickStart]][[{:forward_arrow.png?40|width: 12em}cluster-analyses|Running analyses on psychp01]]\\
[[{:toc.png?40|width: 12em}cluster-toc|Return to Table of Contents]][[{:main_page.png?40|width: 12em}cluster-guide|Return to main page]]

~~DISCUSSION|Discussion~~