Musím se přiznat, že jsem se minulý týden poněkud zapotil, když jsem pomáhal zákazníkovi instalovat licenční server pro plovoucí licence Sparx EA a (Pro) Cloud Server. Tep mi zvyšovalo to, že už jsem to dělal mnohokrát a přesto stále něco nefungovalo podle návodu. Proto jsem oprášil své instalační postupy a sdílím je veřejně.

Popis je zohledněn k verzi EA 17.1, která je v době psaní článku aktuální. V dřívějších verzi to bylo (mohlo být) jinak. V novějších, pokud již vyšla, to bude… Nějak.

Nejprve pojmy a vysvětlení

Licence pro Sparx Enterprise Architect (EA) si můžete zakoupit dvojího typu:

• standardní (standard) a
• plovoucí (floating).

Standardní licence znamená, že ji přiřadíte jedné instalaci EA na konkrétním počítači. V takovém případě nepotřebujete licenční server. Repositáře pak můžete mít lokální (a pak EA nepotřebuje žádný přístup do sítě) nebo vzdálené (přímé připojení pomocí databázového ovladače nebo pomoci Cloud Serveru). Pro vzdálené připojení je třeba mít edici alespoň Corporate a doporučuji používat (Pro) Cloud Serveru (viz dále).

Plovoucí licence znamená, že jedna a táž licence si může plavat mezi desítkami různých instalací EA na různých počítačích, ovšem ne v jednu a tutéž dobu. Hodí se ve chvíli, kdy víte, že sice máte např. 15 uživatelů, kteří s EA pracují, nicméně také víte, že v jednu chvíli jich nepracuje více než např. 7. Pak stačí koupit 7 plovoucích licencí, čímž ve finále ušetříte.

Standardní licenci si typicky pořizují OSVČ, kteří ji používají pro vlastní repositáře. Plovoucí licence si pak typicky pořizují větší organizace. Neznamená to však, že by si OSVČ nemohla zakoupit plovoucí licence a organizace standardní.

Licenční server

Abyste mohli používat plovoucí licence, kromě EA na uživatelských počítačích potřebuje mít licenční server. Technicky jde o službu Windows, která běží na nějakém počítači v síti, ke kterému mají uživatelé EA přístup. Plovoucí licence pak zadáte na tomto licenčním serveru. Uživatelům EA dáte informace o tomto serveru a po jednorázovém nastavení v EA mohou uživatelé pracovat s EA (pokud při spuštění EA je k dispozici volná licence).

K licenčnímu serveru se při správě klíčů a administraci jejich přidělování přistupuje pomocí aplikace Floating License Config Client.

(Pro) Cloud Server

Cloud Server umožňuje přistupovat z EA ke vzdáleným repositářům pomocí protokolu https namísto databázových ovladačů (např. přes ODBC). To má několik výhod:

• Nemusíte na každém uživatelském počítači spravovat a konfigurovat ODBC ovladače, ale děláte to reálně pouze na stroji, kde běží (Pro) Cloud Server.
• Nemusíte každému uživateli zpřístupňovat přímé napojení do databáze (což může být bezpečnostní riziko).
• Uživatelé EA mají mnohem méně možností, jak něco pokazit.
• Lépe se to celé administruje.

Pro Cloud Server umožňuje to samé co Cloud Server, a navíc má další schopnosti, které můžete využít (různé konektory, WebEA apod.). Tím se tady ale zabývat nebudeme.

Technicky se jedná o službu Windows shodou okolností úplně tu samou (ve smyslu to, co ve Windows spouštíte) jako v případě licenčního serveru. Jinými slovy: Licenční server, Cloud Server a Pro Cloud Server jsou marketingově tři různé věci, technicky je to jedna služba běžící ve Windows a naslouchající na různých portech. K této službě se v případě administrace přistupuje dvě různými aplikacemi poskytovanými Sparx Systems.

Instalace

Pokud potřebujete instalovat licenční server a/nebo (Pro) Cloud server, je potřeba provést následující kroky:

1. Stáhněte si jeden jediný instalační soubor ze stránek Sparx Systems. Stahujte Sparx Systems Pro Cloud Server (ssprocloudserver_x64.msi). Sparx nabízí ještě Sparx Systems Cloud Service a Keystore Service, to ignorujte, používalo se to do března 2020.
   
2. Spusťte instalaci na počítači, kde budete služby licenčního serveru a/nebo (Pro) Cloud serveru provozovat.
3. Po úspěšné instalaci:
   • se na ploše objeví dvě ikony:
     
     • 1. Aplikace Pro Cloud Config Client
     • 2. Aplikace Floating License Config Client
   • a spustí se služba operačního systému nazvaná Sparx Systems Professional Cloud.

Základní konfigurace licenčního serveru

1. V adresáři s instalací (ve výchozím stavu „c:\Program Files\Sparx Systems\Pro Cloud Server\Service“) je potřeba mít certifikát v souboru server.pem (tedy privátní i veřejnou část klíče).
   1. Pokud jej nemáte, vytvořte jej např. pomocí openssl (pokud to máte ve vlastní síti bez přístupu „z venku“, případně si můžete vygenerovat Let’s Encrypt certifikát pro počítač na doméně). Přesný popis je nad rámec tohoto článku.
   2. Restartujte službu Sparx Systems Professional Cloud.
2. Spusťte Floating License Config Client.
3. Připojte se k serveru na Floating Licence Server (pokud vás k tomu k tomu aplikace nevyzve, najdete v menu File položku Link To…):
   
   • Protocol: https://
   • Server adress: localhost
   • Port: 1805
   • Username: admin
   • Password: password
4. Pokud se nejde přihlásit, zkontrolujte v logách (lozích), že je vše v pořádku (např. že se správně načetl certifikát a služba poslouchá na odpovídajícím portu).
   • Logy jsou v adresáři (pokud jste jej při instalaci nezměnili):
     "c:\Program Files\Sparx Systems\Pro Cloud Server\Service\Logs"
   • Kontrola naslouchání na portu (zde jako příklad port 1803):
     netstat -ano | findstr :1803
5. Nyní je možné konfigurovat plovoucí klíče (menu Key, položka Add…).
6. Podrobnější konfigurace je pak schovaná pod tlačítkem Manage Group Configuration (v tlačítkové liště předposlední, na obrázku zvýrazněno červeně). Tam si můžete změnit i výchozí heslo pro admina.

Poznámka: Nevolte Keystore Location či možnost Create. Přeci jenom už končíme třetí dekádu 21. století.

Získání licenčního klíče ve Sparx EA

1. Pokud vás EA sám nevyzve k zadání klíče, vyvolejte dialog pro jeho zadání z pásu karet (ribbonu) Start, ke konci je tlačítko Help a tam zvolte Register and Manage Your Licence Key(s).
2. Objeví se dialog Licence Management.
   
3. Zvolte tlačítko Add Key.
4. Objeví se dialog Add Registration Key.
   
5. V levé části zvolte Get Shared Key.
6. Zadejte libovolný název a organizaci (lze nechat i prázdné).
7. Zvolte tlačítko Browse.
8. Objeví se dialog Shared Keystore Selection.
   
9. Zvolte Sparx Keystore Server.
10. Zadejte:
    1. Protokol: https://
    2. Server Address: Adresu vašeho počítače, kde běží licenční server.
    3. Port: 1805
    4. Username: default
    5. Password: password
11. Zkuste tlačítko Test, zda to projde. Pokud ano, potvrďte tlačítkem OK, jinak hledejte problém (vidíte na server? (příkaz ping), máte správně certifikát? (mrkněte do logu na serveru), máte správně username a heslo? nezměnili jste náhodou port v konfiguraci licenčního serveru?).
12. V dialogu Add Registration Key je seznam dostupných edic (např. EA Corporate Edition). Vybert tu, co potřebujete.
    
13. Zvolte OK.
14. V okně Licence Management uvidíte svou (propůjčenou) licenci.
    
15. Zvolte Close.

Poznámka: username a password se konfiguruje ve Floating License Config Client ve správě skupin (viz předchozí část tohoto textu).

Poznámka: Stávalo se mi, že při prvních zadání mi EA hlásilo nesmyslnou chybu, kterou se mi nepodařilo rozklíčovat. Pomohl až několikerý restart serveru (nejen licenčního, ale celého počítače).

Základní instalace (Pro) Cloud Serveru

Předpoklad: Máte připravenou databázi s tabulkami, která bude fungovat jako váš repositář (skripty pro vytvoření zde). Z počítače, kde běží (Pro) Cloud Server samozřejmě musíte mít k databázi přístup.

1. Spusťte Pro Cloud Config Client.
2. Zadejte localhost:1803 a defaultní heslo. Podle dokumentace to je (to co je v uvozovkách) „pcsadm1n“.
3. Pokud nefunguje defaultní heslo (pro tento krok musíte typicky pracovat jako lokální administrátor):
   1. V konfiguračním souboru „c:\Program Files\Sparx Systems\Pro Cloud Server\Service\SSProCloud.config“ najděte řádek začínající SERVER_PASSWORD=
   2. V tomto řádku odmažte vše, co je za rovnítkem. Jinými slovy heslo bude prázdné.
   3. Restartuje službu „Sparx Systems Professional Cloud“.
   4. Přihlaste se bez zadání hesla.
   5. V prostředí zvolte tlačítko Extended properties… a tam vlevo dole zadejte nové heslo.
4. Zadejte přístup k databázi podle klasického postupu přes tlačítko Add (obecně je doporučeno používat nativní přístup).
   
5. Pozor, po přidání je ještě třeba připojení povolit.
   

Závěr

Vše by mělo být nastaveno, zbývá se pouze připojit z EA (Cloud Connection). Pokud budete přesto i nadále bojovat, nebojte se mě kontaktovat. Budu-li moct, poradím.