K2 Instalátor
K2 Instalátor
Hlavní myšlenkou K2 instalátoru je sjednocení všech instalací, spojených s IS K2, do jednoho místa, odkud je možné každou opakovaně instalovat jako takzvanou novou instanci. Každou takovou instanci je možné instalátorem spravovat, to znamená opravit, aktualizovat nebo odinstalovat. Správu je možné provádět i hromadně pro vybrané instance napříč různými instalacemi.
Kapitola Popis instalátoru je věnována seznámení s uživatelským rozhraním instalátoru. Jsou zde popsány jeho základní funkce a přednosti.
Další kapitola Použití je již návodem, jak s instalátorem pracovat, jaké jsou požadavky na software a hardware a co případně dělat, pokud některá z instalací selže.
Předposlední kapitola Dostupné instalace je popisem jednotlivých instalací, které instalátor nabízí. Pro každou instalaci jsou detailně popsány jednotlivé vstupní obrazovky, tak aby uživatel neměl problém jakoukoliv z instalací úspěšně dokončit. Pokud jsou některé obrazovky instalátorů stejné, pak je popsán pouze rozdíl těchto instalací.
Poslední kapitola Rozšiřitelnost o další instalace pojednává o možnosti rozšíření K2 instalátoru o nové instalace.
Registrace uživatele k FTP infoservisu
Verze ke stažení a instalaci prostřednictvím K2 instalátoru jsou vždy distribuovány na FTP infoservis. Je tedy nutné, aby byl uživatel na Infoservisu registrován a měl nastaveno heslo na FTP. Jen pak bude mít přístup k novým instalacím.
Heslo k přístupu na FTP lze nastavit na infoservisu v Detailech uživatele. Zde je nutné stisknutím tlačítka Změnit přejít do změny uživatele.
Obr.: Infoservis - Detaily uživatele
Ve změně detailů uživatele infoservisu jsou zobrazena pole pro zadání hesla. Jedná se o Heslo na ftp a Heslo na ftp (znovu). V těchto polích je nutné danému uživateli nastavit a potvrdit heslo pro přístup k FTP infoservisu a k distribuovaným instalacím.
Obr.: Detaily uživatele - nastavení hesla na ftp
Provedené změny pak uložíme stisknutím tlačítka Uložit změny. Takto provedené změny uživatele infoservisu se projeví vždy do 24 hodin od jejich uložení!
Přihlášení uživatele do instalátoru
Pro správné použití K2 instalátoru je tedy nutné jeho přihlášení uživatelem k FTP infoservisu. Formulář pro zadání přihlašovacích údajů se zobrazí po spuštění instalátoru. Pokud se však uživatel již jednou přihlásí a v Nastavení si aktivuje volbu Automaticky přihlásit po spuštění, pak bude při dalším spuštění instalátoru přihlášen automaticky.
Obr.: Formulář pro přihlášení k FTP infoservisu
Informace o přihlášení uživatele je pak zobrazena v levém dolním rohu formuláře K2 instalátoru. Pokud je zde zobrazen text Nepřipojen, není instalátor v tuto chvíli připojen k FTP infoservisu. Text Nepřipojen je zde zobrazen např. pokud uživatel v přihlašovacím formuláři využije možnost Pokračovat bez přihlášení.
Přihlásit uživatele k FTP infoservisu je možné také pomocí tlačítka Přihlásit se, které je k dispozici v pravém horním rohu K2 instalátoru. Opět se zobrazí okno pro zadání přihlašovacích údajů.
Obr.: Tlačítko pro přihlášení k FTP infoservisu
Nepřihlášený uživatel nemá možnost instalovat nové verze distribuované prostřednictvím FTP infoservisu, může pouze pracovat v offline režimu s již nainstalovanými instancemi a staženými instalacemi.
Popis instalátoru - uživatelské rozhraní
K2 instalátor je aplikace, která slouží k instalaci a správě instalací produktů K2 atmitec spol. s r.o. K2 instalátor je nutné před použitím nainstalovat. Instalátor je dostupný ke stažení na K2 infoservisu v sekci Ke stažení, a to u jednotlivých verzí programu v části Ostatní.
Hlavní obrazovka instalátoru obsahuje záložky – Nové instalace, Nainstalováno, Vzdálená správa, Plán reinstalací, Ostatní instalace, Nastavení, Nápověda.
Nové instalace
Na záložce Nové instalace je k dispozici seznam všech dostupných instalací přihlášenému uživateli. Každá z možných instalací je definována názvem, popisem a ikonou. Jednotlivé instalace zde fungují jako skupiny (rozbalovací nabídky), které je možné rozbalit stisknutím levého tlačítka myši. Poté se zobrazí seznam dostupných dílčích instalací v rámci daného produktu (skupiny). Symbol vlajky zde slouží pro určení jazykové lokalizace dané verze.
Obr.: Záložka Nové instalace
Nainstalováno
Na záložce Nainstalováno je uveden seznam instalací, které již jsou na daném stroji nainstalovány.
Obr.: Záložka Nainstalováno
Jednotlivé instalace jsou zde rozděleny do skupin, které fungují jako rozbalovací nabídky. Každá z těchto nabídek obsahuje vždy seznam všech instancí nainstalovaných pro daný produkt (skupinu). U každé skupiny je uveden počet instalací, které obsahuje. Instalace jednotlivých produktů zde mohou být setříděny dle typu instalace nebo do uživatelem nadefinovaných složek. Pomocí ikony zobrazíme setřídění dle typu instalace. Setřídění dle uživatelem nadefinovaných složek zobrazíme stisknutím ikony . Obsah jednotlivých skupin je možné zobrazit kliknutím levého tlačítka myši.
Obr.: Záložka Nainstalováno
U každé instance je uveden její název a označení verze. Dále zde jsou sloupce pro datum instalace, případně aktualizace verze a umístění této instalace. Pokud je k dispozici po přihlášení uživatele novější verze, pak se v předposledním sloupci Instalace zobrazí číslo této dostupná verze se zeleným symbolem . U každé instalace je viditelná rovněž ikona . Pokud na tuto ikonu najedeme kurzorem myši, zobrazí se výpis detailních informací o každé instalaci daného produktu. Jedná se o totožné informace, jaké jsou uvedeny ve sloupcích, tzn., Produkt, Verze, Název, Skupina, Aktualizace, Umístění. Důležité je zde pole Dostupné aktualizace, kde jsou uvedeny všechny možnosti jak naložit s instalovanou verzí daného produktu.
Zobrazení dle skupin
Jednotlivé instalace na záložce Nainstalováno můžeme třídit do uživatelem vytvořených skupin. Režim zobrazení dle definovaných skupin zapneme pomocí ikony . Proces tvorby skupin a řazení instalací je jednoduchý. Sloupec Skupina je u každé instalace editovatelný. Dvojklikem levého tlačítka myši je možné do tohoto sloupce umístit kurzor a doplnit zde název skupiny, do které chceme instalaci zařadit.
Obr.: Záložka Nainstalováno - tvorba skupin
Stisknutím klávesy Enter se pak instalace do zadané skupiny zařadí. Instalace bez zadané skupiny budou přiřazeny do Instalací bez skupiny.
Obr.: Záložka Nainstalováno - vytvořené skupiny
Zařazení instalací do skupin lze následně využít v Plánu reinstalací.
Vzdálená správa
Vzdálená správa je nová funkčnost v K2 instalátoru, která slouží pro rychlejší a pohodlnější aktualizaci K2 produktů (aplikační server, webová K2, e-shop), které jsou nainstalovány na jiných serverech než samotná K2. Jediné, co nejde aktualizovat vzdáleně je pochopitelně samotná instalace K2.
Vzdálená správa v K2 instalátoru
Popis jednotlivých komponent
Na záložce Vzdálená správa můžeme vidět 4 tlačítka:
Pomocí toho tlačítka si můžeme připojit vzdálené počítače, na kterých jsou nainstalovány produkty K2. Po zmáčknutí se nám zobrazí formulář se vzdálenými počítači.
Správa vzdálených počítačů
V tomto formuláři si nadefinujeme vzdálené počítače, a to kliknutím do sloupce Vzdálený počítač. V dalším sloupci si můžeme přidat vlastní popis. Údaj Stažené soubory nás informuje o velikosti stažených souborů, které instalátor stáhl na vzdálený počítač a jsou potřebné pro aktualizaci produktu K2. Kliknutím na velikost tyto soubory vzdáleně odstraníme. Podobně je na tom sloupec Log soubory, který nám říká celkovou velikost souborů, které jsou typicky ve složce C:\K2Installer.tmp\. Dále se zde nachází verze K2 aktualizační služby. Pokud je zbarvena do červena, není aktuální, pokud do modra je aktuální. Poslední sloupec Stav nám slouží pro informaci o stavu připojení. Červené kolečko nám říká, že se nepodařilo navázat spojení se vzdáleným počítačem, zelené kolečko nám říká, že je spojení navázáno. Pokud nastane problém s připojením na vzdálený počítač, je zapotřebí zkontrolovat Firewall (případně povolený port s číslem 445) nebo antivirus.
Správa vzdálených počítačů - vložení nového počítače
Slouží pro aktualizaci / načtení vzdálených počítačů. Pokud si přidáme nové počítače do Správy vzdálených počítačů, použijeme dané tlačítko pro načtení produktů K2 ze vzdálených počítačů.
Slouží pro zobrazení podle typu instance.
Zobrazení podle typu instance
Slouží pro zobrazení dle námi nadefinovaných skupin.
Zobrazení dle nadefinovaných skupin
U těch K2 produktů, které se dají vypnout, jako je např. aplikační server, se vedle verze zobrazuje přepínač, který nám vrací aktuální stav (zelená – běží, červená – neběží, šedá – neznámý stav) a po kliknutím jej můžeme vypnout / zapnout. Lze použít i hromadnou funkci na zapnutí / vypnutí - přepínač se nachází v záhlaví tabulky. Vedle přepínače se nachází aktualizační ikona, která při kliknutí aktualizuje stav dané služby (vrátí stav přepínače).
Ukázka hromadného zapnutí/vypnutí K2 produktů
Poznámka
Může se stát, že při zapnutí aplikačního serveru pomocí přepínače dojde k zezelenání, ale po kliknutí na aktualizační ikonu se opět zobrazí červený stav přepínače. V tom případě je nutné se připojit na server, kde je daná služba a zkontrolovat proč nenaběhla.
Zbytek ikon je již znám ze záložky Nainstalováno.
Informace pro správnou fukčnost
Prvním krokem, aby bylo možné používat vzdálenou správu, je mít nainstalovaný instalátor a být přihlášen. Bez přihlášení do K2 instalátoru není tato funkce dostupná.
Vzdálená správa bez přihlášení
Dále je zapotřebí mít nainstalovanou aktuální K2 aktualizační službu na všech serverech, na kterých budeme chtít provádět vzdálenou reinstalaci. (Aktualizaci / reinstalaci produktů na vzdálených počítačích pak provádí právě produkt K2 aktualizační služba). Více informací k aktualizační službě naleznete v kapitole Dostupné instalace / Lokální instalace / K2 aktualizační služba. To, jestli máme na serveru nainstalovanou aktuální aktualizační službu, lze zjistit ze Správy vzdálených počítačů ve sloupci Verze služby. Pokud služba není aktuální, je dané pole červené, pro aktualizaci stačí na ni kliknout a zobrazí se dotaz, zda chceme aktualizační službu aktualizovat. Pokud je aktuální, tak je verze modrá.
Aktualizace aktualizační služby na vzdálených počítačích
Poznámka
Během aktualizace aktualizační služby se ikona o stavu změní na modré blikající kolečko, které nás informuje o tom, že se snaží získat stav. Během aktualizace aktualizační služby totiž dochází k jejímu smazání, tudíž nelze získat aktuální stav, proto má Správa vzdálených počítačů nastaven určitý timeout, který se doptává na stav, který je zobrazen modrým blikajícím kolečkem.
Průběh aktualizace aktualizační služby
Poznámka
Uživatel, pod kterým běží aktualizační služba na vzdáleném počítači, musí mít přístup ke složce, kde je nainstalovaná K2, jinak se během aktualizace může vyskytnout chyba.
Dalším důležitým předpokladem je, pokud je na serveru nainstalovaný aplikační server, je nutné, aby běžel pod doménovým účtem, který je zároveň i správcem na daném stroji.
Proces aktualizace produktů pomocí vzdálené správy
Nejprve si vybereme, na jakou verzi chceme daný K2 produkt aktualizovat. Pomocí výběru si vybereme konkrétní verzi, můžeme i hromadně, např. celou naši jednu skupinu. Pokud máme vybráno, na jakou verzi chceme přejít, stačí už pouze zmáčknout Proveď.
Ukázka spuštění aktualizace
Ve sloupci Nainstalováno se nám zobrazí indikátor průběhu, která říká, že daný produkt je v režimu aktualizace. Konkrétní stav aktualizace je popsán vedle běžícího indikátoru (může se jednat např. o stahování, aktualizaci …).
Ukázka průběhu aktualizace
Po úspěšné aktualizaci se zobrazí formulář s informací „Vzdálená aktualizace proběhla úspěšně.“
Hlášení o úspěšné aktualizaci
Pokud máme vše zaktualizováno, zkontrolujeme, zda nám služby, které mají běžet, běží a to pohledem na přepínač (má mít zelený stav). Můžeme ověřit i v K2 např. přihlášený aplikační server.
Nakonec můžeme po sobě "uklidit" na vzdálených počítačích, a to jak stažené soubory potřebné k aktualizaci, tak logy, které vznikly. Otevřeme si Správu vzdálených počítačů (zelené tlačítko s ikonou počítače) a pokud chceme smazat stažené soubory, klikneme do sloupce Stažené soubory na velikost, kterou zabírají. Posléze se nám objeví dotaz, zda opravdu chcete smazat soubory. To samé můžeme provést s logy.
Mazání stažených souborů
Plán reinstalací
Plány reinstalací umožňují připravit a spustit hromadnou reinstalaci produktů K2. Princip spočívá v tom, že si jednotlivé instalace produktů vložíme do skupin, které následně použijeme v plánu reinstalace. (Zařazení produktů do skupin je popsáno v kapitole Nainstalováno, část Zobrazení dle skupin). Plán zajistí reinstalaci všech produktů jednoduchým spuštěním bez nutnosti konfigurace reinstalačního manažera v IS K2, bez nutnosti odhlašování uživatelů a dalších předinstalačních kroků. Správcům se zjednoduší a zrychlí reinstalace.
Obr. Plán reinstalací
Poznámky:
Plán reinstalací je dostupný pouze tehdy, pokud je uživatel přihlášený.
Produkt IS K2 lze reinstalovat pouze z počítače, na kterém je nainstalován, tedy není povoleno provádět vzdálenou aktualizaci K2.
Plány reinstalací doporučujeme používat pouze pro reinstalace v rámci jednoho releasu, nebo mezi releasy jedné generační verze IS K2.
Vytvoření plánu reinstalace
Na záložce Plán reinstalací můžeme vidět seznam definic plánů reinstalací.
Pro vytvoření nového plánu použijeme tlačítko Vytvořit nový plán reinstalace.
Vytvoření nového plánu reinstalace
Zobrazí se formulář pro definici plánu reinstalace.
Definice plánu reinstalace
Uživatelské akce:
Pomocí této funkce lze spustit některou z předem nadefinovaných uživatelských akcí před nebo po reinstalaci. Takto nadefinované akce se poté automaticky spouští v rámci plánu reinstalace. Tato funkce se nejčastěji využívá pro zálohu databáze a souborů před reinstalací.
Pokud chceme přidat akci, stiskneme tlačítko (zelené plus) a zobrazí se nám formulář pro nastavení akce – obrázek.
Nová uživatelská akce
Spustit: Vybírá se, kdy danou akci spustit. Na výběr je ze dvou možností:
- Spustit na začátku reinstalace
- Spustit na konci reinstalace
Akce: Vybírá se jaká akce se má spustit. Na výběr je ze dvou možnosti:
- Zálohovat databázi
- Zálohovat soubory
Název: Název akce
Operace: Uvádí se, co se má zálohovat a kam. Nový záznam se vytvoří dvojklikem do příslušného sloupečku.
1. Pokud je vybrána akce Zálohovat databázi.
V tomto případě v první sloupci pomocí dvojkliku zadáváme server a název databáze, která se má zálohovat do sloupečku Název serveru a databáze (server@databaze). Název musí být ve tvaru, jaký je uveden v závorce, tedy název serveru@název databáze.
Do sloupce Výstupní adresář pro zálohu napíšeme cestu (včetně názvu souboru pro backup), kam se má databáze zálohovat. Důležité je, aby databázový server viděl na výstupní složku, jinak se záloha neprovede.
Zálohovat databázi
Např. máme server TS1 a k tomu máme databázi K2 a K2_Demo. Danou složku budu chtít uložit na lokální c:\ do souboru ZalohaDB. Samozřejmě lokální c:\ je viditelné pro databázový server. Akci budu chtít spustit před reinstalací a pojmenuji si ji Záloha databáze.
Na obrázku je zobrazeno, jak by taková akce vypadala.
Akce zálohovat databázi
2. Pokud je vybrána akce Zálohovat soubory.
V tomto případě v prvním sloupci Maska souborů pomocí dvojkliku zadáme masku souborů a do sloupce Výstupní adresář pro zálohu zadáme cestu, kam se mají soubory uložit.
Lze použít tři varianty v masce souborů:
- c:\temp\*.* - všechny soubory z tohoto adresáře
- c:\temp\*.pas - všechny pas z tohoto adresáře
- c:\temp - všechno, včetně podadresářů z tohoto adresáře.
Zálohovat soubory
Např. chci uložit všechny soubory, které jsou ve složce mandanta DEMO a pouze skripty (vše co má příponu *.pas) ve složce SestavyW. Budu je chtít uložit před reinstalací do složky c:\ZalohaSouboru. Danou akci si pojmenuji Záloha souborů.
Na obrázku je vidět výsledné nastavení.
Akce Zálohovat soubory
Poznámka:
Při zadávání výstupního adresáře lze použít i makro {date}. Například C:\Temp\{date}\Soubor.bak kde date se nahradí za aktuální datum. Vytvoří se záloha vždy v jiném adresáři. respektive daný den.
Vyplníme název plánu a pomocí ikony si vybereme skupiny, které chceme zařadit do plánu a tím je i zreinstalovat. (V nabídce jsou všechny aktuální nainstalované produkty zařazené do skupin (ze záložky Nainstalováno) a produkty zařazené do skupin ze Vzdálené správy).
Přiřazení skupin do plánu reinstalace
Po potvrzení se vytvořený plán objeví v seznamu reinstalací, jak můžeme vidět na obrázku.
Vytvořený vlastní plán reinstalace
Popis sloupců:
Název - název plánu
Vytvořeno - kdy byl plán vytvořen
Změněno - kdy byl plán změněn
Počet - počet skupin v plánu
Tlačítka:
Smazat - smaže daný plán
Změnit - umožní provést změnu plánu
Spustit - spustí plán
Spuštění plánu reinstalace
Plán spustíme pomocí tlačítka Spustit z konkrétního řádku plánu.
Spuštění vlastního plánu reinstalace
Instalátor nám nabídne plán ještě ke kontrole. V záhlaví v poli Verze vybereme verzi, na kterou chceme reinstalovat, a pokud vše souhlasí, potvrdíme plán pomocí tlačítka Potvrdit a zobrazit schéma.
Rekapitulace plánu reinstalace
Po potvrzení plánu se objeví diagram plánu reinstalace, kde můžeme vidět, jak reinstalace bude probíhat. Na začátku reinstalace se nejprve vypnou aplikace (aplikační server, webová K2), na eshopu se nastaví udržbová stránka a z K2 se odhlásí uživatele a dojde k nastavení reinstalačního manažera. Dále začne na všech serverech pararelně probíhat reinstalace (včetně stahování verze) všech produktů ze skupin, které se nacházejí v plánu reinstalace. Po doběhnutí úspěšné instalace se spustí aplikace jako aplikační server, webová K2 a eshop. K2 v Reinstalačním manažerovi vypne zákaz přihlášení.
Ukázka diagramu plánu reinstalace
Najetím na jednotlivé komponenty diagramu můžeme zjistit co se v dané sekci bude odehrávat.
Ukázka zobrazení informace k dané sekci plánu - webová K2
Reinstalaci zahájíme pomocí tlačítka Spustit plán reinstalace (vlevo nahoře). Dále můžeme ve spodní části sledovat průběh plánu v %, uplynulý čas, nebo si diagram přiblížit, či oddálit.
Ukázka průběhu plánu
Pokud během instalace některého z produktů nastane chyba, tak daná akce pro produkt zčevená. Po najetí myší na danou akci se zobrazí krátka informace (informace se nám zobrazí i na zeleně zbarveném produktu).
Ukázka nedoknčené instalace aplikačního serveru
Dvojklikem myši si můžeme zobrazí log a informace o instalaci pro příslušný produkt.
Ukázka logu z nedokončené reinstalace aplikačního serveru
Pokud doběhne celý plán reinstalace a všechny kroky jsou zelené, reinstalace doběhla v pořádku a je možno plán ukončit pomocí tlačítka Ukončit.
Úspěšně dokončená reinstalace dle reinstalačního plánu
Pokud je v instalátoru nastaveno SMTP a email pro zasílání informaci (blížší popis zde), po doběhnutí plánu nám příjde informace o doběhnutém stavu.
Informace obdržená emailem o stavu plánu reinstalace.
Ostatní instalace, nastavení a nápověda
Ostatní instalace
Na záložce Ostatní instalace jsou k dispozici instalace programů, které nejsou nezbytně nutné pro funkčnosti IS K2, ale mohou být užitečné. Jedná se instalace programů Adobe Acrobat Reader, Oracle Call Interface (OCI) klient 11.1. a Microsoft .NET Framework 4.5.1. Dále jsou zde instalace rozšíření IIS (IIS URL Rewrite 2.1 x64 a PHP 5.3 pro IIS) a Microsoft Visual C+ +, nutné pro bezproblémovou instalaci produktu K2 E-shop.
Nastavení
Záložka pro nastavení základních vlastností K2 instalátoru.
Obr.: K2 instalátor - záložka Nastavení
Popis polí:
Název |
Popis |
Cesta k dočasným souborům instalátoru |
Pole pro nastavení cesty k dočasným souborům instalátoru. |
Cesta ke staženým instalacím |
Nastavení cesty k uloženým instalacím (aktualizacím). Z tohoto uložiště pak instalátor vybrané a stažené instalace spouští.
|
FTP server pro aktualizace |
Cesta ke stažení K2. Pokud není vyplněno, bere se z konfigurátoru. |
Zobrazení dostupných verzí produktů ke stažení |
Pomocí této volby je možné přihlášenému uživateli na záložce Nové instalace filtrovat verze nabízené k instalaci z FTP infoservisu.
Touto volbou jsou rovněž ovlivněny verze dostupné pro aktualizaci na záložce Nainstalováno. |
Implicitní setřídění nainstalovaných produktů |
V tomto poli je možné nastavit způsob setřídění nainstalovaných produktů v jednotlivých skupinách na záložce Nainstalováno. |
Jazyk instalací ke stažení |
Zde je možné zvolit jazykovou lokalizaci instalací IS K2, které se budou přihlášenému uživateli nabízet ke stažení a následnému použití. Tato volba se týká pouze instalací IS K2. |
Automaticky přihlásit po spuštění |
Zapnuto: Při spuštění instalátoru dojde k automatickému přihlášení uživatele k FTP infoservisu. Vypnuto: Při spuštění instalátoru je uživatel vyzván k přihlášení. |
Hromadné reinstalace provádět v tichosti |
Pokud je tento příznak zatržen, provádí se hromadné reinstalace v "tichosti", bez nutnosti potvrzovat jednotlivé kroky. Tuto možnost lze využít u všech produktů kromě reinstalací IS K2. |
Uložené přihlašovací údaje |
Tlačítkem Smazat dojde k výmazu uložených přihlašovacích údajů uživatele k FTP infoservisu a po spuštění instalátoru bude přihlášení znovu vyžadováno. |
Stažené instalace |
Tlačítkem Smazat dojde k vymazání všech stažených instalací z disku. |
SMTP server adresa/port |
Adresa a port SMTP serveru pro odesílání emailů. |
SMTP uživatel/heslo |
Uživatel a heslo SMTP serveru, pokud je vyžadováno. |
Email pro zasílání informací |
Email, na který budou zaslány informace. |
Nápověda
Na záložce Nápověda je uvedena verze K2 instalátoru. Dále jsou zde důležité odkazy pro nápovědu a technickou podporu. Ve spodní části této záložky jsou k dispozici systémové informace stroje, na kterém je K2 instalátor nainstalován a spuštěn.
Lokalizace
K2 instalátor je plně lokalizován do českého a anglického jazyka. Každá instalace, která je v rámci instalátoru k dispozici, je rovněž plně lokalizována do českého a anglického jazyka. Jazyk se použije vždy v závislosti na prostředí OS Windows.
Překladem textů je možné instalátor jednoduše rozšířit o další jazyky.
Použití
Spuštění instalátoru
K2 instalátor je automaticky spouštěn v režimu se správcovským oprávněním. Spuštění K2 instalátoru probíhá pomocí souboru "K2Installer.exe".
Nutným předpokladem je zajištění potřebné softwarové a hardwarové výbavy počítače, na kterém budeme instalátor používat.
Softwarové požadavky
- Klientský operační systém - Windows 10 a vyšší
- Serverový operační systém - Windows Server 2012 a vyšší
- .NET Framework 4.5
- Windows Installer 3.1 a vyšší
Hardwarové požadavky
- Procesor - 1 GHz
- Paměť RAM – 512 MB
- Pevný disk – Instalátor vyžaduje k úspěšnému spuštění instalace alespoň tolik místa na disku C, kolik je velikost spouštěného instalačního balíčku + 20 MB.
Aktualizace instalátoru
Při každém přihlášení k FTP infoservisu probíhá kontrola aktualizací K2 instalátoru. Pokud je nalezena dostupná aktualizace nabídne ji K2 instalátor ke stažení.
Obr.: Stažení dostupné aktualizace K2 instalátoru
Stisknutím tlačítka Ano danou aktualizaci uložíme. Po stažení aktualizace nabídne K2 instalátor tuto aktualizaci automaticky k instalaci.
Obr.: Instalace dostupné aktualizace K2 instalátoru
Stisknutím tlačítka Ano dojde ke spuštění Průvodce instalací produktu K2 instalátor.
Obr.: Průvodce instalací produktu K2 instalátor
Instalace
Instalaci libovolného typu produktu je nutné před vlastní instalací vždy stáhnout a uložit na disk. K tomuto účelu slouží tlačítko Stáhnout. Po uložení se u vybrané a stažené instalace zpřístupní tlačítko Instalovat. Stisknutím tohoto tlačítka spustí instalátor instalaci daného produktu. Tlačítko Odebrat slouží k vymazání stažené instalace z lokálního disku.
Obr.: Spuštění instalace
Jednotlivé instalace mají různé vstupní obrazovky vždy dle produktu, který je instalován, viz kapitola Dostupné instalace.
V případě, že instalace proběhne bezchybně, zobrazí se hlášení o úspěšném dokončení instalace. Po přepnutí na záložku Nainstalováno pak uvidíme, že v daném typu instalace přibude nový záznam o nainstalované instanci.
Pokud naopak dojde během instalace k chybě, zobrazí instalace hlášení, že nebyla dokončena.
Další možnosti
Jak již bylo zmíněno, na záložce Nainstalováno jsou k dispozici všechny nainstalované instance produktů. Tato záložka slouží pro správu těchto jednotlivých instalací, tzn. pro jejich aktualizaci, opravu nebo odinstalování.
Pokud je po spuštění instalátoru a přihlášení uživatele na FTP infoservisu nalezena vyšší verze, nabídne ji instalátor u dané instance k instalaci a označí ikonou . Instalátor nabízí k aktualizaci instalované verze vždy nejvyšší (nejaktuálnější) verzi v rámci releasu. Při nabízení verze k aktualizaci dodržuje instalátor také logiku přechodu mezi verzemi a u IS K2 rovněž jazykovou lokalizaci. Není tak možné např., slovenskou verzi IS K2 reinstalovat na verzi českou. Aktualizaci dané instance pak provedeme pomocí tlačítka Proveď. Tlačítko Odinstalovat slouží pro spuštění odinstalace vybrané verze.
Obr.: Záložka Nainstalováno - aktualizace verze
Pole s číslem verze pro aktualizaci je možné otevřít. V zobrazeném okně je vždy uvedena nabídka všech dostupných verzí, které je možné instalovat. Tato nabídka čerpá ze stažených a uložených verzí na disku a z FTP infoservisu. Pokud zde vybereme nižší verzi než je aktuálně nainstalovaná instance, zobrazí se zde ikona . Takto lze instanci degradovat na její nižší verzi.
Obr.: Záložka Nainstalováno - instalace nižší verze instance
Instalace v rámci skupiny je možné hromadně sjednotit na jednu vybranou verzi. K tomu slouží pole v záhlaví každé skupiny. Instalátor zde automaticky doplní nejnovější možnou společnou verzi k instalaci, nalezenou na lokálním disku nebo FTP infoservisu. Verze je pak označena ikonou . Pole je možné otevřít a zobrazit si seznam všech dostupných instalací. Stisknutím tlačítka Proveď instalátor provede postupně aktualizace všech instancí ve skupině na vybranou verzi.
Obr.: Záložka Nainstalováno - hromadná aktualizace (sjednocení) verzí
Výběrem totožné verze k instalaci můžeme prostřednictvím K2 instalátoru provádět také opravy již nainstalovaných instancí. K2 instalátor tuto verzi označí ikonou . Stisknutím tlačítka Proveď dojde ke spuštění instalace (opravy) této verze.
Obr.: Záložka Nainstalováno - oprava instalace
Reinstalace "v tichosti"
Hromadné reinstalace produktů ve skupinách je možné provádět "v tichosti", tzn. bez nutnosti potvrzovat jednotlivé kroky prováděné akce. Tento způsob je možné využít u všech produktů kromě reinstalace Informačního systému K2. Pro zprovoznění této možnosti je nutné aktivovat parametr Hromadné akce provádět v tichosti, který je dostupný na záložce Nastavení.
Co dělat při potížích
Pokud dojde při instalaci k jakékoliv chybě, která zabraňuje v jejím pokračování, zobrazí se okno s popisem, že došlo k přerušení této instalace, viz Obr.: Předčasné ukončení. V tomto případě je potřeba prohlédnout logovací soubor, zda neobsahuje podrobnější informace o chybě. Log soubor je uložen ve složce instalátoru K2Installer.tmp na disku C, a jeho název je ve formátu log_název produktu_datum a čas instalace.txt.
Pro snadnější odhalení a následnou opravu chyby doporučujeme zaslat log soubor na infoservis.
Obr.: Předčasné ukončení
Dostupné instalace
Instalace IS K2
Tento instalační balíček slouží k instalaci informačního systému K2.
Pro stávající uživatele
Od verze "MONDE" je k dispozici instalace K2 pomocí instalačního balíku MSI. Původní instalátor již nebude dále distribuován. Změna instalátoru vede i ke změně filosofie instalace, kterou si vyžádalo použití MSI balíku. Zejména pro účely instalace K2 je potřeba vyhradit jeden stroj, ze kterého se K2 bude instalovat. Záznamy o nainstalovaných aplikacích se totiž uchovávají v registru daného počítače a instalace z jiné stanice o nainstalovaných produktech tedy nic neví.
Softwarové požadavky - instalace K2
Oproti K2Installeru je vyžadován Microsoft .NET Framework 4.5 nebo vyšší, který lze stáhnout a nainstalovat z http://www.microsoft.com/cs-cz/download/details.aspx?id=30653. MSI balík tuto skutečnost neumí detekovat, proto je dobré se nejprve podívat do ovládacích panelů do sekce odebrat program, zda je výše uvedený modul nainstalován.
Nová instalace
Po spuštění instalace a splnění výše uvedených podmínek se zobrazí první dialog, který uživatele informuje, že je spuštěn instalátor pro produkt „K2“, viz Obr.: Start instalace K2.
Obr.: Start instalace K2
Po stisknutí tlačítka Další přejdeme k druhému dialogu, který obsahuje licenční ujednání, které po přečtení musíme akceptovat, abychom mohli pokračovat dále. Ujednání akceptujeme zatrhnutím volby S podmínkami licenční smlouvy souhlasím, viz Obr.: Licenční ujednání K2.
Obr.: Licenční ujednání K2
Tlačítkem Další se dostaneme na třetí dialog, kde je uživatel vyzván k zadání cesty, kam se má IS K2 instalovat, viz Obr.: Cílový adresář K2. Tlačítkem Změnit můžete procházet klasickým dialogem adresáře na fyzických discích, případně na síti.
Obr.: Cílový adresář K2
Po výběru adresáře a stisku tlačítka Další se zobrazí formulář, který vyzve uživatele, aby zvolil databázovou platformu, viz Obr.: Výběr databázové platformy - MS SQL. Vždy je potřeba zvolit jméno serveru, které se automaticky doplňuje jako jméno počítače, z něhož se IS K2 instaluje a dále název hlavního katalogu, který je automaticky doplněn podle vybraného adresáře.
Obr.: Výběr databázové platformy - MS SQL
Pokud je zvolena instalace na "Oracle", je potřeba vyplnit ještě další údaje pro připojení k serveru a to uživatel, heslo a tablespace, viz Obr.: Výběr databázové platformy - Oracle.
Obr.: Výběr databázové platformy - Oracle
Dialog obsahuje ještě tři tlačítka. Tlačítko Testovat připojení slouží k ověření připojení podle zadaných údajů. Test není nutné spouštět, protože probíhá i při stisku tlačítka Další. O výsledku testu jsme informováni třemi možnými okny. První informuje o úspěšném připojení viz Obr.: Úspěšné připojení, druhý o chybných přihlašovacích údajích viz Obr.: Neúspěšné připojení a třetí o konfliktu jmen katalogů viz Obr.: Databáze existuje. Neúspěšné připojení nastane, pokud je špatně zadán server nebo uživatel a heslo (na Oracle) nebo je špatná kombinace hodnot v jazykovém nastavení katalogů viz. tlačítko Rozšířené.
Obr.: Úspěšné připojení
Obr.: Neúspěšné připojení
Obr.: Databáze existuje
Tlačítko Rozšířené slouží k jazykovému nastavení katalogů. Není nutné nastavovat, pokud se použitý jazyk K2 nebude shodovat s jazykem instalace. Podle jazyku IS K2 v balíku MSI se automaticky doplní hodnoty. Pokud nevyhovují požadavkům uživatele IS K2, je možné je změnit viz Obr.: Nastavení jazykových proměnných. Toto nastavení by měla provádět osoba, která je znalá problému, jinak není zaručeno, že K2 bude pracovat správně při komunikaci s databázemi.
Obr.: Nastavení jazykových proměnných
Tlačítko Obnov rozšířené obnoví hodnoty jazykového nastavení podle jazyka IS K2 v balíku MSI.
Po úspěšném nastavení a stisku tlačítka Další, vybereme z dalšího formuláře licenční soubor pro danou verzi systému K2.
Obr.: Výběr licenčního souboru
Pokud cestu k licenčnímu souboru nevyplníme, na konci instalace bude instalátor znovu požadovat načtení tohoto souboru.
Obr.: Hlášení o nekorektní licence
Obr.: Hlášení o možnosti načtení nové licence
Po stisknutí tlačítka Další na formuláři pro vyplnění cesty k licenčnímu souboru v instalaci se zobrazí formulář s možností instalace některých volitelných součástí IS K2, viz Obr.: Nastavení volitelných součástí instalace. V současnosti lze pouze změnit nastavení komponent jazyka R.
V tomto formuláři nastavujeme Stav K2, který slouží pro účely odesílání informací o použití licence do společnosti K2 atmitec. Pokud zatrhneme pole Produkční K2, bude IS K2 registrován jako produkční, pokud pole nezatrhneme, IS K2 bude testovací a jeho funkčnost bude omezena.
Obr.: Nastavení volitelných součástí instalace
Po stisku tlačítka Nainstalovat začne probíhat instalace IS K2. O jejím průběhu jsme informováni ukazatelem průběhu, viz Obr.: Průběh instalace. Může se stát, že se ukazatel zastaví a vypadá to, jako že se nic neděje. V tomto případě je dobré se podívat na lištu nebo do procesů systému, jestli neběží již programy K2 a to buď "k2_sqlrs" nebo "k2wimport", které jsou schovány za oknem zobrazující průběh instalace.
Obr.: Průběh instalace
O úspěšné instalaci jsme informováni následujícím dialogovým oknem, viz Obr.: Dokončení instalace. Na této obrazovce je k dispozici zatrhávací pole Spustit K2. Pokud je toto pole zatrženo, zobrazí se automaticky dialogové okno pro spuštění IS K2 ihned po dokončení instalace.
Obr.: Dokončení instalace
V případě chyby při instalaci bude zobrazeno okno, viz Obr.: Neúspěšná instalace.
Obr.: Neúspěšná instalace
Přebrání stávající K2
Přebrání stávající instalace IS K2 je akce, při které se K2 instaluje do již existujícího adresáře s již existující K2 instalovanou starým instalátorem, tedy při přechodu 133 -> MONDE, nebo v případě, že z nějakého důvodu bylo potřeba odinstalovat IS K2. Důležitá je přítomnost souborů "k2_3main.ini" v případě verze 133 nebo "k2.ini" v případě verze MONDE a vyšší a dále souboru "sysk2.ini". Z těchto ini souborů se přečtou informace potřebné k úspěšné instalaci K2. Přebrání probíhá stejným způsobem jako instalace IS K2. Rozdíl je při zobrazení dialogového okna nastavení databázové platformy, kdy jsou některá pole šedá, protože jejich změna není žádoucí. U Oracle je potřeba doplnit pouze údaje o uživateli a heslu.
Obr.: Dotaz na přebrání stávající instalace
Logy instalací
K2 instalátor po provedení jakékoliv akce (instalace, reintalace, odebrání produktu) zobrazí hlášení o jejím dokončení. Zde má uživatel dvě možnosti.
Obr.: Dokončení instalace
Stisknutím tlačítka Zavřít, dojde k uzavření formuláře. Pomocí tlačítka Zobrazit informace o instalaci je možné zobrazit detailní informace o provedené akci. Každá akce realizovaná prostřednictvím instalátoru se zaznamenává do textového souboru a ukládá se do složky K2Installer.tmp.
Obr.: Detailní informace o instalaci
V případě, že je instalátorem provedena hromadná reinstalace v tichosti, tzn. bez nutnosti odsouhlasit jednotlivé kroky, zobrazí instalátor na konci této akce okno s informacemi o všech provedených instalacích. I zde je pak možné, pomocí tlačítka Detail, zobrazit detailní záznam o provedené akci.
Obr: Informace o instalacích provedených "v tichosti"
Pokud je některý z výsledných log souborů příliš velký, není zde načtený ihned, ale až po kliknutí na viditelný odkaz.
Obr.: Odkaz pro zobrazení logu
Výsledné log soubory lze uložit do "*.ZIP" archívu a připravit je takovýmto způsobem např. pro odeslání. Uložení log souborů je možné provést kliknutím na tlačítko Připravit log soubory k odeslání. Otevře se dialogové okno ve kterém zvolíme název souboru a vybereme složku, do které chceme soubor uložit. Do vzniklého "*.ZIP" archívu se uloží všechny log soubory vztahující se k právě dokončené akci a součástí tohoto archívu je vždy rovněž soubor s názvem SystemInfo, který obsahuje systémové informace o počítači, na kterém je K2 instalátor nainstalován a spuštěn. Jedná se o totožné informace, které jsou uvedeny na záložce Nápověda v K2 instalátoru.
Log soubory z instalační služby, tzn. ty na záložce Windows log instalace, je možné otevřít v poznámkovém bloku kliknutím na příslušné tlačítko.
Lokální instalace
Tento typ instalace je dostupný od verze K2 mona. Jedná se o instalaci IS K2 na lokální počítač, s tím, že je datově napojena na serverovou instalaci a zajišťuje tak, že budou mít vždy stejné verze. Lokální instalace se tedy dokáže automaticky reinstalovat, v případě, že dojde k aktualizaci serverové instalace.
Přínosem lokální instalace je především rychlost spuštění programu K2. Lokální instalace obsahuje všechny binární soubory, lokalizační soubory a soubory nápovědy. Všechny ostatní datové soubory sdílí lokální instalace s instalací serverovou.
Instalátor pro lokální instalaci nalezneme v adresáři serverové K2 a to ve složce SupportFiles\LocalInstall. Z tohoto umístění je možné spustit instalátor pro tuto instalaci. Instalaci tedy spouštíme vždy ze serverové K2, ke které chceme lokální instalaci IS K2 nainstalovat.
Instalátor spouštíme z uvedeného umístění pomocí souboru "K2Installer.exe". Po spuštění se zobrazí obrazovka instalátoru s produktem Lokální instalace.
Obr.: Instalátor pro Lokální instalaci
Vlastní instalaci spustíme pomocí tlačítka Instalovat. Po spuštění se zobrazí první dialog, který informuje uživatele, že je spuštěn instalátor pro produkt Lokální instalace K2.
Obr.: Start lokální instalace K2
Po stisknutí tlačítka Další přejdeme k druhému dialogu, který obsahuje licenční ujednání, které je nutné po přečtení akceptovat, abychom mohli pokračovat dále. Ujednání akceptujeme zatrhnutím volby S podmínkami licenční smlouvy souhlasím.
Obr.: Licenční ujednání K2
Pomocí tlačítka Další se dostaneme na třetí dialog, kde je uživatel vyzván k výběru adresářů. V poli Složka instalace zadáváme cestu, kam se má lokální K2 nainstalovat. Tlačítkem Změnit můžeme procházet klasickým dialogem adresáře na fyzických discích. Po vybrání adresáře instalátor do cesty doplňuje ještě instanci lokální instalace, např. pro první instalaci to je K2, pro druhou K2_I1, pro třetí K2_ I2, atd., proto je vhodné cestu ještě před stiskem tlačítka Další zkontrolovat, popř. změnit. Toto chování má opodstatnění ve chvíli, kdy instalujeme více lokálních K2 a máme pro ně připraven jeden společný adresář. Nedoporučujeme instalovat lokální K2 do složky Program Files, případně Program Files (x86). V tomto případě se může objevit problém s aktualizací K2!
Do pole Složka hlavní K2 zadáváme cestu k adresáři s instalací serverové K2, ke které je tato lokální K2 instalována. Vždy se zde nabízí cesta ke K2, ze které je lokální instalace spuštěna. Měla by zde být uvedena vždy UNC cesta.
Obr.: Výběr cílového adresáře
Složka, do které se instaluje lokální instalace K2, musí mít nastaveno oprávnění typu „Měnit“ pro uživatele, který lokální instalaci spouští.
Obr.: Nastavení oprávnění
Další obrazovka, která se zobrazí po stisknutí tlačítka Další, je již pouze přehledem součástí instalace.
Obr.: Přehled součástí lokální instalace
Po stisku tlačítka Nainstalovat začne probíhat instalace lokální K2.
Obr.: Průběh lokální instalace
Nakonec je uživatel informován o úspěšné instalaci lokální K2. Stisknutím tlačítka Dokončit instalaci lokální K2 ukončíme. Zástupce lokální instalace K2 se zobrazí v nabídce Start ve Windows.
Obr.: Dokončení lokální instalace
Řešení známých potíží
Pokud systém K2 nelze spustit a zůstává přihlašovací obrazovka, je zapotřebí jej spustit ve správném režimu. Nahrání našich k2p_*.bpl brání interní antivir Windows.
Vypnutí provedete v internetovém prohlížeči přes Nastavení ® Aktualizace zabezpečení ® Zabezpečení Windows ® Ochrana před viry a hrozbami ® Ochrana v reálném čase.
K2 aktualizační služba
K2 Aktualizační služba zajišťuje shodu verzí mezi serverovou a lokální instalací IS K2. Tato služba zajišťuje aktualizaci lokální instalace K2, a to i v případě, kdy nemá uživatel právo na daném počítači instalovat jakékoliv aplikace.
Produkt K2 Aktualizační služba je potřeba mít nainstalován také pro Vzdálenou správu instalací, viz kapitola Informace pro správnou funkčnost.
Instalace aktualizační služby
Instalátor pro K2 aktualizační službu nalezneme v adresáři serverové K2 a ve složce SupportFiles\LocalInstall\Packages\UpdateService. Instalátor K2 aktualizační služby bychom tedy měli spouštět vždy z adresáře serverové K2 ke které máme nainstalovanou lokální K2.
Instalátor spouštíme z uvedeného umístění pomocí souboru "K2UpdateServiceInstallation.msi". Po spuštění se zobrazí obrazovka instalátoru s informací o instalaci produktu K2 aktualizační služby.
Obr.: Start instalace K2 aktualizační služby
Po stisknutí tlačítka Další přejdeme k druhému dialogu, který obsahuje licenční ujednání, které je nutné po přečtení akceptovat, abychom mohli pokračovat dále. Ujednání akceptujeme zatrhnutím volby S podmínkami licenční smlouvy souhlasím.
Obr.: Licenční ujednání K2
Pomocí tlačítka Další se dostaneme na třetí dialog, kde je uživatel vyzván k výběru cílového adresáře pro instalaci K2 aktualizační služby. Změnit adresář, do kterého se bude K2 aktualizační služba instalovat, můžeme pomocí tlačítka Změnit.
Obr.: Výběr cílového adresáře
V dalším kroku instalace je zatrhávací pole Spouštět uživatelům aplikaci pro notifikaci událostí. Pokud je toto pole zatrženo, bude spuštěna pro každého uživatele aplikace, která notifikuje události aktualizační služby. Ve Windows se pak zobrazí ikona, která vyjadřuje stav aktualizační služby. Pokud toto pole při instalaci nezatrhneme, aplikace se spouštět nebude. U terminálových serverů doporučujeme tuto volbu nezapínat.
Obr.: Spuštění aplikace pro notifikaci událostí
Dalším krokem instalace je zadání jména a hesla uživatele, pod kterým bude K2 aktualizační služba běžet. Je možné použít místní systémový účet, nebo účet doménového uživatele. Podmínkou je, aby účet byl administrátorem daného počítače, a zároveň musí být pro tohoto uživatele viditelná serverová K2.
Obr.: Místní systémový účet
Obr.: Tento účet
Po stisku tlačítka Další se kontroluje shoda hesel. Pokud nejsou shodné, je uživatel vyzván k opravě.
Další obrazovka, která se zobrazí po stisknutí tlačítka Další, je již pouze informací pro uživatele o připravenosti dané instalace.
Obr.: Potvrzení instalace
O úspěšné instalaci K2 aktualizační služby je uživatel informován v následném dialogovém okně.
Obr.: Dokončení instalace
Stisknutím tlačítka Dokončit instalaci K2 aktualizační služby ukončíme.
Princip aktualizace lokální instalace
Po instalaci K2 aktualizační služby se mezi spuštěnými službami ve Windows objeví ikona této služby. Tato ikona reflektuje 3 stavy K2 aktualizační služby:
- - K2 aktualizační služba je spuštěna.
- - K2 aktualizační služba je zastavena.
- - K2 aktualizační služba provádí aktualizaci lokální instalace K2.
Po spuštění lokální IS K2, pomocí souboru "K2.exe", dojde vždy ke kontrole serverové K2, se kterou je daná lokální K2 datově propojena. Pokud jsou obě tyto K2 stejné (mají stejnou verzi), dojde ke spuštění lokální K2. Pokud je serverová K2 jiné verze než lokální K2, je odeslán požadavek K2 aktualizační službě a tato služba reinstaluje lokální K2, tak aby odpovídala verzi serverové K2. Služba pak provede odebrání lokální K2 a její opětovnou instalaci a následně lokální IS K2 spustí.
V případě, že je po spuštění lokální K2 zaznamenán rozdíl mezi lokální a serverovou K2 a nedojde ke spojení s K2 aktualizační službou (např. v případě, že služba neběží nebo není nainstalována), dojde se spuštění serverové K2. IS K2 v tomto případě hlásí, že je spuštěná serverová verze K2.
K2 vzdálená správa lokálních instalací
Tato aplikace umožňuje správci IS K2 vzdáleně spravovat lokální instalace dané serverové instalace K2. Tato aplikace musí být spouštěna vždy z kořenového adresáře serverové K2 a dále ze složky Admin. Zde nalezneme soubor "K2RemoteUpdateManager.exe", pomocí kterého aplikaci pro vzdálenou správu lokálních instalací spustíme. Veškeré operace, které K2 vzdálená správa lokálních instalací provádí, vyžadují, aby na daném vzdáleném počítači běžela K2 aktualizační služba.
V adresáři Admin je k dispozici také textový soubor "LocalInstallations.k2". V tomto souboru je uveden seznam všech lokálních instalací IS K2, které byly instalovány k dané serverové K2. Aplikace pro vzdálenou správu lokálních instalací z tohoto textového souboru vychází.
Aplikace pro vzdálenou správu lokálních instalací obsahuje dvě záložky Instalace a Služby.
Instalace
Záložka Instalace slouží pro vzdálenou správu lokálních instalací IS K2.
Obr.: Záložka Instalace
V horní části na záložce Instalace jsou základní informace o serverové instalaci K2. Je zde uvedeno označení verze a umístění serverové K2. Dále zde může být upozornění, že K2 není v reinstalačním módu. V případě, že je serverová K2 v reinstalačním módu, nemůže být nikdo přihlášen v lokálních K2 a může být bezpečně spouštěna jejich vzdálená aktualizace.
Pokud není serverová K2 v reinstalačním módu, mohou být v lokálních K2 přihlášeni uživatelé. V tomto případě mohou tito uživatelé při aktualizaci lokálních K2 přijít např. o rozdělanou práci.
Ve spodní části záložky Instalace je seznam vzdálených počítačů a umístění lokálních K2, které jsou na nich nainstalované. Dále je zde vždy uvedeno označení verze, datum a čas instalace a ikona vyjadřující stav dané instalace. Instalace mohu mít 3 stavy:
lokální K2 se shoduje se serverovou instalací. Lokální K2 je tedy aktuální.
verze lokální K2 se neshoduje se serverovou instalací. Lokální K2 je zastaralá.
na daném počítači neběží aktualizační služba, služba není nainstalována, nebo např. došlo k ručnímu vymazání lokální K2. Tento červený semafor zahrnuje více stavů.
Pokud myší najedeme na semafor vyjadřující stav, zobrazí se detailní informace o tomto stavu (stav + datum a čas přečtení). Dvojím kliknutím myší na semafor vyjadřující stav dojde k aktualizaci tohoto semaforu.
Po spuštění aplikace pro vzdálenou správu lokálních instalací se automaticky zatrhnou všechny instalace označené oranžovým semaforem. Ty nejsou aktuální a je žádoucí jejich aktualizace. Vynutit aktualizaci můžeme i u položek s červeným a zeleným semaforem, je nutné je ale vždy zatrhnout.
Aktualizují se vždy pouze zatržené lokální instalace K2. K vlastní aktualizaci vybraných lokálních instalací dojde vždy po stisknutí tlačítka Aktualizovat. Po dobu aktualizace nelze v této aplikaci dále pracovat. V případě, že je na počítači několik lokálních instalací, budou aktualizovány postupně.
Pomocí této aplikace je možné lokální instalace K2 vzdáleně také odinstalovat. To lze provést tak, že si označíme v seznamu danou lokální instalaci a stiskneme tlačítko Odinstalovat.
Vzdáleně je možné na počítač lokální K2 také nainstalovat. To provedeme tak, že stiskneme tlačítko Nová instalace a do zobrazeného formuláře doplníme do pole Vzdálený počítač název počítače a do pole Instalační adresář cestu k adresáři, do kterého chceme lokální K2 nainstalovat.
Obr.: Nová instalace
Tlačítkem Instalovat pak instalaci lokální K2 potvrdíme.
Služby
Na záložce Služby je možné vzdáleně spravovat K2 aktualizační služby.
Obr.: Záložka Služby
Vzdálená správa služeb na této záložce funguje obdobným způsobem jako správa lokálních K2 na záložce Instalace. V horní části záložky Služby jsou vždy uvedeny informace o dostupné (aktuální) verzi K2 aktualizační služby. Ve spodní části je pak uveden seznam všech počítačů, na kterých je K2 aktualizační služba nainstalována. Tento seznam odpovídá seznamu lokálních instalací z dané serverové K2.
U každé aktualizační služby v seznamu je vždy uveden název počítače, na kterém je tato služba nainstalována, označení její verze a stav v podobě semaforu. Aktualizační služba může mít 3 různé stavy:
K2 aktualizační služba je aktuální.
K2 aktualizační služba není aktuální a je nutné ji aktualizovat.
K2 aktualizační služba na daném počítači neběží, ke službě se nepodařilo připojit, atd.. Tento červený semafor zahrnuje více stavů.
Detailní informace o stavu služby se zobrazí po najetí myší na daný semafor. Zobrazí se stav a datum a čas přečtení. Dvojím kliknutím myší na semafor vyjadřující stav dojde k aktualizaci tohoto semaforu.
Po spuštění aplikace se vždy zatrhnou ty služby, u kterých je žádoucí jejich aktualizace, tzn., ty označené oranžovým semaforem. Vlastní aktualizaci služby pak spustíme pomocí tlačítka Aktualizovat. Aplikace provede aktualizaci označených položek (K2 aktualizačních služeb).
Distribuce K2 aktualizační služby a lokální instalace pomocí skupinové politiky doméně (GPO)
Cílem následujícího textu je popis distribuce K2 aktualizační služby a lokální instalace pomocí skupinové politiky na počítače, které jsou zařazeny v doméně. Návod je rozdělen na dvě části. První pojednává o nastavení cílových počítačů a druhá část popisuje skripty pro vzdálenou instalaci.
Nastavení cílového počítače
K2 aktualizační služba musí být spuštěna pod uživatelem, který je na cílovém počítači nastaven jako lokální administrátor. Nachází se tedy v lokální skupině „Administrators“.
Politika musí jako první nastavit uživatele určeného pro běh služby do této skupiny. Zde je potřeba dát pozor na to, abychom do skupiny „Administrators“ vkládali doménovou skupinu, kterou si vytvoříme a přiřadíme ji daného uživatele. Pokud bychom chtěli přidat přímo uživatele, došlo by k výmazu celé skupiny „Administators“ a jejím členem by zůstal pouze uživatel, kterého jsme přidávali. Varianta se skupinou zachová a rozšíří aktuální nastavení skupiny na cílovém počítači.
Tuto část najdeme v detailu politiky v sekci "Computer Configuration / Policies / Windows Settings / Restricted Groups“, viz obrázek. Můžeme zde vidět vytvořenou skupinu „K2_install_test“, která má nastaveno členství „Member Of“ na hodnotu „administrators“.
Obr.: Nastavení cílového počítače
Instalace aktualizační služby
Instalaci služby provedeme pomocí skriptu, který přiřadíme v politice jako „Startup“ skript. Tuto část najdeme v detailu politiky v sekci „Computer Configuration / Policies / Windows Settings / Scripts(Startup/Shutdown)“, viz obrázek.
Obr.: Instalace aktualizační služby
Vytvoříme soubor např. „update_service_loc_inst.cmd“, do kterého vložíme dávku, která je uvedena a popsána níže. Dávka je nastavena tak, aby se spustila instalace pouze za předpokladu, že na cílovém počítači ještě nebyla instalována. V opačném případě je dávka ihned ukončena. V případě, že bychom chtěli instalovat i lokální instalaci K2 je nutné uvést včetně parametrů, které jsou označeny červenou barvou. Bez těchto parametrů dojde pouze k instalaci K2 aktualizační služby.
REG QUERY "HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services\K2UpdateService"
IF %ERRORLEVEL% NEQ 0 (
msiexec /i %DIRECTORY_WITH_MSI_FOR_SERVICE%\K2UpdateServiceInstallation.msi INSTALLDIR="%INSTALL_DIR%" ACCOUNTTYPE=2 WINDOWSUSER=%USER_FOR_SERVICE% CAWINDOWSPASS1=%PASSWORD_FOR_USER_FOR_SERVICE% SERVER_INSTALLATION_PATH=%PATH_WITH_SERVER_INST_K2% CLIENT_INSTALLATION_PATH=%PATH_FOR_LOCAL_K2% SENDREQUESTFORINSTALLNEWK2=1 /quiet /norestart
)
kde nahradíme následující parametry za potřebné hodnoty:
Parametr: %DIRECTORY_WITH_MSI_FOR_SERVICE%
Reinstalace IS K2
Reinstalace znamená přechod systému na vyšší verzi.
Reinstalaci spouštíme v K2 instalátoru na záložce Nainstalováno. Zde je seznam všech dosud nainstalovaných IS K2 (viz kapitola Další možnosti). Ve formuláři nejdeme verzi IS K2, kterou chceme reinstalovat a stiskneme tlačítko Proveď. Tím se spustí reinstalace verze. Otevře se okno s průvodcem instalací produktu, viz Obr.: Spuštění reinstalace.
Obr.: Spuštění reinstalace
Není-li K2 v reinstalačním módu, instalátor při kontrole instalace zobrazí následující hlášení.
Obr.: Kontrolní hlášení o reinstalaci
V průběhu reinstalace se může objevit ještě jedno hlášení, a to v případě, kdy v systému K2 zůstal přihlášený uživatel.
Obr.: Hlášení o přihlášeném uživateli v K2
Po nastavení příznaku reinstalace, příp. odhlášení všech uživatelů, stiskneme tlačítko Opakovat. Reinstalace pak pokračuje dále.
Pokud reinstalujeme IS K2 na databázi Oracle, K2 potřebuje v některých případech při kontrole připravenosti předchozí verze získat přístup do databáze. Po spuštění reinstalace se objeví formulář Přihlašovací údaje k databázi. Tato akce běží ihned po začátku instalace a není tedy možné údaje získat z formulářů instalace.
Obr.: Formulář Přihlašovací údaje k databázi
Po stiknutí tlačítka Další se zobrazí okno s informací, že proběhne kontrola struktur databází. V rámci reinstalace se provádí kontrola struktur všech mandantů. V závislosti na počtu mandantů instalátor odhadne dobu trvání kontroly. Po stisku tlačítka Další se kontrola spustí.
Obr.: Kontrola struktur databází
Doběhne-li kontrola v pořádku, reinstalace pokračuje dalším oknem. Pokud se během kontroly struktur objeví chyby, zobrazí se některé z následujících hlášení. Stisknutím tlačítka Přerušit se reinstalace zruší, tlačítkem Opakovat se kontrola spustí znovu. Stiskneme-li tlačítko Ignorovat, reinstalace poběží dále a kontrola struktur se spustí až na konci reinstalace.
Obr.: Chyba kontroly struktur - kontrola neproběhla
Obr.: Chyba kontroly struktur - kontrola zjistila chyby
Nahlášené chyby je třeba opravit a následně spustit kontrolu znovu. Je doporučeno, aby kontrola struktur nevykazovala žádné chyby. Kontrolu struktur databází si lze připravit předem v reinstalačním manažerovi (viz. kapitola Reinstalační manažer), protože u této kontroly nemusí být zapnutý reinstalační mód.
Při reinstalaci na vyšší generační verzi se následně objeví formulář pro výběr licenčního souboru.
Obr.: Výběr licenčního souboru
Po stisku tlačítka Další se zobrazí formulář s možností instalace některých volitelných součástí IS K2.
V tomto formuláři nastavujeme Stav K2, který slouží pro účely odesílání informací o použití licence do společnosti K2 atmitec. Pokud zatrhneme pole Produkční K2, bude IS K2 registrován jako produkční, pokud pole nezatrhneme, IS K2 bude testovací a jeho funkčnost bude omezena.
Obr.: Nastavení volitelných součástí instalace
Po stisku tlačítka Nainstalovat se spustí reinstalace IS K2.
Kontrola notifikací
Po reinstalaci systému IS K2 se může zobrazit log se sdělením o nekonzistenci v notifikacích. Po přihlášení do IS K2 je nutné spustit Kontrolu v nastavení notifikací a případné nekonzistence odstranit.
Obr. Kontrola notifikací
Reinstalační manažer
Reinstalační manažer slouží pro zajištění správné reinstalace systému K2. Manažer je umístěn ve stromovém menu ve Správci - složka Systém. Pro práci s Reinstalačním manažerem je nutné, aby měl uživatel nastavené právo Servisní zásahy.
Obr.: Správce - Reinstalační manažer
Po spuštění funkce se zobrazí formulář Reinstalační manažer.
Obr.: Reinstalační manažer
Zatržené pole Zákaz přihlašování zabrání uživatelům přihlásit se do IS K2 s výjimkou uživatele, který zákaz přihlašování nastavil. Tím se zajistí, aby průběh reinstalace nebyl narušován přítomností uživatelů v IS K2. Pole Zákaz přihlašování od umožňuje nastavit, odkdy se uživatelé nebudou moct přihlásit. Pokud je doba přihlášení před nastaveným zákazem, zobrazí se hlášení, že se od nastaveného času nebude moci do IS K2 přihlásit. Hlášení nastavíme v poli Zpráva po přihlášení. Do pole Uživatel se pak automaticky doplní zkratka aktuálně přihlášeného uživatele, který provádí nastavení v Reinstalačním manažerovi.
Obr.: Přihlašovací okno IS K2 - zatržené pole Zákaz přihlašování
Obr.: Přihlašovací okno - po vyplnění pole Zákaz přihlašování od
Ve chvíli, kdy je pole Zákaz přihlašování zatržené, je možné zaktivnit i pole Reinstalace povolena. Tímto uživatel potvrdí, že reinstalaci nic nebrání a může proběhnout. Pro zatrhnutí pole je nutné, aby byli všichni uživatelé odhlášeni z K2 a všechny povinné inicializace v dané verzi byly provedeny. Není-li pole zatržené, instalátor nám nepovolí pokračovat v reinstalaci.
Pokud se pole nezatrhne, důvody se objeví v poli Důvody nezatrhnutí pole.
Obr.: Reinstalační manažer
Podle typu reinstalace verze se zvolí v Reinstalačním manažerovi možnost Reinstalovat na verzi:
- verzi se stejným release např. ori.01.101234 na ori.01.102040,
- verzi s vyšším release např. ori.01.99054 na ori.03.103456,
- verzi vyšší generace např. gaia.05.88054 na ori.01.102040.
Dle zvolené varianty reinstalace se spustí kontroly dokončení povinných inicializací a potřebných kroků pro přechod na požadovanou verzi.
V poli Hlavní klient se vybírá mandant, pod kterým mají běžet všechny reinstalační akce, které neběží pro každého mandanta zvlášť.
Pokud je zatržena volba Konverze speciálů na zvolenou verzi, bude během reinstalace proveden automatický překlad speciálních skriptů. Při nezatržení pole je po reinstalaci nutné provést překlad speciálních skriptů ručně. Zatržítko doporučujeme využít pokud jsou sdílené složky skriptů na síti, a které používá produkční K2, aby nedošlo k přepsání těchto skriptů během testování.
Tlačítkem Vše spustíme najednou akce Kontrola struktur, Diagnostika návrháře objektů i Kontrola notifikací.
Tlačítko Kontrola struktur provede kontrolu, zda struktury databáze odpovídají definicím v K2. Kontrolu lze spustit kdykoliv, protože není vázána na zatrhnutí polí Zákaz přihlašování a Reinstalace povolena. Stejná kontrola je provedena také v rámci přípravy instalátoru na reinstalaci.
Obr.: Reinstalační manažer - Kontrola stuktur
Pokud je před reinstalací z nižší verze nutné provést určité akce, objeví se v Reinstalačním manažerovi navíc tlačítko Příprava na "danou verzi", které obsahuje potřebné inicializace.
Po stisknutí tlačítka Diagnostika návrháře objektů se provede kontrola vytvoření každého modulu zaregistrovaného v IS K2 včetně zákaznických.
Kontrola notifikací může zobrazit log se sdělením o nekonzistenci v notifikacích. Po přihlášení do IS K2 je nutné spustit Kontrolu v nastavení notifikací a případné nekonzistence odstranit.
Tlačítkem Zálohovat databázi se otevře formulář pro vytvoření zálohy, ve kterém je zapotřebí vybrat cestu pro její umístění. Databáze se vždy zálohuje na serveru, kde je umístěn SQL server.
Obr.: Seznam databází
Upozornění: Po ukončení reinstalace je K2 stále v reinstalačním módu a nelze se do ní přihlásit. Uživatel, který provedl nastavení v Reinstalačním manažerovi, se musí po dokončení reinstalace přihlásit do K2 a v Reinstalačním manažerovi odtrhnout pole Zákaz přihlašování. Poté je možné se do K2 přihlásit pod jakýmkoliv uživatelem.
Pozn.: Dokud bude K2 v reinstalačním módu, bude na toto uživatel, který reinstalační mód nastavil, při ukončování K2 upozorňován hlášením "K2 má zakázané přihlašování. Přesto ukončit?". Pokud uživatel zvolí Ano, K2 se ukončí, pokud Ne, uživatel zůstane přihlášen.
Obr.: Hlášení systému K2 při ukončení K2
Fulltextové klíče
Pokud během konverzí dochází ke změně nebo rušení textových polí, automaticky se zruší fulltextový klíč, aby nedocházelo k chybám během vykonávání SQL dotazů konverzí. Po skončení konverzí běží inicializace verze, která se snaží zrušené fulltextové klíče obnovit podle definice v K2: Správce - nastavení fulltextových klíčů, funkce 778.
Obnovování fulltext klíčů může být časově náročná operace, která je prováděna na SQL serveru na pozadí. Klíče jsou proto dostupné pro dotazování až po doběhnutí této operace na pozadí.
Jestliže během obnovování se objeví chyba, která může být způsobena chybějícími poli ve fulltextu nebo změnou primárního klíče tabulky, zapíše se do logu ve složce SetupLogs\repairfulltext_(mandant).log. Uvedené chybné fulltextové klíče je potřeba prověřit a opravit viz dokumentace Správce - kapitola 1.17.15. Nastavení fulltextových klíčů.
K2 aplikační server
Tento instalační balíček slouží k instalaci aplikačního serveru IS K2 verze 3. Aplikační server pak slouží pro obsluhu webových klientů, kteří se na aplikační server připojují. Instalaci aplikačního serveru vyžadují také K2 nástroje Plánovač úloh a Notifikace.
Softwarové požadavky
Prvním požadavkem instalátoru aplikačního serveru je nutnost mít spuštěnou instalaci s administrátorským oprávněním. Jelikož tuto podmínku musí splňovat již K2 instalátor samotný, je tímto zajištěno, že se toto oprávnění přenese i na všechny instalace spouštěné z K2 instalátoru. Pro jistotu toto oprávnění testuje každá instalace, takže v případě nedostatečného oprávnění by instalátor zobrazil hlášení.
Druhým požadavkem je nutnost mít nainstalovaný IS K2, a to verze, která odpovídá verzi aplikačního serveru, minimálně na úrovni releasu verze, to znamená např. Iris.3.
Pokud jsou výše zmíněné podmínky splněny, pak můžeme spustit instalaci.
Instalace
Po spuštění instalace se zobrazí první dialog, který uživatele informuje, že je spuštěn instalátor pro produkt K2 Aplikační server a navíc zobrazí číslo verze, která bude nainstalována.
Obr.: Start instalace AS
Po stisknutí tlačítka Další přejdeme k druhému dialogu, který obsahuje licenční ujednání, která po přečtení musíme akceptovat, abychom mohli pokračovat dále. Ujednání akceptujeme zatrhnutím volby S podmínkami licenční smlouvy souhlasím.
Obr.: Licenční ujednání AS
Tlačítkem Další se dostaneme na třetí dialog, kde je uživatel vyzván k zadání cesty k nainstalované K2. Tlačítkem Změnit můžete procházet klasickým dialogem adresáře na fyzických discích, případně na síti.
Obr.: Cesta k IS K2
Pokud ve vybraném adresáři není nainstalován IS K2, pak je při pokusu o pokračování v instalaci zobrazeno varovné hlášení, které nedovolí pokračovat v instalaci, dokud není vybraná platná cesta.
Obr.: IS K2 nenalezen
Pokud je v adresáři nalezena platná instalace IS K2, instalace po stisknutí tlačítka Další pokračuje k dalšímu dialogu, který slouží k výběru instalační cesty. Tedy cesty kde se bude aplikace instalovat. Tlačítkem Změnit můžete procházet klasickým dialogem adresáře na fyzických discích.
Obr.: Instalační adresář
Po výběru instalačního adresáře a stisku tlačítka Další se zobrazí dialog, který vyzve uživatele, aby zadal název aplikačního serveru, včetně popisu (určen pro jednodušší rozpozdnání aplikačního serveru) a mandanta. Tato hodnota slouží jako jedinečná identifikace konkrétního aplikačního serveru mezi více instalacemi těchto aplikačních serverů. Pomocí této identifikace se pak budou připojovat weboví klienti ke správným aplikačním serverům. Vyplníme pole Název instance a Popis aplikačního serveru. Do pole Mandant zadáme mandanta, pro kterého má být aplikační server výchozí.
Obr.: Název aplikačního serveru K2
Obr.: Název instance
Volba Zapnout notifikace zapíná notifikace na AS, tzn. do souboru "K2.INI" je doplněn parametr "NSUSERS=K2". Pomocí volby Zapnout plánovač se zapíná plánovač na AS a do souboru "K2.INI" je přidán parametr "SCHEDULESERVICE=1".
Jestliže, je zatržena volba Konfigurovat aplikační server i pro server webových služeb, pak následuje dialog, viz Obr: Nastavení aplikačního serveru, který vyzve k zadání prefixu anonymního uživatele, počtu uživatelů a hesla uživatelů. Tito uživatelé musí být vytvořeni v IS K2 před instalací AS a měli by být číslováni vzestupně např. AN1, AN2 atd. kde AN je prefix a za ním pořadové číslo. Všichni tito uživatelé musí mít stejné heslo.
Pokud je zatržena volba Konfigurovat pro eshop, zobrazí se jako další krok instalace dialog pro Nastavení aplikačního serveru pro Eshop, viz obr. Číslo výchozí kontaktní osoby pro EShop. Zde zadáváme číslo kontaktní osoby, prostřednictvím které je realizováno přihlášení anonymního uživatele eshopu. Tato kontaktní osoba musí mít přiřazenou registraci. Do "K2.INI" aplikačního serveru se rovněž zařadí parametr "AS3ContactPerson".
V případě, že je zatržena volba Konfigurovat pro kontaktní centrum, zobrazí se v rámci instalace aplikačního serveru také dialog, viz obr. K2 uživatel pro kontaktní centrum. Na této obrazovce zadáváme jméno uživatele, pod kterým běží v IS K2 kontaktní centrum a také heslo. Zde zadané hodnoty se pak doplní do "K2.INI" aplikačního serveru jako parametry "CCUSER" a "CCPASWORD". Do "K2.INI" se doplní také parametr "CONTACTCENTERSERVICE=1".
Obr.: Nastavení aplikačního serveru
Obr.: Číslo výchozí kontaktní osoby pro EShop
Obr.: K2 uživatel pro kontaktní centrum
Dalším dialogem v instalaci je zadání jména a hesla uživatele, pod kterým bude běžet služba aplikačního serveru. Může být použit místní systémový účet viz obr. Místní systémový účet - AS anebo účet Windows uživatele, který vyžaduje heslo, viz obr.: Windows uživatel 2 - AS.
Obr.: Místní systémový účet - AS
Také může být použit doménový uživatel i s heslem, viz Obr.: Windows uživatel 2 - AS
Obr.: Windows uživatel 2 - AS
Po stisku tlačítka Další se kontroluje shoda hesel. Pokud nejsou shodné, je uživatel vyzván k opravě. Dalším dialogem v instalaci je zadání K2 uživatele, pod kterým se bude aplikační server připojovat k IS K2. Je možné využít již vytvořeného uživatele nebo vytvořit speciálního uživatele, který bude sloužit jen pro připojení k AS. Pro uživatele, kterým se bude připojovat k AS, není potřeba mít vyhrazenou licenci, viz Obr.: K2 uživatel - AS
Obr.: K2 uživatel - AS
Po stisku tlačítka Další se kontroluje shoda hesel. Pokud nejsou shodné, je uživatel vyzván k opravě.
Pokud jsou hesla shodná, pak se zobrazí dialog, který uživatele informuje o připravenosti instalace. Kliknutím na tlačítko Nainstalovat se pak spustí samotný průběh instalace.
Obr.: Potvrzení instalace
Po úspěšné instalaci je zobrazen uživateli poslední dialog o úspěšné instalaci, viz Obr.: Konec instalace
Obr.: Konec instalace
Na závěr instalace, případně reinstalace Aplikačního serveru se může zobrazit textový soubor se seznamem uživatelů. Důvodem je zpřísněná politika bezpečnosti uživatelských účtů IS K2.
Jednotlivým uživatelům je možné zakázat přístup z webu do IS K2 a všichni uživatelé mají po reinstalaci tento přístup zakázán. V textovém souboru, se na závěr instalace, zobrazí seznam všech uživatelů, kteří mají propojení na kontaktní osobu a zároveň mají zakázán přístup přes web. Tito nebudou moci používat některé funkce, jako je např. schvalování wkfl z emailu. Pro tyto uživatele je nutné nastavit přístup z webu v knize Uživatelé - nastavení hesel.
Obr.: Textový soubor se seznamem uživatelů
K2 aplikační server 64 bit
Instalační balíček pro instalaci aplikačního serveru IS K2 v 64 bitové verzi. Aplikační server pak slouží pro obsluhu webových klientů, kteří se na aplikační server připojují.
Softwarové požadavky
Důležitým požadavkem pro instalaci 64 bitového aplikačního serveru je existence 64 bitového operačního systému. Ostatní softwarové požadavky se nijak neliší od instalace aplikačního serveru v 32 bitové verzi.
Instalace
Instalace 64 bitového aplikačního serveru zahrnuje stejné instalační kroky a vstupní dialogová okna jako instalace 32 bitového aplikačního serveru.
Webová K2
Tento instalační balíček slouží k instalaci Webové K2. Jedná se webového klienta, který využívá technologii HTML5.
Softwarové požadavky
Prvním požadavkem instalátoru webového klienta je nutnost mít spuštěnou instalaci s administrátorským oprávněním.
Druhou podmínkou je instalace Internetové informační služby, dále jen IIS, verze 8.0 a vyšší. Pokud není IIS nainstalován, zobrazí se na začátku instalace varovné hlášení.
Obr: Chybějící IIS
Třetí podmínkou je instalace nástroje IIS, který se nazývá Kompatibilita metabáze služby IIS a konfigurace služby IIS 6. Pokud není tento nástroj nainstalován, zobrazí se na začátku instalace varovné hlášení.
Obr.: Chybějící Metabase Compatibility
Dále musí být v rámci IIS povolena funkce Protokol WebSocket. V případě, že tato funkce v rámci IIS dostupná není, zobrazí instalátor varovné hlášení.
Obr.: Hlášení při neexistenci služby Protokol WebSocket
Instalaci IIS a veškeré nastavení v rámci IIS provedeme pomocí systému Windows v klientské instalaci Windows (Ovládací panely / Programy a funkce / Zapnout nebo vypnout funkce systému Windows), nebo pro serverovou instalaci Windows (např. Windows Server 2008 R2) pomocí Server manager, následně pravé tlačítko myši na Role a vybrat Přidat roli.
Obr.: Instalace IIS ve Windows 10
Dalším požadavkem je nutnost instalace knihovny .NET Core 1.0.0 nebo novější. Tato instalace je dostupná v K2 intalátoru na záložce Ostatní instalace. Nebo na URL adrese, která se zobrazí v rámci varovného hlášení, v případě, že tato knihovna nainstalována není.
Obr.: Hlášení při neexistenci knihovny .NET Core
Instalace
Po spuštění instalace se zobrazí první dialog, který uživatele informuje, že je spuštěn instalátor pro produkt Webová K2 a navíc se zobrazí číslo verze, která bude nainstalována.
Obr.: Instalace Webová K2
Po stisknutí tlačítka Další přejdeme k druhému dialogu, který se týká licenčního ujednání. Následně je potřeba vybrat Typ protokolu, a to buď standardní HTTP nebo zabezpečenou variantu HTTPS, přes který bude s webovým klientem komunikovat.
Obr.: Typ protokolu Webová K2
Další dialogové okno pak slouží k výběru Cílového adresáře, do nějž má být Webová K2 instalována.
Obr.: Cílový adresář Webová K2
Po výběru instalační cesty následuje dialog, ve kterém nastavíme umístění webové aplikace na IIS. Z tohoto nastavení posléze sestává URL cesta, přes kterou se připojíme k webové aplikaci.
První vstupní hodnotou je Název IIS serveru, což je v podstatě část URL adresy domovské stránky IIS bez protokolu (HTTP, HTTPS). To znamená, že pokud máme nainstalován standardně IIS na počítači s názvem např. amadeus, pak je domovská stránka na URL adrese http://amadeus. Do hodnoty vložíme část adresy za protokolem, to znamená amadeus. Pokud neexistují mapování na jiné názvy, pak je s největší pravděpodobností název webu shodný s názvem počítače. Na lokálním počítači se svým vlastním IIS je tomu tak téměř vždy. Samozřejmě pokud instalujeme IIS na veřejný počítač, pak tomu tak není, viz ostrý server K2, kde je domovská adresa IIS na URL např. https://hetera.k2atmitec.cz. V tomto případě vkládáme do tohoto pole hodnotu hetera.k2atmitec.cz. Adresu si na svém lokálním počítači můžeme ověřit zadáním URL adresy do okna prohlížeče. Pokud je zadaná adresa URL správná, zobrazí se uvítací stránka IIS. Pozor domovská stránka může být přesměrována, viz ostrý server K2. Pro shrnutí - pokud webového klienta instalujete na svůj lokální počítač, pak je první vstupní hodnota rovna jménu vašeho počítače.
Druhou vstupní hodnotou je výběr webu na vašem IIS. Pro standardní instalaci IIS je dostupný pouze tzv. „Default“ web. Což je web, který se nachází na URL adrese, která je shodná s domovskou adresou. Pokud není požadováno instalovat aplikaci na konkrétní web IIS, vybíráme variantu Default Web Site.
Poslední hodnotou na tomto dialogu je Název aplikace na IIS. Jedná se o část URL adresy, přes kterou budeme přistupovat k webové K2, a která nám bude webovou K2 touto adresou jednoznačně identifikovat. Například, pokud zadáme WebK2_luna02, pak po nainstalování bude webový klient dostupný na URL adrese http://Amadeus/WebK2_luna02. Tlačítkem Náhled je možné si pro kontrolu zobrazit URL aplikace.
Obr.: Název aplikace na IIS
Po vyplnění všech informací můžeme pokračovat k dalšímu dialogu - Informace o K2 aplikačním serveru. Je určen k nastavení komunikace s aplikačním serverem, který byl blíže popsán v kapitole K2 aplikační server.
První pole v tomto dialogu je Název nebo IP adresa počítače s K2 AS. Zde zadáváme DNS název nebo přímo IP adresu počítače, na který jsme nainstalovali aplikační server IS K2. Pokud máme AS nainstalován na svém lokálním počítači, můžeme zadat hodnotu "." nebo "localhost".
Druhým vstupem je Název instance K2 AS. Tato hodnota byla zadána při instalaci AS a jednoznačně identifikuje aplikační server na zadaném počítači.
Obr.: Informace o K2 aplikačním serveru
Pokud máme všechny údaje vyplněny, pak pokračujeme dále tlačítkem Další. Zobrazí se dialog, který uživatele informuje o připravenosti instalace. Kliknutím na tlačítko Nainstalovat se pak spustí samotný průběh instalace.
Obr.: Připraveno k instalaci
Po úspěšné instalaci je zobrazen uživateli poslední dialog o výsledku instalace.
Obr.: Instalace dokončena Webová K2
Omezené funkce webové K2 instalované přes HTTP
Pokud je webová K2 instalována na HTTP mohou být některé funkce/metody/objekty omezeny, např.:
- geolokace,
- API pro kopírování textu,
- WebSockets a WebRTC,
- Push notifikace,
- zabezpečení cookies,
- přístup k některým senzorům, např. webkamera, mikrofon.
K2 API
Tento instalační balíček slouží k instalaci serveru webových služeb IS K2. Pomocí těchto webových služeb mohou klienti komunikovat s tímto serverem.
Instalátor je stejný jako instalace webové K2.
Stejně tak softwarové požadavky jsou stejné jako pro instalaci webové K2.
K2 API v2
Druhá generace REST API zpřístupňující data a logiku K2 dalším aplikacím. Oproti předchozí generaci umožňuje provoz na Windows i Linux serverech, autorizaci pomocí JWT tokenů, snazší předávání kontextových informací a zpracování chybových stavů. Obsahuje také vestavěnou OpenAPI dokumentaci rozhraní.
Instalace
Po spuštění instalace se otevře dialogové okno s informací o instalaci daného produktu.
Obr.: Start instalace produktu K2 API v2
Po kliknutí na tlačítko Další se zobrazí informace K2 Licenční ujednání. Po odsouhlasení licenčního ujednání a kliknutí na tlačítko Další se zobrazí dialogové okno pro výběr Cílového operačního systému.
Obr.: Cílový operační systém
Instalace K2 API v2 je umožněna na Microsoft Windows (lokální instalace), nebo na Linux (vzdálená instalace).
Microsoft Windows (lokální instalace)
Při instalaci na Microsoft Windows si vybereme typ protokolu, na který chceme K2 API v2 instalovat. Zvolit lze standardní HTTP variantu, nebo zabezpečenou variantu HTTPS.
Obr.: Typ protokolu pro K2 API v2
V další části vybereme cílovou složku, do které chceme produkt nainstalovat.
Obr.: Cílový adresář K2 API v2
Dále volíme umístění aplikace K2 API v2 na IIS.
Obr.: Umístění na IIS
Popis polí:
Název web serveru |
Zde zadáváme název IIS, v rámci které bude K2 API v2 nainstalován. Název IIS je zpravidla shodný s názvem počítače. |
Vyberte webovou stránku na IIS |
Pole pro výběr webu na IIS. Pro standardní instalaci IIS je dostupný pouze tzv. „Default“ web. Zadáme zde tedy hodnotu Default Web Site. |
Název aplikace web serveru |
Název pro aplikaci na web serveru. Jednoznačná identifikace aplikace na web serveru. |
Náhled URL pro instalovanou aplikaci |
Tlačítko pro zobrazení kompletní URL adresy aplikace K2 API v2. |
Po vyplnění požadovaných údajů v části Název aplikace na web serveru klikneme na tlačítko Další. Zobrazí se nám okno pro zadání Informací o K2 aplikačním serveru.
Obr.: Informace o K2 aplikačním serveru
Popis polí:
Název nebo IP adresa počítače s K2 AS |
Zadáváme název počítače, na kterém běží aplikační server. |
Port pro připojení ke K2 AS |
Zadáváme port počítače, na kterém běží aplikační server. |
Po kliknutí na tlačítko Další se zobrazí dialog, který informuje o připravenosti instalace.
Linux (vzdálená instalace)
Instalace na linuxový server probíhá vzdáleně. Instalační program se v tomto režimu připojí na zadaný linuxový server, na kterém provede stažení, instalaci a nastavení Docker kontejneru, v němž běží aplikace K2 API.
Vzdálený linuxový server musí mít nainstalován SFTP server s ověřením uživatele pomocí privátního klíče a Docker pro běh aplikace. Samotný image pro docker je na server nainstalován z K2 container registry.
Při instalaci na Linux (vzdálená instalace) si vybereme typ protokolu, na který chceme K2 API v2 instalovat. Zvolit lze standardní HTTP variantu, nebo zabezpečenou variantu HTTPS.
Obr.: Typ protokolu pro K2 API v2
V další části vybereme cílovou složku, do které chceme produkt nainstalovat.
Obr.: Cílový adresář K2 API v2
Dále vyplňujeme údaje pro Nastavení připojení k SFTP v prostředí Linux.
Obr.: Nastavení připojení k SFTP v prostředí Linux
Popis polí:
Adresa SFTP |
IP adresa nebo název SFTP serveru, na který budeme K2 API v2 instalovat. |
Uživatel pro připojení k SFTP |
Název uživatele pro připojení k SFTP v prostředí Linux. |
Cesta k souboru s privátním klíčem k SFTP |
Zadáme cestu k souboru, kde je umístěn privátní klíč uživatele SFTP. Slouží k autentizaci přístupu. |
V dalším kroku vyplňujeme Nastavení Docker kontejneru pro spuštění.
Obr.: Nastavení Docker kontejneru pro spuštění
Popis polí:
Název kontejneru |
Vložte unikátní název kontejneru, který vznikne v dockeru. |
URL pro K2 api (bez http) |
Zadáme URL adresu (doménu) pro K2 api v2. Doména musí být směrovaná linuxový server. |
Postfix pro URL pro K2 api |
Pokud je aplikace na jednom serveru jen jedna, není nutné vyplnit. Pokud máme více K2 api, je třeba dané pole vyplnit. |
Náhled URL pro instalovanou aplikaci |
Z tohoto nastavení výše se poté poskládá celá URL adresa K2 api v2. |
Po vyplnění požadovaných údajů a kliknutí na tlačítko Další se nám zobrazí okno pro zadání Informací o K2 aplikačním serveru.
Obr.: Informace o K2 aplikačním serveru
Popis polí:
Název nebo IP adresa počítače s K2 AS |
Zadáváme název počítače, na kterém běží aplikační server. |
Port pro připojení ke K2 AS |
Zadáváme port počítače, na kterém běží aplikační server. |
Po kliknutí na tlačítko Další se zobrazí dialog, který informuje o připravenosti instalace.
K2 Callcentrum
Tento instalační balíček slouží k instalaci webového klienta K2 CallCentrum.
Instalátor obsahuje, oproti obecné instalaci webového klienta, jednu vstupní obrazovku navíc. V části Instalace bude tedy popsána jen tato vstupní obrazovka. Všechny ostatní obrazovky jsou stejné jako v obecné instalaci webového klienta.
Softwarové požadavky
Prvním požadavkem pro instalaci K2 CallCentrum webového klienta je existující instalace Asterisk serverové služby, viz Asterisk serverová služba, u které jsou nám známy parametry pro připojení.
Ostatní softwarové požadavky jsou stejné jako u instalace obecného webového klienta.
Instalace
Odlišným vstupním dialogem od obecné instalace je dialog týkající se informací o Asterisk serverové službě. Aby klient správně fungoval, to znamená, dokázal se připojit k serverové službě, je potřeba znát DNS název nebo IP adresu počítače, na kterém je nainstalována Asterisk serverová služba. Druhým vstupním údajem je port, na kterém daná služba poslouchá. Tyto hodnoty jsou zadávány při instalaci Asterisk serverové služby. Pokud jsme tuto službu neinstalovali, ale máme ji k dispozici, je nutné tyto údaje zjistit, nejlépe od člověka, který je za instalaci zodpovědný.
Obr.: Nastavení Callcentrum serveru
Asterisk serverová služba
Tento instalační balíček slouží k instalaci Asterisk serverové služby, která slouží ke zprostředkování komunikace mezi Asterisk ústřednou a K2 CallCenter webovým klientem.
Instalátor obsahuje stejné dialogy (licence, instalační adresář, apod.) jako předchozí instalace, tudíž zde budou popsány jen ty, které jsou specifické pro tuto instalaci.
Softwarové požadavky
Požadavkem je nutnost mít spuštěnou instalaci s administrátorským oprávněním.
Instalace
Odlišným vstupním dialogem od ostatních instalací je dialog týkající se informací o připojení k Asterisk ústředně. Vstupem tohoto dialogu je konfigurační soubor, který se získá nastavením Asterisk ústředny a následným exportem nastavení z IS K2.
Obr.: Nastavení připojení k Asterisk ústředně
K2 Workflow webová aplikace
Tato aplikace slouží ke spuštění procesu na základě vybraného WKF postupu a k připojení naskenovaných dokumentů k právě spuštěnému procesu. WKF postup, který bude aplikace nabízet obsluze, volíme při instalaci v poli Typ hlavičky postupu pro načtení do menu. Příkladem praktického využití je spuštění procesu na základě postupu "Faktura přijatá" poté, co obsluha naskenuje doručenou papírovou fakturu.
Aby bylo možné službu nainstalovat, musí být nainstalován produkt K2 API. Požadavkem je mít nainstalovanou také službu CGI v IIS. Tuto službu lze na Windows 10 zapnout ve funkcích systému Windows: Internetová informační služba -> Webové služby -> Funkce pro vývoj aplikací -> CGI. Dále je nutné mít nainstalováno PHP verze 5.4 a vyšší.
Popis vybraných kroků instalace
Obr.: Informace o webových službách
Název web serveru |
Zde zadáváme název IIS, v rámci které bude K2 API v2 nainstalován. Název IIS je zpravidla shodný s názvem počítače. |
Název aplikace na web serveru |
Název pro aplikaci na web serveru. Jednoznačná identifikace aplikace na web serveru. |
Obr.: Nastavení workflow
Typ hlavičky postupu pro načtení do menu |
Typ hlavičky postupu. Jde o pole Typ v číselníku Postupů. Postupy s tímto typem se následně obsluze nabízejí ke spuštění. |
Spustit proces bez naskenovaného dokumentu |
Touto volbou stanovujeme, zda chceme umožnit spustit proces i když neexistují naskenované nepřiřazené dokumenty. Pokud jej nezatrhneme, lze proces spustit jen když existují naskenované a nepřiřazené dokumenty (obsluze se na tlačítku s postupem zobrazuje počet naskenovaných a nepřiřazených dokumentů). |
K2 e-shop, firemní weby
Tento instalační balíček slouží k instalaci produktu K2 E-shop a firemní weby. Tato aplikace běží v rámci Internetové informační služby. K2 E-shop a firemní weby využívá pro připojení do IS K2 webové služby a ty pak aplikační server. Instalace proto již předpokládá jejich existenci. Instalovat produkt K2 e-shop, firemní weby je možné lokálně na os Microsoft Windows nebo vzdáleně na os Linux.
Softwarové požadavky
První podmínkou instalace K2 E-shopu, firemní weby je instalace Internetové informační služby, dále jen IIS, verze 8.0 a vyšší. Pokud není IIS nainstalována, zobrazí se na začátku instalace varovné hlášení. V rámci IIS je nutné mít zatrženou možnost CGI (Common Gateway Interface) v sekci Webové služby - Funkce pro vývoj aplikací. Tato volba je nutná pro funkčnost PHP v rámci IIS.
Druhým požadavkem pro funkčnost K2 E-shopu, firemní weby je rozšíření IIS o URL Rewrite. Instalace tohoto rozšíření zajišťuje překlad URL adres do čitelné podoby. Pokud není toto rozšíření nainstalováno, zobrazí instalátor hlášení s odkazem ke stažení. Instalace URL Rewrite je zařazena také na záložce Ostatní instalace odkud ji lze stáhnout a nainstalovat.
Obr.: Hlášení instalátoru (chybějící URL Rewrite)
Podmínkou je instalace podpory PHP verze 7.4. Pokud tato podpora nainstalována není, informuje o tom instalátor zobrazeným hlášením. Odkaz ke stažení PHP je http://windows.php.net/.
Obr.: Hlášení instalátoru (chybějící podpora PHP)
Instalace K2 e-shop, firemní weby na OS Microsoft Windows (lokální instalace)
Po spuštění instalace se zobrazí první dialog, který uživatele informuje, že je spuštěn instalátor pro produkt K2 E-shop, firemní weby. Navíc se také zobrazí číslo verze, která bude nainstalována.
Obr.: Start instalace produktu K2 E-shop, firemní weby
Po stisknutí tlačítka Další přejdeme k druhému dialogu, který obsahuje licenční ujednání. Zde je nutné licenční podmínky odsouhlasit.
Obr.: Licenční ujednání
Tlačítkem Další se dostaneme na třetí dialog, který slouží pro výběr platformy pro instalaci e-shopu. Tento produkt je možné naistalovat na operační systémy Microsoft Windows a Linux.
Obr.: Výběr operačního systému pro instalaci e-shopu
Další dialogové okno pak slouží pro výběr cílového adresáře, do kterého bude produkt K2 e-shop, firemní weby nainstalován. Tlačítkem Změnit můžete procházet klasickým dialogem adresáře na fyzických discích, případně na síti. K2 E-shop, firemní weby zpravidla instalujeme do domovského adresáře IIS (výchozí adresář IIS je C:\inetpub\wwwroot). Název adresáře pak určuje finální podobu URL adresy e-shopu, která se skládá z adresy IIS a názvu adresáře s instalací produktu K2 E-shop, firemní weby.
Obr.: Výběr cílového adresáře pro instalaci e-shopu
Po výběru instalační cesty následuje dialog, ve kterém určujeme K2 API pro produkt K2 E-shop, firemní weby. Pomocí této webové aplikace se K2 e-shop připojuje k IS K2. V tomto dialogu vybíráme Typ protokolu (Http nebo Https), Název IIS serveru (obvykle název počítače, kde K2 API nainstalován) a Název aplikace na IIS (pojmenování K2 API pro K2 e-shop). Tyto tři hodnoty tvoří kompletní URL adresu pro připojení k webové aplikaci K2 API.
Obr.: K2 API pro E-shop
Další okno instalace zobrazíme znovu stisknutím tlačítka Další. Zde je pak nutné nastavit přihlašovací údaje pro anonymní přístup do eshopu. Jedná se o přihlašovací údaje nastavené na kontaktní osobě pro neregistrovaného uživatele eshopu.
Obr.: Přihlášení pro neregistrovaného uživatele
Dalším instalačním dialogem je Nastavení e-shopu. V tomto formuláři je několik polí pro základní nastavení eshopu.
Obr.: Nastavení eshopu
Popis polí:
Číslo e-shopu z K2 |
Zde zadáváme RID internetového obchodu z IS K2 pro jeho jednoznačné určení. |
URL adresa pro přístup k obrázkům |
Pole pro určení URL adresy pro přístup k obrázkům eshopu. |
Šablona eshopu/webu |
Zde je možné vybrat výchozí šablonu pro eshop nebo web. Vybíráme ze seznamu dostupných šablon. |
URL adresa pro obrázkový server |
V případě, že eshop bude využívat obrázkový server zadáváme zde URL adresu, kde je tento server nainstalován. |
Stisknutím tlačítka Další přejdeme na další formulář instalátoru - Konfigurace Elasticsearch. Pokud eshop bude využívat funkci pro Smart Search je zde nutné zadat údaje pro přístup ke službě Elasticsearch. Tento specializovaný nástroj je součástí funkce Smart Search jejíž podrobný popis naleznete v Technické dokumentaci v kapitole Smart Search (e-shop).
Obr.: Konfigurace Elasticsearch
Popis polí:
Elasticsearch |
Pro konfiguraci Elasticsearch je nutné toto pole zatrhnout. Až poté se zpřístupní další nastavení tohoto nástroje. |
Adresa pro připojení k Elasticsearch serveru |
IP adresa nebo název serveru, na kterém je nainstalována služba Elasticsearch. |
Port pro připojení k Elasticsearch serveru |
Síťový port, na kterém služba Elasticsearch běží. V poli se již předbízí výchozí hodnota 9200. |
Další okno instalátoru slouží k nastavení služby Redis. Jedná se o službu pro cache dat, které eshop využívá.
Obr.: Konfigurace Redis
Popis polí:
Redis |
Pro konfiguraci Redis je nutné toto pole zatrhnout. Až poté se zpřístupní další nastavení tohoto nástroje. |
Adresa pro připojení k Redis serveru |
IP adresa nebo název serveru, na kterém je nainstalována služba Redis. |
Port pro připojení k Redis serveru |
Síťový port, na kterém služba Redis běží. V poli se již předbízí výchozí hodnota 6379. |
DBIndex pro Redis |
Číslo databáze v rámci služby Redis. |
V instalaci dále pokračujeme tlačítkem Další. Zobrazí se dialog, který uživatele již informuje o připravenosti instalace. Pomocí tlačítka Nainstalovat pak spustíme vlastní instalaci produktu K2 E-shop, firemní weby.
Obr.: Připravena instalace K2 E-shop, firemni weby
Na závěr se po úspěšné instalaci zobrazí poslední dialog s informací o výsledku.
Obr.: Dokončení instalace
Instalace K2 e-shop, firemní weby na OS Linux (vzdálená instalace)
Po spuštění instalace se zobrazí první dialog, který uživatele informuje, že je spuštěn instalátor pro produkt K2 E-shop, firemní weby. Navíc se také zobrazí číslo verze, která bude nainstalována, viz Obr.: Start instalace produktu K2 E-shop, firemní weby.
Obr.: Start instalace produktu K2 E-shop, firemní weby
Po stisknutí tlačítka Další přejdeme k druhému dialogu, který obsahuje licenční ujednání. Zde je nutné licenční podmínky odsouhlasit.
Obr.: Licenční ujednání
Tlačítkem Další se dostaneme na třetí dialog, který slouží pro výběr platformy pro instalaci e-shopu. Tento produkt je možné naistalovat na operační systémy Microsoft Windows a Linux. Pro vzdálenou instalaci na operační systém Linux je nutné tuto volbu zatrhnout.
Obr.: Výběr operačního systému pro instalaci e-shopu
V dalším okně instalátoru je nutné nastavit připojení na SFTP protokol pro přenost dat v prostředí Linux. Jedná se v podstatě o nastavení pro přenos souborů na linuxový server. To probíhá pomocí SFTP protokolu. K2 instalátor se pomocí zde zadaných údajů na tento protokol připojí.
Obr.: Nastavení připojení k SFTP v prostředí Linux
Popis polí:
Adresa SFTP |
Adresa cílového serveru pro vzdálenou instalaci produktu K2 E-shop, firemní weby. Na tomto serveru musí být dostupný protokol SFTP. |
Uživatel pro připojení k SFTP |
Jméno uživatele pro připojení k SFTP. |
Cesta k souboru s privátním klíčem uživatele k SFTP |
Autorizace uživatele neprobíhá na základě zadaného hesla, ale využívá privátní klíč. V tomto poli je nutné zadat cestu ke tomuto klíči (souboru) pro autorizaci k SFTP. Protože toto přihlášení a tím pádem i klíč využívá také reinstalace produktu, nemělo by docházet k přesunu privátního klíče do jiného uložiště. |
Další dialogové okno pak slouží pro výběr adresáře pro dočasné soubory instalátoru. K2 instalátor si do tohoto adresáře uloží veškeré soubory, které pro danou instalaci používá. Toto uložiště nastavíme v poli Dočasné soubory umístit zde. Dále je zde možné zadat URL adresu homepage eshopu, pokud je již v době instalace známá. To poté slouží pro provedení operací, které probíhají ihned po instalaci eshopu. URL adresu eshopu zadáváme v poli Cílová URL adresa e-shopu.
Obr.: Výběr adresáře a URL adresy
Dále následuje dialog, ve kterém určujeme K2 API pro produkt K2 E-shop, firemní weby. Pomocí této webové aplikace, se K2 e-shop připojuje k IS K2. V tomto dialogu vybíráme Typ protokolu (Http nebo Https), Název IIS serveru (obvykle název počítače, kde K2 API nainstalován) a Název aplikace na IIS (pojmenování K2 API pro K2 e-shop). Tyto tři hodnoty tvoří kompletní URL adresu, pro připojení k webové aplikaci K2 API.
V případě instalace na vzdálený server s operačním systémem Linux zde nemá smysl zadávat "localhost". Komunikace neprobíhá v rámci jednoho serveru. Jde o spojení z linuxového serveru s eshopem směrem k serveru kde běží K2 API.
Obr.: K2 API pro E-shop
Další okno instalace zobrazíme znovu stisknutím tlačítka Další. Zde je pak nutné nastavit přihlašovací údaje pro anonymní přístup do eshopu. Jedná se o přihlašovací údaje nastavené na kontaktní osobě pro neregistrovaného uživatele eshopu.
Obr.: Přihlášení pro neregistrovaného uživatele
Dalším instalačním dialogem je Nastavení e-shopu. V tomto formuláři je několik polí pro základní nastavení eshopu.
Obr.: Nastavení eshopu
Popis polí:
Číslo e-shopu z K2 |
Zde zadáváme RID internetového obchodu z IS K2 pro jeho jednoznačné určení. |
URL adresa pro přístup k obrázkům |
Pole pro určení URL adresy pro přístup k obrázkům eshopu. |
Šablona eshopu/webu |
Zde je možné vybrat výchozí šablonu pro eshop nebo web. Vybíráme ze seznamu dostupných šablon. |
URL adresa pro obrázkový server |
V případě, že eshop bude využívat obrázkový server zadáváme zde URL adresu, kde je tento server nainstalován. |
Stisknutím tlačítka Další přejdeme na další formulář instalátoru Konfigurace Elasticsearch. Pokud eshop bude využívat funkci pro Smart Search je zde nutné zadat údaje pro přístup ke službě Elasticsearch. Tento specializovaný nástroj je součástí funkce Smart Search jejíž podrobný popis naleznete v Technické dokumentaci v kapitole Smart Search (e-shop).
Obr.: Konfigurace Elasticsearch
Popis polí:
Elasticsearch |
Pro konfiguraci Elasticsearch je nutné toto pole zatrhnout. Až poté se zpřístupní další nastavení tohoto nástroje. |
Adresa pro připojení k Elasticsearch serveru |
IP adresa nebo název serveru, na kterém je nainstalována služba Elasticsearch. |
Port pro připojení k Elasticsearch serveru |
Síťový port, na kterém služba Elasticsearch běží. V poli se již předbízí výchozí hodnota 9200. |
Další okno instalátoru, slouží nastavení služby Redis. Jedná se o službu pro cache dat, které eshop využívá.
Obr.: Konfigurace Redis
Popis polí:
Redis |
Pro konfiguraci Redis je nutné toto pole zatrhnout. Až poté se zpřístupní další nastavení tohoto nástroje. |
Adresa pro připojení k Redis serveru |
IP adresa nebo název serveru, na kterém je nainstalována služba Redis. |
Port pro připojení k Redis serveru |
Síťový port, na kterém služba Redis běží. V poli se již předbízí výchozí hodnota 6379. |
DBIndex pro Redis |
Číslo databáze v rámci služby Redis. |
V instalaci dále pokračujeme tlačítkem Další. Zobrazí se dialog, který uživatele již informuje o připravenosti instalace. Pomocí tlačítka Nainstalovat pak spustíme vlastní instalaci produktu K2 E-shop, firemní weby.
Obr.: Připravena instalace K2 E-shop, firemni weby
Na závěr se po úspěšné instalaci zobrazí poslední dialog s informací o výsledku.
Obr.: Dokončení instalace
K2 Obrázkový server
Instalační balíček pro instalaci K2 Obrázkového serveru. Jedná se o software chovající se jako server, který byl vytvořen za účelem efektivní distribuce obrázků klientům e-shopu a webové K2 a optimalizaci těchto distribuovaných obrázků. Instalovat produkt K2 obrázkový server je možné lokálně na operační systém Microsoft Windows nebo vzdáleně na Linux.
Softwarové požadavky
První podmínkou je instalace Internetové informační služby, dále jen IIS, verze 8.0 a vyšší. Pokud není IIS nainstalována, zobrazí se na začátku instalace varovné hlášení.
Druhou podmínkou je instalace nástroje IIS, který se nazývá Kompatibilita metabáze služby IIS a konfigurace služby IIS 6. Pokud není tento nástroj nainstalován, zobrazí se na začátku instalace varovné hlášení, viz Obr.: Chybějící Metabase Compatibility.
Obr.: Chybějící Metabase Compatibility
Třetí podmínkou je nutnost povolit v rámci IIS funkci Protokol WebSocket. V případě, že tato funkce v IIS dostupná není, zobrazí instalátor varovné hlášení.
Obr.: Hlášení při neexistenci služby Protokol WebSocket
Čtvrtá podmínka pro K2 Obrázkový server je rozšíření IIS o URL Rewrite. Instalace tohoto rozšíření zajišťuje překlad URL adres do čitelné podoby. Pokud není toto rozšíření nainstalováno, zobrazí instalátor hlášení s odkazem ke stažení. Instalace URL Rewrite je zařazena také na záložce Ostatní instalace odkud ji lze stáhnout a nainstalovat.
Obr.: Hlášení instalátoru (chybějící URL Rewrite)
Pátá podmínka je nutnost instalace knihovny .NET Core 2.2.2 nebo novější. Tato instalace je dostupná v K2 instalátoru na záložce Ostatní instalace. Nebo na URL adrese, která se zobrazí v rámci varovného hlášení, v případě, že tato knihovna nainstalována není.
Obr.: Hlášení při neexistenci knihovny .NET Core
Poslední šestá podmínka je nutnost instalace ASP.NET Core 7.0.5 nebo vyšší. Tato instalace je dostupná na URL adrese https://dotnet.microsoft.com/en-us/download/dotnet/thank-you/runtime-aspnetcore-7.0.5-windows-hosting-bundle-installer.
Instalace produktu K2 Obrázkový server na OS Microsoft Windows (lokální instalace)
Instalace
Po spuštění instalace se zobrazí první dialog, který uživatele informuje, že je spuštěn instalátor pro produkt K2 Obrázkový server, a navíc se zobrazí číslo verze, která bude nainstalována, viz obr. Start instalace produktu K2 obrázkový server.
Obr.: Start instalace produktu K2 Obrázkový server
Po stisknutí tlačítka Další přejdeme k druhému dialogu, který obsahuje licenční ujednání. Zde je nutné licenční podmínky odsouhlasit.
Tlačítkem Další se dostaneme na třetí dialog, který slouží pro výběr platformy pro instalaci K2 Obrázkového serveru. Tento produkt je možné naistalovat na operační systémy Microsoft Windows a Linux. Pro lokální instalaci na operační systém Microsoft Windows je nutné tuto volbu zatrhnout.
Obr.: Výběr operačního systému pro instalaci K2 Obrázkového serveru
Dalším krokem instalace je výběr typu protokolu pro komunikaci s K2 Obrázkovým serverem. Je zde na výběr standardní HTTP nebo zabezpečená varianta HTTPS.
Obr.: Typ protokolu pro K2 Obrázkový server
Další dialogové okno pak slouží pro výběr cílového adresáře, do nějž má být K2 Obrázkový server nainstalován.
Obr.: Výběr cílového adresáře
Po výběru cílového adresáře instalace následuje další dialogové okno, kde určujeme umístění aplikace (K2 Obrázkový server) na IIS. Z tohoto nastavení se poté poskládá celá URL adresa K2 Obrázkového serveru.
Obr.: Umístění na IIS
Popis polí:
Název IIS serveru |
Zde zadáváme název IIS, v rámci které bude K2 Obrázkový server nainstalován. Název IIS je zpravidla shodný s názvem počítače. |
Vyberte webovou stránku na IIS |
Pole pro výběr webu na IIS. Po standardní instalaci IIS je dostupný pouze tzv. „Default“ web. Zadáme zde tedy hodnotu Default Web Site. |
Název aplikace na IIS |
Název pro aplikaci na IIS. Jednoznačná identifikace aplikace na IIS. |
Náhled |
Tlačítko pro zobrazení kompletní URL adresy aplikace K2 Obrázkový server. |
Celá URL adresa K2 Obrázkového serveru se pak skládá z protokolu (HTTP nebo HTTPS), názvu IIS serveru a názvu aplikace na IIS.
Pomocí tlačítka Další přejdeme na další obrazovku, kde vybíráme adresář s uloženými obrázky pro e-shop.
Obr.: Výběr adresáře s obrázky pro e-shop
Dále pokračujeme opět tlačítkem Další. Zobrazí se dialog, který uživatele informuje o připravenosti instalace.
Obr.: Připravena instalace aplikace K2 Obrázkový server
Kliknutím na tlačítko Nainstalovat se pak spustí samotný průběh instalace.
Na závěr se po úspěšné instalaci zobrazí poslední dialog s informací o výsledku.
Obr.: Dokončení instalace
Instalace produktu K2 Obrázkový server na OS Linux (vzdálená instalace)
Instalace
Po spuštění instalace se zobrazí první dialog, který uživatele informuje, že je spuštěn instalátor pro produkt K2 Obrázkový server, a navíc se zobrazí číslo verze, která bude nainstalována, viz obr. Start instalace produktu K2 obrázkový server.
Obr.: Start instalace produktu K2 Obrázkový server
Po stisknutí tlačítka Další přejdeme k druhému dialogu, který obsahuje licenční ujednání. Zde je nutné licenční podmínky odsouhlasit.
Tlačítkem Další se dostaneme na třetí dialog, který slouží pro výběr platformy pro instalaci K2 Obrázkového serveru. Tento produkt je možné naistalovat na operační systémy Microsoft Windows a Linux. Pro lokální instalaci na operační systém Linux je nutné tuto volbu zatrhnout.
Obr.: Výběr operačního systému pro instalaci K2 Obrázkového serveru
V dalším okně instalátoru je nutné nastavit připojení na SFTP protokol pro přenos dat v prostředí Linux. Jedná se v podstatě o nastavení pro přenos souborů na linuxový server. To probíhá pomocí SFTP protokolu. K2 instalátor se pomocí zde zadaných údajů na tento protokol připojí.
Obr.: Nastavení připojení k SFTP v prostředí Linux
Popis polí:
Adresa SFTP |
Adresa cílového serveru pro vzdálenou instalaci produktu K2 Obrázkový server. Na tomto serveru musí být dostupný protokol SFTP. |
Uživatel pro připojení k SFTP |
Jméno uživatele pro připojení k SFTP. |
Cesta k souboru s privátním klíčem uživatele k SFTP |
Autorizace uživatele neprobíhá na základě zadaného hesla, ale využívá privátní klíč. V tomto poli je nutné zadat cestu ke tomuto klíči (souboru) pro autorizaci k SFTP. Protože toto přihlášení a tím pádem i klíč využívá také reinstalace produktu, nemělo by docházet k přesunu privátního klíče do jiného uložiště. |
Další dialogové okno pak slouží pro výběr adresáře pro dočasné soubory instalátoru. K2 instalátor si do tohoto adresáře uloží veškeré soubory, které pro danou instalaci používá. Toto uložiště nastavíme v poli Dočasné soubory umístit zde.
Obr.: Výběr adresáře pro dočasné soubory instalátoru
Dále pokračujeme opět tlačítkem Další. Zobrazí se dialog, který uživatele informuje o připravenosti instalace.
Obr.: Připravena instalace aplikace K2 Obrázkový server
Kliknutím na tlačítko Nainstalovat se pak spustí samotný průběh instalace.
Na závěr se po úspěšné instalaci zobrazí poslední dialog s informací o výsledku.
Obr.: Dokončení instalace
K2 device connector
Tento instalační balíček slouží k instalaci služby K2 device connector. Tato služba pak slouží k propojení Webové K2 s prostředky lokálního počítače, na kterém je Webová K2 používána.
Instalace
Po spuštění instalace se zobrazí první dialog, který uživatele informuje, že je spuštěn instalátor pro produkt Služba K2 device connector. Navíc se také zobrazí číslo verze, která bude nainstalována.
Obr.: Start instalace produktu Služba K2 device connector
Po stisknutí tlačítka Další přejdeme k druhému dialogu, který obsahuje licenční ujednání.
Obr.: Licenční ujednání
Další dialogové okno pak slouží pro výběr cílového adresáře, do nějž má být K2 device connector nainstalován.
Obr.: Výběr cílového adresáře
Dalším dialogem v instalaci je zadání jména a hesla uživatele, pod kterým bude služba K2 device connector běžet. Může být použit místní systémový účet viz obr. Místní systémový účet - K2 device connector anebo účet Windows uživatele, který vyžaduje heslo, viz obr.: Windows uživatel - K2 device connector.
Obr.: Místní systémový účet - K2 device connector
Obr.: Windows uživatel - K2 device connector
Po vyplnění všech údajů pak pokračujeme dále tlačítkem Další. Zobrazí se dialog, který uživatele informuje o připravenosti instalace.
Obr.: Připravena instalace produktu K2 device connector
Pomocí tlačítka Nainstalovat pak spustíme vlastní instalaci produktu.
Na závěr se po úspěšné instalaci zobrazí poslední dialog s informací o výsledku.
Obr.: Dokončení instalace
Rozšiřitelnost o další instalace
K2 instalátor je navržen tak, aby jej bylo možné rozšířit o libovolný počet dalších instalací. Každá instalace musí splňovat požadavky instalátoru tak, aby byla zajištěna funkční správa této instalace a jejich případných instancí. Požadavky jsou popsány v následující podkapitole.
Požadavky na instalační balíček
Aby bylo možné instalaci používat v K2 instalátoru, musí splňovat několik podmínek. Tento seznam není návodem, jak mají být podmínky realizovány. Jejich popis není předmětem tohoto manuálu. Tyto požadavky jsou splnitelné pouze kvalifikovaným pracovníkem, znalým v dané problematice.
- musí být vygenerovány Guidy (identifikátory) pro n dostupných instancí
- musí být zamezeno, aby se záznam o nainstalované instanci dal spravovat pomocí Přidat a odebrat programy v systému Windows.
- všechny vstupní hodnoty musí být ukládány do registru, aby se daly přečíst při aktualizaci programu.