...
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.
...
- 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
- 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
...
- 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)Spustiť Tomcat server
- 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é :
Blok kódu | ||
---|---|---|
| ||
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:
Blok kódu | ||
---|---|---|
| ||
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ý:
- 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:
Otvoriť tutorial aplikáciu v prehliadači napr. adrese na adrese http://localhost:8080/smartWeb.Blok kódu language bash systemctl start wildfly-DEMO
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:
Blok kódu | ||
---|---|---|
| ||
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
.
Blok kódu | ||
---|---|---|
| ||
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:
Blok kódu | ||
---|---|---|
| ||
cd /opt/D2000/web
chmod +x *.sh
./installWildfly.sh DEMO 0 |
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:
...
language | bash |
---|
...