diff --git a/docs/access/index.md b/docs/access/index.md index 9b6eaf5b..49d75503 100644 --- a/docs/access/index.md +++ b/docs/access/index.md @@ -2,20 +2,28 @@ This documentation guides users through the process of accessing CSCS systems and services. -!!! info +!!! note "" Before accessing CSCS, you need to have an account at CSCS, and be part of a project that has been allocated resources. More information on how to get an account is available in [accounts and projects][account-management]. +
-There are different ways to authenticate your identity in order to access services at CSCS, using a password set by the user. Currently users can be authenticated with: +- :fontawesome-solid-layer-group: __Multi Factor Authentification__ -* Classic ssh with CSCS username/password, and also with ssh-keys -* CSCS username/password on different web services. Sessions can be independent from each other so, signing into one service does not necessarily sign the user into another one -* CSCS username/password on a Single Sign-On gate, which once the user is authenticated, can move between services (connected to this gate) without signing in again -* Username/password from an external institution, provided that his/her CSCS account has been "linked" to that external identity beforehand and the service uses the Single Sign-On gate + Before signing in to CSCS' web portals or using SSH, all users have to set up multi factor authentification (MFA) -## Single Sign-On + [:octicons-arrow-right-24: MFA][mfa] -Most services at CSCS are connected to the CSCS Single Sign-On gate. -This gives users the comfort of not having to sign in multiple times in each individual service connected to this gate and increases security. -Furthermore, the Single Sign-On gate allow users to recover their forgotten passwords and authenticate using a third-party account. The login page looks like +- :fontawesome-solid-layer-group: __Web Services__ + + Before signing in to CSCS' web portals or using SSH, all users have to set up multi factor authentification (MFA) + + [:octicons-arrow-right-24: Accessing CSCS web services][access-web] + +- :fontawesome-solid-layer-group: __SSH Access__ + + Logging into Clusters on Alps + + [:octicons-arrow-right-24: SSH][access-ssh] + +
diff --git a/docs/access/ssh.md b/docs/access/ssh.md index 0d5ef8ca..dd695db1 100644 --- a/docs/access/ssh.md +++ b/docs/access/ssh.md @@ -1,4 +1,4 @@ -[](){#ssh} +[](){#access-ssh} # Using SSH Before accessing CSCS clusters using SSH, first ensure that you have [created a user account][account-management] that is part of a project that has access to the cluster, and have [multi factor authentification][mfa] configured. diff --git a/docs/access/web.md b/docs/access/web.md index c2146ddf..d71ddd93 100644 --- a/docs/access/web.md +++ b/docs/access/web.md @@ -1,3 +1,4 @@ +[](){#access-web} # Accessing CSCS Web Portals Most services at CSCS are connected to the CSCS Single Sign-On gate. diff --git a/docs/alps/network.md b/docs/alps/network.md deleted file mode 100644 index 568c7165..00000000 --- a/docs/alps/network.md +++ /dev/null @@ -1,11 +0,0 @@ -# Alps High Speed Network - -!!! todo - information about the network. - - * Details about SlingShot 11. - * how many NICS per node - * raw feeds and speeds - * Some OSU benchmark results. - * GPU-aware communication - * **slingshot is not infiniband - there is no NVSwitch** diff --git a/docs/index.md b/docs/index.md index b7d01c5f..76399408 100644 --- a/docs/index.md +++ b/docs/index.md @@ -1,6 +1,30 @@ # CSCS Documentation -Welcome to the techincal documentation for Alps. +Start here to get access to CSCS services and Alps + +
+ +- :fontawesome-solid-layer-group: __Accounts and Projects__ + + The first step is to get an account and a project + + [:octicons-arrow-right-24: Accounts and Projects][account-management] + +- :fontawesome-solid-key: __Logging In__ + + Once you have an account, you can set up multi factor authentification + + [:octicons-arrow-right-24: Setting up MFA][mfa] + + Then access CSCS services + + [:octicons-arrow-right-24: Accessing CSCS Web Services][access-web] + + [:octicons-arrow-right-24: Using SSH][access-ssh] + +
+ +The Alps Research infrastructure hosts multiple platforms and clusters targeting different communities
@@ -16,7 +40,7 @@ Welcome to the techincal documentation for Alps. [:octicons-arrow-right-24: Machine Learning Platform][mlp] - [:octicons-arrow-right-24: Climate and weather Platform][cwp] + [:octicons-arrow-right-24: Climate and Weather Platform][cwp] - :fontawesome-solid-mountain-sun: __Alps__ @@ -28,27 +52,8 @@ Welcome to the techincal documentation for Alps. [:octicons-arrow-right-24: Alps Hardware](alps/hardware.md) - [:octicons-arrow-right-24: Alps Network](alps/network.md) - [:octicons-arrow-right-24: Alps Storage](alps/storage.md) - -- :fontawesome-solid-key: __Getting Access__ - - A project is required to access resources on Alps - - [:octicons-arrow-right-24: Applying for an Alps project](https://www.cscs.ch/user-lab/applying-for-accounts) - - CSCS uses multifactor authentification for secure connection to our services and systems - - [:octicons-arrow-right-24: Setting up MFA][mfa] - - [:octicons-arrow-right-24: Logging into vClusters][ssh] - - Manage your project and team in the user management portal - - [:octicons-arrow-right-24: User management portal][ump] -
## Get in Touch @@ -71,7 +76,7 @@ If you can't find the information that you need in the documentation, help is av -# Tools and Services +## Tools and Services !!! todo Provide some links to the "how" documentation here.