Inštalácia JRE 1.8

Smart Web SmartWeb platforma je implementovaná v Java EE a preto potrebuje na svoj beh aj nainštalovane 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 potrebne 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 Smart Web aplikácie

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

ako aplikácia pre 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ý:

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. 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 Smart Web (smartweb.zip) a tutorial javascriptovej aplikácie (tutorial-application.zip). Všetky tieto archívy je potrebné rozpakovať do toho istého adresára.
7. 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 Smart Web.
8. Nainštalovať Smart Web Java EE aplikáciu spustením inštalačného skriptu D2000_EXE/web/installSmartWeb.bat sa automaticky deployne (nakopíruje) Smart Web aj s preddefinovanou konfiguráciou javacriptovej tutorial aplikácie na aplikačný server.
9. 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.
10. Spustiť SELF.DCS (D2Connector) a aplikačný server Wildfly (cez service.exe aplikáciu)
11. Otvoriť tutorial aplikáciu v prehliadači na adrese adrese http://localhost:8080/smartWeb.

...

Pre inštaláciu na Linuxe  treba postupovať podľa nasledovného návodu pre Ubuntu alebo Centos. Pre iné distribúcie treba postupovať analogicky. 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:

...

...

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. 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.