Provoz bridge

Jak sledovat stav bridge, jak probíhají aktualizace, jak bridge přesunout, odvolat nebo odinstalovat. Na konci stránky je referenční část pro správce IT: služba, složky, příkazy bridgectl a události v protokolu Windows.

Stav bridge

Seznam bridgů otevřete v nabídce nastavení položkou Bridge pod Integrace (Integrace najdete v Nastavení systému, které otevřete v uživatelském menu vpravo nahoře, na mobilu v nabídce Nastavení). Každý bridge má jeden z těchto stavů:

Stav	Význam
Online	Bridge je spárovaný a právě komunikuje s Tappeerem.
Offline	Bridge je spárovaný, ale nepřipojený. Počítač může být vypnutý, odpojený od sítě, nebo se agent zastavil.
Čeká na spárování	Bridge je zaregistrovaný, ale žádný agent se s ním zatím nespároval.
Odvolán	Přihlašovací údaj bridge už neplatí. Bridge nelze znovu použít.

Dokud je bridge Offline, konektory, které přes něj běží, nemohou synchronizovat. Postup při výpadku popisuje Řešení problémů.

Stránka bridge

Kliknutím na název bridge otevřete jeho stránku se třemi záložkami:

• Přehled — stav bridge a kdy se naposledy ozval, Název počítače, Platforma, Verze agenta, Cílové systémy, které hlásí (každý s verzí pluginu), datum registrace a dále instalace nastavené na tomto bridgi spolu s konektory, které je používají.
• Historie připojení — jednotlivá spojení bridge s Tappeerem: kdy začalo (Připojeno), kdy skončilo (Odpojeno) a Důvod. Opakovaná krátká spojení končící vypršením limitu ukazují na problém v síti; jedno dlouhé spojení ukončené vypnutím obvykle znamená nasazení nové verze Tappeeru a bridge se sám připojí znovu.
• Aktivita — události, které bridge nahlásil, například spárování, připojení a odpojení nebo chyby agenta.

Automatické aktualizace

Aktualizace agenta řídí Tappeer a bridge je instaluje sám, bez návštěvy u počítače:

• Agent se na novou verzi poprvé zeptá 2 minuty po spuštění, potom každých 10 minut a dříve, když ho o to požádá Tappeer.
• Novou verzi stáhne, ověří její podpis a kontrolní součet a restartuje se do ní.
• Pokud nová verze dvakrát po sobě nevydrží běžet ani minutu, bridge se automaticky vrátí k předchozí verzi a tuto vadnou verzi si zapamatuje, aby ji znovu neinstaloval.

Pluginy pro jednotlivé systémy se aktualizují za běhu, bez restartu agenta a bez přerušení spojení. Když nová verze pluginu selže třikrát během pěti minut, bridge se vrátí k předchozí verzi pluginu.

Chcete-li o okamžiku aktualizace rozhodovat sami, nastavte v souboru bridge.yml položku update.auto_apply: false. Agent pak dál kontroluje, co je k dispozici, a aktualizaci použijete příkazem bridgectl update --apply.

Přesun bridge na jiný počítač

Spárování je vázané na konkrétní počítač a nastavení instalace nelze přesunout na jiný bridge. Přesun proto proveďte takto:

1. Zaregistrujte nový bridge, nainstalujte ho na nový počítač a spárujte (viz Instalace a spárování bridge).
2. Počkejte, až karta nového bridge ukáže váš cílový systém.
3. Na stránce Instalace přidejte na nový bridge novou instalaci se stejným nastavením — hesla do ní zadejte znovu — a ověřte ji tlačítkem Ověřit připravenost (viz Cílové systémy a instalace).
4. V každém konektoru vyberte v sekci Základní údaje v poli Instalace novou instalaci a klikněte na Uložit změny.
5. Starý bridge smažte tlačítkem Smazat (ikona koše) — tím se odstraní i jeho staré instalace a uložené přihlašovací údaje. Pokud ho jen odvoláte tlačítkem Odvolat, staré instalace zůstanou a odstraňte je na stránce Instalace tlačítkem Odebrat. Starý počítač pak odinstalujte (viz níže).

Odvolat, nebo smazat

V seznamu bridgů jsou u každého bridge tyto akce:

• Párovací kód — vystaví nový párovací kód. Je dostupný jen u bridge, který čeká na spárování. Předchozí kód tím přestane platit.
• Odvolat — přihlašovací údaj bridge okamžitě přestane platit a jeho spojení se ukončí. Odvolání nelze vrátit; agenta je pak nutné spárovat s nově zaregistrovaným bridgem. Odvolání použijte vždy, když počítač vyřazujete nebo už není pod vaší kontrolou — platí, i když se počítač už nikdy nepřipojí.
• Smazat (tlačítko s ikonou koše) — odstraní bridge i s historií připojení, instalacemi, které na něm byly nastavené, a jejich uloženými přihlašovacími údaji. Konektory, které přes něj běžely, se nesmažou: vypnou se a zůstanou bez instalace, dokud je nenasměrujete na jiný bridge. Potvrzovací okno je předem vyjmenuje.

Odinstalace

Odinstalujte Tappeer Bridge jako běžný program Windows, nebo příkazem:

msiexec /x <soubor.msi> /qn

Odinstalace zastaví a odregistruje službu a odstraní programové soubory. Přihlašovací údaj, spárování a pluginy na počítači zůstanou, takže po opětovné instalaci se vrátí tentýž bridge.

Chcete-li odstranit i data, použijte vlastnost PURGE=1:

msiexec /x <soubor.msi> PURGE=1 /qn

Odinstalace ani PURGE=1 bridge v Tappeeru neodvolají — pouze smažou data na tomto počítači. Bridge, který vyřazujete, vždy také odvolejte ve webové aplikaci tlačítkem Odvolat.

Reference pro správce IT

Služba

Název služby	TappeerBridge
Zobrazovaný název	Tappeer Bridge
Typ spuštění	automaticky

Službu zastavíte příkazem sc stop TappeerBridge a restartujete příkazem Restart-Service TappeerBridge. Zastavení ukončí i pluginy a programy, které pluginy spustily (například Pohoda.exe nebo MonS3.exe).

Složky a soubory

Cesta	Obsah
%ProgramFiles%\Tappeer\Bridge\	služba (tappeer-launcher.exe) a nástroj bridgectl.exe
%ProgramData%\Tappeer\Bridge\	data a nastavení bridge
%ProgramData%\Tappeer\Bridge\bridge.yml	místní nastavení (upravujte v editoru spuštěném jako správce)
%ProgramData%\Tappeer\Bridge\state.json	aktuální stav agenta, ze kterého čte bridgectl status
%ProgramData%\Tappeer\Bridge\logs\launcher.log	protokol služby
%ProgramData%\Tappeer\Bridge\logs\agent.log	protokol agenta
%ProgramData%\Tappeer\Bridge\bin\	nainstalované verze agenta
%ProgramData%\Tappeer\Bridge\plugins\	nainstalované pluginy

Přihlašovací údaj bridge je uložený šifrovaně pomocí DPAPI v rozsahu počítače. Protokoly se rotují podle velikosti a stáří (výchozí 20 MB, 5 záloh; zálohy starší než 30 dní se mažou). Protokoly mohou obsahovat názvy agend, databází nebo příloh; složku logs může číst každý, kdo se k počítači přihlásí.

Oprávnění složek nastavuje instalátor a bridge je kontroluje při každém startu. Pokud bridge odmítne start kvůli vlastníkovi nebo oprávněním složky, spusťte v příkazovém řádku jako správce bridgectl service-account --apply-dacl. Nabídku Průzkumníka „You don’t currently have permission to access this folder — Continue“ nepotvrzujte: přidá vašemu účtu oprávnění, kvůli kterému služba pod účtem služby nenastartuje.

Příkazy bridgectl

Spouštějte je v příkazovém řádku nebo PowerShellu jako správce.

Příkaz	Co dělá
bridgectl enroll --code TPB-…	spáruje bridge s účtem jednorázovým párovacím kódem; obsahuje-li příkaz z aplikace i --endpoint …, ponechte ho
bridgectl enroll --interactive	totéž, kód si vyžádá v konzoli
bridgectl status [--json]	zda je bridge spárovaný, stav agenta, použitá brána a poslední chyba
bridgectl doctor	kontrola složek, přihlašovacího údaje, dostupnosti brány přes TCP a TLS, hlášení agenta a toho, co pluginy na počítači našly
bridgectl plugin list	vypíše nainstalované verze pluginů
bridgectl plugin install	nainstaluje vydání pluginu ze složky nebo archivu
bridgectl plugin activate <název> <verze>	přepne plugin na jinou nainstalovanou verzi
bridgectl update --check	ukáže, kterou verzi Tappeer nabízí a zda by ji bridge přijal
bridgectl update --apply	připraví nabízenou verzi a použije ji při příštím startu
bridgectl update --clear-rejected	zapomene verze, ze kterých se bridge vrátil, takže je může znovu přijmout
bridgectl purge	smaže přihlašovací údaj a data bridge na tomto počítači (bridge v Tappeeru neodvolá)
bridgectl service-account	vypíše nebo změní účet, pod kterým služba běží (--account DOMENA\účet, --local-system), udělí mu právo přihlásit se jako služba, znovu nastaví oprávnění složek a službu restartuje (pokud nezadáte --no-restart)
bridgectl service-account --apply-dacl	znovu nastaví oprávnění složek bridge pro nakonfigurovaný účet
bridgectl version	vypíše verzi nástroje

bridgectl service-account nepřijímá heslo jako parametr; zeptá se na něj, nebo ho přečte ze standardního vstupu (--password-stdin). Pokud pak služba nenastartuje s chybou 1069, je heslo chybné nebo je účet zakázaný či zamčený — spusťte příkaz znovu se správným heslem.

Protokol událostí Windows

Bridge zapisuje důležité události do protokolu Application (Aplikace) se zdrojem TappeerBridge. Vypíšete je například příkazem:

Get-WinEvent -FilterHashtable @{LogName='Application'; ProviderName='TappeerBridge'}

ID	Událost
100	Spuštění služby nebo agenta; také odmítnuté spuštění s uvedeným důvodem.
101	Zastavení služby.
102	Služba se vrátila k předchozí verzi agenta, protože nová opakovaně nenastartovala. Zpráva uvádí, zda se vadnou verzi podařilo zapamatovat.
103	Spárování se nezdařilo (například neplatný, použitý nebo prošlý kód).
104	Bridge odmítl spustit vydání pluginu.
105	Agent opakovaně padá a není k dispozici předchozí verze, ke které by se mohl vrátit.
106	Soubor protokolu nelze otevřít; protokol se zapisuje jinam.
107	Bridge byl spárován (přihlašovací údaj uložen).
108	Složka bridge patřila jinému vlastníkovi a byla převedena na skupinu Administrators.
109	Nainstalovanou verzi agenta nelze spustit: chybí podpis, byla změněna, je podepsaná nedůvěryhodným klíčem nebo je starší než služba.
110	Žádná nainstalovaná verze agenta neprošla ověřením; služba nic nespustí. Nainstalujte bridge znovu.
111	Soubor se stavem verzí (current.json) nešlo přečíst; služba použila nejnovější ověřenou verzi.
112	Agenta nešlo spustit v izolovaném objektu úlohy Windows; služba to zkouší znovu. Obvykle to způsobuje bezpečnostní software.
113	Služba spustila verzi, ze které se dříve vrátila, protože žádná jiná nainstalovaná verze neprošla ověřením. Nainstalujte novější verzi.
114	Seznam odmítnutých verzí byl vymazán příkazem bridgectl update --clear-rejected.

Při výpadku postupujte v tomto pořadí: stav bridge ve webové aplikaci (záložky Historie připojení a Aktivita), bridgectl status, bridgectl doctor, stav služby (sc query TappeerBridge), protokoly ve složce logs a nakonec protokol událostí. Další pomoc najdete v části Řešení problémů.