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 3.0+. 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.Schémy D2000 sú dostupné v internetovom prehliadači po zadaní adresy v tvare
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). | ||
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 __d2tcl__FallbackOpen=meno_schémy:číslo_inštancie __d2tcl__UseCredentials=meno:heslo __d2tcl__NickName=nickname __d2tcl__AuthMethod=metódy
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
Príklad URL s parametrami:
| ||
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 |
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).
V konfiguračnom súbore je ďalej možné nastaviť TCP port na ktorom má počúvať tctsconnector
.
Príklad konfiguračného súboru 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>__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> |
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:
tctsconnector
, viď vyššie.http://hostname[:port]/myOtherApp/[?alias]