Instalace síťových verzí

Systém ABRA Gen může běžet ve dvou režimech:

• Lokální (nesíťový) režim - Lokální režim představuje takový způsob běhu systému, při kterém všechny DLL knihovny aplikačního serveru běží ve stejném procesu jako klient ABRA Gen. Při spuštění aplikace AbraGen.exe v tomto režimu se DLL knihovny přilinkují do adresního prostoru aplikace. Výhodou tedy je vyšší rychlost než v případě síťového režimu. Je určen ale pouze pro nesíťový provoz bez aplikačního serveru.

  To je případ nesíťové jednouživatelské instalace (singl instalace) na jednom PC (tj. např. demoverze, freeverze, ostrá jednouživatelská (singl) instalace).. V tom případě není nutné komunikovat s databází přes vnější rozhraní zajišťované prostřednictvím aplikačního serveru (Class Provider), viz technologie zpracování dat. Tj. neběží aplikační server.

• Síťový režim - Naopak v síťovém režimu se jedná o běh s aplikačním serverem. Tj. klient ABRA Gen (tj. AbraGen.exe a jiné (např. DynSQLEditor.exe, DefRollEditor.exe apod.) využívá služeb aplikačního serveru, který může být realizován více způsoby:

  • AppServer.exe - 32bitový aplikační server je Windows aplikace (exe).
  • AppServerS.exe , - 32bitový aplikační server je Windows služba (service).
  • AppServer64.exe - 64bitový aplikační server je Windows aplikace i služba.

  • AppServerL-x86 - 32bitový aplikační server je linuxový daemon.

    Od verze 21.4.2 systém ABRA Gen na straně serveru podporuje pouze operační systém Windows a 64-bitové verze operačního systému Linux, tj. je k dispozici pouze 64-bitová verze linuxového aplikačního serveru (appserverl). Pokud v současné době používáte 32-bitovou verzi Linuxu (a 32-bitový aplikační server appserverl-x86), naplánujte si s dostatečným předstihem přechod na operační systém, který bude podporován i v budoucích verzích ABRA Gen.

    V souvislosti s touto plánovanou změnou můžete (kdykoli, nejpozději však před updatem na ABRA Gen 21.4.2) přejít na:

    • 64-bitovou verzi Linuxu

    • 64-bitovou nebo 32-bitovou verzi Windows

      Serverové edice systému Windows jsou od verze Windows Server 2012 k dispozici pouze pro 64-bitovou platformu x86-64. 32-bitová verze aplikačního serveru pro Windows bude v ABRA Gen 22.0 stále k dispozici, ale pro provoz v produkčním síťovém prostředí doporučujeme provozovat 64-bitový aplikační server na Windows Serveru.

  • AppServerL-x64 - 64bitový aplikační server jako linuxový daemon.

  Všechny soubory jsou po instalaci ABRA Gen k dispozici v rootu adresáře, do něhož byla ABRA Gen instalována.

  Komunikace mezi klientem AbraGen.exe a aplikačním serverem probíhá pomocí protokolu TCP/IP. Síťový režim je určen pro případ síťového provozu, kdy klient a aplikační server běží na různých počítačích. Ale je možné nastavit, aby oba běžely na jednom počítači.

  Pro spuštění a ukončení aplikačního serveru platí:

  • Pokud je aplikační server instalován na jiný počítač, musí být aplikační server spuštěn ještě před spuštěním klienta. Důvodem je to, že přes protokol TCP/IP není možné spustit aplikaci na jiném počítači. Klient je schopný spustit pouze server, který je nainstalovaný na stejném počítači.
  • Po ukončení klienta aplikační server dále běží.

Aplikační server na Windows jako aplikace nebo Windows service

Aplikační servery, jak bylo řečeno výše, jsou ve více provedeních, kdy mohou běžet jako aplikace nebo jako služba Windows.

Výhody běhu aplikačního serveru jako služby:

• Větší bezpečnost
• Není nutné přihlášení uživatele

Servis má nastaveno automatické spouštění, takže při příštím spuštění systému se spustí automaticky sám a nemusí se přihlašovat žádný uživatel (samozřejmě po nainstalování).

AppServer.exe je Windows aplikace a spustí se standardním způsobem jako exe soubor.

AppServerS.exe je Windows služba. Pro provoz aplikačního serveru jako služby je nejprve nutné tuto službu zaregistrovat spuštěním dodávaného exe souboru z příkazové řádky. Tj. z příkazové řádky spuštěné pod administrátorským účtem spustit příslušný exe soubor s parametrem /INSTALL (resp. -INSTALL) z adresáře, kde je aplikační server umístěn:

<cesta>\AppServerS.exe /INSTALL

Pro odinstalaci totéž ale s parametrem /UNINSTALL (resp. -UNINSTALL).

AppServer64.exe je Windows aplikace i služba. Aby byl spuštěn jako aplikace, je třeba jej spustit s jedním z parametrů /runasapp, /run nebo /application (resp. -runasapp, -run nebo -application). Pak, je-li spuštěn, je na toolbaru zobrazena ikona . Pro provoz aplikačního serveru jako služby je nejprve nutné tuto službu zaregistrovat spuštěním dodávaného exe souboru z příkazové řádky (k tomu je třeba mít administrátorský přístup). Tj. pod administrátorským účtem spustit exe soubor z příkazové řádky jeho zavoláním s parametrem /INSTALL (resp. -INSTALL) z adresáře, kde je aplikační server umístěn:

<cesta>\AppServer64.exe /INSTALL

Pro odinstalaci totéž ale s parametrem /UNINSTALL (resp. -UNINSTALL).

Aplikační server lze spustit i vícekrát jako Windows službu (stejně jako lze vícekrát spouštět AppServer.exe nebo AppServer64.exe jako aplikaci nebo aplikační server pod Linuxem). AppServerS.exe, resp. AppServer64.exe ale má v sobě zakompilované jméno, pod kterým se jako služba registruje. Aby se tedy mohla služba zaregistrovat vícekrát, je v nexus.cfg v sekci Server k dispozici parametr ServiceNameSuffix (řetězec). Jeho změnou se pak mění interní název služby a též i její DisplayName (pro pozdější identifikaci jednotlivých zaregistrovaných služeb ve správci služeb).

Aplikační server pod Linuxem

Postup instalace viz patřičná instalační příručka. Jak je řečeno v sekci Správné nastavení parametrů Local, ServerName, ProviderType, musí být správně nastaven parametr ProviderType. Tj. v souboru nexus.cfg v sekci [Server] upravit parametr ProviderType takto: ProviderType=2. Více viz kap. Konfigurační soubor Nexus.cfg - oddíly a parametry.

Vedle režimu běhu systému ABRA Gen (lokální režim bez aplikačního serveru (singl instalace)/síťový režim s aplikačním serverem (síťová instalace)) se nastavuje režim připojení k databázi (resp. databázovému serveru). Ten by mohl být teoreticky realizován pomocí:

• Lokálního protokolu - tzv. Local spojení
• Síťového protokolu (TCP/IP či jiný) - tzv. Remote spojení

Lokální protokol (local spojení) je realizován pomocí sdílené virtuální paměti mezi klientem a serverem. Výhodou tedy je vyšší rychlost než v případě síťového protokolu (remote spojení).

Avšak platí pravidlo, že v případě síťového běhu systému ABRA Gen (běh s aplikačním serverem) musí být použit síťový režim připojení k databázi, a to proto, že aplikační server se připojuje k databázovému z více threadů a v tom případě by se při komunikaci pomocí lokálního protokolu aplikační server zasekl. Tj. v takovém režimu tedy nelze použít lokální spojení s databázovým serverem, a to ani tehdy, pokud je umístěn na stejném počítači jako aplikační server.

Připojení k databázi se nastavuje pomocí nástroje DBAdmin. Jak, viz nastavení spojení na databázi.

Nastavení, zda systém ABRA Gen má běžet v lokálním nebo síťovém režimu, lze provést jednou z následujících možností:

1. Pomocí parametrů příkazové řádky při spuštění AbraGen.exe

   Parametr	Popis	Odpovídá nastavení
   -local	spustění v lokálním režimu	Local=1
   -remote	spustění v režimu aplikačního serveru	Local=0
   -selfremote	spuštění v režimu aplikačního serveru na jednom počítači	Local=0; ServerName=LocalHost

2. Pomocí konfiguračního souboru Nexus.cfg - V konfiguračním souboru Nexus.cfg v sekci [Client] v parametru Local resp. ServerName. Viz dále. Konfigurační soubor Nexus.cfg systém hledá ve stejné cestě, jako je AbraGen.exe.

3. Pomocí Windows Registry - V registrech v klíči HKEY_CURRENT_USER\Software\ABRA Software\Repository\Client.

   Jedná se o parametry:

   • Local - pro lokální režim nastaveno na 1, pro síťový režim nastaveno na 0.
   • ServerName - jméno nebo IP adresa IP adresa je v informatice číslo, které jednoznačně identifikuje síťové rozhraní v počítačové síti, která používá protokol IP. Slouží tedy k identifikaci uzlu v rámci propojení sítí IP, kdy každému uzlu je přidělena jedinečná adresa IP, která je tvořena identifikátorem sítě a identifikátorem hostitele. Adresa je obvykle reprezentována desítkovými hodnotami jednotlivých oktetů oddělených tečkou, například 192.168.7.27. počítače, na kterém běží aplikační server v síťové konfiguraci. Může obsahovat zástupné jméno localhost V počítačové terminologii localhost znamená odkaz na právě používaný počítač, tj. alias pro "tento počítač" resp. na většině počítačů alias pro speciální vyhrazenou IP adresu 127.0.0.1 (v protokolu IPv4) nebo ::1 (v protokolu IPv6). Typicky je používán jako alias pro "vlastní počítač", ale nemusí tomu tak být (může být použit např. při definice spojení mezi dvěma aplikacemi ležícími na "tomtéž" serveru (z hlediska jedné aplikace leží ta druhé na tom samém právě používaném počítači). pro identifikaci stejného PC. Podrobněji viz dále.

Pro běh v síťovém režimu se nastavují také parametry aplikačního serveru. Ty je možné nastavit:

1. Pomocí konfiguračního souboru Nexus.cfg- V konfiguračním souboru Nexus.cfg v sekci [Server]. Konfigurační soubor Nexus.cfg systém hledá ve stejné cestě, jako je AbraGen.exe.

2. Pomocí Windows Registry - V registrech, v klíči HKEY_CURRENT_USER\Software\ABRA Software\Repository\Server.

   Jedná se o parametry:

   • ProviderType - Určuje typ a spouštění aplikačního serveru, podrobněji viz dále.
   • StorageFile - Jméno souboru i s cestou v kontextu serveru, který obsahuje data sdílené repozitoře.
   • StorageDLL - Jméno DLL souboru i s cestou v kontextu serveru, který implementuje sdílenou repozitoř.

Různé varianty byly zmíněny v kap. Typy instalací - síťovost.

Jak bylo řečeno v kap. Technologie zpracování dat, třívrstvá technologie, klient komunikuje s aplikačním serverem přes vlastní technologii založenou na TCP/IP. Z toho plyne, že síťovou verzi lze provozovat pouze na sítích s protokolem TCP/IP - týká se klientů a aplikačního serveru, se samotnou databází lze komunikovat i přes jiný typ protokolu.

Jak bylo uvedeno již v základní charakteristice ABRA Gen, aplikační a databázový server systému ABRA Gen je možné provozovat jak na Windows, tak i na Linuxu. Na straně klienta je zatím provozním prostředím pouze operační systém Windows.

Musí být provedena aktivace odpovídajícím aktivačním klíčem. Aktivaci na síť lze provést:

• Rovnou při instalaci; je-li zvolena volba Nová ostrá instalace s licenčním klíčem, pak v kroku Aktivace můžete rovnou systém zaktivovat a v dalším kroku zatrhnout Síťová víceuživatelská instalace. (V případě instalace prováděné rovnou jakožto síťové, se také správně přednastaví hodnoty parametrů popsaných dále, nezbytné pro běh síťové verze a nebude třeba je nastavovat ručně.)
• Dodatečně jiným způsobem. Dále viz Jak lze systém zaktivovat.

Dále musí být nastaveno, že má systém ABRA Gen běžet v síťovém režimu, tedy s aplikačním serverem.

K tomu slouží parametry Local, ServerName a ProviderType. Jednou z možností nastavení lokálního/síťového režimu je správné nastavení následujících parametrů v souboru nexus.cfg:

• Parametr Local v sekci [Client] - určuje, zda ABRA Gen poběží v jednouživatelské konfiguraci bez aplikačního serveru, což je výchozí konfigurace pro Demo a Free verzi, nebo zda se jedná o síťový provoz proti aplikačnímu serveru. Hodnota parametru se nastavuje už při instalaci podle toho, zda je ABRA Gen instalována jako singl verze (tj. demoverzní instalace nebo ostrá jednouživatelská) nebo rovnou jako síťová verze. Více viz parametr Local.

• Parametr ServerName v sekci [Client] - určuje počítač, na kterém v síťové konfiguraci běží aplikační server. Více viz parametr ServerName.

• Parametr ProviderType v sekci [Server] - Určuje typ a spouštění aplikačního serveru: zda se aplikační server spustí jako 32bit Windows aplikace, jako 32bit služba Windows nebo zda se automaticky spouštět nemá (jedná se o běh na vyhrazeném počítači (Windows i Linux), kdy start aplikačního serveru zajistí administrátor standardním způsobem po startu OS, či se jedná o 64bit aplikační server, u něhož neexistuje varianta automatického spouštění. Více viz parametr ProviderType.

  Pokud tedy provádíte rozšíření ze singl instalace na instalaci síťovou, musíte mj. správně nastavit hodnotu parametru Local a dále parametru ProviderType a zajistit spuštění správného aplikačního serveru.

Připojení k databázi se nastavuje pomocí nástroje DBAdmin. Parametry spojení se liší v závislosti na databázovém serveru, s kterým je ABRA Gen provozována. Popis vybraných parametrů viz kap. Vybrané parametry spojení na databázi.

Pro nastavení spojení na databázi (viz parametr SERVER NAME v DBAdmin) platí:

• Single (nesíťová) instalace (tj. demonstrační nebo ostrá jednouživatelská) - V tomto případě není třeba, aby běžel aplikační server (viz Lokální/síťový režim (běhu systému ABRA Gen)). Pak lze databázový server konektovat pomocí Local spojení (je rychlejší než Remote spojení a pro provoz singl instalace stačí).

  Pak stačí, aby hodnotou parametru SERVER NAME byla cesta k souboru databáze:

  SERVER NAME=cesta \soubor.fdb, tj. např. C:\Firma\data.fdb.

  V případě single instalace tedy pro komunikaci klienta s databázovým serverem Firebird není nutné specifikovat komunikační protokol, nicméně je to možné. Je možné použít jeden z protokolů TCP/IP nebo NetBEUI uvedených dále.

  Pokud není cesta k databázi definována síťově, viz dále, měl by být nastaven parametr MaxOpenedUnusedConnections na hodnotu 0 (klient si nebude udržovat nepoužité spojení). V opačném případě by mohlo dojít při provozu s Firebird 1.0x k nežádoucím situacím (ztuhnutí při vytváření databáze apod.). Toto řešení může ovšem způsobit zpomalení systému u některých typů akcí (typicky vystavování mnoha dokladů, kdy se klient opakovaně dotazuje při přidělování posledních čísel dokladů a kdy je výhodné si existující spojení na databázi udržovat). Z výše uvedeného plyne, že může být i u singl instalace vhodné definovat spojení na databázi přes TCP/IP. Nevýhodou je, že toto spojení může být pomalejší oproti Local spojení. Tedy obě řešení mají své výhody a nevýhody a záleží na typu práce, kterou uživatel převážně provádí.

  Dále závisí na tom, zda Firebird je instalován ve variantě SuperServer, ClassicServer nebo SuperClassic, což se při instalaci detekuje a podle toho se příp. doplní spojení jako při síťové instalaci, tj. remote spojení, i v případě nesíťové instalace. Viz Instalace SQL serveru Firebird.

• Síťová instalace - V tomto případě běží aplikační server (viz Lokální/síťový režim (běhu systému ABRA Gen)) a je tudíž nutné, aby se databázový server konektoval pomocí Remote spojení, a to i tehdy, pokud databázový server běží na stejném počítači jako aplikační server. (Důvod viz Režim připojení k databázi (localspojení, remote spojení) výše.)

  Toho se dosáhne, pokud před cestu k databázi bude doplněna identifikace počítače, kde leží databázový server.

  Pro komunikaci aplikačního serveru s databázovým serverem je možné použít jeden z protokolů:

  • protokol TCP/IP: SERVER NAME=server:cesta\soubor.fdb
  • protokol NetBEUI: SERVER NAME=\\server\cesta\soubor.fdb

  Nejpoužívanější protokol je TCP/IP. U jiných protokolů je nutno počítat s tím, že nemusí být na všech počítačích k dispozici! Pro TCP/IP protokol může být místo jména serveru použita IP adresa IP adresa je v informatice číslo, které jednoznačně identifikuje síťové rozhraní v počítačové síti, která používá protokol IP. Slouží tedy k identifikaci uzlu v rámci propojení sítí IP, kdy každému uzlu je přidělena jedinečná adresa IP, která je tvořena identifikátorem sítě a identifikátorem hostitele. Adresa je obvykle reprezentována desítkovými hodnotami jednotlivých oktetů oddělených tečkou, například 192.168.7.27. nebo zástupné jméno localhost V počítačové terminologii localhost znamená odkaz na právě používaný počítač, tj. alias pro "tento počítač" resp. na většině počítačů alias pro speciální vyhrazenou IP adresu 127.0.0.1 (v protokolu IPv4) nebo ::1 (v protokolu IPv6). Typicky je používán jako alias pro "vlastní počítač", ale nemusí tomu tak být (může být použit např. při definice spojení mezi dvěma aplikacemi ležícími na "tomtéž" serveru (z hlediska jedné aplikace leží ta druhé na tom samém právě používaném počítači)..

  Objasníme na příkladech:

  Příklad 1: Mějme síťovou instalaci ABRA Gen pro Firebird, přičemž nechť aplikační server a Firebird leží na serveru, jehož jméno je Nexus, IP adresa např. 172.16.1.12 a soubor databáze leží v jeho adresáři C:\Firma\data.fdb. Potom v definici spojení na databázi (tedy mezi apl. serverem a databází) pro protokol TCP/IP může být buď SERVER NAME=Nexus:C:\Firma\data.fdb nebo SERVER NAME=172.16.1.12:C:\Firma\data.fdb a protože databáze běží na "tom samém popčítači" jako apl. server, může být i SERVER NAME=localhost:C:\Firma\data.fdb příp. SERVER Name=127.0.0.1:c:\Firma\data.fdb. (Localhost v tomto případě je tedy zástupné jméno pro "právě používaný počítač", což z hlediska aplikačního serveru je v našem příkladě server Nexus.)

  Příklad 2: Mějme síťovou instalaci ABRA Gen pro Firebird, ale tentokrát na jednom lokálním (vlastním) počítači, jehož jméno je např. MujNTB a IP adresa např. 173.10.1.10 (tj. na lokálním vlastním počítači máme instalaci ABRA Gen pro Firebird nakonfigurovanou síťově, tj. běžící přes aplikační server, Firebird a soubor databáze v adresáři C:\Firma\data.fdb. Potom v definici spojení pro protokol TCP/IP může být buď SERVER NAME=MujNTB:C:\Firma\data.fdb nebo SERVER NAME=localhost:C:\Firma\data.fdb nebo SERVER Name=127.0.0.1:c:\Firma\data.fdb, ale stačí i jen

  Příklad 3: Mějme nesíťovou instalaci ABRA Gen pro Firebird na počítači, který je zapojen do počítačové sítě pod názvem OBCHOD1 (tj. Firebird na tomtéž počítači, databáze nechť leží v adresáři C:\Firma\data.fdb. Potom v definici spojení stačí jen SERVER Name=c:\Firma\data.fdb (systém se zachová, jakoby bylo definováno SERVER Name=localhost:c:\Firma\data.fdb.

  Hodnota spojení na databázi je doplňována pro nové spojení s databází odpovídajícím způsobem při nové instalaci anebo při přidání spojení pomocí nástroje DBAdmin.

  Parametr SERVER Name má hodnotu:

  • pro Remote spojení (v syntaxi odpovídající TCP/IP protokolu) - pokud byla ABRA Gen s daňovou evidencí resp. ABRA Gen s podvojným účetnictvím instalována rovnou jako síťová verze volbou Nová ostrá instalace s licenčním klíčem, při níž byla v kroku Typ instalace zatržena možnost Síťová víceuživatelská instalace, anebo pokud přidáváme nové spojení k databázi v již provozované síťové verzi. Např. SERVER Name=localhost:c:\Firma\data.fdb

    Pokud je vyžadován jiný protokol, je možné jej nastavit pomocí specifikace cesty k databázi v parametrech spojení s databází (např. během instalace krok Rekapitulace, tlačítko Upřesnit anebo pomocí nástroje DBAdmin).

  • pro Local spojení - pokud byla ABRA Gen s daňovou evidencí resp. ABRA Gen s podvojným účetnictvím instalována jako singl verze (tj. demoverzní instalace nebo ostrá jednouživatelská) anebo pokud přidáváme nové spojení k databázi v již provozované singl verzi. Např. SERVER Name=c:\Firma\data.fdb

  Pokud tedy provádíte rozšíření ze singl instalace na instalaci síťovou, musíte mj. správně upravit spojení na databázi.

Aplikační server se spouští automaticky při spuštění klienta pouze v případě, je-li instalován na tomtéž počítači jako klient. V ostatních případech je třeba pro zdárný běh síťové verze zajistit jeho spuštění. Viz též Lokální/síťový režim (běhu systému ABRA Gen).