TaskPool 2.9

Transkript

TaskPool 2.9

TaskPool 2.9
Příručka správce
TaskPool 2.9
TaskPool 2.9: Příručka správce
©2013 ComArr, spol. s r.o. Všechna práva vyhrazena.
[email protected], www.taskpool.cz
2
TaskPool 2.9
iii
Obsah
1. Úvod ...................................................................................................................... 1
2. Předpoklady instalace ............................................................................................. 2
2.1. Hardware ..................................................................................................... 2
2.2. Java ............................................................................................................ 2
2.3. Aplikační server ........................................................................................... 2
Nastavení a spuštění aplikačního serveru .................................................... 2
Instalace více aplikačních serverů ............................................................... 3
2.4. Databázový server ....................................................................................... 4
Instalace MySQL ........................................................................................ 4
Instalace MSSQL ........................................................................................ 4
2.5. SMTP server ................................................................................................ 4
3. Instalace systému TaskPool ..................................................................................... 6
3.1. Vytvoření databáze v případě MySQL ........................................................... 6
3.2. Vytvoření databáze v případě MSSQL ........................................................... 6
3.3. Umístění souborů TaskPoolu ........................................................................ 7
3.4. Soubor Taskpool.properties ........................................................................... 7
3.5. Naplnění databáze ....................................................................................... 9
3.6. Fulltextová indexace ................................................................................... 10
3.7. Spuštění aplikace ....................................................................................... 10
4. Zálohování ............................................................................................................ 11
5. Upgrade TaskPoolu ............................................................................................... 12
6. Autentikátor ........................................................................................................... 13
6.1. TaskPool autentikace .................................................................................. 13
6.2. Helpdesk autentikace ................................................................................. 13
7. Reportování chyby ................................................................................................ 15
8. Kontaky ................................................................................................................ 16
Úvod
1
Kapitola 1. Úvod
Vážený zákazníku,
děkujeme Vám za Vaše rozhodnutí nasadit náš systém TaskPool. Jsme Vaší objednávkou
potěšeni a rádi Vám budeme při instalaci softwaru nápomocni.
Tento manuál slouží jako příručka správce systému, který bude mít na starosti správu serveru
a chod systému TaskPool, zálohování, systémové soubory a databázi, v neposlední řadě
také instalaci a upgrade systému. Nejedná se o manuál ke konfiguraci funkcí systému a
uživatelského prostředí, k tomu využijte administrátorský a uživatelský manuál.
Pokud se rozhodnete systém TaskPool instalovat sami, tato příručka Vám poslouží jako
komplexní návod k instalaci. Pokud byste si nevěděl rady nebo si přejete provést instalaci
naším týmem, využijte některý z kontaktů zákaznické podpory (viz kapitola 8. Kontakty).
Systém TaskPool běží výhradně v prostředí Java a lze jej provozovat na stanicích s různými
operačními systémy. Již otestovaný je korektní běh na operačních systémech MS Windows,
Linux, SunOne, MacOsX.
TaskPool je webový nástroj a jeho uživatelé nejsou závislí na platformě, stačí jim běžný
internetový prohlížeč se zapnutou podporou JavaScriptu, jako jsou MS Internet Explorer,
Mozilla Firefox, Chrome, Opera apod.
Ke korektnímu běhu TaskPoolu je dále potřeba aplikační server a databázový server, více
se dozvíte v následující kapitole.
Předpoklady instalace
2
Kapitola 2. Předpoklady instalace
2.1. Hardware
Pro bezproblémový chod systému TaskPool je nutné mít k dispozici počítač alespoň s
procesorem Pentium 4, 512 MB RAM a alespoň 200 MB prostoru na disku. Velikost místa,
které TaskPool zaujímá na disku, záleží především na velikosti databáze a velikosti a počtu
vložených příloh k jednotlivým taskům (viz uživatelský manuál). Systém je také možné bez
problémů provozovat na virtuálním serveru.
Dále je nutné mít připraveny následující komponenty, jejich podrobnější nastavení a instalace
budou popsány v následujících částech tohoto manuálu.
1. Java
2. Aplikační server
3. Databázový server
4. SMTP server - bez něj nebude moci TaskPool zasílat e-mailová upozornění (notifikace)
Volitelně je možné použít další komponenty:
• LDAP / Active Directory - je-li využíváno k přihlašování v dané síti (více v
administrátorském manuálu v kapitole 10. LDAP/AD).
• POP3 - pokud chceme využívat komunikaci pomocí e-mailu (více v administrátorském
manuálu v kapitole 14. POP3 přiřazení).
2.2. Java
Pro korektní běh aplikace TaskPool je nutná instalace prostředí Java. Doporočujeme použít
produkt firmy Sun Systems, a to balíček JRE Version 6 a vyšší. Domovská stránka Sun
Systems je zde:
• http://www.sun.com
2.3. Aplikační server
Jako aplikační server doporučujeme použít Apache Tomcat verze 6 nebo 7. Domovská
stránka Tomcatu je zde:
• http://tomcat.apache.org
Během instalace se nastavuje port, na kterém Tomcat poběží. Doporučujeme použít port 80.
Obecně lze ale Tomcat nainstalovat na libovolný neobsazený port. Tento port bude následně
ovlivňovat adresu, na které bude TaskPool přístupný, v případě portu 80 se číslo portu do
adresy zadávat nemusí.
Nastavení a spuštění aplikačního serveru
V unixových systémech doporučujeme umístit instalaci aplikačního serveru do standartního
umístění /usr/local/tomcat/ . V případě Windows se Tomcat standardně instaluje jako
3
služba s umístěním do adresáře c:\Program Files\Apache Software Foundation
\Tomcat 7\ .
POZN.: Od verze 5.5.26 výše je nutné pro správný běh TaskPoolu v konfigurátoru Tomcatu
na kartě "Java" přidat tento parametr:
-Dorg.apache.jasper.compiler.Parser.STRICT_QUOTE_ESCAPING=false
POZN.: Tomcat d používá 64MB paměti. V konfigurátoru Tomcatu na kartě "Java" se dá ručně
nastavit velikost používané paměti. Doporučujeme dle možností serveru nastavit paměť
alespoň na 256MB/512MB (minimální velikost/maximální velikost), ideálně 512MB/1024MB.
Pokud chceme měnit paměť v instalaci na Linuxu, editujeme soubor catalina.sh , jedná
se o řádek JAVA_OPTS="-Xms128m -Xmx128m" , přičemž první hodnota představuje
minimální hodnotu paměti a druhý řádek maximální hodnotu.
Instalace více aplikačních serverů
Aplikačních serverů je možné nainstalovat více vedle sebe, např. pro testování nových verzí
apod. Postup popsaný v této kapitole lze aplikovat na server Apache Tomcat 5.x. Server
Apache Tomcat 6 a 7 lze nainstalovat pouze jeden. Serverů Apache Tomcat 5.x lze mít vedle
sebe neomezené množství, nevylučuje se např. ani varianta Apache Tomcat 6 i 7 a vedle něj
několik serverů Apache Tomcat 5.x. Postup instalace bude popsán v prostředí Windows.
Nejprve je potřeba z webu http://tomcat.apache.org stáhnout instalační balíček Tomcatu 5.x
(nikoliv .exe, ale .zip). V tomto příkladu budeme pracovat s tímto umístěním prvního Tomcatu:
C:\Program Files\Apache Software Foundation\Tomcat 5.5\
Instalační balíček druhého Tomcatu pak můžeme rozbalit např. do tohoto adresáře:
C:\Program Files\Apache Software Foundation\Tomcat 5.5 test\
Po rozbalení souborů v adresáři druhého Tomcatu editujte soubor \Tomcat 5.5 test
\conf\server.xml . Ten obsahuje nastavení tří portů, používaných Tomcatem, standartně
jsou to tyto:
• <Server port="8005" shutdown="SHUTDOWN">
• <Connector
port="8080"
redirectPort="8443" />
protocol="HTTP/1.1"
connectionTimeout="20000"
• <Connector port="8009" protocol="AJP/1.3" redirectPort="8443" />
Tučně zvýrazněné porty je třeba změnit na unikátní hodnoty, dva Tomcaty nemohou používat
žádné společné porty. Čísla portů mohou být libovolné, nesmí však být již obsazené jinými
aplikacemi. Connector port je právě ten, který bude ovlivňovat adresu TaskPoolu. Pokud
se tedy TaskPool bude nacházet na serveru 127.0.0.1, adresa pro přístup do TaskPoolu v
tomto případě bude http://127.0.0.1:8080/ .
Dále editujte soubor \Tomcat 5.5 test\bin\service.bat nastavením následujících
hodnot:
• set SERVICE_NAME = jméno služby v operačním systému, např. "tomcat5test"
4
• set SERVICE_NAME = název služby, který se bude zobrazovat v seznamu služeb
operačního systému, např. "Apache Tomcat Test"
Nyní spušťte soubor service.bat s parametrem install (popř. remove pro odinstalování).
Po spuštění se nainstaluje nová služba se zvoleným názvem.
Nakonec je potřeba přejmenovat soubor \Tomcat 5.5 test\bin\tomcatw.exe
podle zvoleného SERVICE_NAME. Pokud toto neučiníte, nebude možné přistupovat do
konfigurace Tomcatu. Pokud jste zadali např. SERVICE_NAME=tomcat5test , soubor
přejmenujte na tomcat5testw.exe . Po spuštění takto přejmenovaného souboru se již
dostanete do konfigurace Tomcatu. Samotná služba se potom spouští klasicky v seznamu
služeb Windows.
2.4. Databázový server
Podporovány jsou tyto databázové servery: MySQL 5.x., MS SQL 2000, MS SQL 2005, MS
SQL 2008, MS SQL 2008 R2, MS SQL Express.
Instalace MySQL
V této kapitole bude detailně popsána situace, kdy je jako databázový server použit MySQL
na platformě Windows. Domovská stránka MySQL je zde:
• http://www.mysql.com
K nastavení databázového serveru, uživatelů a přístupových práv můžeme doporučit nástroj
MySQL Administrator, který nabízí přehledné grafické uživatelské rozhraní a je volně ke
stažení na webu MySQL.
V případě MySQL verze 5.x ve Windows se po instalaci databázového serveru spustí
konfigurační průvodce. V tomto průvodci je několik kroků, u kterých je potřeba zvolit
následující varianty:
• Configuration type – Detailed Configuration
• Server type - Server Machine
• Database usage - Multifunctional Database
• Numer of concurrent connections to the server – Decision Support (DSS)/OLAP
Nezpomeňte si také poznamenat heslo uživatele "root", které budete při instalaci zadávat.
Takto nakonfigurovaný databázový server je připraven pro použití TaskPoolem.
Instalace MSSQL
V případě instalace databázového serveru MS SQL je vyhovují defaultní instalace. Opět
si nezapomeňte poznamenat heslo administrátora (v tomto případě uživatele "sa"), které
budete zadávat při instalaci.
2.5. SMTP server
SMTP server je systémem TaskPool využíván k zasílání e-mailových upozornění na změny
neboli notifikací. Notifikace jsou jedna z hlavních funkcí systému a umožňují rychlé a efektivní
5
sledování všech změn v systému. Zároveň jsou plně konfigurovatelné, každý uživatel tak
může dostávat pouze ty notifikace, které se týkají přímoj jeho apod.
TaskPool umí k SMTP serveru přistupovat pomocí loginu a hesla ale i bez nich. Šifrování je
možné použít SSL nebo TSL. Přístup se nastavuje v konfiguračním souboru, více v kapitole
3.4. Soubor Taskpool.properties.
Instalace systému TaskPool
6
Kapitola 3. Instalace systému
TaskPool
Předpokládáme, že aplikační server a databázový server jsou již úspěšně nainstalovány.
Detailně opět popisujeme instalaci na platformě Windows za použití databázového serveru
MySQL.
3.1. Vytvoření databáze v případě MySQL
1. Založte v MySQL databázi, např. taskpool .
2. Založte uživatele, který bude vlastnit danou databázi, např. taskpooluser .
Tyto úkony lze pohodlně provést pomocí nástroje MySQL Administrator. Pokud MySQL
Administrator z nějakého důvodu použít nemůžete, lze konfiguraci provést v příkazové
řádce MySQL. Do příkazové řádky MySQL se typicky přihlašuje z příkazové řádky Windows
příkazem: mysql -uroot -p. Parametr -uroot znamená, že se přihlašujete pod uživatelem
"root" a parametr -p znamená, že pro přístup bude vyžadováno heslo, které jste zvolili při
instalaci serveru MySQL. Postup vytvoření databáze v příkazové řádce je tento:
1. Založení databáze:
CREATE DATABASE taskpool;
2. Založení uživatele:
CREATE USER taskpooluser IDENTIFIED BY 'heslo';
3. Nastavení práv uživatele pro přístup k databázi:
GRANT ALL PRIVILEGES ON taskpool.* TO taskpooluser IDENTIFIED BY 'heslo';
GRANT SUPER ON *.* TO taskpooluser@host IDENTIFIED BY 'heslo';
exit;
POZN. 1: taskpool, taskpooluser a heslo jsou pouze příklady, skript je možné upravit podle
vlastních potřeb.
POZN. 2: Příkaz "GRANT SUPER ON *.* TO taskpooluser@host IDENTIFIED BY 'heslo';"
přidělí uživateli právo SUPER. To je nutné v případě, že máte v MySQL zapnuté binární
logování. Hodnota taskpooluser@host je adresa uživatele podle nastavení SQL serveru,
může být tedy např. taskpooluser@localhost, [email protected] atd. Uživatel "root"
má právo SUPER implicitně přiděleno, proto je možné v případě problémů s právy nastavit
tohoto uživatele jako majitele databáze.
3.2. Vytvoření databáze v případě MSSQL
V případě databázových serverů od firmy Microsoft je postup následující:
1. Založte databázi s collation CZECH_CI_AI
2. Vytvořte uživatele a přidělte mu na danou databázi práva OWNER
7
3.3. Umístění souborů TaskPoolu
Na všech platformách se v kořenovém adresáři Tomcatu nachází podadresář ..\webapps
\ROOT\ . Toto je nejvhodnější adresář pro umístění souborů TaskPoolu. Název adresáře
se soubory bude ovlivňovat URL, na kterém bude přístupný TaskPool. V případě adresáře
ROOT může adresa vypadat např. http://localhost/ . Soubory lze umístit i do jiného
adresáře, např. ..\webapps\taskpool\ . Adresa by pak byla http://localhost/
taskpool/ . Pokud se rozhodnete pro ROOT, smažte veškerý obsah tohoto adresáře a
rozbalte do něj soubory systému TaskPool, které jste obdrželi po uskutečnění objednávky.
POZOR! Aplikační server musí mít práva ke čtení a zápisu do adresáře ..\webapps\ROOT
\logos\ . Do tohoto adresáře TaskPool ukládá veškeré přílohy a uživatelské soubory.
3.4. Soubor Taskpool.properties
Konfigurační soubor se nazývá Taskpool.properties a nachází se v adresáři
..\webapps\ROOT\WEB-INF . V distribučním balíčku najdete tento soubor jako
Taskpool.properties.empty , je to z důvodu snažších upgradů systému (více v kapitole
5. Upgrade TaskPoolu). Tento soubor je před prvním použití nutné přejmenovat na podobu
Taskpool.properties .
Vždy, když dojde ke změně konfiguračního souboru, je pro nabytí změn nutné restartovat
službu Tomcat, popř. alespoň instanci TaskPool.
Konfigurační soubor obsahuje následující položky:
SMTP server
Pomocí SMTP serveru TaskPool posílá e-maily. Pokud nebude SMTP nastaven, z TaskPoolu
nebudou moci chodit notifikace, eskalace, e-mailové reporty apod.
• mail.smtp = URL SMTP serveru
• mail.smtp.login = uživatelské jméno pro přihlášení k SMTP serveru
• mail.smtp.password = heslo uživatele pro přihlášení k SMTP serveru
POZOR! Pro funční SMTP server nesmí být v adresáři ..\Tomcat\common\lib\ knihovny
Javamail-1.3.jar a activation-1.0.1.jar !
URL TaskPoolu
Toto je URL, na kterém je přístupný TaskPool. URL je použito v notifikacích jako předpona
adresy tasku, na který notifikace odkazuje. V případě špatného nastavení odkazu se nebude
možné dostat z notifikace na task. Nastavení tohoto URL se případně dá přebít v nastavení
licence přímo v TaskPoolu, více v administrátorském manuálu v kapitole 9. Licence.
• url.login = např. http://taskpool.vasefirma.cz
Odesílatel e-mailů
Toto je implicitní odesílatel notifikací. Nastavení se dá určit pro každý pool zvlášť přímo v
TaskPoolu, více v administrátorském manuálu v kapitole 3. Pooly .
• email.from = např. [email protected]
8
Adresa pro odesílání chybových e-mailů
V případě chyby (např. zaseknuté vlákno, nefunkční pop3, atd.) je tato hodnota
použita jako další příjemce informativního e-mailu. Pokud není vyplněno, odesílá se na
"[email protected]".
• helpdesk.mail = např. [email protected]
Aktivace POP3 rozhraní
Více o této funkci se dozvíte v administrátorském manuálu v kapitole 3.10. Karta E-mail
Interface.
• hd.checkmail = tato položka může nabývat dvou hodnot (1 - vybírání e-mailů ze schránky
je zapnuté, 0 - vybírání e-mailů je vypnuté)
Nastavení připojení k databázi
Toto nastavení je stěžejní pro komunikaci TaskPoolu s databází.
• db.url = na toto místo se zapisuje připojovací řetězec k databázi
• MySQL:
db.url=jdbc:mysql://localhost:3306/taskpool
?useUnicode=true&characterEncoding=utf8
V tomto řetězci reprezentuje "taskpool" název používané databáze a "localhost:3306"
reprezentuje URL pro připojení k databázovému serveru. Tyto hodnoty je potřeba změnit
podle dané instalace.
• MSSQL:
jdbc:jtds:sqlserver://localhost:1433/taskpool
Zde je situace podobná - "taskpool" reprezentuje opět název používané databáze a
"localhost:1433" reprezentuje URL pro připojení k databázovému serveru.
• db.user = uživatel, který je vlastníkem databáze, např. taskpooluser
• db.password = heslo vlastníka databáze
Kód zákazníka
Toto je nepovinná položka. Používá se při použití LDAPu pro přihlašování do TaskPoolu, více
v administrátorském manuálu v kapitole 10. LDAP / AD.
Synchronizace se systémem MarkTime
Toto je nepovinná položka. Pokud chcete systém TaskPool synchronizovat se systémem
MarkTime, zde se nastavuje synchronizační URL. Integrace obou systémů je poměrně
komplexní záležitost a doporučujeme ji vždy konzultovat s pracovníky Bellman Group.
Přístupová práva pro aktualizaci instalace
Tyto údaje jsou vyžadovány při aktualizaci databáze TaskPoolu nebo při naplňování prázdné
databáze a jsou definovány administrátorem v tomto konfiguračním souboru.
9
• update.username = uživatelské jméno pro aktualizaci databáze
• update.password = heslo daného uživatele
Exportní timeout
Export se používá pro uložení informací o jednotlivých tascích do externího souboru.
Hodnota timeoutu určuje maximální čas využitelný pro export v milisekundách. V případě
velmi rozsálhé databáze je možné, že je timeout při exportu překročen a export neproběhne
korektně. V těchto případech lze hodnotu navýšit.
Nastavení GPS souřadnic
Tato funkce je využívána při použití mobilního řešitelského rozhraní. Uživatel pošle z
mobilního telefonu GPS souřadnice svého umístění či umístění problému a pomocí
nastavovaného řetězce TaskPool vytvoří klikatelný odkaz, buď na serveru mapy.cz nebo
google maps. Doporučujeme řetězce neměnit, pouze odkomentovat požadovaný řádek.
Nastavení WS Trust ověření
Pokud používáte ověření WS Trust, tato část konfiguračního souboru slouží právě pro jeho
nastavení.
LDAP timeout
Zde se nastavuje timeout pro přihlášení pomocí LDAP. Pokud se z nějakého důvodu nedaří
pomocí LDAP přihlásit, je možné zkusit zvýšit timeout.
Po dokončení úpravy konfiguračního souboru spusťte nebo restartujte server Tomcat.
3.5. Naplnění databáze
Aby mohl TaskPool s databází korektně pracovat, musí ji naplnit tabulkami, do kterých
bude ukládat data. TaskPool automaticky kontroluje strukturu databáze podle aktuální verze
systému. Pokud najde nějakou odlišnost, požádá uživatele o aktualizaci databáze.
Nejprve zadejte do okna internetového prohlížeče adresu, na které je přístupný TaskPool.
Adresa se odvíjí od portu, na kterém běží Tomcat (viz kapitola 2.3. Aplikačni server) a v jakém
adresáři se nachází soubory TaskPoolu (viz kapitola 3.3. Umístění souborů TaskPoolu).
Pokud Tomcat běží na portu 80, soubory TaskPoolu jsou nakopírovány v adresáři ..
\webapps\ROOT\ , a nacházíte se přímo na serveru, požadovaná adresa bude http://
localhost/ .
Po zadání správné adresy TaskPool zjistí prázdnou databázi a požádá o její aktualizaci.
Objeví se následující okno:
Obrázek 3.1. Update databáze
10
Jako "Username" a "Password" se zadávají nastavené hodnoty ze souboru
"Taskpool.properties" (viz kapitola 3.4. Soubor TaskPool properties). Pole "Version" určuje,
které procedury budou při aktualizaci provedeny. Pro kompletní naplnění či update databáze
použijte pouze hodnotu 1. Ostatní hodnoty slouží pro dílčí updaty a používají se v
nestandardních situacích.
Tlačítkem "UPDATE" spustíte aktualizaci databáze. Na obrazovce uvidíte výpis prováděných
akcí. Po skončení aktualizace se objeví nápis "UPDATE DONE SUCCESSFUL" a tlačítko
"ACCEPT". Na toto tlačítko klikněte a poté restartujte Tomcat.
3.6. Fulltextová indexace
Aplikace TaskPool umožňuje fulltextové vyhledávání. Indexují se veškeré psané texty k
tasku, a to vždy při jakékoliv jeho změně. Reindexaci je možné vyvolat i explicitně. Do
adresního řádku prohlížeče zadejte adresu TaskPoolu následovanou stránkou /fulltext.do ,
tedy např. http://localhost/fulltext.do . V prohlížeči se zobrazí stránka podobná
updatu databáze (kapitola 3.5. Naplnění databáze. Přihlašovací údaje jsou stejné jako pro
update databáze, políčko Customer ID slouží pro reindexaci jen jednoho zákazníka v multi
licenčním prostředí. Do tohoto pole není nutné zadávat žádnou hodnotu. Po kliknutí na
tlačítko "REFULLTEXT" se spustí reindex veškerých dat.
Během reindexace je možné s TaskPoolem standardně pracovat, pouze fulltextové hledání
není možné. Po skončení reindexace se na obrazovce zobrazí její výsledek a tlačítko
"ACCEPT". Po stisknutí tlačítka již bude fulltextové hledání v TaskPoolu dostupné.
POZN.: Reindexace fulltextu není běžně při aktualizaci databáze prováděna z důvodu velké
časové náročnosti. Doporučujeme ji provádět pouze tehdy, pokud dochází k problémům s
fulltextovým vyhledáváním. Vzhledem k možnému zpomalení systému ji však doporučujeme
provádět v době, kdy s TaskPoolem nikdo nepracuje, např. přes noc.
3.7. Spuštění aplikace
Pokud jste vše správně nastavili, tak by se po zadání URL TaskPoolu měla zobrazit tato
přihlašovací obrazovka:
Obrázek 3.2. Přihlašovací obrazovka
Instalace TaskPoolu obsahuje předkonfigurovaný administrátorský účet, jehož přístupové
údaje jsou admin/noileta3 .
Zálohování
11
Kapitola 4. Zálohování
Zálohování celé aplikace doporučujeme provádět alespoň jednou týdně. Je nutné provádět
zálohu následujících komponent:
• konfigurační soubor ..\ROOT\WEB-INF\Taskpool.properties , kde je uložen
přístup k databázi a další důležité informace
• celý adresář ..\ROOT\logos\ , kde jsou uloženy veškeré uživatelské soubory a přílohy
• databáze TaskPoolu, v případě MySQL používejte tento příkaz:
mysqldump [název databáze] > [cesta\soubor.sql] –R –e –c
–u[uživatel databáze] –p[heslo]
např:
mysqldump taskpool > c:\Zaloha\db_2010_03_01.sql –R –e –c
–utaskpooluser -ptppass
• externí databáze (jsou-li používány)
POZOR! Pokud je nakonfigurovaný SMS konektor, musíme zálohovat také tyto soubory:
• knihovnu SMS konektoru ..\ROOT\WEB-INF\lib\smsBranaConnector.jar
• konfigurační
soubor
SMS
\smsBranaConnector.properties
konektoru
..\ROOT\WEB-INF
POZOR! Pokud je nakonfigurovaný COBS konektor, musíme zálohovat také tyto soubory:
• knihovnu COBS konektoru ..\ROOT\WEB-INF\lib\cobsconnector.jar
• konfigurační
soubor
COBS
\cobsconnector.properties
konektoru
..\ROOT\WEB-INF
Upgrade TaskPoolu
12
Kapitola 5. Upgrade TaskPoolu
Upgradem TaskPoolu je myšleno přechod z aktuální verze na vyšší verzi (např. z 2.5 na 2.9).
Přechod však může probíhat i v rámci stejné verze, pouze na novější build (z 2.9 na novější
2.9). Postup upgradu je při obou variantách shodný.
Nejnižší verze TaskPoolu, kterou je možné upgradovat, je verze 1.8. Pokud vlastníte nižší
verzi a přejete si upgradovat na vyšší, je nutné postup upgradu konzultovat s pracovníky
Bellman Group. Upgrade ze starších verzí musí vždy probíhat přes verzi 2.5, kde je zahrnuto
několik zásadních změn v uložení dat do databáze. Pokud tedy např. upgradujeme TaskPool
verze 2.3 na verzi 2.9, musíme nejprve upgradovat na verzi 2.5 a až poté je možný upgrade
na verzi 2.9.
POZN.: Pokud máte zakoupenou maintenace, máte nárok na všechny verze, které vyjdou v
období Vaší maintenance. Pokud maintenance nevlastníte a přejete si upgradovat TaskPool
na vyšší verzi, je nutné maintenance zakoupit. Cena roční maintenance představuje 15% z
ceny Vaší licence.
Postup při upgradu TaskPoolu je následující:
1. Vypněte server Tomcat, popř. pouze instanci TaskPool.
2. Proveďte zálohu všech částí systému, popsaných v kapitole 4. Zálohování.
3. Smažte adresář ..\ROOT\WEB-INF\lib\, KROMĚ částí popsaných v kapitole 4.
Zálohování, tedy případné soubory smsBranaConnector.jar a cobsconnector.jar
(samozřejmě pokud existují).
4. Přepište všechny soubory v adresáři ..\ROOT\ novými soubory z instalačního balíčku,
KROMĚ adresáře ..\ROOT\logos\ .
5. Smažte obsah adresáře "work" umístěného zde: ..\Apache Software Foundation
\Tomcat\work\ .
6. Spusťte server Tomcat (instanci TaskPool).
7. Pokud nová verze vyžaduje aktualizaci databáze, objeví žádost o přístupové údaje ke
spuštění aktualizace. Postup aktualizace je popsán v kapitole 3.5. Naplnění databáze. Po
aktualizaci restartuje Tomcat (instanci).
Pokud nová verze TaskPoolu nevyžaduje aktualizaci databáze, je TaskPool po spuštění
Tomcatu (instance) rovnou připraven k použití.
Pro komfortní zálohování doporučujeme použít software SQL Backup And FTP, který je k
dostání i ve freewarové verzi a umožňuje komfortní zálohování databází i souborů najednou
pomocí jednoho kliknutí. Ovládání tohoto softwaru je navíc velice intuitivní. Domovská
stránka projektu je http://sqlbackupandftp.com/ .
Autentikátor
13
Kapitola 6. Autentikátor
Autentikátor je dílčí produkt, který usnadní přihlašování do TaskPoolu a do Helpdesku tím, že
provede automatické ověření vůči serveru LDAP. Program po spuštění zjistí uživatele, který
je přihlášený na stanici a poté otevře okno prohlížeče, kterému rovnou předá přihlašovací
údaje. TaskPool ověří údaje vůči LDAP serveru a uživatele automaticky přihlásí.
Potřebné soubory najdeme v instalačním balíčku TaskPoolu v adresářích ..\WEB-INF
\tools\TaskPoolLogin\ pro automatické přihlášení do TaskPoolu a ..\WEB-INF
\tools\HelpdeskLogin\ pro automatické přihlášení do Helpdesku.
Dávky TaskPoolLogin.bat či HelpdeskLogin.bat mohou být uloženy například na
souborovém serveru a spouštěny dálkově (není nutno instalovat na každou stanici). Dalším
předpokladem pro spuštění je virtuální prostředí Java, to však dnes bývá standardní součástí
každého operačního systému. Dalším předpokladem je funkční LDAP ověření, manuál k
LDAP najdete v administrátorském manuálu v kapitole 10. LDAP .
6.1. TaskPool autentikace
Adresář "TaskPoolLogin" obsahuje tři soubory.
• TaskPoolLogin.bat - spouštěcí soubor autentikátoru
• TaskPoolLogin.jar - samotný autentikátor (java knihovna)
• TaskPoolLogin.cfg - konfigurační soubor
Pro správnou funkčnost je stěžejní právě konfigurační soubor. Ten obsahuje tři položky.
• authURL=[URL Vašeho TaskPoolu]/LDAPLogin
- doplníme URL TaskPoolu, na který se chceme přihlašovat, tedy např.:
authURL=http://www.taskpool.net/LDAPLogin
• loginURL=[URL Vašeho TaskPoolu]/login.do?ldap
- opět doplníme URL TaskPoolu, např.:
authURL=http://www.taskpool.net/login.do?ldap
• customerID=[kód zákazníka]
- ponecháme prázdné
Po správném vyplnění těchto údajů stačí spustit dávku "TaskPoolLogin.bat" a ta uživatele
automaticky přihlásí do TaskPoolu.
6.2. Helpdesk autentikace
Situace je podobná jako u autentikace do TaskPoolu, zde už budou popsány pouze
parametry konfiguračního souboru. Nastavení vychází z konfigurace Helpdesku, o tomto
nastavení se dočteme v administrátorském manuálu v kapitole 16. Modul Helpdesk .
Autentikátor
14
• authURL - požadovanou hodnotu najdeme v konfiguraci helpdesku na kartě "Přihlášení",
více v administrátorském manuálu v kapitole 16.12. Karta Přihlášení .
LDAP Login URL: http://[URL]/servlet/HelpdeskLoginLDAP?eid=[id]&authId=?????
Obrázek 6.1. Konfigurace Helpdesku: Přihlášení
Pro nás je stěžejní pouze parametr "authId=?????" – místo otazníku vyplníme ID ověření
(vpravo v závorce od daného ověření), které chceme používat. Pokud je v daném poolu
aktivní pouze jedno ověření, není třeba ID vyplňovat.
• loginURL - zde vložíme odkaz na daný helpdeskový formulář, ten najdeme v konfiguraci
helpdesku na kartě "Základní nastavení", více v administrátorském manuálu v kapitole
16.2. Karta Základní nastavení .
Obrázek 6.2. Konfigurace Helpdesku: Základní nastavení
Zvolíme jednu z variant podle používané jazykové verze.
Po správném vyplnění těchto údajů stačí spustit dávku "HelpdeskLogin.bat" a ta uživatele
automaticky přihlásí do Helpdesku.
Reportování chyby
15
Kapitola 7. Reportování chyby
Při chodu TaskPoolu může ojediněle dojít k chybě. V takovém případě je zobrazena chybová
obrazovka s formulářem pro odeslání specifikace chyby týmu Comarr, spol. s r.o.
Obrázek 7.1. Konfigurace Helpdesku: Základní nastavení
Kliknutím na tlačítko Show error můžeme zobrazit konkrétní chybu. Tlačítkem Return to
previous page se vrátíme na předchozí obrazovku.
Pro efektivní bug reporting je důležité tlačítko Send, které spustí výchozího e-mailového
klienta a psaní zprávy s přednastavenou adresou. Stěžejní je detailně popsat, které činnosti
předcházely chybě.
Velmi důležité je také zaslat log aplikace. Máme k dispozici konkrétní chybu, v logu je však
zaznamenáváno více informací a je možné sledovat delší časový úsek před chybou. Jedná
se o následující soubory:
Linux - jedná se o soubor catalina.out, který se může nacházet na libovolném místě dle
dané instalace. Do tohoto souboru se ukládají logy za celou dobu běhu TaskPoolu, zpravidla
je tedy velmi objemný, pro reporting stačí zaslat část logu z období, kdy došlo k chybě.
Windows - logy se zpravidla nacházejí v adresáři s aplikačním serverem, tedy ..\Tomcat
\logs\stdout_[datum]. V prostředí Windows se vytváří nový log vždy při restartu
Tomcatu, dané soubory s logy jsou označeny datem, opět stačí zaslat log pouze z období,
kdy došlo k chybě.
Zároveň je kdykoliv možné využít naše helpdeskové rozhraní, nacházející se na adrese
http://www.taskpool.cz/ v sekci Podpora -> Helpdesk pro zákazníky.
Kontaky
16
Kapitola 8. Kontaky
V případě problémů s instalací nás prosím kontaktujte pomocí našeho helpdeskového
formuláře umístěného na této adrese:
• http://www.taskpool.cz/ , sekce Podpora -> Helpdesk pro zákazníky.
Můžete také využít telefonní číslo zákaznické podpory:
• +420 777 925 233
Další kontaktní údaje jsou uvedeny na této stránce:
• http://www.taskpool.cz/taskpool-comarr.php
(c) Copyright 2013 Comarr, spol. s r.o.

TaskPool 2.9

Transkript

Podobné dokumenty

Cloudová řešení nástrojů CASE

zobrazit dokument

Stahujte zde - active 24

Norton GhostTM

5 - Arrow ECS

Ceník webových služeb

Technická dokumentace pro implementaci mojeID Vydání . CZ.NIC