SmartWeb platforma je implementovaná ako aplikácia pre Java EE aplikačný server Tomcat bežiaci na platforme Java. Tento aplikačný server je dodávaný v rámci 

Inštalácia na Windows OS

Inštalácia JRE 1.8

SmartWeb platforma je implementovaná ako aplikácia pre Java EE aplikačný server Tomcat a preto potrebuje na svoj beh aj nainštalované a nakonfigurované Java Runtime Environment verzie 8.

Postup inštalácie je nasledovný:

1. Stiahnuť a nainštalovať najnovšie JRE 1.8 z oracle.com.
2. Nastaviť systémovú environment premennú JAVA_HOME na root adresár kde bola JRE nainštalovaná.
3. Pre použitie silných šifier v HTTPS protokole je potrebné stiahnuť Java Cryptography Extension (JCE) súbory a prekopírovať ich do lib/security adresára JRE. Ak nie je potrebné konfigurovať HTTPS protokol tento krok je možné vynechať.

Inštalácia Wildfly AS a SmartWeb aplikácie

Postup pri inštalácii aplikačného servera Wildfly je je nasledovný:

1. Rozbaliť inštalačné súbory v inštalačnom adresári D2000 - D2000_EXE/web sa nachádzajú zazipované inštalačné súbory aplikačného servera Wildfly (wildfly.zip) ako aj Java EE aplikácie SmartWeb (smartweb.zip) a tutorial javascriptovej aplikácie (tutorial-application.zip). Všetky tieto archívy je potrebné rozpakovať do toho istého adresára.
2. Nainštalovať aplikačný server Wildfly spustením inštalačného skriptu D2000_EXE/web/installWildfly.bat sa automaticky nainštaluje aplikačný server ako Windows Service s menom: D2000 SmartWeb.
3. Nainštalovať SmartWeb Java EE aplikáciu spustením inštalačného skriptu D2000_EXE/web/installSmartWeb.bat sa automaticky deployne (nakopíruje) SmartWeb aplikácia aj s preddefinovanou konfiguráciou javacriptovej tutorial aplikácie na aplikačný server.
4. Naimportovať do D2000 proces SELF.DCS so základnou konfiguráciou D2Connectora a konfiguráciu objektov pre javascriptovu tutorial aplikáciu z adresára D2000_EXE/web/install_files/D2000.
5. Spustiť SELF.DCS (D2Connector) a aplikačný server Wildfly (cez service.exe aplikáciu)
6. Otvoriť tutorial aplikáciu v prehliadači napr. adrese http://localhost:8080/smartWeb.

...

Inštalácia JRE 1.8

SmartWeb platforma je implementovaná v Java EE a preto potrebuje na svoj beh aj nainštalovane a nakonfigurované Java Runtime Environment verzie 8. Na linuxe sa inštaluje príkazmi cez package manager pod root používateľom. Pre Ubuntu distribúciu sú príkazy nasledovné :

add-apt-repository ppa:webupd8team/java # nalinkovanie repozitára s java balíčkami
apt-get update
apt-get install oracle-java8-set-default

Pre použitie silných šifier v HTTPS protokole je potrebné nainštalovať aj Java Cryptography Extension (JCE) rozšírenie nasledovným príkazom:

apt install oracle-java8-unlimited-jce-policy 

Inštalácia Wildfly AS a SmartWeb aplikácie

Postup pri inštalácii aplikačného servera Wildfly je je nasledovný:

Rozbaliť inštalačné súbory v inštalačnom adresári /opt/D2000/web (alebo v inom, závisí od miesta inštalácie D2000, resp. nakopírovania adresára web).  V tomto adresári sa nachádzajú zazipované inštalačné súbory aplikačného servera Wildfly (wildfly.zip) ako aj Java EE aplikácie SmartWeb (smartweb.zip) a tutorial javascriptovej aplikácie (tutorial-application.zip). Všetky tieto archívy je potrebné rozpakovať do toho istého adresára, napríklad príkazom:

cd /opt/D2000/web
unzip *.zip -d .

Vytvoriť používateľa wildfly. Kvôli bezpečnosti je vhodné aby Wildfly na Linuxe bežal pod samostatným používateľom ktorého je potrebné najskôr vytvoriť. V nasledujúcom skripte vytvoríme groupu a používateľa wildfly, a priradíme ho ako ownera adresára /opt/D2000/web.

groupadd -r wildfly
useradd -r -g wildfly -d /opt/D2000/web -s /sbin/nologin wildfly.
chown -R wildfly:wildfly /opt/D2000/web

Nainštalovať aplikačný server Wildfly spustením inštalačného skriptu /opt/D2000/web/installWildfly.sh s parametrami jednoslovný identifikator servicu (napr DEMO) a port offset (posunutie portov pre prípad že na serveri beží viacero aplikačných serverov). Spustenie skriptu je možné vykonať nasledovne: 

cd /opt/D2000/web
chmod +x *.sh
./installWildfly.sh DEMO 0

...

Spustiť SELF.DCS (D2Connector) a aplikačný server Wildfly cez príkaz:

systemctl start wildfly-DEMO

...

Použitie portov 80/443 pre Wildfly server na Linuxe

Všeobecný rozdiel medzi konfiguráciou Wildfly na Linuxe a Windows je ten že na Linuxe nemôže process aplikačného servera obsadiť priamo porty 80/443 (HTTP/HTTPS) kvoli security. Rieši sa to presmerovaním default portov 8080/8443 cez IPTABLES nasledovne:

...

...

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	Tomcat nie je potrebné inštalovať a spravovať oddelene od D2000, pretože beží ako D2000 proces s príponou .WSC	Tomcat je potrebné inštalovať a spravovať nezávisle na D2000
flexibilita nasadenia v DMZ	nasadenie v DMZ nie je vhodné kvôli potrebe inštalovať a konfigurovať samostatnú inštanciu D2000	Ideálne pre samostatnú inštaláciu v DMZ
ad-hoc upgrade Tomcat Servera	upgrade Tomcatu je zviazaný s D2000	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ý:

1. 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
2. Nakopírovať súbor D2000_EXE/web/smartweb.war do adresára D2000_APP/<názov aplikácie>/config/proc/self.wsc/base/webapps/
3. Rozbaliť súbor D2000_EXE/web/tutorial-application.zip do adresára D2000_APP/<názov aplikácie>/config/proc/self.wsc
4. Spustiť proces SELF.DCS
5. Spustiť proces SELF.WCS
6. 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ý:

1. Stiahnuť a nainštalovať AdoptOpenJDK verzie 11
2. Stiahnuť a nainštalovať NodeJS
3. Nainštalovať Yarn (npm install --global yarn)
4. Nastaviť systémovú environment premennú JAVA_HOME na root adresár kde bola JDK nainštalované.
5. Stiahnuť a nainštalovať Tomcat verzie 10 podla štandardneho postupu 
6. Nakopírovať  súbor D2000_EXE/web/smartweb.war do webapps adresára Tomcatu
7. Rozbaliť súbor D2000_EXE/web/tutorial-application.zip (Tomcat musí mať práva na čítanie z priečinku, napr. uložiť na D:/)
8. Spustiť proces SELF.DCS
9. Vypnúť SELF.WSC (používa port 8080 ako aj Tomcat v defaultnom nastavení)
10. Spustiť Tomcat server
11. Nainštalovať balíčky pre demo aplikáciu (yarn install - spustiť v root adresári dema)
12. Vykompilovať release verziu aplikácie pomocou príkazu yarn build 
13. Spustiť demo aplikáciu v dev režime (yarn start)
14. 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)
15. Reštartovať Tomcat
16. Otvoriť tutorial aplikáciu v prehliadači na adrese http://localhost:8080/smartweb

// 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é:

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