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ů:

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.


Instalace programu Enterprise Architect

  1. 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. 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
  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
  6. Na další záložce spustíme samotnou instalaci MySQL
    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
    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

DBMS Based Repositories For Enterprise Architect | Sparx Systems

Instalace a konfigurace ODBC driverů

Po instalaci databáze MySQL (podle jedné z předchozích kapitol) je jednou z možností konfigurace ODBC.

Další možnosti viz Připojení na databázi EA repozitory „Native Connection“.

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


Konfigurace ODBC pro MySQL

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ý).

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.

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

Nastavení optimálního zoomu

Kvalita zobrazení diagramů v EaInfoportu je závislá na nastavení speciálního Scale parametru v Enterprise Architectu.

zoom.png

Nastavení rozměru elementu na diagramu

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

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
  2. 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 "* * * * *"
  2. Source ftp | file
  3. Version "* * * *"
  4. Port 00000
  5. Start automatic | manual
  6. Stop automatic | manual
  7. Clear automatic | manual
  8. Prereq force | check
  9. 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:

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:

Nejlépe opět uvedeme příklady pro pochopení vhodného nastavení.

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 musí mít přiřazeného uživatele s právy vlastníka (owner) a collation, která bude "case insensitive" (značí se pomocí CI v názvu collation) a Accent-insensitive (značí se pomocí AI v názvu collation).

Např. 

Mssql: Czech_CI_AI

MySQL (MariaDB): utf8mb4_0900_ai_ci

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:

Připojení na databázi EA repozitory „Native Connection“

Spustíme program Enterprise Architect > Manage Projects > Connect to Server a přes šipku zvolíme „Native Connection“.

Po vyplnění podstatných údajů klikneme na tlačítko Test a pokud test proběhne v pořádku, potvrdíme OK.

image-1742290991544.png


image-1742291022798.png

Dalším krokem je vytvoření "Shortcut".

image-1742291082110.png

V levém horním rohu klikneme na logo Enterprise Architect a zvolíme „Save as Shortcut“.

Soubor uložíme do PC a zkopírujeme cestu, kterou bude následně nutné zadat při konfiguraci Infoportu.