more clariden docs

Author: finkandreas

docs/alps/hardware.md

@@ -21,6 +21,7 @@ This approach to cooling provides greater efficiency for the rack-level cooling,
 * Maximum of 64 quad-blade compute blades
 * Maximum of 64 Slingshot switch blades
 
+[](){#ref-alps-slingshot-network}
 ## Alps High Speed Network
 
 !!! todo

docs/alps/storage.md

@@ -16,16 +16,19 @@ These separate clusters are on the same Slingshot 11 network as the Alps.
 | IOPs         | 1.5M                   | 8.6M read, 24M write   | 200k read, 768k write |
 | file create/s| 374k                   | 214k                   | 97k                 |
 
+[](){#ref-storage-capstor}
 ## capstor
 
 Capstor is the largest file system, for storing large amounts of input and output data.
 It is used to provide SCRATCH and STORE for different clusters - the precise details are platform-specific.
 
+[](){#ref-storage-iopstor}
 ## iopstor
 
 !!! todo
     small text explaining what iopstor is designed to be used for.
 
+[](){#ref-storage-vast}
 ## vast
 
 The Vast storage is smaller capacity system that is designed for use as home folders.

docs/vclusters/clariden.md

@@ -9,17 +9,37 @@
 ## Cluster Specification
 ### Hardware
 Clariden consists of ~1200 [Grace-Hopper nodes][ref-alps-gh200-node]. Most nodes are in the [`normal` slurm partition][ref-slurm-partition-normal], while a few nodes are in the [`debug` partition][ref-slurm-partition-debug].
+The nodes are interconnected with the [slingshot high speed network][ref-alps-slingshot-network].
 
-
-
+As usual the login nodes have direct internet connections, while the compute nodes use a [proxy server][ref-network-proxy-server] to access the internet.
 !!! todo
-    a standardised table with information about
-
-    * number and type of nodes
+    Document proxy and the implications (normally transparent, but git needs modifications
 
-    and any special notes
-
-## Logging into Clariden
+### File systems and storage
+The scratch filesystem is hosted on [IOPStore][ref-storage-iopstor], but also the capacity storage [Capstor][ref-storage-capstor] is mounted at `/capstor/scratch/cscs`.
+The variables `STORE` and `PROJECT` are not set on Clariden.
+!!! todo
+    verify this claim after maintenance window
+The home directory is hosted on [VAST][ref-storage-vast]. As usual, an overview of your quota on the different filesystems can be obtained by the `quota` command.
+
+## Getting started
+### Connect to Clariden
+You can connect to Clariden via [ssh][ref-ssh-config], ensuring that the file `~/.ssh/config` has these settings (replace `cscsusername` with your username).
+
+```title="$HOME/.ssh/config"
+Host ela
+    HostName ela.cscs.ch
+    User cscsusername
+    IdentityFile ~/.ssh/cscs-key
+
+Host clariden
+    HostName clariden.alps.cscs.ch
+    ProxyJump ela
+    User cscsusername
+    IdentityFile ~/.ssh/cscs-key
+    IdentitiesOnly yes
+```
+You can then use `ssh clariden` to login to Clariden.
 
 !!! todo
     how to log in, i.e. `ssh clariden.cscs.ch` via `ela.cscs.ch`