From b5d2bc259cbd44191b53290db5e887a604018819 Mon Sep 17 00:00:00 2001 From: Joona Tolonen Date: Thu, 20 Nov 2025 15:14:09 +0200 Subject: [PATCH 01/15] Initial version of the CSC services for courses page --- docs/support/tutorials/index.md | 1 + .../support/tutorials/services-for-courses.md | 79 +++++++++++++++++++ 2 files changed, 80 insertions(+) create mode 100644 docs/support/tutorials/services-for-courses.md diff --git a/docs/support/tutorials/index.md b/docs/support/tutorials/index.md index a94ac9f7aa..250d0c4557 100644 --- a/docs/support/tutorials/index.md +++ b/docs/support/tutorials/index.md @@ -107,5 +107,6 @@ You can find Rahti tutorials in [Cloud Services > Rahti > Tutorials](../../cloud ## CSC Resources for Courses +* [CSC Services for courses](services-for-courses.md) * [A Puhti webinterface demo for course organizers](https://github.com/CSCfi/Jupyter_www_puhti) * [Noppe environment for creating custom notebooks](../../cloud/noppe/guide_for_teachers.md#creating-custom-images) diff --git a/docs/support/tutorials/services-for-courses.md b/docs/support/tutorials/services-for-courses.md new file mode 100644 index 0000000000..e4ec2adf87 --- /dev/null +++ b/docs/support/tutorials/services-for-courses.md @@ -0,0 +1,79 @@ +# CSC Services for Courses + +This guide will explain how to use the course project type with CSC's +high-performance computing (HPC) and cloud services. + +## Prerequisites + +Staff members from higher education institutions and state research institutes can create a MyCSC course project. What you will need is: + + 1. [A CSC account](../../accounts/how-to-create-new-user-account.md) + 2. [A MyCSC course project](../../accounts/how-to-create-new-project.md) + 3. [A Service activated](../../accounts/how-to-add-service-access-for-project.md) + +## Available services + +The following services are available to support you in delivering your course. All services except Noppe require an active MyCSC project with the relevant service enabled. Applying for more quota depends on the services; see the details below. The medium (M) billing unit package is the default package granted for course projects. This should cover most use cases. + +The services are listed in alphabetical order. + +### Allas + +### cPouta + +### Mahti and Puhti (HPC) + +!!! info "Next HPC: Roihu" + + CSC's next national supercomputer Roihu, a BullSequana XH3000 hybrid system, will replace the Puhti and Mahti supercomputers. More information about [Roihu](../../computing/systems-roihu.md). + +Courses using the HPC should have fewer than 50 people. To ensure students have access to the necessary resources, reservations should be made well in advance (i.e. several weeks beforehand) to guarantee capacity during practical sessions. Reservations allocate supercomputer nodes to your project, meaning that only course's students can use them. This ensures reasonable queuing times, even if the system is in heavy use. + +Please note that reservation requests may be declined, so it is good practice to request one when planning the course. If students are completing the course independently over a longer period, they can use the standard queuing system and its limits. In that case, it is your project's BUs that provide guidance on reasonable resource usage. + +HPCs have guidance on reservations in two categories: Typical and maximum possible. Please note that these requests may be denied or reduced, as with any other resource request at CSC. In practice, requests at the maximum level should only be made for major or high-priority events. Only request the needed resources, and provide an explanation as to why you require them (you may require less than the amounts specified below). + +#### Puhti + +*Typical reservation* + +- Each day: + - CPU: A dedicated reservation can include a maximum of two regular nodes (2 x 40 cores and 2 x 192 GB). + - Reservations are valid from 08:00 to 17:00 at most. +- A maximum of five days in total. + +*Maximum reservation* + +- Each day: + - CPU: A dedicated reservation can include a maximum of five regular nodes (200 cores). + - GPU: A dedicated reservation can include a maximum of four GPU nodes. + - The reservation is valid for a maximum of 12 hours per day. Timeslots can be requested (e.g. 08:00–20:00 or 12:00–24:00). +- A maximum of ten days in total. + +#### Mahti + +*Typical reservation* + +- Each day: + - CPU: A dedicated reservation can include a maximum of two regular M-nodes (2x128 cores and 2x256 GB). + - GPU: A dedicated reservation can include a maximum of 14 [GPU slices](../../computing/running/batch-job-partitions.md#gpu-slices) (1 node). + - Reservations are valid from 08:00 to 17:00 +- Maximum total of five days. + +*Maximum reservation* + +- Each day: + - CPU: A dedicated reservation can include a maximum of eight regular M-nodes (8 x 128 cores and 8 x 256 GB). + - GPU: A dedicated reservation can include a maximum of 28 [GPU slices](../../computing/running/batch-job-partitions.md#gpu-slices) (1 node). + - Reservations are valid for a maximum of 12 hours per day and can be requested in time slots (e.g. 08:00–20:00 or 12:00–24:00). +- Maximum total of ten days. + +### Noppe + +### Pukki DBaaS + +### Rahti + +### SD Desktop + + From 5c8dfe26fb332f05f1b25deef510478d24a392df Mon Sep 17 00:00:00 2001 From: Joona Tolonen Date: Thu, 20 Nov 2025 16:34:36 +0200 Subject: [PATCH 02/15] Added an alternative table format of the restrictions. --- docs/support/tutorials/services-for-courses.md | 11 +++++++++++ 1 file changed, 11 insertions(+) diff --git a/docs/support/tutorials/services-for-courses.md b/docs/support/tutorials/services-for-courses.md index e4ec2adf87..7c8a069464 100644 --- a/docs/support/tutorials/services-for-courses.md +++ b/docs/support/tutorials/services-for-courses.md @@ -33,6 +33,8 @@ Please note that reservation requests may be declined, so it is good practice to HPCs have guidance on reservations in two categories: Typical and maximum possible. Please note that these requests may be denied or reduced, as with any other resource request at CSC. In practice, requests at the maximum level should only be made for major or high-priority events. Only request the needed resources, and provide an explanation as to why you require them (you may require less than the amounts specified below). +_Alternative text view (table view below):_ + #### Puhti *Typical reservation* @@ -68,6 +70,15 @@ HPCs have guidance on reservations in two categories: Typical and maximum possib - Reservations are valid for a maximum of 12 hours per day and can be requested in time slots (e.g. 08:00–20:00 or 12:00–24:00). - Maximum total of ten days. +_Alternative table view:_ + +| System | Reservation Type | CPU Limit | Memory per Node | GPU Limit | Daily Time Window | Max Total Days | +|--------|------------------|-----------|------------------|-----------|--------------------|----------------| +| Puhti | Typical | 2 nodes (2×40 cores) | 192 GB | – | 08:00–17:00 | 5 | +| | Maximum | 5 nodes (200 cores) | 192 GB | 4 GPU nodes | Up to 12 hrs (e.g., 08:00–20:00 or 12:00–24:00) | 10 | +| Mahti | Typical | 2 M-nodes (2×128 cores) | 256 GB | 14 GPU slices (1 node) | 08:00–17:00 | 5 | +| | Maximum | 8 M-nodes (8×128 cores) | 256 GB | 28 GPU slices (1 node) | Up to 12 hrs (e.g., 08:00–20:00 or 12:00–24:00) | 10 | + ### Noppe ### Pukki DBaaS From 1cc4e2c42abeb16b8817f1654fcac399d7e4d6f2 Mon Sep 17 00:00:00 2001 From: Joona Tolonen Date: Fri, 5 Dec 2025 08:54:30 +0200 Subject: [PATCH 03/15] Changed text into a table. Added link to the documentation main page. --- .../support/tutorials/services-for-courses.md | 47 ++----------------- 1 file changed, 3 insertions(+), 44 deletions(-) diff --git a/docs/support/tutorials/services-for-courses.md b/docs/support/tutorials/services-for-courses.md index 7c8a069464..0efb3d81fd 100644 --- a/docs/support/tutorials/services-for-courses.md +++ b/docs/support/tutorials/services-for-courses.md @@ -27,50 +27,7 @@ The services are listed in alphabetical order. CSC's next national supercomputer Roihu, a BullSequana XH3000 hybrid system, will replace the Puhti and Mahti supercomputers. More information about [Roihu](../../computing/systems-roihu.md). -Courses using the HPC should have fewer than 50 people. To ensure students have access to the necessary resources, reservations should be made well in advance (i.e. several weeks beforehand) to guarantee capacity during practical sessions. Reservations allocate supercomputer nodes to your project, meaning that only course's students can use them. This ensures reasonable queuing times, even if the system is in heavy use. - -Please note that reservation requests may be declined, so it is good practice to request one when planning the course. If students are completing the course independently over a longer period, they can use the standard queuing system and its limits. In that case, it is your project's BUs that provide guidance on reasonable resource usage. - -HPCs have guidance on reservations in two categories: Typical and maximum possible. Please note that these requests may be denied or reduced, as with any other resource request at CSC. In practice, requests at the maximum level should only be made for major or high-priority events. Only request the needed resources, and provide an explanation as to why you require them (you may require less than the amounts specified below). - -_Alternative text view (table view below):_ - -#### Puhti - -*Typical reservation* - -- Each day: - - CPU: A dedicated reservation can include a maximum of two regular nodes (2 x 40 cores and 2 x 192 GB). - - Reservations are valid from 08:00 to 17:00 at most. -- A maximum of five days in total. - -*Maximum reservation* - -- Each day: - - CPU: A dedicated reservation can include a maximum of five regular nodes (200 cores). - - GPU: A dedicated reservation can include a maximum of four GPU nodes. - - The reservation is valid for a maximum of 12 hours per day. Timeslots can be requested (e.g. 08:00–20:00 or 12:00–24:00). -- A maximum of ten days in total. - -#### Mahti - -*Typical reservation* - -- Each day: - - CPU: A dedicated reservation can include a maximum of two regular M-nodes (2x128 cores and 2x256 GB). - - GPU: A dedicated reservation can include a maximum of 14 [GPU slices](../../computing/running/batch-job-partitions.md#gpu-slices) (1 node). - - Reservations are valid from 08:00 to 17:00 -- Maximum total of five days. - -*Maximum reservation* - -- Each day: - - CPU: A dedicated reservation can include a maximum of eight regular M-nodes (8 x 128 cores and 8 x 256 GB). - - GPU: A dedicated reservation can include a maximum of 28 [GPU slices](../../computing/running/batch-job-partitions.md#gpu-slices) (1 node). - - Reservations are valid for a maximum of 12 hours per day and can be requested in time slots (e.g. 08:00–20:00 or 12:00–24:00). -- Maximum total of ten days. - -_Alternative table view:_ +The guidelines for booking Puhti and Mahti services for a course are given below. | System | Reservation Type | CPU Limit | Memory per Node | GPU Limit | Daily Time Window | Max Total Days | |--------|------------------|-----------|------------------|-----------|--------------------|----------------| @@ -79,6 +36,8 @@ _Alternative table view:_ | Mahti | Typical | 2 M-nodes (2×128 cores) | 256 GB | 14 GPU slices (1 node) | 08:00–17:00 | 5 | | | Maximum | 8 M-nodes (8×128 cores) | 256 GB | 28 GPU slices (1 node) | Up to 12 hrs (e.g., 08:00–20:00 or 12:00–24:00) | 10 | +You can find the services' documentation here: [Computing](../../computing/index.md). + ### Noppe ### Pukki DBaaS From 279afc242f2cd4dbd3359a7dd02a2fbc23a57eaf Mon Sep 17 00:00:00 2001 From: Joona Tolonen Date: Fri, 5 Dec 2025 15:24:46 +0200 Subject: [PATCH 04/15] Version 2 of HPC section, combined content from PR #2658 --- .../support/tutorials/services-for-courses.md | 42 +++++++++++++++---- 1 file changed, 35 insertions(+), 7 deletions(-) diff --git a/docs/support/tutorials/services-for-courses.md b/docs/support/tutorials/services-for-courses.md index 0efb3d81fd..20ed6911d5 100644 --- a/docs/support/tutorials/services-for-courses.md +++ b/docs/support/tutorials/services-for-courses.md @@ -3,17 +3,26 @@ This guide will explain how to use the course project type with CSC's high-performance computing (HPC) and cloud services. -## Prerequisites +Staff members from higher education institutions and state research +institutes can create a MyCSC course project. The procedure is as follows: -Staff members from higher education institutions and state research institutes can create a MyCSC course project. What you will need is: + 1. Have a [CSC account](../../accounts/how-to-create-new-user-account.md) + 2. Create a [MyCSC course project](../../accounts/how-to-create-new-project.md) + 3. Activate wanted [service](../../accounts/how-to-add-service-access-for-project.md) - 1. [A CSC account](../../accounts/how-to-create-new-user-account.md) - 2. [A MyCSC course project](../../accounts/how-to-create-new-project.md) - 3. [A Service activated](../../accounts/how-to-add-service-access-for-project.md) +!!! tip "Noppe" + You don't need a MyCSC project to use the Noppe service. + [Who and how can Noppe be used?](../../cloud/noppe/index.md#who-and-how-can-noppe-be-used) ## Available services -The following services are available to support you in delivering your course. All services except Noppe require an active MyCSC project with the relevant service enabled. Applying for more quota depends on the services; see the details below. The medium (M) billing unit package is the default package granted for course projects. This should cover most use cases. +The following services are available to support you in delivering your course. +All services except Noppe require an active MyCSC project with the relevant +service enabled. + +Applying for more quota depends on the services; see the +details below. The medium (M) billing unit package is the default package +granted for course projects. This should cover most use cases. The services are listed in alphabetical order. @@ -25,7 +34,26 @@ The services are listed in alphabetical order. !!! info "Next HPC: Roihu" - CSC's next national supercomputer Roihu, a BullSequana XH3000 hybrid system, will replace the Puhti and Mahti supercomputers. More information about [Roihu](../../computing/systems-roihu.md). + CSC's next national supercomputer Roihu, a BullSequana XH3000 hybrid system, + will replace the Puhti and Mahti supercomputers. More information about + [Roihu](../../computing/systems-roihu.md). + + +The course project can host a maximum of 50 students at a time. Please note that +course projects are subject to the same Slurm job priority policies as regular +computing projects, meaning that course participants may need to queue for resources +if the system is under heavy use. + +To ensure the availability of resources at the time of the course session(s) +and thus avoid queuing, an _advance resource reservation_ may be requested for +the course. In this case, please +[contact CSC Service Desk](../../support/contact.md) **at least 14 days beforehand**. + +The request should be motivated and include: + +1. the number of participants, +2. the resources planned for the course, +3. and a timetable showing the schedule of the course. The guidelines for booking Puhti and Mahti services for a course are given below. From c720b2b88a9421691109c4b0fc5e5c0790485826 Mon Sep 17 00:00:00 2001 From: Sebastian von Alfthan Date: Fri, 5 Dec 2025 16:06:37 +0200 Subject: [PATCH 05/15] Updates to HPC and introduction Updated the guide to clarify the use of CSC's HPC services, and updates to introduction --- docs/support/tutorials/services-for-courses.md | 16 +++++++++------- 1 file changed, 9 insertions(+), 7 deletions(-) diff --git a/docs/support/tutorials/services-for-courses.md b/docs/support/tutorials/services-for-courses.md index 20ed6911d5..770266155e 100644 --- a/docs/support/tutorials/services-for-courses.md +++ b/docs/support/tutorials/services-for-courses.md @@ -1,7 +1,9 @@ # CSC Services for Courses -This guide will explain how to use the course project type with CSC's -high-performance computing (HPC) and cloud services. +This guide will explain how to use CSC's high-performance computing (HPC) and cloud services when +arranging courses, and provide advice for selecting the right service. + +With the exception of Noppe, all other services require you to use a course project type to provide access and resources for your students. To use the Noppe service, you don't need any MyCSC project, or even a CSC user account. [By whom and how can Noppe be used?](../../cloud/noppe/index.md#who-and-how-can-noppe-be-used) Staff members from higher education institutions and state research institutes can create a MyCSC course project. The procedure is as follows: @@ -10,9 +12,6 @@ institutes can create a MyCSC course project. The procedure is as follows: 2. Create a [MyCSC course project](../../accounts/how-to-create-new-project.md) 3. Activate wanted [service](../../accounts/how-to-add-service-access-for-project.md) -!!! tip "Noppe" - You don't need a MyCSC project to use the Noppe service. - [Who and how can Noppe be used?](../../cloud/noppe/index.md#who-and-how-can-noppe-be-used) ## Available services @@ -38,9 +37,12 @@ The services are listed in alphabetical order. will replace the Puhti and Mahti supercomputers. More information about [Roihu](../../computing/systems-roihu.md). +Mahti and Puhti are ideal platforms for smaller courses with typically less than 50 participants who benefit from the characteristics of the platforms. This +includes cases where the course participants need access to GPUs or larger CPU resources, and cases where the existing +software stack is used for the course assignments. The systems support both traditional batch processing compute tasks, +as well as web-based tools such as Jupyter notebooks and RStudio via the [web interface](../../computing/webinterface/index.md). Course organizers are even able to create customized Jupyter notebook environments for their course in the [Jupyter for courses](../../computing/webinterface/jupyter-for-courses.md) app. -The course project can host a maximum of 50 students at a time. Please note that -course projects are subject to the same Slurm job priority policies as regular +Please note that course projects are subject to the same Slurm job priority policies as regular computing projects, meaning that course participants may need to queue for resources if the system is under heavy use. From def481d63d8fdbfaed72f3c3e98fe19bee9fd2d7 Mon Sep 17 00:00:00 2001 From: Sebastian von Alfthan Date: Fri, 5 Dec 2025 16:16:15 +0200 Subject: [PATCH 06/15] Document service breaks for maintenance Added a note about service breaks for maintenance. --- docs/support/tutorials/services-for-courses.md | 6 ++++++ 1 file changed, 6 insertions(+) diff --git a/docs/support/tutorials/services-for-courses.md b/docs/support/tutorials/services-for-courses.md index 770266155e..6ebd1597c2 100644 --- a/docs/support/tutorials/services-for-courses.md +++ b/docs/support/tutorials/services-for-courses.md @@ -42,6 +42,12 @@ includes cases where the course participants need access to GPUs or larger CPU r software stack is used for the course assignments. The systems support both traditional batch processing compute tasks, as well as web-based tools such as Jupyter notebooks and RStudio via the [web interface](../../computing/webinterface/index.md). Course organizers are even able to create customized Jupyter notebook environments for their course in the [Jupyter for courses](../../computing/webinterface/jupyter-for-courses.md) app. +!!! info "Service breaks" + + Please note that the first Tuesday and Wednesday each month are reserved for regular maintenance breaks. You should never rely on the services being available on those days. + + + Please note that course projects are subject to the same Slurm job priority policies as regular computing projects, meaning that course participants may need to queue for resources if the system is under heavy use. From 7af225ee6a5becd6c4734a3152fa0b9aa9299299 Mon Sep 17 00:00:00 2001 From: Rasmus Kronberg Date: Mon, 8 Dec 2025 11:11:02 +0200 Subject: [PATCH 07/15] restructure a bit --- .../support/tutorials/services-for-courses.md | 177 +++++++++--------- 1 file changed, 92 insertions(+), 85 deletions(-) diff --git a/docs/support/tutorials/services-for-courses.md b/docs/support/tutorials/services-for-courses.md index 6ebd1597c2..e3982d5459 100644 --- a/docs/support/tutorials/services-for-courses.md +++ b/docs/support/tutorials/services-for-courses.md @@ -1,85 +1,92 @@ -# CSC Services for Courses - -This guide will explain how to use CSC's high-performance computing (HPC) and cloud services when -arranging courses, and provide advice for selecting the right service. - -With the exception of Noppe, all other services require you to use a course project type to provide access and resources for your students. To use the Noppe service, you don't need any MyCSC project, or even a CSC user account. [By whom and how can Noppe be used?](../../cloud/noppe/index.md#who-and-how-can-noppe-be-used) - -Staff members from higher education institutions and state research -institutes can create a MyCSC course project. The procedure is as follows: - - 1. Have a [CSC account](../../accounts/how-to-create-new-user-account.md) - 2. Create a [MyCSC course project](../../accounts/how-to-create-new-project.md) - 3. Activate wanted [service](../../accounts/how-to-add-service-access-for-project.md) - - -## Available services - -The following services are available to support you in delivering your course. -All services except Noppe require an active MyCSC project with the relevant -service enabled. - -Applying for more quota depends on the services; see the -details below. The medium (M) billing unit package is the default package -granted for course projects. This should cover most use cases. - -The services are listed in alphabetical order. - -### Allas - -### cPouta - -### Mahti and Puhti (HPC) - -!!! info "Next HPC: Roihu" - - CSC's next national supercomputer Roihu, a BullSequana XH3000 hybrid system, - will replace the Puhti and Mahti supercomputers. More information about - [Roihu](../../computing/systems-roihu.md). - -Mahti and Puhti are ideal platforms for smaller courses with typically less than 50 participants who benefit from the characteristics of the platforms. This -includes cases where the course participants need access to GPUs or larger CPU resources, and cases where the existing -software stack is used for the course assignments. The systems support both traditional batch processing compute tasks, -as well as web-based tools such as Jupyter notebooks and RStudio via the [web interface](../../computing/webinterface/index.md). Course organizers are even able to create customized Jupyter notebook environments for their course in the [Jupyter for courses](../../computing/webinterface/jupyter-for-courses.md) app. - -!!! info "Service breaks" - - Please note that the first Tuesday and Wednesday each month are reserved for regular maintenance breaks. You should never rely on the services being available on those days. - - - -Please note that course projects are subject to the same Slurm job priority policies as regular -computing projects, meaning that course participants may need to queue for resources -if the system is under heavy use. - -To ensure the availability of resources at the time of the course session(s) -and thus avoid queuing, an _advance resource reservation_ may be requested for -the course. In this case, please -[contact CSC Service Desk](../../support/contact.md) **at least 14 days beforehand**. - -The request should be motivated and include: - -1. the number of participants, -2. the resources planned for the course, -3. and a timetable showing the schedule of the course. - -The guidelines for booking Puhti and Mahti services for a course are given below. - -| System | Reservation Type | CPU Limit | Memory per Node | GPU Limit | Daily Time Window | Max Total Days | -|--------|------------------|-----------|------------------|-----------|--------------------|----------------| -| Puhti | Typical | 2 nodes (2×40 cores) | 192 GB | – | 08:00–17:00 | 5 | -| | Maximum | 5 nodes (200 cores) | 192 GB | 4 GPU nodes | Up to 12 hrs (e.g., 08:00–20:00 or 12:00–24:00) | 10 | -| Mahti | Typical | 2 M-nodes (2×128 cores) | 256 GB | 14 GPU slices (1 node) | 08:00–17:00 | 5 | -| | Maximum | 8 M-nodes (8×128 cores) | 256 GB | 28 GPU slices (1 node) | Up to 12 hrs (e.g., 08:00–20:00 or 12:00–24:00) | 10 | - -You can find the services' documentation here: [Computing](../../computing/index.md). - -### Noppe - -### Pukki DBaaS - -### Rahti - -### SD Desktop - - +# Using CSC services for courses + +CSC services can be used for educational purposes in accordance with our +[free-of-charge use policy](https://research.csc.fi/free-of-charge-use/). This +guide outlines how to organize a course using [Noppe](#noppe) and +[CSC supercomputers Puhti and Mahti](#puhti-and-mahti), including advice on how +to select the right service for your needs. + +## Noppe + +### Instructions + +#### Teacher + +#### Student + +## Puhti and Mahti + +!!! info "Puhti and Mahti will be retired in 2026" + Puhti and Mahti will be decommissioned in 2026 and replaced by Roihu, CSC's + next-generation supercomputer offering enhanced performance and + capabilities. Please take this into account when planning courses for 2026. + + [Learn more about Roihu :material-arrow-right:](../../computing/systems-roihu.md) + +### Overview + +CSC supercomputers Mahti and Puhti are ideal platforms for organizing courses +that benefit from HPC resources or aim to teach how to use and run computations +on supercomputing platforms. This includes cases where the course participants +need access to GPUs or larger CPU resources, and cases where the existing +software stack is used for the course assignments. + +The systems support both traditional command-line +[batch processing compute tasks](../../computing/running/getting-started.md), as well as +web-based tools such as Jupyter Notebooks and RStudio via the +[web interfaces](../../computing/webinterface/index.md). Course organizers are +even able to create customized Jupyter Notebook environments for their course +using the +[Jupyter for Courses](../../computing/webinterface/jupyter-for-courses.md) app. + +Please note that courses using CSC supercomputers can have **at maximum 50 +students**. Ideally, teachers should target a smaller number of around 25 +participants. For larger courses the free resources and allowed resource +reservations may not support the requested amount of users. + +!!! warning "Service breaks" + Please note that the first Tuesday and Wednesday of each month are reserved + for regular maintenance breaks. You should never rely on the services being + available on those days. + +### Prerequisites + +#### Teacher + +1. [Create a CSC user account](../../accounts/how-to-create-new-user-account.md). +2. [Create a CSC Course project](../../accounts/how-to-create-new-project.md#course). +3. [Add Puhti and/or Mahti service access to the project](../../accounts/how-to-add-service-access-for-project.md). +4. Invite students to the project either by + * [using an invitation link](../../accounts/how-to-add-members-to-project.md#using-invitation-link) (recommended) + * [or directly](../../accounts/how-to-add-members-to-project.md#adding-members-directly). + +#### Student + +1. [Create a CSC user account](../../accounts/how-to-create-new-user-account.md). +2. Join the course project: + 1. If you've been sent a project invitation link, [accept the invitation in MyCSC](../../accounts/how-to-add-members-to-project.md#member). + 2. If you've been added directly to the course project, no actions are required. + +### Advance resource reservation + +Course projects are subject to the same Slurm job priority policies as regular +computing projects, meaning that **course participants may need to queue for +resources** if the system is under heavy use. To ensure the availability of +resources at the time of the course session(s), we recommend requesting for an +_advance resource reservation_. + +* The resource reservation must be requested **at least 14 days** before + the start of the course via [CSC Service Desk](../contact.md). +* The request should be motivated and include + 1. the number of participants, + 2. the resources planned for the course, + 3. timetable showing the schedule of the course. +* The maximum amount and type of reservable resources are outlined in the + table below. + + | System | Approval | CPU limit | GPU limit | Max. daily time window | Max. course days in total | + |--------|------------------|-------------------|-----------|--------------------|----------------| + | Puhti | Automatic | 2 nodes (80 cores) | 0 | 08:00–17:00 | 5 | + | | CSC Resource Allocation Group | 5 nodes (200 cores) | 4 nodes (16 GPUs) | Up to 12 hrs (e.g., 08:00–20:00 or 12:00–24:00) | 10 | + | Mahti | Automatic | 2 nodes (256 cores) | 14 [GPU slices](../../computing/running/batch-job-partitions.md#gpu-slices) | 08:00–17:00 | 5 | + | | CSC Resource Allocation Group | 8 nodes (1024 cores) | 56 [GPU slices](../../computing/running/batch-job-partitions.md#gpu-slices) | Up to 12 hrs (e.g., 08:00–20:00 or 12:00–24:00) | 10 | From c4c497696d632ab3fd021e3c8c9be35fd34c3526 Mon Sep 17 00:00:00 2001 From: Rasmus Kronberg Date: Mon, 8 Dec 2025 12:32:42 +0200 Subject: [PATCH 08/15] suggestion for hpc content --- docs/support/tutorials/index.md | 12 +-- .../support/tutorials/services-for-courses.md | 86 ++++++++++++++++--- 2 files changed, 79 insertions(+), 19 deletions(-) diff --git a/docs/support/tutorials/index.md b/docs/support/tutorials/index.md index 250d0c4557..b4a49e85c0 100644 --- a/docs/support/tutorials/index.md +++ b/docs/support/tutorials/index.md @@ -33,6 +33,12 @@ * [Running Nextflow pipelines](nextflow-tutorial.md) * [Running Snakemake pipelines on Puhti](snakemake-puhti.md) +## Resources for courses + +* [Organizing a course using CSC services](services-for-courses.md) +* [A Puhti web interface demo for course organizers](https://github.com/CSCfi/Jupyter_www_puhti) +* [Noppe environment for creating custom notebooks](../../cloud/noppe/guide_for_teachers.md#creating-custom-images) + ## Allas * [Using Allas interactively in Puhti and Mahti](../../data/Allas/allas-hpc.md) @@ -104,9 +110,3 @@ You can find Rahti tutorials in [Cloud Services > Rahti > Tutorials](../../cloud ## Visualisation * [Blender tutorial](blender-tutorial.md) - -## CSC Resources for Courses - -* [CSC Services for courses](services-for-courses.md) -* [A Puhti webinterface demo for course organizers](https://github.com/CSCfi/Jupyter_www_puhti) -* [Noppe environment for creating custom notebooks](../../cloud/noppe/guide_for_teachers.md#creating-custom-images) diff --git a/docs/support/tutorials/services-for-courses.md b/docs/support/tutorials/services-for-courses.md index e3982d5459..7d750d28ff 100644 --- a/docs/support/tutorials/services-for-courses.md +++ b/docs/support/tutorials/services-for-courses.md @@ -1,19 +1,27 @@ -# Using CSC services for courses +# How to organize a course using CSC resources CSC services can be used for educational purposes in accordance with our [free-of-charge use policy](https://research.csc.fi/free-of-charge-use/). This guide outlines how to organize a course using [Noppe](#noppe) and -[CSC supercomputers Puhti and Mahti](#puhti-and-mahti), including advice on how -to select the right service for your needs. +[CSC supercomputers Puhti and Mahti](#puhti-and-mahti), including advice on +[how to select the most suitable service for your needs](#which-service-should-i-choose). ## Noppe +### Overview + +Motivation why to use Noppe here. + ### Instructions #### Teacher +[Please see the guide for teachers](../../cloud/noppe/guide_for_teachers.md). + #### Student +[Please see the guide for student](../../cloud/noppe/guide_for_students.md). + ## Puhti and Mahti !!! info "Puhti and Mahti will be retired in 2026" @@ -44,28 +52,37 @@ students**. Ideally, teachers should target a smaller number of around 25 participants. For larger courses the free resources and allowed resource reservations may not support the requested amount of users. +It is also recommended to request an advance resource reservation for courses +to guarantee the availability of resources. +[Read more below](#advance-resource-reservation). + !!! warning "Service breaks" Please note that the first Tuesday and Wednesday of each month are reserved for regular maintenance breaks. You should never rely on the services being available on those days. -### Prerequisites +### Instructions #### Teacher 1. [Create a CSC user account](../../accounts/how-to-create-new-user-account.md). 2. [Create a CSC Course project](../../accounts/how-to-create-new-project.md#course). -3. [Add Puhti and/or Mahti service access to the project](../../accounts/how-to-add-service-access-for-project.md). +3. [Add Puhti and/or Mahti service access to the project](../../accounts/how-to-add-service-access-for-project.md#project-manager). 4. Invite students to the project either by - * [using an invitation link](../../accounts/how-to-add-members-to-project.md#using-invitation-link) (recommended) - * [or directly](../../accounts/how-to-add-members-to-project.md#adding-members-directly). + 1. [using an invitation link](../../accounts/how-to-add-members-to-project.md#using-invitation-link) (recommended) + 2. [or directly](../../accounts/how-to-add-members-to-project.md#adding-members-directly). +5. [Request an advance resource reservation](#advance-resource-reservation). +6. Prepare the course content. + 1. [Consult the documentation](../../computing/index.md). + 2. [Contact CSC Service Desk if you need support](../contact.md). #### Student 1. [Create a CSC user account](../../accounts/how-to-create-new-user-account.md). 2. Join the course project: 1. If you've been sent a project invitation link, [accept the invitation in MyCSC](../../accounts/how-to-add-members-to-project.md#member). - 2. If you've been added directly to the course project, no actions are required. + 2. If you've been added directly to the course project, no further actions are required to join the course project. +3. [Accept the relevant terms of service in MyCSC](../../accounts/how-to-add-service-access-for-project.md#member). ### Advance resource reservation @@ -73,20 +90,63 @@ Course projects are subject to the same Slurm job priority policies as regular computing projects, meaning that **course participants may need to queue for resources** if the system is under heavy use. To ensure the availability of resources at the time of the course session(s), we recommend requesting for an -_advance resource reservation_. +_advance resource reservation_. Please note: * The resource reservation must be requested **at least 14 days** before the start of the course via [CSC Service Desk](../contact.md). * The request should be motivated and include - 1. the number of participants, - 2. the resources planned for the course, - 3. timetable showing the schedule of the course. + 1. The course project number, + 2. the number of participants, + 3. the resources planned for the course, + 4. timetable showing the schedule of the course. * The maximum amount and type of reservable resources are outlined in the table below. | System | Approval | CPU limit | GPU limit | Max. daily time window | Max. course days in total | - |--------|------------------|-------------------|-----------|--------------------|----------------| + |--------|----------|-----------|-----------|------------------------|---------------------------| | Puhti | Automatic | 2 nodes (80 cores) | 0 | 08:00–17:00 | 5 | | | CSC Resource Allocation Group | 5 nodes (200 cores) | 4 nodes (16 GPUs) | Up to 12 hrs (e.g., 08:00–20:00 or 12:00–24:00) | 10 | | Mahti | Automatic | 2 nodes (256 cores) | 14 [GPU slices](../../computing/running/batch-job-partitions.md#gpu-slices) | 08:00–17:00 | 5 | | | CSC Resource Allocation Group | 8 nodes (1024 cores) | 56 [GPU slices](../../computing/running/batch-job-partitions.md#gpu-slices) | Up to 12 hrs (e.g., 08:00–20:00 or 12:00–24:00) | 10 | + +A granted advance resource reservation will be visible in the form for +launching an interactive session in the web interfaces. Note that the option +will be greyed out until the start of the reservation. + +In batch job scripts, the advance resource reservation is activated using the +Slurm directive: + +```bash +#SBATCH --reservation= +``` + +Please note that the project number and partition must match what has been +specified for the advance resource reservation. + +## Which service should I choose? + +The following table compares Noppe vs. Puhti and Mahti in order to help +selecting the most suitable service for your course. + +| Feature | | Noppe | Puhti | Mahti | +|---------|---------|:-----:|:-----:|:-----:| +| Prerequisites | | | | | +| | CSC course project required | ❌ | ✅ | ✅ | +| | Teacher needs CSC account | ✅ | ✅ | ✅ | +| | Students need CSC accounts | ❌ | ✅ | ✅ | +| User interface | | | | | +| | Web interface | ✅ | ✅ | ✅ | +| | Command-line interface | ❌ | ✅ | ✅ | +| Graphical apps | | | | | +| | Jupyter Notebooks | ✅ | ✅ | ✅ | +| | RStudio | ✅ | ✅ | ✅ | +| | MATLAB | ❌ | ✅ | ✅ | +| | TensorBoard | ❌ | ✅ | ✅ | +| | MLflow | ❌ | ✅ | ✅ | +| | VS Code | ❌ | ✅ | ✅ | +| | Remote desktop | ❌ | ✅ | ✅ | +| | Remote desktop with GPU acceleration | ❌ | ✅ | ❌ | +| Resources | | | +| | CPU | ✅ | ✅ | ✅ | +| | GPU | ❌ | ✅ | ✅ | +| | Shared storage quota | 20 GiB | 1 TiB | 1 TiB | From f1771b4f2af4fb368cfac1ebd10bcad581280e59 Mon Sep 17 00:00:00 2001 From: Joona Tolonen Date: Tue, 9 Dec 2025 11:46:00 +0200 Subject: [PATCH 09/15] Added initial draft version of the rest of the available services. --- .../support/tutorials/services-for-courses.md | 189 ++++++++++++++++++ 1 file changed, 189 insertions(+) diff --git a/docs/support/tutorials/services-for-courses.md b/docs/support/tutorials/services-for-courses.md index 7d750d28ff..7e68616732 100644 --- a/docs/support/tutorials/services-for-courses.md +++ b/docs/support/tutorials/services-for-courses.md @@ -1,11 +1,96 @@ # How to organize a course using CSC resources +```mermaid +graph LR; + A["Create a CSC + user account"] --> B; + B["Create a MyCSC + Course project"] --> C; + C["Activate + service(s)"] --> D; + D["Invite + students"] --> E; + E["Creat content"] +``` + CSC services can be used for educational purposes in accordance with our [free-of-charge use policy](https://research.csc.fi/free-of-charge-use/). This guide outlines how to organize a course using [Noppe](#noppe) and [CSC supercomputers Puhti and Mahti](#puhti-and-mahti), including advice on [how to select the most suitable service for your needs](#which-service-should-i-choose). +## Allas + +### Overview + +Allas is a Ceph-based object storage system. It is designed for storing and sharing large +volumes of data. Data can be accessed from other CSC services, such as cPouta, Puhti and +Mahti, or directly via the website: . + +Data can be accessed using tools and programming languages based on S3 or Swift interfaces. + +### Instructions + +#### Teacher + +1. [Create a CSC user account](../../accounts/how-to-create-new-user-account.md). +2. [Create a CSC Course project](../../accounts/how-to-create-new-project.md#course). +3. [Add Allas service access to the project](../../accounts/how-to-add-service-access-for-project.md#project-manager). +4. If you need to restrict access to data to students only, invite them to the project: + 1. [using an invitation link](../../accounts/how-to-add-members-to-project.md#using-invitation-link) (recommended) + 2. [or directly](../../accounts/how-to-add-members-to-project.md#adding-members-directly). +5. Prepare the course content. + 1. [Consult the documentation](../../data/Allas/index.md). + 2. [Contact CSC Service Desk if you need support](../contact.md). + +#### Student + +If the course-related data is not publicly available but is shared: + +1. [Create a CSC user account](../../accounts/how-to-create-new-user-account.md). +2. Join the course project: + 1. If you've been sent a project invitation link, [accept the invitation in MyCSC](../../accounts/how-to-add-members-to-project.md#member). + 2. If you've been added directly to the course project, no further actions are required to join the course project. +3. [Accept the relevant terms of service in MyCSC](../../accounts/how-to-add-service-access-for-project.md#member). + +## cPouta + +### Overview + +cPouta is an infrastructure-as-a-service (IaaS) platform based on OpenStack technology. +It is ideal for use cases requiring an internet-connected Linux server. + +A variety of virtual machine options are available, ranging from small machines to +I/O-intensive or GPU-enabled ones. These virtual machines can be connected to +the internet via a public IPv4 address. + +The OpenStack platform can be administered either through the web interface or +using command line tools. + +### Instructions + +#### Teacher + +1. [Create a CSC user account](../../accounts/how-to-create-new-user-account.md). +2. [Create a CSC Course project](../../accounts/how-to-create-new-project.md#course). +3. [Add cPouta service access to the project](../../accounts/how-to-add-service-access-for-project.md#project-manager). +4. If students need to create or modify IaaS components, invite them to the project: + 1. [using an invitation link](../../accounts/how-to-add-members-to-project.md#using-invitation-link) (recommended) + 2. [or directly](../../accounts/how-to-add-members-to-project.md#adding-members-directly). +5. Prepare the course content. + 1. [Consult the documentation](../../cloud/pouta/index.md). + 2. [Contact CSC Service Desk if you need support](../contact.md). + +#### Student + +If access to the OpenStack control plane is required: + +1. [Create a CSC user account](../../accounts/how-to-create-new-user-account.md). +2. Join the course project: + 1. If you've been sent a project invitation link, [accept the invitation in MyCSC](../../accounts/how-to-add-members-to-project.md#member). + 2. If you've been added directly to the course project, no further actions are required to join the course project. +3. [Accept the relevant terms of service in MyCSC](../../accounts/how-to-add-service-access-for-project.md#member). + ## Noppe ### Overview @@ -150,3 +235,107 @@ selecting the most suitable service for your course. | | CPU | ✅ | ✅ | ✅ | | | GPU | ❌ | ✅ | ✅ | | | Shared storage quota | 20 GiB | 1 TiB | 1 TiB | + +## Pukki + +### Overview + +Pukki is a Database-as-a-service (DBaaS), where you can launch a new database +"with a simple click". Pukki automates away the database maintenance and +administrative tasks of other services so that the teacher can focus on using/teaching +the actual topic of databases. + +Instead of manually setting up your own database that you have to maintain yourself, +you can use DBaaS to manage the tedious tasks of provisioning, configuring, maintaining, +updating, documenting and backing up your database. + +### Instructions + +#### Teacher + +1. [Create a CSC user account](../../accounts/how-to-create-new-user-account.md). +2. [Create a CSC Course project](../../accounts/how-to-create-new-project.md#course). +3. [Add Pukki service access to the project](../../accounts/how-to-add-service-access-for-project.md#project-manager). +4. If students need to create own DBaaS instances, invite them to the project: + 1. [using an invitation link](../../accounts/how-to-add-members-to-project.md#using-invitation-link) (recommended) + 2. [or directly](../../accounts/how-to-add-members-to-project.md#adding-members-directly). +5. Prepare the course content. + 1. [Consult the documentation](../../cloud/dbaas/index.md). + 2. [Contact CSC Service Desk if you need support](../contact.md). + +#### Student + +If access to create your own database instances is required: + +1. [Create a CSC user account](../../accounts/how-to-create-new-user-account.md). +2. Join the course project: + 1. If you've been sent a project invitation link, [accept the invitation in MyCSC](../../accounts/how-to-add-members-to-project.md#member). + 2. If you've been added directly to the course project, no further actions are required to join the course project. +3. [Accept the relevant terms of service in MyCSC](../../accounts/how-to-add-service-access-for-project.md#member). + +## Rahti + +### Overview + +Rahti is an orchestration service for containers that runs on OKD. Educators +can launch services to be used on a course, or Rahti can form part of the course itself. +The service is for example useful for teaching CI/CD pipelines. + +Like cPouta, Rahti offers similar multipurpose technology, but without the burden +of having to maintain the operating system yourself. A variety of ready-made templates +can be used with just one click, saving you the trouble of installing services as you +would in cPouta. + +### Instructions + +#### Teacher + +1. [Create a CSC user account](../../accounts/how-to-create-new-user-account.md). +2. [Create a CSC Course project](../../accounts/how-to-create-new-project.md#course). +3. [Add Rahti service access to the project](../../accounts/how-to-add-service-access-for-project.md#project-manager). +4. If students need to launch their own workloads in Rahti, invite them to the project: + 1. [using an invitation link](../../accounts/how-to-add-members-to-project.md#using-invitation-link) (recommended) + 2. [or directly](../../accounts/how-to-add-members-to-project.md#adding-members-directly). +5. Prepare the course content. + 1. [Consult the documentation](../../cloud/rahti/index.md). + 2. [Contact CSC Service Desk if you need support](../contact.md). + +#### Student + +If access to the container environment is required: + +1. [Create a CSC user account](../../accounts/how-to-create-new-user-account.md). +2. Join the course project: + 1. If you've been sent a project invitation link, [accept the invitation in MyCSC](../../accounts/how-to-add-members-to-project.md#member). + 2. If you've been added directly to the course project, no further actions are required to join the course project. +3. [Accept the relevant terms of service in MyCSC](../../accounts/how-to-add-service-access-for-project.md#member). + +## Sensitive Data (SD) Desktop + +### Overview + +Sensitive Data (SD) Desktop allows you to analyze sensitive research data from +your web browser securely. With this user interface, you can easily manage +a virtual computer (here called desktop, technically defined as virtual machine). + +### Instructions + +#### Teacher + +1. [Create a CSC user account](../../accounts/how-to-create-new-user-account.md). +2. [Create a CSC Course project](../../accounts/how-to-create-new-project.md#course). +3. [Add Sensitive Data (SD) Desktop service access to the project](../../accounts/how-to-add-service-access-for-project.md#project-manager). +4. Invite students to the project either by + 1. [using an invitation link](../../accounts/how-to-add-members-to-project.md#using-invitation-link) (recommended) + 2. [or directly](../../accounts/how-to-add-members-to-project.md#adding-members-directly). +5. Prepare the course content. + 1. [Consult the documentation](../../data/sensitive-data/sd_desktop/index.md). + 2. [Contact CSC Service Desk if you need support](../contact.md). + +#### Student + +1. [Create a CSC user account](../../accounts/how-to-create-new-user-account.md). +2. Join the course project: + 1. If you've been sent a project invitation link, [accept the invitation in MyCSC](../../accounts/how-to-add-members-to-project.md#member). + 2. If you've been added directly to the course project, no further actions are required to join the course project. +3. [Accept the relevant terms of service in MyCSC](../../accounts/how-to-add-service-access-for-project.md#member). From ec4f2f66a19dcec3a256c4c2097071be31d0329d Mon Sep 17 00:00:00 2001 From: Joona Tolonen Date: Tue, 9 Dec 2025 12:59:32 +0200 Subject: [PATCH 10/15] Updated based on feedback from service owners. --- .../support/tutorials/services-for-courses.md | 33 ++++++++++++------- 1 file changed, 21 insertions(+), 12 deletions(-) diff --git a/docs/support/tutorials/services-for-courses.md b/docs/support/tutorials/services-for-courses.md index 7e68616732..c07ff2bd0b 100644 --- a/docs/support/tutorials/services-for-courses.md +++ b/docs/support/tutorials/services-for-courses.md @@ -14,13 +14,22 @@ graph LR; ``` CSC services can be used for educational purposes in accordance with our -[free-of-charge use policy](https://research.csc.fi/free-of-charge-use/). This -guide outlines how to organize a course using [Noppe](#noppe) and -[CSC supercomputers Puhti and Mahti](#puhti-and-mahti), including advice on +[free-of-charge use policy](https://research.csc.fi/free-of-charge-use/). + +The maximum lifetime of a MyCSC course project, including all its enabled services, +is six months. It is not possible to extend or transfer an existing MyCSC course project. + +This guide outlines how to organize a course using [Allas](#allas), [cPouta](#cpouta), +[Noppe](#noppe), [CSC supercomputers Puhti and Mahti](#puhti-and-mahti), [Pukki](#pukki), +[Rahti](#rahti) and [SD Desktop](#sd-desktop). The guide also includes advice on [how to select the most suitable service for your needs](#which-service-should-i-choose). ## Allas +!!! info + Please note that the data will only be available for the duration of + the MyCSC Course project. + ### Overview Allas is a Ceph-based object storage system. It is designed for storing and sharing large @@ -251,27 +260,27 @@ updating, documenting and backing up your database. ### Instructions +!!! info + If each student needs their own Pukki DBaaS instance, they should create + a MyCSC student project and activate the Pukki service within that project. + #### Teacher 1. [Create a CSC user account](../../accounts/how-to-create-new-user-account.md). 2. [Create a CSC Course project](../../accounts/how-to-create-new-project.md#course). 3. [Add Pukki service access to the project](../../accounts/how-to-add-service-access-for-project.md#project-manager). -4. If students need to create own DBaaS instances, invite them to the project: - 1. [using an invitation link](../../accounts/how-to-add-members-to-project.md#using-invitation-link) (recommended) - 2. [or directly](../../accounts/how-to-add-members-to-project.md#adding-members-directly). +4. Based on the nature of your course: + 1. In case of one database, use its tools to create accounts for students. + 2. If each student needs their own database, ask them to create a student project. 5. Prepare the course content. 1. [Consult the documentation](../../cloud/dbaas/index.md). 2. [Contact CSC Service Desk if you need support](../contact.md). #### Student -If access to create your own database instances is required: +Follow these instructions to find out how to create a student project: [Getting started with CSC services for students](student_quick/index.md) -1. [Create a CSC user account](../../accounts/how-to-create-new-user-account.md). -2. Join the course project: - 1. If you've been sent a project invitation link, [accept the invitation in MyCSC](../../accounts/how-to-add-members-to-project.md#member). - 2. If you've been added directly to the course project, no further actions are required to join the course project. -3. [Accept the relevant terms of service in MyCSC](../../accounts/how-to-add-service-access-for-project.md#member). +Then, add Pukki service to that project. ## Rahti From 4f36fcbe54ec15906e228b78219bb50ef7a4c431 Mon Sep 17 00:00:00 2001 From: Joona Tolonen Date: Tue, 9 Dec 2025 14:15:29 +0200 Subject: [PATCH 11/15] Unified terminology, updated Rahti section based on PO comments. --- .../support/tutorials/services-for-courses.md | 47 +++++++++++-------- 1 file changed, 28 insertions(+), 19 deletions(-) diff --git a/docs/support/tutorials/services-for-courses.md b/docs/support/tutorials/services-for-courses.md index c07ff2bd0b..01b69528cc 100644 --- a/docs/support/tutorials/services-for-courses.md +++ b/docs/support/tutorials/services-for-courses.md @@ -4,7 +4,7 @@ graph LR; A["Create a CSC user account"] --> B; - B["Create a MyCSC + B["Create a CSC Course project"] --> C; C["Activate service(s)"] --> D; @@ -16,19 +16,19 @@ graph LR; CSC services can be used for educational purposes in accordance with our [free-of-charge use policy](https://research.csc.fi/free-of-charge-use/). -The maximum lifetime of a MyCSC course project, including all its enabled services, -is six months. It is not possible to extend or transfer an existing MyCSC course project. +The maximum lifetime of a CSC Course project, including all its enabled services, +is six months. It is not possible to extend or transfer an existing CSC Course project. This guide outlines how to organize a course using [Allas](#allas), [cPouta](#cpouta), [Noppe](#noppe), [CSC supercomputers Puhti and Mahti](#puhti-and-mahti), [Pukki](#pukki), -[Rahti](#rahti) and [SD Desktop](#sd-desktop). The guide also includes advice on +[Rahti](#rahti) and [SD Desktop](#sensitive-data-sd-desktop). The guide also includes advice on [how to select the most suitable service for your needs](#which-service-should-i-choose). ## Allas !!! info Please note that the data will only be available for the duration of - the MyCSC Course project. + the CSC Course project. ### Overview @@ -225,7 +225,7 @@ selecting the most suitable service for your course. | Feature | | Noppe | Puhti | Mahti | |---------|---------|:-----:|:-----:|:-----:| | Prerequisites | | | | | -| | CSC course project required | ❌ | ✅ | ✅ | +| | CSC Course project required | ❌ | ✅ | ✅ | | | Teacher needs CSC account | ✅ | ✅ | ✅ | | | Students need CSC accounts | ❌ | ✅ | ✅ | | User interface | | | | | @@ -262,7 +262,7 @@ updating, documenting and backing up your database. !!! info If each student needs their own Pukki DBaaS instance, they should create - a MyCSC student project and activate the Pukki service within that project. + a CSC Student project and activate the Pukki service within that project. #### Teacher @@ -278,7 +278,7 @@ updating, documenting and backing up your database. #### Student -Follow these instructions to find out how to create a student project: [Getting started with CSC services for students](student_quick/index.md) +Follow these instructions to find out how to create a student project: [Getting started with CSC services for students](student_quick.md) Then, add Pukki service to that project. @@ -297,27 +297,36 @@ would in cPouta. ### Instructions +!!! info + If students should not have access to others' Rahti environments, + they should use a CSC Student project instead. + #### Teacher 1. [Create a CSC user account](../../accounts/how-to-create-new-user-account.md). 2. [Create a CSC Course project](../../accounts/how-to-create-new-project.md#course). 3. [Add Rahti service access to the project](../../accounts/how-to-add-service-access-for-project.md#project-manager). -4. If students need to launch their own workloads in Rahti, invite them to the project: - 1. [using an invitation link](../../accounts/how-to-add-members-to-project.md#using-invitation-link) (recommended) - 2. [or directly](../../accounts/how-to-add-members-to-project.md#adding-members-directly). +4. Based on the nature of your course: + 1. If each student needs isolated Rahti namespace environment, ask them to create a student project. + 2. If students sharing and seeing each other's environments is not a problem, + invite students to the project either by + 1. [using an invitation link](../../accounts/how-to-add-members-to-project.md#using-invitation-link) (recommended) + 2. [or directly](../../accounts/how-to-add-members-to-project.md#adding-members-directly). 5. Prepare the course content. 1. [Consult the documentation](../../cloud/rahti/index.md). 2. [Contact CSC Service Desk if you need support](../contact.md). #### Student -If access to the container environment is required: - -1. [Create a CSC user account](../../accounts/how-to-create-new-user-account.md). -2. Join the course project: - 1. If you've been sent a project invitation link, [accept the invitation in MyCSC](../../accounts/how-to-add-members-to-project.md#member). - 2. If you've been added directly to the course project, no further actions are required to join the course project. -3. [Accept the relevant terms of service in MyCSC](../../accounts/how-to-add-service-access-for-project.md#member). +1. If an isolated Rahti namespace environment is required, follow these instructions +to find out how to create a student project: [Getting started with CSC services for students](student_quick.md) + 1. then, add Rahti service to that project. +2. Or if an access to a shared container environment is required: + 1. [Create a CSC user account](../../accounts/how-to-create-new-user-account.md). + 2. Join the course project: + 1. If you've been sent a project invitation link, [accept the invitation in MyCSC](../../accounts/how-to-add-members-to-project.md#member). + 2. If you've been added directly to the course project, no further actions are required to join the course project. + 3. [Accept the relevant terms of service in MyCSC](../../accounts/how-to-add-service-access-for-project.md#member). ## Sensitive Data (SD) Desktop @@ -338,7 +347,7 @@ a virtual computer (here called desktop, technically defined as virtual machine) 1. [using an invitation link](../../accounts/how-to-add-members-to-project.md#using-invitation-link) (recommended) 2. [or directly](../../accounts/how-to-add-members-to-project.md#adding-members-directly). 5. Prepare the course content. - 1. [Consult the documentation](../../data/sensitive-data/sd_desktop/index.md). + 1. [Consult the documentation](../../data/sensitive-data/sd_desktop.md). 2. [Contact CSC Service Desk if you need support](../contact.md). #### Student From 64e809f96601085595eeeb9b7e2b8ee0c61163fa Mon Sep 17 00:00:00 2001 From: Joona Tolonen Date: Fri, 12 Dec 2025 10:55:08 +0200 Subject: [PATCH 12/15] Updated based on feedback from service owners. Also fixed some typos. --- .../support/tutorials/services-for-courses.md | 49 ++++++++++++------- 1 file changed, 32 insertions(+), 17 deletions(-) diff --git a/docs/support/tutorials/services-for-courses.md b/docs/support/tutorials/services-for-courses.md index 01b69528cc..fce0e5b46f 100644 --- a/docs/support/tutorials/services-for-courses.md +++ b/docs/support/tutorials/services-for-courses.md @@ -10,7 +10,7 @@ graph LR; service(s)"] --> D; D["Invite students"] --> E; - E["Creat content"] + E["Create content"] ``` CSC services can be used for educational purposes in accordance with our @@ -64,13 +64,19 @@ If the course-related data is not publicly available but is shared: ## cPouta +!!! info + Please note that the resources will only be available for the duration of + the CSC Course project. Also if each student needs to manage own virtual + infrastructure, they should create a CSC Student project and activate + the cPouta service within that project. + ### Overview cPouta is an infrastructure-as-a-service (IaaS) platform based on OpenStack technology. -It is ideal for use cases requiring an internet-connected Linux server. +It is ideal for use cases requiring an internet-accessible Linux server. A variety of virtual machine options are available, ranging from small machines to -I/O-intensive or GPU-enabled ones. These virtual machines can be connected to +I/O-intensive or GPU-enabled ones. These virtual machines can be accessed from the internet via a public IPv4 address. The OpenStack platform can be administered either through the web interface or @@ -83,22 +89,32 @@ using command line tools. 1. [Create a CSC user account](../../accounts/how-to-create-new-user-account.md). 2. [Create a CSC Course project](../../accounts/how-to-create-new-project.md#course). 3. [Add cPouta service access to the project](../../accounts/how-to-add-service-access-for-project.md#project-manager). -4. If students need to create or modify IaaS components, invite them to the project: - 1. [using an invitation link](../../accounts/how-to-add-members-to-project.md#using-invitation-link) (recommended) - 2. [or directly](../../accounts/how-to-add-members-to-project.md#adding-members-directly). +4. Based on the nature of your course: + 1. In case of an infrastructure with few machines and an access, use Linux's own + tools to create accounts for students. + 2. If each student needs their own virtual infrastructure, ask them to create a student project. + 3. If students need to modify shared infrastructure, invite them to the project: + 1. [using an invitation link](../../accounts/how-to-add-members-to-project.md#using-invitation-link) (recommended) + 2. [or directly](../../accounts/how-to-add-members-to-project.md#adding-members-directly). 5. Prepare the course content. 1. [Consult the documentation](../../cloud/pouta/index.md). 2. [Contact CSC Service Desk if you need support](../contact.md). -#### Student +!!! warning "Sufficient quota" + If you end up using a shared cPouta virtual infrastructure with a large number of students, + please ensure that the project quota is sufficient. If not, either request an increase + to the quota () or ask the students to create their own CSC Student projects instead. -If access to the OpenStack control plane is required: +#### Student -1. [Create a CSC user account](../../accounts/how-to-create-new-user-account.md). -2. Join the course project: - 1. If you've been sent a project invitation link, [accept the invitation in MyCSC](../../accounts/how-to-add-members-to-project.md#member). - 2. If you've been added directly to the course project, no further actions are required to join the course project. -3. [Accept the relevant terms of service in MyCSC](../../accounts/how-to-add-service-access-for-project.md#member). +1. In case of an own cPouta virtual infrastructure, follow these instructions to find out how to create + a student project: [Getting started with CSC services for students](student_quick.md). Then, add cPouta service to that project. +2. If access to the teacher's CSC Course project's OpenStack control plane is required: + 1. [Create a CSC user account](../../accounts/how-to-create-new-user-account.md). + 2. Join the course project: + 1. If you've been sent a project invitation link, [accept the invitation in MyCSC](../../accounts/how-to-add-members-to-project.md#member). + 2. If you've been added directly to the course project, no further actions are required to join the course project. + 3. [Accept the relevant terms of service in MyCSC](../../accounts/how-to-add-service-access-for-project.md#member). ## Noppe @@ -278,9 +294,8 @@ updating, documenting and backing up your database. #### Student -Follow these instructions to find out how to create a student project: [Getting started with CSC services for students](student_quick.md) - -Then, add Pukki service to that project. +1. Follow these instructions to find out how to create a student project: [Getting started with CSC services for students](student_quick.md) + 2. Then, add Pukki service to that project. ## Rahti @@ -298,7 +313,7 @@ would in cPouta. ### Instructions !!! info - If students should not have access to others' Rahti environments, + If students should **not** have access to others' Rahti environments, they should use a CSC Student project instead. #### Teacher From 02af0649199505118ee14fc94a9fe0e93a1cccb1 Mon Sep 17 00:00:00 2001 From: Joona Tolonen Date: Fri, 12 Dec 2025 12:43:05 +0200 Subject: [PATCH 13/15] Changed services each to their own tab. --- .../support/tutorials/services-for-courses.md | 585 +++++++++--------- 1 file changed, 279 insertions(+), 306 deletions(-) diff --git a/docs/support/tutorials/services-for-courses.md b/docs/support/tutorials/services-for-courses.md index fce0e5b46f..a4b4a84ebe 100644 --- a/docs/support/tutorials/services-for-courses.md +++ b/docs/support/tutorials/services-for-courses.md @@ -1,18 +1,5 @@ # How to organize a course using CSC resources -```mermaid -graph LR; - A["Create a CSC - user account"] --> B; - B["Create a CSC - Course project"] --> C; - C["Activate - service(s)"] --> D; - D["Invite - students"] --> E; - E["Create content"] -``` - CSC services can be used for educational purposes in accordance with our [free-of-charge use policy](https://research.csc.fi/free-of-charge-use/). @@ -24,351 +11,337 @@ This guide outlines how to organize a course using [Allas](#allas), [cPouta](#cp [Rahti](#rahti) and [SD Desktop](#sensitive-data-sd-desktop). The guide also includes advice on [how to select the most suitable service for your needs](#which-service-should-i-choose). -## Allas +=== "Allas" -!!! info - Please note that the data will only be available for the duration of - the CSC Course project. + !!! info + Please note that the data will only be available for the duration of + the CSC Course project. -### Overview + Allas is a Ceph-based object storage system. It is designed for storing and sharing large + volumes of data. Data can be accessed from other CSC services, such as cPouta, Puhti and + Mahti, or directly via the website: . -Allas is a Ceph-based object storage system. It is designed for storing and sharing large -volumes of data. Data can be accessed from other CSC services, such as cPouta, Puhti and -Mahti, or directly via the website: . + Data can be accessed using tools and programming languages based on S3 or Swift interfaces. -Data can be accessed using tools and programming languages based on S3 or Swift interfaces. + ## Instructions -### Instructions + ### Teacher -#### Teacher + 1. [Create a CSC user account](../../accounts/how-to-create-new-user-account.md). + 2. [Create a CSC Course project](../../accounts/how-to-create-new-project.md#course). + 3. [Add Allas service access to the project](../../accounts/how-to-add-service-access-for-project.md#project-manager). + 4. If you need to restrict access to data to students only, invite them to the project: + 1. [using an invitation link](../../accounts/how-to-add-members-to-project.md#using-invitation-link) (recommended) + 2. [or directly](../../accounts/how-to-add-members-to-project.md#adding-members-directly). + 5. Prepare the course content. + 1. [Consult the documentation](../../data/Allas/index.md). + 2. [Contact CSC Service Desk if you need support](../contact.md). -1. [Create a CSC user account](../../accounts/how-to-create-new-user-account.md). -2. [Create a CSC Course project](../../accounts/how-to-create-new-project.md#course). -3. [Add Allas service access to the project](../../accounts/how-to-add-service-access-for-project.md#project-manager). -4. If you need to restrict access to data to students only, invite them to the project: - 1. [using an invitation link](../../accounts/how-to-add-members-to-project.md#using-invitation-link) (recommended) - 2. [or directly](../../accounts/how-to-add-members-to-project.md#adding-members-directly). -5. Prepare the course content. - 1. [Consult the documentation](../../data/Allas/index.md). - 2. [Contact CSC Service Desk if you need support](../contact.md). + ### Student -#### Student + If the course-related data is not publicly available but is shared: -If the course-related data is not publicly available but is shared: + 1. [Create a CSC user account](../../accounts/how-to-create-new-user-account.md). + 2. Join the course project: + 1. If you've been sent a project invitation link, [accept the invitation in MyCSC](../../accounts/how-to-add-members-to-project.md#member). + 2. If you've been added directly to the course project, no further actions are required to join the course project. + 3. [Accept the relevant terms of service in MyCSC](../../accounts/how-to-add-service-access-for-project.md#member). -1. [Create a CSC user account](../../accounts/how-to-create-new-user-account.md). -2. Join the course project: - 1. If you've been sent a project invitation link, [accept the invitation in MyCSC](../../accounts/how-to-add-members-to-project.md#member). - 2. If you've been added directly to the course project, no further actions are required to join the course project. -3. [Accept the relevant terms of service in MyCSC](../../accounts/how-to-add-service-access-for-project.md#member). +=== "cPouta" -## cPouta + !!! info + Please note that the resources will only be available for the duration of + the CSC Course project. Also if each student needs to manage own virtual + infrastructure, they should create a CSC Student project and activate + the cPouta service within that project. -!!! info - Please note that the resources will only be available for the duration of - the CSC Course project. Also if each student needs to manage own virtual - infrastructure, they should create a CSC Student project and activate - the cPouta service within that project. + cPouta is an infrastructure-as-a-service (IaaS) platform based on OpenStack technology. + It is ideal for use cases requiring an internet-accessible Linux server. -### Overview + A variety of virtual machine options are available, ranging from small machines to + I/O-intensive or GPU-enabled ones. These virtual machines can be accessed from + the internet via a public IPv4 address. -cPouta is an infrastructure-as-a-service (IaaS) platform based on OpenStack technology. -It is ideal for use cases requiring an internet-accessible Linux server. + The OpenStack platform can be administered either through the web interface or + using command line tools. -A variety of virtual machine options are available, ranging from small machines to -I/O-intensive or GPU-enabled ones. These virtual machines can be accessed from -the internet via a public IPv4 address. + ## Instructions -The OpenStack platform can be administered either through the web interface or -using command line tools. + ### Teacher -### Instructions + 1. [Create a CSC user account](../../accounts/how-to-create-new-user-account.md). + 2. [Create a CSC Course project](../../accounts/how-to-create-new-project.md#course). + 3. [Add cPouta service access to the project](../../accounts/how-to-add-service-access-for-project.md#project-manager). + 4. Based on the nature of your course: + 1. In case of an infrastructure with few machines and an access, use Linux's own + tools to create accounts for students. + 2. If each student needs their own virtual infrastructure, ask them to create a student project. + 3. If students need to modify shared infrastructure, invite them to the project: + 1. [using an invitation link](../../accounts/how-to-add-members-to-project.md#using-invitation-link) (recommended) + 2. [or directly](../../accounts/how-to-add-members-to-project.md#adding-members-directly). + 5. Prepare the course content. + 1. [Consult the documentation](../../cloud/pouta/index.md). + 2. [Contact CSC Service Desk if you need support](../contact.md). -#### Teacher + !!! warning "Sufficient quota" + If you end up using a shared cPouta virtual infrastructure with a large number of students, + please ensure that the project quota is sufficient. If not, either request an increase + to the quota () or ask the students to create their own CSC Student projects instead. -1. [Create a CSC user account](../../accounts/how-to-create-new-user-account.md). -2. [Create a CSC Course project](../../accounts/how-to-create-new-project.md#course). -3. [Add cPouta service access to the project](../../accounts/how-to-add-service-access-for-project.md#project-manager). -4. Based on the nature of your course: - 1. In case of an infrastructure with few machines and an access, use Linux's own - tools to create accounts for students. - 2. If each student needs their own virtual infrastructure, ask them to create a student project. - 3. If students need to modify shared infrastructure, invite them to the project: - 1. [using an invitation link](../../accounts/how-to-add-members-to-project.md#using-invitation-link) (recommended) - 2. [or directly](../../accounts/how-to-add-members-to-project.md#adding-members-directly). -5. Prepare the course content. - 1. [Consult the documentation](../../cloud/pouta/index.md). - 2. [Contact CSC Service Desk if you need support](../contact.md). + ### Student -!!! warning "Sufficient quota" - If you end up using a shared cPouta virtual infrastructure with a large number of students, - please ensure that the project quota is sufficient. If not, either request an increase - to the quota () or ask the students to create their own CSC Student projects instead. + 1. In case of an own cPouta virtual infrastructure, follow these instructions to find out how to create + a student project: [Getting started with CSC services for students](student_quick.md). Then, add cPouta service to that project. + 2. If access to the teacher's CSC Course project's OpenStack control plane is required: + 1. [Create a CSC user account](../../accounts/how-to-create-new-user-account.md). + 2. Join the course project: + 1. If you've been sent a project invitation link, [accept the invitation in MyCSC](../../accounts/how-to-add-members-to-project.md#member). + 2. If you've been added directly to the course project, no further actions are required to join the course project. + 3. [Accept the relevant terms of service in MyCSC](../../accounts/how-to-add-service-access-for-project.md#member). -#### Student +=== "Noppe" -1. In case of an own cPouta virtual infrastructure, follow these instructions to find out how to create - a student project: [Getting started with CSC services for students](student_quick.md). Then, add cPouta service to that project. -2. If access to the teacher's CSC Course project's OpenStack control plane is required: - 1. [Create a CSC user account](../../accounts/how-to-create-new-user-account.md). - 2. Join the course project: - 1. If you've been sent a project invitation link, [accept the invitation in MyCSC](../../accounts/how-to-add-members-to-project.md#member). - 2. If you've been added directly to the course project, no further actions are required to join the course project. - 3. [Accept the relevant terms of service in MyCSC](../../accounts/how-to-add-service-access-for-project.md#member). + Motivation why to use Noppe here. -## Noppe + ## Instructions -### Overview + ### Teacher -Motivation why to use Noppe here. + [Please see the guide for teachers](../../cloud/noppe/guide_for_teachers.md). -### Instructions + ### Student -#### Teacher + [Please see the guide for student](../../cloud/noppe/guide_for_students.md). -[Please see the guide for teachers](../../cloud/noppe/guide_for_teachers.md). +=== "Puhti and Mahti" -#### Student + !!! info "Puhti and Mahti will be retired in 2026" + Puhti and Mahti will be decommissioned in 2026 and replaced by Roihu, CSC's + next-generation supercomputer offering enhanced performance and + capabilities. Please take this into account when planning courses for 2026. -[Please see the guide for student](../../cloud/noppe/guide_for_students.md). + [Learn more about Roihu :material-arrow-right:](../../computing/systems-roihu.md) -## Puhti and Mahti + CSC supercomputers Mahti and Puhti are ideal platforms for organizing courses + that benefit from HPC resources or aim to teach how to use and run computations + on supercomputing platforms. This includes cases where the course participants + need access to GPUs or larger CPU resources, and cases where the existing + software stack is used for the course assignments. -!!! info "Puhti and Mahti will be retired in 2026" - Puhti and Mahti will be decommissioned in 2026 and replaced by Roihu, CSC's - next-generation supercomputer offering enhanced performance and - capabilities. Please take this into account when planning courses for 2026. + The systems support both traditional command-line + [batch processing compute tasks](../../computing/running/getting-started.md), as well as + web-based tools such as Jupyter Notebooks and RStudio via the + [web interfaces](../../computing/webinterface/index.md). Course organizers are + even able to create customized Jupyter Notebook environments for their course + using the + [Jupyter for Courses](../../computing/webinterface/jupyter-for-courses.md) app. - [Learn more about Roihu :material-arrow-right:](../../computing/systems-roihu.md) + Please note that courses using CSC supercomputers can have **at maximum 50 + students**. Ideally, teachers should target a smaller number of around 25 + participants. For larger courses the free resources and allowed resource + reservations may not support the requested amount of users. -### Overview + It is also recommended to request an advance resource reservation for courses + to guarantee the availability of resources. + [Read more below](#advance-resource-reservation). -CSC supercomputers Mahti and Puhti are ideal platforms for organizing courses -that benefit from HPC resources or aim to teach how to use and run computations -on supercomputing platforms. This includes cases where the course participants -need access to GPUs or larger CPU resources, and cases where the existing -software stack is used for the course assignments. + !!! warning "Service breaks" + Please note that the first Tuesday and Wednesday of each month are reserved + for regular maintenance breaks. You should never rely on the services being + available on those days. -The systems support both traditional command-line -[batch processing compute tasks](../../computing/running/getting-started.md), as well as -web-based tools such as Jupyter Notebooks and RStudio via the -[web interfaces](../../computing/webinterface/index.md). Course organizers are -even able to create customized Jupyter Notebook environments for their course -using the -[Jupyter for Courses](../../computing/webinterface/jupyter-for-courses.md) app. - -Please note that courses using CSC supercomputers can have **at maximum 50 -students**. Ideally, teachers should target a smaller number of around 25 -participants. For larger courses the free resources and allowed resource -reservations may not support the requested amount of users. - -It is also recommended to request an advance resource reservation for courses -to guarantee the availability of resources. -[Read more below](#advance-resource-reservation). - -!!! warning "Service breaks" - Please note that the first Tuesday and Wednesday of each month are reserved - for regular maintenance breaks. You should never rely on the services being - available on those days. - -### Instructions - -#### Teacher - -1. [Create a CSC user account](../../accounts/how-to-create-new-user-account.md). -2. [Create a CSC Course project](../../accounts/how-to-create-new-project.md#course). -3. [Add Puhti and/or Mahti service access to the project](../../accounts/how-to-add-service-access-for-project.md#project-manager). -4. Invite students to the project either by - 1. [using an invitation link](../../accounts/how-to-add-members-to-project.md#using-invitation-link) (recommended) - 2. [or directly](../../accounts/how-to-add-members-to-project.md#adding-members-directly). -5. [Request an advance resource reservation](#advance-resource-reservation). -6. Prepare the course content. - 1. [Consult the documentation](../../computing/index.md). - 2. [Contact CSC Service Desk if you need support](../contact.md). - -#### Student - -1. [Create a CSC user account](../../accounts/how-to-create-new-user-account.md). -2. Join the course project: - 1. If you've been sent a project invitation link, [accept the invitation in MyCSC](../../accounts/how-to-add-members-to-project.md#member). - 2. If you've been added directly to the course project, no further actions are required to join the course project. -3. [Accept the relevant terms of service in MyCSC](../../accounts/how-to-add-service-access-for-project.md#member). - -### Advance resource reservation - -Course projects are subject to the same Slurm job priority policies as regular -computing projects, meaning that **course participants may need to queue for -resources** if the system is under heavy use. To ensure the availability of -resources at the time of the course session(s), we recommend requesting for an -_advance resource reservation_. Please note: + ## Instructions -* The resource reservation must be requested **at least 14 days** before - the start of the course via [CSC Service Desk](../contact.md). -* The request should be motivated and include - 1. The course project number, - 2. the number of participants, - 3. the resources planned for the course, - 4. timetable showing the schedule of the course. -* The maximum amount and type of reservable resources are outlined in the - table below. + ### Teacher - | System | Approval | CPU limit | GPU limit | Max. daily time window | Max. course days in total | - |--------|----------|-----------|-----------|------------------------|---------------------------| - | Puhti | Automatic | 2 nodes (80 cores) | 0 | 08:00–17:00 | 5 | - | | CSC Resource Allocation Group | 5 nodes (200 cores) | 4 nodes (16 GPUs) | Up to 12 hrs (e.g., 08:00–20:00 or 12:00–24:00) | 10 | - | Mahti | Automatic | 2 nodes (256 cores) | 14 [GPU slices](../../computing/running/batch-job-partitions.md#gpu-slices) | 08:00–17:00 | 5 | - | | CSC Resource Allocation Group | 8 nodes (1024 cores) | 56 [GPU slices](../../computing/running/batch-job-partitions.md#gpu-slices) | Up to 12 hrs (e.g., 08:00–20:00 or 12:00–24:00) | 10 | - -A granted advance resource reservation will be visible in the form for -launching an interactive session in the web interfaces. Note that the option -will be greyed out until the start of the reservation. - -In batch job scripts, the advance resource reservation is activated using the -Slurm directive: - -```bash -#SBATCH --reservation= -``` - -Please note that the project number and partition must match what has been -specified for the advance resource reservation. - -## Which service should I choose? - -The following table compares Noppe vs. Puhti and Mahti in order to help -selecting the most suitable service for your course. - -| Feature | | Noppe | Puhti | Mahti | -|---------|---------|:-----:|:-----:|:-----:| -| Prerequisites | | | | | -| | CSC Course project required | ❌ | ✅ | ✅ | -| | Teacher needs CSC account | ✅ | ✅ | ✅ | -| | Students need CSC accounts | ❌ | ✅ | ✅ | -| User interface | | | | | -| | Web interface | ✅ | ✅ | ✅ | -| | Command-line interface | ❌ | ✅ | ✅ | -| Graphical apps | | | | | -| | Jupyter Notebooks | ✅ | ✅ | ✅ | -| | RStudio | ✅ | ✅ | ✅ | -| | MATLAB | ❌ | ✅ | ✅ | -| | TensorBoard | ❌ | ✅ | ✅ | -| | MLflow | ❌ | ✅ | ✅ | -| | VS Code | ❌ | ✅ | ✅ | -| | Remote desktop | ❌ | ✅ | ✅ | -| | Remote desktop with GPU acceleration | ❌ | ✅ | ❌ | -| Resources | | | -| | CPU | ✅ | ✅ | ✅ | -| | GPU | ❌ | ✅ | ✅ | -| | Shared storage quota | 20 GiB | 1 TiB | 1 TiB | - -## Pukki - -### Overview - -Pukki is a Database-as-a-service (DBaaS), where you can launch a new database -"with a simple click". Pukki automates away the database maintenance and -administrative tasks of other services so that the teacher can focus on using/teaching -the actual topic of databases. - -Instead of manually setting up your own database that you have to maintain yourself, -you can use DBaaS to manage the tedious tasks of provisioning, configuring, maintaining, -updating, documenting and backing up your database. - -### Instructions - -!!! info - If each student needs their own Pukki DBaaS instance, they should create - a CSC Student project and activate the Pukki service within that project. - -#### Teacher - -1. [Create a CSC user account](../../accounts/how-to-create-new-user-account.md). -2. [Create a CSC Course project](../../accounts/how-to-create-new-project.md#course). -3. [Add Pukki service access to the project](../../accounts/how-to-add-service-access-for-project.md#project-manager). -4. Based on the nature of your course: - 1. In case of one database, use its tools to create accounts for students. - 2. If each student needs their own database, ask them to create a student project. -5. Prepare the course content. - 1. [Consult the documentation](../../cloud/dbaas/index.md). - 2. [Contact CSC Service Desk if you need support](../contact.md). - -#### Student - -1. Follow these instructions to find out how to create a student project: [Getting started with CSC services for students](student_quick.md) - 2. Then, add Pukki service to that project. - -## Rahti - -### Overview - -Rahti is an orchestration service for containers that runs on OKD. Educators -can launch services to be used on a course, or Rahti can form part of the course itself. -The service is for example useful for teaching CI/CD pipelines. - -Like cPouta, Rahti offers similar multipurpose technology, but without the burden -of having to maintain the operating system yourself. A variety of ready-made templates -can be used with just one click, saving you the trouble of installing services as you -would in cPouta. - -### Instructions - -!!! info - If students should **not** have access to others' Rahti environments, - they should use a CSC Student project instead. - -#### Teacher - -1. [Create a CSC user account](../../accounts/how-to-create-new-user-account.md). -2. [Create a CSC Course project](../../accounts/how-to-create-new-project.md#course). -3. [Add Rahti service access to the project](../../accounts/how-to-add-service-access-for-project.md#project-manager). -4. Based on the nature of your course: - 1. If each student needs isolated Rahti namespace environment, ask them to create a student project. - 2. If students sharing and seeing each other's environments is not a problem, - invite students to the project either by + 1. [Create a CSC user account](../../accounts/how-to-create-new-user-account.md). + 2. [Create a CSC Course project](../../accounts/how-to-create-new-project.md#course). + 3. [Add Puhti and/or Mahti service access to the project](../../accounts/how-to-add-service-access-for-project.md#project-manager). + 4. Invite students to the project either by 1. [using an invitation link](../../accounts/how-to-add-members-to-project.md#using-invitation-link) (recommended) 2. [or directly](../../accounts/how-to-add-members-to-project.md#adding-members-directly). -5. Prepare the course content. - 1. [Consult the documentation](../../cloud/rahti/index.md). - 2. [Contact CSC Service Desk if you need support](../contact.md). + 5. [Request an advance resource reservation](#advance-resource-reservation). + 6. Prepare the course content. + 1. [Consult the documentation](../../computing/index.md). + 2. [Contact CSC Service Desk if you need support](../contact.md). -#### Student + ### Student -1. If an isolated Rahti namespace environment is required, follow these instructions -to find out how to create a student project: [Getting started with CSC services for students](student_quick.md) - 1. then, add Rahti service to that project. -2. Or if an access to a shared container environment is required: 1. [Create a CSC user account](../../accounts/how-to-create-new-user-account.md). 2. Join the course project: 1. If you've been sent a project invitation link, [accept the invitation in MyCSC](../../accounts/how-to-add-members-to-project.md#member). 2. If you've been added directly to the course project, no further actions are required to join the course project. 3. [Accept the relevant terms of service in MyCSC](../../accounts/how-to-add-service-access-for-project.md#member). -## Sensitive Data (SD) Desktop + ## Advance resource reservation + + Course projects are subject to the same Slurm job priority policies as regular + computing projects, meaning that **course participants may need to queue for + resources** if the system is under heavy use. To ensure the availability of + resources at the time of the course session(s), we recommend requesting for an + _advance resource reservation_. Please note: + + * The resource reservation must be requested **at least 14 days** before + the start of the course via [CSC Service Desk](../contact.md). + * The request should be motivated and include + 1. The course project number, + 2. the number of participants, + 3. the resources planned for the course, + 4. timetable showing the schedule of the course. + * The maximum amount and type of reservable resources are outlined in the + table below. + + | System | Approval | CPU limit | GPU limit | Max. daily time window | Max. course days in total | + |--------|----------|-----------|-----------|------------------------|---------------------------| + | Puhti | Automatic | 2 nodes (80 cores) | 0 | 08:00–17:00 | 5 | + | | CSC Resource Allocation Group | 5 nodes (200 cores) | 4 nodes (16 GPUs) | Up to 12 hrs (e.g., 08:00–20:00 or 12:00–24:00) | 10 | + | Mahti | Automatic | 2 nodes (256 cores) | 14 [GPU slices](../../computing/running/batch-job-partitions.md#gpu-slices) | 08:00–17:00 | 5 | + | | CSC Resource Allocation Group | 8 nodes (1024 cores) | 56 [GPU slices](../../computing/running/batch-job-partitions.md#gpu-slices) | Up to 12 hrs (e.g., 08:00–20:00 or 12:00–24:00) | 10 | + + A granted advance resource reservation will be visible in the form for + launching an interactive session in the web interfaces. Note that the option + will be greyed out until the start of the reservation. + + In batch job scripts, the advance resource reservation is activated using the + Slurm directive: + + ```bash + #SBATCH --reservation= + ``` + + Please note that the project number and partition must match what has been + specified for the advance resource reservation. + + ## Which service should I choose? + + The following table compares Noppe vs. Puhti and Mahti in order to help + selecting the most suitable service for your course. + + | Feature | | Noppe | Puhti | Mahti | + |---------|---------|:-----:|:-----:|:-----:| + | Prerequisites | | | | | + | | CSC Course project required | ❌ | ✅ | ✅ | + | | Teacher needs CSC account | ✅ | ✅ | ✅ | + | | Students need CSC accounts | ❌ | ✅ | ✅ | + | User interface | | | | | + | | Web interface | ✅ | ✅ | ✅ | + | | Command-line interface | ❌ | ✅ | ✅ | + | Graphical apps | | | | | + | | Jupyter Notebooks | ✅ | ✅ | ✅ | + | | RStudio | ✅ | ✅ | ✅ | + | | MATLAB | ❌ | ✅ | ✅ | + | | TensorBoard | ❌ | ✅ | ✅ | + | | MLflow | ❌ | ✅ | ✅ | + | | VS Code | ❌ | ✅ | ✅ | + | | Remote desktop | ❌ | ✅ | ✅ | + | | Remote desktop with GPU acceleration | ❌ | ✅ | ❌ | + | Resources | | | + | | CPU | ✅ | ✅ | ✅ | + | | GPU | ❌ | ✅ | ✅ | + | | Shared storage quota | 20 GiB | 1 TiB | 1 TiB | + +=== "Pukki" + + Pukki is a Database-as-a-service (DBaaS), where you can launch a new database + "with a simple click". Pukki automates away the database maintenance and + administrative tasks of other services so that the teacher can focus on using/teaching + the actual topic of databases. + + Instead of manually setting up your own database that you have to maintain yourself, + you can use DBaaS to manage the tedious tasks of provisioning, configuring, maintaining, + updating, documenting and backing up your database. + + ## Instructions + + !!! info + If each student needs their own Pukki DBaaS instance, they should create + a CSC Student project and activate the Pukki service within that project. + + ### Teacher -### Overview + 1. [Create a CSC user account](../../accounts/how-to-create-new-user-account.md). + 2. [Create a CSC Course project](../../accounts/how-to-create-new-project.md#course). + 3. [Add Pukki service access to the project](../../accounts/how-to-add-service-access-for-project.md#project-manager). + 4. Based on the nature of your course: + 1. In case of one database, use its tools to create accounts for students. + 2. If each student needs their own database, ask them to create a student project. + 5. Prepare the course content. + 1. [Consult the documentation](../../cloud/dbaas/index.md). + 2. [Contact CSC Service Desk if you need support](../contact.md). + + ### Student + + 1. Follow these instructions to find out how to create a student project: [Getting started with CSC services for students](student_quick.md) + 2. Then, add Pukki service to that project. + +=== "Rahti" -Sensitive Data (SD) Desktop allows you to analyze sensitive research data from -your web browser securely. With this user interface, you can easily manage -a virtual computer (here called desktop, technically defined as virtual machine). + Rahti is an orchestration service for containers that runs on OKD. Educators + can launch services to be used on a course, or Rahti can form part of the course itself. + The service is for example useful for teaching CI/CD pipelines. -### Instructions + Like cPouta, Rahti offers similar multipurpose technology, but without the burden + of having to maintain the operating system yourself. A variety of ready-made templates + can be used with just one click, saving you the trouble of installing services as you + would in cPouta. -#### Teacher + ## Instructions + + !!! info + If students should **not** have access to others' Rahti environments, + they should use a CSC Student project instead. + + ### Teacher + + 1. [Create a CSC user account](../../accounts/how-to-create-new-user-account.md). + 2. [Create a CSC Course project](../../accounts/how-to-create-new-project.md#course). + 3. [Add Rahti service access to the project](../../accounts/how-to-add-service-access-for-project.md#project-manager). + 4. Based on the nature of your course: + 1. If each student needs isolated Rahti namespace environment, ask them to create a student project. + 2. If students sharing and seeing each other's environments is not a problem, + invite students to the project either by + 1. [using an invitation link](../../accounts/how-to-add-members-to-project.md#using-invitation-link) (recommended) + 2. [or directly](../../accounts/how-to-add-members-to-project.md#adding-members-directly). + 5. Prepare the course content. + 1. [Consult the documentation](../../cloud/rahti/index.md). + 2. [Contact CSC Service Desk if you need support](../contact.md). + + ### Student + + 1. If an isolated Rahti namespace environment is required, follow these instructions + to find out how to create a student project: [Getting started with CSC services for students](student_quick.md) + 1. then, add Rahti service to that project. + 2. Or if an access to a shared container environment is required: + 1. [Create a CSC user account](../../accounts/how-to-create-new-user-account.md). + 2. Join the course project: + 1. If you've been sent a project invitation link, [accept the invitation in MyCSC](../../accounts/how-to-add-members-to-project.md#member). + 2. If you've been added directly to the course project, no further actions are required to join the course project. + 3. [Accept the relevant terms of service in MyCSC](../../accounts/how-to-add-service-access-for-project.md#member). + +=== "SD Desktop" + + Sensitive Data (SD) Desktop allows you to analyze sensitive research data from + your web browser securely. With this user interface, you can easily manage + a virtual computer (here called desktop, technically defined as virtual machine). + + ## Instructions + + ### Teacher -1. [Create a CSC user account](../../accounts/how-to-create-new-user-account.md). -2. [Create a CSC Course project](../../accounts/how-to-create-new-project.md#course). -3. [Add Sensitive Data (SD) Desktop service access to the project](../../accounts/how-to-add-service-access-for-project.md#project-manager). -4. Invite students to the project either by - 1. [using an invitation link](../../accounts/how-to-add-members-to-project.md#using-invitation-link) (recommended) - 2. [or directly](../../accounts/how-to-add-members-to-project.md#adding-members-directly). -5. Prepare the course content. - 1. [Consult the documentation](../../data/sensitive-data/sd_desktop.md). - 2. [Contact CSC Service Desk if you need support](../contact.md). + 1. [Create a CSC user account](../../accounts/how-to-create-new-user-account.md). + 2. [Create a CSC Course project](../../accounts/how-to-create-new-project.md#course). + 3. [Add Sensitive Data (SD) Desktop service access to the project](../../accounts/how-to-add-service-access-for-project.md#project-manager). + 4. Invite students to the project either by + 1. [using an invitation link](../../accounts/how-to-add-members-to-project.md#using-invitation-link) (recommended) + 2. [or directly](../../accounts/how-to-add-members-to-project.md#adding-members-directly). + 5. Prepare the course content. + 1. [Consult the documentation](../../data/sensitive-data/sd_desktop.md). + 2. [Contact CSC Service Desk if you need support](../contact.md). -#### Student + ### Student -1. [Create a CSC user account](../../accounts/how-to-create-new-user-account.md). -2. Join the course project: - 1. If you've been sent a project invitation link, [accept the invitation in MyCSC](../../accounts/how-to-add-members-to-project.md#member). - 2. If you've been added directly to the course project, no further actions are required to join the course project. -3. [Accept the relevant terms of service in MyCSC](../../accounts/how-to-add-service-access-for-project.md#member). + 1. [Create a CSC user account](../../accounts/how-to-create-new-user-account.md). + 2. Join the course project: + 1. If you've been sent a project invitation link, [accept the invitation in MyCSC](../../accounts/how-to-add-members-to-project.md#member). + 2. If you've been added directly to the course project, no further actions are required to join the course project. + 3. [Accept the relevant terms of service in MyCSC](../../accounts/how-to-add-service-access-for-project.md#member). From 0cea09f7e05a1c7d00964d7754c13ef0b88c734d Mon Sep 17 00:00:00 2001 From: Joona Tolonen Date: Thu, 18 Dec 2025 09:45:13 +0200 Subject: [PATCH 14/15] Small fixes. --- docs/support/tutorials/services-for-courses.md | 9 +++++++++ 1 file changed, 9 insertions(+) diff --git a/docs/support/tutorials/services-for-courses.md b/docs/support/tutorials/services-for-courses.md index a4b4a84ebe..785dcdffea 100644 --- a/docs/support/tutorials/services-for-courses.md +++ b/docs/support/tutorials/services-for-courses.md @@ -1,3 +1,8 @@ +--- +hide: + - toc +--- + # How to organize a course using CSC resources CSC services can be used for educational purposes in accordance with our @@ -323,9 +328,13 @@ This guide outlines how to organize a course using [Allas](#allas), [cPouta](#cp Sensitive Data (SD) Desktop allows you to analyze sensitive research data from your web browser securely. With this user interface, you can easily manage a virtual computer (here called desktop, technically defined as virtual machine). + SD Desktop is designed for managing sensitive data from any research field and for + diverse purposes. ## Instructions + + ### Teacher 1. [Create a CSC user account](../../accounts/how-to-create-new-user-account.md). From 437e74527ddd98aeff18ba1942c7891f5bc864b6 Mon Sep 17 00:00:00 2001 From: Joona Tolonen Date: Thu, 18 Dec 2025 10:05:22 +0200 Subject: [PATCH 15/15] Changed which service to choose into an own tab. --- .../support/tutorials/services-for-courses.md | 63 +++++++++---------- 1 file changed, 31 insertions(+), 32 deletions(-) diff --git a/docs/support/tutorials/services-for-courses.md b/docs/support/tutorials/services-for-courses.md index 785dcdffea..8bf465aff4 100644 --- a/docs/support/tutorials/services-for-courses.md +++ b/docs/support/tutorials/services-for-courses.md @@ -11,10 +11,37 @@ CSC services can be used for educational purposes in accordance with our The maximum lifetime of a CSC Course project, including all its enabled services, is six months. It is not possible to extend or transfer an existing CSC Course project. -This guide outlines how to organize a course using [Allas](#allas), [cPouta](#cpouta), -[Noppe](#noppe), [CSC supercomputers Puhti and Mahti](#puhti-and-mahti), [Pukki](#pukki), -[Rahti](#rahti) and [SD Desktop](#sensitive-data-sd-desktop). The guide also includes advice on -[how to select the most suitable service for your needs](#which-service-should-i-choose). +This guide outlines how to organize a course using Allas, cPouta, Noppe, +CSC supercomputers Puhti and Mahti, Pukki, Rahti and SD Desktop. Please see the details +below. + +=== "Which service(s) to choose?" + + The following table compares Noppe vs. Puhti and Mahti in order to help + selecting the most suitable service for your course. + + | Feature | | Noppe | Puhti | Mahti | + |---------|---------|:-----:|:-----:|:-----:| + | Prerequisites | | | | | + | | CSC Course project required | ❌ | ✅ | ✅ | + | | Teacher needs CSC account | ✅ | ✅ | ✅ | + | | Students need CSC accounts | ❌ | ✅ | ✅ | + | User interface | | | | | + | | Web interface | ✅ | ✅ | ✅ | + | | Command-line interface | ❌ | ✅ | ✅ | + | Graphical apps | | | | | + | | Jupyter Notebooks | ✅ | ✅ | ✅ | + | | RStudio | ✅ | ✅ | ✅ | + | | MATLAB | ❌ | ✅ | ✅ | + | | TensorBoard | ❌ | ✅ | ✅ | + | | MLflow | ❌ | ✅ | ✅ | + | | VS Code | ❌ | ✅ | ✅ | + | | Remote desktop | ❌ | ✅ | ✅ | + | | Remote desktop with GPU acceleration | ❌ | ✅ | ❌ | + | Resources | | | + | | CPU | ✅ | ✅ | ✅ | + | | GPU | ❌ | ✅ | ✅ | + | | Shared storage quota | 20 GiB | 1 TiB | 1 TiB | === "Allas" @@ -217,34 +244,6 @@ This guide outlines how to organize a course using [Allas](#allas), [cPouta](#cp Please note that the project number and partition must match what has been specified for the advance resource reservation. - ## Which service should I choose? - - The following table compares Noppe vs. Puhti and Mahti in order to help - selecting the most suitable service for your course. - - | Feature | | Noppe | Puhti | Mahti | - |---------|---------|:-----:|:-----:|:-----:| - | Prerequisites | | | | | - | | CSC Course project required | ❌ | ✅ | ✅ | - | | Teacher needs CSC account | ✅ | ✅ | ✅ | - | | Students need CSC accounts | ❌ | ✅ | ✅ | - | User interface | | | | | - | | Web interface | ✅ | ✅ | ✅ | - | | Command-line interface | ❌ | ✅ | ✅ | - | Graphical apps | | | | | - | | Jupyter Notebooks | ✅ | ✅ | ✅ | - | | RStudio | ✅ | ✅ | ✅ | - | | MATLAB | ❌ | ✅ | ✅ | - | | TensorBoard | ❌ | ✅ | ✅ | - | | MLflow | ❌ | ✅ | ✅ | - | | VS Code | ❌ | ✅ | ✅ | - | | Remote desktop | ❌ | ✅ | ✅ | - | | Remote desktop with GPU acceleration | ❌ | ✅ | ❌ | - | Resources | | | - | | CPU | ✅ | ✅ | ✅ | - | | GPU | ❌ | ✅ | ✅ | - | | Shared storage quota | 20 GiB | 1 TiB | 1 TiB | - === "Pukki" Pukki is a Database-as-a-service (DBaaS), where you can launch a new database