Update systému ABRA Gen (aktualizácia inštalácie)

Ako bolo povedané v úvodnej kap. Aktualizácia systému ABRA Gen (update a iné aktualizácie), systém ABRA Gen sa neustále vyvíja a mal by byť priebežne aktualizovaný. Základnou možnosťou, ako vykonať aktualizáciu systému, je update. Update znamená prechod na vyššiu verziu systémuABRA Gen a mal by sa priebežne vykonávať.

V nasledujúcom texte budú uvedené orientačné inštalačné postupy na prevedenie systému ABRA Gen na vyššiu verziu. Ak si nie ste istí krokmi, ktoré postupy obsahujú, odporúčame radšej zveriť proces update do rúk servisného oddelenia firmy ABRA Software s.r.o. alebo niektorému z jej partnerov.

Update od v. 10.02 prebieha tzv. inkrementálnym spôsobom.

O inkrementálnom Update

Základné pojmy inkrementálneho update

Inkrementálny update - Aktualizácia programu, ktorá realizuje zmeny dátových štruktúr a úpravy dát priamo nad existujúcou databázou a zároveň prináša zmeny správania aplikačnej vrstvy programu.
Databázový objekt (entita) – viď Databázové objekty.
UpdateList – zmeny databázových objektov, ktoré výrobca v rámci vývoja novej verzie vykoná, sa zaznamenávajú (u výrobcu) do tzv. UpdateListu. Tento UpdateList sa stáva súčasťou inštalácie verzie a na jeho základe sa vykonávajú zmeny nad "živou" databázou používateľa.
Operácia – Dielčia zmena databázy definovaná v UpdateListe. Operáciou môže byť napr. zmena tabuľky, pridanie stĺpca tabuľky alebo aj pridanie inicializačných dát a pod.
Dátové konverzie – špeciálne operácie meniace dáta v databáze. Typicky SQL príkaz "update" alebo sada SQL príkazov meniaca dáta bez ovplyvnenia dátovej štruktúry.
Dodávané súbory v rámci inštalácie (pre riešenie inkrementálneho update):
- UpdateDB.DBO – Súbor databázových operácií. Obsahuje príkazy na zmenu existujúcej databázy. Tj. vlastne obsahuje operácie z UpdateListu.
- CreateDB.DBO – Súbor databázových operácií. Obsahuje operácie pre vytvorenie novej prázdnej databázy, vrát. nahratia inicializačných dát či iných dát podľa kontextu. (Viď napr. popis stavu Nová databáza.)
- InitData.DBO - Súbor databázových operácií. Obsahuje operácie pre naplnenie novej databázy inicializačnými dátami.
- InstallDB.DBO - Súbor databázových operácií. Obsahuje príkazy, ktoré sa vykonajú v rámci inštalácie nového modulu do existujúcej inštalácie (doplnia dáta novo inštalovaného modulu tak, aby zodpovedali existujúcej inštalácii).
- ExternalData.DAT- Súbor databázových operácií. Pomocný súbor pre súbory DBO. Obsahuje dáta pre príkazy nad tabuľkou (vloženie a zmena, využíva sa hlavne pre inicializačné dáta). Obsahuje SQLite3 databázu s aktuálnymi verziami reportov, exportov, B2Bexportov a použív. definovateľných formulárov, ktoré sa nahrávajú v rámci inicializačných dát či v rámci zmien v UpdateListe.
Dátový update (alebo update dát) – Tá časť inkrementálneho update, pri ktorej dochádza k aplikácii operácií UpdateListu. Dátový update vykonáva tzv. DDL príkazy modifikujúce štruktúru databázy a príkazy modifikujúce dáta (dátové konverzie).
Doinštalácia modulu – Ak pri aktualizácii programu zaškrtne používateľ inštaláciu modulu, ktorý dovtedy nainštalovaný nebol, dôjde v rámci dátového update okrem iného k vytvoreniu objektov databázy potrebných na fungovanie tohto modulu. Pri doinštalácii modulu dochádza k vykonaniu aj iných činností, ale na objasnenie inkrementálneho update je podstatné práve vytvorenie dátového základu daného modulu. Preto na účely objasnenia update budeme nazývať doinštaláciou modulu len vytvorenie týchto databázových objektov.
Metadata – Viď Metadata.
Závislosti – Tu myslené závislosti v databáze. Databázové objekty sú navzájom prepojené, majú medzi sebou väzby, a preto sú od seba závislé. Trigger je napríklad závislý od svojej tabuľky. Bez nej nemôže existovať (príp. nemôže existovať v validnom stave). Rovnako tak procedúry, ak majú vo svojom tele použité stĺpce tabuliek, stávajú sa od týchto stĺpcov závislé. A pod.

Princíp inkrementálneho update

Update systému ABRA Gen na vyššiu verziu všeobecne znamená jednak nahradenie programových súborov novými (nahradenie binárnych súborov a ich registrácia) a jednak prípadnú úpravu databázy (štruktúry databázy a dát v nej uložených) tak, aby zodpovedala vyššej verzii.

Inštalačný program teda pri voľbe Aktualizácia existujúcej inštalácie vykoná nahradenie programových súborov systému Systém ABRA Gen novšími a ďalej nastaví existujúce spojenie na databázy do stavu Update. Pri následnom spustení systému ABRA Gen a výbere spojenia na databázu (čo môže v rámci procesu "aktualizácie inštalácie" prebehnúť automaticky, viď Krok - Dokončenie inštalácie) sa spustí proces dátového update. Dátový update číta operácie zo súboru UpdateDB.DBO a operácie postupne v príslušnej databáze vykonáva. Vykonáva zmeny dátových štruktúr a úpravy dát priamo nad existujúcou databázou.

Vzhľadom na to, že používatelia môžu mať vlastné databázové objekty, ktoré sú závislé od databázových objektov systému ABRA Gen, bude dochádzať k tomu, že na rôznych dátach rôznych klientov bude tento "dátový update" generovať rôzne veľkú množinu príkazov. O. i. od toho sa bude odvíjať doba jeho vykonania.

Vykonané operácie sa logujú do databázy do špeciálnej tabuľky na to určenej, vrátane verzie a príznaku, či bola operácia dokončená. To je dôležité preto, aby mohol systém v procese dátového update pokračovať, ak z nejakého dôvodu dôjde k jeho prerušeniu. Ak pri dátovom update dôjde k chybe, objaví sa dialógové okno Riešenie problému, v ktorom je používateľ informovaný jednak o chybovom hlásení databázy a ďalej potom o tom, aká operácia chybu spôsobila:

Príklad zobrazenia informácie o chybe vzniknutej v priebehu dátového update. Operácia sa pokúša pridať databázový objekt (doménu), ktorý už v databáze existuje. (Iná vec je, ako mohlo k takej situácii dôjsť, aké zásahy boli do databázy vykonané mimo systém ABRA Gen, ktoré to mohli spôsobiť atď. Od toho sa bude odvíjať aj spôsob riešenia daného problému.)

V takom prípade je možné Update prerušiť, zabezpečiť nápravu v existujúcej databáze a spustiť dátový update znova. Program má evidované, ktoré operácie už boli vykonané - tie znova nevykonáva, ale nadviaže v mieste, kde došlo k prerušeniu.

Podrobnejšie informácie nájdete v tipe Riešenie pádov dátového update.

Vykonanie operácie môže riešiť a často aj rieši nejaké závislosti. Väčšinou sa riešia tým spôsobom, že závislé objekty sa odstránia a po zmene, ktorá je predmetom operácie, sa všetky závislé objekty opäť vytvoria. Dielčie kroky operácie nebežia v transakcii – databáza ani transakčné spracovanie DDL nepodporuje. Avšak program si odstránené objekty samozrejme zaznamenáva a je schopný nadviazať presne tam, kde prestal. Z toho vyplýva, že operáciu je možné prerušiť, ale je potrebné ju dokončiť. Nie je možné ju vynechať, napr. zásahom do UpdateListu (používateľsky to ani nie je umožnené), aj keď vynechanie problematickej operácie sa ponúka ako zdanlivo najjednoduchšie riešenie. Avšak v rámci nej už mohlo dôjsť k nejakým úpravám závislostí a teda nedokončenie operácie by mohlo spôsobiť budúce ťažkosti. Pri servisnom riešení problémov je potrebné tento princíp správne chápať!

Počet zmien, ktoré je možné vykonať so štruktúrou jednej tabuľky do doby zálohy a obnovy databázy, je obmedzený (cca 255). Z toho vyplýva, že nie je možné donekonečna vykonávať inkrementálny update na nové verzie, bez toho, aby sa niekedy nevykonala aj obnova dát, pri ktorej sa vytvorí nová databáza. Avšak sa dá predpokladať (vzhľadom na malý počet takých zmien), že táto potreba nastane raz za niekoľko rokov. Teda sa týmto používateľ zatiaľ nemusí nijako znepokojovať.

Update vs. (ne)registrované moduly - Dátový update aktualizuje všetky tabuľky, ktoré v databáze nájde, bez ohľadu na to, či daný modul je alebo nie je aktuálne registrovaný v repozitári systému ABRA Gen. (K tomu môže dôjsť napr. tak, že používateľ si nenainštaluje všetky moduly (teda ich nemá registrované v repozitári)), ale do danej inštalácie si obnoví dáta zo zálohy, ktorá daný modul obsahovala. Čiže systém ABRA Gen sa bude externe správať, akoby tam modul nebol, ale v databáze sú tabuľky daného modulu obsiahnuté a štandardne podliehajú procesu dátového update.)

Prvé spustenie po update

Ak je v kroku Dokončenie inštalácie zaškrtnuté "Spustiť systém ABRA Gen", systém sa spustí a hneď sa vykoná dátový update. (Všetky spojenia (ak ich máte viac) by mali byť v stave Update (pokiaľ medzitým nedošlo k zásahu zvonka pomocou nástroja DbAdmin)). Podrobnejšie viď vyššie Princíp inkrementálneho update alebo tiež stavy databázového spojenia - stav Update. Po jeho úspešnom vykonaní sa spojenie prepne do stavu OK. Nasleduje prihlásenie používateľa do systému.

Dialóg pre výber spojenia na databázu sa v tomto prípade nezobrazuje (keďže existuje len jedno spojenie a to je v stave OK, zobrazovanie dialógu by teda bolo zbytočné).

Ak používate API, kontroluje sa, že databáza je v stave spojenia OK, inak vracia chybu 400. Z kontroly sú vyňaté servisné endpointy maintenance a monitoring.

Ak máte definované viaceré spojenia na databázy (tj. napr. vlastníte licenciu (aktivačný kľúč) na multiverziu a v systéme vediete viac firiem), potom sa vyššie uvedený proces vykoná automaticky pre všetky databázy. Viď tiež Príprava multiverzie na prevádzku po novej inštalácii resp. po update. Potom sa zobrazí dialóg pre výber spojenia na databázu, všetky spojenia by mali byť v stave OK. Po výbere spojenia nasleduje prihlásenie používateľa do systému

V prípade update sa prihlasovanie do jednotlivých spojení vykonáva automaticky a nečaká sa na prihlásenie používateľa, aby bolo možné ho aj v prípade multiverzie automaticky vykonávať napr. cez noc, bez zásahu obsluhy.

Ak prvé spustenie ABRA Gen s jednoduchým účtovníctvom resp. ABRA Gen s podvojným účtovníctvom po aktualizácii inštalácie a prihlásenie sa do daného spojenia nevykonáte (tj. ak v kroku Dokončenie inštalácie nie je zaškrtnuté "Spustiť systém ABRA Gen"), potom spojenie zostane v stave Update a dátový update danej databázy prebehne až neskôr, a to až pri ďalšom spustení systému vyvolanom iným spôsobom a po prihlásení sa do daného spojenia na databázu. Potom sa po spustení systému zobrazí dialóg pre výber spojenia na databázu podobný nasledujúcemu:

Príklad vzhľadu okna pre výber spojenia na databázu po inštalácii update, ak nebol systém spustený ihneď v rámci dokončenia inštalácie update, ale až neskôr iným spôsobom. Teda zatiaľ nedošlo k vykonaniu dátového update a spojenie zostalo v stave Update. K update databázy dôjde až po prihlásení do daného spojenia.

Po stlačení tlačidla OK sa pri tomto prvom prihlásení do daného spojenia po inštalácii update vykoná kontrola, či súhlasí verzia produktu. Tj. či nedošlo napr. k nasadeniu ABRA Gen s jednoduchým účtovníctvom na ABRA Gen s podvojným účtovníctvom alebo naopak. Ak by k takej situácii došlo, systém nahlási chybu. Ak prebehne kontrola v poriadku, vykoná sa dátový update príslušnej databázy.

Z hľadiska aktivácie je systém v stave ostrej verzie, ak správne prebehla aktivácia inštalácie. Ak nie, je systém v stave Trial verzie resp. demoverzie, podrobnejšie viď Stavy systému z hľadiska aktivácie a Ako spoznať stav aktivácie.

ABRA Gen s jednoduchým účtovníctvom resp. ABRA Gen s podvojným účtovníctvom, ktorá sa má aktualizovať, nesmie byť súčasne spustená.

Od v. 3.01.16 si systém pri svojom spustení vytvára tzv. mutex (objekt jadra, ktorý musí vytvoriť inštalačný program pri svojom spustení), ktorý nesie okrem iného informáciu o ceste, z ktorej bol spustený. Inštalačný program potom po výbere adresára pre inštaláciu kontroluje, či mutex s vybranou cestou existuje, a ak áno, inštaláciu nevykoná.

Ďalšia akcia spojené s update

S vykonaním update systému ABRA Gen, môžu súvisieť aj niektoré ďalšie kroky, ktoré je potrebné alebo ktoré je minimálne odporúčané vykonať:

Nutné: Aktualizácia súborov potrebných pre webové služby, ak ich prevádzkujete, viac viď Web. služby a update
Odporúčané: Kontrola aktuálnosti Udf knižníc, viac viď Doinštalované Udf knižnice
Odporúčané: Spustiť procedúru SelectivityMaintenance. Prepočítava selektivitu indexov a môže v častých prípadoch pomôcť zrýchliť odozvu systému.

Procedúra je navrhnutá pre databázy Firebird a ORACLE, na databáze MSSQL si musí používateľ zabezpečiť údržbu selektivity sám.
Príklad spustenia procedúry v programe DBTool.exe:

Firebird:
```
EXECUTE PROCEDURE SELECTIVITYMAINTENANCE(1)
```
Oracle:
```
BEGIN SELECTIVITYMAINTENANCE(1); END;
```
Odporúčané: Reštartovať terminálový server, ak prevádzkujete systém ABRA Gen v terminálovom režime.

Ďalej platí:

Preinštalovávať všetky služby ABRA Gen vo Windows, teda aplikačný server AppServer, Autoserver a pod. nie je nutné. (Ak sa nezmenil ich názov alebo cesta. Ide totiž len o zápis do registra, nič viac.)
Ak spolu s prechodom na vyššiu verziu systému ABRA Gen vykonávate aj prechod medzi inštaláciami či na iný produkt ABRA Gen, postup viď Prechod medzi systémami ABRA Gen, najmä ak ste v pôvodnej inštalácii mali nejaké vlastné zákaznícke úpravy.
Ak prevádzkujete závislé spojenia, tj. spojenia so synonymami (databáza Oracle/MSSQL), je potrebné procesu update venovať špeciálnu pozornosť. Postup nie je súčasťou tejto príručky, avšak nie je možné ho podceňovať. Kontaktujte, prosím, servisné oddelenie dodávateľa.

Ďalej odporúčame:

venovať pozornosť Zmenám vo verziách.
venovať maximálnu pozornosť servisným informáciám zobrazovaným po spustení novej verzie ABRA Gen (keďže nie všetky úpravy v dátach možno zabezpečiť automaticky v rámci update a často je zároveň nutný aj nejaký ručný zásah používateľa)!!!

TIP - Riešenie pádov dátového update

Tip je určený pre veľmi pokročilých používateľov a správcov systému. V prípade neistoty kontaktujte konzultantov obchodného či servisného oddelenia dodávateľa.

Popis situácie a všeobecný postup riešenie problému

Počas vykonávania inkrementálneho update môže dôjsť k chybe v niektorej operácii zo zoznamu AfterUpdateDB.DBO, AfterRestoreDB.dbo alebo AfterRestoreFromBackupDB.dbo. Update sa preruší a zobrazí sa chybové hlásenie:

Pri vykonaní databázovej operácie došlo k chybe.
Id operácie: ID operácie
Názov operácie: názov operácie
Text chyby: text chyby

Okno s hlásením umožňuje zopakovať operáciu, pri ktorej chyba nastala, alebo update prerušiť. Opakovanie operácie spravidla situáciu nevyrieši, a je teda potrebné update prerušiť.

V niektorých prípadoch podľa závažnosti a typu nahlásenej chyby je možné zvoliť jeden z nasledujúcich postupov:

Nápravu situácie, ktorá bráni vykonaniu operácie, zabezpečiť na databázovej úrovni (napr. s pomocou nástroja DBTool). Po oprave znovu spustiť a dokončiť update.
Dokončiť update s vynechaním chybovej operácie (viď nižšie) a nápravu v databáze vykonať neskôr.

Pred vynechaním operácie je nutné vedieť, čo daná operácia rieši a ako je možné jej obsah a priebeh nahradiť iným spôsobom! Samotné vynechanie operácie nie je riešením problému, ide len o možnosť, ako dočasne preskočiť chybu a problém doriešiť následne.

Vynechanie operácie je možné vykonať nasledovne:

Spustiť nástroj DBOperations.exe.
Pomocou voľby Súbor→Otvoriť načítať obsah súboru After*.DBO (typicky AfterUpdateDB.dbo).

Chyby operácií z iných zoznamov, ktorých názov sa nezačína prefixom After*, nie je vhodné riešiť touto cestou.
V načítanom zozname vyhľadať chybnú operáciu podľa ID operácie z chybového hlásenia (pokiaľ operáciu nenájdete, znamená to, že sa nachádza v inom *.DBO súbore).
Operáciu zo zoznamu vymazať alebo na záložke Podmienka pridať podmienku, ktorá nikdy nebude splnená – napr. zvoliť možnosť „Systémy Abry“ a nezaškrtnúť žiadnu voľbu.
Súbor uložiť.
Zavrieť nástroj DBOperations.exe.
Znova spustiť update.

Možnosť riešenia konkrétnej chyby operácie "Aktualizácia indexov v databáze podľa kľúčov na business objekte"

Nasledujúci popis uvádza riešenie konkrétneho problému v rámci operácie Aktualizácia indexov v databáze. Táto operácia je súčasťou zoznamu AfterUpdateDB.DBO.

Operácia pridáva do databázy indexy podľa kľúčov vybraných business objektov nasledovne:

ku každému kľúču pridá unikátny index s prefixom IA_ v názve, radený vzostupne, index je zložený z položky kľúča a ID
ku každému kľúču pridá unikátny index s prefixom ID_ v názve, radený zostupne, index je zložený z položky kľúča a ID
ku každému reťazcovému kľúču pridá expression index s prefixom IE_ v názve, radený vzostupne, index obsahuje výraz UPPER(<položka kľúča>)

Tieto indexy urýchľujú prístup k dátam nových číselníkov.

Pokiaľ zlyhá pridanie niektorého indexu k niektorému kľúču, operácia informáciu o chybe zaznamená a pokračuje pridávaním podľa ďalších kľúčov.

Ak dôjde k zlyhaniu aspoň pri jednom kľúči, operácia na záver preruší update a zobrazí vyššie uvedené chybové hlásenie.

V texte chyby sú uvedené informácie o chybách k jednotlivým kľúčom, pre ktoré sa indexy nepodarilo vytvoriť.

Príklad chyby:

Pri vykonanie databázovej operácie došlo k chybe.
Id operácie: ANVHXITT3GZOJDOUUETGTH2KLC
Názov operácie: Aktualizácia indexov v databáze podľa kľúčov na business objekte.
Text chyby:
Nepodarilo sa aktualizovať niektoré indexy:

Tabuľka: Firms
Kľúč: A.OrgIdentNumber
Chybové hlásenie: [Chyba pri prístupe k databáze
"Dynamic SQL Error
SQL error code = -303
arithmetic exception, numeric overflow, or string truncation string right truncation
expected length 31, actual 35"
SQL príkaz:
select
IndexName
from Nx$Indexes
where
TableName = ?TableName
and ((ColumnName = ?ColumnName) or (UPPER(Expression) = UPPER(?ColumnName)))
and ((ColumnPosition = ?ColumnPosition) or (ColumnPosition is NULL))
and IsAscending = ?IsAscending]

Tabuľka: StoreCards
Kľúč: X_HodneDlouheJmeno_Def_Polozky
Chybové hlásenie: [Error message: "Vážna chyba pri prístupe k databáze
CREATE INDEX IA_IMLIUQ2WZZXOXJ3RTSJGKA5MUW failed
unknown ISC error 336068726"
SQL príkaz:
CREATE UNIQUE INDEX IA_IMLIUQ2WZZXOXJ3RTSJGKA5MUW ON Firms (X_HodneDlouheJmeno_Def_Polozky, ID)]

Riešenie pre uvedený príklad:

Dokončiť update s vynechaním operácie s ID=ANVHXITT3GZOJDOUUETGTH2KLC podľa vyššie uvedeného postupu.
Zistiť, ktoré z vyššie uvedených typov kľúčov IA_, ID_ a IE_* chýbajú v databáze pre kľúče vypísané v texte chyby - tj. Firms.OrgIdentNumber, resp. StoreCards.X_HodneDlouheJmeno_Def_Polozky.
Pokiaľ chybu spôsobujú nevhodné vlastnosti položky, ku ktorej sa index vytvára (napr. príliš dlhý názov), tieto vlastnosti opraviť.
Skúsiť vytvoriť chýbajúce indexy priamo, napr. nástrojom DBTool.
Pokiaľ sa ani potom nepodarí index vytvoriť, je potrebné kontaktovať technickú podporu.