APS Web Panel Rozšiřující webový modul pro APS Administrator Přehled přítomnosti osob v oblastech a místnostech, změna uživatelského hesla a PINu a nastavení časového plánu Instalační a uživatelská příručka 2004 2015,TECH FASS s.r.o., Věštínská 1611/19, Praha, www.techfass.cz, techfass@techfass.cz (vydáno dne 19/1/2016, minimální verze databáze APS400nAdministrator - 52)
1 Obsah 1 Obsah... 2 2 Popis produktu... 3 3 Instalace podpůrných funkcí a služeb... 3 3.1 Podmínky instalace... 3 3.2 Instalace HTTP serveru... 3 3.3 Instalace IIS na Windows Vista a Windows 7... 4 3.4 Instalace IIS na Windows 8, 8.1 a Windows 10... 5 4 Instalace webové aplikace APS Web Panel... 6 4.1 Vyzkoušení aplikace... 8 Uvedené názvy produktů a společností mohou být ochrannými známkami a/nebo ochranné servisní známky jejich příslušných vlastníků.
2 Popis produktu Programový modul APS Web Panel rozšiřuje programový balík APS Administrator o možnost sledování aktuální přítomnosti uživatelů ve vybraných oblastech a místnostech, změnu hesla a PINu uživatele a nastavení časového plánu prostřednictvím webového prohlížeče. 3 Instalace podpůrných funkcí a služeb 3.1 Podmínky instalace Instalaci je vhodné provést na počítači, který slouží jako server pro systémy APS (tzn. ten, na kterém již je provozován databázový a komunikační server). Lze zvolit i jiné modely, pro ty je však nutná hlubší znalost databázových systémů, webových aplikací, atd. V této příručce nadále předpokládáme, že instalace je provedena na jednom počítači. Pro provoz aplikace APS Web Panel je nutná databáze APS400nAdministrator, verze 52 nebo vyšší. 3.2 Instalace HTTP serveru APS Web Panel využívá technologii ASP.NET, verze 4.0. Doporučeným HTTP serverem proto je Internetová Informační Služba (IIS) společnosti Microsoft, verze 5.1 (nebo vyšší), s podporou ASP.NET 4.0. IIS je součástí instalace operačních systémů Microsoft Windows, avšak při standardní instalaci není tato služba nainstalována a je nutné ji doinstalovat dodatečně. Webový modul může být zprovozněn také pomocí bezplatného programu UltiDev Cassini WebServer společnosti UltiDev LLC. Instalaci pomocí tohoto software doporučujeme zejména méně zkušeným uživatelům. Návod na instalaci naleznete zde: http://www.techfass.cz/xxxxxx Strana 3
3.3 Instalace IIS na Windows Vista a Windows 7 Tento postup je možné provést na IIS verze 6.0 a novějším. 3.3.1 Podpora IIS Při standardní instalaci systému není tato služba nainstalována a je nutné ji doinstalovat dodatečně. Potřebné položky jsou umístěny v ovládacím panelu Programy a funkce v části Zapnout nebo vypnout funkce systému Windows. Ve stromečkové struktuře vyhledejte a zapněte službu Internetová informační služba (obr. 1). Tímto krokem se zapnou základní funkce IIS. Obr. 1: Zapnutí služby IIS Obr. 2: Zapnutí služby ASP.NET Dále vyhledejte a zapněte službu ASP.NET, která je součástí stromečkové struktury služby IIS (Internetová informační služba > Webové služby >Funkce pro vývoj aplikací) (obr. 2). Tyto služby mohou být vzájemně závislé, tzn. zapnutím jedné služby může automaticky dojít k zapnutí dalších služeb. 3.3.2 Instalace podpory ASP.NET 4.0 Podporu aplikací ASP.NET verze 4.0 je nutné na IIS zaregistrovat. Registrace se provede spuštěním registračního programu aspnet_regiis.exe s parametrem i, umístěného ve složce se součástmi prostředí NET. Registrační program spusťte z příkazového řádku zadáním cesty k souboru včetně parametru i. Příkaz zadaný do příkazového řádku by tedy měl vypadat takto: C:\Windows\Microsoft.NET\Framework\v4.0.30319\aspnet_regiis.exe -i Po zadání příkazu se zobrazí v příkazovém řádku zpráva o úspěšné registraci služby. Strana 4
3.4 Instalace IIS na Windows 8, 8.1 a Windows 10 V novějších verzích Microsoft Windows dochází k drobným změnám v instalaci IIS a nastavení webové aplikace. 3.4.1 Podpora IIS Při standardní instalaci systému není tato služba nainstalována a je nutné ji doinstalovat dodatečně. Potřebné položky jsou umístěny v ovládacím panelu Programy a funkce v části Zapnout nebo vypnout funkce systému Windows. Ve stromečkové struktuře vyhledejte a zapněte službu Internetová informační služba. Služba IIS je složena z několika samostatných funkcí, zapnutím služby Internetová informační služba dojde k zapnutí funkcí nezbytných pro provoz IIS. Pro instalaci a provoz nadstavby APS Web Panel není nutné zapínat i zbylé, nezapnuté funkce. 3.4.2 Instalace podpory ASP.NET 4.0 Podpora aplikací ASP.NET verze 4.0 se aktivuje oproti předchozím verzím systémů Microsoft Windows také z ovládacího panelu Programy a funkce v části Zapnout nebo vypnout funkce systému Windows. Obr. 3: Zapnutí služby.net Framework Obr. 4: Zapnutí služby ASP.NET v4.5 Ve stromečkové struktuře vyhledejte a zapněte funkci.net Framework 4.5 Advanced Services (obr. 3) a dále vyhledejte službu Technologie ASP.NET 4.5 (obr. 4), která je součástí stromečkové struktury IIS (Internetová informační služba > Webové služby > Funkce pro vývoj aplikací). Tyto služby mohou být vzájemně závislé, tzn. zapnutím jedné služby může automaticky dojít k zapnutí dalších služeb. Strana 5
4 Instalace webové aplikace APS Web Panel Celou složku obsahující součásti programu APS Web Panel (aps.webpanel) zkopírujte do složky IIS, určené pro publikování informací na webu. Při výchozí konfiguraci IIS je tato složka umístěna zde: C:\Inetpub\wwwroot Součásti aplikace tedy budou umístěny ve složce C:\Inetpub\wwwroot\aps.webpanel Při popisu instalace nadále předpokládáme, že výchozí pojmenování je zachováno. Poté je nutné IIS informovat o tom, že v dané složce je umístěna ASP.NET aplikace. To lze provést v ovládacím panelu IIS, dostupném např. v nabídce Správa počítače. V nabídce správy počítače otevřete nabídku Služby a aplikace a vyberte položku Správce Internetové informační služby. V seznamu objektů publikovaných serverem vyberte složku obsahující aplikaci APS Web Panel a v kontextovém menu vyberte možnost Převést na aplikaci (obr. 5). Obr. 5: Převedení na aplikaci Strana 6
Do pole Alias vyplňte jméno, pod kterým bude aplikace dostupná z internetového prohlížeče (obvykle aps.webpanel). Fond aplikací lze obvykle ponechat na výchozí hodnotě DefaultAppPool, viz obr. 6. Stisknutím tlačítka OK potvrďte instalaci aplikace. Obr. 6: Úprava připojovacího řetězce Výchozí hodnota DefaultAppPool by měla být po provedení předchozích kroků nastavena na rozhraní.net Framework verze 4.0, které je vyžadováno pro použití nadstavby APS Web Panel. Pokud tak nastavena není, lze manuálně vybrat požadovaný fond aplikací, tedy hodnotu ASP.NET v4.0. Nyní vyberte v nabídce funkcí možnost Připojovací řetězce a upravte řetězec s názvem APSConnectionString (obr. 7). Po výběru možnosti Server SQL vyplňte jméno serveru k atributu Server (obvykle (local)), k atributu Databáze vyplňte hodnotu APS400nAdministrator. Dále změňte pověření z integrovaného zabezpečení systému Windows na pověření SQL serveru. Vyberte možnost Zadat pověření a pomocí tlačítka Nastavit nastavte uživatelské jméno a heslo administrátorského účtu s přístupem do databáze (obvykle administrátorský SQL účet sa). Obr. 7: Úprava připojovacího řetězce Nezapomeňte, že při výchozí instalaci SQL Serveru 2005 Express Edition je nainstalována tzv. pojmenovaná instance. Atributu Server je potom nutné zadat hodnotu ve tvaru: COMPUTER_NAME\INSTANCE_NAME, kde COMPUTER_NAME je jméno počítače, na němž SQL server pracuje a INSTANCE_NAME je název konkrétní instance, obvykle SQLEXPRESS. Strana 7
4.1 Vyzkoušení aplikace Webová aplikace se spouští v okamžiku, kdy HTTP server přijme od klienta (v tomto případě jeho webového prohlížeče) vhodně formulovaný požadavek. Přímo na serveru spusťte webový prohlížeč a do panelu Adresa webového prohlížeče ve tvaru: http://computer_name/aps.webpanel/default.aspx Pokud je vše nakonfigurováno správně, zobrazí se úvodní stránka s formulářem pro přihlášení uživatele. V opačném případě je zobrazena stránka s chybovým hlášením a je nutné konfiguraci upravit. Nejčastějšími chybami konfigurace webové aplikace jsou: Nesprávně zadané jméno SQL serveru, vypnuté síťové komunikační rozhraní SQL serveru (viz instalační příručka programu APS Administrator). Strana 8