Ďalšie akcie spojené s inštaláciou (UDF knižnice a pod.)

V rámci inštalácie ABRA Gen s jednoduchým účtovníctvom resp. ABRA Gen s podvojným účtovníctvom prebieha automaticky niekoľko súvisiacich akcií. Tu zmienime nasledujúce:

Pre správny chod systém ABRA Gen s jednoduchým účtovníctvom resp. ABRA Gen s podvojným účtovníctvom vyžaduje, aby v ceste inštalácie Firebird v podadresári UDF (napr. c:\Program Files\Firebird\Firebird_2_5\UDF\) boli k dispozícii Udf knižnice (súbory nxudf*.dll resp. libnxudf*.so) zodpovedajúcej verzie alebo verzie kompatibilnej. Tieto udf knižnice s deklaráciami doplnkových funkcií pre FB sú nutné na spustenie niektorých agend ABRA Gen s jednoduchým účtovníctvom resp. ABRA Gen s podvojným účtovníctvom(napr. Kniha majetku spätne k dátumu, funkcie využívané pri Zaúčtovaní žiadostí a pod.)

Popis Udf funkcí viz kap. Zoznam UDF funkcií (užívateľsky definovaných funkcií).

V inštalácii sú k dispozícii jednak 32-bitové, tak 64-bitové UDF verzie príslušných knižníc.

Inštalačný program ABRA Gen tieto knižnice inštaluje automaticky vždy pri inštalácii novej verzie (32bit i 646bit). Inštalačný program nainštaluje Udf knižnice vždy znova, tzn. aj keby už na danom počítači boli inštalované z inej inštalácie, potom ich prepíše príslušnou verziou z inštalácie. Udfs knižnice sú spätne kompatibilné, tzn. staršie verzie ABRA Gen s jednoduchým účtovníctvom resp. ABRA Gen s podvojným účtovníctvom dokážu pracovať s novšími verziami Udf knižníc. Opačne to ale neplatí!

Tzn., že pokiaľ na jednom počítači prevádzkujete staršiu verziu ABRA Gen s jednoduchým účtovníctvom resp. ABRA Gen s podvojným účtovníctvom a nainštalujete si novšiu verziu (napr. ako demoverziu), bude staršia verzia s novšou verziou Udf knižníc bez problémov pracovať. Pokiaľ by ste ale prevádzkovali novšiu verziu ABRA Gen s jednoduchým účtovníctvom resp. ABRA Gen s podvojným účtovníctvom a potom si nainštalovali staršiu verziu, novšia verzia ABRA Gen s jednoduchým účtovníctvom resp. ABRA Gen s podvojným účtovníctvom by v agendách využívajúcich funkcie z Udf knižníc mohla vykazovať chyby. Viď taktiež Často kladené otázky a odpovede - otázka Začali sa mi objavovať chyby typu "function XY is not defined". Ďalej viď Odinštalácia ABRA Gen s jednoduchým účtovníctvom resp. ABRA Gen s podvojným účtovníctvom.

Udf knižnice sa automaticky inštalujú pri inštalácii - defaultne do cesty inštalácie FB. Ak sú umiestnené inde, musí k nim byť zadaná príslušná cesta v konfiguračnom súbore FB.

Po update ABRA Gen je odporúčané vykonať kontrolu aktuálnosti príslušných súborov. Viď Ďalšie akcie spojené s inštaláciou novej verzie (update) ABRA Gen.

Ak ste inštalovali novú verziu Firebird s tým, že inštalačný program novej verzie ABRA Gen ešte neprebehol, pretože najskôr potrebujete spustiť systém ABRA Gen v pôvodnej verzii a vykonať obnovu dát (aby najskôr došlo k zvýšeniu čísla ODS databázy a mohli ste pokračovať v procese update ABRA Gen), musíte si tieto knižnice do príslušného adresára nakopírovať ručne! Súbory nxudf*.dll resp. libnxudf*.so nájdete v ceste inštalácie systému ABRA Gen v podadresári udfs (podľa použitého databázového servera Firebird, napr. ABRAGx\udfs\Win32\).

Pro správný chod systém ABRA Gen s jednoduchým účtovníctvom, resp. ABRA Gen s podvojným účtovníctvom vyžaduje, aby v cestě instalace Firebird (např. c:\Program Files\Firebird\Firebird_3_0\) byly k dispozici ICU knihovny (soubory icudt69.dll, icuin69.dll a icuuc69.dll) odpovídající verze nebo verze kompatibilní. Tyto ICU knihovny jsou nutné pro správnou funkčnost databáze Firebird s kódováním Unicode, tedy od verze ABRA Gen 22.1 a vyšší.

Instalační program ABRA Gen tyto knihovny instaluje automaticky vždy na závěr instalace nové verze. Instalační program nainstaluje ICU knihovny vždy znovu, tj. i kdyby již na daném počítači byly instalovány z jiné instalace, pak je přepíše příslušnou verzí z instalace.

Po dokončení instalace je potřeba, aby se uživatel Windows, na kterém instalace probíhala odhlásil ze svého Windows účtu a následně se přihlásil. Tato operace aktivuje vytvoření proměnné do souboru firebird.msg, který je součástí instalace Firebird. To umožní následně v případě problémů lépe interpretovat chybové hlášky systému ABRA Gen.

V případě, že po dokončení instalace neproběhne odhlášení z účtu Windows a dojde při spuštění ABRA Gen k nějaké chybě, budete v rámci chybového hlášení upozornění na aktivaci proměnné v souboru firebird.msg.

Zobrazená chyba obsahuje informaci o tom, že podrobnosti o chybě je možné zobrazit až po aktivaci proměnné v souboru firebird-msg.

ICU knihovny se instalují pouze v případě operačního systému Windows. V rámci operačního systému Linux jsou již knihovny součástí instalace databázového serveru Firebird.

Ve výjimečných případech se může stát, že bude potřeba doinstalovat ICU knihovny ručně. Tyto případy mohou nastat zejména, kdy z nějakého důvodu nedoběhne proces instalace do konce, nebo je instalátor z nějakého důvodu přerušen a instalace ICU knihoven v takovém případě nenastane. V takovém případě je potřeba provést následující postup:

1) Vyhledejte složku, kde máte ABRA Gen nainstalovanou. Zde najdete podadresáře distrib a icu. Například C:\AbraGen\distrib\icu\. Z tohoto adresáře je potřeba zkopírovat všechny soubory (podle verze aplikačního serveru si vyberte složku s 32-bit nebo 64-bit soubory) do složky, kde máte instalován databázový server Firebird, např. C:\Program Files\Firebird\Firebird_3_0\

2) V dalším kroku je potřeba v adresáři s instalovaným databázovým serverem najít podadresář intl, např. C:\Program Files\Firebird\Firebird_3_0\intl a zde soubor fbintl.conf. Soubor otevřete například v Poznámkovém bloku pro editaci a na začátek souboru doplňte následující text: 

intl_module = builtin {
	icu_versions = 6.9 default
}

3) Nyní je nutný restart databázového serveru Firebird. Poté proveďte ještě odhlášení z účtu Windows a následně se do něj opět přihlaste. Tato operace je nutná z důvodu vytvoření proměnné ve Windows do souboru firebird.msg. Tato proměnná pomáhá při následných problémech lépe interpretovat chyby v chybových hlášeních.

Po inštalácii sa vykonajú o. i. nasledujúce záznamy, ktoré sú potom používané na predvypĺňanie pri následných inštaláciách alebo je podľa nich vykonávaná odinštalácia:

  • Záznam v Pridať/Odobrať programy - pridá sa jeden záznam z ABRA Gen s jednoduchým účtovníctvom resp. ABRA Gen s podvojným účtovníctvom do zoznamu aktuálne nainštalovaných programov v Pridať/Odobrať programy, pričom platí, že v zozname Pridať/Odobrať programy je vždy len jeden záznam, a to ten, ktorý ukazuje na poslednú uskutočnenú inštaláciu, a to aj v prípade, že máte viacero inštalácií ABRA Gen s jednoduchým účtovníctvom resp. ABRA Gen s podvojným účtovníctvom! Objasníme na príklade:

    Majme inštaláciu ABRA Gen s jednoduchým účtovníctvom resp. ABRA Gen s podvojným účtovníctvom, ktorú si označíme ako ABRA-Demo, v registroch a v Pridať/Odobrať programy je len jeden záznam ukazujúci na ABRA-Demo. Potom si nainštalujeme systém druhý raz (ale nie ako update pôvodnej inštalácie, ale ako novú samostatnú inštaláciu do iného adresára) a označíme si ju ako ABRA-Ostrá. Záznamy v registri a v Pridať/Odobrať programy sa prepíšu údajmi poslednej inštalácie, tzn. ukazujú na ABRA-Ostrá. Pozor, v takom prípade pri odobraní z Pridať/Odobrať programy by sa odobrala ABRA-Ostrá (ďalej viď odinštalácia).

    V Pridať/Odobrať programy sa môže teoreticky vyskytovať aj viac zástupcov ABRA Gen s jednoduchým účtovníctvom resp. ABRA Gen s podvojným účtovníctvom, a to vtedy, pokiaľ ste predtým uskutočnili viacero inštalácií starších verzií ABRA Gen s jednoduchým účtovníctvom resp. ABRA Gen s podvojným účtovníctvom(v. 2.xx). Pokiaľ ste však mali inštaláciu verzie 2.xx a teraz ste vykonali jej update na v.3.xx, jej záznam sa zaktualizuje a nezdvojí.

  • Záznamy do souboru Unins000.dat a do registrů - do speciálního souboru Uninst000.dat v adresáři instalace se zapíší aktuální údaje o poslední instalaci, mj. název složky v menu Start apod. Ďalej sa niektoré dôležité údaje z poslednej inštalácie zapíšu aj do registrov (ako napr. cesta k odinštalačnému programu, potrebná na odinštaláciu a nájdenie zodpovedajúceho súboru Unins000.dat).