České vysoké učení technické v Praze Fakulta elektrotechnická Tutoriál k softwarovému projektu Převody pojistných kmenů Michal Ciasnocha, Stanislav Kokaisl, Jan Mathauser, Milan Molda, Daniel Puncman
Obsah 1 Úvod 3 2 Použití aplikace PPK 3 2.1 Přihlášení uživatele........................ 3 2.2 Zadavatel PPK.......................... 3 2.3 Schvalovatel PPK......................... 4 2.4 Administrátor systému...................... 6 3 Instalace aplikace 6 3.1 Stažení potřebných aplikacích.................. 6 3.2 Instalace potřebných aplikací.................. 7 3.3 Nastavení JBOSS AS....................... 7 3.4 Spuštění databázového serveru Sybase............. 9 3.5 Nahrání aplikace PPK na server................ 9
1 Úvod Tento dokument popisuje jak používat aplikaci pro převod pojistných kmenů (aplikace PPK). V druhé části je popsán způsob jak aplikaci nasadit na vlastním serveru. 2 Použití aplikace PPK Aplikace se ovládá přes webové rozhraní, její ovládání je vcelku intuitivní. 2.1 Přihlášení uživatele Aby mohl uživatel s aplikací pracovat, musí se nejprve přihlásit pomocí přihlašovacího formuláře Systém po úspěšném přihlášení přidělí uživateli patřičnou roli. Existují tři role: zadavatel PPK, administrátor PPK a administrátor systému. 2.2 Zadavatel PPK Po kliknutí na Založit nový PPK v horním menu 3
se uživateli zobrazí dialog pro vyhledání smluv. Uživatel pak intuitivně pokračuje ve výběru a úpravě smluv. Přehled zadaných převodů si uživatel zobrazí po kliknutí na Moje PPK v hlavním menu 2.3 Schvalovatel PPK Po kliknutí na Zobrazit PPK se uživateli zobrazí seznam převodů pojistných kmenů. 4
Schvalovatel pak může měnit status pojistných kmenů a přidávat k nim komentáře. 5
2.4 Administrátor systému Po kliknutí na položku Uživatelé se administrátorovi zobrazí přehled uživatelů používající systém. Admistrátor pak může upravovat údaje jednotlivých uživatelů. 3 Instalace aplikace Aplikace PPK běží na aplikačním serveru JBoss, proto je nutné udělat několik následujících kroků popsaných dále v dokumentu. 3.1 Stažení potřebných aplikacích JDK http://www.oracle.com/technetwork/java/javase/downloads/index.html JBOSS aplikační server http://sourceforge.net/projects/jboss/files/jboss/jboss-5.1.0.ga/jboss-5.1.0.ga.zip/download samotná aplikace - repozitář https://hg.kenai.com/hg/team4 source-code-repository Sybase ASA 6
http://www.sybase.com/detail?id=1055872 Connector pro sybase http://www.sybase.com/products/allproductsa-z/softwaredeveloperkit/jconnect 3.2 Instalace potřebných aplikací JBOSS AS stačí rozbalit, JDK se nainstaluje spuštěním stažené binárky, v Linuxu např. příkazem sh jdk-6u21-linux-i586.bin v adresáři kde je binárka uložná. Sybase se instaluje pomocí staženého setupu. Konektor se nainstaluje do JBossu překopírováním souboru conn3.jar, který se nachází v adresáři classes ve staženém archivu, do adresáře.../jboss-5.1.0.ga/server/default/lib. Aplikace se z repozitáře stáhne například příkazem: hg clone https://hg.kenai.com/hg/team4~source-code-repository AplikacePPK Musíme mít ovšem nainstalovaný program hg. 3.3 Nastavení JBOSS AS Je potřeba editovat soubor run.conf v adresáři.../jboss-5.1.0.ga/bin/, v tomto souboru se musí nastavit cesta k JDK, tzn. JAVA HOME=.../jdk1.6.0 21,poté je v hodné zvýšit parametry JRE, například na hodnoty: -Xms512m -Xmx1024m -XX:PermSize=256m -XX:MaxPermSize=512m. Pro přehlednost přidávám jak vypadá můj run.conf: -*- shell-script -*- JBoss Bootstrap Script Configuration $Id: run.conf 88389 2009-05-08 02:37:00Z ispringer $ This shell script is sourced by run.sh to initialize the environment variables that run.sh uses. It is recommended to use this file to configure these variables, rather than modifying run.sh itself. Specify the maximum file descriptor limit, use "max" or "maximum" to use the default, as queried by the system. Defaults to "maximum" 7
MAX_FD="maximum" Specify the JBoss Profiler configuration file to load. Default is to not load a JBoss Profiler configuration file. PROFILER="" Specify the location of the Java home directory. If set then $JAVA will be defined to $JAVA_HOME/bin/java, else $JAVA will be "java". JAVA_HOME="/usr/java/jdk1.6.0" JAVA_HOME="/home/stana/jdk1.6.0_21" Specify the exact Java VM executable to use. JAVA="" Specify options to pass to the Java VM. if [ "x$java_opts" = "x" ]; then JAVA_OPTS="-Xms512m -Xmx1024m -XX:PermSize=256m -XX:MaxPermSize=512m -Dorg.jboss.resolver.warning=true -Dsun.rmi.dgc.client.gcInterval=3600000 -Dsun.rmi.dgc.server.gcInterval=3600000" fi Sample JPDA settings for remote socket debugging JAVA_OPTS="$JAVA_OPTS -Xrunjdwp:transport=dt_socket, address=8787,server=y,suspend=n" Sample JPDA settings for shared memory debugging JAVA_OPTS="$JAVA_OPTS -Xrunjdwp:transport=dt_shmem, address=jboss,server=y,suspend=n" Server se spustí skriptem run.sh (např. příkazem sh run.sh), který je umístěn v adresáři.../jboss-5.1.0.ga/bin Po naběhnutí serveru, lze funkčnost otestovat zadáním adresy http://localhost:8080/ do adresního řádku prohlížeče. 8
3.4 Spuštění databázového serveru Sybase Server spuštím přes utilitku dbeng10, ta se nachází v adresáři.../sqlanywhere/bin32 nebo by měla být dostupná pře nabídku vašeho prostředí (např. v GNOME Applications-SQL Anywhere-Personal Server). V dialogu, který se zobrazí po spuštění, vyplníme cestu k databázi.../team4/database/ppkdata.db a jméno serveru localhost, stiskneme ok a server by se měl spustit. 3.5 Nahrání aplikace PPK na server Pro spuštění aplikace je nutné, aby Vám běžel aplikační i databázový server (předchozí dva odstavce). Nejdříve je nutné nastavit cestu k aplikačnímu serveru v souboru.../team4/aplikaceppk/build.properties, zde přepíšeme hodnotu jboss.home na cestu k naší instalaci JBossu. Předpokládám, že máte nainstalován Ant. Aplikace se nahraje na JBoss server pomocí příkazu ant deploy v adresáři.../team4/aplikaceppk. Otevřeme si webový prohlížeč a zadáme adresu http://localhost:8080/aplikaceppk/, měla by se zobrazit úvodní obrazovka naší aplikace. 9