Šablona Open Sans - MP

Instalace webové služby Mydlinka
Aktualizace dokumentu: 16.10.2015
Obsah
1 Co je to webová služba Mydlinka
2 Požadavky na instalaci a provoz
2.1 SAS
2.2 Databáze
2.3 Operační systém
2.4 Softwarové vybavení
2.5 Síť
2.6 Další požadavky
3 Příprava instalace
3.1 Soubory pro instalaci
3.2 Přístupové údaje pro webovou službu
3.3 Umístění databáze SAS
4 Webová služba Mydlinka pro Windows
4.1 Instalace na počítač s OS Windows
4.2 Nastavení
4.3 Provoz služby a řešení potíží
4.4 Odinstalace
5 Webová služba Mydlinka pro Linux
5.1 Požadované softwarové vybavení
5.2 Instalace
5.3 Nastavení
5.4 Odinstalace
5.5 Provoz služby a řešení potíží
6 Technická podpora
Co je to webová služba Mydlinka
Webová služba Mydlinka (dále jen webová služba) je rozšíření aplikace Systém agend pro školy
(dále jen SAS), která zastává funkci prostředníka mezi databází SASu a aplikacemi určenými
ke vzdálenému sběru dat (např. Učitelský zápisník).
Webová služba umožní zadávání vybraných dat do databáze SASu přes Internet, zajišťuje
bezpečnost přenosu, integritu a dohledatelnost tímto způsobem vložených dat.
Webová služba je vybavena instalátorem pro Windows, který usnadní práci s webovou službou.
Požadavky na instalaci a provoz
Webová služba Mydlinka může být nainstalována pouze na počítači, který je trvale připojen k síti
Internet.
SAS
Webová služba vyžaduje funkční instalaci aplikace Systém agent pro školy. Aplikace SAS nemusí
být nainstalována na stejném počítači jako webová služba. Minimální vyžadovaná verze databáze
SASu je verze 7.4 včetně všech dostupných aktualizací. Některé funkce webové služby jsou
na aplikaci SAS přímo závislé, proto doporučujeme aplikaci SAS udržovat aktuální.
Databáze
Databáze aplikace SAS nemusí být nainstalována na stejném počítači jako webová služba, ale
musí být oba počítače propojeny v síti.
Operační systém
Webová služba může být nainstalována jak na operační systém Windows, tak na operační systém
typu Linux. Minimální vyžadovaná verze operačního systému Windows je 5.2, tedy Windows XP 64Bit Edition a Windows Server 2003. Podporované operační systémy Linuxového typu jsou Ubuntu,
Debian, Red Hat a CentOS. Podpora jednotlivých operačních systémů se může změnit.
Softwarové vybavení
Na počítači, na kterém bude webová služba zprovozněna, musí být korektně nainstalován virtuální
stroj Java ve verzi 7 a vyšší. Současně musí být nainstalována minimálně klientská část
databázového serveru Firebird ve verzi 2.5 a vyšší. Na počítači s operačním systémem Linux je
nutné nainstalovat nástroj JSVC z rodiny nástrojů Apache Commons Daemon. Na počítači
s operačním systémem Linux je také vyžadován bash verze 3.2 a novější.
Síť
Počítač s webovou službou musí být připojen k Internetu. Při provozu webové služby je třeba
použít takové nastavení sítě, které nebude bránit komunikaci mezi jednotlivými komponentami
webové služby. Především se jedná o povolení komunikace v bráně Firewall pro port webové
služby a databázového serveru.
Další požadavky
Při provozu webové služby mohou nastat situace, kdy nastavení operačního systému bude bránit
správné funkci webové služby. Především se jedná (dle operačního systému) o antivirový program
a nastavení přístupových práv a vlastnictví k jednotlivým složkám aplikace. Je třeba provést takové
nastavení, které nebude webové službě bránit pracovat správně.
Příprava instalace
Během instalace a oživení webové služby bude třeba vložit některé vstupní údaje. Připravte si tyto
údaje k pozdějšímu použití.
Soubory pro instalaci
Soubory pro instalaci získáte v SASu v modulu Informační servis. Ze seznamu zdrojů vyberte uzel
Mobilní aplikace a stáhněte nejnovější verzi archivu s mobilními aplikacemi.
Stažený archiv rozbalte a nachystejte si jej k dalšímu použití. Bližší popis obsahu archivu se nachází
přímo v něm, v souboru info.txt.
Přístupové údaje pro webovou službu
Tyto údaje zjistíte v SASu v modulu Správce databáze. Zvolte funkci Internet | Webová služba |
Přístup pro webovou službu. Pokud budete vyzváni, vložte heslo pro uživatele SYSDBA.
V dialogovém okně se zobrazí přístupové údaje pro webovou službu.
Umístění databáze SAS
Pokud se rozhodnete instalovat webovou službu na jiný počítač, než na kterém je instalován SAS,
budete potřebovat adresu počítače, na kterém je umístěna databáze SASu, a cestu k databázi
na daném počítači. Dále budete potřebovat číslo portu, na kterém databázový server Firebird
pracuje (pokud jste číslo portu neměnili, použijte výchozí hodnotu 3050).
Webová služba Mydlinka pro Windows
Jednotlivé kroky návodu se mohou mírně lišit v závislosti na verzi operačního systému Windows.
Instalaci, Odinstalaci a práci s webovou službou pro Windows by měl provádět pouze zkušený
uživatel.
Instalace na počítač s OS Windows
Pomocí souborového manažeru (Průzkumník, Total Commander,...) vytvořte na cílovém počítači
dočasnou složku, do které rozbalte soubor mydlinka-setup-[verze].exe z archivu ze složky ws.
Spusťte instalátor mydlinka-setup-[verze].exe v režimu správce (Spustit jako správce) a řiďte se
pokyny v jednotlivých dialogových oknech průvodce.
Uvítací dialog
Instalátor zobrazí uvítací dialog průvodce instalací. Pokud byla na daném stroji již webová služba
nainstalována, budete vyzváni nejprve k odinstalaci předchozí verze. Provedením odinstalace bude
ztraceno původní nastavení webové služby. Pokračujte tlačítkem Další.
Licenční smlouva
Prostudujte licenční smlouvu, která se vztahuje k webové službě, vyberte možnost Souhlasím
s podmínkami licenční smlouvy a pokračujte tlačítkem Další.
Umístění webové služby
Vyberte složku, do které chcete webovou službu nainstalovat a pokračujte tlačítkem Další.
Nabídka Start
Vyberte název složky v nabídce Start, do které budou nainstalováni zástupci aplikací, nebo zvolte
možnost Nevytvářet složku v nabídce Start a pokračujte tlačítkem Další.
Připojení k databázi
Vyplňte pole Adresa cílového počítače. Pokud je databáze umístěna na stejném stroji jako webová
služba, použijte adresu 127.0.0.1, v opačném případě použijte adresu IP, kterou jste si
poznamenali v kroku přípravy. Za adresu vložte lomítko a číslo portu, na kterém pracuje
databázový server Firebird. Adresa bude vypadat například takto pro instalaci webové služby
na stejný stroj, kde je umístěna databáze:
127.0.0.1/3050
Nebo například takto, pokud se databáze nachází na jiném stroji:
192.168.1.25/3050
Do pole Cesta k databázi vložte umístění databázového souboru na cílovém počítači.
Do polí Uživatelské jméno a Heslo vložte přístupové údaje k databázi, které jste získali v modulu
Správce databáze.
Zkontrolujte vložené údaje a pokračujte tlačítkem Další. Průvodce instalací prověří, zda jsou
zadané údaje správné a zamezí pokračování instalace, dokud nebudou zadány správné údaje.
V případě potíží ověřte zadané údaje, především dejte pozor na záměnu podobných znaků jako
jsou například číslice nula a velké písmeno O nebo číslice jedna a malé písmeno L. Pokud jsou
zadané údaje správné, ale připojení k databázi se nedaří ověřit, zkontrolujte, zda je zadaný port
naslouchání databázového serveru Firebird povolen v bráně Firebird na cílovém počítači.
Port pro webovou službu
Zadejte číslo portu, na kterém bude pracovat Webová služba Mydlinka. Jako výchozí hodnota byla
zvolena hodnota 7077. Pokud není toto číslo portu obsazeno jinou aplikací, je možné tuto hodnotu
ponechat. Pokračujte tlačítkem Další.
Režim spouštění služby
Zvolte režim spouštění služby po startu počítače – automaticky nebo ručně a pokračujte tlačítkem
Další. Režim spouštění je možné později změnit ve správci služeb Windows.
Shrnutí nastavení
Zkontrolujte nashromážděná nastavení a tlačítkem Instalovat spusťte instalaci.
Dokončení instalace
Zvolte, zda chcete webovou službu spustit ihned po dokončení instalace a vyberte, zda chcete
nainstalovat ovládací panel služby do oznamovací oblasti. Instalaci dokončete klepnutím
na tlačítko Dokončit.
Nastavení
Další nastavení služby lze provést ve správci služeb Windows. Otevřete Ovládací panely a vyberte
Nástroje pro správu – zobrazit místní služby. Nalistujte službu Webová služba Mydlinka a poklepáním
na položku se zobrazí další možnosti nastavení služby. Veškerá nastavení, která jsou zde dostupná,
jsou poskytována operačním systémem Windows a jejich popis je třeba hledat na serverech
s nápovědou Microsoft.
Provoz služby a řešení potíží
Ovládání služby je možné pomocí správce služeb Windows nebo pomocí ovládacího panelu
Webové služby Mydlinka – pokud byl nainstalován. Veškeré změny nastavení provádějte
obezřetně, protože změna nastavení může způsobit nefunkčnost webové služby.
Změna přístupových údajů k databázi je možná odinstalací a opětovnou instalací webové služby.
Pokud nastanou potíže se spouštěním webové služby po startu počítače, ale manuální spuštění
služby pracuje správně, nastavte ve správci služeb Windows režim spouštění Automaticky –
zpoždění spuštění.
Pokud služba pracuje správně, ale klientská aplikace se nemůže ke službě připojit, ověřte, zda je
na počítači, na kterém je služba nainstalována, povolena komunikace na portu, který byl
pro komunikaci zvolen při instalaci webové služby.
Odinstalace
Odinstalaci webové služby proveďte v Ovládacích panelech Windows. Otevřete Ovládací panely –
Programy – Programy a funkce – Odinstalovat program. V seznamu nainstalovaných programů
vyhledejte a vyberte Webová služba Mydlinka a klikněte na tlačítko Odinstalovat. Potvrďte
odinstalaci a vyčkejte, dokud nebude odinstalace dokončena.
Webová služba Mydlinka pro Linux
Jednotlivé kroky návodu se mohou mírně lišit v závislosti na typu distribuce operačního systému
Linuxového typu. Instalaci, Odinstalaci a práci s webovou službou pro Linux by měl provádět
pouze zkušený uživatel.
Instalace je popsána tak, jak probíhá na distribuci Ubuntu/Debian. Na jiných systémech je nutné
pro každý krok použít správný nástroj dle typu distribuce. Toto platí zejména pro nástroj
na instalaci balíčků.
Všechny kroky návodu je třeba provádět s právy superuživatele (root).
Požadované softwarové vybavení
Než začnete instalaci webové služby, ověřte, zda máte nainstalované a funkční požadované
softwarové vybavení.
Instalaci virtuálního stroje Java můžete provést například podle návodu pro Ubuntu, který najdete
na adrese wiki.ubuntu.cz/java.
Instalaci databázového serveru Firebird proveďte dle návodu od výrobce. Návod je k dispozici
na adrese www.firebirdsql.org/manual/ubusetup.html.
Nástroj JSVC z rodiny nástrojů Apache Commons Daemon nainstalujte podle návodu na adrese
www.installion.co.uk/ubuntu/saucy/universe/j/jsvc/en/install/index.html
Instalace
Připravte si soubor mydlinka-setup-[verze].tar z archivu ze složky ws. Nakopírujte soubor na
cílový počítač do přechodné složky, kterou pro tento účel vytvoříte. Spusťte terminál a přesuňte se
do vytvořené složky. Rozbalte soubor mydlinka-setup-[verze].tar příkazem
tar -xf mydlinka-setup-[verze].tar
Spusťte instalaci příkazem:
sudo ./install.sh
Instalační program nejprve ověří, zda jsou nainstalované všechny potřebné komponenty. Pokud
některá komponenta chybí, doinstalujte ji podle předchozího kroku. Jakmile jsou všechny
komponenty ověřeny, nainstalují se soubory webové služby a poté se automaticky spustí skript
pro nastavení webové služby. Pokud je nastavení korektní, uloží se na disk a instalační program
spustí webovou službu.
V případě, že při spuštění instalace bude webová služba už nainstalovaná, instalační program
nabídne možnost její odinstalace. Odinstalaci proveďte zejména pokud je již nainstalovaná verze
odlišná od verze, kterou právě instalujete, jinak webová služba nemusí fungovat správně.
Nastavení
Změnu nastavení služby je možné provést příkazem:
sudo /opt/mydlinka/setup.sh
Postupně zadejte požadované vstupní údaje.
Zadejte Adresa a port cílového stroje s databází SAS. Pokud je databáze umístěna na stejném stroji
jako webová služba, použijte adresu 127.0.0.1, v opačném případě použijte adresu IP, kterou jste
si poznamenali v kroku přípravy. Za adresu vložte lomítko a číslo portu, na kterém pracuje
databázový server Firebird. Adresa bude vypadat například takto pro instalaci webové služby
na stejný stroj, kde je umístěna databáze:
127.0.0.1/3050
Nebo například takto, pokud se databáze nachází na jiném stroji:
192.168.1.25/3050
Zadejte Cesta k databázi SAS na cílovém stroji a vložte umístění databázového souboru na cílovém
počítači. Pokud se databáze nachází na počítači s operačním systémem Windows, použijte jako
oddělovač cesty dopředná lomítka. Je třeba zadat fyzickou cestu k databázi. Pokud bude cesta
odkazovat na virtuální disk, nemusí webová služba pracovat správně. Cesta může vypadat
například takto:
C:/SAS/Data/sas.fdb
Do polí Uživatelské jméno a Heslo vložte přístupové údaje k databázi, které jste získali v modulu
Správce databáze.
Zadejte Číslo portu pro Webovou službu Mydlinka. Jako výchozí hodnota byla zvolena hodnota 7077.
Pokud není toto číslo portu obsazeno jinou aplikací, je možné tuto hodnotu ponechat.
Pokud je nové nastavení korektní, uloží se na disk, v opačném případě zadejte údaje znovu.
Odinstalace
Odinstalaci spustíte příkazem:
sudo /opt/mydlinka/uninstall.sh
Během odinstalace bude tázáni, zda chcete odstranit záznamy běhu aplikace (logy) a uložené
nastavení.
Provoz služby a řešení potíží
Manuální spuštění služby provedete příkazem:
sudo service mydlinka start
nebo
sudo /etc/init.d/mydlinka start
Restartování služby provedete příkazem:
sudo service mydlinka restart
nebo
sudo /etc/init.d/mydlinka restart
Zastavení služby provedete příkazem:
sudo service mydlinka stop
nebo
sudo /etc/init.d/mydlinka stop
Zjištění stavu služby provedete příkazem:
sudo service mydlinka status
nebo
sudo /etc/init.d/mydlinka status
Pokud dojde k potížím s webovou službou, odešlete prosím na technickou podporu mimo popisu
chyby také záznamy o běhu aplikace (logy), které naleznete v adresáři /var/log/mydlinka.
Pokud služba pracuje správně, ale klientská aplikace se nemůže ke službě připojit, ověřte, zda je
na počítači, na kterém je služba nainstalována, povolena komunikace na portu, který byl
pro komunikaci zvolen při instalaci webové služby.
Technická podpora
Pokud nastanou potíže při provozu Webové služby Mydlinka, kontaktujte technickou podporu
na adrese [email protected]. Do předmětu e-mailu uveďte heslo Mydlinka.
Před odesláním e-mailu ověřte, že potíže nejsou způsobeny nesplněním některého požadavku
na instalaci a provoz webové služby.
Držte se pravidel pro technickou podporu, pomůžete tak rychlejšímu odbavení Vašeho požadavku.
Pravidla pro technickou podporu naleznete na adrese www.mp-soft.cz/?id=sas pravidla.