====== Grupy Badawcze ======

===== Co to jest grupa badawcza? =====

Zgodnie z [[https://hpc.mini.pw.edu.pl/rules/|regulaminem]] użytkowania zasobów klastra Eden, każdy użytkownik klastra musi być członkiem jakiejś grupy badawczej. Jest to jednostka organizacyjna pozwalająca na efektywne zarządzanie przydziałem zasobów obliczeniowych.

===== Kto może utworzyć własną grupę badawczą? =====

Na czele każdej grupy badawczej stoi kierownik grupy badawczej - jeden z pracownik naukowych Mini PW, tzn. osoba która spełnia łącznie dwa warunki:
  - Jest pracownikiem zatrudnionym na wydziale MiniPW. 
  - Złożyła deklarację o przynależności do tzw. Liczby N.

Istnieje możliwość utworzenia grup badawczych dla pracowników PW spoza wydziału MINI na mocy odrębnych porozumień z wydziałem.
===== Jakie sobą obowiązki kierownika grupy badawczej? =====

Kierownik grupy badawczej, oprócz tego, że przysługują mu te same prawa co innym użytkownikom (czyli dostęp do klastra obliczeniowego), zobowiązuje się dodatkowo do:

  - kierownik odpowiada za nadzorowanie co robią na klastrze użytkownicy przypisani do jego grupy, w szczególności, w miarę możliwości, monitoruje czy zasoby są użytkowane w sposób efektywny lub czy nie są wykorzystywane w sposób niezgodny z przeznaczeniem. Oczekuje się, że kierownik pozostaje w stałym kontakcie z członkami swojej grupy, i że osoby te realizują wyłącznie zadania na jego polecenie.
  - kierownik otrzyma od pomocy technicznej wskazówki w jaki sposób uzyskać informacje o historii uruchomionych zadań i wykorzystanych zasobach.
  - w przypadku gdy obliczenia na klastrze przyczynią się do powstania publikacji naukowej lub pracy dyplomowej, prosimy o dopilnowanie by w jej treści pojawiła się formułka, której treść znajduje się w regulaminie dostępnym na stronie https://hpc.mini.pw.edu.pl/rules
  - raz do roku poproszę w imieniu Rady HPC o złożenie sprawozdania z tego jakie prace były prowadzone na klastrze i jakie były ich owoce. Tego typu informacje pozwalają nam śledzić nasz wpływ na środowisko naukowe oraz ułatwią nam starania o finansowanie.
  - Również raz na jakiś czas będę wysyłał prośbę o weryfikację aktualności składu grupy.

==== Jak utworzyć nową grupę badawczą? ====

Wystarczy, gdy osoba spełniająca warunki wyśle maila na adres [[michal.kadlof@pw.edu.pl]] prośbę o utworzenie takiej grupy.

Mail musi zawierać:
  - propozycję nazwy grupy
  - złożyć deklarację akceptacji regulaminu korzystania z klastra i zobowiązania do wypełniania obowiązków kierownika grupy.
  - Opcjonalnie lista osób która powinna zostać dołączona do grupy. Lista musi zawierać w imię i nazwisko oraz adres e-mail:
    - w przypadku osób z PW mail musi pochodzić z domeny  @pw.edu.pl)
    - w przypadku osób z poza PW mail może być dowolny. 

==== Jaka może być nazwa grupy? ====

Nazwa musi spełniać kilka warunków:
  - powinna być krótka - najlepiej do 16 znaków
  - może się składać tylko z małych liter alfabetu łacińskiego cyfr i symbolu łącznika "-"
  - nazwy nie można zmienić w przyszłości
  - nazwa powinna być powiązana z osobą kierownika (a nie z jakimś bieżącym projektem badawczym).

Przykładowa nazwa: ''kowalski-lab''

Nazwa służy do identyfikowania grupy w systemie. Użytkownicy muszą ją podawać przy uruchamianiu zadań w celu wskazania, na poczet której grupy mają zostać naliczone godziny wykorzystania klastra.

==== W jaki sposób kierownik może monitorować wykorzystanie zasobów w swojej grupie? ==== 

Do śledzenia wykorzystania zasobów wykorzystuje się polecenia systemu kolejkowego slurm, które należy uruchomić na hoście dostępowym ''eden''.

  * ''sshare -laA <nazwa-zespołu>'' - polecenie wypisze udziały i wykorzystanie dla grupy i poszczególnych członków. Pierwszy wiersz dotyczy grupy, a pozostałe członków grupy: kolumny ''NormShares'' i ''EffectvUsage'' prezentują udział w mocy oraz faktyczne wykorzystanie. Kolumna `LevelFairshare` prezentuje czy grupa/użytkownik wykorzystuje mniej czy więcj niż swój udział. Wartości poniżej 1 oznaczają, że grupa liczy więcej niż wynosi jej udział, a algorytm będzie obniżać priorytet zadań i odwrotnie.
  * ''sacct -A <nazwa-zespołu>'' - pozwala wypisać zadania danego zespołu. Dodatkowe opcje zadania pozwalają zdefiniować zakres czasowy oraz wyświetlić dodatkowe informacje o zadaniach.
  * Raporty zbiorcze można generować poleceniem ''sreport cluster accountutilizationbyuser accounts=<nazwa-zespołu>''

Wspomniane polecenia mają liczne opcje formatujące, dzięki którym można zmieniać zakres czasowy i poziom szczegółowości danych. W razie potrzeby pomocy w generowaniu raportu lub ich interpretacji administrator służy pomocą techniczną. 

== Ostatnia aktualizacja treści: 10 sty 2025 ==