Differences

This shows you the differences between two versions of the page.

--- cluster-access [2024/05/07 12:18] – created gabriele
+++ cluster-access [2024/11/22 11:32] (current) – [3. GUI access] gabriele
@@ Line 9: / Line 9: @@
-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).\\
+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.\\
@@ Line 16: / Line 16: @@
-===== VPN connection =====
+===== 1. VPN Connection =====
-Windows PC:
+  - Windows PC:
-	On campus:
+    - //On campus//:
-.	Establish an ssh connection
+      - Establish an ''ssh'' connection
-Off campus:
+    - //Off campus//:
-.	Connect to VPN
+      - Connect to VPN
-.	Establish an ssh connection
+      - Establish an ''ssh'' connection
-Mac or Linux
+  - Mac or Linux:
-Both on and off campus:
+    - //Both on and off campus//:
-.	Connect to VPN
+      - Connect to VPN
-.	Establish an ssh connection
+      - Establish an ''ssh'' connection
-For Windows, you will need to have installed an SSH client.
+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 here for a step-by-step guide to install the VPN client GlobalProtect.
+See [[cluster-vpn_install|here]] for a step-by-step guide to install the VPN client GlobalProtect.
-Log in with SSH
+===== 2. Log in with SSH =====
+==== Access to psychp01 through Command Line (Linux and OSX) ====
-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:
-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.
+  ssh psychp01.rhul.ac.uk
-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, 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:
-into a terminal window.
+  ssh cluster_name -l your_cluster_username
-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
+  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
+  ssh gbellucci@psychp01.rhul.ac.uk
-If you need X-forwarding, you must log in like this:
+If you need X-forwarding (see X11 Forwarding in [[cluster-linux|Linux Quickstart]]), you must log in like this:
-ssh -X cluster_name
+  ssh -X cluster_name
-For Interactive sessions, for example MATLAB, you should add -Y to your ssh command:
+For Interactive sessions, for example MATLAB, you should add -Y to your ''ssh'' command:
-ssh -Y username@psychp01.rhul.ac.uk
+  ssh -Y username@psychp01.rhul.ac.uk
-where the command -Y enables trusted X11 forwarding.
+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:
-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
-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
-The programs included with the Debian GNU/Linux system are free software;
+  individual files in /usr/share/doc/ */copyright.
-the exact distribution terms for each program are described in the
+  Debian GNU/Linux comes with ABSOLUTELY NO WARRANTY, to the extent
-individual files in /usr/share/doc/ */copyright.
+  permitted by applicable law.
+  Last login: Fri Oct 6 19:08:37 2023 from 10.40.65.14
-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:~\$
+  username@psychp01:~\$
-When you are done, you can close the connection just by typing exit in the command line. Please see below a short video that demonstrates that.
+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~~
-SSH clients for Windows
-On Windows, you can use PuTTYgen that comes with PuTTY. More information on ssh.com. Further, the cmder console emulator works nicely with Windows 10/11 and is available open source 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 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
-GUI access
-Alternatively, for allowing GUI access, the cluster comes installed with Remote Desktop Protocol (RDP). From a Windows and Apple computer, use the Microsoft Remote Desktop App. From Linux computers use 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 is a useful option you can use in case you would need to visually inspect something on cluster without the need to download it onto your local machine (e.g., plots of your results or preprocessing steps and so on). However, you should not run anything from the GUI. All analyses need to be run using the batch system. Processes that do not use the batch system will be killed.