Aktualizace pomocí utility MaPSetup: Porovnání verzí

Z Prirucky
 
(Není zobrazeno 14 mezilehlých verzí od 2 dalších uživatelů.)
Řádek 1: Řádek 1:
'''Aktualizace pomocí utility MaPSetup''' je jeden z možných způsobů [[aktualizace aplikace KS mzdy]].
'''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: Aktualizace-pomoci-utility-MaPSetup-aktualizace-1.png|right|400px]]
[[Image: Mapsetup 1.png|500px|right]]
# [[Aktualizace aplikace KS mzdy]].
# [[Portál-Aktualizace]]
# [[Aktualizace (Aplikační server KS)]]


== Ke stažení ==
== Umístění ==
Utilita MaPSetup.EXE je k dispozici ke stažení z odkazu
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.
: http://download.ksprogram.cz/download/MapSetup.zip
 
== Poslední změny ==
Ve verzi 10.0 byla 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 ve verzi 10.0 je [https://download.ksprogram.cz/download/MapSetupChanges.txt zde].


== Funkcionalita ==
== Funkcionalita ==
Po stažení a rozbalení spusťte aplikaci MaPSetup.EXE. Po otevření okna je k dispozici několik voleb:
'''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>, 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'''.


=== Aktualizace z webu společnosti KS program, s.r.o. ===
'''3.''' Další okna spouští '''samotnou aktualizaci''' (příp. slouží k nastavení konfigurace před aktualizací či provedení jiných akcí).
Tato volba provede
{|border="1" cellpadding="3" cellspacing="0"
* '''stažení nejvyššího dostupného sestavení''' aplikace a její
|+ <small>MaPSetup</small>
* '''rozbalení na místo, kde je aplikace na stanici nainstalovaná'''.
|- style="background-color: #eeeeee"
|<small>Produkt</small>
|<small>Okno č. 2</small>
|<small>Okno č. 3</small>
|-
|rowspan = "5"|[[Image: Mapsetup 1.png|100px|right]]
|-
|[[Image: Mapsetup 1-1.png|100px]]
|-
| [[Image: Mapsetup 1-2.png|100px]]
| [[Image: Mapsetup 1-2-2.png|100px]]
|-
| [[Image: Mapsetup 1-3.png|100px]]
| [[Image: Mapsetup 1-3-1.png|100px]]
|}


Konfiguraci internetového připojení je pro potřeby utility MaPsetup přebírána z nastavení Microsoft Internet Exploreru.
Pokud je již nainstalováno nejnovější sestavení aplikace, zobrazí se hláška: [[Image: Mapsetup mate-nainstalovanu-nejnovejsi-verzi.png|50px]].


Spuštěním utility MapSetup s parametrem /AKTUALIZOVAT_Z dojde k zapsání aktualizačních souboru do aktualizačního adresáře nastaveného v Rozšiřujících parametrech
== 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.


Příklad spuštění
{|class="wikitable sortable" border="1" cellpadding="3" cellspacing="0"
|+ <small>Instrukce MaPSetup.exe</small>
|-
|<small>'''Instrukce'''</small>
|<small>'''Popis'''</small>
|-
|''' /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)]]
|-
|'''/SINGLE'''
| Též pro odstranění hlášky, kdy MaPSetup je vyhodnocen jinými programy jako "vir". <small>Pozor: nedochází ke stažení nové verze MaPSetup.</small>
|}


MapSetup.exe /AKTUALIZOVAT_Z cesta
{|class="wikitable sortable" border="1" cellpadding="3" cellspacing="0"
|+ <small>Parametry MaPSetup.exe</small>
|-
|<small>'''Parametr'''</small>
|<small>'''Popis'''</small>
|-
|''' /TYPE typ'''
|Může nabývat jednu z těchto hodnot:
* TK (KS mzdy PROFi)
* WK (KS portál)
* AS (KS aplikační server)
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é).
|}


cesta -  cesta k aktualizačnímu adresáři např. x:\AktualizaceAplikace, nebo  \\server\AktualizaceAplikace
* 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


MapSetup.exe /AKTUALIZOVAT_Z x:\AktualizaceAplikace
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


=== Změna nastavení ===
Uvedené IČ je pouze ilustrativní.
[[Image: Aktualizace-pomoci-utility-MaPSetup-zmena-nastaveni.png|right|100px]]
Tato volba je určena k nastavení účtu, pod kterým se aktualizace provádí. Pokud bude nastaven pro aktualizaci uživatel se silnějšími právy na stanici, bude při příštím spuštění aktualizace využit tento účet. Aktuálně použitý uživatel aktualizace je zobrazen v titulku okna.


Zároveň tato volba umožňuje přesunutí aplikace do jiného adresáře. Pokud je aplikace nainstalovaná např. do adresáře
== Poznámky ==
: ''C:\Program Files (x86)\KS Program''
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.
je možné ji přesunout např. do
: ''C:\ProgramData\KS Program''.  
Utilita se současně pokusí změnit i zástupce na ploše, pokud dříve ukazovaly na původní adresář spouštění.


=== Odinstalování ===
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>
Volba umožňuje odstranění aplikace ze stanice.


== Odkazy ==
== Odkazy ==
* [[Aktualizace aplikace KS mzdy]]
* [[Aktualizace aplikace KS mzdy]]
* <small>[[Aktualizace aplikace]] </small>
* <small>[[Aktualizace aplikace]] </small>
* <small><s>[[Aktualizace pomocí utility MaPSetup - starší verze 1]]</s></small>

Aktuální verze z 27. 9. 2023, 10:32

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:

Mapsetup 1.png
  1. Aktualizace aplikace KS mzdy.
  2. Portál-Aktualizace
  3. Aktualizace (Aplikační server KS)

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 byla 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 ve verzi 10.0 je 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í).

MaPSetup
Produkt Okno č. 2 Okno č. 3
Mapsetup 1.png
Mapsetup 1-1.png
Mapsetup 1-2.png Mapsetup 1-2-2.png
Mapsetup 1-3.png Mapsetup 1-3-1.png

Pokud je již nainstalováno nejnovější sestavení aplikace, zobrazí se hláška: Mapsetup mate-nainstalovanu-nejnovejsi-verzi.png.

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 MaPSetup.exe
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)
/SINGLE Též pro odstranění hlášky, kdy MaPSetup je vyhodnocen jinými programy jako "vir". Pozor: nedochází ke stažení nové verze MaPSetup.
Parametry MaPSetup.exe
Parametr Popis
/TYPE typ Může nabývat jednu z těchto hodnot:
  • TK (KS mzdy PROFi)
  • WK (KS portál)
  • AS (KS aplikační server)

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í.

Odkazy