﻿# Telepítés Windowsra (IIS)

> Az IIS a WorkSmartHub-ot folyamaton belül (in-process) futtatja: kezeli a folyamatot, és fordított proxyként is működik, így külön Windows-szolgáltatásra nincs szükség. Mivel a háttérfolyamatok a webes folyamatban futnak, az IIS-nek akkor is futva kell tartania ezt a folyamatot, amikor senki sem…

Source: https://workwise-solutions.net/hu/docs/installation/windows-iis/ · Language: hu · English version: https://workwise-solutions.net/docs/installation/windows-iis/

Az IIS a WorkSmartHub-ot folyamaton belül (in-process) futtatja: kezeli a folyamatot, és fordított proxyként is működik, így külön Windows-szolgáltatásra nincs szükség. Mivel a háttérfolyamatok a webes folyamatban futnak, az IIS-nek akkor is futva kell tartania ezt a folyamatot, amikor senki sem használja az oldalt.

![WorkSmartHub Windows Serveren, IIS alatt](https://workwise-solutions.net/docs/images/diagram-install-windows-iis-hu.png)
*Az IIS folyamaton belül, folyamatosan futó alkalmazáskészletben futtatja az alkalmazást; az adatok a webhely mappájában vagy külső adatbázisban vannak.*

## 1. Előfeltételek

1. Telepítse a **Web Server (IIS)** szerepkört az **Application Development → Application Initialization** szolgáltatással. A **Security → Windows Authentication** csak Active Directory-s bejelentkezéshez kell.
2. Telepítse az **ASP.NET Core 10.0 Hosting Bundle** csomagot (a .NET hivatalos letöltőoldaláról, .NET 10.0, ASP.NET Core Runtime), majd futtassa az `iisreset` parancsot.
3. Telepítse a **Microsoft Visual C++ Redistributable (x64)** csomagot. A licenckezelés erre épül; nélküle az alkalmazás induláskor `libsodium` hibát jelez.
4. Ellenőrizze a futtatókörnyezetet: `dotnet --info`.

## 2. A fájlok másolása

Másolja a kiadás (publish) mappájának tartalmát az oldal mappájába, például a `C:\inetpub\wwwroot\WorkSmartHub` mappába. A mappában közvetlenül kell lennie a `WorkSmartHub.dll`, a `web.config`, az `appsettings.json` fájlnak és a `wwwroot` mappának.

## 3. Alkalmazáskészlet

Hozzon létre egy alkalmazáskészletet (application pool) **.NET CLR version: No Managed Code** és Integrated pipeline beállítással. Az **Advanced Settings** alatt:

| Beállítás | Érték | Miért |
|---|---|---|
| Start Mode | AlwaysRunning | Az IIS-szel együtt indul, nem az első kéréssel |
| Idle Time-out (minutes) | 0 | Az IIS tétlenség miatt soha nem állítja le a folyamatot |
| Identity | Egy erre a célra létrehozott szolgáltatásfiók | |
| Load User Profile | True | Egyes hitelesítési beállításokhoz kell |
| Regular Time Interval (minutes) | 0, vagy egy munkaidőn és a háttérfolyamatok idején kívüli időpont | Az újrahasznosítás (recycle) megszakítja a futó munkát |

Adjon **Modify** jogot az alkalmazáskészlet identitásának az oldal mappájára. Az alkalmazás ide ír: `Logs\`, az SQLite adatbázis (`database.db` a `-wal` és `-shm` fájlokkal), `FileStorage\`, az élő sablonok, valamint maga az `appsettings.json` (induláskor biztonsági másolat után hozzáadja az új kiadás által bevezetett beállításokat).

## 4. A webhely

1. **Add Website**: válassza ki az alkalmazáskészletet, az oldal mappáját és a kötést (binding).
2. A webhely **Advanced Settings** ablakában: **Preload Enabled: True**.
3. Az oldalt **HTTPS**-en szolgálja ki (a kötésen vagy egy terheléselosztón). Az előtte álló proxynak magának kell beállítania az `X-Forwarded-Proto` és az `X-Forwarded-Host` fejlécet.
4. **Active Directory-s bejelentkezés** (csak Windowson): a szervernek tartományba léptetettnek kell lennie; a webhelyen kapcsolja be az **Anonymous Authentication** és a **Windows Authentication** módot is. Sok csoportba tartozó felhasználóknál növelje meg a HTTP.sys fejléckorlátait (`MaxFieldLength` 65534, `MaxRequestBytes` 16777216 a `HKLM\System\CurrentControlSet\Services\HTTP\Parameters` alatt), majd indítsa újra a gépet.
5. A `web.config` fájlban adja hozzá az `aspNetCore` elemhez a `shutdownTimeLimit="60"` attribútumot, hogy újrahasznosításkor az alkalmazásnak legyen ideje befejezni a munkáját (legfeljebb 45 másodpercre van szüksége).
6. Indítsa el az alkalmazáskészletet, és nyissa meg az oldalt. A `GET /health` `200`-as választ ad, ha az alkalmazás fut.

## 5. Beállítás

Szerkessze az oldal mappájában lévő `appsettings.json` fájlt: adatbázis, cache, felhasználói tár és bejelentkezés, aláíró kulcsok, `PublicBaseUrl`, e-mail, naplózás ([Konfiguráció](https://workwise-solutions.net/hu/docs/installation/configuration/)). IIS alatt a `HttpSettings.Urls` beállítást nem használja az alkalmazás; hagyja az alapértéken. Módosítás után hasznosítsa újra az alkalmazáskészletet.

A háttérfolyamatok a beállított időpontban, a szerver helyi ideje szerint futnak; az alkalmazáskészlet újrahasznosítása ne essen ezekre az időpontokra.

## Frissítés

1. Ha az új kiadás újabb .NET verziót igényel, telepítse annak Hosting Bundle-jét, és futtassa az `iisreset` parancsot.
2. Készítsen mentést az adatbázisról és az oldal mappájáról, majd állítsa le az alkalmazáskészletet.
3. Tegye félre az `appsettings.json` egy másolatát.
4. Másolja az új fájlokat az oldal mappájára, majd tegye vissza a saját `appsettings.json` fájlját. A szerkesztett sablonok megmaradnak.
5. Indítsa el az alkalmazáskészletet. Az adatbázist az alkalmazás induláskor migrálja.

## IIS nélkül

Bármely Windows-szolgáltatás-burkoló (service wrapper) megfelel, amely az alkalmazás mappájában a `dotnet WorkSmartHub.dll` parancsot futtatja, egy `localhost:5000` felé mutató fordított proxyval. A burkoló leállítási időkorlátja legalább 60 másodperc legyen, és automatikusan induljon. Active Directoryhoz az IIS ajánlott.

A teljes, lépésenkénti leírás a kiadás backend README-jében található.
