Info |
---|
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. |
Obsah |
---|
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/
- a následne premenovať
_.wsc
naself.wsc
- vytvoriť proces SELF.WSC s parametrom /X2
- prekopírovať a premenovať adresár
- Rozbaliť Nakopírovať súbor
D2000_EXE/web/smartWebsmartweb.zip
do adresáraD2000_EXE/templates/config/proc/_.wsc
dowar
do adresáraD2000_APP/<názov aplikácie>/config/proc/self.wsc/base/webapps/
- 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.DCS
- 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
- 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 Nakopírovať súbor
D2000_EXE/web/smartWebsmartweb.zipwar
do rootwebapps
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ý:
- adresára Tomcatu
- Spustiť proces SELF.DCS
- Spustiť Tomcat server
- 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 na 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ý:
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 |
Zmena kontextového adresára URL linky
...
Spustiť SELF.DCS (D2Connector) a aplikačný server Wildfly cez príkaz:
Blok kódu | ||
---|---|---|
| ||
systemctl start wildfly-DEMO |
...
Pre zmenu kontextového adresára URL linky z http://localhost:8080/smartweb na napr.
...
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 |
---|
...
myApp je potrebné spraviť nasledovné:
- Zastaviť Tomcat server.
- Premenovať súbor /webapps/smartweb.war
- Spustiť Tomcat server.