Hibaelhárítás

Ez a fejezet a tünetből indul: keresse meg a táblázatokban, amit lát; a jobb oldali oszlop az okot és a teendőt mondja. Szinte minden hibánál a szolgáltatás naplója mondja meg a legtöbbet, ezért az első szakasz azt írja le, hol találja.

Először a napló

Minden szolgáltatás webes felületén a Naplók lap mutatja a szolgáltatás naplófájljait. A lap tetején a naplómappa teljes útvonala áll, balra a fájlok listája (a „most fut” címke jelöli az éppen írt fájlt), jobbra a kiválasztott fájl vége.

• A Sorok a végéről választóval állíthatja, hány sort mutasson; a frissítő gomb a friss véget hozza, a letöltés gomb a teljes fájlt adja – a titkok (kulcsok, jelszavak) elfedésével.
• Minden indulás új fájlt nyit; a fájl fejléce a teljes parancssort, a gépet, a nyelvet és a konfigurációs fájlt is kiírja.
• A kérések kérésenként egy összefoglaló sort kapnak, a válasz kódjával és a hívó nevével – így egy elutasított kulcs is visszakereshető.

Ha a felület nem érhető el (mert a szolgáltatás el sem indult), a naplót a fájlrendszerben kell keresni:

Hol fut	A naplók helye
Windows, konzolból	%TEMP%\LiveCaptionPro\<mappa>, vagy beállított LCP_HOME mellett az adatgyökér alatt
macOS és Linux, konzolból	~/.local/state/LiveCaptionPro/<mappa>, vagy beállított LCP_HOME mellett az adatgyökér alatt
szolgáltatásként	a szolgáltatás saját mappája (lásd Szolgáltatásként); Linuxon a journalctl is mutatja

A mappák neve: server-log (feliratozó), translatorserver-log (fordító), voiceserver-log (beszédszolgáltatás; a beszédmotornak külön naplója van, a Futási kép lap megmutatja), accountserver-log (fiókszolgáltatás). A naplók nyelve külön beállítás: a gép nyelvét vagy a LCP_LANGUAGE változót követi, nem a felületét.

A szolgáltatás nem indul el

Tünet	Ok és teendő
a port foglalt	a szolgáltatás megmondja, mi foglalja a portot. Gyakran egy korábbi példány fut még: állítsa le, vagy indítsa másik porttal
hiányzik a fiókszolgáltatás címe	a LCP_ACCOUNT_URL kötelező; az AccountServer\setup-account-peers -Activate állítja be. Utána minden ablakot indítson újra: a változó a már futó folyamatokhoz nem jut el
a fiókszolgáltatás nem talál adatbázist, vagy „nincs alapértelmezett binding”	a connection string egy binding változójában él (LCP_DB_<NÉV>), az alapértelmezettet az LCP_DEFAULT_DB nevezi meg. A saját helyi adatbázist az AccountServer\managed-postgres indító hozza létre; meglévőre a maintenance\db-default -Name <NÉV> állítja át
a fiókszolgáltatás egy perc várakozás után leáll	az adatbázis nem érhető el: a PostgreSQL-konténer nem fut, vagy a Docker Desktop nincs elindítva. Az AccountServer\managed-postgres.ps1 -Status megmondja, mi a helyzet
a fiókszolgáltatás rossz adatbázis-jelszót jelez	ha az imént cserélte a jelszót, nyisson új ablakot: a nyitott ablakok a régi értéket tartják
a fiókszolgáltatás futás közben leállt: „az adatbázis megváltozott”	az adatbázist visszatöltötték vagy újra létrehozták; indítsa újra (lásd Karbantartás, mentés, kizáródás)
a beszédszolgáltatás hiányzó motorkörnyezetet jelez	a motor Python-környezetét a VoiceServer\prepare-engine.ps1 készíti el (több gigabájtos letöltés, ezért kérdez); az indító felajánlja
egy mentett beállítás után nem indul	indítsa egyszer a --ignore-saved kapcsolóval, és a Beállítások lapon javítsa az értéket
a feliratozó kevés videómemóriát talál	a sorrend fordítva ment: a feliratozónak kell utolsónak indulnia, a fordító és a beszédszolgáltatás után

Belépés és jogosultság

Tünet	Ok és teendő
nem lehet belépni egyik szolgáltatás felületére sem, de a kulcsos forgalom megy	a fiókszolgáltatás vagy az adatbázisa nem érhető el: a kiesés alatt új belépés nincs, a már belépett munkamenetek élnek. Indítsa el, és nézze meg a naplóját
elveszett a rendszergazda jelszava	a fiókszolgáltatás gépén az AccountServer\maintenance\admin-password indító ad újat
egy frissen kiadott kulcsot a szolgáltatás 401-gyel utasít el	várjon fél percet, amíg a jogosultsági kép frissül; a szolgáltatás Hívók lapján a kulcsnak meg kell jelennie
egy szolgáltatás minden kulcsot elutasít	nincs peer tokenje, vagy a fiókszolgáltatás nem fogadja el: az AccountServer\setup-account-peers -Check megmondja. Új adatbázis után a -Replace ad újat
egy művelet a felületen „elutasítva”	a felhasználónak nincs hozzá joga, vagy a művelet valódi belépést kíván (emelés), és a helyi bizalommal nyitotta a lapot. Az Audit napló megmutatja az okot
piros sáv a Hívók lapon: elavult jogosultsági kép	a szolgáltatás 24 óránál régebben kapott friss képet: a fiókszolgáltatás nem érhető el, vagy a peer tokent nem fogadja el

Hálózat és titkosítás

Tünet	Ok és teendő
a munkaállomás „nincs válasz” hibát kap	a szolgáltatás csak helyben figyel, vagy a tűzfal eldobja a kapcsolatot. Nézze meg a Hálózat lapon a címeket és a tűzfalszabályt (lásd Távoli GPU-szerver)
a tűzfalszabály felvétele nem fejeződik be	a rendszergazdai megerősítés (UAC) a szolgáltatás gépén vár: ott kell elfogadni
Windowson a szabály megvan, mégsem érhető el	a hálózat nyilvános (Public) besorolású, a szabály pedig a privát és a tartományi hálózatra szól; jelölje a hálózatot privátnak
macOS-en a szolgáltatás nem éri el a másik gépet vagy a hálózati adatbázist	hiányzik a Helyi hálózat engedély (Rendszerbeállítások → Adatvédelem és biztonság → Helyi hálózat), vagy az alkalmazás-tűzfal nem engedi a programot
a LiveCaption elutasítja a korábban elfogadott tanúsítványt	az ujjlenyomat megváltozott: a tanúsítványt újragenerálták, változott a gép címe – vagy nem az a gép válaszol. Vesse össze az ujjlenyomatot a szolgáltatás gépén kiírttal, és csak utána fogadja el újra
figyelmeztető sáv minden lapon: titkosítatlan távoli felület	a webes felület a hálózatról titkosítás nélkül érhető el, a jelszó olvashatóan utazik; kapcsolja be a titkosítást, vagy tegye reverse proxy mögé

Szolgáltatásként telepítve

Tünet	Ok és teendő
a szolgáltatás percenként újraindul	futási hibával (4-es kód) lép ki, és a rendszer egy perc múlva újrapróbálja. A szolgáltatás naplója mondja meg az okot – leggyakrabban nem érhető el az adatbázis vagy a fiókszolgáltatás
a szolgáltatás leállt, és nem indul újra	használati hibával (1-es kód) lépett ki, például egy rossz kapcsoló miatt; javítsa a telepítő parancsát, és futtassa újra
a telepítő nem indul: más példány vagy a másik macOS-változat már be van jegyezve	gépenként egy példány telepíthető, és egy szolgáltatás nem lehet egyszerre LaunchDaemon és LaunchAgent; előbb távolítsa el a meglévőt
a napi indító nem indítja a szolgáltatást, csak egy parancsot ír ki	a szolgáltatás telepítve van; a napi indító nem indít mellé konzolos ikret – a kiírt paranccsal kezelje
a karbantartó indító művelete nem látszik a szolgáltatásban	az indító egy másik adatbázisra dolgozott, mint a szolgáltatás; futtassa a db-check indítót, és nézze meg, melyik adatbázist írja ki

Ha nem találja a tünetét

A weboldal útmutatói között is van egy tünet szerinti Hibaelhárítás, a feliratozással, a fordítással és a tolmáccsal kapcsolatos hibákkal. Ha ott sem találja, írjon a Kapcsolat oldalon – a szolgáltatás naplója és az ellenőrző parancsok (livecaption --check, captionclient --check) kimenete sokat segít.