View source for BinAC2/Login

{|style="background:#deffee; width:100%;"
|style="padding:5px; background:#cef2e0; text-align:left"|
[[Image:Attention.svg|center|25px]]
|style="padding:5px; background:#cef2e0; text-align:left"|
Access to bwForCluster BinAC 2 is only possible from IP addresses within the [https://www.belwue.de BelWü] network which connects universities and other scientific institutions in Baden-Württemberg.
If your computer is in your University network (e.g. at your office), you should be able to connect to bwForCluster BinAC 2 without restrictions.
If you are outside the BelWü network (e.g. at home), a VPN (virtual private network) connection to your University network must be established first. Please consult the VPN documentation of your University.
|}

'''Prerequisites for successful login:'''

You need to have
* completed the 3-step [[registration/bwForCluster|bwForCluster registration]] procedure.
* [[Registration/Password|set a service password]] for bwForCluster BinAC 2.
* Setup the [[BinAC2/Login#TOTP_Second_Factor|two factor authentication (2FA)]].


= Login to bwForCluster BinAC 2 =

Login to bwForCluster BinAC 2 is only possible with a Secure Shell (SSH) client for which you must know your [[BinAC2/Login#Username|username]] on the cluster and the [[BinAC2/Login#Hostname|hostname]] of the BinAC 2 login node.

For more gneral information on SSH clients, visit the [[Registration/Login/Client|SSH clients Guide]].

== TOTP Second Factor ==

TODO: An neues Verfahren anpassen.

== Username ==

Your <code><username></code> on BinAC 2 consists of a prefix and your local username.
For prefixes please refer to the [[Registration/Login/Username|Username Guide]].

<b>Example</b>: If your local username at your University is <code>ab123</code> and you are a user from Tübingen University, your username on the cluster is: <code>tu_ab123</code>.

== Hostnames ==

BinAC 2 has one login node serving as a load balancer. We use DNS round-robin scheduling to load-balance the incoming connections between the actual three login nodes. If you are logging in multiple times, different sessions might run on different login nodes and hence programs started in one session might not be visible in another sessions. 

{| class="wikitable"
! Hostname !! Destination
|-
| login.binac2.uni-tuebingen.de || one of the three login nodes 
|-
|}

== Login with SSH command (Linux, Mac, Windows) ==

Most Unix and Unix-like operating systems like Linux or MacOS come with a built-in SSH client provided by the OpenSSH project.
Windows 10 and Windows also come with a built-in OpenSSH client. 

For login use one of the following ssh commands:

 ssh <username>@login.binac2.uni-tuebingen.de

To run graphical applications on the cluster, you need to enable X11 forwarding with the <code>-X</code> flag:

 ssh -X <username>@login.binac2.uni-tuebingen.de

== Login with graphical SSH client (Windows) ==

For Windows we suggest using MobaXterm for login and file transfer.
 
Start MobaXterm and fill in the following fields:
<pre>
Remote name              : login.binac2.uni-tuebingen.de
Specify user name        : <username>
Port                     : 22
</pre>

After that click on 'ok'. Then a terminal will open where you can enter your credentials.






<!--

== Login Example ==

To login to bwForCluster BinAC, proceed as follows:
# Login with SSH command or MoabXterm as shown above.
# The system will ask for a one-time password <code>One-time password (OATH) for <username></code>. Please enter your OTP and confirm it with Enter/Return. The OTP is not displayed when typing. If you do not have a second factor yet, please create one (see [BinAC/Login#TOTP_Second_Factor]]).
# The system will ask you for your service password <code>Password:</code>. Please enter it and confirm it with Enter/Return. The password is not displayed when typing. If you do not have a service password yet or have forgotten it, please create one (see [[Registration/Password]]).
# You will be greeted by the cluster, followed by a shell.
<pre>
$ ssh tu_ab123@login01.binac.uni-tuebingen.de
One-time password (OATH) for tu_ab123:
Password: 

Last login: ...

          bwFOR Cluster BinAC, Bioinformatics and Astrophysics 

------------------------------------------------------------------------------

please submit jobs solely with the 'qsub' command. Available queues are
 
    tiny  - 20min     - fast queue for testing (four GPU cores available) 
    short - 48hrs     - serial/parallel jobs
    long  - 7days     - serial/parallel jobs
    gpu   - 30days    - GPU-only jobs  
    smp   - 7days     - large SMP jobs ( memory > 128GB/node ) 

The COMPUTE and GPU nodes provide 28 cores and 128GB of RAM each. In 
addition, every GPU node is equipped with 2 Nvidia K80 accelerator cards, 
totalling in 4 GPUs per node. The SMP machines provide 40 cores per node 
and 1 TB of RAM.

A local SCRATCH directory (/scratch) is available on each node. A fast, 
parallel WORK file system is mounted on /beegfs/work. Please also use the 
workspace tools.

Register to our BinAC mailing list via 
https://listserv.uni-tuebingen.de/mailman/listinfo/binac_announce

------------------------------------------------------------------------------
   Please do not keep data on WORK for a prolonged time. If rarely needed and
   while working on a project, please compress files to an archive. 
------------------------------------------------------------------------------


[tu_ab123@login01 ~]$ 

</pre>

= Allowed Activities on Login Nodes =

{|style="background:#deffee; width:100%;"
|style="padding:5px; background:#cef2e0; text-align:left"|
[[Image:Attention.svg|center|25px]]
|style="padding:5px; background:#cef2e0; text-align:left"|
To guarantee usability for all users you must not run your compute jobs on the login nodes.
Compute jobs must be submitted as batch jobs.
Any compute job running on the login nodes will be terminated without notice.
Long-running compilation or long-running pre- or post-processing tasks must also be submitted as batch jobs.
|}

The login nodes are the access points to the compute system, your <code>$HOME</code> directory and your workspaces.
These nodes are shared with all users. Hence, your activities on the login nodes are primarily limited to setting up your batch jobs.
Your activities may also be:
* quick compilation of program code or
* quick pre- and post-processing of results from batch jobs.

We advise to use interactive batch jobs for compute and memory intensive compilation and pre- and post-processing tasks.

= Related Information =

* If you want to reset your service password, consult the [[Registration/Password|Password Guide]].
* If you want to register a new token for the two factor authentication (2FA), consult [[BinAC/Login#TOTP_Second_Factor|this section]].
* If you want to de-register, consult the [[Registration/Deregistration|De-registration Guide]].
-->