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

V nižšie uvedenom texte je popis inštalácie a konfigurácie D2000 TCL pre verziu D2000 V9.02.

Závislosti inštalácie D2000 TCL

Pred samotnou inštaláciou D2000 TCL, je nutné vykonať tieto kroky:

1. Nainštalovať D2000 V9.02.
2. Vytvoriť požadovanú aplikáciu D2000.
3. Vytvoriť používateľa D2000, ktorý má v rámci svojich práv povolené prihlásenie do tenkého klienta (TCL).
   
4. Nainštalovať najnovšiu verziu Java JRE, verzia Java SE JRE 7x dostupná na http://java.sun.com.
5. Nainštalovať najnovšiu verziu Apache Tomcat, verzia 7.x dostupná na http://tomcat.apache.org/.

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

Inštalácia tenkého klienta s Tomcat Serverom

Po nainštalovaní Apache Tomcat vytvorte adresár aplikácie Tenkého klienta s ľubovoľným názvom v hlavnom adresári web servera (web server je defaultne nainštalovaný v C:\Program Files\Apache Software Foundation\Tomcat X) v priečinku webapps, napríklad 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.

1. Nakopírovať súbory z D2000_EXE\tcl\war\ do adresára aplikácie vo web serveri.
2. Vytvoriť service "tcts.exe --WS<host>:<port>" a Watchdog (WD) na tento service.
   <host>:<port> 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:
   
   Naštartovať tcts service.
3. Vytvoriť service na automatickú synchronizáciu bitových máp "tcldeployer.exe --WS<host>:<port>" a Watchdog (WD) na tento service.
   
   Naštartovať tcldeployer service.
4. Ak je žiadaná podpora ESL:
   1. Vytvoriť service "event.exe /WTCL_LOCAL --SES_LOCAL" a Watchdog (WD) na tento service.
      
      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.

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.

__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:

Konfigurácia aliasov

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 uložená v adresári web aplikácie na web serveri v súbore WEB-INF\ d2tcl_config.xml (štandardne C:\Program Files\Apache Software Foundation\Tomcat X\webapps\myApp\WEB-INF\ d2tcl_config.xml). 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:

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:

1. Zastaviť Apache Tomcat proces (windows service).
2. Dokončiť upgrade existujúcej inštancie D2000 V9.02.
3. Vytvoriť zálohu adresára custom a zálohu súborov WEB-INF/*.xml.
4. Nakopírovať súbory z D2000_EXE\tcl\war\ do adresára aplikácie vo web serveri.
5. Prepísať / obnoviť adresár custom zo zálohy.
6. 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.
7. Spustiť Apache Tomcat proces (windows service).

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

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:

1. Zastavenie Tomcat servera.
2. Nakopírovať súbory z D2000_EXE\tcl\war\ do adresára aplikácie vo web serveri (meno adresára musí byť vyhradené pre túto inštanciu TCL, napríklad webapps\mojaNovaApp
3. Vytvoriť service "tcts.exe --WStomcatHost:port" a Watchdog (WD) na tento service.
   tomcatHost je meno servera, na ktorom beží inštancia tomcat-u,
   port je nevyužité číslo komunikačného portu medzi tcts a D2WTC, napríklad 7121, 7122, 7123, ..
   Prvá inštancia TCL využíva port 7120, ak nie je špecifikované inak.
4. Vytvoriť service na automatickú synchronizáciu bitových máp tcldeployer.exe --WStomcatHost:port a Watchdog (WD) na tento service, kde číslo portu zostáva rovnaké ako v predchádzajúcom bode.
5. Konfigurácia portu nasadenej aplikácie na aplikačnom serveri je servlet-init parametrov. V tomto prípade je číslo komunikačného portu D2000 zadané ako init parameter pre servlety GWTTCLServiceImpl a GWTTCLServiceImpl2 v súboroch WEB-INF/web*.xml.
   

   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>
   

6. Vytvoriť service event.exe podľa potreby a popisu v predchádzajúcom odseku.
7. Nová inštancia TCL bude dostupná na URL:
   http://hostname[:port]/mojaNovaApp/[?alias]