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ššia vyžaduje verziu PostgreSQL 13

Avtor: Petr Pech

Od verzie 2022.5 je na nových inštaláciách a pri aktualizácii ABRA Flexi na Windows a MacOS vyžadovaná verzia PostgreSQL 13. Pri aktualizácii serverovej inštalá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 64-bitovej variante s NTFS (dáta nie je možné ukladať na FAT32).

  5. Minimálna pož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é použí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 inštalácie a aktualizácie ABRA Flexi vrátane aktualizácie PostgreSQL.

1. Stiahnutie inštalačného balíčka ABRA Flexi

Verziu pre vlastné servery a lokálne inštalá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 potrebný pre lokálne inštalácie a inštalácie na server. Balíček obsahuje aj inštaláciu databázového systému.

2. Inštalácia (aktualizácia)

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

Teraz môžete spustiť inštalačný balíček. Na operačnom systéme MacOS môže dôjsť k odmietnutiu inštalač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 – Inštalácia ABRA Flexi na MacOS.

Po úvodných krokoch inštalácie,

ohľadom licenčnej zmluvy vás inštalátor vyzve k aktualizácii databázového systému PostgreSQL:

Pre inštaláciu je potrebné získať inštalačný balíček PostgreSQL. Tento balíček inštalátor stiahne automaticky v prípade, že je počítač pripojený na internet. Ručne je možné tento balíček stiahnuť na tejto adrese:

MacOS

Windows

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

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

V ďalšom kroku sa spustí rozbaľovanie archívu a pripraví sa inštalátor pre aktualizáciu databázového systému.

Posledný krok pred samotnou aktualizáciou databázového systému je obrazovka, ktorou potvrdíte aktualizáciu PostgreSQL a dôjde k zmene dát. Staré dáta je možné 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. Zásah používateľa nie je nutný, proces môže trvať desiatky minút.

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

Staré dáta z pôvodnej verzie ABRA Flexi je možné uchovať – používateľ je vyzvaný na uloženie dát do priečinka Data_old.

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

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 e-mailovú adresu podporaflexi@abra.eu Pre rýchlejšie vyriešenie problému nám priamo zašlite log inštalácie, pozri nižšie 1. otázku 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

Pozri snímku.

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é používať ABRA Flexi 2022.5.0 a vyššiu a s touto verziou spojený databázový systém PostgreSQL vo verzii 13.

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

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

Aké sú požiadavky na lokálnu inštaláciu alebo server?

Musím vykonať aktualizáciu, 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, táto aktualizácia pre vás nie je 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 okna chatu v pravom dolnom rohu.

Ste s tem dobili odgovor na svoje vprašanje?