Stefan Schmidt 22.11.2009 Page | 1|4 Dieser Guide behandelt alle

Topic:
Team:
Development Guide
ITMVZ
Dieser Guide behandelt alle nötigen Tools, die für die Verwendung des itmVZ Projektes mit der Programmier-IDE Eclipse (siehe: www.eclipse.org) gebraucht werden. Dieser Guide bezieht sich auf ein
Windows Betriebsystem Windows XP SP3 oder höher. Für andere Betriebssysteme sind Downloadlinks oder Verweise angegeben, die Installation von Zusatzsoftware kann sich aber unterscheiden.
ECLISPE IDE GALILEO
Info:
Eclipse galileo ist ein bewertete und auch in der Praxis häufig verwendete Programmierumgegebung
für Java und andere Programmiersprachen, es ist durch viele Plug-ins und ähnlich Zusatzpaket stark
erweiterbar und kann für annähernd jede aktuelle Programmiersprache verwendet werden. Trotz
der großen Konkurrenz NetBeans kann sich Eclipse bei kleineren Unternehme behaupten.
Home:
http://www.eclipse.org/
Download:
http://www.eclipse.org/downloads/download.php?file=/technology/epp/downloads/release/galileo
/SR1/eclipse-jee-galileo-SR1-win32.zip
POSTGRES
Info:
Die Datenbanklösung für das Projekt itmVZ, es genügt eine Standardinstallation, es werden einfachheitshalber folgende Benutzerdaten empfohlen. Sollten Sie andere Benutzerdaten verwenden wollen, bitte ändern Sie diese in der Datei: itmvz-ds.xml.
User:
Postgres
Entsprechende Änderung in itmvz-ds.xml <user-name>postgres</user-name> (im XML-Tree „datasource“)
Passwort:
Postadmin
Änderungen von <password>postadmin</password> (im XML-Tree „datasource“)
Home:
http://www.postgresql.org/
Download:
http://www.enterprisedb.com/products/pgdownload.do#windows
JBOSS 5.0.1
Info:
Die Serverbasis für das itmVZ Projekt. Es wird die Version 5.0.1 oder höher empfohlen. Die .zip-Files
können an beliebiger Stelle entpackt werden, empfohlen wird „C:\JBoss\“ (Windows System). Weitere Konfigurationen folgen. Hilfe beim entpacken von .zip-Archiven finden sich am Ende dieses Guides.
Home:
http://www.jboss.org
Download:
http://sourceforge.net/projects/jboss/files/JBoss/JBoss-5.0.1.GA/jboss-5.0.1.GA.zip/download
Stefan Schmidt
FH Joanneum, Internettechnik
22.11.2009
Page | 1|4
Topic:
Team:
FILECOPY
Es werden folgende Files benötigt um den Server und die Datenbank entsprechend vor zu konfigurieren:
 itmvz-ds.xml (entsprechende persönliche Konfigurationen siehe Kapitel Postgres)
 postgresql-8.3-604.jdbc4.jar (postgres HDBC Driver 8.3.0)
 itmzbackup.sql (Datenbank Model des itmVZ-Projekts)
Page | 2|4
Alle oben aufgeführten Dateien finden sich unter folgendem Link auf der Google Code Plattform zum
Download in einem .zip-Archiv
Link:
http://code.google.com/p/fhj-ws2009-itm07akse/downloads/detail?name=db_server_files1.rar&can=2&q=
Das Archiv enthält ein kurzes ReadMe zu jedem der enthaltenen Files. Hier in noch einige Worte
mehr zu den einzelnen Files – es sollten alle vorher genannten Schritt ausgeführt worden sein bevor
die Dateioperationen beginnen.
itmvz-ds.xml
In den Ordner [PATH]/jboss/server/default/deploy/ kopieren.
Postgresql-8.3-604.jdbc4.jar
In den Ordner [PATH]/jboss/server/default/lib/ kopieren.
itmvz.sql
 Die Postgreskonsole öffnen unter [PATH]/PostgreSQL84/scripts/runpsql.bat
o
Start/Alle Programme/Postgres SQl 8.3/SQL Shell (psql)
 Der Shell-Routine durch den Loginprozess folgen
o
o
o
o
o
Server [localhost]: (mit Enter bestätigen)
Database [postgres]: (mit Enter bestätigen)
Port [5432]: (mit Enter bestätigen)
Username [postgres]: (ggf. ändern, wenn die Postgres Installation personalisiert
wurde, ansonsten mit Enter bestätigen)
Passwort für Benutzer Username: (das entsprechende Passwort eingegeben)
 Command „\i [PATH]/itmvz.sql“ ohne Leerzeichen eingeben und mit Enter ausführen.
 Logout mit dem Kommand “\quit” (der Bildschirmanweisung folgen)
Ein eigenen Guide zum Thema Datenbank-Import für Postgres 8.3 finden sie unter:
http://code.google.com/p/fhj-ws2009-itm07akse/downloads/detail?name=How%20to%20import%20DB.pdf&can=2&q=#makechanges
(note: name des sql files kann vom hier genannten oder im Archiv befindlichen abweichen)
Stefan Schmidt
FH Joanneum, Internettechnik
22.11.2009
Topic:
Team:
ANT BUILD FILE
Hier eine kurze Einführung in das Ant-Build System von itmVZ von Herrn Adam Ali in englischer Sprache:
“Before you run the build.xml file, you have to consider the following steps:
Page | 3|4
1.In the file Jboss.properties.template track the path to your Jboss location and rename the
file to "jboss.properties".
2.In the file potstgres.properties.template write the login-name and the password of your
postgres installation and rename it to "postgres.properties".
3.In the file javadoc.properties.template, track the path to your JDK location where javadoc.exe is. And don't forget to rename it too.
finally if you want to commit, it would be very nice if you add those local files to the 'add to
svn:ignore' so that your local file wouldn't be overridden by the files from the repo. “
User [email protected], vom 30. Okt. 2009, Sie finden den originalen Wikipost hier:
http://code.google.com/p/fhj-ws2009-itm07-akse/wiki/b4runningTheBuild
Schritte bevor das Ant-Build File ausgeführt werden kann:
 Öffnen Sie Eclipse und wechseln Sie zu ihrem Projektordner in dem Sie das itmVZ-Projekt aus dem







SVN geladen haben
In diesem befindet sich der File jboss.propertis.template unter ./itmVZ/, öffnen Sie diesen
Hinter “boss.home=” ist der Text in Ihr JBoss-Installationsverzeichnis zu ändern (siehe Kapitel JBoss)
Schließen Sie nun den File und benennen Sie ihn nun wie folgt um – jboss.properties.template in
jboss.properties – Rechtsklick auf den File in der Dateisystemübersicht, und „Rename“ wählen.
Öffnen Sie nun den File dbms.properties.template, und ändern Sie daran den Username bzw. das
Passwort sollten Sie nicht die Standardeinstellungen gewählt haben (siehe Kapitel Postgres).
Schließen Sie nun das File wieder und benennen Sie es nun, wie unter Punkt 4 beschrieben, um, von
dbms.properties.template in dbms.properties
Öffnen Sie nun den File javadoc.properties.template, tragen Sie hier hinter „javadoc.location=“ den
Pfad ihrer JavaJDK bzw. des Files javadoc.exe ein – bei einer Standardinstallation befindet sich diese
Datei unter C:\Programme\Java \JDK\bin\
Benennen Sie nun den File javadoc.properties.template wie die anderen beiden Files um - javadoc.properties.
Stefan Schmidt
FH Joanneum, Internettechnik
22.11.2009
Topic:
Team:
Weitere nützliche Files des Integrationsteams zum Thema Systemherstellung:
 Zip Archive
Zum Entpacken und Verpacken von .zip-Archiven empfehlen wir das Freewareprodukt 7zip von
Igor Pavlov. Es ist völlig kostenlos und kommen den meisten Archivformaten zu recht. Laden Sie
die .exe-Datei unter dem Downloadlink herunter und folgen Sie der kurzen Installationsroutine.
Sie können nun .zip-Archive durch Rechtsklick auf diese über das Kontextmenü „7zip“ entpacken. Page | 4|4
7zip Home:
http://www.7-zip.org/
7zip Download:
http://sourceforge.net/projects/sevenzip/files/7-Zip/4.65/7z465.exe/download
 SVN Checkout for Dummies
http://code.google.com/p/fhj-ws2009-itm07akse/downloads/detail?name=SVN%20Checkout%20for%20Dummies!.pdf&can=2&q=#makechanges
Stefan Schmidt
FH Joanneum, Internettechnik
22.11.2009