﻿# Frissítés, mentés és visszaállítás

> Dockerben és Kubernetesen az appsettings.json kivételével minden az adatköteten van (/app/data). A felhős fájltárolók mentése a szolgáltatónál történik.

Source: https://workwise-solutions.net/hu/docs/installation/upgrade-backup-restore/ · Language: hu · English version: https://workwise-solutions.net/docs/installation/upgrade-backup-restore/

## Mit kell menteni

| Elem | Hol |
|---|---|
| Belső adatbázis | SQLite: `database.db` a `database.db-wal` és `database.db-shm` fájllal (mindig együtt). SQL Server, PostgreSQL, MySQL: az adatbázis saját mentőeszközeivel. |
| Szerverlemezes fájltároló | `FileStorage/` (mellékletek, komponensképek) |
| Szerkesztett sablonok | `LiveEmailTemplates/`, `LiveNotificationTemplates/` |
| Konfiguráció | `appsettings.json` |
| Naplók (opcionális) | `Logs/` |

Dockerben és Kubernetesen az `appsettings.json` kivételével minden az adatköteten van (`/app/data`). A felhős fájltárolók mentése a szolgáltatónál történik.

> **A mentések hitelesítő adatokat tartalmaznak.** Az adatbázisban az alkalmazás által visszafejthető formában vannak a fájltárolók kulcsai, az értesítési és e-mail hitelesítő adatok és más titkok, valamint a bejelentkezési sütiket védő kulcsok; az `appsettings.json` az aláíró kulcsokat és a kapcsolati titkokat tartalmazza. A mentéseket korlátozott hozzáféréssel és titkosítva tárolja, az ideiglenes másolatokat pedig törölje.

SQLite adatbázis másolása előtt állítsa le az alkalmazást: az adatbázis write-ahead-log módban fut, és futás közben készült másolata inkonzisztens lehet.

## Frissítés

1. Olvassa el a [kiadási jegyzékeket](https://workwise-solutions.net/hu/docs/release-notes/): ezek írják le, ha egy verzióhoz teendő tartozik, és hogy kell-e újabb .NET futtatókörnyezet.
2. Készítsen mentést az adatbázisról és az adatmappáról vagy -kötetről.
3. Cserélje le az alkalmazás fájljait (vagy az image-et), a saját `appsettings.json` megtartásával.
4. Indítsa el az alkalmazást. **Az adatbázis-migrációk induláskor automatikusan lefutnak.** Több szerver esetén csomópontok közötti zárolással futnak, így a szerverek együtt is frissíthetők. Az új beállítások alapértékkel bekerülnek az `appsettings.json`-ba.

Korábbi verzióra visszatérni a frissítés előtt készült mentés visszaállításával lehet: a migrációk nem fordíthatók vissza.

![Frissítés, mentés és visszaállítás](https://workwise-solutions.net/docs/images/diagram-upgrade-backup-hu.png)
*A frissítés lépései, a mentendő elemek és a visszalépés módja.*

Sablonok: IIS-es és linuxos frissítéskor a szerkesztett élő sablonok megmaradnak (a kiadás csak az alapértelmezetteket tartalmazza). Dockerben azok az image-ek, amelyeknél az élő sablonok a konténeren belül voltak, a konténer újralétrehozásakor elveszítik őket; előbb másolja ki őket a régi konténerből (lásd az üzemeltetői útmutatót).

Platformonkénti lépések: [Windows (IIS)](https://workwise-solutions.net/hu/docs/installation/windows-iis/#frissítés), [Linux](https://workwise-solutions.net/hu/docs/installation/linux/#frissítés), [Kubernetes](https://workwise-solutions.net/hu/docs/installation/kubernetes/#üzemeltetés).

## Docker

Mentés (Linuxon; a segédparancs az alkalmazás image-ét használja, hálózat nélkül fut):

```bash
docker stop worksmarthub
docker run --rm --network none -v worksmarthub-data:/app/data -v "$PWD":/backup --user "$(id -u):$(id -g)" \
  --entrypoint sh worksmarthub:23 -c 'umask 077; tar czf "/backup/worksmarthub-data-$(date +%F).tgz" -C /app/data .'
docker start worksmarthub
```

Visszaállítás (leállított alkalmazással; a teljes kötetet lecseréli):

```bash
docker run --rm --network none -u 0 --cap-drop ALL --cap-add CHOWN --cap-add DAC_OVERRIDE --cap-add FOWNER \
  -v worksmarthub-data:/app/data -v "$PWD":/backup:ro --entrypoint sh worksmarthub:23 \
  -c 'tar tzf /backup/worksmarthub-data-YYYY-MM-DD.tgz >/dev/null && find /app/data -mindepth 1 -delete && tar xzf /backup/worksmarthub-data-YYYY-MM-DD.tgz -C /app/data && chown -R 1001:1001 /app/data'
```

Frissítés: `docker stop worksmarthub && docker rm worksmarthub`, majd indítsa el az új image-et ugyanazzal a kötettel.

Vigyázzon a kötetre: a nevesített kötetek túlélik a `docker rm` parancsot és az image-frissítést, de a `docker volume prune -a`, valamint a Docker Desktop *Clean / Purge data* és *Reset to factory defaults* funkciója törli őket. Ezek előtt mindig készítsen mentést.

## Átköltözés másik szerverre vagy adatbázisba

- Azonos adatbázistípus esetén: mentse és állítsa vissza az adatbázist és az adatmappát, másolja át az `appsettings.json` fájlt (ugyanazokkal az aláíró kulcsokkal, különben a munkamenetek, a tokenek és a fájlhivatkozások megszűnnek), és állítsa a `PublicBaseUrl` értékét az új címre. A mellékletek és képek hivatkozásai automatikusan az aktuális címre épülnek fel.
- A Kubernetes üzemeltetői útmutatóban külön fejezet szól a környezetek közötti átköltözésről.
