= SAGE/IO-SEA !User/Developer Guide =

== System overview ==

{{{

--- external network --+------------+
                       |            |
                       port 222     port 22 (ssh)
                       |            |
                       v            |
+-------------------------+         |
| sage.zam.kfa-juelich.de |         |
+-------------------------+         |
                                    |
        +---------------------------+
        |
        v
+--------------+
| sage-loginvm |
+--------------+
        |
        |     +----------------+
        +---->| sage-client-gc |
        |     +----------------+
        |
        |     +----------------+
        +---->| sage-server-gc |
        |     +----------------+
        |
        |     +------------------+
        +---->| sage-tier2-[1-4] |
        |     +------------------+
        |
        |     +------------------+
        +---->| sage-tier3-[1-2] |
        |     +------------------+
        |
        |     +------------------+
        +---->| sage-tier4-[1-2] |
        |     +------------------+
        |
        |     +----------------+
        +---->| client-[21-28] |
        |     +----------------+
        |
        |     +------------------+
        +---->| datawarp-[01-04] |
        |     +------------------+
        |
        |     +-----------------+
        +---->| visnode-[01-04] |
              +-----------------+



}}}

== User administration ==

There are two kind of accounts: normal user accounts ({{{<name><number>}}}, e.g. {{{mustermann1}}} and admin accounts ({{{<initial><name>}}}, e.g. {{{gmustermann}}}).

Please use the user accounts preferably to do the benchmarking etc. work which do not require privileges. Use the admin accounts only if your privilege doesn't suffice to do the required work. Please be careful, we trust you know what you're doing.

== Logging in ==

To log into the system, please use

{{{
ssh -l <username> sage.zam.kfa-juelich.de
}}}

This will land you on the {{{sage-loginvm}}}. This is a virtual machine with 4 CPUs and 16 GB of memory. From there, you can use ssh to go to other machines in the cluster.

== Nodes in the system ==

=== server nodes ===

Please find out about the current disk configuration by logging into the nodes and running {{{lsblk}}}.

The list of server nodes is the following:
 * {{{sage-tier2-[1-4]}}}: 128 GB memory, 24 cores (except {{{sage-tier2-3}}} with only 16 cores.
 * {{{sage-tier3-[1-2]}}}: 128 GB memory, 16 cores
 * {{{sage-tier4-[1-2]}}}: 128 GB memory, 16 cores on {{{-1}}}, 24 cores on {{{-2}}}

=== client nodes ===

The list of client nodes is the following:
 * {{{client-[21-28]}}}: 16 GB memory, 8 cores
 * {{{datawarp-[01-04]}}}: 128 GB, 28 cores
 * {{{visnode-[01-04]}}}: 128 GB, 28 cores

== Networks ==

=== Ethernet ===

All nodes are connected via a 1G Ethernet

=== Infiniband ===

Server and client nodes are connect by an infinband fabric