Preskoči na glavno vsebino

Aktualizácia databázového systému pre ABRA Flexi na vlastnom serveri a lokálne

ABRA Flexi 2022.5 a vyššie vyžaduje verziu PostgreSQL 13

Avtor: Petr Pech

Od verzie 2022.5 je pri nových instaláciách a pri aktualizácii ABRA Flexi na Windows a MacOS vyžadovaná verzia PostgreSQL 13. Pri aktualizácii serverovej instalácie dôjde na operačných systémoch Windows a MacOS k automatickému prevodu dátových súborov do novej verzie PostgreSQL.

Automatická aktualizácia na Linuxe momentálne nie je podporovaná, preto verzia nebude zatiaľ nasadená do RPM/DEB repozitárov. Neinštalujte ručne balíček verzie 2022.5.x, s verziou PostgreSQL 9.x nebude fungovať.

0. Odporúčania a systémové obmedzenia pre aktualizáciu databázy

  1. Na aktualizáciu si, prosíme, vyhraďte dostatok času.

  2. Pre všetky prípady odporúčame účtovné dáta vopred zálohovať.

  3. Migrácia bude potrebovať dostatok voľného miesta na disku a môže byť časovo veľmi náročná.

  4. OS Windows je podporovaný už len v 64bitovej variante s NTFS (dáta nemožno ukladať na FAT32).

  5. Minimálna vyžadovaná verzia macOS je teraz verzia 10.14 Mojave.

  6. Na Linuxe došlo k ukončeniu podpory starších verzií PostgreSQL 8.3 až 9.6. Minimom je verzia 10 (maximom zostáva verzia 13).

  7. Ukončenie podpory databázových procedúr v jazyku PL/Tcl. Prípadné užívateľské procedúry v tomto jazyku je nutné z databáz odstrániť.

Pri nedodržaní týchto bodov nemôžeme garantovať úspešnú aktualizáciu.

Teraz sa pozrieme na postup instalácie a aktualizácie ABRA Flexi vrátane aktualizácie PostgreSQL.

1. Stiahnutie instalačného balíčka ABRA Flexi

Verziu pre vlastné servery a lokálne instalácie získate v sekcii na stiahnutie.

V sekcii na stiahnutie nájdete a stiahnete univerzálny balíček podľa Vášho operačného systému. Univerzálny balíček je nutný pre lokálne instalácie a instalácie na server. Balíček obsahuje aj instaláciu databázového systému.

2. Instalácia (aktualizácia)

Pred samotnou instaláciou úplne ukončite aplikáciu ABRA Flexi, pokiaľ beží. Zároveň nesmú byť aktívne API integrácie (napojenie na iné systémy) či webhooky, ktoré na pozadí zapisujú dáta automaticky.

Teraz môžete spustiť instalačný balíček. Na operačnom systéme MacOS môže dôjsť k odmietnutiu instalačného balíčka systémom s týmto hlásením:

Postup, ako túto situáciu vyriešiť, nájdete v dokumentácii - Instalácia ABRA Flexi na MacOS.

Po úvodných krokoch instalácie,

ohľadom licenčného ujednania vás instalátor vyzve k aktualizácii databázového systému PostgreSQL:

Pre instaláciu je nutné získať instalačný balíček PostgreSQL. Tento balíček instalátor stiahne automaticky v prípade, že je počítač pripojený k internetu. Ručne možno tento balíček stiahnuť na tejto adrese:

MacOS

Windows

Ďalšia obrazovka upozorňuje na dlhšiu dobu spracovania instalácie, počas ktorej nie je možné pristupovať k dátam. Potvrdenie vykonáte tlačidlom "Ďalej".

Na ďalšej obrazovke instalátora máte možnosť zadať ručne stiahnutý instalačný balíček PostgreSQL. Balíček je v archíve ZIP, tento archív nijako nemeňte a nerozbaľujte, iba vyberte cestu k nemu a potvrďte tlačidlom "Ďalej".

V ďalšom kroku sa spustí rozbalenie archívu a pripraví sa instalátor na aktualizáciu databázového systému.

Posledný krok pred samotnou aktualizáciou databázového systému je obrazovka, na ktorej potvrdíte aktualizáciu PostgreSQL a dôjde k zmene dát. Staré dáta možno na konci aktualizácie archivovať, nemusíte sa teda obávať straty dát. Potvrdenie vykonáte tlačidlom "Ďalej".

Stavová obrazovka v jednoduchej forme zobrazí priebeh aktualizácie. V prípade výskytu informatívnej hlášky je v instalácii potrebné pokračovať tlačidlom "Ďalej".

V prípade prerušenia instalácie o tom, že aktualizácia databázy nebola úspešná, informuje ďalšie hlásenie.

Po úspešnej aktualizácii je užívateľ informovaný a je možné instalátor "Ukončiť".

Staré dáta z pôvodnej verzie ABRA Flexi možno uchovať, užívateľ je vyzvaný na uloženie dát do zložky Data_old.

V opačnom prípade dôjde k vypísaniu informácie, že aktualizácia databázy nebola úspešná a užívateľ je vyzvaný na vymazanie dátového adresára novej verzie. Pôvodné dáta pred aktualizáciou zostávajú zachované.

Pokiaľ sa na disku nachádza adresár so zálohovanými dátami z poslednej aktualizácie, dôjde počas aktualizácie k chybe a pre pokračovanie je potrebné adresár ručne vymazať.

V tomto prípade, keď nedošlo k úspešnej aktualizácii databázového systému, prosím, kontaktujte našu technickú podporu na emailovú adresu podporaflexi@abra.eu Pre rýchlejšie vyriešenie problému nám rovno zašlite log instalácie, viď nižšie 1. otázka v FAQ.

FAQ

Kde získam log aktualizácie na zistenie chyby?

Windows - logy nájdete v adresári flexi-upgrade, ktorý nájdete v adresári C:\Users\{jméno uživatele}\AppData\Local\Temp\

MacOS - log nájdete v adresári /Library/Application\ Support/FlexiBee/flexi-upgrade/

Počas aktualizácie databázy sa objaví Chyba C:\Users\{uzivatel}\AppData\Local\Temp\flexi-upgrade\pgsql\share\tsearch_data\danish.stop

Viď snímka.

Túto chybu sme zaznamenali na Windows Server 2019. Problém spôsobuje FSRM (File Server Resource Manager). Riešením je nastavenie na pasívny režim.

Kde nájdem adresáre aplikácie a databázy?

Môžem sa vrátiť na predchádzajúcu verziu ABRA Flexi?

Bohužiaľ nie, po aktualizácii je nutné využívať ABRA Flexi 2022.5.0 a vyššie a s touto verziou spojený databázový systém PostgreSQL vo verzii 13.

Môžu užívatelia počas aktualizácie pracovať?

Nemôžu. Pred samotnou instaláciou úplne ukončite aplikáciu ABRA Flexi, pokiaľ beží. Zároveň nesmú byť aktívne API integrácie (napojenie na iné systémy) či webhooky, ktoré na pozadí zapisujú dáta automaticky.

Aké sú požiadavky na lokálnu instaláciu či server?

Musím aktualizáciu vykonať, ak mám licenciu v cloude?

V prípade, že využívate licenciu prenájom a máte dáta u nás v cloude, nie je táto aktualizácia pre Vás nutná.

Ako získam informácie o behu databázového systému?

Databázový server PostgreSQL automaticky zapisuje informácie o svojom chode do systémového logu.

Potrebujete poradiť?

V prípade otázok k aplikácii nás kontaktujte na podporaflexi@abra.eu prípadne prostredníctvom chatového okna v pravom dolnom rohu.

Ste s tem dobili odgovor na svoje vprašanje?