SW ATTIS Technická příručka instalace a zálohování

SW ATTIS nástroje manažerského řízení

SW ATTIS

Technická příručka instalace a zálohování

Verze manuálu: 14.4 Datum: 23. 9. 2016

ATTN Consulting s.r.o.

Strana: 1 / 39

Hanušova 100/10, 779 00 Olomouc, Czech Republic www.attis.cz, e-mail: [email protected], tel.: +420 585 751 601, IČ: 25894978, DIČ: CZ25894978, č.ú.: 533417001/5500 Společnost je zapsána v Obchodním rejstříku vedeném Krajským soudem v Ostravě, oddíl C, vložka 24596.

SW ATTIS nástroje manažerského řízení Obsah 1.

Základní schéma aplikace .....................................................................................................................................5

2.

Logika aplikace – možnosti chování......................................................................................................................6 Konfigurační a licenční soubory aplikace......................................................................................................6 Nastavení uživitelského zobrazení desktopové aplikace. .............................................................................6 Nastavení uživitelského zobrazení webové aplikace. ...................................................................................6 Umístění aplikačního logu. ...........................................................................................................................6 První přihlášení – jméno\heslo. ....................................................................................................................6

3.

Instalace desktopové aplikace ..............................................................................................................................8 Stručný postup instalace desktopové aplikace.............................................................................................8 Podrobný postup instalace desktopové aplikace. ........................................................................................8 Kopie souborů aplikace do sdíleného adresáře aplikace......................................................................8 Oprávnění k instalačnímu adresáři. ......................................................................................................9 Konfigurační a licenční soubor aplikace. ..............................................................................................9 Nastavení logování aplikace. ................................................................................................................9 Spuštění aplikace. ...............................................................................................................................10

4.

Instalace aplikační služby....................................................................................................................................11 Kopie souborů aplikace do adresáře aplikace. ...........................................................................................11 Konfigurační soubor aplikační služby. ........................................................................................................11 Nastavení logování aplikační služby. ..........................................................................................................12 Spuštění aplikační služby. ...........................................................................................................................12

5.

Instalace webové aplikace ..................................................................................................................................13 Stručný postup instalace webové aplikace na IIS. ......................................................................................13 Podrobný postup instalace webové aplikace na IIS. ..................................................................................13 Kopie souborů aplikace do adresáře aplikace. ...................................................................................13 Povolení „Role Services“ v „Server Manageru“. .................................................................................15 Nastavení IIS (Internet Information Services).....................................................................................15 Konfigurační soubor aplikace. ............................................................................................................18 Nastavení logování aplikace. ..............................................................................................................19 Přístup k webové aplikaci. ..........................................................................................................................20 Pomocí webového prohlížeče.............................................................................................................20 Kompatibilita zobrazení v IE 11. .........................................................................................................20

6.

Instalace SQL Serveru .........................................................................................................................................21


Strana: 2 / 39


SW ATTIS nástroje manažerského řízení Doporučené nastavení SQL Serveru. ..........................................................................................................21 Instalace SQL Serveru. ................................................................................................................................21 Konfigurace SQL Serveru. ...........................................................................................................................22 Uživatelské oprávnění k práci s databází. ...................................................................................................24 Závěrečné práce pro použití aplikací. .........................................................................................................26 7.

Možnosti přihlášení do aplikace ATTIS4 .............................................................................................................27 Pomocí uživatelské jména a hesla. .............................................................................................................27 Použitím „Windows Authentication“ – AD. ................................................................................................27 Nastavení IIS – webová aplikace. ........................................................................................................27 Nastavení desktopové – síťové verze aplikace. ..........................................................................................29

8.

Detailní popis položek konfiguračních souborů .................................................................................................30

9.

Zálohování a obnova aplikace ATTIS...................................................................................................................31 Pravidelnost. ...............................................................................................................................................31 Způsoby provedení zálohy. .........................................................................................................................31 Záloha pomocí nástrojů v rámci aplikace. ..........................................................................................31 Záloha pomocí standardních nástrojů pro práci s MS SQL serverem. ................................................32 Obnova dat. ................................................................................................................................................32 Obnova dat při prvním spuštění aplikace. ..........................................................................................32 Obnova dat pomocí nástrojů v rámci aplikace. ..................................................................................32

10.

Kontrolní body po instalaci .............................................................................................................................33 Firewall (součást Windows nebo antivirového řešení)...........................................................................33 Obsah instalačních adresářů. ..................................................................................................................33 SQL Server. ..............................................................................................................................................33 Spuštění aplikace. ...................................................................................................................................33

11.

Různé - dodatek ..............................................................................................................................................34 Instalace více instancí aplikace. ..............................................................................................................34 Webová aplikace je pomalá – dlouhé odezvy. .......................................................................................34 Úprava v registru. ...............................................................................................................................34 Kontrola „web.config“ aplikace. .........................................................................................................34 Recyklace „Application Pool“..............................................................................................................34 Nastavení jazyka webové aplikace. ........................................................................................................35 U webové aplikace nefunguje ověřování AD. .........................................................................................35 Omezení přístupu uživatelů přes webovou aplikaci při ověřování AD. ..................................................35 IE 11 – zobrazuje stránku špatně – ikony na horní liště. ........................................................................36


Strana: 3 / 39


SW ATTIS nástroje manažerského řízení První spuštění desktopové aplikace trvá dlouho. ...................................................................................36 Dlouhotrvající odezvy SQL Serveru. ....................................................................................................36 Pomalé síťové připojení. .....................................................................................................................37 Nastavení intervalu automatického znovunačtení stránky ve Webové aplikaci. ...................................37 Konfigurace znovunačtení stránky. ....................................................................................................37 Pozor na správné nastavení. ...............................................................................................................38 Chyba otevírání zdrojů - WWW. .............................................................................................................38 Kontrola povolení otevírání POPup oken v prohlížeči. .......................................................................38 Form Authentication - Ověření práv k odkazovanému dokumentu. ..................................................38 Windows Authentication - Ověření práv k odkazovanému dokumentu. ...........................................39


Strana: 4 / 39


SW ATTIS nástroje manažerského řízení 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


Strana: 5 / 39


SW ATTIS nástroje manažerského řízení 2. Logika aplikace – možnosti chování Konfigurační a licenční soubory. Nastavení uživitelského zobrazení aplikace (oken) je pro každého uživatele jedinečné, nebo sdílené všemi uživateli. Webová aplikace používá cookies. Umístění aplikačního logu je v instalačním adresáři aplikace nebo profilu uživatele.

Konfigurační a licenční soubory aplikace. Nastavení aplikace je uloženo v konfiguračním souboru. V konfiguračním souboru je definováno: zda se aplikace bude spouštět na síti, jazykové verze, umístění log souborů, definice připojení k SQL databázi, umístění uložení uživatelsky definovaných rozložení. Konfigurační soubor je uložen v instalačním adresáři aplikace. Licenční soubor „attis4.licence“ je uložen v instalačním adresáři aplikace nebo v profilu uživatele „%userprofile%\AppData\Roaming\ATTIS\ATTIS4\attis4.licence“ Licence se hledá v pořadí 1. profil uživatele 2. instalační adresář.

Nastavení uživitelského zobrazení desktopové aplikace. V případě ukládání uživatelských rozložení v instalačním adresáři aplikace, jsou tato rozložení pro všechny přihlášené uživatele shodná. Nově přihlašovanému uživateli bude předvyplněno uživatelské jméno předchozího přihlášeného uživatele. V případě požadavku na ukládání do profilu uživatele, je nutné mít v konfiguračním souboru desktopové aplikace doplněny následující údaje: Toto nám zajistí, že každý uživatel bude mít vlastní nastavení, kterré nebude nikdo jiný přepisovat.

Nastavení uživitelského zobrazení webové aplikace. U webové aplikace jsou informace uloženy ve formě cookies. Úpravy v konfiguračním souboru jsou bezpředmětné.

Umístění aplikačního logu. Defaultní umístění aplikačního logu je v instalačním adresáři aplikace. Požadujeme-li umístění logu v profilu uživatele, musí konfigurační soubor obsahovat následující položku:

První přihlášení – jméno\heslo. Pro první přihlášení použiji: jméno: admin heslo: [bez hesla] - následně jsem vyzván ke změně hesla. Pokud mám obnovenou dodanou zálohu, přístupové údaje mi sdělí dodavatel databáze.


Strana: 6 / 39




Strana: 7 / 39


SW ATTIS nástroje manažerského řízení 3. Instalace desktopové aplikace Stručný postup instalace desktopové aplikace. Soubory aplikace v balíčku: ATTIS4_bin.zip – adresář „Win-aplikace“. Na staženém souboru „ATTIS4_bin.zip“ klepněte pravým tlačítkem myši - Vlastnosti. V případě, že je soubor blokovaný, klepněte na tlačítko „Unblock“. Ze staženého ZIP balíčku rozbalit obsah adresáře „Win-aplikace“ do umístění na disku, kde má uživatel oprávnění pro čtení i zápis např. do adresáře „ATTIS4“ (v konfiguraci aplikace lze upravit, aby stačilo oprávnění ke čtení, viz kapitola 7). Dále je třeba upravit konfigurační soubor aplikace „attis4.win.exe.config“ a uložit do instalačního adresáře. Úprava položek konfiguračního souboru aplikace viz kapitola 3.2.3. Vložení licenčního souboru aplikace „attis4.licence“ do instalačního adresáře. Vytvořit zástupce na ploše, který odkazuje do instalačního adresáře aplikace na soubor „attis4.win.exe“.

Podrobný postup instalace desktopové aplikace. Postupné kroky: Kopie souborů aplikace do sdíleného adresáře aplikace. Oprávnění k instalačnímu adresáři. Konfigurační a licenční soubor aplikace.

Kopie souborů aplikace do sdíleného adresáře aplikace.

Na stažený soubor klepněte pravým tlačítkem myši. V případě, že je soubor blokovaný, klepněte na tlačítko „Unblock“.

ATTIS – Kontrola stažených souborů aplikace ATTIS, zda nejsou blokované


Strana: 8 / 39


SW ATTIS nástroje manažerského řízení Oprávnění k instalačnímu adresáři.

Minimální oprávnění k instalačnímu adresáři – čtení, standardní čtení-zápis. Rozbalit ze staženého balíčku obsah adresáře „Win-aplikace“ na místo na disku, kde má uživatel oprávnění pro čtení-zápis do adresáře např. „ATTIS4“. Nastavit sdílení, oprávnění „čtení/zápis“. Na uživatelských stanicích, vytvořte zástupce na ploše odkazujícího na soubor „attis4.win.exe“. V případě nastavení ukládání do profilu uživatele (viz kapitola 8), postačuje oprávnění „čtení“.

Konfigurační a licenční soubor aplikace.

Konfigurační soubor aplikace „attis4.win.exe.config“ je umístěn v instalačním adresáři aplikace. Sekce „connectionStrings“ definuje připojení k databázi. Syntaxe ConnectionString odpovídá standardu Microsoft OLE DB. Následující hodnoty musí být upraveny dle skutečných podmínek instalace: Data Source – název serveru\jméno instance,port Initial Catalog – jméno databáze User Id – uživatel Password – heslo Příklad: - Ověření pomocí uživatelského jména a hesla, uživatel nastavený na SQL Serveru

- Ověření pomocí jména, pod nímž je uživatel přihlášen ve Windows

POZOR: Při použití ověřování pomocí uživatele SQL Serveru, je heslo v nezašifrovaném tvaru. Licenční soubor aplikace je aplikován pouze u desktopové aplikace. Licenční soubor aplikace „attis4.licence“ uložte do instalačního adresáře aplikace.

Nastavení logování aplikace.

Aplikace vytváří vlastní soubor „eXpressAppFramework.log“, ve kterém se zaznamenávají činnosti a případné chyby aplikace. Nastavení úrovně logování se provádí v konfiguračním souboru aplikace „attis4.win.exe.config“ umístěném v instalačním adresáři aplikace.


Strana: 9 / 39


SW ATTIS nástroje manažerského řízení Příklad: - Část konfiguračního souboru definující úroveň logování. <system.diagnostics> <switches>

Úroveň logování může nabývat následujících hodnot: 0 – nelogovat 1 – chyby 2 – varování (standard) 3 – informace 4 – detailní záznam činností aplikace (používá se při hledání chyb) POZOR: Při nastavení vysoké úrovně logování, může dojít k výraznému zpomalení aplikace. Umístění log souboru aplikace: Instalační adresář: - Nutné oprávnění read/write na instalační adresář aplikace. Profil uživatele: - C:\%LOCALAPPDATA%\-\ATTIS4.Win\“číslo verze“\eXpressAppFramework.log Pozn.: Od verze 4.33.5038.1. je cesta : C:\%LOCALAPPDATA%\ATTN Consulting s.r.o\ATTIS4.Win\“číslo verze“\eXpressAppFramework.log POZOR: Pro ukládání do profilu uživatele, musí konfigurační soubor obsahovat následující položku:

Spuštění aplikace.

Vytvořit zástupce na ploše, který odkazuje do instalačního adresáře aplikace na soubor „attis4.win.exe“.


Strana: 10 / 39


SW ATTIS nástroje manažerského řízení 4. Instalace aplikační služby Postupné kroky: Kopie souborů aplikace do adresáře aplikační služby. Úprava konfiguračního souboru aplikační služby. Spuštění aplikační služby.

Kopie souborů aplikace do adresáře aplikace. Soubory aplikace: ATTIS4_bin.zip – adresář „Win-aplikace“. Na staženém souboru „ATTIS4_bin.zip“ klepněte pravým tlačítkem myši - Vlastnosti. V případě, že je soubor blokovaný, klepněte na tlačítko „Unblock“. Ze staženého ZIP balíčku rozbalit obsah adresáře „Win-aplikace“ do libovolného umístění na disku.

Konfigurační soubor aplikační služby.

-

Konfigurační soubor aplikace „Deneb.JobService.exe.config“ je umístěn v instalačním adresáři aplikace. Sekce „connectionStrings“ definuje připojení k databázi. Syntaxe ConnectionString odpovídá standardu Microsoft OLE DB. Konfigurační soubor je až na dvě vyjímky shodný s konf. souborem desktopové aplikace. V konfiguraci sekce „connection String“ má odlišný název: Add name=“ServerConnectionString“. Jiný název konfiguračního souboru „Deneb.JobService.exe.config“.

Následující hodnoty musí být upraveny dle skutečných podmínek instalace: Data Source – název serveru\jméno instance,port Initial Catalog – jméno databáze User Id – uživatel Password – heslo Příklad: - Ověření pomocí uživatelského jména a hesla, uživatel nastavený na SQL Serveru

- Ověření pomocí jména, pod nímž běží služba

POZOR: Aplikační služba (Deneb.JobService.exe.config) má v konfiguraci sekce „connectionStrings” odlišný název: Add name=”ServerConnectionString”. Při použití ověřování pomocí uživatele SQL Serveru, je heslo v nezašifrovaném tvaru.


Strana: 11 / 39


SW ATTIS nástroje manažerského řízení Nastavení logování aplikační služby. Aplikační služba vytváří vlastní soubor „eXpressAppFramework.log“, ve kterém se zaznamenávají činnosti a případné chyby služby. Nastavení úrovně logování se provádí v konfiguračním souboru služby „DenebJobService.exe.config“ umístěném v instalačním adresáři služby. Příklad: - Část konfiguračního souboru definující úroveň logování. <system.diagnostics> <switches>

Úroveň logování může nabývat následujících hodnot: 0 – nelogovat 1 – chyby 2 – varování (standard) 3 – informace 4 – detailní záznam činností aplikace (používá se při hledání chyb) POZOR: Při nastavení vysoké úrovně logování, může dojít k výraznému nárůstu velikosti logu. Umístění log souboru aplikace: Instalační adresář - Nutné oprávnění read/write na instalační adresář aplikace. Profil uživatele - %LOCALAPPDATA%\ATTN Consulting s.r.o\ATTIS4.Win\“č. verze“\eXpressAppFramework.log POZOR: Pro ukládání do profilu uživatele, musí konfigurační soubor obsahovat následující položku:

Spuštění aplikační služby. V instalačním adresáři s oprávněním „administrator“ spustit: „Deneb.JobService.exe -i <serviceName>“ („service name“ je volitelný parametr) Provede instalaci služby s názvem „Deneb.Jobservice“ případně s Vámi zvoleným názvem, která poběží s oprávněním „Local System account“. Po instalaci zkontrolovat aplikační EventLog, kde se zobrazí informace o případné chybě při spuštění služby. POZOR: V daném okamžiku může běžet vždy jen jedna plánovaná úloha. Úloha není spuštěna, pokud již nějaká jiná běží.


Strana: 12 / 39


SW ATTIS nástroje manažerského řízení 5. Instalace webové aplikace Stručný postup instalace webové aplikace na IIS. Soubory aplikace: ATTIS4_bin – adresář „Web-IIS“. Na IIS vytvořte novou webovou aplikaci ATTIS. Soubory aplikace zkopírujte do adresáře webové aplikace ATTIS na IIS serveru. Uložte dodaný konfigurační soubor „web.config“ do instalačního adresáře. V souboru Web.config v sekci změňte připojovací řetězec pro SQL server dle nastavení vašeho SQL serveru. Aplikace vyžaduje na serveru nainstalovaný .NET Framework 4.0 a povolený v IIS serveru, ASP a CGI scripts, Forms Authentication. IIS : ApplicationPool (Fond aplikací) - Advanced Settings: .NET Framework version musí být typu ASP.NET v4.0, ManagedPipelineMode – Integrated. V root IIS – „ISAPI and CGI Restriction“: vše povolit (musí být zobrazen Framework 4 – pokud není, je třeba jej doinstalovat). Výchozí dokument – Default.aspx.

Podrobný postup instalace webové aplikace na IIS. Postupné kroky: Kopie souborů aplikace do adresáře aplikace. Kontrola, případně povolení rolí na serveru. Nastavení IIS (Internet Information Services), založení nové „Site“. Konfigurační soubor aplikace.

Kopie souborů aplikace do adresáře aplikace.

Na stažený souboru „ATTIS4_bin.zip klepněte pravým tlačítkem myši. V případě, že je soubor blokovaný, klepněte na tlačítko „Unblock“. Rozbalení a kopie souborů z adresáře „Web-IIS“ do cílového umístění na serveru. Zpravidla „C:\inetpub\wwwroot\ATTIS4“. Složku „ATTIS4“ - nebo jinou, musíte vytvořit. Doporučujeme používat cestu „C:\inetpub\wwwroot" kvůli oprávnění pro "IIS“.


Strana: 13 / 39



ATTIS – Kontrola stažených souborů aplikace ATTIS4, zda nejsou blokované

ATTIS – Rozbalení a kopie souborů z adresáře „Web-IIS“ do cílového umístění na serveru


Strana: 14 / 39


SW ATTIS nástroje manažerského řízení Povolení „Role Services“ v „Server Manageru“.

Na serveru musí být pro správnou funkčnost povoleny následující role dle obrázku.

ATTIS – Povolení „Role Services“ v „Server Manageru“

V sekci „Common http Features“ je nutné zatrhnout „Static Content“

Nastavení IIS (Internet Information Services).

Nastavení. o Nastavení provádíme v Internet Information Services (IIS) Manageru. o V root IIS – „ISAPI and CGI Restrictions“ - musí být povoleno ASP.NET v4… o Pokud tam položka není uvedena, musí se zaregistrovat v „IIS“. Postup:  Spustit „cmd“ jako Administrator.  Změnit aktuální adresář na „Windows/Microsoft.NET/Framework/v4.xxxx“ - místo xxxx doplnit číslo dle nainstalované verze .NET Framework.  Zadat: „aspnet_regiis /i“ - bez uvozovek.  Restartovat IIS příkazem „iisreset“.


Strana: 15 / 39



ATTIS – Nastavení IIS Nový web - založení nové „Site“. o „Sites“ --> pravé tlačítko myši --> New --> Site. o „Site name“ - používaný název. o „Application pool“ - předvyplní se nový App. pool se shodným názvem. o „Physical Path“ - cesta k souborům aplikace ATTIS. o „Binding“ - Vazby - definuje pod jakým názvem a na jakém portu nebo IP bude aplikace naslouchat. Pozn.: V uvedeném případě, bude aplikace dostupná na http://attis4.mojedomena.cz. Je nutné, aby v DNS pro danou síť existoval záznam, který bude směrovat toto jméno (URL) na daný server IIS.

ATTIS – Založení site ATTN Consulting s.r.o.

Strana: 16 / 39


SW ATTIS nástroje manažerského řízení V nastavení „Authentication“ musí být povoleny uvedené způsoby.

ATTIS – Nastavení „Authentication“ V nastavení „Default Document“ přesuňte „default.aspx“ na první místo.

ATTIS – Nastavení „Default Document“ Nastavení „Application Pool“: o V sekci „Application Pools“ označit název shodný s názvem „Application Pool“, který jsme vytvořili a zvolit „Advanced Settings“. o „.NET Framework Version“ zvolit: v4.0 o Zkontrolovat a ponechat „Managed Pipeline Mode“ - „Integrated“. o Nastavit : Idle Time-out (minutes): 0 Nastavení recyklace : o Zrušit provádění plánované recyklace dané „Application Pool“. - V případě nedostatku paměti, viz. sekci 11. „Různé – dodatek“.


Strana: 17 / 39



ATTIS – Nastavení „Application Pool“

ATTIS – Nastavení „Application Pool“ – „Advanced Settings“

Restart „Application Pool“ a „Site“.

Konfigurační soubor aplikace.

Konfigurační soubor aplikace „web.config“ je umístěn v instalačním adresáři aplikace. Sekce „connectionStrings“ definuje připojení k databázi. Syntaxe ConnectionString odpovídá standardu Microsoft OLE DB. Následující hodnoty musí být upraveny dle skutečných podmínek instalace: Data Source – název serveru\jméno instance,port Initial Catalog – jméno databáze User Id – uživatel Password – heslo Příklad: - Ověření pomocí uživatelského jména \ hesla, uživatel nastavený na SQL Serveru ATTN Consulting s.r.o.

Strana: 18 / 39



- Ověření pomocí účtu NT AUTHORITY \ IUSR

POZOR: Při použití ověřování pomocí uživatele SQL Serveru, je heslo v nezašifrovaném tvaru.

Nastavení logování aplikace.

Aplikace vytváří vlastní soubor „eXpressAppFramework.log“, ve kterém se zaznamenávají činnosti a případné chyby aplikace. Nastavení úrovně logování se provádí v konfiguračním souboru aplikace „web.config“ umístěném v instalačním adresáři aplikace. Příklad: - Část konfiguračního souboru definující úroveň logování. <system.diagnostics> <switches>

Úroveň logování může nabývat následujících hodnot: 0 – nelogovat 1 – chyby 2 – varování (standard) 3 – informace 4 – detailní záznam činností aplikace (používá se při hledání chyb) POZOR: Při nastavení vysoké úrovně logování, může dojít k výraznému zpomalení aplikace. Umístění log souboru aplikace: Instalační adresář. - Nutné oprávnění read/write na instalační adresář aplikace. Oprávnění je nutné nastavit pro uživatele, pod kterým běží „ApplicationPool“. V případě „ApplicationPoolIdentity“ se jedná o účet „ NT AUTHORITY \ IUSR“


Strana: 19 / 39


SW ATTIS nástroje manažerského řízení Přístup k webové aplikaci. Pomocí webového prohlížeče.

Zadáním adresy viz 4.2.3.

Kompatibilita zobrazení v IE 11.

Problém s nastavením kompatibility se vyskytuje pouze v prohlížeči IE verze 11 a jeho důsledkem je nezobrazování některých záznamů. Nastavení kompatibility pro Internet Explorer 11:

ATTIS – pro správnou funkci aplikace v prohlížeči Internet Explorer 11 přejděte do "Nastavení kompatibility“ a přidejte website "attis.cz" (popř. jiný dle URL pro daný web).


Strana: 20 / 39


SW ATTIS nástroje manažerského řízení 6. Instalace SQL Serveru Pozn.: Na počítačích s OS Windows XP nebo Windows Server 2003, je nutné nejdříve aktualizovat komponenty systému, aby splňovaly požadavky na instalaci Microsoft SQL Server 2008 R2, zejména .NET Framework 3.5 SP1, Windows Installer 4.5, Windows PowerShell 1.0. Tyto komponenty jsou součástí doplňkového balíčku ATTIS4_Prerequisites. Postupné kroky: Doporučené nastavení Instalace SQL Serveru Konfigurace SQL Serveru Uživatelské oprávnění k práci s databází Závěrečné práce pro použití aplikací

Doporučené nastavení SQL Serveru. Pokud nepoužíváte a nemáte zakoupenou licenci na SQL Server, který chcete striktně používat, doporučujeme použít jednu z následujících express edicí SQL Serveru. Tyto edice jsou zdarma a poskytují dostatečný výkon pro běh aplikace ATTIS. Microsoft® SQL Server® 2008 R2 SP2 - Express Edition Microsoft® SQL Server® 2012 Express Pro aplikaci ATTIS doporučujeme použít samostatnou instanci SQL Serveru. Důvodem je možnost nastavení oprávnění pro přístup k databázi s právy „System Administrator“ bez bezpečnostního rizika pro případné další databáze ve stejné instanci SQL Serveru. Díky tomuto oprávnění je umožněna jednoduchá záloha a obnovení databáze v rámci aplikace, bez nutnosti použití externích nástrojů.

Instalace SQL Serveru. Před instalací zvolené verze SQL Serveru je nutné mít nainstalováno následující prostředí: o Pro Microsoft® SQL Server® 2008 R2 SP2 - Express Edition: .NET Framework 3.5 SP1, Windows Installer 4.5, Windows PowerShell 1.0. o Pro Microsoft® SQL Server® 2012 Express: .NET Framework 3.5 SP1, .NET Framework 4.0, Windows PowerShell 2.0. Po instalaci restartujte server. Proveďte instalaci vybrané verze MS SQL serveru, doporučujeme např. Microsoft® SQL Server® 2008 R2 SP2 - Express Edition. Podrobný popis instalace přesahuje rámec tohoto dokumentu. o Je nutné nainstalovat součást „Database Engine Services“, doporučujeme také „Management Tools – Basic“ pro správu databází. o Během instalace doporučujeme vytvořit vlastní „Named instance“ s názvem instance (např. „SQLATTIS4“), který budete používat v „Connection string“ v konfiguračních souborech aplikace ATTIS. o „Collation“ zvolte podle kódování jazyka, ve kterém budete vkládat textová data do aplikace ATTIS, např. pro češtinu doporučujeme „Czech_CI_AS“.


Strana: 21 / 39


SW ATTIS nástroje manažerského řízení Konfigurace SQL Serveru. Konfigurace se provádí pomocí „SQL Server Configuration Manager“, který se nainstaloval jako součást instalace spolu s instancí SQL Serveru. o Po spuštění se otevře okno se seznamem nainstalovaných instancí (v závorce). o Dvojklikem na požadované instanci, se otevře okno vlastností. Zde změňte účet, pod kterým se daná instance spouští, z „Network Service“ na „Local Service“. o Zobrazí se informace, že služba bude restartována. Potvrďte OK.

ATTIS – SQL Server Configuration Manager


Strana: 22 / 39


SW ATTIS nástroje manažerského řízení „SQL Server Network Configuration“: o Vyberte požadovanou instanci SQL Serveru a v pravé části se zobrazí seznam protokolů s informací, zda jsou povolené.

ATTIS – SQL Server Network Configuration Pozn.: V případě, že se k databázi budete připojovat vždy pouze z lokální instalace a v konfiguraci aplikace použijete v „connection string“ název „(local)“, stačí, aby byl povolen jen protokol „Shared Memory“. Pokud budete k databázi přistupovat i z jiných PC v síti, je třeba povolit protokol TCP/IP.

ATTIS – TCP/IP Properties


Strana: 23 / 39



ATTIS – TCP/IP Properties - na záložce „IP Adresses“ ve spodní části v sekci „IP All“ vymazat „TCP Dynamic port“ a doplnit „TCP Port“ Po uložení změn je nutné restartovat službu instance SQL serveru (pravé tlačítko myši – restart).

ATTIS – SQL Server Network Configuration

Uživatelské oprávnění k práci s databází. Pro práci s databází se používá oprávnění uživatele zadaného v sekci „ConnectionStrings“ příslušného konfiguračního souboru aplikace. V případě používání „User Id=sa“ není třeba provádět žádná další nastavení.


Strana: 24 / 39


SW ATTIS nástroje manažerského řízení Pro používání aplikace je doporučené nastavení oprávnění uživatele následující: o „Server roles“ – Public

ATTIS – Login Properties o

„User Mapping“ – Database role membership - db_owner; public

ATTIS – Login Properties


Strana: 25 / 39


SW ATTIS nástroje manažerského řízení Pozn.: S výše uvedeným oprávněním bude umožněna plná funkčnost aplikace mimo obnovu databáze. Obnovu databáze musí provádět správce IT pod účtem s oprávněním „Server roles“ – sysadmin.

Závěrečné práce pro použití aplikací. Provést obnovu (restore) databáze ATTIS, pomocí SQL Server Management Studia nebo pomocí systémových nástrojů určených k práci s SQL ( SQLCMD.exe, OSQL.exe). Povolit přístup přes TCP/IP protokol, povolit na firewallu daný port specifikovaný v SQL (obvykle 1433). Vytvořit na SQL Serveru uživatelské účty používané v „connectionStrings“ konfiguračního souboru aplikace, s oprávněním přístupu k dané databázi.


Strana: 26 / 39


SW ATTIS nástroje manažerského řízení 7. Možnosti přihlášení do aplikace ATTIS4 Pomocí uživatelského jména a hesla. Použitím „Windows Authentication“ – AD.

Pomocí uživatelské jména a hesla. Pro přihlášení do aplikace je uživatel vyzván k zadání svého uživatelského jména a hesla. Při prvním přihlášení je uživatel standardně vyzván ke změně hesla.

Použitím „Windows Authentication“ – AD. Každý uživatel je do aplikace přihlášen automaticky pomocí jména, pod nímž je přihlášen ve Windows (přesněji: uživatelské jméno je převzato z aktuálně přihlášeného Windows účtu pomocí objektu System.Security.Principal.WindowsIdentity). Pokud účet neexistuje, je automaticky založen s rolemi (a tedy i oprávněním) nastavenými jako standardní viz „Manuál SW ATTIS“.

Nastavení IIS – webová aplikace.

Nastavení konfiguračního souboru IIS ( web.config ) pro ověřování v AD. Oproti standardnímu konfiguračnímu souboru musí navíc obsahovat řádky s pozadím. Zmíněná knihovna není součástí standardního instalačního balíčku, musí se vyžádat. Cesta ke knihovně je závislá od konkrétní instalace. <sectionGroup name="devExpress"> <section name="settings" type="DevExpress.Web.ASPxClasses.SettingsConfigurationSection, DevExpress.Web.v12.1" requirePermission="false" /> <section name="compression" type="DevExpress.Web.ASPxClasses.CompressionConfigurationSection, DevExpress.Web.v12.1" requirePermission="false" /> <section name="themes" type="DevExpress.Web.ASPxClasses.ThemesConfigurationSection, DevExpress.Web.v12.1" requirePermission="false" /> <section name="errors" type="DevExpress.Web.ASPxClasses.ErrorsConfigurationSection, DevExpress.Web.v12.1" requirePermission="false" /> <section name="ModuleConfigSection" type="Deneb.Module.Manager.ModuleConfigSection, Deneb.Module.Manager" allowLocation="true" allowDefinition="Everywhere" /> <ModuleConfigSection> <Modules>


Strana: 27 / 39


SW ATTIS nástroje manažerského řízení Nastavení IIS – Authentication. Uživatel se musí hlásit ze stejné domény, jinak bude vyžadováno ověření. Pokud se vyskytne situace, že PC je ve stejné doméně, ale v jiné síti, je nutné, aby si uživatel přidal www server do zóny intranet.

ATTIS – Nastavení IIS – Authentication

ATTIS – Nastavení IIS – Authentication Jiné typy ověření – disabled . ATTN Consulting s.r.o.

Strana: 28 / 39


SW ATTIS nástroje manažerského řízení Nastavení desktopové – síťové verze aplikace. Nastavení konfiguračního souboru „attis4.win.exe.config“ pro ověřování standardnímu konfiguračnímu souboru musí navíc obsahovat řádky s pozadím.

v AD.

Oproti

<section name="ModuleConfigSection" type="Deneb.Module.Manager.ModuleConfigSection, Deneb.Module.Manager" allowLocation="true" allowDefinition="Everywhere" /> <ModuleConfigSection> <Modules> <system.diagnostics> <switches> <startup><supportedRuntime version="v4.0" sku=".NETFramework,Version=v4.0"/>


Strana: 29 / 39


SW ATTIS nástroje manažerského řízení 8. Detailní popis položek konfiguračních souborů Vždy si vyžádejte aktuální konfigurační soubor od dodavatele. Následuje popis položek konfiguračního souboru „Attis4.win.exe.config”. Konfigurační soubor nemusí obsahovat všechny zde uvedené položky. Konfigurační soubor pro IIS (web.config) nebo pro aplikační službu (Deneb.JobService.exe.config) obsahující stejné položky, mají stejný význam jako zde uvedený. Komentář je odlišen zvýrazňovačem: <section name="ModuleConfigSection" type="Deneb.Module.Manager.ModuleConfigSection, Deneb.Module.Manager" allowLocation="true" allowDefinition="Everywhere" /> <ModuleConfigSection> <Modules> <system.diagnostics> <switches> <startup><supportedRuntime version="v4.0" sku=".NETFramework,Version=v4.0"/>

Pozn.: ukládání do profilu uživatele nám umožní nastavení oprávnění pro instalační adresář - čtení POZOR: Aplikační služba (Deneb.JobService.exe.config) má v konfiguraci sekce „connectionStrings” odlišný název: Add name=”ServerConnectionString”. Při použití ověřování pomocí uživatele SQL Serveru, je heslo v nezašifrovaném tvaru.


Strana: 30 / 39


SW ATTIS nástroje manažerského řízení 9. Zálohování a obnova aplikace ATTIS Pravidelnost Způsoby provedení zálohy Obnova dat

Pravidelnost. Pro spolehlivé zachování dat je vhodné, provádět denní zálohu databáze aplikace. Počet uchovávaných záloh a periodicita provádění zálohování je na zvážení systémového administrátora.

Způsoby provedení zálohy. Záloha pomocí nástrojů v rámci aplikace. Záloha pomocí standardních nástrojů pro práci s MS SQL serverem. Záloha pomocí nástrojů v rámci aplikace.

V aplikaci: Správa > Globální akce > Akce zálohování a obnovy > Záloha lokální databáze. Zvolíme umístění a volitelný název zálohy. Zálohu lze uložit i na sdílené síťové umístění.


Strana: 31 / 39


SW ATTIS nástroje manažerského řízení V případě ukládání záloh na sdílené síťové umístění, je nutné nastavit přístupová oprávnění pro účet, pod kterým běží služba SQL Serveru. Záloha pomocí standardních nástrojů pro práci s MS SQL serverem.

SQL Server Management Studio Pomocí systémových nástrojů určených k práci s SQL ( SQLCMD.exe, OSQL.exe) – doporučená varianta.

Obnova dat. Pro obnovu databáze platí stejná pravidla jako pro zálohování. V konfiguračním souboru aplikace, musí navíc mít uživatel definovaný pro přístup k SQL serveru, v sekci „“ definovanou roli v „Server roles“ na SQL Severu – „sysadmin“. Z důvodu požadovaného oprávnění „sysadmin“ se nedoporučuje provádět obnovu dat pomocí nástrojů aplikace, ale doporučuje se použití standardních nástrojů pro práci s MS SQL Serverem.

Obnova dat při prvním spuštění aplikace.

-

Pro automatickou obnovu databáze musí být splněny následující podmínky: aplikace je spuštěna s oprávněním „administrátor“ instalační složka obsahuje adresář „DATA“ a v něm soubor zálohy databáze „AttisDefaultDb.bak“ databáze uvedená v aktuálním connection stringu aplikace neexistuje uživatel spouštějící aplikaci musí mít práva k BACKUP složce příslušné instance SQL Serveru uživatel definovaný pro přístup k SQL serveru v sekci „“ musí mít definovanou roli v „Server roles“ na SQL Severu – „sysadmin“

Obnova dat pomocí nástrojů v rámci aplikace.

-

V aplikaci: Správa > Globální akce > Akce zálohování a obnovy > Obnova lokální databáze. Vybereme soubor zálohy k obnově. po spuštění akce Restore (lokální i remote) dojde k nastavení automatické obnovy během následujícího startu aplikace (na tomtéž počítači) obnova se provádí při startu aplikace informace o spuštění obnovy se ukládá do složky ModelAdaptor („AttisStartup.cfg“) účet pod kterým běží služba SQL Serveru musí mít přístup záložnímu souboru (read)


Strana: 32 / 39


SW ATTIS nástroje manažerského řízení 10. Kontrolní body po instalaci Postupné kroky: Firewall Obsah instalačních adresářů SQL Server Spuštění aplikace

Firewall (součást Windows nebo antivirového řešení). Kontrola nastavení, případné povolení portu pro komunikaci s SQL serverem.

Obsah instalačních adresářů. Kontrola zda instalační adresáře obsahují aktuální verzi binárních souborů aplikace (dle data a velikosti, případně verze stejné jako v instalačním ZIP balíčku). Dále musí obsahovat soubory „attis4.win.exe.config“ a „attis4.licence“ pro desktopovou aplikaci, „web.config“ pro IIS, „Deneb.JobService.exe.config“ pro aplikační službu. Všechny soubory „*.config“ musí mít správně upravený „Connection string“.

SQL Server. Kontrola, zda běží služba nainstalované instance SQL Serveru – např.: „SQL Server (SQLATTIS4)“.

Spuštění aplikace. Spuštění desktopové aplikace (attis4.win.exe). Pokud nelze aplikaci spustit, vypnout dočasně antivir. Pokud se tím chyba odstraní, řešit s dodavatelem antivirového řešení. Spuštění webové aplikace zadáním adresy URL, viz kapitola 4.2.3. Kontrola zda je daná adresa pro PC známá (definovaná v DNS).


Strana: 33 / 39


SW ATTIS nástroje manažerského řízení 11. Různé - dodatek Instalace více instancí aplikace. Instalace SQL Serveru viz. bod 5. Instalace desktopové aplikace viz. bod 2. x počet požadovaných instancí. Konfigurační soubor aplikace viz. bod 2.2.3. bude mít v každé instanci jiný „Initial Catalog“. Instalace webové aplikace viz. bod 4. x počet požadovaných instancí. Konfigurační soubor aplikace viz. bod 4.2.4. bude mít v každé instanci jiný „Initial Catalog“. Kontrolní body viz. bod 9. Pozn.: Zjednodušeně řečeno nainstalujeme 1x SQL Server na kterém budeme mít pro každou instalaci aplikace samostatnou databázi. Konfigurační soubor v každé instalaci bude odkazovat na jinou databázi. Podle počtu skupin uživatelů provedeme stejný počet instalací aplikace do samostatných umístění. Uživatelům, kteří mají pracovat na stejných datech, nastavíme přístup ke stejné aplikaci.

Webová aplikace je pomalá – dlouhé odezvy. Úprava v registru. Kontrola „web.config“ aplikace. Recyklace „Application Pool“. Úprava v registru.

Zvýšení počtu souběžných požadavků. Optimalizaci nastavení IIS je možné provést pomocí úpravy registrů. Úpravu registrů by měl provádět IT technik znalý dané problematiky. Spustit „regedit“. Ve větvi: HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\ASP.NET\4.0.30319.0\ založit klíč: maxConcurrentRequestsPerCPU (DWORD) nastavit hodnotu na 5000. Pozn.: Při současné práci většího počtu uživatelů, defaultní hodnoty nemusí být dostatečné a požadavky čekají ve frontě. Tímto dochází ke zvýšení doby odezvy aplikace. Kontrola „web.config“ aplikace.

Kontrola „web.config“ aplikace, zda existuje tag „“ – pokud ano – odstranit. Kontrola nastavení logování aplikace v souboru "web.config": Při vyšším čísle než 2, dochází k výraznému spomalení aplikace. Recyklace „Application Pool“.

V případě dostatečné paměti na serveru IIS je doporučeno, zakázat plánovanou recyklaci „AppPool“. Zamezí se tím déle trvajícímu prvnímu načtení stránky aplikace. V případě nutnosti plánované „recyklace“, lze zdržení prvotního načtení obejít plánovaným načtením logon stránky. Vhodný způsob určí administrátor.


Strana: 34 / 39


SW ATTIS nástroje manažerského řízení Nastavení jazyka webové aplikace. Jazyky, které mohou být aplikací použity, musí být uvedeny v konfiguračním souboru aplikace „web.config“. V klíči "Languages" musí být uvedeny všechny jazyky, oddělené středníkem, které chci v aplikaci používat. Jazyky, které zde nebudou uvedeny, nelze v aplikaci požít. Jazyk aplikace je vybrán dle výchozího jazyka nastaveného v prohlížeči uživatele, kterým se připojuje k aplikaci. „Control Panel\Clock, Language and Region\Language“ Pro toto chování je nutné následující nastavení: V root web aplikace musí existovat soubor " Model.xafml " Obsah souboru: <Application PreferredLanguage="(User language)"> V případě, že přistupuje uživatel z prohlížeče, kde je výchozí jazyk který aplikace nepodporuje, bude použit výchozí jazyk aplikace - angličtina. V případě, že aplikace běží pouze v anglickém jazyce a nelze přepnout do jiného jazyka, je nutné Zkontrolovat, zda účet pod kterým běží „Application pool“ má přístup pro čtení a zápis do instalační složky aplikace a podsložky se zkratkou jazyka – např. „cs“.

U webové aplikace nefunguje ověřování AD. -

Nastavená „Proxy“ v prohlížeči. Přidejte adresu na které aplikace na IIS naslouchá do vyjímek. Objeví se formulář pro zadání uživatelského jména a hesla. Přidejte adresu na které aplikace na IIS naslouchá do „Local intranet“.

Omezení přístupu uživatelů přes webovou aplikaci při ověřování AD. -

Omezení přístupu je řešeno pomocí nastavení – konfigurace IIS. V nastavení „Sites – Authorization Rules“. Odebrat pravidlo povolující přístup „All users“ a „All anonymous users“ Přidat pravidlo povolující přístup uživateli nebo skupině, kde mám zařazené osoby pro práci s applikací.


Strana: 35 / 39


SW ATTIS nástroje manažerského řízení IE 11 – zobrazuje stránku špatně – ikony na horní liště. -

Úprava v konfiguračním souboru „web.config“. Zkontrolovat případně doplnit:

<system.webServer> <customHeaders>

První spuštění desktopové aplikace trvá dlouho. -

Příčin může být několik, uvedeme zde základní. Dlouhotrvající odezvy SQL Serveru. Pomalé síťové připojení. Dlouhotrvající odezvy SQL Serveru.

V případě přetížení SQL Serveru, na kterém je umístěna databáze aplikace ATTIS, může docházet k prodlevě před načtením dat, požadovaných aplikací. Pro diagnostiku tohoto problému, můžeme použít program „ATTIS4.DataSource.Test.exe“, který je umístěný v instalačním adresáři aplikace.


Strana: 36 / 39


SW ATTIS nástroje manažerského řízení Popis: Informace v horních dvou oknech nám definují připojení k databázi a jsou totožné s informacemi v „ConnectionStringu“ v konfiguračním souboru „attis4.win.exe.config“ Př: Okno „Query“: Dotaz, který se spouští na SQL Serveru. Dotaz samotný není až tak důležitý, jako doba za jakou je spuštěn. DECLARE @StartTime datetime,@EndTime datetime,@dotaz int SELECT @StartTime=GETDATE() SELECT @dotaz=COUNT(*) FROM dbo.columninfo SELECT @EndTime=GETDATE() SELECT DATEDIFF(ms,@StartTime,@EndTime) AS [Duration in milliseconds] Okno „Query Result“: Výsledek by se měl zobrazit okamžitě, pokud to trvá, znamená to, že je požadavek ve frontě a čeká na zpracování – stejně tak aplikace ATTIS.Hodnota by se měla pohybovat do 20. Vyšší hodnoty nám signalizují pomalé odezvy SQL, což je předpokladem pro pomalou práci aplikace. Při opakovaném spuštění by se hodnota měla dostat pod 20. Pomalé síťové připojení.

-

V případě pomalého síťového spojení (typicky při použití WIFI) se mohou dostavit prodlevy při spouštění aplikace anebo při zobrazení složitějších pohledů v rámci aplikace. Diagnostiku rychlosti připojení doporučujeme provádět nástrojem „iperf.exe“ nebo obdobným. Doporučená rychlost pro pohodlnou práci s aplikací je min. 90 Mbits/sec.

Nastavení intervalu automatického znovunačtení stránky ve Webové aplikaci. Konfigurace znovunačtení stránky. Pozor na správné nastavení.

Konfigurace znovunačtení stránky.

-

V případě, že níže uvedená položka není obsažena v konfiguračním souboru (web.config), aplikace neprovádí automatické znovunačtení stránek (výchozí stav). Do „Web.Config“ souboru zadat do „AppSettings“ klíč nebo i více klíčů které budou začínat názvem RefreshPage. Zadat hodntotu ve tvaru: „NázvyViewOddeleneStrednikem#PeriodaRefreshe#jmenoUzivatele“ Vždy musí být 2 značky # #PeriodaRefreshe (sekundy) Jméno uživatele není povinné, pokud se zada misto jmena uzivatele * platí pro všechny uživatele, ekvivalentem * je nezadat žádné jméno.


Strana: 37 / 39


SW ATTIS nástroje manažerského řízení Příklad: 1.řádek platí pouze pro uživatele „admin“, 2. a 3. řádek pro všechny uživatele. Pozor na správné nastavení.

Doporučujeme nastavovat pro minimum stránek a pro definované uživatele. Pozor na časový interval – sekundy. V případě neuváženého nastavení (mnoho „View“, všichni uživatelé, krátké časy), může docházet k přetížení IIS.

Chyba otevírání zdrojů - WWW. Kontrola povolení otevírání POPup oken v prohlížeči. Form Authentication - ověření práv k odkazovanému dokumentu. Windows Authentication Kontrola povolení otevírání POPup oken v prohlížeči.

V prohlížeči, který je používán pro aplikaci ATTIS, musí být povolena POPup okna. Jinými slovy zrušeno blokování, přidáním dané web adresy do vyjímek. Form Authentication - Ověření práv k odkazovanému dokumentu.

Postup při používání ověřování na základě uživatelského jména a hesla. Uživatel se přihlašuje do aplikace ATTIS přes formulář. Pokud se při přístupu k externímu zdroji zobrazí chyba, znamená to, že není ověřen uživatel přistupující ke sdílenému prostředku. V případě www aplikace se jedná o účet, který se musí nastavit v ověřování "ASP.NET Impersonation". Je nutné ověřit práva tohoto účtu k prostředku, který je definován v aplikaci ATTIS jako "Umístění elektronické" . Tento účet následně přidat do lokální skupiny IIS_IUSR (na serveru IIS).


Strana: 38 / 39


SW ATTIS nástroje manažerského řízení Windows Authentication - Ověření práv k odkazovanému dokumentu.

Postup při používání ověřování Windows Authentication. Uživatel je automaticky přihlášen do aplikace ATTIS. Zkontrolovat, zda uživatelé pracující s aplikací, mají práva ke sdílenému prostředku..


Strana: 39 / 39


SW ATTIS Technická příručka instalace a zálohování

Recommend Documents