Inštalácia sieťových verzií

Systém ABRA Gen môže bežať v dvoch režimoch:

• Lokálny (nesieťový) režim - Lokálny režim predstavuje taký spôsob behu systému, pri ktorom všetky DLL knižnice aplikačného servera bežia v tom istom procese ako klient ABRA Gen. Pri spustení aplikácie AbraGen.exe v tomto režime sa DLL knižnice prilinkujú do adresového priestoru aplikácie. Výhodou teda je vyššia rýchlosť než v prípade sieťového režimu. Je určený ale iba pre nesieťovú prevádzku bez aplikačného servera.

  To je prípad nesieťovej jedno používateľskej inštalácie (singl inštalácie) na jednom PC (tj. napr. demoverzia, freeverzia, ostrá jedno používateľská (singl) inštalácia). V tom prípade nie je nutné komunikovať s databázou cez vonkajšie rozhranie zabezpečované prostredníctvom aplikačného servera (Class Provider), viď technológia spracovania dát. Tj. aplikačný server nebeží.

• Sieťový režim - Naopak v sieťovom režime ide o beh s aplikačným serverom. Tj. klient ABRA Gen (tj. AbraGen.exe a iné (napr. DynSQLEditor.exe, DefRollEditor.exe a pod.) využíva služby aplikačného servera, ktorý môže byť realizovaný viacerými spôsobmi:

  • AppServer.exe - 64-bitový aplikačný server je Windows aplikácia (exe).
  • AppServerS.exe, - 64-bitový aplikačný server je Windows služba (service).
  • AppServer64.exe - 64-bitový aplikačný server je aplikácia aj služba systému Windows.
  • AppServerL-x64 - 64-bitový aplikačný server ako linuxový démon.

  • Od verzie 21.4.2 systém ABRA Gen na strane servera podporuje len operačný systém Windows a 64-bitovej verzie operačného systému Linux, tzn. je k dispozícii len 64-bitová verzia linuxového aplikačného servera (appserverl). Pokiaľ v súčasnej dobe používate 32-bitovú verziu Linuxu (a 32-bitový aplikačný server appserverl-x86), naplánujte si s dostatočným predstihom prechod na operačný systém, ktorý bude podporovaný i v budúcich verziách ABRA Gen.

    V súvislosti s touto plánovanou zmenou môžete (kedykoľvek, najneskôr však pred updatom na ABRA Gen 21.4.2) prejsť na:

    • 64-bitovú verziu Linuxu

    • 64-bitovú verziu Windows

      Serverové edície systému Windows sú od verzie Windows Server 2012 k dispozícii len pre 64-bitovú platformu x86-64. 32-bitová verzia aplikačného servera pre Windows bude v ABRA Gen 22.0 stále k dispozícii, ale na prevádzku v produkčnom sieťovom prostredí odporúčame prevádzkovať 64-bitový aplikačný server na Windows Serveri.

  • AppServerL-x64 - 64-bitový aplikačný server ako linuxový démon.

  Všetky súbory sú po inštalácii ABRA Gen k dispozícii v roote adresára, do ktorého bola ABRA Gen nainštalovaná.

  Komunikácia medzi klientom AbraGen.exe a aplikačným serverom prebieha pomocou protokolu TCP/IP. Sieťový režim je určený pre prípad sieťovej prevádzky, keď klient a aplikačný server bežia na rôznych počítačoch. Ale je možné nastaviť, aby oba bežali na jednom počítači.

  Pre spustenie a ukončenie aplikačného servera platí:

  • Pokiaľ je aplikačný server nainštalovaný na inom počítači, musí byť aplikačný server spustený ešte pred spustením klienta. Dôvodom je to, že cez protokol TCP/IP nie je možné spustiť aplikáciu na inom počítači. Klient je schopný spustiť iba server, ktorý je nainštalovaný na rovnakom počítači.
  • Po ukončení klienta aplikačný server ďalej beží.

Aplikačný server na Windows ako aplikácia alebo služba Windows

Aplikačné servery, ako bolo povedané vyššie, sú vo viacerých vyhotoveniach, keď môžu bežať ako aplikácia alebo ako služba Windows.

Výhody behu aplikačného servera ako služby:

• Väčšia bezpečnosť
• Nie je nutné prihlásenie používateľa

Servis má nastavené automatické spúšťanie, takže pri budúcom spustení systému sa spustí automaticky sám a nemusí sa prihlasovať žiadny používateľ (samozrejme po nainštalovaní).

AppServer.exe je aplikácia systému Windows a spustí sa štandardným spôsobom ako exe súbor.

AppServerS.exe je služba Windows. Pre prevádzku aplikačného servera ako služby je najprv nutné túto službu zaregistrovať spustením dodávaného exe súboru z príkazového riadku. Tj. z príkazového riadku spusteného pod administrátorským účtom spustiť príslušný exe súbor s parametrom /INSTALL (resp. -INSTALL) z adresára, kde je aplikačný server umiestnený:

<cesta>\AppServerS.exe /INSTALL

Pre odinštalovanie to isté, ale s parametrom /UNINSTALL (resp. -UNINSTALL).

AppServer64.exe je Windows aplikácia aj služba. Aby bol spustený ako aplikácia, je potrebné ho spustiť s jedným z parametrov /runasapp, /run alebo /application (resp. -runasapp, -run alebo -application). Potom, ak je spustený, je na toolbari zobrazená ikona . Pre prevádzku aplikačného servera ako služby je najprv nutné túto službu zaregistrovať spustením dodávaného exe súboru z príkazového riadka (na to je potrebné mať administrátorský prístup). Tj. pod administrátorským účtom spustiť exe súbor z príkazového riadka jeho zavolaním s parametrom /INSTALL (resp. -INSTALL) z adresára, kde je aplikačný server umiestnený:

<cesta>\AppServer64.exe /INSTALL

Na odinštalovanie to isté, ale s parametrom /UNINSTALL (resp. -UNINSTALL).

Aplikačný server možno spustiť aj viackrát ako Windows službu (rovnako ako možno viackrát spúšťať AppServer.exe alebo AppServer64.exe ako aplikáciu alebo aplikačný server pod Linuxom). AppServerS.exe, resp. AppServer64.exe, má však v sebe zakompilované meno, pod ktorým sa ako služba registruje. Aby sa teda mohla služba zaregistrovať viackrát, je v nexus.cfg v sekcii Server k dispozícii parameter ServiceNameSuffix (reťazec). Jeho zmenou sa potom mení interný názov služby a tiež aj jej DisplayName (na neskoršiu identifikáciu jednotlivých zaregistrovaných služieb v správcovi služieb).

Aplikačný server pod Linuxom

Postup inštalácie viď inštalačná príručka pre Firebird alebo inštalačná príručka pre Oracle/MSSQL. Ako je uvedené v sekcii Správne nastavenie parametrov Local, ServerName, ProviderType, musí byť správne nastavený parameter ProviderType. Tj. v súbore nexus.cfg v sekcii [Server] upraviť parameter ProviderType takto: ProviderType=2. Viac viď kap. Konfiguračný súbor Nexus.cfg - oddiely a parametre.

Okrem režimu behu systému ABRA Gen (lokálny režim bez aplikačného servera (single inštalácia)/sieťový režim s aplikačným serverom (sieťová inštalácia)) sa nastavuje režim pripojenia k databáze (resp. databázovému serveru). Ten by mohol byť teoreticky realizovaný pomocou:

• Lokálneho protokolu - tzv. Local spojenie
• Sieťového protokolu (TCP/IP či iný) - tzv. Remote spojenie

Lokálny protokol (local spojenie) je realizovaný pomocou zdieľanej virtuálnej pamäte medzi klientom a serverom. Výhodou teda je vyššia rýchlosť než v prípade sieťového protokolu (remote spojenie).

Avšak platí pravidlo, že v prípade sieťového behu systému ABRA Gen (beh s aplikačným serverom) musí byť použitý sieťový režim pripojenia k databáze, a to preto, že aplikačný server sa pripája k databázovému z viacerých vlákien a v tom prípade by sa pri komunikácii pomocou lokálneho protokolu aplikačný server zasekol. Tj. v takom režime teda nemožno použiť lokálne spojenie s databázovým serverom, a to ani vtedy, ak je umiestnený na tom istom počítači ako aplikačný server.

Pripojenie k databáze sa nastavuje pomocou nástroja DBAdmin. Ako, viď nastavenie spojenia na databázu.

Nastavenie, či systém ABRA Gen má bežať v lokálnom alebo sieťovom režime, možno vykonať jednou z nasledujúcich možností:

1. Pomocou parametrov príkazového riadka pri spustení AbraGen.exe

   Parameter	Popis	Zodpovedá nastaveniu
   -local	spustenie v lokálnom režime	Local=1
   -remote	spustenie v režime aplikačného servera	Local=0
   -selfremote	spustenie v režime aplikačného servera na jednom počítači	Local=0; ServerName=LocalHost

2. Pomocou konfiguračného súboru Nexus.cfg - V konfiguračnom súbore Nexus.cfg v sekcii [Client] v parametri Local resp. ServerName. Viď ďalej. Konfiguračný súbor Nexus.cfg systém hľadá v rovnakej ceste, ako je AbraGen.exe.

3. Pomocou Windows Registry - V registroch v kľúči HKEY_CURRENT_USER\Software\ABRA Software\Repository\Client.

   Ide o parametre:

   • Local - pre lokálny režim nastavené na 1, pre sieťový režim nastavené na 0.
   • ServerName - meno alebo IP adresa IP adresa je v informatike číslo, ktoré jednoznačne identifikuje sieťové rozhranie v počítačovej sieti, ktorá používa protokol IP. Slúži teda na identifikáciu uzla v rámci prepojenia sietí IP, kedy každému uzlu je pridelená jedinečná adresa IP, ktorá je tvorená identifikátorom siete a identifikátorom hostiteľa. Adresa je obvykle reprezentovaná desiatkovými hodnotami jednotlivých oktetov oddelených bodkou, napríklad 192.168.7.27. počítača, na ktorom beží aplikačný server v sieťovej konfigurácii. Môže obsahovať zástupné meno localhost V počítačovej terminológii localhost znamená odkaz na práve používaný počítač, tzn. alias pre "tento počítač" resp. na väčšine počítačov alias pre špeciálnu vyhradenú IP adresu 127.0.0.1 (v protokole IPv4) alebo ::1 (v protokole IPv6). Typicky sa používa ako alias pre "vlastný počítač", ale nemusí tomu tak byť (môže byť použitý napr. pri definícii spojenia medzi dvoma aplikáciami ležiacimi na "tom istom" serveri (z hľadiska jednej aplikácie leží tá druhá na tom istom práve používanom počítači). na identifikáciu rovnakého PC. Podrobnejšie viď ďalej.

Pre beh v sieťovom režime sa nastavujú aj parametre aplikačného servera. Tie je možné nastaviť:

1. Pomocou konfiguračného súboru Nexus.cfg- V konfiguračnom súbore Nexus.cfg v sekcii [Server]. Konfiguračný súbor Nexus.cfg systém hľadá v rovnakej ceste, ako je AbraGen.exe.

2. Pomocou Windows Registry - V registroch, v kľúči HKEY_CURRENT_USER\Software\ABRA Software\Repository\Server.

   Ide o parametre:

   • ProviderType - Určuje typ a spustenie aplikačného servera, podrobnejšie viď ďalej.
   • StorageFile - Meno súboru aj s cestou v kontexte servera, ktorý obsahuje dáta zdieľaného repozitára.
   • StorageDLL - Meno DLL súboru aj s cestou v kontexte servera, ktorý implementuje zdieľaný repozitár.

Rôzne varianty boli spomenuté v kap. Typy inštalácií - sieťovosť.

Ako bolo povedané v kap. Technológie spracovania dát, trojvrstvová technológia, klient komunikuje s aplikačným serverom cez vlastnú technológiu založenú na TCP/IP. Z toho vyplýva, že sieťovú verziu možno prevádzkovať iba na sieťach s protokolom TCP/IP - týka sa klientov a aplikačného servera, so samotnou databázou možno komunikovať aj cez iný typ protokolu.

Ako bolo uvedené už v základnej charakteristike ABRA Gen, aplikačný a databázový server systému ABRA Gen je možné prevádzkovať tak na Windows, ako aj na Linuxe. Na strane klienta je zatiaľ prevádzkovým prostredím iba operačný systém Windows.

Musí byť vykonaná aktivácia zodpovedajúcim aktivačným kľúčom. Aktiváciu do siete možno vykonať:

• Rovno pri inštalácii; ak je zvolená voľba Nová ostrá inštalácia s licenčným kľúčom, potom v kroku Aktivácia môžete rovno systém aktivovať a v ďalšom kroku zaškrtnúť Sieťová viacpoužívateľská inštalácia. (V prípade inštalácie vykonávanej rovno ako sieťovej sa tiež správne prednastavia hodnoty parametrov opísaných ďalej, nevyhnutné pre beh sieťovej verzie a nebude ich treba nastavovať ručne.)
• Dodatočne iným spôsobom. Ďalej viď Ako možno systém aktivovať.

Ďalej musí byť nastavené, že má systém ABRA Gen bežať v sieťovom režime, teda s aplikačným serverom.

K tomu slúžia parametre Local, ServerName a ProviderType. Jednou z možností nastavenia lokálneho/sieťového režimu je správne nastavenie nasledujúcich parametrov v súbore nexus.cfg:

• Parameter Local v sekcii [Client] - určuje, či ABRA Gen pobeží v jednoužívateľskej konfigurácii bez aplikačného servera, čo je východisková konfigurácia pre Demo a Free verziu, alebo či ide o sieťovú prevádzku proti aplikačnému serveru. Hodnota parametra sa nastavuje už pri inštalácii podľa toho, či je ABRA Gen inštalovaná ako singl verzia (tj. demoverzná inštalácia alebo ostrá jednoužívateľská) alebo priamo ako sieťová verzia. Viac viď parameter Local.

• Parameter ServerName v sekcii [Client] - určuje počítač, na ktorom v sieťovej konfigurácii beží aplikačný server. Viac viď parameter ServerName.

• Parameter ProviderType v sekcii [Server] - Určuje typ a spustenie aplikačného servera: či sa aplikačný server spustí ako 32-bitová Windows aplikácia, ako 32-bitová služba Windows alebo či sa automaticky spúšťať nemá (ide o beh na vyhradenom počítači (Windows i Linux), keď štart aplikačného servera zabezpečí administrátor štandardným spôsobom po štarte OS, či ide o 64-bitový aplikačný server, pri ktorom neexistuje variant automatického spúšťania. Viac viď parameter ProviderType.

  Ak teda vykonávate rozšírenie zo singl inštalácie na sieťovú inštaláciu, musíte okrem iného správne nastaviť hodnotu parametra Local a ďalej parametra ProviderType a zaistiť spustenie správneho aplikačného servera.

Pripojenie k databáze sa nastavuje pomocou nástroja DBAdmin. Parametre spojenia sa líšia v závislosti na databázovom serveri, s ktorým je ABRA Gen prevádzkovaná. Popis vybraných parametrov viď kap. Vybrané parametre spojenia na databázu.

Pre nastavenie spojenia na databázu (viď parameter SERVER NAME v DBAdmin) platí:

• Single (nesieťová) inštalácia (tj. demonštračná alebo ostrá jednoužívateľská) - V tomto prípade nie je potrebné, aby bežal aplikačný server (viď Lokálny/sieťový režim (behu systému ABRA Gen)). Potom možno databázový server pripojiť pomocou Local spojenia (je rýchlejšie než Remote spojenie a pre prevádzku singl inštalácie stačí).

  Pre databázový server firebird ďalej platí:

  Stačí, aby hodnotou parametra SERVER NAME bola cesta k súboru databázy:

  SERVER NAME=cesta \súbor.fdb, tj. napr. C:\Firma\data.fdb.

  V prípade single inštalácie teda na komunikáciu klienta s databázovým serverom Firebird nie je nutné špecifikovať komunikačný protokol, avšak je to možné. Je možné použiť jeden z protokolov TCP/IP alebo NetBEUI uvedených ďalej.

  Pokiaľ nie je cesta k databáze definovaná sieťovo, viď ďalej, mal by byť nastavený parameter MaxOpenedUnusedConnections na hodnotu 0 (klient si nebude udržiavať nepoužité spojenie). V opačnom prípade by mohlo dôjsť pri prevádzke s Firebird 1.0x k nežiaducim situáciám (stuhnutie pri vytváraní databázy a pod.). Toto riešenie môže však spôsobiť spomalenie systému pri niektorých typoch akcií (typicky vystavovanie mnohých dokladov, keď sa klient opakovane dopytuje pri prideľovaní posledných čísel dokladov a keď je výhodné si existujúce spojenie na databázu udržiavať). Z výška uvedeného vyplýva, že môže byť aj pri singl inštalácii vhodné definovať spojenie na databázu cez TCP/IP. Nevýhodou je, že toto spojenie môže byť pomalšie oproti Local spojeniu. Teda obe riešenia majú svoje výhody a nevýhody a záleží na type práce, ktorú používateľ prevažne vykonáva.

  Ďalej závisí od toho, či je Firebird nainštalovaný vo variante SuperServer, ClassicServer alebo SuperClassic, čo sa pri inštalácii deteguje a podľa toho sa prípadne doplní spojenie ako pri sieťovej inštalácii, tj. remote spojenie, aj v prípade nesieťovej inštalácie. Viď Inštalácia SQL servera Firebird.

• Sieťová inštalácia - V tomto prípade beží aplikačný server (viď Lokálny/sieťový režim (behu systému ABRA Gen)) a je teda nutné, aby sa databázový server pripájal pomocou Remote spojenia, a to aj vtedy, pokiaľ databázový server beží na tom istom počítači ako aplikačný server. (Dôvod viď Režim pripojenia k databáze (local spojenie, remote spojenie) výška.)

  Pre databázový server Firebird ďalej platí:

  To sa dosiahne, pokiaľ sa pred cestu k databáze doplní identifikácia počítača, kde sa nachádza databázový server.

  Na komunikáciu aplikačného servera s databázovým serverom je možné použiť jeden z protokolov:

  • protokol TCP/IP: SERVER NAME=server:cesta\súbor.fdb
  • protokol NetBEUI: SERVER NAME=\\server\cesta\súbor.fdb

  Najpoužívanejší protokol je TCP/IP. Pri iných protokoloch je nutné počítať s tým, že nemusia byť na všetkých počítačoch k dispozícii! Pre TCP/IP protokol môže byť namiesto mena servera použitá IP adresa IP adresa je v informatike číslo, ktoré jednoznačne identifikuje sieťové rozhranie v počítačovej sieti, ktorá používa protokol IP. Slúži teda na identifikáciu uzla v rámci prepojenia sietí IP, kedy každému uzlu je pridelená jedinečná adresa IP, ktorá je tvorená identifikátorom siete a identifikátorom hostiteľa. Adresa je obvykle reprezentovaná desiatkovými hodnotami jednotlivých oktetov oddelených bodkou, napríklad 192.168.7.27. alebo zástupné meno localhost V počítačovej terminológii localhost znamená odkaz na práve používaný počítač, tzn. alias pre "tento počítač" resp. na väčšine počítačov alias pre špeciálnu vyhradenú IP adresu 127.0.0.1 (v protokole IPv4) alebo ::1 (v protokole IPv6). Typicky sa používa ako alias pre "vlastný počítač", ale nemusí tomu tak byť (môže byť použitý napr. pri definícii spojenia medzi dvoma aplikáciami ležiacimi na "tom istom" serveri (z hľadiska jednej aplikácie leží tá druhá na tom istom práve používanom počítači)..

  Objasníme na príkladoch:

  Príklad 1: Majme sieťovú inštaláciu ABRA Gen pre Firebird, pričom nech aplikačný server a firebird ležia na serveri, ktorého meno je Nexus, IP adresa napr. 172.16.1.12 a súbor databáza leží v jeho adresári C:\Firma\data.fdb. Potom v definícii spojenie na databázu (teda medzi apl. serverom a databázou) pre protokol TCP/IP môže byť buď SERVER NAME=Nexus:C:\Firma\data.fdb alebo SERVER NAME=172.16.1.12:C:\Firma\data.fdb a pretože databáza beží na "tom istom popčítači" ako apl. server, môže byť aj SERVER NAME=localhost:C:\Firma\data.fdb príp. SERVER Name=127.0.0.1:c:\Firma\data.fdb. (Localhost v tomto prípade je teda zástupné meno pre "práve používaný počítač", čo z hľadiska aplikačného servera je v našom príklade server Nexus.)

  Príklad 2: Majme sieťovú inštaláciu ABRA Gen pre Firebird, ale tentoraz na jednom lokálnom (vlastnom) počítači, ktorého meno je napr. MujNTB a IP adresa napr. 173.10.1.10 (tj. na lokálnom vlastnom počítači máme inštaláciu ABRA Gen pre Firebird nakonfigurovanú sieťovo, tj. bežiacu cez aplikačný server, firebird a súbor databáza v adresári C:\Firma\data.fdb. Potom v definícii spojenie pre protokol TCP/IP môže byť buď SERVER NAME=MujNTB:C:\Firma\data.fdb alebo SERVER NAME=localhost:C:\Firma\data.fdb alebo SERVER Name=127.0.0.1:c:\Firma\data.fdb, ale stačí aj len

  Príklad 3: Majme nesieťovú inštaláciu ABRA Gen pre Firebird na počítači, ktorý je zapojený do počítačovej siete pod názvom OBCHOD1 (tj. firebird na tom istom počítači, databáza nech leží v adresári C:\Firma\data.fdb. Potom v definícii spojenie stačí len SERVER Name=c:\Firma\data.fdb (systém sa zachová, akoby bolo definované SERVER Name=localhost:c:\Firma\data.fdb.

  Hodnota spojenie na databázu je dopĺňaná pre nové spojenie s databázou zodpovedajúcim spôsobom pri novej inštalácii alebo pri pridaní spojenia pomocou nástroja DBAdmin.

  Parameter SERVER Name má hodnotu:

  • pre Remote spojenie (v syntaxi zodpovedajúcej TCP/IP protokolu) - ak bola ABRA Gen s jednoduchým účtovníctvom resp. ABRA Gen s podvojným účtovníctvom inštalovaná priamo ako sieťová verzia voľbou Nová ostrá inštalácia s licenčným kľúčom, pri ktorej bola v kroku Typ inštalácie zaškrtnutá možnosť Sieťová viacužívateľská inštalácia, alebo ak pridávame nové pripojenie k databáze v už prevádzkovanej sieťovej verzii. Napr. SERVER Name=localhost:c:\Firma\data.fdb

    Ak je vyžadovaný iný protokol, je možné ho nastaviť pomocou špecifikácie cesty k databáze v parametroch spojenia s databázou (napr. počas inštalácie krok Rekapitulácia, tlačidlo Spresniť alebo pomocou nástroja DBAdmin).

  • pre Local spojenie - ak bola ABRA Gen s jednoduchým účtovníctvom resp. ABRA Gen s podvojným účtovníctvom inštalovaná ako singl verzia (tj. demoverzná inštalácia alebo ostrá jednoužívateľská) alebo ak pridávame nové pripojenie k databáze v už prevádzkovanej singl verzii. Napr. SERVER Name=c:\Firma\data.fdb

  Ak teda vykonávate rozšírenie zo singl inštalácie na sieťovú inštaláciu, musíte okrem iného správne upraviť spojenie na databázu.

Aplikačný server sa spúšťa automaticky pri spustení klienta iba v prípade, ak je inštalovaný na tom istom počítači ako klient. V ostatných prípadoch je potrebné pre úspešný beh sieťovej verzie zabezpečiť jeho spustenie. Viď tiež Lokálny/sieťový režim (behu systému ABRA Gen).