Instalace cizojazyčného klienta

Každý instalační soubor je určený pro určitou kombinaci lokalizace a internacionalizace systému ABRA Gen.

  • Lokalizace uváděná velkými písmeny (CZ, SK nebo CH) určuje, pro jaký národní legislativní rámec je instalace určena
  • Internacionalizace uváděná malými písmeny (cs, sk, de nebo en) určuje komunikační jazyk aplikace

Příklady:

  • AbraGen-L05-19.0.3-de-CZ-Firebird-release-137019-PU.exe - česká lokalizace, německá internacionalizace (tj. verze určená pro provoz v českém legislativním prostředí, komunikující s uživateli v německém jazyce)
  • AbraGen-L05-19.0.4-sk-SK-MSSQL-release-137075.exe - slovenská lokalizace i internacionalizace (tj. verze určená pro provoz ve slovenském legislativním prostředí, komunikující s uživateli ve slovenském jazyce)
  • AbraGen-L06-19.1.0-de-CH-Firebird-release-136227-PU.exe - švýcarská lokalizace, německá internacionalizace (tj. verze určená pro provoz ve švýcarském legislativním prostředí, komunikující s uživateli v německém jazyce)

Viz také sekce Název instalačního souboru v kapitole Instalační program a parametry.

K určitým konkrétním datům (zpřístupněným prostřednictvím jednoho databázového spojení) je možné souběžně přistupovat z klientských aplikací, které mají stejnou lokalizaci, ale odlišnou internacionalizaci.

V české firmě pracuje také několik zaměstnanců, jejichž rodným jazykem je angličtina.

  • Česky hovořící zaměstnanci používají klientskou aplikaci nainstalovanou ze souboru AbraGen-L06-19.2.2-cs-CZ-Firebird-release-141383-PU.exe.
  • Anglicky hovořící zaměstnanci používají klientskou aplikaci nainstalovanou ze souboru AbraGen-L06-19.2.2-en-CZ-Firebird-release-141383-PU.exe.
  • Obě skupiny zaměstnanců mají nakonfigurované prostředí tak, aby přistupovali ke stejným datům.

V minulosti platilo, že pokud se jednalo o tzv. nativní verzi, kdy byla lokalizace shodná s internacionalizací, označení internacionalizace se v názvu instalačního souboru neuvádělo. V současné době je kód internacionalizace součástí názvu instalačního souboru vždy, i když se jedná o kombinace cs-CZ nebo sk-SK.

Viz též Často kladené otázky k provozu cizojazyčného klienta (en/de verze).

Provozujete systém v síťové nativní verzi, určené pro českou legislativu, v českém jazyce. Několika uživatelům chcete nově poskytnout uživatelské rozhraní, které s nimi bude komunikovat anglicky (tj. půjde o jinou internacionalizaci).

Pokud provádíte kompletně novou instalaci (včetně nativní verze), nainstalujte nejprve síťovou nativní verzi (tj. v našem případě z instalačního souboru určeného pro českou lokalizaci i internacionalizaci) a proveďte obnovu dat. V dalším postupu předpokládáme, že máte nativní (v našem případě české) prostředí funkční.

Od dodavatele systému získáte instalační soubor určený pro produkt, linii, číslo verze, lokalizaci, databázi a revizi odpovídající nativní verzi. Lišit se bude pouze jazykem klienta (internacionalizací). Jak se pozná, pro jakou internacionalizaci je instalační soubor určen, viz popis struktury názvu instalačního souboru.

Pokud jste českou verzi instalovali z instalačního souboru AbraGen-L06-19.2.2-cs-CZ-Firebird-release-141383-PU.exe, budete pro instalaci anglicky komunikující verze potřebovat instalační soubor AbraGen-L06-19.2.2-en-CZ-Firebird-release-141383-PU.exe.

Instalační soubor určený pro cizojazyčnou (v našem případě anglickou) internacionalizaci spustíte a provedete novou instalaci (nikoli update) do nového umístění (prázdné složky). Během instalace zvolíte postupně možnosti Nová ostrá instalace s licenčním klíčem a Bez výchozích dat. Na volbě typu instalace (jednouživatelská nebo síťová) nezáleží, v dalším kroku ji ručně upravíte (v souboru NEXUS.CFG).

Na konci instalace v posledním dialogu zrušte zatržení u volby Spustit ABRA Gen. Pokud zatržení zrušit zapomenete, nic se nestane, ale budete zbytečně čekat na úpravy repozitoře a databáze, které k ničemu nepotřebujete a nebudete je používat.

Následně je zapotřebí tuto samostatnou instalaci zkonfigurovat pro provoz v síťovém režimu a nasměrovat (úpravou souboru NEXUS.CFG) na aplikační server, ke kterému se připojuje nativní verze:

  • V sekci [Client] souboru NEXUS.CFG cizojazyčné verze je třeba uvést parametry Local a ServerName. Hodnotou parametru Local bude 0 a hodnotou parametru ServerName bude název nebo IP adresa počítače s cílovou nativní instalací systému ABRA Gen.
  • V sekci [Server] je třeba uvést parametry ProviderType, příp. Port a ServiceNameSuffix, s hodnotami shodnými s konfigurací nativní instalace.

Po této úpravě konfigurace a prvním spuštění cizojazyčné verze dojde k připojení k aplikačnímu serveru nativní instalace a k instrumentaci její databáze. Instrumentace provede úpravu souboru repozitoře (většinou soubor Storage.STF). Dále nahraje přeložená systémová data (vybrané reporty, exporty, definovatelné formuláře) do databáze.

V praxi (při provozu ve stejné síti v rámci firmy) často stačí zkopírovat soubor NEXUS.CFG ze složky s nativní instalací do složky s cizojazyčnou instalací, bez jakýchkoli úprav, protože připojení k aplikačnímu serveru i umístění repozitoře je z pohledu všech instalací shodné.

Pro souběžný provoz různých jazykových verzí je zapotřebí, aby všechny instalace měly shodné číslo verze, a to včetně aplikovaných service packů.

V případě, že máte na serveru nastavenou kontrolu na administrátorské změny (zápis do Windows registrů je nutné vždy povolit) doporučujeme pro správné provedení instrumentace poprvé spustit cizojazyčnou verzi v režimu Správce, tzn pravým tlačítkem myši na zástupce nebo spustitelný soubor Abragen.exe a vybrat volbu Spustit jako správce.

  • Proveďte update nativní verze (tj. např. verze v české internacionalizaci) a následně proveďte aktualizaci všech spojení na databázi (tj. spusťte českou verzi pro všechna existující spojení). Postupujte úplně stejným způsobem, jako kdybyste cizojazyčnou internacionalizaci neprovozovali.
  • Zazálohujte si soubor NEXUS.CFG ze složky s cizojazyčným klientem.

  • Proveďte novou instalaci cizojazyčné verze (do existující složky se starší verzí cizojazyčné verze, ze které jste si v předchozím kroku zazálohovali soubor NEXUS.CFG).

    Technicky se nejedná o update, při instalaci skutečně vyberte možnost Nová ostrá instalace. Update byl již proveden v předchozím kroku, při instalaci nativní internacionalizace.

  • Zazálohovaný soubor NEXUS.CFG nakopírujte zpátky, aby se aktualizovaná instalace připojovala ke stejnému serveru a používala údaje ze stejné repozitoře jako dříve.
  • Aplikaci z aktualizované cizojazyčné instalace spusťte. Při prvním spuštění proběhne instrumentace databáze a doplnění repozitoře.

V praxi se může stát, že se instrumentace z nějakého důvodu nedokončí a některé části aplikace zůstanou nepřeložené. V takovém případě doporučujeme následující postup:

  • Spusťte nástroj StorExpl.exe ze složky s nativní instalací a pokud v repozitoři naleznete klíč LANG (na nejvyšší úrovni), odstraňte ho.
  • Zopakujte instalaci cizojazyčné verze podle výše uvedeného postupu.
  • V případě přetrvávajících problémů kontaktujte dodavatele.