V nižšie uvedenom texte je popis inštalácie a konfigurácie D2000 TCL
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 java servlet spec 2.4+. Funkčnosť TCL bola odskúšaná so servermi Apache Tomcat, JBoss Application Server a WildFly
"tcts.exe --WS<host>:<port>"
a Watchdog (WD) na tento service pomocou utility scsconfig.exe"tcldeployer.exe --WS<host>:<port>"
a Watchdog (WD) na tento service. "event.exe /WTCL_LOCAL --SES_LOCAL"
a Watchdog (WD) na tento service."event.exe /WTCL_REMOTE --SES_REMOTE"
a Watchdog (WD) na tento servis, ak schémy v aplikácii využívajú remote ESL skripty.http://hostname[:port]/myApp/[?alias|urlparams]
hostname | IP adresa alebo názov počítača, na ktorom beží Apache Tomcat. |
port | Číslo portu pre pripojenie cez HTTP(S) k Apache Tomcat. Ak je port = 80, nemusí sa zadávať, vo východzom nastavení po inštalácii Apache Tomcat používa port 8080. |
myApp | Názov adresára v hlavnom adresári Apache Tomcatu (adresár aplikácie tenkého klienta). |
alias | Ná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 ***************
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.
"tcts.exe --WS<host>:<port>"
a Watchdog (WD) na tento service."tcldeployer.exe --WS<host>:<port>"
a Watchdog (WD) na tento service. "event.exe /WTCL_LOCAL --SES_LOCAL"
a Watchdog (WD) na tento 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.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.
__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á, otvorí sa východzia v základnej inštancii.
__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ť.
Parametre v URL sa zapisujú za znak '?' a oddeľujú sa znakom '&'.
Príklad URL s parametrami:
http://hostname[:port]/myApp/?
__d2tcl__OverrideOpen=S.Main&__d2tcl__UseCredentials=SystemD2000:SystemD2000&__d2tcl__NickName=debugsession1
Pre zjednodušenie zápisu URL je možné nakonfigurovať tzv. aliasy. Alias je pomenovaná množina parametrov, ktorej meno je špecifikované v URL ako parameter za znakom '?', napr.
http://hostname[:port]/myApp/?alias
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á.
Ak v URL nie je alias špecifikovaný, bude použitý alias s prázdnym menom (ak je taký definovaný).
Naviac je možné definovať tzv. vzorový alias - s menom "*". Parametre tohto vzorového aliasu sa použijú ako východzie.
Konfigurácia jednotlivých aliasov je čítaná z adresára web aplikácie na web serveri zo súboru WEB-INF\d2tcl_config.xml (štandardne 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ť.
Príklad konfiguračného súboru d2tcl_config.xml:
<?xml version="1.0" encoding="UTF-8"?> <config> <alias name="*"> <param>__d2tcl__UseCredentials=SystemD2000:SystemD2000</param> </alias> <alias name=""> <param>>__d2tcl__FallbackOpen=S.Main</param> </alias> <alias name="s1"> <param>__d2tcl__OverrideOpen=S.Section1</param> </alias> <alias name="admin"> <param>__d2tcl__UseCredentials=</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]
hostname | IP adresa alebo názov počítača, na ktorom beží Apache Tomcat. |
port | Číslo portu pre pripojenie cez HTTP(S) k Apache Tomcat. Ak je port = 80, nemusí sa zadávať, vo východzom nastavení po inštalácii Apache Tomcat používa port 8080. |
myApp | Názov adresára v hlavnom adresári Apache Tomcatu (adresár aplikácie tenkého klienta). |
alias | Názov aliasu z konfiguračného súboru. Ak sa zadáva alias, musí byť pred ním znak "?". |
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.
Pred upgrade TCL na novšiu verziu je nutné vykonať tieto kroky:
Je možné použiť jednu inštanciu Tomcat 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>
http://hostname[:port]/mojaNovaApp/[?alias]