Aktualizace pomocí utility MaPSetup: Porovnání verzí
Řádek 1: | Řádek 1: | ||
'''Aktualizace pomocí utility MaPSetup''' je jeden z možných způsobů aktualizací aplikací | '''Aktualizace pomocí utility MaPSetup''' je jeden z možných způsobů aktualizací aplikací Ks mzdy, KS portál a Aplikační server KS, ostatní způsoby aktualizace jsou popsány v následujících samostatných stránkách: | ||
[[Image: Mapsetup 1.png|500px|right]] | [[Image: Mapsetup 1.png|500px|right]] | ||
# [[Aktualizace aplikace KS mzdy]]. | # [[Aktualizace aplikace KS mzdy]]. | ||
Řádek 5: | Řádek 5: | ||
# [[Aktualizace (Aplikační server KS)]] | # [[Aktualizace (Aplikační server KS)]] | ||
== | == Umístění == | ||
Utilita ''MaPSetup'' je | Utilita ''MaPSetup'' je součástí aplikace KS mzdy a je tedy ve složce MaP. MaPSetup lze stáhnout i [https://download.ksprogram.cz/download/MapSetup.zip zde] jako ZIP archív ''MapSetup.zip'', který rozbalte do libovolné složky. | ||
== | == Poslední změny == | ||
Ve verzi 10.0 bylo pro volbu AS zrušena volba "jednoduchý režim" a "expertní režim", nyní je pouze jeden. V okně s výběrem akce, pro produkt AS, se volba "Instalace" změní na "Změna instalace (přidání/odebrání instance)" pokud je AS nainstalován. Tato volba otevírá okno pro konfiguraci seznamu instancí AS, okno vychází z původního okna "Expertní konfigurátor AS". Bylo zamezeno volit si u každé instance AS umístění mimo instalační složku, volba názvu podsložky zůstala. Ruční vložení a smazání řádku v seznamu instancí bylo zakázáno a nyní slouží k tomuto účelu tlačítka "Přidat instanci" a "Odebrat instanci". V prvním sloupci "Akce" je informace, zda bude provedena aktualizace/instalace či odebrání instance. Byl přidán sloupec "TCP Port" pro možnost změnit si předdefinovaný port webových služeb aplikačního serveru. Opraveno přehození připojovacích řetězců k databázi mezi jednotlivými instancemi po odebrání instance AS (která nebyla poslední instancí). Kompletní seznam změn [https://download.ksprogram.cz/download/MapSetupChanges.txt zde]. | |||
== Funkcionalita == | == Funkcionalita == | ||
'''1.''' '''Spusťte''' aplikaci '''''MaPSetup.exe'''''. <br> | '''1.''' '''Spusťte''' aplikaci '''''MaPSetup.exe'''''. <br> | ||
Poznámka: Spouštějte aplikaci pod účtem s oprávněním ''Správce počítače'' <small>(Windows: Účty - Správce)</small>. Pokud je toto splněno, objeví se po spuštění v titulku okna nápis [Administrátor]. | Poznámka: Spouštějte aplikaci pod účtem s oprávněním ''Správce počítače'' <small>(Windows: Účty - Správce)</small>, jinak nemusíte mít oprávnění měnit soubory aplikace. Pokud je toto splněno, objeví se po spuštění v titulku okna nápis [Administrátor]. | ||
'''2.''' V prvním okně '''vyberte produkt'''. | '''2.''' V prvním okně '''vyberte produkt'''. | ||
Řádek 60: | Řádek 56: | ||
| Zaregistruje DLL knihovny do registru. Povinné, pokud nejsou registrované knihovny. Jinak nepovinné. | | Zaregistruje DLL knihovny do registru. Povinné, pokud nejsou registrované knihovny. Jinak nepovinné. | ||
|- | |- | ||
|''' / | |''' /CLOSE''' | ||
| | |Automaticky se zavře poslední okno po provedení aktualizace. Nepovinné. | ||
|- | |||
|''' /AUTO''' | |||
|Automaticky se stiskne tlačítko Další nebo Aktualizovat. Nepovinné. | |||
|- | |- | ||
|''' /SILENT''' | |''' /SILENT''' | ||
Řádek 96: | Řádek 95: | ||
|- | |- | ||
|''' /DLL složka''' | |''' /DLL složka''' | ||
| Zaregistruje DLL knihovny do registru s explicitním uvedením cesty (platné u typu TK). Pokud je KS mzdy PROFi nainstalován na serveru a uživatelé jej spouštění vzdáleně, pak | | Zaregistruje DLL knihovny (COM komponenty knihoven KSOleModul.dll a KSNetBridge.dll) do registru s explicitním uvedením cesty (platné u typu TK). (Pokud je KS mzdy PROFi nainstalován na serveru a uživatelé jej spouštění vzdáleně, pak musela být na lokálním počítači uvedená cesta do serverového umístění KS mzdy PROFi. Pokud již DLL knihovny jsou zaregistrované, je opakované použití parametru zbytečné.) Registrace DLL již není nutná (díky main.exe.manifest), pokud však již byla provedena, může být toto potřeba, pokud hodnota v registru odkazuje na již neplatné umístění. Nepovinné. | ||
|- | |- | ||
|''' /AKTUALIZOVAT_Z''' | |''' /AKTUALIZOVAT_Z''' | ||
| Pro typ TK. Nepovinné. Aktualizuje soubory jak na lokálním počítači tak na aktualizačním serveru. Platí pro případ, kdy se aplikace KS mzdy PROFi na lokálních stanicích aktualizují z umístění uvedeného v parametru [[AKTUALIZOVAT_Z (sk.13)]]; v tom případě je parametr povinný. | | Pro typ TK. Nepovinné. Aktualizuje soubory jak na lokálním počítači tak na vašem aktualizačním serveru. Platí pro případ, kdy se aplikace KS mzdy PROFi na lokálních stanicích aktualizují z umístění uvedeného v parametru [[AKTUALIZOVAT_Z (sk.13)]]; v tom případě je parametr povinný, jinak si lokální stanice opět stáhne starou verzi z vašeho aktualizačního serveru. | ||
|- | |- | ||
|''' /INSTANCE1 složka''' | |''' /INSTANCE1 složka''' | ||
Řádek 126: | Řádek 125: | ||
== Poznámky == | == Poznámky == | ||
Soubory pro aktualizaci (sbalené ve formě .ZIP) jsou získávány z webu [ | Soubory pro aktualizaci (sbalené ve formě .ZIP) jsou získávány z webu [https://download.ksprogram.cz/download]. Počítač toho, kdo provádí aktualizaci, tedy nesmí mít blokován přístup k této adrese antivirem či podnikovým firewalem. | ||
Cesta pro aktualizaci aplikace KS mzdy PROFi je vyhledána automaticky z registrů Windows. <small>HKEY_LOCAL_MACHINE/SOFTWARE/Microsoft Windows/Current Version/APPPath/main.exe. Pokud je zde více klíčů, bere se v úvahu první, výchozí. </small> | Cesta pro aktualizaci aplikace KS mzdy PROFi je vyhledána automaticky z registrů Windows. <small>HKEY_LOCAL_MACHINE/SOFTWARE/Microsoft Windows/Current Version/APPPath/main.exe. Pokud je zde více klíčů, bere se v úvahu první, výchozí. </small> |
Verze z 23. 9. 2022, 13:25
Aktualizace pomocí utility MaPSetup je jeden z možných způsobů aktualizací aplikací Ks mzdy, KS portál a Aplikační server KS, ostatní způsoby aktualizace jsou popsány v následujících samostatných stránkách:
Umístění
Utilita MaPSetup je součástí aplikace KS mzdy a je tedy ve složce MaP. MaPSetup lze stáhnout i zde jako ZIP archív MapSetup.zip, který rozbalte do libovolné složky.
Poslední změny
Ve verzi 10.0 bylo pro volbu AS zrušena volba "jednoduchý režim" a "expertní režim", nyní je pouze jeden. V okně s výběrem akce, pro produkt AS, se volba "Instalace" změní na "Změna instalace (přidání/odebrání instance)" pokud je AS nainstalován. Tato volba otevírá okno pro konfiguraci seznamu instancí AS, okno vychází z původního okna "Expertní konfigurátor AS". Bylo zamezeno volit si u každé instance AS umístění mimo instalační složku, volba názvu podsložky zůstala. Ruční vložení a smazání řádku v seznamu instancí bylo zakázáno a nyní slouží k tomuto účelu tlačítka "Přidat instanci" a "Odebrat instanci". V prvním sloupci "Akce" je informace, zda bude provedena aktualizace/instalace či odebrání instance. Byl přidán sloupec "TCP Port" pro možnost změnit si předdefinovaný port webových služeb aplikačního serveru. Opraveno přehození připojovacích řetězců k databázi mezi jednotlivými instancemi po odebrání instance AS (která nebyla poslední instancí). Kompletní seznam změn zde.
Funkcionalita
1. Spusťte aplikaci MaPSetup.exe.
Poznámka: Spouštějte aplikaci pod účtem s oprávněním Správce počítače (Windows: Účty - Správce), jinak nemusíte mít oprávnění měnit soubory aplikace. Pokud je toto splněno, objeví se po spuštění v titulku okna nápis [Administrátor].
2. V prvním okně vyberte produkt.
3. Další okna spouští samotnou aktualizaci (příp. slouží k nastavení konfigurace před aktualizací či provedení jiných akcí).
Pokud je již nainstalováno nejnovější sestavení aplikace, zobrazí se hláška: .
Instrukce a parametry MaPSetup
Pomocí instrukcí a parametrů lze dosáhnout cíleného spouštění, např. aktualizace konkrétního typu, do určitého adresáře, apod. Mohou být založeny například 3 ikony, každá pro aktualizaci samostatného produktu.
Instrukce | Popis |
/UPDATE | Provede akci aktualizace. Povinné. |
/NOCHECK | Vypne kontrolu, zda-li je už nové sestavení (verze) nainstalováno a zaktualizuje. Nepovinné. |
/REGISTER | Zaregistruje DLL knihovny do registru. Povinné, pokud nejsou registrované knihovny. Jinak nepovinné. |
/CLOSE | Automaticky se zavře poslední okno po provedení aktualizace. Nepovinné. |
/AUTO | Automaticky se stiskne tlačítko Další nebo Aktualizovat. Nepovinné. |
/SILENT | Tichý režim bez GUI. Nepovinné |
/NOLOG | Nebude logovat. Nepovinné |
/FORCEVERSION | Vynutí specifickou verzi. |
/SETPROXY | MaPSetup (Proxy) |
/PROXY | MaPSetup (Proxy) |
Parametr | Popis |
/TYPE typ | Může nabývat jednu z těchto hodnot:
Povinný parametr. |
/ICO identifikační číslo | Identifikační číslo IČ organizace (platné u typů TK, WK), pro níž je sestavení uvolněno. Pokud není uvedeno, zaktualizuje se na poslední standardní sestavení (uvolněné všem uživatelům). |
/DLL složka | Zaregistruje DLL knihovny (COM komponenty knihoven KSOleModul.dll a KSNetBridge.dll) do registru s explicitním uvedením cesty (platné u typu TK). (Pokud je KS mzdy PROFi nainstalován na serveru a uživatelé jej spouštění vzdáleně, pak musela být na lokálním počítači uvedená cesta do serverového umístění KS mzdy PROFi. Pokud již DLL knihovny jsou zaregistrované, je opakované použití parametru zbytečné.) Registrace DLL již není nutná (díky main.exe.manifest), pokud však již byla provedena, může být toto potřeba, pokud hodnota v registru odkazuje na již neplatné umístění. Nepovinné. |
/AKTUALIZOVAT_Z | Pro typ TK. Nepovinné. Aktualizuje soubory jak na lokálním počítači tak na vašem aktualizačním serveru. Platí pro případ, kdy se aplikace KS mzdy PROFi na lokálních stanicích aktualizují z umístění uvedeného v parametru AKTUALIZOVAT_Z (sk.13); v tom případě je parametr povinný, jinak si lokální stanice opět stáhne starou verzi z vašeho aktualizačního serveru. |
/INSTANCE1 složka | Aktualizuje portál v umístění uvedeném za tímto parametrem (platné jen pro typ WK - pro něj povinné). |
/INSTANCE2 složka | Aktualizuje portál v umístění uvedeném za tímto parametrem - pokud existuje i vedlejší instance (platné jen pro typ WK - pro něj povinné). |
- Na pořadí a velikosti písmen v instrukcích a parametrech nezáleží.
- Stejně tak nezáleží na sklonu lomítka.
- Pokud se povinné parametry či instrukce pro daný typ neuvedou, spustí se grafické rozhraní MaPSetup.
- V případě, že se v cestě u některého z parametrů (DLL, AKTUALIZOVAT_Z, INSTANCE1, INSTANCE2) vyskytuje mezera, uvozte tuto cestu uvozovkami " ".
Příklady
Aktualizace KS mzdy PROFi
MaPSetup.exe /UPDATE /ICO 12345678 /TYPE TK MaPSetup.exe /UPDATE /ICO 12345678 /TYPE TK /AKTUALIZOVAT_Z "X:\KS Program\AktualizaceAplikace" MaPSetup.exe /UPDATE /ICO 12345678 /TYPE TK /NOCHECK
Aktualizace aplikace KS portál
MaPSetup.exe /UPDATE /TYPE WK /ICO 12345678 /INSTANCE1 D:\KSPortal MaPSetup.exe /UPDATE /TYPE WK /ICO 12345678 /INSTANCE1 D:\KSPortal\Hlavni /INSTANCE2 D:\KSPortal\Test
Uvedené IČ je pouze ilustrativní.
Poznámky
Soubory pro aktualizaci (sbalené ve formě .ZIP) jsou získávány z webu [1]. Počítač toho, kdo provádí aktualizaci, tedy nesmí mít blokován přístup k této adrese antivirem či podnikovým firewalem.
Cesta pro aktualizaci aplikace KS mzdy PROFi je vyhledána automaticky z registrů Windows. HKEY_LOCAL_MACHINE/SOFTWARE/Microsoft Windows/Current Version/APPPath/main.exe. Pokud je zde více klíčů, bere se v úvahu první, výchozí.