Inštalácia a upgrade SmartWeb platformy

Inštalácia Smart Web aplikácie na Tomcat v rámci D2000
Inštalácia Smart Web aplikácie na standalone Tomcat
Zmena kontextového adresára URL linky

SmartWeb platforma je implementovaná ako aplikácia pre aplikačný server Tomcat bežiaci na platforme Java. Tento aplikačný server je dodávaný aj v rámci inštalácie D2000 a beží na Jave dodávanej spolu s verziou D2000. V prvom kroku je teda potrebné rozhodnúť či chceme Smart Web inštalovať na Tomcat server dodávaný v rámci D2000 alebo na samostatne spravovaný Tomcat server nezávisle od D2000. Obe alternatívy majú svoje výhody a nevýhody, ktoré je možné zosumarizovať nasledovne:

Vlastnosť	Tomcat v rámci D2000	Samostatný Tomcat Server
jednoduchosť nasadenia	[OK] Tomcat nie je potrebné inštalovať a spravovať oddelene od D2000, pretože beží ako D2000 proces s príponou .WSC	[NO] Tomcat je potrebné inštalovať a spravovať nezávisle na D2000
flexibilita nasadenia v DMZ	[NO] nasadenie v DMZ nie je vhodné kvôli potrebe inštalovať a konfigurovať samostatnú inštanciu D2000	[OK] Ideálne pre samostatnú inštaláciu v DMZ
ad-hoc upgrade Tomcat Servera	[NO] upgrade Tomcatu je zviazaný s D2000	[OK] Tomcat je možné upgradovať ad-hoc nezávisle na D2000

Nasledujúce kapitoly rozoberajú obe možnosti inštalácie.

Inštalácia Smart Web aplikácie na Tomcat v rámci D2000

Postup inštalácie je nasledovný:

Nakonfigurovať a spustiť proces SELF.WSC nasledovne:
1. prekopírovať adresár D2000_EXE/templates/config/proc/_.wsc do D2000_APP/<názov aplikácie>/config/proc/
2. a následne premenovať _.wsc na self.wsc
3. vytvoriť proces SELF.WSC s parametrom /X2
Nakopírovať súbor D2000_EXE/web/smartweb.war do adresára D2000_APP/<názov aplikácie>/config/proc/self.wsc/base/webapps/
Rozbaliť súbor D2000_EXE/web/tutorial-application.zip do adresára D2000_APP/<názov aplikácie>/config/proc/self.wsc
Spustiť proces Konfigurácia procesu D2Connector pre SmartWeb
Spustiť proces SELF.WCS
Otvoriť tutorial aplikáciu v prehliadači na adrese http://localhost:8080/smartweb

Inštalácia Smart Web aplikácie na standalone Tomcat

Postup inštalácie je nasledovný:

Stiahnuť a nainštalovať AdoptOpenJDK verzie 11
Stiahnuť a nainštalovať NodeJS
Nainštalovať Yarn (npm install --global yarn)
Nastaviť systémovú environment premennú JAVA_HOME na root adresár kde bola JDK nainštalované.
Stiahnuť a nainštalovať Tomcat verzie 10 podla štandardneho postupu
Nakopírovať súbor D2000_EXE/web/smartweb.war do webapps adresára Tomcatu
Rozbaliť súbor D2000_EXE/web/tutorial-application.zip (Tomcat musí mať práva na čítanie z priečinku, napr. uložiť na D:/)
Spustiť proces Konfigurácia procesu D2Connector pre SmartWeb
Vypnúť SELF.WSC (používa port 8080 ako aj Tomcat v defaultnom nastavení)
Spustiť Tomcat server
Nainštalovať balíčky pre demo aplikáciu (yarn install - spustiť v root adresári dema)
Vykompilovať release verziu aplikácie pomocou príkazu yarn build
Spustiť demo aplikáciu v dev režime (yarn start)
Nastaviť cestu v konfiguračnom súbore Tomcat aplikácie k dist_dev a dev adresáru demo aplikácie (napr.: C:\Program Files\Apache Software Foundation\Tomcat 10.1\conf\applications\smartweb\smartweb.json)
Reštartovať Tomcat
Otvoriť tutorial aplikáciu v prehliadači na adrese http://localhost:8080/smartweb

Príklad konfiguračného súboru tomcat aplikácie

// pripojenie k D2000 aplikácii
"connections": [
    {
      "host": "localhost",
      "port": "3120"
    }
  ],
// cesta k výstupu aplikácie
"webResourceDirectories": [
      {
        // dev vystup
        "directoryPath": "c:\\tutorial-application\\dist_dev\\",
        "contextRoot": "/dev"
      },
      {
        // release vystup
        "directoryPath": "c:\\tutorial-application\\dist\\"
      }, 
  ]

Zmena kontextového adresára URL linky

Pre zmenu kontextového adresára URL linky z http://localhost:8080/smartweb na napr. http://localhost:8080/myApp je potrebné spraviť nasledovné:

Zastaviť Tomcat server.
Premenovať súbor /webapps/smartweb.war
Spustiť Tomcat server.