Kopie zapasowe

Katalogi przestrzeni roboczych (/home, /work, /projects) oprócz migawek (dostępnych w podkatalogu .snap każdego katalogu) są także objęte mechanizmem kopii zapasowych.

Harmonogram

Kopie katalogów tworzone są na podstawie codziennych migawek w następujących godzinach:

  • projektów /projects - 02:05
  • użytkowników /home, /work - 03:05

System skonfigurowany jest do utrzymywania kopii zapasowych zależnie od terminu ich wykonania, więc użytkownik ma dostęp do:

  • 7 kopii dziennych
  • 4 kopii tygodniowych
  • 6 kopii miesięcznych
  • 1 kopii rocznej

Odzyskiwanie danych

Interfejs web

W przypadku potrzeby odzyskania niezbyt dużych danych najwygodniej jest użyć interfejsu webowego.

Do zalogowania należy użyć poświadczeń WMICluster upewniając się, że pole Realm/Uwierzytelnianie ustawione jest na cluster.wmi.amu.edu.pl. Po poprawnym zalogowaniu może pojawić się komunikat o błędzie permission check failed (403) - można go bezpiecznie zignorować.

Z drzewa po lewej stronie ekranu należy przejść do: Datastore/Magazyny danych -> cephfs, a następnie do karty Content/Zawartość. W centralnej części interfejsu pojawi się kolejne drzewo zawierające elementy, do których użytkownik ma dostęp:

  • katalogi projektowe - projects
  • katalogi użytkownika - users

Aby przejść do danego elementu należy dwukrotnie kliknąć w jego nazwę lub wybrać ikonę 📂 z kolumny Działania/Actions. Czynność należy powtarzać aż do uzyskania docelowego zasobu. Zasoby prezentowane są jako drzewa pogrupowane według terminu utworzenia kopii.

W przypadku katalogów użytkownika dostępne są osobne zasoby dla katalogów oznaczone odpowiednio:

  • /home - <login>_home.ppxar.didx
  • /work - <login>_work.ppxar.didx

Analogicznie dla każdego katalogu projektowego dostępny jest osobny zasób, np. dla /projects/ai_snake będzie to projects_ai_snake.mpxar.didx.

Po zlokalizowaniu interesującego nas zasobu w drzewie należy dla pliku z rozszerzeniem .pxar.didx kliknąć 📂 w kolumnie Działania/Actions. Otworzy to interfejs przeglądania zawartości kopii, za którego pomocą można pobrać pliki lub katalogi.

Zagrożenie

Próba pobrania danych o zbyt dużym rozmiarze może zakończyć się niepowodzeniem. W takim wypadku należy użyć alternatywnej metody dostępu poprzez zamontowanie kopii.

Montowanie kopii zapasowej

W celu odzyskania danych od dużej pojemności należy zamontować kopię zapasową używając dostępu SSH.

Należy skonfigurować lokalizację repozytorium kopii zapasowych oraz utworzyć wymagane katalogi:

export PBS_REPOSITORY=$USER@cluster.wmi.amu.edu.pl@backup.cluster.wmi.amu.edu.pl:443:cephfs
if [ -z "${XDG_RUNTIME_DIR}" ];then export XDG_RUNTIME_DIR=~/.xdg; mkdir ~/.xdg; chmod 0700 ~/.xdg; fi

Używając poświadczeń WMICluster należy zalogować się do systemu kopii zapasowych:

proxmox-backup-client login

Katalogi użytkownika

W przypadku katalogów użytkownika (/home oraz /work) należy wylistować dostępne kopie zapasowe:

proxmox-backup-client snapshot list host/wmicluster-backup --ns users/$USER

Po wybraniu docelowej kopii należy ją zamontować używając odpowiedniego pliku kopii:

mkdir backup_mount

# należy podać odpowiedni plik do zamontowania wraz z backupem:
# <username>_home.mpxar - dla /home/<username>
# <username>_work.mpxar - dla /work/<username>

proxmox-backup-client mount host/wmicluster-backup/2026-09-28T03:04:24Z \
    s329549_home.mpxar backup_mount --ns users/$USER

Kopia dostępna jest w trybie tylko do odczytu w katalogu backup_mount:

ls -al backup_mount/

Po zakończeniu operacji należy odmontować kopię:

umount backup_mount

Katalogi projektowe

Należy wylistować dostępne kopie zapasowe:

proxmox-backup-client namespace list --ns projects

Przykładowe wyjście:

projects
projects/ai_snake
projects/wmi_spack

Dla wybranego katalogu projektu należy wylistować dostępne kopie zapasowe:

 proxmox-backup-client snapshot list host/wmicluster-backup --ns projects/ai_snake

Po wybraniu docelowej kopii należy ją zamontować używając odpowiedniego pliku kopii:

mkdir backup_mount

# należy podać odpowiedni plik z rozszerzeniem .mpxar do zamontowania wraz z backupem
# uwaga: nazwa katalogu projektowego użyta jest także w parametrze --ns

proxmox-backup-client mount host/wmicluster-backup/2026-09-28T00:09:49Z \
    projects_ai_snake.mpxar backup_mount --ns projects/ai_snake

Kopia dostępna jest w trybie tylko do odczytu w katalogu backup_mount:

ls -al backup_mount/

Po zakończeniu operacji należy odmontować kopię:

umount backup_mount

Kończenie pracy

Po odzyskaniu danych należy wylogować się z systemu kopii zapasowych:

proxmox-backup-client logout
unset PBS_REPOSITORY

Rozwiązywanie problemów

Brak katalogu montowania

Error: pxar mount failed: No such file or directory (os error 2)

Oznacza brak docelowego katalogu montowania kopii. Należy go utworzyć (np. mkdir backup_mount) i spróbować ponownie.

Próba podwójnego zamontowania

fusermount3: failed to access mountpoint /home/<username>/backup_mount: Permission denied
Error: pxar mount failed: mount failed

Nastąpiła próba zamontowania kopii w katalogu, który jest już aktywnym celem montowania. Należy odmontować poprzedni zasób (np. umount backup_dir) i spróbować ponownie.

Niepoprawny parametr --ns

Error: no permissions on /datastore/cephfs/projects/ai_snake

Należy upewnić się że parametr --ns odpowiada katalogowi projektowemu, który ma być obsłużony.

Error: parameter verification failed - 'ns': value does not match the regex pattern

Należy sprawdzić czy wartość parametru --ns jest prawidłowa. Na przykład --ns users/$USER może zostać niepoprawnie skopiowany do powłoki jako --ns users/\$USER (dodany znak \).