System backupów

Kopie zapasowe chronią dane serwera przed utratą. SGS Hub oferuje dwa typy backupów: Thin i Full.

Typy backupów

Thin Backup (lekki backup)

Co zawiera:

• ✅ Pliki konfiguracyjne (.ini, .cfg)
• ✅ Save files (.ark, .arktribe)
• ✅ Player data
• ✅ Cluster data (jeśli serwer w klastrze)
• ❌ NIE zawiera: Plików gry, modów, binarek

Rozmiar: 50-500 MB (zależnie od liczby graczy)

Czas tworzenia: 1-3 minuty

Kiedy używać:

• ✅ Regularne backupy (codzienne/co-godzinne)
• ✅ Przed edycją plików konfiguracyjnych
• ✅ Przed aktualizacją modów
• ✅ Szybkie snapshoty postępu graczy

Kiedy NIE używać:

• ❌ Przed major updates gry (trzeba Full Backup)
• ❌ Przed zmianą wersji ARK (ASE → ASA)
• ❌ Gdy chcesz przenieść serwer na inną maszynę

Thin Backup to domyślny wybór

95% przypadków używaj Thin Backup. Jest szybki, mały, i wystarczający dla większości scenariuszy. Full Backup rezerwuj dla krytycznych momentów.

Full Backup (pełny backup)

Co zawiera:

• ✅ Wszystko z Thin Backup
• ✅ Pliki gry ARK (~35-40 GB)
• ✅ Wszystkie mody (~5-10 GB)
• ✅ Pliki binarne i cache
• ✅ Logi (opcjonalnie)

Rozmiar: 40-60 GB dla ARK, 10-30 GB dla FiveM

Czas tworzenia: 15-30 minut (zależnie od rozmiaru)

Kiedy używać:

• ✅ Przed major updates ARK/FiveM
• ✅ Przed instalacją wielu nowych modów
• ✅ Przed migracją serwera
• ✅ Raz w tygodniu jako disaster recovery
• ✅ Przed eksperymentalnymi zmianami

Kiedy NIE używać:

• ❌ Codzienne backupy (za duże, za wolne)
• ❌ Przed drobnymi zmianami w INI
• ❌ Gdy masz mało miejsca na dysku

Porównanie

Cecha	Thin Backup	Full Backup
Rozmiar	50-500 MB	40-60 GB
Czas tworzenia	1-3 min	15-30 min
Zawiera mody	❌	✅
Zawiera pliki gry	❌	✅
Przywrócenie	2-5 min	20-40 min
Użycie dysku	Niskie	Wysokie
Częstotliwość	Codziennie	Raz w tygodniu
Koszt	Niski (limity planu)	Wysoki (limity planu)

Tworzenie backupu

Ręczne tworzenie backupu

Krok 1: Otwórz zakładkę Backups

1. Panel serwera → zakładka Backups
2. Zobaczysz listę istniejących backupów

Krok 2: Utwórz backup

1. Kliknij Create Backup
2. Wybierz typ:
   • Thin Backup (zalecane)
   • Full Backup (dla ważnych momentów)
3. Wpisz nazwę backupu (opcjonalnie):

   Przykłady nazw:
   - before-mod-update-2025-10-26
   - weekly-backup-week43
   - pre-genesis-migration
   - daily-auto-backup

4. Dodaj opis (opcjonalnie):

   Backup przed instalacją Primal Fear moda.
   Wszystko działa stabilnie, 45 graczy online.

5. Kliknij Create

Krok 3: Poczekaj na zakończenie

Status backupu:

• PENDING - W kolejce
• CREATING - Trwa tworzenie (1-30 min)
• COMPLETED - Gotowy
• FAILED - Błąd

Progress bar pokazuje postęp:

• Thin: Compressing files... (0-100%)
• Full: Copying game files... (0-100%)

Nie zatrzymuj serwera podczas backupu

Możesz tworzyć backupy podczas gdy serwer działa. SGS Hub używa snapshot'ów aby uniknąć korupcji danych.

NIE zatrzymuj serwera podczas tworzenia backupu - może to spowodować incomplete backup.

Automatyczne backupy

Ustaw harmonogram automatycznych backupów.

Zobacz Harmonogramy dla szczegółów, ale w skrócie:

1. Zakładka Schedules → Create Schedule
2. Action: BACKUP
3. Typ: Thin
4. Cron: 0 */6 * * * (co 6 godzin)
5. Zapisz

Popularne harmonogramy:

Harmonogram	Cron	Opis
Co 6 godzin	0 */6 * * *	Thin backup 4x dziennie
Codziennie o 4:00 AM	0 4 * * *	Thin backup w nocy
Co tydzień w niedzielę	0 3 * * 0	Full backup raz w tygodniu
Co godzinę	0 * * * *	Thin backup (tylko dla krytycznych)

Strategia 3-2-1

Najlepsza strategia backupów:

• 3 kopie danych (oryginał + 2 backupy)
• 2 różne media (serwer SGS Hub + lokalny dysk)
• 1 kopia offsite (download Full Backup raz w miesiącu)

Przeglądanie backupów

Lista backupów

W zakładce Backups zobaczysz wszystkie backupy:

Kolumny:

• Nazwa - Nazwa backupu (lub auto-generated)
• Typ - Thin / Full
• Rozmiar - Wielkość w MB/GB
• Data utworzenia - Timestamp
• Status - Completed / Failed
• Akcje - Restore, Download, Delete

Sortowanie:

• Domyślnie: Najnowsze na górze
• Możesz sortować według: Nazwa, Typ, Rozmiar, Data

Filtrowanie:

• Wszystkie
• Tylko Thin
• Tylko Full
• Tylko Failed (do debugowania)

Szczegóły backupu

Kliknij backup aby zobaczyć szczegóły:

Informacje:

• Pełna nazwa - Z timestamp
• Typ - Thin lub Full
• Rozmiar skompresowany - Wielkość archiwum
• Rozmiar nieskompresowany - Wielkość po rozpakowaniu
• Data utworzenia - Kiedy powstał
• Czas trwania - Ile zajęło tworzenie
• Status serwera - RUNNING / STOPPED podczas backupu
• Liczba graczy - Ilu było online (dla kontekstu)

Zawartość (Thin Backup):

✓ GameUserSettings.ini (23 KB)
✓ Game.ini (15 KB)
✓ TheIsland.ark (450 MB)
✓ TheIsland.arktribe (120 MB)
✓ PlayerData/ (50 MB - 142 pliki)
✓ Cluster/ (5 MB)

Zawartość (Full Backup):

✓ All from Thin Backup
✓ ShooterGame/Binaries/ (8 GB)
✓ ShooterGame/Content/ (30 GB)
✓ Mods/ (7 GB - 15 modów)

Przywracanie z backupu

Przywracanie całego serwera

Scenariusz: Serwer crashnął, save'y są skorumpowane, chcesz wrócić do wcześniejszego stanu.

Krok 1: Zatrzymaj serwer

1. Panel serwera → Stop (⏹️)
2. Poczekaj aż status = STOPPED

Zatrzymaj serwer przed restore!

NIGDY nie przywracaj backupu gdy serwer działa. Spowoduje to korupcję danych i nieprzewidywalne zachowanie.

Krok 2: Wybierz backup

1. Zakładka Backups
2. Znajdź backup do przywrócenia
3. Sprawdź datę i rozmiar - upewnij się że to właściwy

Krok 3: Restore

1. Kliknij Restore (🔄) obok backupu
2. Dialog potwierdzenia:

   Czy na pewno chcesz przywrócić backup "before-mod-update-2025-10-26"?
   
   ⚠️ UWAGA:
   - Obecne pliki serwera zostaną NADPISANE
   - Postępy graczy od czasu backupu zostaną UTRACONE
   - Ta akcja jest NIEODWRACALNA bez backupu obecnego stanu
   - Serwer musi być ZATRZYMANY
   
   [ Cancel ] [ Restore Backup ]

3. Kliknij Restore Backup

Krok 4: Proces restore

Status:

• PREPARING - Przygotowanie (10s)
• EXTRACTING - Rozpakowywanie archiwum (1-5 min)
• COPYING - Kopiowanie plików (2-20 min zależnie od typu)
• COMPLETED - Zakończone

Czas:

• Thin Backup: 2-5 minut
• Full Backup: 20-40 minut

Krok 5: Uruchom serwer

1. Kliknij Start (▶️)
2. Sprawdź Console - szukaj komunikatów błędów
3. Po uruchomieniu, zweryfikuj że wszystko działa poprawnie

Weryfikacja po restore

Po restore sprawdź:

• ✅ Czy gracze mogą się połączyć
• ✅ Czy save'y się ładują
• ✅ Czy mody działają (jeśli były w backupie)
• ✅ Czy konfiguracja jest poprawna (INI files)

Przywracanie pojedynczych plików

Scenariusz: Skasowałeś GameUserSettings.ini przez pomyłkę, chcesz przywrócić tylko ten plik.

SGS Hub nie obsługuje jeszcze selective restore, ale możesz:

Metoda 1: Download → Extract → Upload

1. Download backup (ZIP/TAR.GZ)
2. Rozpakuj na swoim komputerze
3. Znajdź potrzebny plik
4. Upload przez zakładkę Files

Metoda 2: Restore całego backupu

Jeśli nie możesz wykonać Metody 1, restore całego backupu (nadpisze wszystko).

Metoda 3: Przez support

Skontaktuj się z supportem SGS Hub, mogą wyekstraktować konkretne pliki z backupu.

Download backupu

Pobieranie na lokalny dysk

Dlaczego downloadować:

• 📦 Offsite backup (3-2-1 strategy)
• 🔄 Migracja serwera na inną platformę
• 🔍 Analiza save'ów offline
• 🎁 Udostępnienie save'a innym

Jak pobrać:

1. Zakładka Backups
2. Kliknij Download (⬇️) obok backupu
3. Wybierz format:
   • ZIP - Uniwersalny (Windows, Mac, Linux)
   • TAR.GZ - Mniejszy rozmiar, lepszy dla Linuxa
4. Kliknij Download
5. Plik zostanie pobrany do Twojego folderu Downloads

Rozmiar downloadu:

• Thin Backup: 50-500 MB (1-5 minut)
• Full Backup: 40-60 GB (30-120 minut zależnie od internetu)

Full Backup download może trwać długo

Full Backup 50 GB przez internet 100 Mbps = ~1 godzina.

Zaplanuj download na noc lub gdy nie używasz internetu intensywnie.

Struktura pobranego backupu

Po rozpakowaniu ZIP/TAR.GZ:

backup-2025-10-26-123456/
├── metadata.json              # Metadane backupu
├── ShooterGame/
│   ├── Saved/
│   │   ├── Config/
│   │   │   └── WindowsServer/
│   │   │       ├── GameUserSettings.ini
│   │   │       └── Game.ini
│   │   ├── SavedArks/
│   │   │   └── TheIsland.ark
│   │   └── ...
│   └── Content/              # Tylko w Full Backup
│       └── Mods/
└── cluster/                  # Jeśli był w klastrze

Usuwanie backupów

Ręczne usuwanie

Krok 1: Wybierz backup

1. Zakładka Backups
2. Znajdź backup do usunięcia (zwykle najstarszy)

Krok 2: Usuń

1. Kliknij Delete (🗑️)
2. Potwierdź usunięcie
3. Backup zostaje permanentnie usunięty

Usunięcie jest nieodwracalne

Usunięte backupy nie mogą być przywrócone. Upewnij się że nie potrzebujesz backupu przed usunięciem!

Automatyczne czyszczenie

SGS Hub może automatycznie usuwać stare backupy według retention policy.

Konfiguracja:

1. Zakładka Backups → Settings (⚙️)
2. Retention Policy:
   • Keep last X backups - Zachowaj ostatnie X backupów (np. 10)
   • Keep backups for X days - Zachowaj backupy młodsze niż X dni (np. 30)
   • Keep weekly backups for X weeks - Zachowaj cotygodniowe przez X tygodni (np. 12)
3. Zapisz

Przykładowa policy:

✓ Zachowaj ostatnie 7 daily Thin Backups
✓ Zachowaj ostatnie 4 weekly Full Backups
✓ Usuń wszystko starsze niż 60 dni

Co się dzieje: SGS Hub automatycznie usuwa backupy pasujące do policy co 24h o północy.

Bulk delete

Usuwanie wielu backupów naraz:

1. Zaznacz checkboxy obok backupów
2. Kliknij Delete Selected
3. Potwierdź bulk delete

Use case: Czyszczenie 20 starych Thin Backups jednocześnie.

Limity backupów według planu

Każdy plan subskrypcji ma limit liczby backupów.

Plan	Max Thin	Max Full	Storage
Free	3	0	2 GB
Starter	10	2	10 GB
Pro	30	5	50 GB
Enterprise	100	20	200 GB

Co się dzieje gdy osiągniesz limit:

❌ Nie możesz utworzyć więcej backupów (limit: 30/30)

Opcje:
1. Usuń stare backupy
2. Upgrade do wyższego planu

[Delete Old Backups] [Upgrade Plan]

Storage limit: Jeśli Twoje backupy zajmują więcej niż limit storage:

• Najstarsze backupy są automatycznie usuwane
• Otrzymujesz notyfikację email o przekroczeniu limitu

Strategia dla limitów

• Używaj Thin Backups codziennie (małe, zmieści się wiele)
• Używaj Full Backups raz w tygodniu (duże, ale masz ich mniej)
• Downloaduj ważne Full Backups na lokalny dysk i usuń ze serwera

Troubleshooting

Backup failed podczas tworzenia

Sprawdź logi:

1. Kliknij failed backup
2. Zobacz Error log

Popularne błędy:

"Disk space full"

• Brak miejsca na dysku
• Usuń stare backupy lub nieużywane pliki
• Upgrade planu dla większego storage

"Server busy"

• Za dużo graczy online, operacje I/O są wolne
• Spróbuj utworzyć backup w godzinach niskiego ruchu (3-5 AM)

"Backup limit reached"

• Osiągnąłeś limit backupów dla planu
• Usuń stare backupy lub upgrade planu

Restore nie działa

Problem: Restore завис на 50% lub failed

Sprawdź:

1. Czy serwer jest zatrzymany (status: STOPPED)
2. Czy masz wystarczająco miejsca na dysku
3. Czy backup nie jest corrupted (spróbuj downloadować - jeśli download fails, backup jest uszkodzony)

Rozwiązanie:

• Zatrzymaj serwer i spróbuj ponownie
• Użyj starszego backupu jeśli obecny jest corrupted
• Skontaktuj się z supportem jeśli problem persystuje

Backup jest corrupted

Problem: Download backupu fails lub restore pokazuje błędy

Jak sprawdzić:

1. Download backupu
2. Spróbuj rozpakować ZIP/TAR.GZ
3. Jeśli nie można rozpakować = corrupted

Przyczyny:

• Serwer crashnął podczas tworzenia backupu
• Problem z dyskiem w Pterodactyl node
• Network error podczas uploadu backupu

Rozwiązanie:

• Użyj wcześniejszego, working backupu
• Zawsze miej 2-3 recent backupy na wypadek korupcji jednego

Po restore serwer nie startuje

Sprawdź Console:

• Szukaj błędów podczas ładowania
• Możliwe że backup zawiera corrupted save files

Rozwiązania:

1. Restore starszego backupu (sprzed korupcji)
2. Jeśli to był Full Backup z modami - sprawdź czy mody się załadowały
3. Spróbuj Thin Backup zamiast Full (może problem jest w plikach gry)

Best practices

Do's ✅

• ✅ Regularnie twórz backupy - Minimum raz dziennie
• ✅ Thin dla codziennych, Full dla tygodniowych - Oszczędza miejsce
• ✅ Backup przed zmianami - Przed instalacją modów, edycją INI, updates
• ✅ Testuj restore - Raz w miesiącu zrób test restore na serwerze testowym
• ✅ Download Full Backups offsite - 3-2-1 backup strategy
• ✅ Nazywaj backupy opisowo - "before-primal-fear" lepsze niż "backup-123"
• ✅ Monitoruj storage - Nie daj się zaskoczyć brakiem miejsca

Don'ts ❌

• ❌ Nie twórz backupów podczas ładowania serwera - Poczekaj aż status = RUNNING
• ❌ Nie restore na działającym serwerze - Zawsze zatrzymaj najpierw
• ❌ Nie kasuj wszystkich backupów naraz - Zachowaj przynajmniej 2-3 ostatnie
• ❌ Nie polegaj tylko na autobackupach - Ręczny backup przed critical changes
• ❌ Nie ignoruj failed backups - Sprawdź dlaczego failują
• ❌ Nie mieszaj backupów z różnych serwerów - Nazywaj jasno (server1-backup, server2-backup)

Następne kroki

• Harmonogramy - Automatyzacja backupów i innych zadań
• Troubleshooting - Rozwiązywanie problemów z plikami i backupami