/
Inštalácia a prevádzkovanie

Inštalácia a prevádzkovanie

D2000 Tenký klient (TCL) - inštalácia a prevádzkovanie

Funkcionalitu D2000 TCL tvoria nasledovné časti:

Server:

  • Systémový D2000 proces .TTS - zabezpečuje runtime prostredie behu a online konverziu D2000 schém do prostredia TCL

  • Systémový D2000 proces .SES - interpretuje aplikačné ESL skripty pre schémy zobrazené v TCL

  • Systémový D2000 proces .TCD - slúži na synchronizáciu obrázkov a zdrojov medzi aplikačným serverom D2000 a webovým serverom

  • Systémový D2000 proces .WSC - slúži ako webový server/servlet kontajner

  • D2000 TCL servlet bežiaci v kontajneri webového servera.

Klient:

  • Internetový prehliadač (Chrome, MS Edge, Firefox, ...) - zobrazuje D2000 obrazovky/schémy

Postup na sprevádzkovanie TCL s použitím integrovaného systémového D2000 web servera:

  1. Vytvoríme proces SELF.TTS (cesta "tcts")


    Ak web server s TCL servletom beží na inom počítači, pomocou parametra "--WS<host>:<port>" špecifikujeme adresu a port D2000 komunikačného rozhrania sa TCL servlet. Port rozhrania je štandardne 7120.

  2. Vytvoríme proces SELF.SES (cesta "event", parametre "--SES_LOCAL")


    Ak prevázkujeme aj schémy so vzdialenými ESL skriptami, je potrebné vytvoriť proces SELF_REMOTE.SES s cestou "event" a s parametrom "–SES_REMOTE"

  3. Vytvoríme proces SELF.TCD (cesta "tcldeployer")


    Ak web server s TCL servletom beží na inom počítači, pomocou parametra "--WS<host>:<port>" špecifikujeme adresu a port komunikačného rozhrania sa TCL servlet. Port rozhrania je štandardne 7120.
    Poznámka: jeden web server dokáže obslúžiť iba jeden TCD proces. Preto v redundantných systémoch nemôže mať SELF.TCL autoštart, ale musí byť spúšťaný napr. na web serveri a pripájať sa k aktívnemu D2000 Serveru (štartovací parameter /RD alebo /RF).

  4. Vytvoríme proces SELF.WSC (cesta "wssc", parametre "--TCL-WEBAPP=myApp")


    Parameter "--TCL-WEBAPP=<meno_web_app>" zabezpečí, že pri štarte SELF.WSC sa nakopíruje TCL servlet spolu s potrebnými súbormi z inštalačného adresára D2000 do adresára webovej aplikácie <meno_web_app>. štandardne <adresár_D2000_aplikácie>/config/proc/self.wsc/base/webapps/<meno_web_app>. Zároveň <meno_web_app> tvorí cestu v URL pre prístup z internetového prehliadača (viď nižšie). Po prvotnom spustení SELF.WSC dôjde k nakopírovaniu a neskôr môžeme tento parameter odstrániť.
    Konfigurácia web servera je uložená v súbore <adresár_D2000_aplikácie>/config/proc/self.wsc/base/conf/server.xml. V tomto súbore môžme napr. špecifikovať HTTP port servera (element `<Connector port=`). Východzie nastavenie portu je 8080, nastavenie je možné zmeniť na port 80, ktorý je štandard pre HTTP.

Po naštartovaní uvedených procesov je serverová časť TCL pripravená obsluhovať klientov.

Ako alternatívu pre produkčné nasadenie je možné použiť namiesto D2000 procesu WSC štandardný webový server.  Webový server môže byť akýkoľvek s podporou špecifikácie java servlet spec 3.0+. Funkčnosť TCL bola odskúšaná so servermi Apache Tomcat, JBoss Application Server a WildFly

Inštalácia, konfigurácia a prevádzkovanie TCL na webserveri Apache Tomcat

Inštalácia

  1. Nainštalujte prostredie Java JRE (https://java.com), potrebné pre beh Tomcatu

  2. Nainštalujte Apache Tomcat (http://tomcat.apache.org)

  3. Vytvorte adresár web aplikácie TCL s ľubovoľným názvom (napr. myApp) v aplikačnom adresári web servera (Tomcat je defaultne nainštalovaný v C:\Program Files\Apache Software Foundation\Tomcat X), takže adresár bude C:\Program Files\Apache Software Foundation\Tomcat X\webapps\myApp.

  4. Skopírujte súbory z D2000_EXE\web\tcl\war\ (Tomcat 9-) resp. D2000_EXE\web\tcl-jakarta\war\ (Tomcat 10+) do adresára web aplikácie na web serveri (do ...\webapps\myApp\).

  5. Spustite Tomcat

Konfigurácia užívateľov D2000


  1. Vo východzom nastavení nemajú užívatelia D2000 právo prihlásiť sa cez TCL. V nástroji CNF povoľte jednotlivým užívateľom D2000 prihlásenie do TCL. Tiež nastavte zostavu resp. schému, ktorá sa užívateľovi po prihlásení zobrazí.

Prevádzkovanie TCL

Schémy D2000 sú dostupné v internetovom prehliadači po zadaní adresy v tvare

http://hostname[:port]/web_app_name/[?alias|?urlparams]

hostname

IP adresa alebo názov počítača, na ktorom beží proces SELF.WSC resp. Apache Tomcat. (napríklad "127.0.0.1")

port

Číslo portu pre pripojenie cez HTTP(S) k SELF.WSC resp. Apache Tomcat. Ak je port = 80, nemusí sa zadávať, vo východzom nastavení po inštalácii SELF.WSC používa port 8080.

web_app_name

Názov adresára v hlavnom adresári Apache Tomcatu (adresár web aplikácie tenkého klienta). (napríklad "myApp")

urlparams

URL parametre. Pomocou parametrov v URL je možné špecifikovať správanie TCL. Je možné nastaviť tieto parametre:

__d2tcl__OverrideOpen=meno_schémy:číslo_inštancie
parameter určuje, že po úspešnom prihlásení používateľa sa otvorí schéma meno_schémy v inštancii číslo_inštancie. Číslo inštancie je nepovinné, v takom prípade sa schéma otvorí v základnej (nulovej) inštancii. Zadaná schéma sa otvorí vždy bez ohľadu na nastavenie východzej schémy/zostavy v parametroch používateľa D2000. Parameter je možné zapísať aj v skrátenom tvare !meno_schémy, napr. http://localhost:8080/myApp/?!S.Main

__d2tcl__FallbackOpen=meno_schémy:číslo_inštancie
daná schéma sa otvorí iba ak používateľ nemá žiadnu schému/zostavu nastavenú ako východziu v parametroch používateľa. Ak má nastavenú východziu, tento parameter je ignorovaný.

__d2tcl__UseCredentials=meno:heslo
parameter umožňuje automaticky prihlásiť užívateľa daným menom a heslom bez toho, aby sa mu zobrazil prihlasovací dialóg. V prípade, že v hodnote parametra je zadané len meno (bez dvojbodky), prihlasovací dialóg sa zobrazí s predvyplneným menom.

__d2tcl__NickName=nickname
parameter umožňuje pomenovať D2000 proces .SEE, ktorý vznikne pripojením klienta a slúži na interpretáciu ESL skriptov zobrazovaných schém. To je možné využiť pri ladení skriptu ESL, keď treba špecifikovať, na ktorom procese .SEE má ladenie prebiehať.

__d2tcl__AuthMethod=metódy
parameter umožňuje špecifikovať metódu autentifikácie. Prípustné metódy sú:

  • d2000 - overovanie užívateľa menom a heslom

  • spnego - overenie podľa aktualne prihláseného užívateľa v operačnom systéme, bez zadávania mena/hesla

Je možné zadať obe metódy, oddelené čiarkou. V takomto prípade sa vykoná 'spnego' autentifikácia ako prvá. Ak zlyhá, použije sa metóda 'd2000'.

Ak parameter nie je uvedený, východzia hodnota je 'd2000'

Vlastnosť je dostupná od D2000 release R067

Parametre v URL sa zapisujú za znak '?' a oddeľujú sa znakom '&'.

Príklad URL s parametrami:

http://localhost:8080/myApp/?__d2tcl__OverrideOpen=S.Main&__d2tcl__UseCredentials=SystemD2000:SystemD2000&__d2tcl__NickName=debugsession1

alias

Pre zjednodušenie zápisu URL parametrov je možné nakonfigurovať tzv. aliasy. Alias je pomenovaná množina URL parametrov, ktorej meno je špecifikované v URL ako text za znakom '?', napr.
http://hostname[:port]/myApp/?alias