/
Upgrade SmartWeb aplikácie

Upgrade SmartWeb aplikácie

Upgrade SmartWeb aplikácie spočíva vo výmene inštalačného balíka (smartweb.jar, resp. smartweb.war) za novšiu verziu. Konfiguračný súbor application.yaml zostáva zachovaný a nie je súčasťou inštalačného balíka, takže sa pri upgrade neprepisuje.

[!NOTE] Tento postup platí pre aktuálny spôsob nasadenia SmartWeb platformy postavenej na Spring Boot (samostatný JAR alebo WAR v samostatnom Tomcate). Upgrade starších verzií nasadených na aplikačnom serveri Wildfly je popísaný v kapitole Inštalácia a konfigurácia pre staršie verzie D2000.

Upgrade nasadenia ako samostatný JAR

  1. Zastaviť bežiacu SmartWeb aplikáciu (proces smartweb.jar, resp. príslušnú systémovú službu).

  2. Zálohovať pôvodný súbor smartweb.jar aj adresár config/ (kvôli možnosti návratu na predchádzajúcu verziu).

  3. Nahradiť súbor smartweb.jar novou verziou z D2000_EXE/web/smartweb.jar. Adresár config/ ponechať bez zmeny.

  4. Opäť spustiť aplikáciu príkazom java -jar smartweb.jar (resp. spustiť systémovú službu).

Upgrade nasadenia ako WAR v samostatnom Tomcate

  1. Zastaviť aplikačný server Tomcat.

  2. Zálohovať pôvodný .war súbor aj adresár <tomcat>/conf/applications/<názov-war>/ s konfiguráciou.

  3. Nahradiť .war súbor v adresári webapps Tomcatu novou verziou z D2000_EXE/web/smartweb.war. Nový .war súbor je potrebné premenovať na rovnaký názov, aký mal pôvodný (aby zostala zachovaná URL cesta aj umiestnenie konfigurácie).

  4. Voliteľne odstrániť z adresára webapps pôvodný rozbalený adresár aplikácie, aby Tomcat aplikáciu nasadil nanovo.

  5. Spustiť aplikačný server Tomcat.

[!IMPORTANT] Premenovaním archívu aplikácie (smartweb.war) definujeme URL cestu k spustenej aplikácii. Zároveň tým umožníme spustenie viacerých, na sebe úplne nezávislých verzií SmartWeb aplikácie na jednom Tomcat serveri, z ktorých každá bude dostupná na inej URL ceste. Tieto aplikácie sa môžu pripájať na rôzne D2000 inštancie, dokonca aj rozdielnych verzií.

Pozor, pre správne fungovanie aplikácie je nevyhnutné názov .war súboru aplikácie premenovať iba s použitím alfanumerických znakov a bez diakritiky.

Migrácia konfigurácie

SmartWeb pri štarte automaticky spracuje existujúci konfiguračný súbor:

  • Staršia konfigurácia vo formáte smartweb.json sa pri prvom spustení novej verzie automaticky zmigruje do formátu application.yaml.

  • Ak sa po upgrade v štruktúre konfigurácie objavia nové vlastnosti, SmartWeb ich pri štarte doplní s predvolenými hodnotami.

Po upgrade odporúčame skontrolovať poznámky k vydaniu a prípadné nové konfiguračné možnosti v súbore application.yaml.