Update systému ABRA Gen (aktualizace instalace)

Jak bylo řečeno v úvodní kap. Aktualizace systému ABRA Gen (update a jiné aktualizace), systém ABRA Gen se neustále vyvíjí a měl by být průběžně aktualizován. Základní možností, jak provést aktualizaci systému, je update. Update znamená přechod na vyšší verzi systémuABRA Gen a měl by být průběžně prováděn.

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 a.s. 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álního 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) – viz Databázové objekty.
UpdateList – změny databázových objektů, které výrobce v rámci vývoje nové verze provede, se zaznamenávají (u výrobce) do tzv. UpdateListu. Tento UpdateList se stává součástí instalace verze a na jeho základě se provádí změny nad "živou" databází uživatele.
Operace – Dílčí změna databáze definovaná v UpdateListu. Operací může být např. změna tabulky, přidání sloupce tabulky nebo také přidání inicializačních dat apod.
Datové konverze – speciální operace měnící data v databázi. Typicky SQL příkaz "update" nebo sada SQL příkazů měnící data bez ovlivnění datové struktury.
Dodávané soubory v rámci instalace (pro řešení inkrementálního update):
- UpdateDB.DBO – Soubor databázových operací. Obsahuje příkazy pro změnu stávají databáze. Tj. vlastně obsahuje operace z UpdateListu.
- CreateDB.DBO – Soubor databázových operací. Obsahuje operace pro vytvoření nové prázdné databáze, vč. nahrání inicializačních dat či jiných dat dle kontextu. (Viz např. popis stavu Nová databáze.)
- InitData.DBO - Soubor databázových operací. Obsahuje operace pro naplnění nové databáze inicializačními daty.
- InstallDB.DBO - Soubor databázových operací. Obsahuje příkazy, které se provedou v rámci instalace nového modulu do existující instalace (doplní data nově instalovaného modulu tak, aby odpovídala stávající instalaci).
- ExternalData.DAT- Soubor databázových operací. Pomocný soubor pro soubory DBO. Obsahuje data pro příkazy nad tabulkou (vložení a změna, využívá se hlavně pro inicializační data). Obsahuje SQLite3 databázi s aktuálními verzemi reportů, exportů, B2Bexportů a uživ. definovatelných formulářů, které se nahrávají v rámci inicializačních dat či v rámci změn v UpdateListu.
Datový update (neboli update dat) – Ta část inkrementálního update, při které dochází k aplikaci operací UpdateListu. Datový update provádí tzv. DDL příkazy modifikující strukturu databáze a příkazy modifikující data (datové konverze).
Doinstalace modulu – Pokud při aktualizaci programu zaškrtne uživatel instalaci modulu, který do té doby nainstalovaný nebyl, dojde v rámci datového update mimo jiné k vytvoření objektů databáze potřebných pro fungování tohoto modulu. Při doinstalaci modulu dochází k provedení i jiných činností, ale pro objasnění inkrementálního update je podstatné právě vytvoření datové základny daného modulu. Proto pro účely objasnění update budeme nazývat doinstalací modulu jen vytvoření těchto databázových objektů.
Metadata – Viz Metadata.
Závislosti – Zde myšleno závislosti v databázi. Databázové objekty jsou navzájem propojené, mají mezi sebou vazby, a proto jsou na sobě závislé. Trigger je například závislý na své tabulce. Bez ní nemůže existovat (příp. nemůže existovat ve validním stavu). Stejně tak procedury, pokud mají ve svém těle použité sloupce tabulek, stávají se na těchto sloupcích závislé. Apod.

Princip inkrementálního 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. Datový update čte operace ze souboru UpdateDB.DBO a operace postupně v příslušné databázi provádí. Provádí změny datových struktur a úpravy dat přímo nad existující databází. Tedy, od v. 10.02 vč. platí, že se v rámci update nevytváří nová databáze.

Do v. 10.01. vč. se v rámci procesu update vždy vytvářela databáze nová. Do ní bylo nutné provádět obnovu dat a jejich následný update. Byla tedy nutná aktuální záloha dat. Proces update vč. zálohy a obnovy dat byl časově velmi náročný. Dále viz též Výhody inkrementálního update.

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ů. Mj. od toho se bude odvíjet doba jeho provedení.

Provedené operace se logují do databáze do speciální tabulky k tomu určené, včetně verze a příznaku, zda byla operace dokončena. To je důležité proto, aby mohl systém v procesu datového update pokračovat, dojde-li z nějakého důvodu k jeho přerušení. Pokud při datovém update dojde k chybě, objeví se dialogové okno Řešení problému, ve kterém je uživatel informován jednak o chybovém hlášení databáze a dále pak o tom, jaká operace chybu způsobila:

Příklad zobrazení informace o chybě vzniklé v průběhu datového update. Operace se pokouší přidat databázový objekt (doménu), který již v databázi 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 se bude odvíjet i způsob řešení daného problému.)

V takovém případě je možné Update přerušit, zajistit nápravu v existující databázi a spustit datový update znovu. Program má evidováno, které operace již byly provedené - ty znovu neprovádí, ale naváže v místě, kde k přerušení došlo.

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

2020-05-04: Tip není zapodmínkovaný proto, že by v CH verzi neplatil, ale protože se ho zřejmě nevyplatí překládat.

Provedení operace může řešit a často také řeší nějaké závislosti. Většinou se řeší tím způsobem, že závislé objekty se odstraní a po změně, jež je předmětem operace, se všechny závislé objekty opět vytvoří. Dílčí kroky operace neběží v transakci – databáze ani transakční zpracování DDL nepodporuje. Ovšem program si odstraněné objekty samozřejmě zaznamenává a je schopný navázat přesně tam, kde přestal. Z tohoto vyplývá, že operaci je možné přerušit, ale je třeba ji dokončit. Není možné ji vynechat, např. zásahem do UpdateListu (uživatelsky to ani umožněno není), i když vynechání problematické operace se nabízí jako zdánlivě nejjednodušší řešení. Nicméně v rámci ní už mohlo dojít k nějakým úpravám závislostí a tudíž nedokončení operace by mohlo způsobit budoucí potíže. Při servisním řešení problémů je třeba tento princip správně chápat!

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 plyne, že nelze donekonečna provádět inkrementální update na nové verze, aniž by se někdy udělala také obnova dat, při které se vytvoří databáze nová. Nicméně se dá předpokládat (vzhledem k malému počtu takových změn), že tato potřeba nastane jednou za několik let. Tudíž se tímto uživatel zatím nemusí nijak znepokojovat.

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 dojít např. tak, že uživatel si nenainstaluje všechny moduly (tudíž je nemá registrované v repozitoři)), ale do dané instalace si obnoví data ze zálohy, která 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.)

Update verze, která nepodporovala inkrementální update

Vzhledem k tomu, že popsaný systém zaznamenávání operací do UpdateListu za účelem realizace inkrementálního update byl spuštěn od verze 10.01.08 (CZ), je možné přejít na verzi 10.02 a vyšší pouze z verze 10.01.08, příp. z verze 10.01.01 s SA2.11-CZ, která s ní byla datově kompatibilní. Z žádné jiné!!! Z toho vyplývá i doporučený postup při update z verze, která inkrementální update nepodporovala, viz dále.

Provést update na výchozí verzi, z níž bude možné provést update na verzi podporující inkrementální update. Tj. na verzi 10.01.08 nebo alespoň 10.01.01 SA2.11-CZ. A to způsobem platným pro provádění update resp. provádění aktualizací, který byl platný do verze 10.01 včetně.
Provést bezpečnostní zálohu datve verzi 10.01.08 resp. 10.01.01 SA2.11-CZ. Tato záloha dat je sice od v. 10.02 a vyšší nepoužitelná, ale pro případ, že by se update nepodařilo z nějakého důvodu provést, je potřeba mít možnost se k verzi 10.01.08 dočasně vrátit.
Provést update.
Provést zálohu. První použitelná bezpečnostní záloha dat, použitelná pro případ nějaké havárie ve verzi 10.02.

Inkrementální update, jak bylo výše řečeno, vyžaduje přejít přes verzi 10.01.08 resp. 10.01.01 SA2.11-CZ. To je ale jediné omezení. Nadále nebude nutné, stejně tak jako tomu nebylo ani v minulosti, instalovat každou vydanou verzi. Je možné verze přeskakovat. Z verze 10.01.08 se může provést update jak na verzi 10.02 tak na libovolnou verzi vyšší. UpdateList obsahuje vždy veškeré operace. Instalační program si z nich vybere takovou množinu operací, která je rozdílem původní updatované verze a verze nově instalované.

První spuštění 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šechna spojení (pokud jich máte více) by měla být ve stavu Update (pokud mezitím nedošlo k zásahu z vnější pomocí nástroje DbAdmin)). Podrobněji viz výše Princip inkrementálního update nebo též stavy databázového spojení - stav Update. Po jeho úspěšném provedení se spojení přepne do stavu OK. Následuje přihlášení uživatele do systému.

Dialog pro výběr spojení na databázi se v tomto případě nezobrazuje (jelikož existuje jen jedno spojení a to je ve stavu OK, zobrazování dialogu by tedy bylo zbytečné).

Pokud máte definováno více spojení na databáze (tj. např. vlastníte licenci (aktivační klíč) na multiverzi a v systému vedete více firem), pak se výše uvedený proces provede automaticky pro všechny databáze. Viz též Příprava multiverze k provozu po nové instalaci resp. po update. Poté se zobrazí dialog pro výběr spojení na databázi, všechna spojení by měla být ve stavu OK. Po výběru spojení následuje přihlášení uživatele do systému

V případě update se přihlašování do jednotlivých spojení provádí automaticky a nečeká se na přihlášení uživatele, aby bylo možno jej i v případě multiverze automaticky provádět např. přes noc, bez zásahu obsluhy.

Pokud první spuštění ABRA Gen s daňovou evidencí resp. ABRA Gen s podvojným účetnictvím 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. Pak se po spuštění systému zobrazí dialog pro výběr spojení na databázi obdobný následujícímu:

Příklad vzhledu okna pro výběr spojení na databázi po instalaci update, pokud nebyl systém spuštěn ihned v rámci dokončení instalace update, ale až později jiným způsobem. Tudíž zatím nedošlo k provedení datového update a spojení zůstalo ve stavu Update. K update databáze dojde až po přihlášení do daného spojení.

Po stisku tlačítka OK se při tomto prvním přihlášení do daného spojení po instalaci update provede kontrola, zda souhlasí verze produktu. Tj. zda nedošlo např. k nasazení ABRA Gen s daňovou evidencí na ABRA Gen s podvojným účetnictvím nebo obráceně. Pokud by k takové situaci došlo, systém nahlásí chybu. Pokud proběhne kontrola v pořádku, provede se datový update příslušné databáze.

Z hlediska aktivace je systém ve stavu ostré verze, pokud správně proběhla aktivace instalace. Pokud ne, je systém ve stavu Trial verze resp. demoverze, blíže viz Stavy systému z hlediska aktivace a Jak poznat stav aktivace.

ABRA Gen s daňovou evidencí resp. ABRA Gen s podvojným účetnictvím, která se má aktualizovat, nesmí být současně spuštěna.

Od v. 3.01.16 si systém při svém spuštění vytváří tzv. mutex (objekt jádra, který musí vytvořit instalační program při svém spuštění), který nese mj. informaci o cestě, ze které byl spuštěn. Instalační program pak po výběru adresáře pro instalaci kontroluje, zda mutex s vybranou cestou existuje a pokud ano, instalaci neprovede.

Další akce 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:

Nutno: Aktualizace souborů potřebných pro webové služby, pokud je provozujete, více viz Web. služby a update
Doporučeno: Kontrola aktuálnosti Udf knihoven, více viz Doinstalované Udf knihovny
Doporučeno: Spustit proceduru SelectivityMaintenance. Přepočítává selektivitu indexů a může v častých případech pomoci zrychlit odezvu systému.
Příklad spuštění procedury v programu DBTool.exe:

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

Dále platí:

Přeinstalovávat všechny služby ABRA Gen ve Windows, tedy aplikační server AppServer, Autoserver apod. není nutné. (Pokud se nezměnil jejich název nebo cesta. Jedná se totiž jen o zápis do registru, nic více.)
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.

Dále doporučujeme:

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.