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

Obsah tejto kapitoly nemá pre systém ABRA Gen pre ORACLE, resp. ABRA Gen pre MSSQL význam.

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 spomenieme 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 kompatibilnej verzie. 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 funkcií viď kap. Zoznam UDF funkcií (používateľsky definovaných funkcií).

V inštalácii sú k dispozícii tak 32-bitové, ako aj 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 aj 646bit). Inštalačný program nainštaluje Udf knižnice vždy znova, tj. aj keby už na danom počítači boli nainštalované z inej inštalácie, potom ich prepíše príslušnou verziou z inštalácie. Udf knižnice sú spätne kompatibilné, tj. staršia verzia ABRA Gen s jednoduchým účtovníctvom resp. ABRA Gen s podvojným účtovníctvom vie pracovať s novšou verziou 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ť. Ak 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, potom by novšia verzia ABRA Gen s jednoduchým účtovníctvom resp. ABRA Gen s podvojným účtovníctvom v agendách využívajúcich funkcie z Udf knižníc mohla vykazovať chyby. Viď tiež Často kladené otázky a odpovede - otázka Začali sa mi objavovať chyby typu "function XY is not defined". Ďalej viď Odinštalovanie 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 - predvolene do cesty inštalácie FB. Ak sú umiestnené inde, musí k nim byť zadaná zodpovedajúca cesta v konfiguračnom súbore FB.

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

Pokiaľ ste inštalovali novú verziu Firebird s tým, že inštalačný program novej verzie ABRA Gen zatiaľ 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\).

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 (napr. c:\Program Files\Firebird\Firebird_3_0\) boli k dispozícii ICU knižnice (súbory icudt69.dll, icuin69.dll a icuuc69.dll) zodpovedajúcej verzie alebo kompatibilnej verzie. Tieto ICU knižnice sú nutné na správnu funkčnosť databázy Firebird s kódovaním Unicode, teda od verzie ABRA Gen 22.1 a vyššej.

Inštalačný program ABRA Gen tieto knižnice inštaluje automaticky vždy na záver inštalácie novej verzie. Inštalačný program nainštaluje ICU knižnice vždy znovu, tj. aj keby už na danom počítači boli nainštalované z inej inštalácie, potom ich prepíše príslušnou verziou z inštalácie.

Po dokončení inštalácie je potrebné, aby sa používateľ Windows, na ktorom inštalácia prebiehala, odhlásil zo svojho Windows účtu a následne sa prihlásil. Táto operácia aktivuje vytvorenie premennej do súboru firebird.msg, ktorý je súčasťou inštalácie Firebird. To umožní následne v prípade problémov lepšie interpretovať chybové hlásenia systému ABRA Gen.

V prípade, že po dokončení inštalácie neprebehne odhlásenie z účtu Windows a dôjde pri spustení ABRA Gen k nejakej chybe, budete v rámci chybového hlásenia upozornení na aktiváciu premennej v súbore firebird.msg.

Zobrazená chyba obsahuje informáciu o tom, že podrobnosti o chybe je možné zobraziť až po aktivácii premennej v súbore firebird-msg.

ICU knižnice sa inštalujú iba v prípade operačného systému Windows. V rámci operačného systému Linux sú už knižnice súčasťou inštalácie databázového servera Firebird.

Vo výnimočných prípadoch sa môže stať, že bude potrebné doinštalovať ICU knižnice ručne. Tieto prípady môžu nastať najmä, keď z nejakého dôvodu nedobehne proces inštalácie do konca, alebo je inštalátor z nejakého dôvodu prerušený a inštalácia ICU knižníc v takom prípade nenastane. V takom prípade je potrebné vykonať nasledujúci postup:

1) Vyhľadajte priečinok, kde máte ABRA Gen nainštalovanú. Tu nájdete podadresáre distrib a icu. Napríklad C:\AbraGen\distrib\icu\. Z tohto adresára je potrebné skopírovať všetky súbory (podľa verzie aplikačného servera si vyberte priečinok s 32-bitovými alebo 64-bitovými súbormi) do priečinka, kde máte nainštalovaný databázový server Firebird, napr. C:\Program Files\Firebird\Firebird_3_0\

2) V ďalšom kroku je potrebné v adresári s nainštalovaným databázovým serverom nájsť podadresár intl, napr. C:\Program Files\Firebird\Firebird_3_0\intl a tu súbor fbintl.conf. Súbor otvorte napríklad v Poznámkovom bloku na editáciu a na začiatok súboru doplňte nasledujúci text: 

intl_module = builtin {
	icu_versions = 6.9 default
}

3) Teraz je nutný reštart databázového servera Firebird. Potom vykonajte ešte odhlásenie z účtu Windows a následne sa doň opäť prihláste. Táto operácia je nutná z dôvodu vytvorenia premennej vo Windows do súboru firebird.msg. Táto premenná pomáha pri následných problémoch lepšie interpretovať chyby v chybových hláseniach.

Po inštalácii sa vykonajú okrem iného nasledujúce záznamy, ktoré sa potom používajú na predvyplňovanie pri následných inštaláciách alebo sa podľa nich vykonáva odinštalácia:

  • Záznam v Pridať/Odobrať programy - pridá sa jeden záznam s 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ú vykonanú inštaláciu, a to aj v prípade, že máte viac 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ýkrát (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 registroch a v Pridať/Odobrať programy sa prepíšu údajmi poslednej inštalácie, tj. ukazujú na ABRA-Ostrá. Pozor, v takom prípade by sa pri odobratí z Pridať/Odobrať programy 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, ak ste skôr vykonali viac inštalácií starších verzií ABRA Gen s jednoduchým účtovníctvom resp. ABRA Gen s podvojným účtovníctvom(v. 2.xx). Ak 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 súboru Unins000.dat a do registrov - do špeciálneho súboru Uninst000.dat v adresári inštalácie sa zapíšu aktuálne údaje o poslednej inštalácii, okrem iného názov zložky v menu Štart a pod. Ď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).