Instalační instrukce pro IT a správce

Toto je návod na instalaci Digitoo Agenta pro více uživatelů. Je určen IT pracovníkům, kteří mají na starost instalaci a správu Digitoo Agenta v rámci organizace pro více uživatelů. Samotný Digitoo Agent je z hlediska nasazení velmi flexibilní a snadno jej začleníte do stávající infrastruktury.

Digitoo agent nemůže běžet jako služba. Nemůže se nastavit, aby se dal spustit jako služba, protože agent je program, který přímo komunikuje za konkrétního uživatele s jeho ERL klientem. Uživatel v něm provádí i nastavení a Agent dává uživateli zpětnou vazbu a tedy potřebuje GUI. Windows služba je typicky headless. Z tohoto důvodu agent nemůže běžet jako služba.

Stažení instalačního EXE

Setup EXE pro instalaci i upgrade získáte ve webové aplikaci Digitoo.  Pokud již daná firma má účet založený, tak je prosím požádejte, ať vás do účtu pozvou. V aplikaci pak sekci Nastavení - Seznam připojení najdete tlačítko pro stažení instalačního souboru. 
Případně vám ten soubor může stáhnout kdokoliv jiný a ten soubor vám poslat.

Nyní je čas se rozhodnout, kam budete Digitoo Agenta instalovat. Setup exe je vytvořen s ohledem na potřeby jednotlivého uživatele, pro víceuživatelské instalace máme více možností

Víceuživatelská nesdílená instalace

Vezměme nejdříve častý stav, kdy se uživatelé připojují vzdáleně (např přes terminálový server) a každý má svého uživatele Windows. Nejjednodušší, i když trochu „naivní“ přístup, je přihlásit se postupně za jednotlivé uživatele (např. na terminálovém serveru) a u každého spustit instalaci zvlášť. Po instalaci stačí Agenta nastavit: přihlásit daného uživatele a v nastavení přenosu dokumentů zvolit **„Dokumenty, které jsem odeslal já“**. Vše pak funguje bez problémů. 
Nevýhodou je, že aktualizaci budete muset provádět u každého uživatele zvlášť – u malého počtu to nevadí, ale jinak to může být pracné.
 

Sdílená instalace - lepší způsob

Lepší variantou je spustit Setup EXE jednou – pod libovolným uživatelem s instalačními právy (např. adminem). Setup nainstaluje Agenta i všechny potřebné DLL knihovny do složky ve formátu:

C:\Users\<Uživatel>\AppData\Local\Programs\digitoo-agent-<název erp>-digitoo4

Tento adresář obsahuje vše potřebné a aplikace používá relativní cesty. Pokud celou tuto složku přesunete na sdílený síťový disk a uživatelům připravíte zástupce na ploše (disk musí být namapovaný), bude Agent fungovat. U každého uživatele pak stačí jednou provést konfiguraci jako dříve – přihlásit se jako tento uživatel a zadat do Agenta jeho Digitoo uživatele a nastavit přenášené dokumenty na “Dokumenty, které jsem odeslal já”. Toto uděláte jen jednou – při aktualizacích se nastavení zachovají.
 

Aktualizace Digitoo agenta

Aktualizaci provedete tak, že Agenta nejprve aktualizujete u uživatele, kde proběhla původní instalace, a poté celý adresář znovu překopírujete na stejné sdílené místo. Odkazy na plochách i uživatelská nastavení zůstanou funkční.

Další tipy

Uživatelská nastavení

Nastavení jednotlivých uživatelů se ukládají do user space:

C:\Users\<Uživatel>\AppData\Roaming\Digitoo Agent <Název ERP> Pro

Tak to má být – sdílená zůstávají jen binárky a knihovny. Pokud se někdo rozhodne upravovat konfigurační soubory ručně, buďte opatrní – jakákoli chyba ve struktuře JSON způsobí, že si Agent soubor smaže a vytvoří nový. Také je naprosto klíčové, aby uživatelé pracovali každý pod jiným Digitoo uživatelem a neměli přenos dokumentů nastaveny jako “Přenášer všechny dokumenty”, jinak budou problémy s duplicitami.

Další možnosti víceuživatelského nastavení

Z výše uvedeného vyplývá, že Agent je velmi flexibilní. Pokud přesunete celý instalační adresář, můžete Agenta spouštět odkudkoli. Uživatelská nastavení zůstanou oddělená – nejsou součástí instalační složky.

RDP a další scénáře

Agent lze spouštět i přes RDP nebo jiné prostředí, kde se aplikace spouští vzdáleně. Důležité je zachovat všechny exe a dll dohromady. Jediné co je potřeba zajistit je dobrá komuniakce s ERP, což může být u RDP oříšek.  Agent dělá dvě věci:

1. Vytváří soubory v určeném adresáři (nastavitelném v **Pokročilém nastavení** jako „Adresář Digitoo“).
2. Spouští ERP aplikaci s parametry – např. cestou k vytvořenému souboru (cestu k ERP EXE lze nastavit rovněž v **Pokročilém nastavení**).

Z toho přirozeně plyne, že je tedy potřeba:

- zajistit, aby ERP mělo přístup do „Adresáře Digitoo“,
- a aby parametry volání byly při spouštění přes RDP správně předávány.

Tip: Pokud používáte „Adresář Digitoo“ na síťovém disku (např. `\\server\share`), doporučujeme tento disk namapovat na písmeno (např. `Z:`). Často to vyřeší problémy s přístupovými právy – čisté UNC cesty někdy způsobují úrpblémy  s právy a podobně. Namapování velmi často problém kupodivu vyřeší.