Java Enterprise Edition JEE

Vorbemerkungen zur Installation

Glassfish unter Linux

Glassfish ist zwar im Repository von allen Linux-Distributionen verfügbar, aber leider manchmal in keiner sehr aktuellen Version. In diesen Fällen ist die Installation direkt aus den Ressourcen von Eclipse vorzuziehen.

Glassfish und Mac

Der Mac beschränkt die Ausführbarkeit von Glassfish auf externen Medien wie USB-Laufwerken, USB-Sticks oder Netzwerkfreigaben. Unproblematisch ist es, Glassfish im Benutzerverzeichnis einzurichten.

Glassfish und Eclipse

Das Zusammenspiel mit Eclipse funktioniert über die Glassfish-Tools. Wichtig ist, dass die Glassfish-Tools die für die Entwicklung installierte Glassfish-Version auch unterstützt. Sonst ist es erforderlich eine niedrigere Version speziell für die Entwicklung zu verwenden.

Download von Glassfish und Installation

Glassfish wurde ursprünglich von Sun, dann von Oracle betreut. Inzwischen wird Glassfish von der Eclipse-Foundation gepflegt. Sie finden Glassfish darum unter dem folgenden Link:

https://projects.eclipse.org/projects/ee4j.glassfish/downloads

Dort wird für eine Full Profile-Version und eine abgemagertes Web Profile ein Link angeboten. Auf der Folgeseite finden Sie einen Download-Button. Sie laden daraufhin eine ZIP-Datei namens glassfish-x.y.z.zip herunter. x, y und z stehen für die Versionsnummern.

In der ZIP-Datei befindet sich ein Verzeichnis glassfish5 und darin eine Datei README.txt, die den weiteren Verlauf der Installation erläutert.

Im Verzeichnis bin gibt es ein Kommandozeilen-Tool asadmin, das zur Verwaltung von Glassfish eingesetzt wird. Als Argument wird die Start-Domain verwendet, die standardmäßig domain1 heißt. Glassfish wartet auf Port 8080 auf Anfragen.

Sie können den Server über die URL http://localhost:4848 administrieren.

Über diese grafische Oberfläche können Sie den Glassfish verwalten.

Kommandozeile

Sie können den Glashfish auch über die Konsole steuern. Dazu finden Sie im Installationspfad des Glassfish ein Verzeichnis bin, in dem sich die Befehle befinden.

Start und Stop des Servers

Für die Administration - insbesondere das Starten und Stoppen des Servers benötigen Sie Administrationsrechte. Unter Ubuntu lautet der Befehl zum Starten des Servers darum:

sudo /opt/glassfish5/bin/asadmin start-domain

Ein Neustart erfolgt mit dem Befehl:

sudo /opt/glassfish5/bin/asadmin restart-domain

Den Server stoppen Sie mit dem Befehl:

sudo /opt/glassfish5/bin/asadmin stop-domain

Administration per Browser

Der Glassfish wird typischerweise über dei GlassFish Console per Browser administriert. Dazu muss der Administrator ein Passwort erhalten und anschließend der Betrieb auf sichere Administration umgestellt werden. Dazu dienen die folgenden drei Befehle:

/opt/glassfish5/bin/asadmin change-admin-password
/opt/glassfish5/bin/asadmin enable-secure-admin
/opt/glassfish5/bin/asadmin restart-domain

Im Zuge der Aufrufe wird zunächst das bisherige Admin-Passwort eingefordert, das direkt nach der Installation leer ist. Dann wird das neue Passwort eingegeben.

Nach dieser Anpassung kann der Server per Browser über die URL https://serveradresse:4848 administriert werden.

Allerdings beklagt Firefox ein ungültiges Zertifikat, das per Ausnahme erlaubt werden muss.

Deployment

Mit dem folgenden Befehl können Sie eine Datei über die Konsole deployen:

/opt/glassfish5/bin/asadmin deplay meinpaket.war

Das bereitgestellte Paket ist anschließend über die URL http://hostname:8080/meinpaket erreichbar.

Sie können das Paket mit dem folgenden Befehl aus dem Deployment entfernen:

/opt/glassfish5/bin/asadmin undeplay meinpaket.war

Integration des Glassfish in Eclipse

Für eine gelungene Einbindung in Eclipse muss zuvor das Plugin Glassfish Toolsinstalliert werden.

Zuvor muss ggf die URL als Update Site angegeben werden. Dies erreicht man über Help | Install New Software, indem man die folgende URL einträgt: http://download.eclipse.org/glassfish-tools/1.0.0/repository.

Der Download kann auch über den Marktplatz Help | Eclipse Marketplace erfolgen. In bestimmten Versionsverhältnissen klappte dies allerdings nicht.

Hier sucht man nach dem Stichwort Glassfish und installiert.

Nun gibt es auch den Eintrag in File | New | Other für Server. Genau das rufen Sie auf: File | New | Other... Im Dialog Server aufklappen und das darin befindliche Server anwählen dann Next.

Im nächsten Dialog ist der Glassfish-Server bereits unter Glassfish jede installierte Glassfish-Version aufgelistet. Sie wählen Ihre Installation aus und klicken Next.

Im nächsten Dialog muss das Glassfish-Server Directory auf das Verzeichnis gesetzt werden, das bei der Installation angegeben wurde. In diesem Fall also /opt/glassfish4/glassfish. Das JDK muss auf 1.7 oder besser gesetzt werden. Next. Es gibt eine Fehlermeldung, wenn die Domain Directorys nicht beschreibbar sind. Das Deploy-Verzeichnis muss für Eclipse beschreibbar gemacht werden, das ja nun als Benutzer und nicht mit root-Rechten gestartet wird.

sudo -s
cd /opt/glassfish4/glassfish
chmod -R 777 domains

Noch einmal Back und Next und dann Finish und die Integration ist abgeschlossen.