Adresářová struktura na serveru
Komunikace mezi serverem a instalační službou
Při instalaci instalační služby na klientský počítač je možné uvést:
• | Adresář, do kterého má být služba nainstalována. |
• | Jméno účtu a heslo, pod kterým služba poběží. |
• | Parametry, se kterými má být služba spuštěna. |
Požadavek na instalaci balíčku obsahuje:
• | Jméno instalačního balíčku včetně cesty. |
• | Parametry, se kterými má být instalační balíček spuštěn. |
Službu je možné spustit s parametry určujícími:
• | sdílený adresář s požadavky a výsledky instalace, |
• | číslo portu, na kterém instalační služba přijímá příkazy ze serveru, |
• | kdy má být kontrolován. |
Chybové stavy (např. nedostupný zdroj adresář s požadavky) jsou zapisovány do systémového logu událostí. Informace o průběhu instalace jednotlivých balíčků jsou zapisovány do souboru logu příslušného balíčku na serveru.
Požadavky jsou zpracovávány v abecedním pořadí podle identifikátoru požadavku. (Tím je zajištěna primitivní podpora pro řešení závislostí.)
Postup zpracování požadavku:
• | Instalační balíček je zkopírován na lokální disk. To by mělo být výhodné zejména v případě, že by v průběhu instalace byl potřeba restartu. |
• | Balíček je spuštěn s požadovanými parametry: |
o | Výstup instalačního balíčku na konsoli je instalační službou přesměrován do souboru logu na serveru. |
o | Návratový kód instalačního balíčku je zpracován následovně: |
Popis |
|
---|---|
0 |
Instalace proběhla úspěšně. |
1 |
Instalace proběhla úspěšně. Je vyžadován restart. |
2 |
Instalace vyžaduje restart. Po restartu bude instalační balíček opět spuštěn se stejnými parametry plus "--restarted". |
3 a vyšší |
Instalace se nezdařila. |
• | V případě požadavku na restart je uživateli zobrazena výzva, kterou může potvrdit nebo odmítnout. V případě odmítnutí instalační služba čeká až do manuálního restartu. |
• | Instalace dalšího balíčku je spuštěna až po dokončení předchozího (s jakýmkoliv výsledkem). |
Instalační balíček musí splňovat tyto požadavky:
• | Návratový kód odpovídá tabulce (viz výše). |
Instalační balíček by měl splňovat tyto požadavky
• | Log vypisuje pomocí standardního výstupu na konzoli (out nebo err stream). |
• | Běží skrytě, nevyžaduje interakci s uživatelem. |
Viz též kapitola Seznam instalačních balíčků.
Adresářová struktura na serveru
Pro každý klientský počítač musí být po síti dostupný adresář, do kterého má právo čtení i zápisu uživatel, pod jehož účtem běží instalační služba na klientských počítačích. Tento adresář obsahuje podadresáře requests a results.
Adresář requests obsahuje soubory ve tvaru <identifikátor požadavku>.request, kde identifikátor požadavku může být cokoliv. Po ukončení instalace (s libovolným výsledkem) instalační služba přesune soubor s požadavkem z adresáře requests do adresáře results. Soubory v adresáři request jsou vytvářeny instalačním nástrojem.
Adresář results obsahuje logy ve tvaru <identifikátor požadavku>.log a soubory ve tvaru <identifikátor požadavku>.<result>, kde result může být jedna z hodnot "ok" (instalace ukončena úspěšně) nebo "error" (instalace ukončena s chybou). Soubory v adresáři results jsou vytvářeny instalační službou.
Struktura souboru s požadavkem
Struktura souboru s požadavkem
Soubor obsahuje jeden až dva řádky. Na prvním řádku je jméno balíčku včetně plné síťové cesty. Na druhém řádku mohou být parametry, se kterými má být balíček spuštěn.
Soubor může obsahovat textové shrnutí výsledku instalace nebo může být prázdný.
Komunikace mezi serverem a instalační službou
Instalační služba naslouchá na daném portu, na kterém ji může kontaktovat server.
Možné příkazy jsou:
Příkaz |
Odpověď |
Popis |
---|---|---|
CHECK_REQUESTS |
OK |
Služba překontroluje adresář s požadavky. |