# Instalační manuál # Základní požadavky Kapitola obsahuje základní softwarové a hardwarové požadavky pro správnou funkci aplikace Enterprise Architect Information Portal. # Požadovaný hardware Enterprise Architect Information Portal vyžaduje, ke svému správnému fungování, následující hardware.
**Název** **Minimální** **Doporučené**
RAM 4 GB 8 GB
HDD 50 GB 150 GB
CPU Intel® Pentium Dual-Core® Intel® Pentium Dual-Core® (nebo lepší)
# Požadovaný software Enterprise Architect Information Portal vyžaduje, ke svému správnému fungování, následující software a knihovny. **Podporované databáze:**
**Název****Minimální****Doporučené****Popis**
MySQL5.7.7.x8.+
PostgreSQL1214
Oracle12c+2019
MariaDB 10.1.2 Minimální nebo vyšší.
**Podporované verze EA pro účely EA Infoportu:**
**Název** **Minimální** **Doporučené** **Popis**
Enterprise Architech 14 16+ (32 bitová verze) Uvedené verze Enterprise Architect se týkají serveru, na kterém je provozován Infoport. Na klientských stanicích je možné provozovat i 64 bit verzi.
**MS knihovny:**
**Název** **Minimální** **Doporučené** **Popis**
.NET 4.7.1 Pouze pokud jsou potřeba ODBC drivery.
.NET CORE 6.x **Neinstaluje se: je součástí instalačního balíčku!**
**Podporované operační systémy**
**Název** **Minimální** **Doporučené** **Popis**
Windows Workstation (pro účely instalace portálu) Windows 10 (1607+) Windows 11 Portál může běžet i na OS určeném pro Workstation
Windows Server Windows Server 2012 Windows Server 2019
# Instalační postupy Instalační postup pro zprovoznění EaInfoportT3 na vlastním serveru. Instalaci všech komponent je potřeba provádět pod uživatelským účtem Windows ( např: technický uživatel). Nikoliv tedy pod účtem např. system service. Poznámka: Všechny podtrhnuté údaje v instalaci jsou uvedeny jako příklad a ve vaší instalaci se pravděpodobně budou lišit. Poznámka: Při migrování na novou verzi je z bezpečnostního důvodu lepší zálohovat databázi. # Instalace a konfigurace programu Enterprise Architect Skládá se postupně z těchto kroků: - Instalace samotného programu Enterprise Architect - Instalace databáze - Instalace ODBC driverů pro přístup do databáze - Nastavení optimálního zoomu v Enterprise Architect Jako hlavní složku pro instalace aplikací firmy Dataprojekt bude uživatel v tomto manuálu používat *C:\\EAInfoport*. Kromě spustitelných souborů se zde budou ukládat i různé konfigurační soubory. V případě potřeby je možné použít jakoukoliv jinou složku s oprávněním pro zápis. - 1. [Instalace programu Enterprise Architect](https://doc.eainfoport.cz/books/instalacni-manual/page/instalace-programu-enterprise-architect) 2. [Instalace databáze pro uložení modelu Enterprise Architect](https://doc.eainfoport.cz/books/instalacni-manual/page/instalace-databaze-pro-ulozeni-modelu-enterprise-architect) 3. [Založení databáze pro Enterprise Architect model](https://doc.eainfoport.cz/books/instalacni-manual/page/c-zalozeni-databaze-pro-enterprise-architect-model) 4. [Instalace a konfigurace ODBC driverů](https://doc.eainfoport.cz/books/instalacni-manual/page/1-d-instalace-a-konfigurace-odbc-driveru) 5. [Uložení Enterprise Architect modelu do databáze](https://doc.eainfoport.cz/books/instalacni-manual/page/1-e-ulozeni-enterprise-architect-modelu-do-databaze) 6. [Vytvoření odkazu na repository](https://doc.eainfoport.cz/books/instalacni-manual/page/1-f-vytvoreni-odkazu-na-repository) 7. [Nastavení optimálního zoomu](https://doc.eainfoport.cz/books/instalacni-manual/page/17-nastaveni-optimalniho-zoomu) 8. [Nastavení rozměru elementu na diagramu](https://doc.eainfoport.cz/books/instalacni-manual/page/18-nastaveni-rozmeru-elementu-na-diagramu) # Instalace programu Enterprise Architect 1. Z [https://sparxsystems.com/](https://sparxsystems.com/) stáhneme soubor easetupfull.exe nebo ealite.msi a uložíme ho na lokální disk (například do složky C:\\EAInfoport). 2. Spustíme soubor easetupfull.exe nebo ealite.msi 3. Pomocí průvodce nainstalujeme aplikaci 1. Přečteme si a potvrdíme EULA smlouvu 2. Ponecháme defaultní adresář pro instalaci C:\\EAInfoport\\Sparx Systems\\EA 4. Po dokončení instalace smažeme soubor easetupfull.exe (nebo ealite.msi) 5. Spustíme aplikaci Enterprise Architect 6. V licenčním managementu vyplníme jméno a název společnosti a registrační klíč (čtyři skupiny čtyř písmen a číslic), dialog potvrdíme a uzavřeme 7. V následujícím dialogu pro aktivaci verze zadáme aktivační kód (čtyři písmena a číslice) Tímto je instalace programu Enterprise Architect dokončená a aplikace připravená k používání. # Instalace databáze pro uložení modelu Enterprise Architect
V případě, že je na počítači nainstalován nebo na síti dostupný databázový stroj je možné tuto kapitolu přeskočit. Zde si ukážeme, jak nainstalovat jeden z podporovaných databázových strojů. Jde o **MySql**, který je doporučován jako ideální pro potřeby jak samotného programu Enterprise Architect, tak i EaInfoportu.
1. Před vlastní instalací MySQL je potřeba zajistit, že je na počítači nainstalovaný pomocný balíček **vcredist\_x86.exe** ve verzi 2013. Na internetu vyhledáme „Visual C++ Redistributable Packages for Visual Studio 2013“ a variantu vcredist\_x86.exe uložíme na disk a spustíme. Po odsouhlasení licence se balíček nainstaluje. Počítač není potřeba restartovat. Soubor vcredist\_x86.exe smažeme. 2. Z [*https://downloads.mysql.com/archives/installer/*](https://downloads.mysql.com/archives/installer/) stáhneme webový instalační program ve verzi 32-bit z 5.7.x řady. Aktuálně tedy *mysql-installer-web-community-5.7.28.0.msi* Soubor uložíme na lokální disk (například do složky C:\\EAInfoport). 3. Soubor spustíme 4. Jako typ instalace vybereme *Custom [![MysQL instal.png](https://doc.eainfoport.cz/uploads/images/gallery/2022-03/scaled-1680-/mysql-instal.png)](https://doc.eainfoport.cz/uploads/images/gallery/2022-03/mysql-instal.png)* 5. Vybereme dvě položky k instalování: *MySQL Server 5.7.x – X86 Connector/ODBC 5.3.x – X86 [![MySQL instal 2_1.png](https://doc.eainfoport.cz/uploads/images/gallery/2022-03/scaled-1680-/mysql-instal-2-1.png)](https://doc.eainfoport.cz/uploads/images/gallery/2022-03/mysql-instal-2-1.png)* 6. Na další záložce spustíme samotnou instalaci *MySQL [![MySQL instal 3.png](https://doc.eainfoport.cz/uploads/images/gallery/2022-03/scaled-1680-/mysql-instal-3.png)](https://doc.eainfoport.cz/uploads/images/gallery/2022-03/mysql-instal-3.png)* 7. Nastavení na dalších záložkách necháme defaultní. Pouze na záložce s nastavením účtů a rolí nejprve vyplníme kořenové heslo *(pro správce databáze)* a následně vytvoříme infoport uživatele, pod kterým se budeme do databáze později přihlašovat. Všechna hesla *(správcovské zvlášť)* by měla byt bezpečná. Pro demonstrační účely, ale v manuálu používáme jako heslo frázi *P@ssw0rd (bude později vidět v definici připojení) [![MySQL instal 4.png](https://doc.eainfoport.cz/uploads/images/gallery/2022-03/scaled-1680-/mysql-instal-4.png)](https://doc.eainfoport.cz/uploads/images/gallery/2022-03/mysql-instal-4.png) [![MySQL User Acount.png](https://doc.eainfoport.cz/uploads/images/gallery/2022-03/scaled-1680-/mysql-user-acount.png)](https://doc.eainfoport.cz/uploads/images/gallery/2022-03/mysql-user-acount.png)* 8. Instalační soubor *mysql-installer-web-community-5.7.28.0.msi* smažeme z disku. Tím máme dokončenu instalaci databáze i ODBC driveru (ale ten bude ještě potřeba nakonfigurovat)
# Založení databáze pro Enterprise Architect model - Ze stránky [https://sparxsystems.com/downloads/corp/scripts/EASchema\_1220\_MySQL.sql](https://sparxsystems.com/downloads/corp/scripts/EASchema_1220_MySQL.sql) si stáhneme databázový skript na založení potřebných tabulek. - Soubor EASchema\_1220\_MySQL.sql uložíme do adresáře C:\\EAInfoport - Spustíme (řádkový) program MySQL 5.7 Command Line Client - Přihlásíme se pomocí kořenového (správcovského) hesla - Vytvoříme databázi „ea“ a to pomocí příkazu *CREATE DATABASE ea;* - Do databáze se přepneme pomocí příkazu *USE ea;* - Vytvoříme tabulky potřebné pro fungování Enterprise Architect a to příkazem *SOURCE* C:\\EAInfoport*\\EASchema\_1220\_MySQL.sql* - Program ukončíme # Instalace a konfigurace ODBC driverů Pokud jsme instalovali databázi MySQL (*podle jedné z předchozích kapitol*) budeme pokračovat až konfigurací ODBC. Pro fungování EaInfoportu je potřeba, aby měl Enterprise Architect uložená data v relační databázi (*ne jen v .eap souboru*). Pro propojení Enterprise Architect a databáze jsou zapotřebí ODBC drivery, které jsou volně dostupné pro všechny podporované typy databází. Níže je podrobně uveden postup pro MySQL, pro ostatní databáze je postup obdobný. ### Instalace ODBC pro MySQL - Ze stránky [https://downloads.mysql.com/archives/c-odbc/](https://downloads.mysql.com/archives/c-odbc/) stáhneme instalační soubor pro **32-bit** verzi z **5.x.x** řady. Aktuálně tedy (mysql-connector-odbc-5.3.13-win32.msi). Soubor uložíme například do složky C:\\EAInfoport - Spustíme instalaci, potvrdíme licenci, dokončíme instalaci - Instalační soubor smažeme ### Konfigurace ODBC pro MySQL - Spustíme aplikaci pro správu ODBC připojení „**ODBC Data Sources (32-bit)**“ - Přepneme do záložky **Uživatelské DNS** (pozor důležité!) - Přidáme nový Data Source typu „MySQL ODBC 5.3 ANSI Driver“ - Parametry připojení vyplníme podle následujícího vzoru (a podle hodnot, které jsme zadávali při instalaci MySQL databáze), a **nezapomeneme na Detailní nastavení** - Data Source Name *= ea* - TCP/IP Server = *localhost* - User = *infoport* - Password = *P@ssw0rd [![MySQL Connector_1111.png](https://doc.eainfoport.cz/uploads/images/gallery/2022-03/scaled-1680-/mysql-connector-1111.png)](https://doc.eainfoport.cz/uploads/images/gallery/2022-03/mysql-connector-1111.png)* - Záložka ***Connection*** - Zaškrtneme *Allow big result sets* - Zaškrtneme *Allow multiple statements* - *[![MySQL Connector_1upraveno.png](https://doc.eainfoport.cz/uploads/images/gallery/2022-03/scaled-1680-/mysql-connector-1upraveno.png)](https://doc.eainfoport.cz/uploads/images/gallery/2022-03/mysql-connector-1upraveno.png)* - Záložka ***Cursors/Results*** - Zaškrtneme *Return matched rows instead of affected rows [![MicrosoftTeams-image (1) opraveno.png](https://doc.eainfoport.cz/uploads/images/gallery/2022-03/scaled-1680-/microsoftteams-image-1-opraveno.png)](https://doc.eainfoport.cz/uploads/images/gallery/2022-03/microsoftteams-image-1-opraveno.png)* - *Záložka **Misc*** - Zaškrtneme *Prepare statements on the client [![MicrosoftTeams-image (2)upraveno.png](https://doc.eainfoport.cz/uploads/images/gallery/2022-03/scaled-1680-/microsoftteams-image-2upraveno.png)](https://doc.eainfoport.cz/uploads/images/gallery/2022-03/microsoftteams-image-2upraveno.png)* - Nastavení uložíme - Aplikaci ODBC Data Source Administratior (32-bit) již můžeme uzavřít # Uložení Enterprise Architect modelu do databáze Pokud zatím nemáme žádný EA model, tak si jej vytvoříme (resp. otevřeme ukázkový). - V aplikaci Enterprise Architect z hlavního menu (pod ikonkou EA) vyvoláme příkaz Open Project - Vybereme Local File a najdeme soubor *C:\\Users\\Administrator\\AppData\\Roaming\\Sparx Systems\\EA\\EAExample.eap* Pokud ještě nemáme EA projekt uložený do nějaké databáze (například proto, že jsme ji podle minulých kapitol teprve instalovali), tak jej uložíme. - Pomocí pásu karet Configure | Model |Transfer otevřeme Project Treansfer dialog - Vybereme File to DBMS - Jako Source Project zadáme *C:\\Users\\Administrator\\AppData\\Roaming\\Sparx Systems\\EA\\EAExample.eap* - Jako Target Project zadáme do Data Ling Properties následující: - Na záložce Provider vybereme Microsoft OLE DB Provider for ODBC Drivers - Na záložce Connection - V části 1 (… source name …) vybereme hodnotu ODBC připojení, tzn. *ea* - V části 2 (… log on …) zadáme jméno kořenového uživatele databáze (správce) a jeho heslo. V našem případě *root* a *P@ssw0rd* - V části 3 (… catalog …) vybereme název databázového schématu, tzn. *ea* - Otestujeme připojení a potvrdíme - Enterprise Architect překopíruje obsah projektu ze souboru do databáze (a bude tak dostupný pro systém EaInfoport) - Posledním krokem je otevření projektu z databáze - Z hlavního menu (pod ikonkou EA) vyvoláme příkaz *Open Project …* - Zvolíme Connect to Server a pro připojení do databáze vyplníme stejné údaje, jako jsme použili v minulém kroku. - Po potvrzení jsme napojeni na projekt uložený do databáze. # Vytvoření odkazu na repository Jakmile máme EA model uložený do databáze je potřeba vytvořit zástupce pro připojení (*shortcut*), který bude používat systém EaInfoport - V aplikaci Enterprise Architect z hlavního menu (pod ikonkou EA) vyvoláme příkaz *Save as shortcut* - Zvolíme složku, kam chceme zástupce vytvořit (např. C:\\EAInfoport*\\Dataprojekt\\ea.EAP*) a potvrdíme - Jakmile budeme v administraci EaInfoportu [**připojovat novou repozitoř**](https://doc.eainfoport.cz/books/instalacni-manual/page/vytvoreni-a-editace-repozitare), budeme pracovat právě s tímto souborem - Funkčnost odkazu si ověříme tím, že nejprve vypneme program Enterprise Architect, pak na disku vyhledáme soubor s odkazem C:\\EAInfoport*\\Dataprojekt\\ea.EAP* a ten „spustíme“ (*doubleclick*) - Pokud se nám otevřel Enterprise Architect i s naším projektem, máme vše správě nastavené a uložené # Nastavení optimálního zoomu Kvalita zobrazení diagramů v EaInfoportu je závislá na nastavení speciálního Scale parametru v Enterprise Architectu. - V aplikaci Enterprise Architect vyvoláme dialog Preferences (*CTRL + F9*) - Ve levé části vybereme „*Diagram*“ - V části General nastavíme „*Scale Saved Bitmaps to*“ na hodnotu 100% a tamtéž „*Image Memory Limit*“ na 512 [![zoom.png](https://doc.eainfoport.cz/uploads/images/gallery/2022-05/scaled-1680-/zoom.png)](https://doc.eainfoport.cz/uploads/images/gallery/2022-05/zoom.png) # Nastavení rozměru elementu na diagramu - ***Je potřeba nastavení u každého projektu!*** Pokud chcete použít Infoport pro editování diagramu, tak si otevřete ***Enterprise Architect***, následně kliknete na záložku ***Configure***, poté přejdete do záložky ***Options***. V otevřeném okně kliknete na ***Cloud*** a zaškrtnete volbu ***Auto create Diagram Image and Image Map (each time a Diagram is saved).*** *[![EA na ticket otázky a odpovědi.png](https://doc.eainfoport.cz/uploads/images/gallery/2022-03/scaled-1680-/ea-na-ticket-otazky-a-odpovedi.png)](https://doc.eainfoport.cz/uploads/images/gallery/2022-03/ea-na-ticket-otazky-a-odpovedi.png)* # InfoportLauncher InfoportLauncher.exe je program pro instalaci a aktualizace systému EaInfoport. Autonomně stáhne, nainstaluje a spustí EaInfoport a zajišťuje i jeho pravidelné aktualizace. Konfiguruje se pomocí parametrů příkazové řádky. Pokud jej spustíte bez parametrů, „*InfoportLauncher.exe*“ vypíše základní nápovědu se seznamem a popisem všech dostupných parametrů. InfoportLauncher.exe je „portable“ program, který se instaluje pouhým zkopírováním na disk. Doporučujeme jej nakopírovat do složky „*C:\\EAInfoport\\Dataprojekt\\Infoport*“ 1. [Jak program funguje](https://doc.eainfoport.cz/books/instalacni-manual/page/22-jak-program-funguje) 2. [Parametry](https://doc.eainfoport.cz/books/instalacni-manual/page/22-parametry) # Jak program funguje Program si nejprve zkontroluje základní požadavky na prostředí, ve kterém je spuštěn. Pokud je nakonfigurován pro automatické stahování aktuálních verzí z ftp serveru, zjistí poslední dostupnou verzi EaInfoportu, tuto stáhne a nainstaluje. Je-li z bezpečnostních důvodů přístup na ftp zakázán, je možné z webových stránek ručně stáhnout EaInfoport.zip a nakopírovat jej do stejného adresáře jako je InfoportLauncher.exe. Ten již zajistí nainstalování. InfoportLauncher.exe také dokáže kontrolovat, zda je systém EaInfoport běží a případně jej spustit. # Parametry InfoportLauncher.exe lze spustit s těmito parametry: *„InfoportLaunch -Trigger -Source -Scope -Version -Port -Start -Stop -Clear -Prereq -Run“* 1. [*Trigger "\* \* \* \* \*"*](https://doc.eainfoport.cz/books/instalacni-manual/page/221-trigger) 2. [*Source ftp | file*](https://doc.eainfoport.cz/books/instalacni-manual/page/222-source-ftp-file) 3. [*Version "\* \* \* \*"*](https://doc.eainfoport.cz/books/instalacni-manual/page/223-version) 4. [*Port 00000*](https://doc.eainfoport.cz/books/instalacni-manual/page/224-port-00000) 5. [*Start automatic | manual*](https://doc.eainfoport.cz/books/instalacni-manual/page/225-start-automatic-manual) 6. [*Stop automatic | manual*](https://doc.eainfoport.cz/books/instalacni-manual/page/226-stop-automatic-manual) 7. [*Clear automatic | manual*](https://doc.eainfoport.cz/books/instalacni-manual/page/227-clear-automatic-manual) 8. [*Prereq force | check*](https://doc.eainfoport.cz/books/instalacni-manual/page/228-prereq-force-check) 9. [*Run force | check*](https://doc.eainfoport.cz/books/instalacni-manual/page/229-run-force-check) # Trigger "* * * * *" Tento parametr nastavuje periodu, s jakou InfoportLauncher.exe vykonává svoji činnost. Je použit standardní Cron formát. Ten se skládá z pětice částí, které popisují časové a datumové údaje. Postupně jde o *min (0 - 59), hour (0 - 23), day of month (1 - 31), month (1 - 12), day o week sd (0 - 6) (0 = neděle)* Pokud na údaji nezáleží, je nahrazen \* Nejlépe je to pochopitelné na příkladech: - Pokud chceme činnost naplánovat na každou hodinu, použijeme "0 \* \* \* \*", čímž říkáme: v nula minut, každou hodinu, každý den v měsíci, každý měsíc, libovolný den v týdnu. - Pokud chceme činnost naplánovat vždy hodinu po půlnoci, použijeme "0 1 \* \* \*", čímž říkáme: v nula minut, první hodinu dne, každý den v měsíci, každý měsíc, libovolný den v týdnu. - Pokud chceme činnost naplánovat vždy v půl třetí ráno v noci ze pátku na sobotu, použijeme "30 2 \* \* 6", čímž říkáme: třicet minut, druhé hodiny dne, šestý den v týdnu (v sobotu) bez ohledu na den v měsíci či měsíc. # Source ftp | file Přepínač mezi automatickým a ručním downloadováním zip souborů s aktualizacemi. Pokud nastavíme *ftp* tak InfoportLauncher.exe autonomně stahuje (*ftp protokolem*) soubory a správce se nemusí o nic starat. Volba *file* je vhodná tam (jde zejména o korporátní firmy), kde existují bezpečností pravidla zakazující programům přístup mimo vlastní doménu. V případě ručního stahování .zip souborů je nutné tyto nakopírovat vždy „vedle“ programu InfoportLauncher.exe (tj. například do složky „c:\\Program Files (x86)\\Dataprojekt\\Infoport“). Dále již program provede aktualizaci sám. Stažený zip soubor se nesmí nijak přejmenovávat ani rozbalovat. Vhodné je pouze zkontrolovat, jestli souhlasí hash staženého souboru (zipu) s tím, co je uvedené na webové stránce odkud byl soubor stažen. Na kontrolu je možné použít libovolnou utilitu na výpočet MD5 hashe (například v nástroji Total Commander je v menu Soubor volba Vytvořit soubor s kontrolou dat CRC) # Version "* * * *" Pomocí parametru Version je možné filtrovat, které aktualizace chce správce instalovat. Parametr se skládá že čtyř částí, postupně jde o *major, minor, build, revision*. Pokud na údaji nezáleží, je nahrazen \* Jednotlivé váhy parametru jsou: - *major* – vydávané zpravidla jednou za rok/několik let. Jde o zásadní změny a vylepšení systému. - *minor* – vydávané zpravidla jednou za měsíc/několik měsíců. V rámci těchto změn jsou dodávány nové funkčnosti a dochází i ke změnám ve strukturách databáze. - *build* – přidávají drobná vylepšení, a především opravují chyby. Bývají publikovány týdně. - *revision* – technická verze, která může sloužit jako hotfix pro problém nalezený u konkrétního zákazníka. Nejlépe opět uvedeme příklady pro pochopení vhodného nastavení. - Pokud chceme agilně instalovat každičkou vydanou verzi, použijeme "\* \* \* \*". Toto nám zaručí, že okamžikem vydání nové verze se nám tato nainstaluje. - Pokud naopak chce přistupovat k aktualizace konzervativně, parametr nastavíme na "\* \* 0 \*", což znamená, že se nebudou dotahovat jednotlivé buildy, ale počkáme si na minor verzi. - Pro korporátní zákazníky je výhodná též možnost tímto parametrem oddělit live prostředí od prostředí určeného k otestování/adopci nové verze. V tom případě si v live instalaci nastavíme například na "7 3 0 \*" (zafixujeme si dříve adoptovanou verzi) a v testovací instalaci nastavíme například "7 4 \* \*" (čímž budeme dostávat všechny čerstvé aktualizace) # Port 00000 Parametr Port se použije pouze při nainstalování a prvním spuštění systému EaInfoport. Tento parametr udává, na jakém portu bude systém fungovat do chvíle, kdy jej administrátor portálu zkonfiguruje. Konfigurace EaInfoportu se provádí pomocí něho samého (*Setup stránka*). Pokud by byl standardní port 80 již obsazen jiným webovým serverem, nebylo by možné Setup stránku v EaInfoportu vůbec vyvolat. Proto je možné nastavit číslo portu na libovolné volné číslo. Po zkonfigurování portálu je již tento parametr ignorován. # Start automatic | manual Tento parametr slouží jako zpřesnění chování InfoportLauncher.exe při aktualizacích. Pokud je nastaven na *automatic*, tak po nainstalování nové verze spustí EaInfoport. Pokud je hodnota *manual*, musí po aktualizaci správce EaInfoport sám spustit. Nastavení na *automatic* také zaručuje, že je zkontrolováno spuštění EaInfoport kdykoliv je kontrolována aktualizace verze (což je dáno parametrem Trigger). Viz také parametr Run. # Stop automatic | manual Tento parametr slouží jako zpřesnění chování InfoportLauncher.exe při aktualizacích. Pokud je nastaven na *automatic*, tak po nainstalování nové verze vypne EaInfoport. Toto nastavení dává smysl především pokud je parametr Start rovněž nastaven na *automatic.* Potom se totiž celá aktualizace provede bez nutnosti zásahu správce systému. # Clear automatic | manual Tento parametr slouží jako zpřesnění chování InfoportLauncher.exe při aktualizacích. Pokud je nastaven na *automatic*, tak po nainstalování nové verze EaInfoport odinstaluje (smaže) původní. Mazání se týká pouze adresáře s konkrétní verzí a nijak nezasahuje do databáze s daty. # Prereq force | check Při každém spuštění InfoportLauncher.exe si program ověřuje, zda je prostředí způsobilé pro instalaci, aktualizaci či spuštění EaInfoportu. Kontroluje zejména dostatek místa na disku a to, zda je nainstalován program Enterprise Architect. Pokud nejsou splněny všechny předpoklady a parametr je nastaven na *force*, InfoportLauncher.exe nepokračuje dál a vypíše chybové hlášení. Pokud by byl ale parametr nastaven na *check*, sice dojte také ke kontrole a vypsání problémů, ale program dále pokračuje ve své činnost. Důsledky (například nedostatku volné diskové kapacity) se projeví později. # Run force | check V pravidelných jednominutových intervalech kontroluje, zda je EaInfoport spuštěn. Pokud není a hodnota parametru je nastavena na *check*, tak vypíše informaci o tom, že aktuálně nainstalovaná verze neběží. Pokud je hodnota parametru nastavena na *force*, InfoportLancher neprodleně spustí EaInfoport (a vypíše o tom informaci). # Příprava prázdné databáze (nebo schématu) pro metadata EA Infoportu Pro instalaci Infoport je potřeba mít vytvořené prázdné schéma v databázi, kterou chcete využít pro metadata aplikace. Vytvořené schéma využijete v configuration manageru, kde se na něj budete odkazovat. Po prvním spuštění Infoportu se vytvoří potřebné databázové tabulky v schématu pro správný chod aplikace a též se vytvoří defaultní nastavení aplikace. # Nastavení firewallu na serveru Standardním způsobem (dle použitého firewallu) povolíme port (pro příchozí requesty), na kterém chceme, aby byl EAInfoportT3 dostupný – například 80, nebo 8080 # Scope Pomocí parametru Scope je možné určit, které verze chce správce instalovat z ftp. Možnosti: - candidate - release # Configuration Manager Slouží k nastavení Infoportálu. Po prvním spuštění EaInfoportT3.exe, nám konsole zahlásí, že poslouchá na localhostu s určitým portem. "Now listening on: http://localhost:64297" Po zadání URL do webového prohlížeče, se nám načte „Configuration Manager“. První vyvolání manageru slouží k vytvoření souboru appsettings.json, který ukládá určité parametry pro chod Infoportu. # Configuration Manager [![Config.png](https://doc.eainfoport.cz/uploads/images/gallery/2022-05/scaled-1680-/0c8config.png)](https://doc.eainfoport.cz/uploads/images/gallery/2022-05/0c8config.png) Po vyplnění formuláře stiskneme tlačítko [![chceck all.png](https://doc.eainfoport.cz/uploads/images/gallery/2022-05/scaled-1680-/chceck-all.png)](https://doc.eainfoport.cz/uploads/images/gallery/2022-05/chceck-all.png) a pokud máme vše dobře vyplněno, objeví se v každé části [![schváleno.png](https://doc.eainfoport.cz/uploads/images/gallery/2022-05/scaled-1680-/schvaleno.png).](https://doc.eainfoport.cz/uploads/images/gallery/2022-05/schvaleno.png) Poté stiskneme tlačítko [![savesetup.png](https://doc.eainfoport.cz/uploads/images/gallery/2022-05/scaled-1680-/savesetup.png), ](https://doc.eainfoport.cz/uploads/images/gallery/2022-05/savesetup.png) počkáme až se celý Configuration Manager nastaví a uloží. Vyskočí nám tato stránka, kde stačí v Url adrese odmazat ***/Setup/Save*** a dát Enter.[![error.png](https://doc.eainfoport.cz/uploads/images/gallery/2022-05/scaled-1680-/wbnerror.png)](https://doc.eainfoport.cz/uploads/images/gallery/2022-05/wbnerror.png) - [Show Password ](https://doc.eainfoport.cz/books/instalacni-manual/page/show-password) - [Licence](https://doc.eainfoport.cz/books/instalacni-manual/page/1-licence) - [Infoport Database Connection](https://doc.eainfoport.cz/books/instalacni-manual/page/2-infoport-database-connection) - [URL](https://doc.eainfoport.cz/books/instalacni-manual/page/3-url) - [Serilog](https://doc.eainfoport.cz/books/instalacni-manual/page/4-serilog) - [Active Directory](https://doc.eainfoport.cz/books/instalacni-manual/page/5-active-directory-ldap-section) - [OpenID](https://doc.eainfoport.cz/books/instalacni-manual/page/5-openid) - [Environment](https://doc.eainfoport.cz/books/instalacni-manual/page/6-environment) - [Infoport na pozadí](https://doc.eainfoport.cz/books/instalacni-manual/page/7-infoport-na-pozadi) # Show Password [![pass.png](https://doc.eainfoport.cz/uploads/images/gallery/2022-05/scaled-1680-/1Qepass.png)](https://doc.eainfoport.cz/uploads/images/gallery/2022-05/1Qepass.png) Po zakliknutí checkboxu se zobrazí všechna hesla v konfiguračním manageru. # Licence Licenční klíč Vám zašle firma Dataprojekt s.r.o. [![licence.png](https://doc.eainfoport.cz/uploads/images/gallery/2022-05/scaled-1680-/licence.png)](https://doc.eainfoport.cz/uploads/images/gallery/2022-05/licence.png) - - - - - - V první sekci vkládáme licenční klíč a nastavujeme dobu expirace přihlášení uživatele. [![lic klíč.png](https://doc.eainfoport.cz/uploads/images/gallery/2022-05/scaled-1680-/lic-klic.png)](https://doc.eainfoport.cz/uploads/images/gallery/2022-05/lic-klic.png) - - - - - - Automatic Logout Time je bezpečnostní prvek, který slouží k automatickému odhlášení při jeho delší nečinnosti. [![Snímek obrazovky 2022-03-15 143042.png](https://doc.eainfoport.cz/uploads/images/gallery/2022-03/scaled-1680-/snimek-obrazovky-2022-03-15-143042.png)](https://doc.eainfoport.cz/uploads/images/gallery/2022-03/snimek-obrazovky-2022-03-15-143042.png) - - - - - - Multi Company Mode Pokud bude Multi Company aktivován (*zaškrtnutý checkbox*) tak bude vidět jen Login Email, jak při zakládání nového uživatele, tak i při editaci stávajícího uživatele. Taktéž bude vidět Login Email na přihlašovací obrazovce. [![multicompany.png](https://doc.eainfoport.cz/uploads/images/gallery/2022-05/scaled-1680-/multicompany.png)](https://doc.eainfoport.cz/uploads/images/gallery/2022-05/multicompany.png) - - - - - - Statistic Key For Monitoring je klíč pro sdílení statistiky jiným uživatelům. Po kliknutí na tlačítko Generate Statistics Access Key se vygeneruje klíč. [![Snímek obrazovky 2022-03-15 143138.png](https://doc.eainfoport.cz/uploads/images/gallery/2022-03/scaled-1680-/AE9snimek-obrazovky-2022-03-15-143138.png)](https://doc.eainfoport.cz/uploads/images/gallery/2022-03/AE9snimek-obrazovky-2022-03-15-143138.png)[![Snímek obrazovky 2022-03-15 143525.png](https://doc.eainfoport.cz/uploads/images/gallery/2022-03/scaled-1680-/snimek-obrazovky-2022-03-15-143525.png)](https://doc.eainfoport.cz/uploads/images/gallery/2022-03/snimek-obrazovky-2022-03-15-143525.png) # Infoport Database Connection První sekce v konfiguraci obsahuje nastavení Infoport databáze. (Databázové schéma, v kterém má program uložené veškeré nastavení). [![infoport database .png](https://doc.eainfoport.cz/uploads/images/gallery/2022-03/scaled-1680-/infoport-database.png)](https://doc.eainfoport.cz/uploads/images/gallery/2022-03/infoport-database.png) V první položce si zvolíme typ databáze. Máme na výběr ze tří typů. 1. MySQL s defaultním portem 3306 2. Microsoft SQL Server s defaultním portem 1433 3. Oracle s defaultním portem 1521 4. PostgreSQL s defaultním portem 5432 Po zvolení typu se nám automaticky vyplní hodnota položky Port. [![dbms_0.png](https://doc.eainfoport.cz/uploads/images/gallery/2022-03/scaled-1680-/dbms-0.png)](https://doc.eainfoport.cz/uploads/images/gallery/2022-03/dbms-0.png) Druhá položka je nastavení IP adresy serveru databáze. (Pokud Vám Infoport běží na stejném stroji s databází, stačí vyplnit lokální IP adresu). [![server.png](https://doc.eainfoport.cz/uploads/images/gallery/2022-03/scaled-1680-/server.png)](https://doc.eainfoport.cz/uploads/images/gallery/2022-03/server.png) Třetí položka je nastavení portu serveru databáze. Defaultně předvyplněný údaj podle typu databáze je možné změnit. [![port.png](https://doc.eainfoport.cz/uploads/images/gallery/2022-03/scaled-1680-/port.png)](https://doc.eainfoport.cz/uploads/images/gallery/2022-03/port.png) Čtvrtá položka má význam jen pro MySQL a Microsoft SQL Server. Vyplňujeme název schématu, do kterého si Infoport vytvoří svoje tabulky. (Pokud není schéma vytvořené na databázovém serveru, Infoport si ho vytvoří sám, když má uživatel v databázi dostatečná oprávnění). [![database.png](https://doc.eainfoport.cz/uploads/images/gallery/2022-03/scaled-1680-/database.png)](https://doc.eainfoport.cz/uploads/images/gallery/2022-03/database.png) Další dvě položky jsou uživatel a heslo. Musíme vyplnit uživatele, který má DML a DDL práva do naší zvolené databáze. [![user.png](https://doc.eainfoport.cz/uploads/images/gallery/2022-03/scaled-1680-/user.png)](https://doc.eainfoport.cz/uploads/images/gallery/2022-03/user.png) Položka Timeout slouží k nastavení maximální délky dotazu do databáze, má vliv především u dotazů během vyhledávání. [![timeout.png](https://doc.eainfoport.cz/uploads/images/gallery/2022-03/scaled-1680-/timeout.png)](https://doc.eainfoport.cz/uploads/images/gallery/2022-03/timeout.png) # URL V druhé sekci určíme, na jaké URL bude Infoport poslouchat. [![url.png](https://doc.eainfoport.cz/uploads/images/gallery/2022-06/scaled-1680-/url.png)](https://doc.eainfoport.cz/uploads/images/gallery/2022-06/url.png) - - - - - - ***TLS*** Pokud používáme zabezpečenou komunikaci, je možné zvolit verzi/verze TLS, které považujeme za dostatečně bezpečné. Například verze 1.1. není po roce 2021 na operačním systémů Windows podporována a neměla by se používat. [![tls url.png](https://doc.eainfoport.cz/uploads/images/gallery/2022-05/scaled-1680-/tls-url.png)](https://doc.eainfoport.cz/uploads/images/gallery/2022-05/tls-url.png) - - - - - - *URL* se skládá ze tří částí. První určuje protokol (http nebo https), ve druhé je IP adresa a třetí část je port. Chceme-li používat https (viz níže), musí být certifikát vystaven na stejnou IP adresu, jakou zde uvedeme. [![url protocol.png](https://doc.eainfoport.cz/uploads/images/gallery/2022-05/scaled-1680-/url-protocol.png)](https://doc.eainfoport.cz/uploads/images/gallery/2022-05/url-protocol.png) - - - - - - ***Protocol Http1 a Http 2*** Jsou to protokoly, které jsou nastavené defaultně. Uživatel si musí nastavit jen Protocol Http1, který podporuje fungování Windows Autentizace.[![http.png](https://doc.eainfoport.cz/uploads/images/gallery/2022-05/scaled-1680-/http.png)](https://doc.eainfoport.cz/uploads/images/gallery/2022-05/http.png) - - - - - - ***Pfx File*** Dalšími položkami k vyplnění jsou cesta a heslo k certifikátu k výše zadané URL. [![pfx file.png](https://doc.eainfoport.cz/uploads/images/gallery/2022-05/scaled-1680-/pfx-file.png)](https://doc.eainfoport.cz/uploads/images/gallery/2022-05/pfx-file.png) - - - - - - ***Installed certificate*** [![1url.png](https://doc.eainfoport.cz/uploads/images/gallery/2022-05/scaled-1680-/1url.png)](https://doc.eainfoport.cz/uploads/images/gallery/2022-05/1url.png) [![2url.png](https://doc.eainfoport.cz/uploads/images/gallery/2022-05/scaled-1680-/BiY2url.png)](https://doc.eainfoport.cz/uploads/images/gallery/2022-05/BiY2url.png) ***Https Redirection*** Když se zapne/zaškrtne checkbox u Https Redirection, tak se všechny http requesty převádí na https a na port, který se nastaví. [![3url.png](https://doc.eainfoport.cz/uploads/images/gallery/2022-05/scaled-1680-/3url.png)](https://doc.eainfoport.cz/uploads/images/gallery/2022-05/3url.png) - - - - - - ***Max Request Headers Total Size In KB*** Tento parametr umožnuje nastavit maximální povolenou velikost requestu. Některé requesty můžou obsahovat větší množství dat a Infoport je nedokáže zpracovat. (*Například přihlášení přes OpenID, kde se posílaly všechny skupiny, ve kterých uživatel je*). [![url max request.png](https://doc.eainfoport.cz/uploads/images/gallery/2022-06/scaled-1680-/url-max-request.png)](https://doc.eainfoport.cz/uploads/images/gallery/2022-06/url-max-request.png) - - - - - - Pokud chceme další URL, na kterém bude portál poslouchat, stiskneme tlačítko [![add url.png](https://doc.eainfoport.cz/uploads/images/gallery/2022-05/scaled-1680-/add-url.png)](https://doc.eainfoport.cz/uploads/images/gallery/2022-05/add-url.png) a vytvoří se nám nové položky k vyplnění. Pokud chceme smazat URL, stiskneme tlačítko [![delete url.png](https://doc.eainfoport.cz/uploads/images/gallery/2022-05/scaled-1680-/delete-url.png)](https://doc.eainfoport.cz/uploads/images/gallery/2022-05/delete-url.png). # Serilog Třetí sekce nám umožní nastavit logování Infoportu. První položka je zaškrtávací políčko, které říká, jestli mají být logovány aktivity uživatelů. (Přehled navštívených URL). [![insighs.png](https://doc.eainfoport.cz/uploads/images/gallery/2022-03/scaled-1680-/insighs.png)](https://doc.eainfoport.cz/uploads/images/gallery/2022-03/insighs.png) V druhé položce volíme relativní cestu na ukládání logů. [![Log path.png](https://doc.eainfoport.cz/uploads/images/gallery/2022-03/scaled-1680-/log-path.png)](https://doc.eainfoport.cz/uploads/images/gallery/2022-03/log-path.png) V třetí položce vybíráme typ logování. (Každý typ je popsán v tabulce, doporučujeme logování Information). [![logtype.png](https://doc.eainfoport.cz/uploads/images/gallery/2022-03/scaled-1680-/logtype.png)](https://doc.eainfoport.cz/uploads/images/gallery/2022-03/logtype.png) Tabulka pro typy logování.
**Úroveň (od nejpodrobnějšího k nejméně podrobnému)** **Popis**
Verbose For information that's typically valuable only for debugging. These messages may contain sensitive application data and so shouldn't be enabled in a production environment. Disabled by default.
Debug For information that may be useful in development and debugging. Example: Entering method Configure with flag set to true. Enable Debug level logs in production only when troubleshooting, due to the high volume of logs.
Information For tracking the general flow of the app. These logs typically have some long-term value. Example:Request received for path/api/todo
Warning For abnormal or unexpected events in the app flow. These may include errors or other conditions that don´t cause the app to stop but might need to be investigadet. Handled exceptions are a common place to use the Warning log level. Example: FileNotFoundException for file quotes.txt.
Error For errors and exceptions that cannot be handled. These messages indicate a failure in the current aktivity or operation (such as the current http request), not an app-wide failure. Example log message: Cannot insert record due to duplicate key violation.
Fatal For failures that require immediate attention. Examples: data loss scenarios, out of disk space.
Ve čtvrté položce vybíráme, kam chceme, aby se logy zapisovaly. Máme tři možnosti: Konzole, Soubor nebo Obojí. [![service log write to.png](https://doc.eainfoport.cz/uploads/images/gallery/2022-03/scaled-1680-/service-log-write-to.png)](https://doc.eainfoport.cz/uploads/images/gallery/2022-03/service-log-write-to.png) V páté položce volíme, jak často se má logovací soubor uzavírat. [![rollinginterval.png](https://doc.eainfoport.cz/uploads/images/gallery/2022-03/scaled-1680-/rollinginterval.png)](https://doc.eainfoport.cz/uploads/images/gallery/2022-03/rollinginterval.png) Zde můžeme vidět zvolený den. Znamená to, že se nám každý den vytvoří nový soubor s logy pro portál. Logy z minulých dnů zůstávají na disku. Po vyplnění stačí stisknout tlačítko [![check.png](https://doc.eainfoport.cz/uploads/images/gallery/2022-03/scaled-1680-/check.png)](https://doc.eainfoport.cz/uploads/images/gallery/2022-03/check.png)a manager Vám zahlásí, jestli je vše v pořádku. # Active Directory - LDAP Section V této sekci nastavujeme Active Directory pomocí LDAP protokolu. [![AD.png](https://doc.eainfoport.cz/uploads/images/gallery/2022-05/scaled-1680-/xT4ad.png)](https://doc.eainfoport.cz/uploads/images/gallery/2022-05/xT4ad.png) "*Active*" nám určuje, jestli chceme, aby Infoport pracoval s AD. "*Automatic Login*" určí, jestli se uživatelé do AD automaticky přihlásí, pokud zadají v prohlížeči URL Infoportu. "*Database Preference*" nám určuje, že se při přihlašování jde nejdřív do databáze k uživatelům a teprve potom do AD "*False Login As Host*" nám umožňuje zvolit, jestli chceme, aby se uživatel, který není v AD mohl přihlásit jako host portálu. # OpenID [![openID.png](https://doc.eainfoport.cz/uploads/images/gallery/2022-06/scaled-1680-/openid.png)](https://doc.eainfoport.cz/uploads/images/gallery/2022-06/openid.png) - - - - - - ***Server Realm*** – vyplníme odkaz na open id server [![image-1665479608966.png](https://doc.eainfoport.cz/uploads/images/gallery/2022-10/scaled-1680-/image-1665479608966.png)](https://doc.eainfoport.cz/uploads/images/gallery/2022-10/image-1665479608966.png) - - - - - - ***Metadata*** – vyplníme odkaz na metadata open id serveru [![image-1665479593158.png](https://doc.eainfoport.cz/uploads/images/gallery/2022-10/scaled-1680-/image-1665479593158.png)](https://doc.eainfoport.cz/uploads/images/gallery/2022-10/image-1665479593158.png) - - - - - - ***ClientID*** – vyplníme odkaz na identifikátor Clienta [![image-1665479977551.png](https://doc.eainfoport.cz/uploads/images/gallery/2022-10/scaled-1680-/image-1665479977551.png)](https://doc.eainfoport.cz/uploads/images/gallery/2022-10/image-1665479977551.png) - - - - - - ***Client Secret*** – vložíme client secret [![image-1665479962615.png](https://doc.eainfoport.cz/uploads/images/gallery/2022-10/scaled-1680-/image-1665479962615.png)](https://doc.eainfoport.cz/uploads/images/gallery/2022-10/image-1665479962615.png) - - - - - - ***Redirect Uri*** – zadáme url, která se zavolá po odhlášení z infoportu [![image-1665479987025.png](https://doc.eainfoport.cz/uploads/images/gallery/2022-10/scaled-1680-/image-1665479987025.png)](https://doc.eainfoport.cz/uploads/images/gallery/2022-10/image-1665479987025.png) - - - - - - ***Infoport Group for Portals Admins*** – zadáme název skupiny, u které chceme, aby v ní byli uživatelé portálový administrátoři v Infoportu [![image-1665480000658.png](https://doc.eainfoport.cz/uploads/images/gallery/2022-10/scaled-1680-/image-1665480000658.png)](https://doc.eainfoport.cz/uploads/images/gallery/2022-10/image-1665480000658.png) - - - - - - ***LogoutUri*** – zadáme url, která odhlašuje z open id [![image-1665480018624.png](https://doc.eainfoport.cz/uploads/images/gallery/2022-10/scaled-1680-/image-1665480018624.png)](https://doc.eainfoport.cz/uploads/images/gallery/2022-10/image-1665480018624.png) - - - - - - ***Claim that belongs to the username*** – zadáme claim, podle kterého si infoport bude vytahovat infoport username z odpovědi [![image-1665480031495.png](https://doc.eainfoport.cz/uploads/images/gallery/2022-10/scaled-1680-/image-1665480031495.png)](https://doc.eainfoport.cz/uploads/images/gallery/2022-10/image-1665480031495.png) - - - - - - ***Claim that belongs to the email*** – zadáme claim, podle kterého si infoport bude vytahovat email z odpovědi [![image-1665480040204.png](https://doc.eainfoport.cz/uploads/images/gallery/2022-10/scaled-1680-/image-1665480040204.png)](https://doc.eainfoport.cz/uploads/images/gallery/2022-10/image-1665480040204.png) - - - - - - ***Claim that belongs to the forename*** – zadáme claim, podle kterého si infoport bude vytahovat křestní jméno uživatele z odpovědi [![image-1665480049916.png](https://doc.eainfoport.cz/uploads/images/gallery/2022-10/scaled-1680-/image-1665480049916.png)](https://doc.eainfoport.cz/uploads/images/gallery/2022-10/image-1665480049916.png) - - - - - - ***Claim that belongs to the surname*** – zadáme claim, podle kterého si infoport bude vytahovat příjmení uživatele z odpovědi [![image-1665480059247.png](https://doc.eainfoport.cz/uploads/images/gallery/2022-10/scaled-1680-/image-1665480059247.png)](https://doc.eainfoport.cz/uploads/images/gallery/2022-10/image-1665480059247.png) - - - - - - ***Claim that belongs to the groups*** – zadáme claim, podle kterého si infoport bude vytahovat skupiny, do kterých patří uživatel z odpovědi [![image-1665480067373.png](https://doc.eainfoport.cz/uploads/images/gallery/2022-10/scaled-1680-/image-1665480067373.png)](https://doc.eainfoport.cz/uploads/images/gallery/2022-10/image-1665480067373.png) - - - - - - Přidáme ***Open ID Scopes***, aby se nám vracely všechny potřebné atributy [![image-1665480078281.png](https://doc.eainfoport.cz/uploads/images/gallery/2022-10/scaled-1680-/image-1665480078281.png)](https://doc.eainfoport.cz/uploads/images/gallery/2022-10/image-1665480078281.png) # Environment První položkou je zaškrtávací políčko, kterým určujeme, jestli chceme publikované obrázky ukládat i do databáze. V další třech položkách si volíme relativní cestu, do které se budou ukládat publikované obrázky, kešované obrázky a dočasné soubory. [![Envir.png](https://doc.eainfoport.cz/uploads/images/gallery/2022-03/scaled-1680-/envir.png)](https://doc.eainfoport.cz/uploads/images/gallery/2022-03/envir.png) # Infoport na pozadí Infoport provádí různé funkce na pozadí. Některé může uživatel nastavit, jiné běží podle defaultních nastaveních. Konfigurovatelné funkce najde uživatel v souboru „***appsettings.json***“. Funkce především pracují s repozitáři. V ***Configuration Manageru*** volí uživatel některé funkce na pozadí. Po spuštění začne funkce pracovat v pozadí a načítat postupně stromeček pro uživatele (funkce nese název *InitialLoadCacheDeep* v Background sekci). [![cache.png](https://doc.eainfoport.cz/uploads/images/gallery/2022-03/scaled-1680-/cache.png)](https://doc.eainfoport.cz/uploads/images/gallery/2022-03/cache.png) 1. [SynchronizeADUserJob](https://doc.eainfoport.cz/books/instalacni-manual/page/synchronizeaduserjob) 2. [SynchronizeSparxUserJob](https://doc.eainfoport.cz/books/instalacni-manual/page/synchronizesparxuserjob) 3. [Startup Jobs](https://doc.eainfoport.cz/books/instalacni-manual/page/startup-jobs) 4. [Scheduler Jobs](https://doc.eainfoport.cz/books/instalacni-manual/page/scheduler-jobs) # SynchronizeADUserJob [![synchronize AD User Job.png](https://doc.eainfoport.cz/uploads/images/gallery/2022-05/scaled-1680-/synchronize-ad-user-job.png)](https://doc.eainfoport.cz/uploads/images/gallery/2022-05/synchronize-ad-user-job.png) Synchronizace s uživateli *Infoportu* je pro uživatele z *AD*. Funkce se jmenuje ***SynchronizeADUserJob***. Opět má cron položku pro pravidelné spouštění synchornizace. #### CreateUser a AddUserToGroup ***CreateUser*** je příznak toho, jestli chceme, aby se uživatelé z AD vytvářeli do Infoportu. ***AddUserToGroup*** je zase příznak, jestli chceme, aby se uživatelé přidávali do skupin. [![synchronizaad.png](https://doc.eainfoport.cz/uploads/images/gallery/2022-03/scaled-1680-/synchronizaad.png)](https://doc.eainfoport.cz/uploads/images/gallery/2022-03/synchronizaad.png) # SynchronizeSparxUserJob [![synchronize sparx User Job.png](https://doc.eainfoport.cz/uploads/images/gallery/2022-05/scaled-1680-/synchronize-sparx-user-job.png)](https://doc.eainfoport.cz/uploads/images/gallery/2022-05/synchronize-sparx-user-job.png) Nyní probereme funkci pro synchronizaci *Sparx* uživatelů s uživateli *Infoportu*. Funkce se jmenuje ***SynchronizeSparxUserJob***. Obsahuje jedinou položku pro nastavení (*cronovské nastavení*). Podle zadaného nastavení se pravidelně synchronizuji uživatelé. [![synchronizasesparx.png](https://doc.eainfoport.cz/uploads/images/gallery/2022-03/scaled-1680-/synchronizasesparx.png)](https://doc.eainfoport.cz/uploads/images/gallery/2022-03/synchronizasesparx.png) # Startup Jobs Jsou to procesy, které se spustí vždy jen jednou při startu aplikace a vykonají činnosti, které jsou potřeba provést před tím, než aplikaci začnou používat uživatelé. ### Prefetch Repository Cache Job [![Prefetch.png](https://doc.eainfoport.cz/uploads/images/gallery/2022-05/scaled-1680-/prefetch.png)](https://doc.eainfoport.cz/uploads/images/gallery/2022-05/prefetch.png) Při každém spuštění aplikace se z databáze do paměťové keše načítá základní část stromečku repozitory. Důvodem je zrychlení práce uživatele při procházení stromečkem. To, kolik úrovní se načte je závislé na parametrech „*Initial Load Cache Deep*“ a „*Maximum Auto Cache Deep*“. První „***Initial Load Cache Deep***“ udává, kolik úrovní se načte před tím, než aplikace začne „*poslouchat*“ a je k dispozici uživatelům. Zde je vhodné volit 3 až 5 úrovní. - ***Hodnotu 3*** pokud je repozitoř organizovaná spíše do šířky *(to znamená, že na jedné úrovni je větší množství {>>50} modelů či balíčků).* - ***Hodnotu 5*** pro balíčky organizované převážně do hloubky (*zanořování balíčků*). [![Initial Load Cache de.png](https://doc.eainfoport.cz/uploads/images/gallery/2022-03/scaled-1680-/initial-load-cache-de.png)](https://doc.eainfoport.cz/uploads/images/gallery/2022-03/initial-load-cache-de.png) Pokud je druhý parametr „***Maximum Auto Cache Deep***“ nastaven na větší hodnotu než první (*doporučeno je 7 až 13*), pokračuje načítání dat do keše i poté, co je aplikace uživatelům dostupná. To se děje postupně až do hloubky stromečku určené tímto parametrem. [![Maximum_0.png](https://doc.eainfoport.cz/uploads/images/gallery/2022-03/scaled-1680-/maximum-0.png)](https://doc.eainfoport.cz/uploads/images/gallery/2022-03/maximum-0.png) Pokud libovolný uživatel prochází stromečkem hlouběji, než je nastaveno v parametru pro maximální automatické načtení (*„Maximum Auto Cache Deep*“), dochází k rozšiřování keše o zobrazená data. Další uživatelé tak mají zobrazení výrazně urychlené. Tato nakešovaná data mají pak vliv na to, jak mohou (budou-li tak nakonfigurované) fungovat i některé další joby („*Regenerate Repository Tree“, „Regenerate Existing Image“, „Regenerate Missing Image*“). # Scheduler Jobs Jsou to procesy, které se spouštějí pravidelně a slouží k udržování aplikace v dobré kondici. Jde především o občerstvování dat v paměťové a diskové keši, o různé datové synchronizace a o odstraňování nepotřebných dat a systémových procesů. #### Společná nastavení u všech naplánovaných Jobů Základní parametrem pro každý job je informace o tom, s jakou periodicitou poběží. Je možné nastavit jeho spuštění každou minutu, nebo třeba jen jednou za měsíc. K tomu se používá syntaxe známá jako ***[CRON](https://en.wikipedia.org/wiki/Cron)*** a v konfigurátoru tomu odpovídá vždy pět položek (*Minute, Hour, Day of the Month, Month a Day of the week)*. [![1.png](https://doc.eainfoport.cz/uploads/images/gallery/2022-03/scaled-1680-/1.png)](https://doc.eainfoport.cz/uploads/images/gallery/2022-03/1.png) U každého jobu je také možné nastavit, zda se má spustit ihned po startu aplikace (serveru) a to zaškrtnutím položky „***Run Immediately***“. [![run immediately.png](https://doc.eainfoport.cz/uploads/images/gallery/2022-03/scaled-1680-/run-immediately.png)](https://doc.eainfoport.cz/uploads/images/gallery/2022-03/run-immediately.png) - [Regenerate Repository Tree Job](https://doc.eainfoport.cz/books/instalacni-manual/page/regenerate-repository-tree-job) - [Regenerate Image](https://doc.eainfoport.cz/books/instalacni-manual/page/142-regenerate-image) - [Clean Dcom Job](https://doc.eainfoport.cz/books/instalacni-manual/page/144-clean-dcom-job) - [Cleaning Disk Cache Job](https://doc.eainfoport.cz/books/instalacni-manual/page/145-cleaning-disk-cache-job) # Regenerate Repository Tree Job [![regenerate.png](https://doc.eainfoport.cz/uploads/images/gallery/2022-05/scaled-1680-/regenerate.png)](https://doc.eainfoport.cz/uploads/images/gallery/2022-05/regenerate.png) Tento job je určen k periodické aktualizaci stromečku repozitáře nezávisle na uživatelích. Při spuštění postupně prochází celý, do té doby nakešovaný stromeček a porovnává jej se stavem v databázi. Pokud nezjistí žádné rozdíly, tak ponechá větve stromečku nedotčeny. Pokud ale na nějaké úrovni zanoření zjistí změnu (*přidaný / odebraný / změněný artefakt*) odebere z keše všechny hlouběji zanořené artefakty a obnoví je z databáze. Toto obnovení postupuje do hloubky zanoření dané parametrem „***Maximum Auto Cache Deep***“ ze sekce „***Prefetch Repository Cache***“. Vhodné načasování je okamžik, kdy uživatelé s programem pracují minimálně, tzn. v nočních hodinách a po (*případných*) automatických synchronizacích modelů na úrovni databáze nějakým externím softwarem. # Regenerate Image Obrázky diagramů se generují obecně dvěma způsoby. Buď tím, že si uživatel zobrazí detail diagramu anebo joby na pozadí „***Regenerate Existing Image***" a „***Regenerate Missing Image***". Po vygenerování se obrázek uloží do diskové keše a po opětovném požadavku (kteréhokoliv) uživatele, se z disku zobrazí. Obrázky ale také zastarávají a to tím, že jej někdo upraví nebo změní jeho metadata. Pokud si uživatel zobrazí obrázek diagramu, který byl nedávno modifikován, systém to pozná. Zobrazí původní zastaralý obrázek z diskové keše a začne diagram přegenerovávat. To ale zabírá určitý čas (typicky vyšší jednotky sekund) a uživatele to zdržuje. Proto existují dva joby, které se tomuto snaží předcházet, vyhledávají zastaralé nebo dosud nevygenerované diagramy a regenerují je. - [RegenerateExistingImageJob](https://doc.eainfoport.cz/books/instalacni-manual/page/regenerateexistingimagejob) - [Regenerate Missing Image Job](https://doc.eainfoport.cz/books/instalacni-manual/page/regenerate-missing-image-job) # Regenerate Existing Image Job [![existing.png](https://doc.eainfoport.cz/uploads/images/gallery/2022-05/scaled-1680-/existing.png)](https://doc.eainfoport.cz/uploads/images/gallery/2022-05/existing.png) Tento job má za úkol přegenerovávat dříve vytvořené obrázky diagramů. Rozpoznává, jestli byl diagram od posledního vytvoření jeho obrázku modifikován a případně jej nechá znovu vytvořit a uložit do diskové keše. Slovo *Existing* v názvu tohoto jobu znamená, že se práce tohoto jobu týká výhradně diagramů, k nimž v diskové keši již „nějaký“ obrázek existuje (*neexistující obrázky řeší job „**Regenerate Missing Image**“).* Přepínač „***Only By Tree Cache***“ určuje, jestli se regenerace zaměří pouze na ty obrázky na disku, které patří diagramům aktuálně načteným v paměťové keši stromečku (viz. „***Prefetch Repository Cache***“). Pokud tento přepínač není zaškrtnutý, job zajistí aktuálnost všech obrázků uložených v diskové keši bez ohledu na to, jaký je aktuální stav stromečku. [![only be tree cache.png](https://doc.eainfoport.cz/uploads/images/gallery/2022-03/scaled-1680-/only-be-tree-cache.png)](https://doc.eainfoport.cz/uploads/images/gallery/2022-03/only-be-tree-cache.png) Přepínače „***Check Modified Date***“ a „***Check Hash Matching***“ slouží k upřesnění metody, který program použije pro rozpoznání, že obrázek je zastaralý. První z nich „***Check Modified Date***“ znamená, že je kontrolováno časové razítko souboru oproti časovému razítku diagramu v databázi. Toto je velmi rychlé, ale spolehlivost je někde okolo 90 %. Je to dáno tím, že ne všechny úpravy na diagramu aktualizují toto časové razítko (toto je přímo vlastnost programu Enterprise Architect). [![Check modifite date.png](https://doc.eainfoport.cz/uploads/images/gallery/2022-03/scaled-1680-/check-modifite-date.png)](https://doc.eainfoport.cz/uploads/images/gallery/2022-03/check-modifite-date.png) Druhý přepínač „***Check Hash Matching***“ určuje, že se pro kontrolu aktuálnosti použije výpočet tzv. hashe všech metadat mající vliv na vizuální stránku obrázku. Tato metoda je sice 100 % spolehlivá, ale je časově náročná. [![check hash matching.png](https://doc.eainfoport.cz/uploads/images/gallery/2022-03/scaled-1680-/check-hash-matching.png)](https://doc.eainfoport.cz/uploads/images/gallery/2022-03/check-hash-matching.png) Oba přepínač je možné „*kombinovat*“. Pokud nezaškrtneme ani jeden, tak tím programu říkáme, aby nic nekontroloval a všechny diagramy rovnou přegenerovával. Poslední možností je zaškrtnutí obou přepínačů, díky čemuž program nejprve zkontroluje datum modifikace a pak teprve hash. Doporučené nastavení je mít zaškrtnuté pouze „***Check Modified Date***“ s tím, že pravděpodobnost nepřegenerování zastaralého diagramu není až tak zásadní komplikací. V případě, že si uživatel zobrazí (zastaralý) obrázek diagramu, je v každém případě hash kontrolován a na neaktuálnost program reaguje jeho přegenerování a následným zobrazením občerstveného obrázku. Posledním parametrem tohoto jobu je „***Gap Miliseconds***“. Jde o interval mezi generováním obrázků jednotlivých diagramů. Ty se typicky negenerují ihned jeden za druhým, ale je zde ponechána časová prodleva. Ta slouží k tomu, aby se mohl bez zbytečných odkladů zpracovat i požadavek uživatele na generování obrázku. Defaultní hodnota tohoto parametru je *5000* (tzn. 5s), pokud ale víme, že v době regenerování nebudou uživatelé aktivní, je možné tento parametr výrazně *snížit nebo ho nastavit na 0.* *[![gap.png](https://doc.eainfoport.cz/uploads/images/gallery/2022-03/scaled-1680-/gap.png)](https://doc.eainfoport.cz/uploads/images/gallery/2022-03/gap.png)* # Regenerate Missing Image Job [![missing.png](https://doc.eainfoport.cz/uploads/images/gallery/2022-05/scaled-1680-/missing.png)](https://doc.eainfoport.cz/uploads/images/gallery/2022-05/missing.png) Tento job má za úkol dogenerovávat ještě nevytvořené obrázky diagramů a ukládat je do diskové keše. Nijak nepracuje s obrázky již vytvořenými a uloženými v keši, a to ani tehdy, pokud by byly zastaralé (k tomu slouží „***Regenerate Existing Image***“). Přepínač „***Only By Tree Cache***“ určuje, jestli se generování zaměří pouze na diagramy aktuálně načtené v paměťové keši stromečku (viz. „*Prefetch Repository Cache*“). Pokud tento přepínač není zaškrtnutý, job zajistí vygenerování všech obrázků diagramů, které jsou součásti kompletního stromečku. [![only be tree cache.png](https://doc.eainfoport.cz/uploads/images/gallery/2022-03/scaled-1680-/only-be-tree-cache.png)](https://doc.eainfoport.cz/uploads/images/gallery/2022-03/only-be-tree-cache.png) Posledním parametrem tohoto jobu je „***Gap Miliseconds***“. Jde o interval mezi generováním obrázků jednotlivých diagramů. Ty se typicky negenerují ihned jeden za druhým, ale je zde ponechána časová prodleva. Ta slouží k tomu, aby se mohl bez zbytečných odkladů zpracovat i požadavek uživatele na generování obrázku. Defaultní hodnota tohoto parametru je 5000 (tzn. 5s), pokud ale víme, že v době regenerování nebudou uživatelé aktivní, je možné tento parametr výrazně snížit nebo ho nastavit na 0. [![gap.png](https://doc.eainfoport.cz/uploads/images/gallery/2022-03/scaled-1680-/gap.png)](https://doc.eainfoport.cz/uploads/images/gallery/2022-03/gap.png) # Clean Dcom Job [![clean dcom.png](https://doc.eainfoport.cz/uploads/images/gallery/2022-05/scaled-1680-/clean-dcom.png)](https://doc.eainfoport.cz/uploads/images/gallery/2022-05/clean-dcom.png) Job slouží k odstranění přebytečných *(typicky nefunkčních*) DCOMů z paměti operačního systému. DCOM je prostředník při komunikaci mezi EAInfoportem a Enterprise Architectem. DCOM je nejčastěji používán pro generování obrázků diagramů ale také k některým aktivním operacím (např založení a odstranění artefaktu). Pro připojení ke každé jedné repozitoři je potřeba minimálně jeden DCOM. V DCOMu občas dojde k chybě a ten je pak nezpůsobilý pro další komunikaci. Pokud k tomu dojde, je okamžitě (*a pro uživatele transparentně*) vytvořena v paměti nová instance DCOMu a ta se začne používat. Původní instance ale v tom okamžiku v paměti zůstává. Je odstraněna až tímto úklidovým jobem. Parametr „***Max Dcom Per Repository***“ udává, kolik je maximum tolerovaných DCOMů v paměti na jednu repozitory. To znamená, že program si tento parametr vynásobí počtem připojených repozitoří a zkontroluje, zda je celkový počet běžících DCOMů menší než toto číslo. „***Max Dcom Per Repository***“ nijak nerozlišuje, který DCOM „patří“ k jaké repozitoři. Pokud je limit překročen, jsou z paměti odstraněny všechny instance DCOMu a program ji je následně znovu při potřebě jejich použití vytvoří. [![max DCOM repository.png](https://doc.eainfoport.cz/uploads/images/gallery/2022-03/scaled-1680-/max-dcom-repository.png)](https://doc.eainfoport.cz/uploads/images/gallery/2022-03/max-dcom-repository.png) Pokud provozujete na jednom serveru vícero instalací EaInfoportu (což na různých portech lze), je potřeba parametr „*Max Dcom Per Repository*“ nastavit s vědomím, že každá instalace (má-li aktivní tento job) bude počet repozitoří počítat podle sebe. # Cleaning Disk Cache Job [![clean.png](https://doc.eainfoport.cz/uploads/images/gallery/2022-05/scaled-1680-/clean.png)](https://doc.eainfoport.cz/uploads/images/gallery/2022-05/clean.png) Tento job slouží k čištění diskové keše. Disková keš je adresář na disku, kam jsou ukládány obrázky diagramů, tak aby je bylo možné rychle zobrazovat uživatelům. Některé dávno vytvořené soubory s obrázky, už nemusí mít význam. Na disku zbytečně zabírají místo a je možné je odstranit. První ze dvou parametrů „***Safety Gap Seconds***“ chrání nejmladší (nejpozději vytvořené) soubory proti smazání. Například defaultní hodnota *86400* (což je 60\*60\*24 s) říká, že soubory vytvořené za posledních 24 hodin se nebudou uklízet (mazat) a to ani tehdy, pokud by celková jejich velikost na disku přesahovala přes limit (daný druhým parametrem). [![safety gap seconds.png](https://doc.eainfoport.cz/uploads/images/gallery/2022-03/scaled-1680-/safety-gap-seconds.png)](https://doc.eainfoport.cz/uploads/images/gallery/2022-03/safety-gap-seconds.png) Druhý parametr „***Disk Size Limit Bytes***“ říká, jaká je maximální celková velikost souborů na disku po úklidu. Job si seřadí soubory obrázků podle okamžiku jejich vytvoření a postupně je od nejstarších maže až do okamžiku, kdy zbylé zabírají na disku méně místa, než udává tento limit. Pokud by se ale měli mazat už i příliš „mladé“ soubory (dle prvního parametru) mazání se ukončí a na disku budou soubory zabírat více místa. [![disk size limit.png](https://doc.eainfoport.cz/uploads/images/gallery/2022-03/scaled-1680-/disk-size-limit.png)](https://doc.eainfoport.cz/uploads/images/gallery/2022-03/disk-size-limit.png) Mezi jednotlivými běhy tohoto jobu není nijak sledované (natož regulované), že soubory na disku nezabírají příliš místa. Velikost parametru „***Disk Size Limit Bytes***“ je vhodné nastavit tak, aby se soubory obrázků vygenerované pomocí „***Regenerate Missing Image***“ tak akorát vešli do diskového limitu. Pokud je totiž limit velikosti nižší než to, kolik zabírají obrázky, dochází k neustálému cyklickému (tzn. *zbytečnému*) generování a odmazávání těch samých obrázků. Pokud je obrázek diagramu už na disku uložen, tak jeho regenerování (*samozřejmě pokud nebyl jeho model rozšířen*) již další nárok na diskový prostor nevyžaduje. # Nastavení serveru pro e-mailová oznámení Vytvořili jsme tři notifikační služby, které upozorňují uživatele o změnách na diagramu - [*Notification Hour Job*](https://doc.eainfoport.cz/books/instalacni-manual/page/751-notification-hour-job) - [*Notifikation Day Job*](https://doc.eainfoport.cz/books/instalacni-manual/page/752-notification-day-job) - [*Notifiacation Week Job*](https://doc.eainfoport.cz/books/instalacni-manual/page/753-notification-week-job) Správce musí nastavit e-mailový server, aby bylo možné odesílat notifikační e-maily uživatelům. [![email server.png](https://doc.eainfoport.cz/uploads/images/gallery/2022-10/scaled-1680-/email-server.png)](https://doc.eainfoport.cz/uploads/images/gallery/2022-10/email-server.png) - - - - - - ***Mail Adress*** je okénko pro zadání emailového serveru. [![image-1665475238321.png](https://doc.eainfoport.cz/uploads/images/gallery/2022-10/scaled-1680-/image-1665475238321.png)](https://doc.eainfoport.cz/uploads/images/gallery/2022-10/image-1665475238321.png) - - - - - - ***Mail Port*** je okénko pro zadání emailového portu. [![image-1665475296514.png](https://doc.eainfoport.cz/uploads/images/gallery/2022-10/scaled-1680-/image-1665475296514.png)](https://doc.eainfoport.cz/uploads/images/gallery/2022-10/image-1665475296514.png) - - - - - - ***Mail Account*** je okénko pro zadání uživatelského jména, který má přístup na emailový server. [![image-1665475328780.png](https://doc.eainfoport.cz/uploads/images/gallery/2022-10/scaled-1680-/image-1665475328780.png)](https://doc.eainfoport.cz/uploads/images/gallery/2022-10/image-1665475328780.png) - - - - - - ***Mail Password*** je okénko pro zadání hesla pro uživatele. [![image-1665475484529.png](https://doc.eainfoport.cz/uploads/images/gallery/2022-10/scaled-1680-/image-1665475484529.png)](https://doc.eainfoport.cz/uploads/images/gallery/2022-10/image-1665475484529.png) - - - - - - ***Sender Email*** je nastavení emailu, který se bude ukazovat uživatelům, kterým přijde email o notifikaci o změně na EA diagramu. [![image-1665475511602.png](https://doc.eainfoport.cz/uploads/images/gallery/2022-10/scaled-1680-/image-1665475511602.png)](https://doc.eainfoport.cz/uploads/images/gallery/2022-10/image-1665475511602.png) - - - - - - ***Sender Name*** je nastavení jména, který se bude ukazovat uživatelům, kterým přijde email o notifikaci o změně na EA diagramu. [![image-1665475526536.png](https://doc.eainfoport.cz/uploads/images/gallery/2022-10/scaled-1680-/image-1665475526536.png)](https://doc.eainfoport.cz/uploads/images/gallery/2022-10/image-1665475526536.png) - - - - - - ***Redirect Address*** je políčko, kam uživatel zadá url Infoportu, aby se uživatel mohl odkázat přes odkaz v emailu na portál. [![image-1665475571050.png](https://doc.eainfoport.cz/uploads/images/gallery/2022-10/scaled-1680-/image-1665475571050.png)](https://doc.eainfoport.cz/uploads/images/gallery/2022-10/image-1665475571050.png) - - - - - - ***Diagram Thumbnail*** je checkbox, kterým se určí jestli chceme zasílat uživatelům v emailech zmenšené obrázky diagramu. [![image-1665475604811.png](https://doc.eainfoport.cz/uploads/images/gallery/2022-10/scaled-1680-/image-1665475604811.png)](https://doc.eainfoport.cz/uploads/images/gallery/2022-10/image-1665475604811.png) # Notification Hour Job Základním parametrem pro každý job je informace o tom, s jakou periodicitou poběží. Je možné nastavit jeho spuštění každou minutu, nebo třeba jen jednou za měsíc. K tomu se používá syntaxe známá jako ***[CRON](https://en.wikipedia.org/wiki/Cron)*** a v konfigurátoru tomu odpovídá vždy pět položek (*Minute, Hour, Day of the Month, Month a Day of the Week)*. U každého jobu je také možné nastavit, zda se má spustit ihned po startu aplikace (serveru) a to zaškrtnutím položky „***Run Immediately***“. [![hour job.png](https://doc.eainfoport.cz/uploads/images/gallery/2022-09/scaled-1680-/hour-job.png)](https://doc.eainfoport.cz/uploads/images/gallery/2022-09/hour-job.png) Tento job má za úkol zasílat uživateli upozornění na email o změně na diagramu. Pokud nezjistí žádnou změnu na diagramu, tak nezasílá upozornění. Pokud zjistí změnu na diagramu, tak job pošle emailem upozornění na diagram s provedenou změnou. - - - - - - Uživatel může na diagramu vidět ikonku "*informačního* *panáčka*", která po najetí na ní informuje jaký typ upozornění je nastavený.
[![diagram nastavení1.png](https://doc.eainfoport.cz/uploads/images/gallery/2022-09/scaled-1680-/diagram-nastaveni1.png)](https://doc.eainfoport.cz/uploads/images/gallery/2022-09/diagram-nastaveni1.png) Pro nastavení hodinového upozornění, musí uživatel kliknout na ikonku [![hodina.png](https://doc.eainfoport.cz/uploads/images/gallery/2022-09/scaled-1680-/hodina.png)](https://doc.eainfoport.cz/uploads/images/gallery/2022-09/hodina.png) a až se ikonka změní je zasílání diagramu nastaveno. # Notification Day Job Základním parametrem pro každý job je informace o tom, s jakou periodicitou poběží. Je možné nastavit jeho spuštění každou minutu, nebo třeba jen jednou za měsíc. K tomu se používá syntaxe známá jako ***[CRON](https://en.wikipedia.org/wiki/Cron)*** a v konfigurátoru tomu odpovídá vždy pět položek (*Minute, Hour, Day of the Month, Month a Day of the Week)*.
U každého jobu je také možné nastavit, zda se má spustit ihned po startu aplikace (serveru) a to zaškrtnutím položky „***Run Immediately***“. [![day jov.png](https://doc.eainfoport.cz/uploads/images/gallery/2022-09/scaled-1680-/day-jov.png)](https://doc.eainfoport.cz/uploads/images/gallery/2022-09/day-jov.png) Tento job má za úkol zasílat uživateli upozornění na email o změně na diagramu. Pokud nezjistí žádnou změnu na diagramu, tak nezasílá upozornění. Pokud zjistí změnu na diagramu, tak job pošle emailem upozornění na diagram s provedenou změnou. - - - - - - Uživatel může na diagramu vidět ikonku "*informačního* *panáčka*", která po najetí na ní informuje jaký typ upozornění je nastavený.
[![diagram nastavení1.png](https://doc.eainfoport.cz/uploads/images/gallery/2022-09/scaled-1680-/diagram-nastaveni1.png)](https://doc.eainfoport.cz/uploads/images/gallery/2022-09/diagram-nastaveni1.png) Pro nastavení denního upozornění, musí uživatel kliknout na ikonku [![den.png](https://doc.eainfoport.cz/uploads/images/gallery/2022-09/scaled-1680-/den.png)](https://doc.eainfoport.cz/uploads/images/gallery/2022-09/den.png) a až se ikonka změní je zasílání diagramu nastaveno. # Notification Week Job Základním parametrem pro každý job je informace o tom, s jakou periodicitou poběží. Je možné nastavit jeho spuštění každou minutu, nebo třeba jen jednou za měsíc. K tomu se používá syntaxe známá jako ***[CRON](https://en.wikipedia.org/wiki/Cron)*** a v konfigurátoru tomu odpovídá vždy pět položek (*Minute, Hour, Day of the Month, Month a Day of the Week)*.
U každého jobu je také možné nastavit, zda se má spustit ihned po startu aplikace (serveru) a to zaškrtnutím položky „***Run Immediately***“. [![week job.png](https://doc.eainfoport.cz/uploads/images/gallery/2022-09/scaled-1680-/week-job.png)](https://doc.eainfoport.cz/uploads/images/gallery/2022-09/week-job.png) Tento job má za úkol zasílat uživateli upozornění na email o změně na diagramu. Pokud nezjistí žádnou změnu na diagramu, tak nezasílá upozornění. Pokud zjistí změnu na diagramu, tak job pošle emailem upozornění na diagram s provedenou změnou. - - - - - - Uživatel může na diagramu vidět ikonku "*informačního* *panáčka*", která po najetí na ní informuje jaký typ upozornění je nastavený. [![diagram nastavení1.png](https://doc.eainfoport.cz/uploads/images/gallery/2022-09/scaled-1680-/diagram-nastaveni1.png)](https://doc.eainfoport.cz/uploads/images/gallery/2022-09/diagram-nastaveni1.png) Pro nastavení týdenního upozornění, musí uživatel kliknout na ikonku [![týden.png](https://doc.eainfoport.cz/uploads/images/gallery/2022-09/scaled-1680-/tyden.png)](https://doc.eainfoport.cz/uploads/images/gallery/2022-09/tyden.png) a až se ikonka změní je zasílání diagramu nastaveno. # Údržba Databáze # X Frame Správce portálu má nyní novou možnost v konfiguraci. Pokud chcete zapnout funkci XFrame musíte mít aktivní protocol Https a doporučujeme tuto funkci zapínat jen ve vnitřní síti. Funkce umožňuje vložit celý portál přes html iframe do jiných aplikací. # Konfigurace aplikace Kapitola obsahuje nastavení konfigurační aplikace a nastavení připojení k Infoportu. # Nastavení konfigurace aplikace V této kapitole jsou popsány pouze parametry, které jsou typicky editované při instalaci. Před spuštěním aplikace se ujistěte, že na portu 80 nekomunikuje žádná aplikace. Po spuštění aplikace se zobrazí Configuration Manager, který je potřeba vyplnit. [![1 infoport.png](https://doc.eainfoport.cz/uploads/images/gallery/2022-03/scaled-1680-/1-infoport.png)](https://doc.eainfoport.cz/uploads/images/gallery/2022-03/1-infoport.png) [![xT4ad.png](https://doc.eainfoport.cz/uploads/images/gallery/2022-05/scaled-1680-/xt4ad.png)](https://doc.eainfoport.cz/uploads/images/gallery/2022-05/xt4ad.png) [![3 Environment_0.png](https://doc.eainfoport.cz/uploads/images/gallery/2022-03/scaled-1680-/3-environment-0.png)](https://doc.eainfoport.cz/uploads/images/gallery/2022-03/3-environment-0.png) # Nastavení připojení k Infoportu V této sekci konfigurujeme přístup portálu do databáze s jeho metadaty (vytvořili jsme ji v kroku 3.4.8). Je potřeba mít připraveného databázového uživatele s oprávněními pro čtení / zápis / vytváření DB objektů. Pokud je použita databáze MSSQL se zapnutou integrated security, není potřeba vyplňovat UserId ani Password. Je však potřeba mít v databázi zavedeného uživatele, pod kterým je portál (a tedy i EA) spouštěn. InfoportConnection\_MySql": "Server=127.0.0.1;port=3306;Database=Data;Uid=Admin;Pwd=xxxxx;" - DBMS: Název parametru musí být stejný (InfoportConnection) sufix tohoto parametru se liší dle použité db: \_MySQL / \_SQLServer/ \_Oracle / apod. - Server: Název nebo IP adresa serveru. - Port: Port, na kterém DB naslouchá (nepovinný parametr). - Databáze: Název databáze, ve kterém jsou uložena metadata portálu. - Jméno: Jméno databázového uživatele. - Heslo: Heslo databázového uživatele. - Timeout: Doba, po kterou probíhá dotaz. Na velké databázi to může trvat i déle jak minutu, takže pro velké databáze nastavit minimálně na 90. ("Timeout": 90) - Maximum Dcom Instances: 2 – MaximumDcomInstances udává maximální počet DCOMů na každý jeden běžící EaInfoport server. Defaultní hodnota (pokud se nic neuvede je 2. Pokud si uživatel nepřeje ukončovat DCOMy, tak nechť nastaví hodně vysoké číslo (třeba 99). Pokud je překročeno maximum DCOMů, tak je server všechny ukončí (kill) a spustí si jeden čerstvý. Kontrola se dělá jak při startu, tak v pravidelných intervalech nastavených v Background / Seconds. - Pokud se ve správci úloh vypne DCOM, tak si ho EAInfoportT3 znova zapne během chvilky. [![1 infoport.png](https://doc.eainfoport.cz/uploads/images/gallery/2022-03/scaled-1680-/1-infoport.png)](https://doc.eainfoport.cz/uploads/images/gallery/2022-03/1-infoport.png) Vyplňte databázové schéma (**nejedná se o schéma repository Enterprise Architect, ale schéma pro metadata EAInfoportu**). Databázové schéma **musí být prázdné** a jen pro účely EAInfoportuT3. Po vyplnění příslušné záložky uživatel klikne na tlačítko „*Check*“, pokud se záložka rozsvítí červeně, je potřeba opravit případné chyby. Pokud se rozsvítí zeleně, byla záložka vyplněna správně. # Spuštění EaInfoportT3 V adresáři EAInfoportT3 spustíme soubor EaInfoportT3.exe. Po naběhnutí aplikace (může trvat několik minut) ověříme správný chod aplikace zadáním výše nastavené url do browseru. Běh více instancí portálu: běh více instancí portálu na jednom serveru nastavíme prostým zkopírováním složky EAInfoportT3, konfigurací každé složky dle tohoto postupu a spuštěním EaInfoportT3.exe. Prvotní přihlášení administrátorem - administrátor se poprvé přihlásí pomocí přihlašovacích údajů: Uživatelské jméno: admin Heslo: P@ssw0rd Po prvním přihlášení doporučujeme změnit heslo! # Vytvoření a editace repozitáře [![image-1665490592311.png](https://doc.eainfoport.cz/uploads/images/gallery/2022-10/scaled-1680-/image-1665490592311.png)](https://doc.eainfoport.cz/uploads/images/gallery/2022-10/image-1665490592311.png) - [Vzhled](https://doc.eainfoport.cz/books/instalacni-manual/page/vzhled) - [EA Shortcut](https://doc.eainfoport.cz/books/instalacni-manual/page/ea-shortcut) - [EA Databáze](https://doc.eainfoport.cz/books/instalacni-manual/page/ea-databaze) - [Příklady Connection Stringů](https://doc.eainfoport.cz/books/instalacni-manual/page/priklady-connection-stringu) # Vzhled ### Detail repozitáře Stačí vyplnit název, popis a zvolit barvu. (*Název je povinné pole*). [Počet diagramů k archivaci](https://doc.eainfoport.cz/books/uzivatelsky-manual/page/9-archivace-diagramu) [![Snímek obrazovky 2023-08-22 105736.png](https://doc.eainfoport.cz/uploads/images/gallery/2023-08/scaled-1680-/snimek-obrazovky-2023-08-22-105736.png)](https://doc.eainfoport.cz/uploads/images/gallery/2023-08/snimek-obrazovky-2023-08-22-105736.png) Tato konfigurace se projeví během přepínání mezi repozitáři nebo v seznamech repozitáří. [![Obrázek2.png](https://doc.eainfoport.cz/uploads/images/gallery/2022-04/scaled-1680-/obrazek2.png)](https://doc.eainfoport.cz/uploads/images/gallery/2022-04/obrazek2.png) # EA Shortcut ### EA Shortcut ***Pro vytvoření Shortcut je potřeba mít nainstalováný Enterprise Architect a být připojený do EA Repository.*** Pokud se nám povedlo se připojit do repozitáře a máme otevřený projekt, rozklikneme v levém horním rohu ikonku ***EA [![ea.png](https://doc.eainfoport.cz/uploads/images/gallery/2022-04/scaled-1680-/ea.png)](https://doc.eainfoport.cz/uploads/images/gallery/2022-04/ea.png)*** ***[![ea1.png](https://doc.eainfoport.cz/uploads/images/gallery/2022-04/scaled-1680-/ea1.png)](https://doc.eainfoport.cz/uploads/images/gallery/2022-04/ea1.png)*** Po kliknutí na ***Save as Shortcut***… vybereme cestu a klikneme na OK. (doporučujeme si uložit cestu do clipboard historie pomocí ctrl+c a soubor si předem otevřít, jestli Vás přesměruje do repozitáře). [![project.png](https://doc.eainfoport.cz/uploads/images/gallery/2022-04/scaled-1680-/project.png)](https://doc.eainfoport.cz/uploads/images/gallery/2022-04/project.png) Nyní v konfiguraci EA Shortcut vložíme cestu k EAP souboru a uživatele s heslem k repozitáři, jestli je zapnutá security. Tlačítko pro generování je nepovinné. [![shortcut.png](https://doc.eainfoport.cz/uploads/images/gallery/2022-04/scaled-1680-/shortcut.png)](https://doc.eainfoport.cz/uploads/images/gallery/2022-04/shortcut.png) (Pokud Vaše EA databáze je MySQL nebo PostgreSQL, tak využíváte ODBC pro připojení do EA. Můžete využít modře ohraničené tlačítko pro vygenerování connection stringu do Vaší databáze). # EA Databáze ### EA Databáze Zvolíme si typ databáze, v které máme připojený EAP pomocí EA a napíšeme její *connection string*. [![databáze_0.png](https://doc.eainfoport.cz/uploads/images/gallery/2022-04/scaled-1680-/databaze-0.png)](https://doc.eainfoport.cz/uploads/images/gallery/2022-04/databaze-0.png) Pokud máte vyplněné všechny údaje, můžete zvolit tlačítko "***Otestovat připojení***" a "***Uložit***". [![otestovat_0.png](https://doc.eainfoport.cz/uploads/images/gallery/2022-04/scaled-1680-/otestovat-0.png)](https://doc.eainfoport.cz/uploads/images/gallery/2022-04/otestovat-0.png) [![uložit.png](https://doc.eainfoport.cz/uploads/images/gallery/2022-04/scaled-1680-/ulozit.png)](https://doc.eainfoport.cz/uploads/images/gallery/2022-04/ulozit.png) - - - - - - Tlačítko "*Reset oprávnění Ea Infoport*" vynuluje veškeré nastavení oprávnění na balíčkách. [![image-1665490719429.png](https://doc.eainfoport.cz/uploads/images/gallery/2022-10/scaled-1680-/image-1665490719429.png)](https://doc.eainfoport.cz/uploads/images/gallery/2022-10/image-1665490719429.png) # Příklady Connection Stringů ### Příklady Connection Stringů **Oracle:** - DATA SOURCE=(DESCRIPTION=(ADDRESS\_LIST=(ADDRESS=(PROTOCOL=TCP)(HOST=localhost)(PORT=1536)))(CONNECT\_DATA=(SERVER=DEDICATED)(SERVICE\_NAME=dedicated)));User Id=myuser;Password=mypassword; **MS SQL:** - Server=127.0.0.1;Database=eainfoport;User id=myuser;Password=mypassword **MS SQL trusted connection:** V případě, že databáze má vůči doméně integrovanou security, tak použijte connection string níže: - Server=XXXXX;Database=YYYYY;Trusted\_Connection=True **MySQL:** - Server=127.0.0.1;port=3306;Database=eainfoport;Uid=myuser;Pwd=mypassword; **MariaDB:** - Server=127.0.0.1;port=3306;Database=eainfoport;Uid=myuser;Pwd=mypassword; [Další příklady](https://www.connectionstrings.com/) # Známé chyby při spuštění Při spuštění EaInfoportT3 mohou nastat následující chyby: - Ve verzi 8.2.0.30 je problém se spuštěním, pokud není nastavená nová funkčnost "Notifikační systém", tak Infoport padá na chybu. Od nového patche 8.2.1.2 je možné spustit Infoport bez potřeby nastavení. - Chyba s nedůvěryhodným zipem. [![známé chyby.png](https://doc.eainfoport.cz/uploads/images/gallery/2022-03/scaled-1680-/zname-chyby.png)](https://doc.eainfoport.cz/uploads/images/gallery/2022-03/zname-chyby.png) Pokud uživatel po spuštění **EaInfoportT3.exe** uvidí tuto chybu, ať už v logu nebo v konzoli, tak to znamená, že server považuje stažený EaInfoportT3\_Delivery.zip za nedůvěryhodný. Oprava se provede dle obrázku níže. [![známé chyby 1.png](https://doc.eainfoport.cz/uploads/images/gallery/2022-03/scaled-1680-/zname-chyby-1.png)](https://doc.eainfoport.cz/uploads/images/gallery/2022-03/zname-chyby-1.png) Uživatel klikne pravým tlačítkem myši na EaInfoportT3\_Delivery.zip a vyvolá vlastnosti. V záložce „General“ > Security poté klikne na tlačítko „*Unblock*“ a znova rozbalí příslušný .zip - chyba by měla být vyřešena. - Druhá chyba souvisí s jazykem EaInfoportT3 databáze – Musí být založena v jazyce utf8\_general\_ci. Pokud je založena ve špatném jazyce zobrazí se chyba obsahující takovéto znaky v konzoli: *Incorrect string value: '\\xC5\\x98\\xC3\\xA1de...'* - FIPSPolicy chyba. **Podoba chyby:** \[ERR\] An unhandled exception has occurred while executing the request. System.Reflection.TargetInvocationException: Exception has been thrown by the target of an invocation. ---> System.InvalidOperationException: This implementation is not part of the Windows Platform FIPS validated cryptographic algorithms. at System.Security.Cryptography.MD5CryptoServiceProvider..ctor() **Oprava:** Do EaInfoportT3.exe.config je třeba přidat následující řádky. <configuration> <runtime> <!-- below tag will disable security policy checking for FIPS --> <enforceFIPSPolicy enabled="false"/> </runtime> </configuration> # Nastavení viditelnosti artefaktů EaInfoportT3 má novou funkčnost, která umožnuje globálně vyfiltrovat stromeček na základě „property Scope“. Je možné určit viditelnost Atributů, Operací nebo Elementů. Správce repozitáře nalezne níže uvedené nastavení v sekci „Správa Repozitáře“ → „Detail Repozitáře“. Zde je nově přidaná sekce Filtry, ve které můžete nastavit viditelnost artefaktů ve stromečku repozitáře. [![DetailRepozitare.png](https://doc.eainfoport.cz/uploads/images/gallery/2023-02/scaled-1680-/detailrepozitare.png)](https://doc.eainfoport.cz/uploads/images/gallery/2023-02/detailrepozitare.png) [![filtry.png](https://doc.eainfoport.cz/uploads/images/gallery/2023-02/scaled-1680-/filtry.png)](https://doc.eainfoport.cz/uploads/images/gallery/2023-02/filtry.png)