Minitutorials

Glassfish – Installation auf einem SPARC System

Wer mal so “auf die Schnelle” einen Applikationsserver fuer JAVA EE benoetigt, sollte SUN’s Glassfish mal ausprobieren. Die Vorteile liegen auf der Hand:

• Leicht zu installieren.
• Leicht zu konfigurieren.
• Leicht zu “clustern”.
• Benutzt Tomcat aehnlichen Servlet container.
• Eclipse plugin.

Die Installation die ich hier beschreibe, habe ich unter Solaris 10 auf einem SPARC System durchgefuehrt. Sie sollte sich aber weitestgehend auch auf allen Unix bzw. Linuxdistributionen nachvollziehen lassen. Ich benutze zur Installation die Bash. Daher sind Konstrukte wie export $Variable=wasauchimmer zulaessig. CSH und KSH Benutzer muessen den export als eigenen Befehl ausfuehren.

Folgende Software wird benoetigt?

• Das Java JDK 5 oder groesser.  http://java.sun.com/javase/downloads/index.jsp
• Ant von Apache. http://ant.apache.org/bindownload.cgi
• Glassfish von der Glassfish homepage.https://glassfish.dev.java.net/public/downloadsindex.html

Glassfish wird fuer viele verschiedene Betriebssysteme und Versionen selbiger angeboten. Daher ist es wichtig, genau das richtige Paket fuer Dein Betriebssystem runterzuladen.

Java:
Hier gibt es nicht besonderes zu beachten. Die Pakete werden entweder fuer die entsprechenden Paketmanager oder als selbstinstallierendes Archiv angeboten. Nach der Installation ist noch eine Umgebungsvariable zu setzen.
[root@test:~]$ export JAVA_HOME=[jdk Verzeichnis]
Ein Eintrag in die Datei /etc/.profile sorgt dafuer, dass solche Variablen auch nach dem Reboot erhalten bleiben.

Ant:
Glassfish wird ueber ein Apache Ant-Buildfile (setup.xml) gebaut. Aehnlich den makefiles fuer make. Allerdings basiert Ant auf Java und nicht wie make auf C++. Somit muss Ant installiert werden, bevor Glassfish installiert werden kann. Wir wollen Ant unter /usr/ant installieren. Folgende Schritte sind dafuer notwendig:
Ich gehe davon aus, dass das runtergeladene Paket unter /usr liegt.
[root@test:~]$ gunzip < apache-ant-[versionsnummer]-bin.tar.gz | tar xvf -
[root@test:~]$ export ANT_HOME=/usr/ant
[root@test:~]$ export ANT_BIN=$ANT_HOME/bin
Jetzt noch ANT_BIN zum PATH hinzufuegen.
[root@test:~]$ export PATH=$PATH:$ANT_BIN
Wenn man Ant ueber einen Paketmanager installiert, kann man sich die Handarbeit natuerlich sparen.

Kleiner Test, ob alles soweit in Ordnung ist.
[root@test:~]$ ant -version
Apache Ant version 1.6.5 compiled on April 1 2008

Glassfish:
Bevor wir mit der Installation beginnen, sollten die Parameter der setup.xml entsprechend angepasst werden.
Die Defaultwerte in der setup.xml sind:

* Name der Domain
domain.name=domain1

* Name der Servers
instance.name=server

* Name des Administrators
admin.user=admin

* Passwort des Administrators
admin.password=adminadmin

* Admin-webinterface Port
admin.port=4848

* HTTP Port
instance.port=8080

* Object Request Broker Port
orb.port=3700

* Intermediate Queueing Port
imq.port=7676

* HTTPS Port
https.port=8181

Um Portkonflikte mit anderen Servern oder Firewalls zu vermeiden, sollten die Parameter vor dem Build von Glassfish angeglichen werden.
Glassfish sollte unter /opt installiert werden. Dafuer das zuvor runtergeladene .jar file nach /opt moven.
Dann die folgenden Befehle ausfuehren:
[root@test:~]$ cd /opt
[root@test:~]$ java -jar Xmx256M [glassfish-version].jar
[root@test:~]$ cd glassfish
[root@test:~]$ ant -f setup.xml
Damit alle Glassfish Befehle systemweit genutzt werden koennen, sollte auch der Pfad zum Glassfish /bin-Verzeichnis mit in die PATH-Variable aufgenommen werden.
[root@test:~]$ export PATH=$PATH:/opt/glassfish/bin
Nun koennen wir den Server starten.
[root@test:~]$ asadmin start -domain domain1
Nun geben wir http://localhost:4848 im Browser ein. Wenn alles geklappt hat, wird jetzt die Administrator Loginseite angezeigt und der Server arbeitet.
Viel Spass beim Testen.

© 2008 buildblog.