Preskoči na glavno vsebino

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

Od verzie 2026.6.0 inštalátor pre Windows a macOS prevádza databázu na PostgreSQL 17

Avtor: Petr Pech

Úvod

Od verzie 2026.6.0 inštaluje ABRA Flexi na Windows a macOS databázový systém PostgreSQL 17 namiesto verzie 13. Pri aktualizácii existujúcej inštalácie sa dáta na novú verziu prevedú automaticky. Prevod prenáša celú databázu, takže pri väčších inštaláciách trvá dlhšie. Aktualizáciu preto odporúčame naplánovať mimo prevádzky.

Na Linuxe inštalátor PostgreSQL neaktualizuje. Podporované sú verzie 13 až 17, prehľad nájdete v systémových požiadavkách.

📝 História: Od verzie 2022.5 sa na Windows a macOS vyžadovala verzia PostgreSQL 13 a pri aktualizácii prebehol automatický prevod dát. Na Linuxe nebola automatická aktualizácia podporovaná, preto verzia 2022.5.x vtedy nebola nasadená do RPM/DEB repozitárov a s PostgreSQL 9.x nefungovala.


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á. Voľného miesta musí byť približne toľko, koľko zaberajú súčasné dáta + bezpečná rezerva pre chod OS či ďalšie operácie.

  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 vyžadovaná verzia macOS je teraz verzia 10.14 Mojave.

  6. Na Macu s procesorom Apple Silicon (rad M) potrebuje prevod z PostgreSQL 13 Rosettu 2. Inštalátor ju doinštaluje automaticky, počítač musí byť pripojený k internetu.

  7. Na Linuxe sú podporované verzie PostgreSQL 13 až 17.

  8. Ukončenie podpory databázových procedúr v jazyku PL/Tcl. Prípadné používateľské procedúry v tomto jazyku je potrebné 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ík podľa vášho operačného systému. Univerzálny balík je potrebný pre lokálne inštalácie a inštalácie na server. Balík obsahuje aj inštaláciu databázového systému.


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

Pred samotnou inštaláciou kompletne ukončite aplikáciu ABRA Flexi, ak 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ť inštalačný balík. 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 inštaláciu povoliť, popisuje článok o zablokovanej inštalácii alebo aktualizácii.

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

týkajúcich sa licenčného ujednania, vás inštalátor vyzve na aktualizáciu databázového systému PostgreSQL:
​

Na prevod dát potrebuje inštalátor balík PostgreSQL v pôvodnej verzii, z ktorej aktualizujete. Ak je počítač pripojený k internetu, stiahne ho automaticky. Ručne ho stiahnete tu:

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ík PostgreSQL. Balík 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 na aktualizáciu databázového systému.

Posledným krokom 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 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 jednoduchou formou zobrazí priebeh aktualizácie. V prípade zobrazenia informatívneho hlásenia je potrebné v inštalácii pokračovať tlačidlom "Ďalej".

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

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

Staré dáta z pôvodnej verzie ABRA Flexi je možné uchovať. Pôvodný dátový adresár zostane ako záloha s číslom verzie, napríklad Data_old_PG13. Po overení, že všetko funguje, ho môžete zmazať.

V opačnom prípade dôjde k vypísaniu 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é.

Ak na disku zostala záloha z predchádzajúcej aktualizácie, inštalátor ponúkne jej zmazanie, premenovanie (napríklad na Data_old_PG9_3), alebo ukončenie aktualizácie. Pri nedostatku miesta vypíše nájdené staré zálohy aj s ich veľkosťou.

Aktualizáciu databázy je možné v inštalátore pre Windows zrušiť, dáta zostanú bez zmeny. Počas kopírovania a presúvania dát však aktualizáciu prerušiť nejde.

Ak aktualizácia databázového systému neprebehne úspešne, kontaktujte našu technickú podporu na podporaflexi@abra.eu. Pre rýchlejšie vyriešenie nám rovno zašlite log inštalácie, pozri prvú otázku vo 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?

Nie. Po aktualizácii na verziu 2026.6.0 a vyššiu sa používa PostgreSQL 17.

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

Nemôžu. Pred samotnou inštaláciou kompletne ukončite aplikáciu ABRA Flexi, ak 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 inštaláciu či server?

Potrebujem na Macu s procesorom M Rosettu?

Od verzie 2026.6.0 iba na prevod dát z PostgreSQL 13. Inštalátor ju doinštaluje sám. Podrobnosti nájdete v návode na inštaláciu na Mac s procesorom Apple Silicon.

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

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

Kedy môžem zmazať adresár Data_old_PG13?

Až po overení, že aplikácia aj dáta fungujú.

Potrebujete poradiť?

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

Ste s tem dobili odgovor na svoje vprašanje?