Skip to content

Commit 4aecf6d

Browse files
authored
add documentation for besso (#269)
1 parent 342c928 commit 4aecf6d

File tree

5 files changed

+104
-5
lines changed

5 files changed

+104
-5
lines changed

.github/actions/spelling/allow.txt

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -4,6 +4,7 @@ AMD
44
Alpstein
55
Balfrin
66
Besard
7+
Besso
78
Broyden
89
CFLAGS
910
CHARMM
@@ -121,6 +122,7 @@ artifactory
121122
autodetection
122123
aws
123124
baremetal
125+
besso
124126
biomolecular
125127
blaspp
126128
blt

docs/clusters/besso.md

Lines changed: 80 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,80 @@
1+
[](){#ref-cluster-besso}
2+
# Besso
3+
4+
Besso is a small Alps cluster that provides development resources for porting software for selected customers.
5+
It is provided as is, without the same level of support as the main platform clusters.
6+
7+
### Storage and file systems
8+
9+
Besso uses the [HPCP filesystems and storage policies][ref-hpcp-storage].
10+
11+
## Getting started
12+
13+
### Logging into Besso
14+
15+
To connect to Besso via SSH, first refer to the [ssh guide][ref-ssh].
16+
17+
!!! example "`~/.ssh/config`"
18+
Add the following to your [SSH configuration][ref-ssh-config] to enable you to directly connect to besso using `ssh besso`.
19+
```
20+
Host besso
21+
HostName besso.vc.cscs.ch
22+
ProxyJump ela
23+
User cscsusername
24+
IdentityFile ~/.ssh/cscs-key
25+
IdentitiesOnly yes
26+
```
27+
28+
### Software
29+
30+
[](){#ref-cluster-besso-uenv}
31+
#### uenv
32+
33+
Besso is a development and testing system, for which CSCS does not provide supported applications.
34+
35+
Instead, the [prgenv-gnu][ref-uenv-prgenv-gnu] programming environment is provided for the both the [a100][ref-alps-a100-node] and [mi200][ref-alps-mi200-node] node types.
36+
37+
[](){#ref-cluster-besso-containers}
38+
#### Containers
39+
40+
Besso supports container workloads using the [Container Engine][ref-container-engine].
41+
42+
To build images, see the [guide to building container images on Alps][ref-build-containers].
43+
44+
#### Cray Modules
45+
46+
!!! warning
47+
The Cray Programming Environment (CPE), loaded using `module load cray`, is no longer supported by CSCS.
48+
49+
CSCS will continue to support and update uenv and the Container Engine, and users are encouraged to update their workflows to use these methods at the first opportunity.
50+
51+
The CPE is still installed on Besso, however it will receive no support or updates, and will be [replaced with a container][ref-cpe] in a future update.
52+
53+
## Running jobs on Besso
54+
55+
### Slurm
56+
57+
Besso uses [Slurm][ref-slurm] as the workload manager, which is used to launch and monitor workloads on compute nodes.
58+
59+
There are multiple [Slurm partitions][ref-slurm-partitions] on the system:
60+
61+
* the `a100` partition contains [NVIDIA A100 GPU][ref-alps-a100-node] nodes
62+
* the `mi200` partition contains [AMD Mi250x GPU][ref-alps-mi200-node] nodes
63+
* the `normal` partition contains all of the nodes in the system.
64+
65+
| name | max nodes per job | time limit |
66+
| -- | -- | -- |
67+
| `a100` | 2 | 24 hours |
68+
| `mi200` | 2 | 24 hours |
69+
| `normal` | 4 | 24 hours |
70+
71+
See the Slurm documentation for instructions on how to [run jobs][ref-slurm].
72+
73+
### FirecREST
74+
75+
!!! under-construction
76+
Besso will have support for [FirecREST][ref-firecrest] access.
77+
78+
## Maintenance and status
79+
80+
There is no regular scheduled maintenance for this system.

docs/alps/clusters.md renamed to docs/clusters/index.md

Lines changed: 10 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -43,4 +43,14 @@ The following clusters are part of the platforms that are fully operated by CSCS
4343
[:octicons-arrow-right-24: Santis][ref-cluster-santis]
4444
</div>
4545

46+
## Other systems
47+
48+
<div class="grid cards" markdown>
49+
- :fontawesome-solid-mountain: __Porting and Development__
50+
51+
Besso is a small system used by some partners for development and porting with AMD and NVIDIA GPUs.
52+
53+
[:octicons-arrow-right-24: Besso][ref-cluster-besso]
54+
</div>
55+
4656

docs/index.md

Lines changed: 4 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -30,15 +30,15 @@ Find out more about Alps...
3030

3131
Learn more about the Alps research infrastructure
3232

33-
[:octicons-arrow-right-24: Alps Overview](alps/index.md)
33+
[:octicons-arrow-right-24: Alps Overview][ref-alps]
3434

3535
Get detailed information about the main components of the infrastructure
3636

37-
[:octicons-arrow-right-24: Alps Clusters](alps/clusters.md)
37+
[:octicons-arrow-right-24: Alps Clusters][ref-alps-clusters]
3838

39-
[:octicons-arrow-right-24: Alps Hardware](alps/hardware.md)
39+
[:octicons-arrow-right-24: Alps Hardware][ref-alps-hardware]
4040

41-
[:octicons-arrow-right-24: Alps Storage](alps/storage.md)
41+
[:octicons-arrow-right-24: Alps Storage][ref-alps-storage]
4242

4343
- :fontawesome-solid-key: __Logging In__
4444

mkdocs.yml

Lines changed: 8 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -17,7 +17,14 @@ nav:
1717
- 'Alps':
1818
- alps/index.md
1919
- 'Platforms': alps/platforms.md
20-
- 'Clusters': alps/clusters.md
20+
- 'Clusters':
21+
- clusters/index.md
22+
- 'Besso': clusters/besso.md
23+
- 'Bristen': clusters/bristen.md
24+
- 'Clariden': clusters/clariden.md
25+
- 'Daint': clusters/daint.md
26+
- 'Eiger': clusters/eiger.md
27+
- 'Santis': clusters/santis.md
2128
- 'Hardware': alps/hardware.md
2229
- 'Storage': alps/storage.md
2330
- 'Machine Learning Platform':

0 commit comments

Comments
 (0)