ˇ e vysok´e uˇcen´ı technick´e v Praze Cesk´ Fakulta elektrotechnick´a
Tutori´al k softwarov´emu projektu
Pˇ revody pojistn´ ych kmen˚ u Michal Ciasnocha, Stanislav Kokaisl, Jan Mathauser, Milan Molda, Daniel Puncman
Obsah ´ 1 Uvod
3
2 Pouˇ zit´ı aplikace PPK 2.1 Pˇrihl´ aˇsen´ı uˇzivatele . . 2.2 Zadavatel PPK . . . . 2.3 Schvalovatel PPK . . . 2.4 Administr´ ator syst´emu
. . . .
. . . .
. . . .
. . . .
. . . .
. . . .
. . . .
. . . .
. . . .
. . . .
. . . .
. . . .
. . . .
. . . .
3 3 3 4 6
3 Instalace aplikace 3.1 Staˇzen´ı potˇrebn´ ych aplikac´ıch . . . . . 3.2 Instalace potˇrebn´ ych aplikac´ı . . . . . 3.3 Nastaven´ı JBOSS AS . . . . . . . . . . 3.4 Spuˇstˇen´ı datab´ azov´eho serveru Sybase 3.5 Nahr´ an´ı aplikace PPK na server . . .
. . . . .
. . . . .
. . . . .
. . . . .
. . . . .
. . . . .
. . . . .
. . . . .
. . . . .
. . . . .
. . . . .
. . . . .
. . . . .
6 6 7 7 9 9
. . . .
. . . .
. . . .
. . . .
. . . .
. . . .
. . . .
. . . .
1
´ Uvod
Tento dokument popisuje jak pouˇz´ıvat aplikaci pro pˇrevod pojistn´ ych kmen˚ u (aplikace PPK). V druh´e ˇca´sti je pops´an zp˚ usob jak aplikaci nasadit na vlastn´ım serveru.
2
Pouˇ zit´ı aplikace PPK
Aplikace se ovl´ ad´ a pˇres webov´e rozhran´ı, jej´ı ovl´ad´an´ı je vcelku intuitivn´ı.
2.1
Pˇ rihl´ aˇ sen´ı uˇ zivatele
Aby mohl uˇzivatel s aplikac´ı pracovat, mus´ı se nejprve pˇrihl´asit pomoc´ı pˇrihlaˇsovac´ıho formul´ aˇre
Syst´em po u ´spˇeˇsn´em pˇrihl´ aˇsen´ı pˇridˇel´ı uˇzivateli patˇriˇcnou roli. Existuj´ı tˇri role: zadavatel PPK, administr´ator PPK a administr´ator syst´emu.
2.2
Zadavatel PPK
Po kliknut´ı na Zaloˇzit nov´y PPK v horn´ım menu
3
se uˇzivateli zobraz´ı dialog pro vyhled´an´ı smluv. Uˇzivatel pak intuitivnˇe pokraˇcuje ve v´ ybˇeru a u ´pravˇe smluv. Pˇrehled zadan´ ych pˇrevod˚ u si uˇzivatel zobraz´ı po kliknut´ı na Moje PPK v hlavn´ım menu
2.3
Schvalovatel PPK
Po kliknut´ı na Zobrazit PPK se uˇzivateli zobraz´ı seznam pˇrevod˚ u pojistn´ ych kmen˚ u.
4
Schvalovatel pak m˚ uˇze mˇenit status pojistn´ ych kmen˚ u a pˇrid´avat k nim koment´ aˇre.
5
2.4
Administr´ ator syst´ emu
Po kliknut´ı na poloˇzku Uˇzivatel´e se administr´atorovi zobraz´ı pˇrehled uˇzivatel˚ u pouˇz´ıvaj´ıc´ı syst´em.
Admistr´ ator pak m˚ uˇze upravovat u ´daje jednotliv´ ych uˇzivatel˚ u.
3
Instalace aplikace
Aplikace PPK bˇeˇz´ı na aplikaˇcn´ım serveru JBoss, proto je nutn´e udˇelat nˇekolik n´ asleduj´ıc´ıch krok˚ u popsan´ ych d´ale v dokumentu.
3.1
Staˇ zen´ı potˇ rebn´ ych aplikac´ıch
JDK http://www.oracle.com/technetwork/java/javase/downloads/index.html JBOSS aplikaˇ cn´ı server http://sourceforge.net/projects/jboss/files/JBoss/JBoss-5.1.0.GA/jboss-5.1.0.GA.zip/download samotn´ a aplikace - repozit´ aˇr 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ˇ rebn´ ych aplikac´ı
JBOSS AS staˇc´ı rozbalit, JDK se nainstaluje spuˇstˇen´ım staˇzen´e bin´arky, v Linuxu napˇr. pˇr´ıkazem ’sh jdk-6u21-linux-i586.bin’ v adres´aˇri kde je bin´arka uloˇzn´ a. Sybase se instaluje pomoc´ı staˇzen´eho setupu. Konektor se nainstaluje do JBossu pˇrekop´ırov´ an´ım souboru conn3.jar, kter´ y se nach´az´ı v adres´aˇri classes ve staˇzen´em archivu, do adres´aˇre .../jboss-5.1.0.GA/server/default/lib. Aplikace se z repozit´ aˇre st´ ahne napˇr´ıklad pˇr´ıkazem: hg clone https://hg.kenai.com/hg/team4~source-code-repository AplikacePPK Mus´ıme m´ıt ovˇsem nainstalovan´ y program hg.
3.3
Nastaven´ı JBOSS AS
Je potˇreba editovat soubor run.conf v adres´aˇri .../jboss-5.1.0.GA/bin/, v tomto souboru se mus´ı nastavit cesta k JDK, tzn. JAVA HOME=”.../jdk1.6.0 21”,pot´e je v hodn´e zv´ yˇsit parametry JRE, napˇr´ıklad na hodnoty: -Xms512m -Xmx1024m -XX:PermSize=256m -XX:MaxPermSize=512m. Pro pˇrehlednost pˇrid´av´am jak vypad´ a m˚ uj 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ˇr. pˇr´ıkazem sh run.sh), kter´ y je um´ıstˇen v adres´ aˇri .../jboss-5.1.0.GA/bin Po nabˇehnut´ı serveru, lze funkˇcnost otestovat zad´an´ım adresy http://localhost:8080/ do adresn´ıho ˇr´ adku prohl´ıˇzeˇce.
8
3.4
Spuˇ stˇ en´ı datab´ azov´ eho serveru Sybase
Server spuˇst´ım pˇres utilitku dbeng10, ta se nach´az´ı v adres´aˇri .../sqlanywhere/bin32 nebo by mˇela b´ yt dostupn´a pˇre nab´ıdku vaˇseho prostˇred´ı (napˇr. v GNOME Applications-SQL Anywhere-Personal Server). V dialogu, kter´ y se zobraz´ı po spuˇstˇen´ı, vypln´ıme cestu k datab´azi .../team4/database/ppkdata.db a jm´eno serveru localhost, stiskneme ok a server by se mˇel spustit.
3.5
Nahr´ an´ı aplikace PPK na server
Pro spuˇstˇen´ı aplikace je nutn´e, aby V´am bˇeˇzel aplikaˇcn´ı i datab´azov´ y server (pˇredchoz´ı dva odstavce). Nejdˇr´ıve je nutn´e nastavit cestu k aplikaˇcn´ımu serveru v souboru .../team4/AplikacePPK/build.properties, zde pˇrep´ıˇseme hodnotu jboss.home na cestu k naˇs´ı instalaci JBossu. Pˇredpokl´ ad´ am, ˇze m´ ate nainstalov´an Ant. Aplikace se nahraje na JBoss server pomoc´ı pˇr´ıkazu ant deploy v adres´aˇri .../team4/AplikacePPK. Otevˇreme si webov´ y prohl´ıˇzeˇc a zad´ ame adresu http://localhost:8080/AplikacePPK/, mˇela by se zobrazit u ´vodn´ı obrazovka naˇs´ı aplikace.
9