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

Z Prirucky
Řá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í
[[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í ==
== Ke stažení ==
Utilita MaPSetup.EXE je k dispozici ke stažení z odkazu
Utilita ''MaPSetup'' je k dispozici ke stažení z odkazu
: Z odkazu [http://download.ksprogram.cz/download download ksprogram] stáhněte soubor MapSetup.zip
: Z odkazu [http://download.ksprogram.cz/download download ksprogram] stáhněte soubor ''MapSetup.zip''.
 
== Rozbalení ==
Po stažení a rozbalení vzniknou tři soubory:
* ''MaPSetup.exe''
* <small>''MaPSetup.exe.config''</small>
* <small>''Zdroje.dll''</small>


== 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>. Pokud je toto splněno, objeví se po spuštění v titulku okna nápis [Administrátor].


=== Aktualizace z webu společnosti KS program, s.r.o. ===
'''2.''' V prvním okně '''vyberte produkt'''.
Tato volba provede
* '''stažení nejvyššího dostupného sestavení''' aplikace 
* '''rozbalení na místo, kde je aplikace na stanici nainstalovaná'''.


Konfiguraci internetového připojení je pro potřeby utility MaPsetup přebírána z nastavení Microsoft Internet Exploreru.
'''3.''' Další okna spouští '''samotnou aktualizaci''' (příp. slouží k nastavení konfigurace před aktualizací či provedení jiných akcí).
 
{|border="1" cellpadding="3" cellspacing="0"
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
|+ <small>MaPSetup</small>
 
|- style="background-color: #eeeeee"
 
|<small>Produkt</small>
Příklad spuštění
|<small>Okno č. 2</small>
 
|<small>Okno č. 3</small>
MaPSetup.exe /UPDATE /ICO 61946508 /TYPE TK /AKTUALIZOVAT_Z x:\AktualizaceAplikace
|-
 
|rowspan = "5"|[[Image: Mapsetup 1.png|100px|right]]
UPDATE - parametr určující aktualizaci aplikace
|-
 
|[[Image: Mapsetup 1-1.png|100px]]
ICO - ičo společnosti
|-
 
| [[Image: Mapsetup 1-2.png|100px]]
TYPE - typ akttualizace TK - těžký klient
| [[Image: Mapsetup 1-2-2.png|100px]]
 
|-
AKTUALIZOVAT_Z - cesta k aktualizačnímu adresáři pro uživatelé aplikace
| [[Image: Mapsetup 1-3.png|100px]]
 
| [[Image: Mapsetup 1-3-1.png|100px]]
 
|}
=== Změna nastavení ===
[[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
: ''C:\Program Files (x86)\KS Program''
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í ===
Volba umožňuje odstranění aplikace ze stanice.


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


== Instrukce a parametry MaPSetup ==
== 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.


{|class="wikitable sortable" border="1" cellpadding="3" cellspacing="0"
{|class="wikitable sortable" border="1" cellpadding="3" cellspacing="0"
Řádek 54: Řádek 51:
|<small>'''Popis'''</small>
|<small>'''Popis'''</small>
|-
|-
|'''/INSTALL'''
|''' /UPDATE'''
|Provede akci instalace.
|Provede akci aktualizace. Povinné.
|-
|-
|'''/UPDATE'''
|''' /NOCHECK'''
|Provede akci aktualizace.
| Vypne kontrolu, zda-li je už nové sestavení (verze) nainstalováno a zaktualizuje. Nepovinné.
|-
|-
|'''/REMOVE'''
|''' /REGISTER'''
|Provede odebrání aplikace.
| Zaregistruje DLL knihovny do registru. Povinné, pokud nejsou registrované knihovny. Jinak nepovinné.
|-
|-  
|'''/DELETE'''
|'''/FORCECLOSE'''
|Provede odebrání aplikace.
|Vynutí uzavření spuštěné aplikace,která je aktualizována. Pozor: neuloží práci, proto je doporučované zavírat manuálně před případnou aktualizací. Nepovinné.
|-
|-
|'''/SILENT'''
|'''/SILENT'''
|Tichý režim bez GUI.
|Tichý režim bez GUI. Nepovinné
|-
|-
|'''/NOLOG'''
|'''/NOLOG'''
|Nebude logovat.
|Nebude logovat. Nepovinné
|-
|'''/FORALL'''
|Nainstaluje/aktualizuje pro všechny.
|-
|-
|'''/FORCEVERSION'''
|'''/FORCEVERSION'''
|Vynutí specifickou verzi.
|Vynutí specifickou verzi.
|-
|'''/FORCECLOSE'''
|Natvrdo zavře spuštěnou aplikaci, která je aktualizována. Pozor: neuloží práci, proto je doporučované zavírat manuálně před případnou aktualizací.
|}
|}


Řádek 88: Řádek 79:
|<small>'''Popis'''</small>
|<small>'''Popis'''</small>
|-
|-
|'''/TYPE typ'''
|''' /TYPE typ'''
|Aktuálně jedna volba typ = TK (KS mzdy PROFi), další typy jsou ve fázi vývoje.
|Může nabývat jednu z těchto hodnot:
|-
* TK (KS mzdy PROFi)
|'''/TARGET složka'''
* WK (KS portál)
|Složka obsahuje umístění nainstalované/aktualizované aplikace.
* AS (KS aplikační server)
|-
Povinný parametr.
|'''/VERSION verze'''
|Verze obsahuje označení verze a sestavení, které je žádoucí aktualizovat (musí existovat a být uvolněná pro klienta).
|-
|'''/LOGIN uživatelské jméno'''
|
|-
|'''/PASSWORD heslo'''
|
|-
|-
|'''/DBPLATFORM databázová platforma'''
|''' /ICO identifikační číslo'''
|Databázová platforma nabývá jednu z hodnot MSSQL, ORACLE, INFORMIX, MYSQL, POSTGRE.
|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).
|-
|-
|'''/DB modifikovaný připojovací řetězec'''
|''' /DLL složka'''
|modifikovaný připojovací řetězec ve formátu "dbserver:databáze"
| 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 musí 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 parametr zbytenčný. Nepovinné.
|-
|-
|'''/ICO identifikační číslo'''
|''' /AKTUALIZOVAT_Z'''
|Identifikační číslo IČ organizace
| 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ý.
|-
|-
|'''/DB1 sekundární modifikovaný připojovací řetězec'''
|''' /INSTANCE1 složka'''  
|modifikovaný připojovací řetězec ve formátu "dbserver:databáze"
| Aktualizuje portál v umístění uvedeném za tímto parametrem (platné jen pro typ WK - pro něj povinné).
|-
|-
|'''/DB2 sekundární modifikovaný připojovací řetězec'''
|''' /INSTANCE2 složka'''
|modifikovaný připojovací řetězec ve formátu "dbserver:databáze"
| 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 [ftp.ksprogram.cz/download/ ftp.ksprogram.cz/download]. Ten, kdo provádí aktualizaci (jeho počítač), zde musí mít přístup.
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>


== 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>

Verze z 23. 2. 2017, 13:32

Aktualizace pomocí utility MaPSetup je jeden z možných způsobů aktualizací aplikací

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

Ke stažení

Utilita MaPSetup je k dispozici ke stažení z odkazu

Z odkazu download ksprogram stáhněte soubor MapSetup.zip.

Rozbalení

Po stažení a rozbalení vzniknou tři soubory:

  • MaPSetup.exe
  • MaPSetup.exe.config
  • Zdroje.dll

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). 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é.
/FORCECLOSE Vynutí uzavření spuštěné aplikace,která je aktualizována. Pozor: neuloží práci, proto je doporučované zavírat manuálně před případnou aktualizací. Nepovinné.
/SILENT Tichý režim bez GUI. Nepovinné
/NOLOG Nebude logovat. Nepovinné
/FORCEVERSION Vynutí specifickou verzi.
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 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 musí 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 parametr zbytenčný. Nepovinné.
/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ý.
/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 [ftp.ksprogram.cz/download/ ftp.ksprogram.cz/download]. Ten, kdo provádí aktualizaci (jeho počítač), zde musí mít přístup.

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

Citováno z „http://prirucky.ksprogram.cz/index.php?title=Aktualizace_pomocí_utility_MaPSetup&oldid=30414“