Differences

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

--- using-the-cluster [2020/03/19 12:17] – jean-baka
+++ using-the-cluster [2020/03/20 12:01] – [How to Connect to the Cluster] jean-baka
@@ Line 8: / Line 8: @@
 To get access to the cluster you should talk to Jean-Baka (he sits in BecA). Once you have access you should read up on [[Using SLURM|SLURM]] so you can learn how to submit jobs to the cluster.
+===== How to Connect to the Cluster =====
+Connecting to the HPC **is not done through clicking on the "Log In" link** on the top right corner of these wiki pages. In order to launch computations on the HPC or even just to view files residing in its storage infrastructure, users must use the **SSH protocol**. Through this protocol, users gain command-line access to the HPC from an SSH //client// software installed on their own machine (e.g. a laptop, desktop or smartphone). Depending on the operating system you are using on the computer from which you want to establish the connection, the procedure differs:
+==== If you are running MacOSX (on Apple computers) or any GNU/Linux distribution ====
+Those operating systems are part of the large family of UNIX systems, that almost invariably contain an already-installed SSH client, most often some flavor of the [[https://www.openssh.com/|OpenSSH]] client. Just open a terminal emulator and run the command ''ssh username@hpc.ilri.cgiar.org'', where your replace ''username'' with your own username on the HPC (as communicated by the person who created your account there).
+If the above doesn't work, then you probably have to **install** an ssh client. It suffices to **install the SSH client only**, no need for the SSH server: that one would be useful only if you want to allow remote connections //into// your computer. For instance, you can read about [[https://www.cyberciti.biz/faq/how-to-install-ssh-on-ubuntu-linux-using-apt-get/|instructions to install openssh-client on Ubuntu GNU/Linux]].
+==== If you are running Microsoft Windows ====
+If you are running Windows 10, you can access a simple ssh client by [[https://www.howtogeek.com/235101/10-ways-to-open-the-command-prompt-in-windows-10/|launching the "command prompt"]] and then typing in there ''ssh username@hpc.ilri.cgiar.org'', where your replace ''username'' with your own username on the HPC (as communicated by the person who created your HPC account).
+Another option is to [[https://mobaxterm.mobatek.net/download-home-edition.html|install MobaXterm]]: choose the "installer edition" unless you don't have rights to install stuff on the computer you are using, in which case you will use the "portable edition"). Once you have installed MobaXterm, you can setup a new connection by specifying the following connection parameters:
+  * host: ''hpc.ilri.cgiar.org''
+  * port: leave the default SSH port, i.e. port 22
+  * username: your username, as communicated by the person who created your HPC account.
 ===== Cluster Organization =====