Porovnávané verzie

Kľúč

  • Tento riadok sa pridal
  • Riadok je odstránený.
  • Formátovanie sa zmenilo.
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(plus) Tomcat nie je potrebné inštalovať a spravovať oddelene od D2000, pretože beží ako D2000 proces s príponou .WSC(mínus) Tomcat je potrebné inštalovať a spravovať nezávisle na D2000
flexibilita nasadenia v DMZ(mínus) nasadenie v DMZ nie je vhodné kvôli potrebe inštalovať a konfigurovať samostatnú inštanciu D2000 (plus) Ideálne pre samostatnú inštaláciu v DMZ
ad-hoc upgrade Tomcat Servera(mínus) upgrade Tomcatu je zviazaný s D2000(plus) 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ť a premenovať 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.wscupraviť súbor 
    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/conf/context.xml

Inštalácia na Windows OS

Inštalácia JRE 1.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. webapps/
  2. Rozbaliť súbor D2000_EXE/web/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.
  3. 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.
  4. 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.
  5. 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.
  6. do adresára D2000_APP/<názov aplikácie>/config/proc/self.wsc
  7. Spustiť proces SELF.DCS
  8. Spustiť proces SELF.WCSSpustiť SELF.DCS (D2Connector) a aplikačný server Wildfly (cez service.exe aplikáciu)
  9. Otvoriť tutorial aplikáciu v prehliadači napr. adrese na adrese http://localhost:8080/smartWeb.

...

  1. 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. Nastaviť systémovú environment premennú JAVA_HOME na root adresár kde bola JDK nainštalované.
  3. Stiahnuť a nainštalovať Tomcat verzie 9 podla štandardneho postupu 
  4. Nakopírovať  súbor D2000_EXE/web/smartweb.war do webapps adresára Tomcatu
  5. Rozbaliť súbor D2000_EXE/web/tutorial-application.zip do parent adresára Tomcatu 
  6. Spustiť proces SELF.DCS
  7. Spustiť Tomcat server
  8. Otvoriť tutorial aplikáciu v prehliadači na

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
languagebash
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
languagebash
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
    languagebash
    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
    languagebash
    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
    languagebash
    cd /opt/D2000/web
    chmod +x *.sh
    ./installWildfly.sh DEMO 0
  1. 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.
  2. 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.
  3. Spustiť SELF.DCS (D2Connector) a aplikačný server Wildfly cez príkaz:

    Blok kódu
    languagebash
    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:

...

languagebash

...

  1. smartweb

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.