SW ATTIS Postup aktualizace aplikace ATTIS Verze manuálu: 0.9 Datum: 22. 3. 2018 ATTN Consulting s.r.o. Strana: 1 / 11
Obsah 1. Základní schéma aplikace... 3 2. Nutná znalost a předpoklady pro provedení aktualizace aplikace... 4 3. Obsah aktualizačního balíčku ATTIS... 4 4. Před započetím aktualizace... 4 5. Aktualizace aplikace ATTIS stručný postup... 4 6. Podrobný postup aktualizace aplikace ATTIS... 6 Aktualizace desktopové části... 6 Aktualizace webové části... 7 Aktualizace aplikační služby... 8 Aktualizace databáze aplikace... 9 Spuštění aplikační služby, kontrola logu... 11 ATTN Consulting s.r.o. Strana: 2 / 11
1. Základní schéma aplikace Aplikace ATTIS je postavena na architektuře klient-server. Veškerá data jsou uložená v databázi, ke které přistupují klienti (desktopové aplikace, IIS). Přístup k databázi je definován v konfiguračním souboru aplikace. ATTIS Základní schéma aplikace ATTN Consulting s.r.o. Strana: 3 / 11
2. Nutná znalost a předpoklady pro provedení aktualizace aplikace Ukončení práce všech uživatelů s aplikací. - V případě, že aplikace bude spuštěná, nebude možné aktualizaci provést. Zastavení služby DenebJobService.exe aplikační služba (je-li nainstalována) - V případě, že služba bude spuštěná, nebude možné aktualizaci provést. Používané části aplikace přístup k binárním souborům. - Ne každý používá všechny zde uvedené části aplikace. - Desktopová část. - Webová část (nemusí být používána). - Aplikační služba (nemusí být používána). - V případě, že se používají, musí všechny části aplikace obsahovat stejnou verzi! Desktopová aplikace a aplikační služba mohou být instalovány ve stejném adresáři. Od nové Verze 4.9 není možné použít stávající konfigurační soubor z předchozích verzí. Je nutno použít novy který je obsažen v aktualizačním balíčku. Od verze 4.9 je nutné pro Webovou část mít nakopírovanou licenci ve správném umístění. 3. Obsah aktualizačního balíčku ATTIS Adresář Desktop-aplikace pro aktualizaci desktopové části a aplikační služby. Adresář Web-aplikace pro aktualizaci webové části. Adresář AD-Authentication aktualizace modulů pro ověřování AD. 4. Před započetím aktualizace Záloha databáze. Kontrola, že s aplikací nikdo nepracuje, zastavení aplikační služby. Záloha stávajících instalačních adresářů aplikace, zejména souborů *.config a *.licence. 5. Aktualizace aplikace ATTIS stručný postup Záloha databáze. Kontrola, že s aplikací nikdo nepracuje, zastavení aplikační služby. Smazání obsahu stávajících instalačních adresářů mimo podadresář ModelAdaptor (pokud existuje) a konfiguračního a licenčního souboru. Stažení aktualizačního balíčku ATTIS4_upgrade_xxx.zip. - xxx zkratka klienta, nebo verze aplikace (název balíčku dle obdrženého emailu s pokyny k aktualizaci) Na staženém balíčku klepněte pravým tlačítkem myši - Vlastnosti. V případě, že je soubor blokovaný, klepněte na tlačítko Unblock (Odblokovat). Obsah adresáře Desktop-aplikace v instalačním balíčku zkopírovat do původního adresáře desktopové aplikace, v případě používání i do adresáře aplikační služby. Původní obsah adresáře ATTN Consulting s.r.o. Strana: 4 / 11
smazat mimo podadresář ModelAdaptor (pokud existuje) a soubory s koncovkou config a licence. Obsah adresáře Web-aplikace v instalačním balíčku zkopírovat do původního adresáře webové aplikace. Původní obsah adresáře smazat mimo podadresář ModelAdaptor (pokud existuje) a soubory s koncovkou config. ATTN Consulting s.r.o. Strana: 5 / 11
POUZE pokud používám ověřování AD: 1) Obsah adresáře AD-Authentication v instalačním balíčku zkopírovat do původního adresáře desktopové aplikace. 2) Obsah adresáře AD-Authentication v instalačním balíčku zkopírovat do podsložky bin, původního adresáře webové aplikace. Z příkazového řádku spuštěného s oprávněním administrátor spustit v adresáři desktopové aplikace program pro aktualizaci databáze (pouze pokud mám instalováno): 1) s parametrem konfiguračního souboru desktopové aplikace: DBUpdater.exe -silent ATTIS4.Win.exe.config 2) s parametrem konfiguračního souboru web aplikace a knihovnou ATTIS4.Web.dll : DBUpdater.exe -silent c:\inetpub\wwwroot\%webapp%\web.config c:\inetpub\wwwroot\%webapp%\bin\attis4.web.dll \%webapp%\ nahradím dle své instalace 3) s parametrem konfiguračního souboru aplikační služby: DBUpdater.exe -silent Deneb.JobService.exe.config Je-li instalována tak spuštění aplikační služby, kontrola Windows aplikačního logu viz. podrobný postup aktualizace. 6. Podrobný postup aktualizace aplikace ATTIS Aktualizace desktopové části. Aktualizace webové části. Aktualizace aplikační služby. Aktualizace databáze aplikace Spuštění aplikační služby, kontrola logu Aktualizace desktopové části Smazání obsahu stávajícího instalačního adresáře mimo podadresáře ModelAdaptor a dále mimo konfiguračního a licenčního souboru. - Konfigurační soubory: ATTIS4.Win.exe.config Deneb.JobService.exe.config (nemusí existovat). - Licenční soubor: attis4.licence (nemusí existovat). Stažení aktualizačního balíčku ATTIS4_upgrade_xxx.zip xxx zkratka klienta, nebo verze aplikace (název balíčku dle obdrženého emailu s pokyny k aktualizaci) Na staženém balíčku klepněte pravým tlačítkem myši - Vlastnosti. V případě, že je soubor blokovaný, klepněte na tlačítko Unblock (Odblokovat). Př.: Zde uvedený soubor neodpovídá názvu Vaší aktualizace. ATTN Consulting s.r.o. Strana: 6 / 11
ATTIS Kontrola stažených souborů aplikace ATTIS, zda nejsou blokované Obsah adresáře Desktop-aplikace v instalačním balíčku zkopírovat do původního adresáře desktopové aplikace ke konfiguračnímu a licenčnímu souboru. Přejmenovaní ATTIS4.Win.exe.config na ATTIS4.Win.exe.config_old Nový konfigurační soubor ATTIS4.Win.exe.config.sample přejmenovat na ATTIS4.Win.exe.config a vložit do něj z původního konfiguračního souboru Connection string pro připojeni do DB. V případě dalších úprav v původním konfiguračním souboru nakopírovat i tyto změny POUZE pokud používám ověřování AD: Obsah adresáře AD-Authentication v instalačním balíčku zkopírovat do původního adresáře desktopové aplikace. Aktualizace webové části Smazání obsahu stávajícího instalačního adresáře mimo podadresáře ModelAdaptor a mimo konfiguračního souboru. - Konfigurační soubor: web.config. Stažení aktualizačního balíčku ATTIS4_upgrade_xxx.zip xxx zkratka klienta, nebo verze aplikace (název balíčku dle obdrženého emailu s pokyny k aktualizaci) Na staženém balíčku klepněte pravým tlačítkem myši - Vlastnosti. V případě, že je soubor blokovaný, klepněte na tlačítko Unblock. Př.: Zde uvedený soubor neodpovídá názvu Vaší aktualizace. ATTN Consulting s.r.o. Strana: 7 / 11
ATTIS Kontrola stažených souborů aplikace ATTIS, zda nejsou blokované Obsah adresáře Web-aplikace v instalačním balíčku zkopírovat do původního adresáře webové aplikace ke konfiguračnímu souboru web.config. Přejmenovaní Web.config na Web.config_old Nový konfigurační soubor Web.config.sample přejmenovat na Web.config a vložit do něj z původního konfiguračního souboru Connection string pro připojeni do DB. V případě dalších úprav v původním konfiguračním souboru nakopírovat i tyto změny Licenčni soubor jenž je použit pro Desktopovou část je nutné nově použit i pro Webový klient. Licenční soubor attis4.licence nakopírujeme do Vámi vytvořené složky C:\ProgramData\attis\attis4 POUZE pokud používám ověřování AD: Obsah adresáře AD-Authentication v instalačním balíčku zkopírovat do podsložky bin, původního adresáře webové aplikace. Aktualizace aplikační služby Zastavení aplikační služby. Instalační adresář aplikační služby může být shodný s adresářem desktopové aplikace. V tomto případě provedeme pouze start služby po provedené aktualizaci databáze viz.bod 6.4. a body 6.3. se Vás dále netýkají. Pokud je instalační adresář shodný s adresářem desktopové aplikace, následující kroky bodu 6.3. NEPROVÁDÍM! Smazání obsahu stávajícího instalačního adresáře včetně podadresářů, mimo konfiguračního souboru. - Konfigurační soubor: Deneb.JobService.exe.config Stažení aktualizačního balíčku ATTIS4_upgrade_xxx.zip xxx zkratka klienta, nebo verze aplikace (název balíčku dle obdrženého emailu s pokyny k aktualizaci) ATTN Consulting s.r.o. Strana: 8 / 11
Na staženém balíčku klepněte pravým tlačítkem myši - Vlastnosti. V případě, že je soubor blokovaný, klepněte na tlačítko Unblock. Př.: Zde uvedený soubor neodpovídá názvu Vaší aktualizace. ATTIS Kontrola stažených souborů aplikace ATTIS, zda nejsou blokované Obsah adresáře Desktop-aplikace v instalačním balíčku zkopírovat do původního adresáře aplikační služby ke konfiguračnímu souboru Deneb.JobService.exe.config. Aktualizace databáze aplikace Jednotlivé body provádíme pouze v případě, že daná aplikace je nainstalovaná. Po spuštění DBUpdater.exe -silent postupujeme dle výzev programu. Aktualizace může trvat řádově minuty, čekejte na informaci od programu. Z příkazového řádku spuštěného s oprávněním administrátor spustit v adresáři desktopové aplikace program pro aktualizaci desktopové aplikace s parametrem konfiguračního souboru desktopové aplikace: DBUpdater.exe -silent ATTIS4.Win.exe.config ATTN Consulting s.r.o. Strana: 9 / 11
Z příkazového řádku spuštěného s oprávněním administrátor spustit v adresáři desktopové aplikace program pro aktualizaci webové aplikace s parametrem konfiguračního souboru web aplikace a knihovnou ATTIS4.Web.dll : DBUpdater.exe -silent c:\inetpub\wwwroot\%webapp%\web.config c:\inetpub\wwwroot\%webapp%\bin\attis4.web.dll Pozn.: \%webapp% nahraďte Vaším jménem dle aktuální instalace Z příkazového řádku spuštěného s oprávněním administrátor spustit v adresáři kde je nainstalovaná služba program pro aktualizaci Deneb.JobService s parametrem konfiguračního souboru aplikační služby. DBUpdater.exe -silent Deneb.Jobservice.exe.config ATTN Consulting s.r.o. Strana: 10 / 11
Spuštění aplikační služby, kontrola logu Spustit službu Deneb.JobService Kontrola aplikačního eventlogu Windows - v případě úspěšné aktualizace musí log obsahovat dvě zprávy 1. The service has started 2. The service's main thread is running. ATTN Consulting s.r.o. Strana: 11 / 11