Tento postup inštalácie je platný iba pre novšie verzie D2000. Ak používate D2000 do verzie V12.0.61 vrátane prosím postupujte podľa návodu Inštalácia a konfigurácia pre staršie verzie D2000.
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ý 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ý:
- Nakonfigurovať a spustiť proces SELF.WSC nasledovne:
- prekopírovať a premenovať adresár
D2000_EXE/templates/config/proc/_.wsc
doD2000_APP/<názov aplikácie>/config/proc/self.wsc
- vytvoriť proces SELF.WSC s parametrom /X2
- prekopírovať a premenovať adresár
- Rozbaliť súbor
D2000_EXE/web/smartWeb.zip
do adresáraD2000_EXE/templates/config/proc/_.wsc
doD2000_APP/<názov aplikácie>/config/proc/self.wsc/base
- Rozbaliť súbor
D2000_EXE/web/tutorial-application.zip
do adresáraD2000_EXE/templates/config/proc/_.wsc
doD2000_APP/<názov aplikácie>/config/proc/self.wsc
Inštalácia Smart Web aplikácie na standalone Tomcat
Postup inštalácie je nasledovný:
- Stiahnuť a nainštalovať AdoptOpenJDK verzie 11
- Nastaviť systémovú environment premennú JAVA_HOME na root adresár kde bola JDK nainštalované.
- 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 JDK. Ak nie je potrebné konfigurovať HTTPS protokol tento krok je možné vynechať
- Stiahnuť a nainštalovať Tomcat verzie 9 podla štandardneho postupu
- Rozbaliť súbor
D2000_EXE/web/smartWeb.zip
do root adresára Tomcatu - Rozbaliť súbor
D2000_EXE/web/tutorial-application.zip
do parent adresára root adresára Tomcatu
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 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. - 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
. - 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.
- 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
. - Spustiť SELF.DCS (D2Connector) a aplikačný server Wildfly (cez service.exe aplikáciu)
- Otvoriť tutorial aplikáciu v prehliadači napr. adrese http://localhost:8080/smartWeb.
Inštalácia na Linux OS (Ubuntu)
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áraweb
). 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ľawildfly
, 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
- Nainštalovať SmartWeb Java EE aplikáciu spustením inštalačného skriptu
/opt/D2000/web/installSmartWeb.sh
sa automaticky deployne (nakopíruje) SmartWeb aplikácia aj s preddefinovanou konfiguráciou javacriptovej tutorial aplikácie na aplikačný server.
- Naimportovať do D2000 proces SELF.DCS so základnou konfiguráciou D2Connectora a konfiguráciu objektov pre javascriptovu tutorial aplikáciu z adresára
/opt/D2000/web/install_files/D2000
. Spustiť SELF.DCS (D2Connector) a aplikačný server Wildfly cez príkaz:
systemctl start wildfly-DEMO
- Otvoriť tutorial aplikáciu v prehliadači napr. adrese http://localhost:8080/smartWeb.
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:
Iptables -t nat -A PREROUTING -i eth0 -p tcp -dport 80 -j REDIRECT --to-port 8080 Iptables -t nat -A PREROUTING -i eth0 -p tcp -dport 443 -j REDIRECT --to-port 8443