Spis treści dokumentacji

Aktualizacja serwera

Zaktualizujesz serwer Gadki do nowej wersji tym samym instalatorem, bez utraty konfiguracji i danych.

Serwer aktualizujesz, uruchamiając nowy instalator .run na tej samej maszynie. Instalator sam rozpoznaje istniejącą instalację: wymienia programy i usługi systemd, uzupełnia schemat bazy i uruchamia serwer ponownie. Konfiguracji i kluczy w /etc/gadka ani danych w /var/lib/gadka nie zmienia.

Zanim zaczniesz

  • Nowy instalator serwera ze strony gadka.lemric.com/pobierz, w wersji 0.3.2 lub nowszej, skopiowany na serwer.
  • Dostęp root.
  • Kilka minut przerwy. Aplikacje użytkowników połączą się ponownie same.

Krok 1. Zrób kopię zapasową

Dla bazy SQLite:

sudo gadka --config /etc/gadka/gadka.yaml admin backup --out /var/lib/gadka/przed-aktualizacja.db

Dla PostgreSQL i MySQL użyj narzędzi swojej bazy. Zobacz Kopie zapasowe i odtwarzanie.

Krok 2. Uruchom nowy instalator

chmod +x gadka-server-<wersja>-linux-amd64.run
sudo ./gadka-server-<wersja>-linux-amd64.run

Instalator wykryje plik /etc/gadka/gadka.yaml i zamiast pytań instalacyjnych wyświetli:

Gadka — aktualizacja istniejącej instalacji

Konfiguracja /etc/gadka i dane /var/lib/gadka pozostają bez zmian.
Przed aktualizacją zrób kopię zapasową bazy danych.
Kontynuować? (tak/nie) [tak]:

Krok 3. Potwierdź

Naciśnij Enter albo wpisz tak. Każda inna odpowiedź przerywa aktualizację bez żadnych zmian (Błąd: przerwano).

Instalator po kolei:

  1. zatrzymuje usługi gadka i gadka-proxy,
  2. wymienia programy /usr/local/bin/gadka i /usr/local/bin/gadka-caddy oraz pliki usług systemd,
  3. zapisuje plik /etc/systemd/system/gadka.service.d/10-credentials.conf, dzięki któremu serwer może wyliczyć Server ID,
  4. uzupełnia schemat bazy (Migracja bazy…),
  5. uruchamia usługi.

Na końcu zobaczysz:

Gotowe. Zaktualizowano do wersji …

Krok 4. Sprawdź wynik

gadka --version
systemctl status gadka gadka-proxy
gadka healthcheck && echo OK

Usługi powinny być w stanie active (running), a ostatnie polecenie wypisać OK. Zaloguj się w aplikacji i wyślij wiadomość testową.

Po aktualizacji z wersji starszej niż 0.3.2

Aktualizacja nie zmienia pliku gadka.yaml. Instalacje utworzone starszym instalatorem nie mają ustawienia zaufanego proxy, które nowe instalacje dostają od razu. Dopisz je ręcznie. Zobacz Plik konfiguracyjny.

Gdy coś pójdzie nie tak

  1. Zobacz błąd: journalctl -u gadka -n 50.
  2. Stan schematu bazy pokaże sudo runuser -u gadka -- /usr/local/bin/gadka --config /etc/gadka/gadka.yaml migrate status.
  3. Jeśli musisz wrócić do poprzedniej wersji, przywróć bazę z kopii z kroku 1. Opis odtwarzania: Kopie zapasowe i odtwarzanie.

Aplikacje użytkowników

Aplikacje desktopowe aktualizują się same, niezależnie od serwera. Zobacz Aktualizacje aplikacji.

Co dalej