Update systému ABRA Gen (aktualizace instalace)

Ako bolo spomenuté 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ákladní možností, jak provést aktualizaci systému, je update. Update znamená prechod na vyššiu verziu systémuABRA Gen a mal by byť priebežne vykonávaný.

V následujícím textu budou uvedeny orientační instalační postupy pro převedení systému ABRA Gen na vyšší verzi. Pokud si nejste jistí kroky, které postupy obsahují, doporučujeme raději svěřit proces update do rukou servisního oddělení firmy ABRA Software s.r.o. nebo některému z jejích partnerů.

Update od v. 10.02 probíhá tzv. inkrementálním způsobem.

O inkrementálním Update

Základné pojmy inkrementálneho update

Inkrementální update - Aktualizace programu, která realizuje změny datových struktur a úpravy dat přímo nad existující databází a zároveň přináší změny chování aplikační 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 prebiehajú zmeny nad "živou" databázou užívateľa.
Operácia – Čiastková zmena databázy definovaná v UpdateListe. Operáciou môže byť napr. zmena tabuľky, pridanie stĺpca tabuľky alebo tiež 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 (na riešenie inkrementálneho update):
- UpdateDB.DBO – Súbor databázových operácií. Obsahuje príkazy na zmenu aktuálnej databázy. Tzn. 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. nahrania 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 aktuálnej 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 uží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.
Datový update (neboli update dat) – Ta část inkrementálního update, při které dochází k aplikaci operací 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 užívateľ začiarkne 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 pre fungovanie tohto modulu. Pri doinštalácii modulu dochádza aj k iným činnostiam, ale pre objasnenie inkrementálneho update je podstatné práve vytvorenie dátovej základne daného modulu. Pre účely objasnenia update budeme preto doinštaláciou modulu označovať iba vytvorenie týchto databázových objektov.
Metadáta – Viď Metadáta.
Závislosti – Tu sa myslia závislosti v databáze. Databázové objekty sú navzájom prepojené, majú medzi sebou väzby, sú preto na sebe závislé. Trigger je napríklad závislý na svojej tabuľke. Bez nej nemôže existovať (príp. nemôže existovať vo validnom stave). Podobne i procedúry, ak majú v svojom tele použité stĺpce tabuliek, stávajú sa na týchto stĺpcoch závislé. A pod.

Princíp inkrementálneho update

Update systému ABRA Gen na vyšší verzi obecně znamená jednak nahrazení programových souborů novými (nahrazení binárních souborů a jejich registrace) a jednak případnou úpravu databáze (struktury databáze a dat v ní uložených) tak, aby odpovídala vyšší verzi.

Instalační program tedy při volbě Aktualizace existující instalace provede nahrazení programových souborů systému Systém ABRA Gen novějšími a dále nastaví existující spojení na databáze do stavu Update. Při následném spuštění systému ABRA Gen a výběru spojení na databázi (což může v rámci procesu "aktualizace instalace" proběhnout automaticky, viz Krok - Dokončení instalace) se spustí proces datové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. Provádí změny datových struktur a úpravy dat přímo nad existující databází.

Vzhledem k tomu, že uživatelé mohou mít vlastní databázové objekty, které jsou závislé na databázových objektech systému ABRA Gen, bude docházet k tomu, že na různých datech různých klientů bude tento "datový update" generovat různě velkou množinu příkazů. O. i. od toho sa bude odvíjať aj doba jeho vykonania.

Vykonané operácie sa logujú do databázy do špeciálnej tabuľky, ktorá je na to určená, vrátane verzie a príznaku, či bola operácia dokončená. To je dôležité preto, aby systém mohol v procese dátového update pokračovať, pokiaľ 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 užívateľ informovaný jednak o chybovom hlásení databázy, jednak o tom, ktorá 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. (Jiná věc je, jak mohlo k takové situaci dojít, jaké zásahy byly do databáze provedeny mimo systém ABRA Gen, které mohly toto způsobit atd. Od toho sa bude odvíjať aj spôsob riešenia daného problému.)

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

Podrobnější informace naleznete v tipu Řešení pádů datového update.

Vykonanie operácie môže riešiť a často aj rieši nejaké závislosti. Väčšinou sa to rieši 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. Čiastkové kroky operácie nebežia v transakcii – databáza ani transakčné spracovanie DDL nepodporuje. Program si ale odstránené objekty samozrejme zaznamenáva a je schopný naviazať presne tam, kde prestal. Z tohto vyplýva, že operáciu je možné prerušiť, ale je ju potrebné dokončiť. Nie je ju možné vynechať, napr. zásahom do UpdateListu (užívateľsky to ani nie je umožnené), i keď vynechanie problematickej operácie sa ponúka ako zdanlivo najjednoduchšie riešenie. Mohlo však už v rámci nej dôjsť k nejakým úpravám závislostí a nedokončenie operácie by tak mohlo spôsobiť budúce problémy. Pri servisnom riešení problémov je potrebné tento princíp správne chápať!

Počet změn, které je možné provést se strukturou jedné tabulky do doby zálohy a obnovy databáze, je omezen (cca 255). Z toho plynie, že nie je možné donekonečna robiť inkrementálny update na nové verzie bez toho, aby sa niekedy neurobila aj obnova dát, pri ktorej sa vytvorí databáza nová. Dá sa však predpokladať (vzhľadom k malému počtu takýchto zmien), že táto potreba nastane raz za niekoľko rokov. Užívateľ sa tým preto zatiaľ nemusí nijako znepokojovať.

Update vs. (ne)registrované moduly - Datový update updatuje všechny tabulky, které v databázi najde, bez ohledu na to, jestli daný modul je či není aktuálně registrován v repozitoři systému ABRA Gen. (K tomu môže dôjsť napr. tak, že užívateľ si nenainštaluje všetky moduly (takže ich nemá registrované v repository)), ale do danej inštalácie si obnoví dáta zo zálohy, ktorá daný modul obsahovala. Čili systém ABRA Gen se bude externě chovat, jakoby tam modul nebyl, ale v databázi jsou tabulky daného modulu obsaženy a standardně podléhají procesu datového update.)

Prvé spustenie po update

Je-li v kroku Dokončení instalace zatrženo "Spustit systém ABRA Gen", systém se spustí a rovnou se provede datový update. (Všetky spojenia (ak ich máte niekoľko) by mali byť v stave Update (ak medzitým nedošlo k zásahu zvonku 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 prebehnutí sa spojení prepne do stavu OK. Následuje přihlášení uživatele do systému.

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

Ak máte definovaných niekoľko spojení na databázy (tzn. napr. vlastníte licenciu (aktivačný kľúč) na multiverziu a v systéme vediete viacero firiem), tak vyššie uvedený proces prebehne automaticky pre všetky databázy. Viď tiež Príprava multiverzie na prevádzku po novej inštalácii resp. po update. Následne sa zobrazí dialóg na výber spojenia na databázu, všetky spojenia by mali byť v stave OK. Po výběru spojení následuje přihlášení uživatele do systému

V prípade update sa prihlasovanie do jednotlivých spojení vykonáva automaticky a nečaká sa na prihlásenie užívateľa, aby ho bolo možno i v prípade multiverzie automaticky realizovať napr. v noci, bez zásahu obsluhy.

Pokud první spuštění ABRA Gen s jednoduchým účtovníctvom resp. ABRA Gen s podvojným účtovníctvom po aktualizaci instalace a přihlášení se do daného spojení neprovedete (tj. není-li v kroku Dokončení instalace zatrženo "Spustit systém ABRA Gen"), pak spojení zůstane ve stavu Update a datový update dané databáze proběhne až později, a to až při dalším spuštění systému vyvolaném jiným způsobem a po přihlášení se do daného spojení na databázi. Po spustení systému sa potom zobrazí dialóg na výber spojenia na databázu podobný nasledujúcemu:

Príklad vzhľadu okna na výber spojenia na databázu po inštalácii update, ak systém nebol spustený ihneď v rámci dokončenia inštalácie update, ale až neskôr iným spôsobom. Zatiaľ teda nedošlo k realizácii 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. zda nedošlo např. k nasazení ABRA Gen s jednoduchým účtovníctvom na ABRA Gen s podvojným účtovníctvom nebo obráceně. Pokiaľ by k takej situácii došlo, systém nahlási chybu. Pokiaľ 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, systém je v stave Trial verzie resp. demoverzie, bližšie viď Stavy systému z hľadiska aktivácie a Ako zistiť stav aktivácie.

ABRA Gen s jednoduchým účtovníctvom resp. ABRA Gen s podvojným účtovníctvom, která se má aktualizovat, nesmí být současně spuštěna.

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 o. i. 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 pokiaľ áno, inštaláciu nevykoná.

Ďalšie akcie spojené s update

S provedením update systému ABRA Gen, mohou souviset i některé další kroky, které je potřeba nebo které je minimálně doporučeno provést:

Nutné: Aktualizácia súborov potrebných pre webové služby, ak ich používate, 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é: Spustit proceduru SelectivityMaintenance. Prepočítava selektivitu indexov a môže v častých prípadoch pomôcť urýchliť odozvu systému.
Príklad spustenia procedúry v programe DBTool.exe:

Firebird:
```
EXECUTE PROCEDURE SELECTIVITYMAINTENANCE(1)
```
Odporúčané: Restartovat terminálový server, pokud provozujete systém ABRA Gen v terminálovém režimu.

Ďalej platí:

Přeinstalovávat všechny služby ABRA Gen ve Windows, tedy aplikační server AppServer, Autoserver apod. není nutné. (Ak sa nezmenil ich názov alebo cesta. Ide totiž iba o zápis do registra, nič viac.)
Pokud spolu s přechodem na vyšší verzi systému ABRA Gen provádíte i přechod mezi instalacemi či na jiný produkt ABRA Gen, postup viz Přechod mezi systémy ABRA Gen, zejména, pokud jste v původní instalaci měli nějaké vlastní zákaznické úpravy.

Ďalej odporúčame:

věnovat pozornost Změnám ve verzích.
věnovat maximální pozornost servisním informacím zobrazovaným po spuštění nové verze ABRA Gen (jelikož ne všechny úpravy v datech lze zajistit automaticky v rámci update a mnohdy je rovněž nutný nějaký ruční zásah uživatele)!!!

TIP - Řešení pádů datového update

Tip je určen pro velmi pokročilé uživatele a správce systému. V případě nejistoty kontaktujte konzultanty obchodního či servisního oddělení dodavatele.

Popis situace a obecný postup řešení problému

Během provádění inkrementálního update může dojít k chybě v některé operaci ze seznamu AfterUpdateDB.DBO, AfterRestoreDB.dbo nebo AfterRestoreFromBackupDB.dbo. Update se přeruší a zobrazí se chybové hlášení:

Při vykonání databázové operace došlo k chybě.
Id operace: ID operace
Název operace: název operace
Text chyby: text chyby

Okno s hlášením umožňuje zopakovat operaci, při které chyba nastala, nebo update přerušit. Opakování operace zpravidla situaci nevyřeší a je tedy třeba update přerušit.

V některých případech podle závažnosti a typu nahlášené chyby je možné zvolit jeden z následujících postupů:

Nápravu situace, která brání provedení operace, zajistit na databázové úrovni (např. s pomocí nástroje DBTool). Po opravě znovu spustit a dokončit update.
Dokončit update s vynecháním chybové operace (viz níže) a nápravu v databázi provést později.

Před vynecháním operace je nutné vědět, co daná operace řeší a jak je možné její obsah a průběh nahradit jiným způsobem! Pouhé vynechání operace není řešením problému, jedná se jen o možnost, jak dočasně přeskočit chybu a problém dořešit následně.

Vynechání operace lze provést následovně:

Spustit nástroj DBOperations.exe.
Pomocí volby Soubor→Otevřít načíst obsah souboru After*.DBO (typicky AfterUpdateDB.dbo).

Chyby operací z jiných seznamů, jejichž název nezačíná prefixem After*, není vhodné řešit touto cestou.
V načteném seznamu vyhledat chybovou operaci podle ID operace z chybového hlášení (pokud operaci nenaleznete, znamená to, že se nachází v jiném *.DBO souboru).
Operaci ze seznamu vymazat nebo na záložce Podmínka přidat podmínku, která nikdy nebude splněna – např. zvolit možnost „Systémy Abry“ a nezatrhnout žádnou volbu.
Soubor uložit.
Zavřít nástroj DBOperations.exe.
Znovu spustit update.

Možnost řešení konkrétní chyby operace "Aktualizace indexů v databázi podle klíčů na business objektu"

Následující popis uvádí řešení konkrétního problému v rámci operace Aktualizace indexů v databázi. Tato operace je součástí seznamu AfterUpdateDB.DBO.

Operace přidává do databáze indexy podle klíčů vybraných business objektů následovně:

ke každému klíči přidá unikátní index s prefixem IA_ v názvu, řazený vzestupně, index je složený z položky klíče a ID
ke každému klíči přidá unikátní index s prefixem ID_ v názvu, řazený sestupně, index je složený z položky klíče a ID
ke každému řetězcovému klíči přidá expression index s prefixem IE_ v názvu, řazený vzestupně, index obsahuje výraz UPPER(<položka klíče>)

Tyto indexy urychlují přístup k datům nových číselníků.

Pokud selže přidání některého indexu k některému klíči, operace informace o chybě zaznamená a pokračuje přidáváním podle dalších klíčů.

Dojde-li k selhání alespoň u jednoho klíče, operace na závěr přeruší update a zobrazí výše uvedené chybové hlášení.

V textu chyby jsou uvedeny informace o chybách k jednotlivým klíčům, pro které se indexy nepodařilo vytvořit.

Příklad chyby:

Při vykonání databázové operace došlo k chybě.
Id operace: ANVHXITT3GZOJDOUUETGTH2KLC
Název operace: Aktualizace indexů v databázi podle klíčů na business objektu.
Text chyby:
Nepodařilo se aktualizovat některé indexy:

Tabulka: Firms
Klíč: A.OrgIdentNumber
Chybové hlášení: [Chyba při přístupu k databázi
"Dynamic SQL Error
SQL error code = -303
arithmetic exception, numeric overflow, or string truncation string right truncation
expected length 31, actual 35"
SQL pří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]

Tabulka: StoreCards
Klíč: X_HodneDlouheJmeno_Def_Polozky
Chybové hlášení: [Error message: "Vážná chyba při přístupu k databázi
CREATE INDEX IA_IMLIUQ2WZZXOXJ3RTSJGKA5MUW failed
unknown ISC error 336068726"
SQL příkaz:
CREATE UNIQUE INDEX IA_IMLIUQ2WZZXOXJ3RTSJGKA5MUW ON Firms (X_HodneDlouheJmeno_Def_Polozky, ID)]

Řešení pro uvedený příklad:

Dokončit update s vynecháním operace s ID=ANVHXITT3GZOJDOUUETGTH2KLC podle výše uvedeného postupu.
Zjistit, které z výše uvedených typů klíčů IA_, ID_ a IE_* chybí v databázi pro klíče vypsané v textu chyby - tj. Firms.OrgIdentNumber, resp. StoreCards.X_HodneDlouheJmeno_Def_Polozky.
Pokud chybu způsobují nevhodné vlastnosti položky, ke které se index vytváří (např. příliš dlouhý název), tyto vlastnosti opravit.
Zkusit vytvořit chybějící indexy přímo, např. nástrojem DBTool.
Pokud se ani poté nepodaří index vytvořit, je třeba kontaktovat technickou podporu.