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

V nižšie uvedenom texte je popis inštalácie a konfigurácie D2000 TCL

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:

Vytvoríme proces SELF.TTS (cesta "tcts")
Image Added
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.
Vytvoríme proces SELF.SES (cesta "event", parametre "--SES_LOCAL")
Image Added
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"
Vytvoríme proces SELF.TCD (cesta "tcldeployer")
Image Added
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.
Vytvoríme proces SELF.WSC (cesta "wssc", parametre "--TCL-WEBAPP=myApp")
Image Added
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ť.
Parametrom "--PORT.HTTP=<port>" môžme špecifikovať HTTP port servera. Východzie nastavenie je 8080, môžme špecifikovať port 80, ktorý je štandardne pre HTTP používaný na produkčných serveroch.

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. Na prevádzkovanie TCL je potrebné mať okrem samotného systému D2000 (verzie 9.2.34 alebo vyššej) ešte webový server, na ktorý sa budú pripájať klienti s internetovými prehliadačmi. Webový server môže byť akýkoľvek s podporou špecifikácie java servlet spec 23.40+. Funkčnosť TCL bola odskúšaná so servermi Apache Tomcat, JBoss Application Server a WildFly

...

Nainštalujte prostredie Java JRE (https://java.com), potrebné pre beh Tomcatu
Nainštalujte Apache Tomcat (http://tomcat.apache.org)
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.
Skopírujte súbory z D2000_EXE\tcl\war\ do adresára web aplikácie na web serveri (do ...\webapps\myApp\).
Spustite Tomcat

...

Konfigurácia užívateľov D2000

Spustite aplikáciu D2000
Vytvorte a spustite service "tcts.exe --WS<host>:<port>" a Watchdog (WD) na tento service pomocou utility scsconfig.exe
<host> je meno počítača (resp. IP adresa), kde beží WEB server,
<port> je číslo IP portu, na ktorom komunikuje tcts so servletom (default je 7120).
Image Removed
Vytvorte a spustite service na automatickú synchronizáciu bitových máp a zdrojov "tcldeployer.exe --WS<host>:<port>" a Watchdog (WD) na tento service.
Image Removed
Ak je žiadaná podpora ESL (aktívne schémy):
Vytvorte a spustite service "event.exe /WTCL_LOCAL --SES_LOCAL" a Watchdog (WD) na tento service.
Image Removed
Vytvorte a spustite service "event.exe /WTCL_REMOTE --SES_REMOTE" a Watchdog (WD) na tento servis, ak schémy v aplikácii využívajú remote ESL skripty.
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
Image Removed. Tiež nastavte zostavu resp. schému, ktorá sa užívateľovi po prihlásení zobrazí.
Image Added

Kotva
prevadzkovanie
prevadzkovanie
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 Apache Tomcat

inštalácii SELF.WSC používa port 8080.

myApp

web_app_name

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

aliasNázov aliasu z konfiguračného súboru (viď nižšie)
Ak sa zadáva alias, musí byť pred ním znak "?".urlparams

URL parametre (viď nižšie)

Ak sa zadávjú URL parametre, musí byť pred nimi znak "?".

************ TODO ***************

Nainštalovať Java JRE (https://java.com)
Nainštalovať Apache Tomcat (http://tomcat.apache.org)

Inštaláciu a konfiguráciu D2000 TCL je potrebné urobiť manuálne po inštalácii D2000.

...

Po nainštalovaní Apache Tomcat vytvorte adresár web aplikácie Tenkého klienta s ľubovoľným názvom v aplikačnom adresári web servera (webapps) (Tomcat je defaultne nainštalovaný v C:\Program Files\Apache Software Foundation\Tomcat X), takže adresár bude napríklad C:\Program Files\Apache Software Foundation\Tomcat X\webapps\myApp. Do tohto adresára nakopírujte obsah adresára D2000_EXE\tcl\war\.

Pozor: Je potrebné, aby používateľ D2000 mal v rámci svojich práv povolené prihlásenie do Tenkého klienta.

Nakopírovať súbory z D2000_EXE\tcl\war\ do adresára aplikácie vo web serveri.
Vytvoriť service "tcts.exe --WS<host>:<port>" a Watchdog (WD) na tento service.
<host> je meno počítača (resp. IP adresa), kde beží WEB server,
<port> je číslo IP portu, na ktorom komunikuje tcts so servletom (default je 7120).
Vytvorenie konfigurácie pomocou utility scsconfig.exe:
Image Removed
Naštartovať tcts service.
Vytvoriť service na automatickú synchronizáciu bitových máp "tcldeployer.exe --WS<host>:<port>" a Watchdog (WD) na tento service.
Image Removed
Naštartovať tcldeployer service.
Ak je žiadaná podpora ESL:
1. Vytvoriť service "event.exe /WTCL_LOCAL --SES_LOCAL" a Watchdog (WD) na tento service.
  Image Removed
  Naštartovať evhtcllocal service.
2. Vytvoriť service "event.exe /WTCL_REMOTE --SES_REMOTE" a Watchdog (WD) na tento servis, ale len v prípade, ak schémy v aplikácii využívajú remote ESL skripty.

(napríklad "myApp")
urlparams	URL parametre.

Parametre predávané v URL

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

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

Príklad URL s parametrami:

Žiadny formát
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

Konfigurácia aliasov

...

Meno aliasu môže byť ľubovoľné, ale musí začínať písmenom abecedy a obsahovať len znaky a..z, A..Z, 0..9 a "_". Meno nie je citlivé na veľké/malé písmená.

...

Konfigurácia jednotlivých aliasov je čítaná z adresára web aplikácie na web serveri zo súboru WEB-INF\/d2tcl_config.xml (pre SELF.WSC štandardne <adresár_D2000_aplikácie>/config/proc/self.wsc/base/webapps/myApp/WEB-INF/d2tcl_config.xml, pre Apache Tomcat C:\Program Files\Apache Software Foundation\Tomcat X\webapps\myApp\WEB-INF\d2tcl_config.xml). Konfiguračný súbor vo východzom stave neexistuje, pre použitie aliasov je potrebné ho vytvoriť

V konfiguračnom súbore je ďalej možné nastaviť TCP port na ktorom má počúvať TCL servlet (parameter "tctsconnector port=").

Príklad konfiguračného súboru d2tcl_config.xml:

...

Blok kódu

title	d2tcl_config.xml

<?xml version="1.0" encoding="UTF-8"?>
 <config>
   <tctsconnector port="7120"/>

   <alias name="*">
     <param>__d2tcl__UseCredentials=SystemD2000:SystemD2000</param>
   </alias>
   
   <alias name="">
     <param>><param>__d2tcl__FallbackOpen=S.Main</param>
   </alias>
   
   <alias name="s1">
     <param>__d2tcl__OverrideOpen=S.Section1</param>
   </alias>
	
   <alias name="admin">
     <param>__d2tcl__UseCredentials=<administrator</param>
     <param>!S.Admin</param>
   </alias>
 </config>

Spustite tcts (odsek Inštalácia tenkého klienta s Tomcat Serverom, bod 2).

Spustite tcldeployer (odsek Inštalácia tenkého klienta s Tomcat Serverom, bod 3).

Pre spustenie schémy, za ktorou je ESL skript, je potrebné spustiť SES (odsek Inštalácia tenkého klienta s Tomcat Serverom, bod 4).

Pozor: V prípade, že požadujete spustenie oboch procesov event.exe (jeden s parametrom --SES_LOCAL a druhý s parametrom --SES_REMOTE), druhý spúšťaný proces v poradí je potrebné odlíšiť s parametrom /W[nazov], napríklad event.exe /Wremote --SES_REMOTE

Schéma sa zobrazí v internetovom prehliadači zadaním adresy:

http://hostname[:port]/myApp/[?alias]

...

Ak sa pri prvom spustení Tenkého klienta daná schéma nezobrazí, skúste reštartovať webový server aj proces tcts.exe.

Príklad výslednej URL s aliasom: http://localhost/myApp/?s1

Príklad výslednej URL bez aliasu: http://localhost/myApp/?!S.Section1

URL s aliasom vykoná automatické prihlásenie, URL bez aliasu otvorí najskor login dialóg, potom obe URL otvoria rovnakú schému.

Upgrade TCL na novšiu verziu

...

Pred upgrade TCL na novšiu verziu je nutné vykonať tieto kroky:

Zastaviť Apache Tomcat proces (windows service).Dokončiť upgrade existujúcej inštancie D2000 V9.02webový server.
Vytvoriť zálohu adresára custom a zálohu všetkých manuálnych zmien v adresári web aplikácie (napr. vlastné úpravy CSS, úpravy login stránky, úpravy konfiguračných súborov WEB-INF/*.xml .a pod).
Urobiť upgrade systému D2000
Zmazať obsah adresára web aplikácie
a) Ak je TCL prevádzkovaný na externom web serveri (Tomcat, ...) - nakopírovať Nakopírovať súbory z D2000_EXE\tcl\war\ do adresára aplikácie vo web aplikácie
b) Ak je TCL prevádzkovaný na integrovanom D2000 web serveri .
Prepísať / obnoviť adresár custom zo zálohy.
Skontrolovať diff medzi zálohovanými súbormi WEB-INF/*.xml a novou inštaláciou, podľa potreby obnoviť súbory WEB-INF/*.xml zo zálohy alebo urobiť merge.
(proces .WSC) - spustiť proces WSC s parametrom "--TCL-WEBAPP=<meno_web_app>", čím dôjde k nakopírovaniu súborov
Skontrolovať rozdiely medzi zálohovanými súbormi (z bodu 2) a novou inštaláciou a zlúčiť rozdiely
Spustiť webový serverSpustiť Apache Tomcat proces (windows service).

Prevádzkovanie viacerých inštancií TCL na jednej inštancii

...

web servera

...

Je možné použiť jednu inštanciu Tomcat web servera na prevádzkovanie viacerých inštancií web časti TCL naraz. Nastavenie prvej inštancie TCL je štandardné a prebieha podľa návodu v predchádzajúcich kapitolách. Deployment každej ďalšej inštancie TCL si vyžaduje nasledovný postup:

...

Príklad konfigurácie:


  <servlet>
    <servlet-name>GWTTCLServiceImpl</servlet-name>
    <servlet-class>sk.ipesoft.d2wtc.servlet.D2WASServiceImpl</servlet-class>
    <init-param> 
     <param-name>d2000_servlet_log_dir</param-name>
     <param-value></param-value> 
    </init-param>
    <init-param> <param-name>d2port</param-name> <param-value>7121</param-value> </init-param>
   <load-on-startup>1</load-on-startup>
  </servlet>

...

V tomto prípade treba zabezpečiť, aby nedošlo ku konfliktu TCP/IP portov na ktorých prebieha komunikácia D2000 s TCL servletmi a nastaviť jedinečný port v súbore d2tcl_config.xml a príslušný port nastaviť aj pre procesy .TTS a .TCD parametrom "--WS<host>:<port>". V adresári web aplikácii webového servera nemôže byť viac TCL aplikácii s rovnakým portom, lebo to vedie k nefunkčnosti TCL.

Info

title	Súvisiace stránky:

D2000 Tenký klient
Pravidlá kreslenia

...

Strom stránky

Porovnávané verzie

Stará verzia 2

Nová verzia Aktuálny

Kľúč

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

Funkcionalitu D2000 TCL tvoria nasledovné časti:

Server:

Klient:

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

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

Konfigurácia užívateľov D2000

Kotva
prevadzkovanie
prevadzkovanie
Prevádzkovanie TCL

http://hostname[:port]/

web_app_name/[?alias|?urlparams]

Parametre predávané v URL

Konfigurácia aliasov

Upgrade TCL na novšiu verziu

Prevádzkovanie viacerých inštancií TCL na jednej inštancii

web servera

Strom stránky

História stránky

Porovnávané verzie

Stará verzia 2

Nová verzia Aktuálny

Kľúč

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

Funkcionalitu D2000 TCL tvoria nasledovné časti:

Server:

Klient:

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

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

Konfigurácia užívateľov D2000

KotvaprevadzkovanieprevadzkovaniePrevádzkovanie TCL

http://hostname[:port]/

web_app_name/[?alias|?urlparams]

Parametre predávané v URL

Konfigurácia aliasov

Upgrade TCL na novšiu verziu

Prevádzkovanie viacerých inštancií TCL na jednej inštancii

web servera

Kotva
prevadzkovanie
prevadzkovanie
Prevádzkovanie TCL