Troubleshooting: Pliki i kopie zapasowe

Rozwiązywanie problemów z plikami serwera i backupami.

Problemy z edycją plików INI

Problem: Zmiany w GameUserSettings.ini nie działają

Najczęstsze przyczyny:

1. Nie zrestartowałeś serwera

Dashboard → Servers → [Serwer] → Power → Restart

Zmiany INI wymagają restartu aby wejść w życie.

2. Błędna sekcja w pliku

ARK INI ma wiele sekcji. Parametr musi być w odpowiedniej:

# ❌ ŹLE - parametr w złej sekcji
[ServerSettings]
XPMultiplier=3.0  # To nie zadziała!

# ✅ DOBRZE
[/Script/ShooterGame.ShooterGameMode]
XPMultiplier=3.0

3. Błąd składni

# ❌ ŹLE - spacje, znaki specjalne
XP Multiplier = 3.0
XPMultiplier = 3,0  (przecinek zamiast kropki)

# ✅ DOBRZE
XPMultiplier=3.0

4. Serwer nadpisuje plik

Niektóre parametry są kontrolowane przez Settings UI:

Dashboard → Settings → Game → XP Multiplier: 3.0
(To nadpisze ręczną edycję INI)

Rozwiązanie: Używaj Settings UI zamiast edycji INI dla podstawowych parametrów.

Problem: Nie mogę zapisać zmian w INI

Błąd: "Permission denied" lub "File locked"

Przyczyna: Serwer używa pliku (jest RUNNING).

Rozwiązanie:

1. Zatrzymaj serwer (Stop)
2. Edytuj plik
3. Save
4. Uruchom serwer (Start)

Alternatywnie: Użyj funkcji "Edit while running" (beta):

Files → GameUserSettings.ini → ⋮ → Force Edit
(Ostrzeżenie: może spowodować corrupted file)

Problem: Plik INI znikł lub jest pusty

Przyczyna: Corrupted podczas zapisu lub przypadkowe usunięcie.

Rozwiązanie:

Opcja 1: Przywróć z backupu

Dashboard → Backups → [Najnowszy backup]
⋮ → Restore → Restore Type: CONFIGS_ONLY

Opcja 2: Regeneruj domyślny plik

Files → Delete GameUserSettings.ini
Restart serwera (wygeneruje nowy z domyślnymi wartościami)

Opcja 3: Skopiuj template

Dashboard → Files → Templates → ARK ASA Default Config
Copy content → Paste do GameUserSettings.ini → Save

Problemy z backupami

Problem: Backup nie kończy się (status CREATING >1h)

Oczekiwany czas:

• THIN backup (configs only): 10-30 sekund
• FULL backup (cały serwer): 5-20 minut

Jeśli przekroczyłeś:

Krok 1: Sprawdź postęp

Dashboard → Backups → [Backup]
Progress: 45.2%
Stage: COMPRESSING

Krok 2: Sprawdź rozmiar serwera

Dashboard → [Serwer] → Status
Disk Usage: 15.3 GB

Duże serwery (>20 GB) mogą zajmować >30 minut.

Krok 3: Cancel jeśli stuck Jeśli progress nie zmienia się przez >10 min:

Backups → [Backup] → ⋮ → Cancel Backup
Poczekaj 2 minuty → Create Backup ponownie

Problem: Backup failed (status FAILED)

Sprawdź error message:

Backups → [Failed backup] → kliknij
Error: "..."

Częste błędy:

Error	Przyczyna	Rozwiązanie
Insufficient storage	Brak miejsca na backupy	Usuń stare backupy lub ulepsz plan
Server still running	Backup FULL wymaga zatrzymania	Zatrzymaj serwer lub użyj THIN
Disk I/O error	Problem z dyskiem node	Retry za 5 min lub kontakt support
Compression failed	Corrupted files w save	Sprawdź integrity files (usuń .corrupted)

Uniwersalne rozwiązanie:

1. Zatrzymaj serwer
2. Dashboard → Files → usuń pliki *.corrupted
3. Uruchom serwer → poczekaj 1 min
4. Zatrzymaj serwer
5. Create FULL backup

Problem: Limit backupów osiągnięty

Błąd: "Backup limit reached (10/10)"

Rozwiązanie:

Opcja 1: Usuń stare backupy

Dashboard → Backups
Sortuj: Oldest first
Usuń backupy starsze niż 30 dni

Opcja 2: Download i archive lokalnie

Backups → [Stary backup] → ⋮ → Download
Zapisz na swoim dysku → Usuń z platformy

Opcja 3: Ulepsz plan

Starter (10 backups) → Pro (30 backups)

Best practice - automatyczne czyszczenie:

Dashboard → Schedules → Create Schedule
Action: BACKUP
Config:
  backupType: FULL
  retention: 7  # Auto-delete backupy starsze niż 7 dni

Problemy z przywracaniem backupów

Problem: Restore failed

Error: "Restore failed - checksum mismatch"

Przyczyna: Backup corrupted (uszkodzony podczas tworzenia/storage).

Nie ma rozwiązania - backup jest bezużyteczny.

Zapobieganie:

• Regularnie testuj restore (raz w miesiącu)
• Trzymaj 3-5 kopii backupów (rotacja)
• Używaj FULL backups dla krytycznych momentów

Problem: Po restore serwer nie startuje

Sprawdź co przywróciłeś:

Jeśli FULL restore:

• Przywróciłeś WSZYSTKO (configs, saves, mods)
• Sprawdź czy mody są kompatybilne z obecną wersją ARK

Jeśli CONFIGS_ONLY:

• Przywróciłeś tylko INI files
• Save files pozostały stare → może być mismatch

Rozwiązanie:

Opcja 1: Restore innego backupu

Backups → [Wcześniejszy backup] → Restore

Opcja 2: Fresh start

Files → usuń wszystkie pliki SavedArks/*.ark
Restart serwera (nowy save)

Opcja 3: Kontakt support Podaj:

• Backup ID
• Error message z Console
• Timestamp restore

Problem: Po restore brakuje struktur/dinos graczy

Możliwe przyczyny:

1. Przywróciłeś stary backup

• Sprawdź datę backupu: Created: 2025-09-15
• Wszystko po tej dacie zostało utracone

2. Przywróciłeś THIN zamiast FULL

• THIN = tylko configs (bez saves)
• Sprawdź typ: Type: THIN

3. Backup był przed dodaniem graczy

• Backup zawiera stan serwera sprzed graczy

Niestety nie ma rozwiązania - dane sprzed backupu są utracone.

Zapobieganie:

• Twórz backupy CODZIENNIE (harmonogram)
• Przed ważnymi zmianami: manual FULL backup
• Sprawdzaj Type i Created At przed restore

Upload/Download plików

Problem: Upload pliku nie kończy się

Oczekiwany czas upload:

• <10 MB: 10-30 sekund
• 10-100 MB: 30 sekund - 2 minuty

• 100 MB: 2-10 minut

Jeśli timeout (>10 min):

Rozwiązanie:

1. Użyj FTP zamiast web upload

Dashboard → Files → FTP Access
Host: ftp.sgshub.eu
Port: 21
User: srv_xyz789
Password: [pokazane w UI]

Użyj FileZilla lub WinSCP

2. Compress plik przed uploadem

# Na swoim PC
Zip lub 7z → upload compressed
Po uploaderze: rozpakuj w Files → Extract

3. Split duże pliki

# Windows PowerShell
$file = "bigfile.ark"
$chunkSize = 100MB
$chunks = [math]::Ceiling((Get-Item $file).Length / $chunkSize)
...
Upload części osobno → merge na serwerze

Problem: Download backupu timeout

Przyczyna: Backup za duży (>5 GB), connection timeout.

Rozwiązanie:

Użyj resume-capable download managera:

• Windows: Internet Download Manager (IDM)
• Mac: Folx
• Linux: wget z -c flag

wget -c "https://cdn.sgshub.eu/backups/bak_abc123?token=..."

Jeśli przerwanie → restart pobierania od miejsca przerwania.

Powiązane strony

• Guides: Pliki
• Guides: Backupy
• Troubleshooting: Serwery
• FAQ