GlassFish-Projekt – Erste Schritte

GlassFish Community

Erstellen des Projekts GlassFish V2.1.1
Informationen zu GlassFish V3 finden Sie auf den Build-Seiten HIER
Voraussetzungen für die Erstellung von GlassFish
Kurzanleitung
Umfassende Build-Anweisungen
GlassFish-Build mit NetBeans IDE
Erstellen von Branch aus
GlassFish Maven – Zielübersicht

Auf diesen Seiten wird die Erstellung von GlassFish V2 beschrieben.Hier finden Sie einige nützliche Links zum Übermitteln von Bugs oder zum Anfordern einer Funktion. Die Governance-Richtlinie finden Sie hier.

Umfassende Anweisungen zum Erstellen von GlassFish V2

GlassFish kann mit NetBeans oder mithilfe der Befehlszeilenoptionen erstellt werden.Der folgende Artikel enthält weitere Informationen zur Erstellung und Entwicklung des GlassFish-Projekts mit NetBeans.Nachfolgend finden Sie die Befehlszeilenoptionen zur Erstellung von GlassFish.

Voraussetzungen zur Erstellung von GlassFish.

Die Anwender müssen Maven (1.0.2) installiert haben. Damit wird das lokale Repository erstellt, in dem Maven GlassFish-Abhängigkeiten speichert.
Die Anwender müssen über einen Zugang zu java.net verfügen und auf das CVS-Repository für das GlassFish-Projekt zugreifen können.
Die Anwender müssen sich einmal beim GlassFish CVS-Repository anmelden (damit CVS das Kennwort in der Datei .cvspass im Stammverzeichnis des Anwenders speichert).
J2SE 5.0 (1.5.0_12) muss installiert und als JAVA_HOME-Umgebungsvariable sowie in Ihrem Binary-Pfad konfiguriert sein.Es wird empfohlen, die neueste Version zu verwenden.
Richten Sie den CVS-Client gemäß den java.net-Anweisungen ein.

Schritte zur Erstellung von GlassFish:

Der erste Schritt besteht aus der Prüfung der Modulabhängigkeiten und der im Build-System verwendeten, gemeinsamen Dateien sowie aus der Bearbeitung der Eigenschaftendatei.

% mkdir workspace
% cd workspace
% cvs -d :pserver:<Anwender-ID>@cvs.dev.java.net:/cvs checkout -r SJSAS91_FCS_BRANCH glassfish/bootstrap

Auf diese Weise werden project.xml, maven.xml, project.properties und die gemeinsamen, in project.xml aufgeführten Dateien ausgecheckt.

Erstellen Sie workspace/glassfish/bootstrap/build.properties. Bei einem wiederverwendbaren GlassFish-Arbeitsbereich erstellen Sie einmalig ${HOME}/build.properties (Unix) oder %HOMEPATH%\build.properties (Windows) und definieren die folgenden Variablen: (Sie erhalten den Wert %HOMEPATH% durch Ausführen des Befehls echo %HOMEPATH% oder durch Ausführen von "set" und Ermitteln der Variable HOMEPATH (Windows)).
Definieren Sie zwei GlassFish-Variablen namens glassfish.os.name, glassfish.cvs.username wie oben.
glassfish.os.name= <Betriebssystemname – mögliche Werte sind WINNT, SunOS, Linux, SunOS_X86, Darwin>
glassfish.cvs.username= <java.net-ID>

Beispiel für Windows XP Professional

glassfish.os.name=WINNT

glassfish.cvs.username=carlavmott

Checken Sie nun die Quellen aus.

% cd glassfish/bootstrap
% maven checkout

Bekannte Einschränkung: Einige der Quellen zur Erstellung von GlassFish stehen möglicherweise nicht sofort auf java.net zur Verfügung (Beispiel: MQ, ORB, JWSDP 2.0 etc.).Diese werden bis auf weiteres als Binary-Abhängigkeiten behandelt. (Informationen zur Verwendung von Binary-Abhängigkeiten finden Sie im nächsten Schritt.) Sie können mit dem folgenden Aufruf auch eine Untermenge der Module auschecken:

% maven checkout -Dmodules=[durch Komma getrennte Liste der Modulnamen]

Die Modulnamen finden Sie auf dieser Seite.

Erstellen Sie einen Bootstrap des Server-Image (eine Sammlung der Skripte und Jar-Dateien zur Ausführung von GlassFish). Der Entwickler kann die Option "bootstrap" auswählen, mit der der vordefinierte Server heruntergeladen und nur eine Untermenge der Module erstellt wird. Die andere Option "bootstrap-all" erstellt den Server von Grund auf neu. Außerdem werden alle Module erstellt, um die Versionsänderung im Zusammenhang mit modulübergreifenden oder Binary-Abhängigkeiten zu überprüfen.

Option bootstrap-all: Alle Module werden aus der Quelle erstellt.

% maven bootstrap-all

Option bootstrap: Erstellen eines eigenen Moduls mit dem vordefinierten Server

% maven bootstrap

Dieser Schritt ist optional, wenn Sie bereits einen hochgestuften Build von GlassFish installiert haben.Zur Verwendung des hochgestuften Builds müssen Sie die Eigenschaft unter glassfish/project.properties einstellen.

glassfish.image.version=<<Build-Version>>

Auf diese Weise "verweist" das Build-System auf diese Installation. Diese Eigenschaft kann auch ${HOME}/build.properties hinzugefügt werden.

Erstellen Sie den ausgecheckten Quellcode. Die Kompilierungsreihenfolge wird durch eine gemeinsame Konfigurationsdatei gesteuert, die in Schritt 2 weiter oben ausgecheckt wurde. In diesem Schritt wird das installierte Image am Ende der Kompilierung der einzelnen Module aktualisiert.

% maven build

Sie können mit dem folgenden Aufruf auch stets eine Untermenge der Module erstellen:

% maven build -Dmodules=[durch Komma getrennte Liste der Modulnamen]

oder wechseln Sie zu ../[Modulname] und rufen Sie Folgendes auf:

% maven build

Konfigurieren Sie die GlassFish Server-Laufzeitdatei.In diesem Schritt wird das asadmin-Skript erstellt und create-domain etc. ausgeführt, damit der GlassFish-Server ausgeführt werden kann.

% maven configure-runtime (Die Installation erfolgt standardmäßig im Hintergrund.)

Wenn Sie gemeinsame Konfigurationsinformationen angeben möchten (z. B. Port-Nummern etc.), verwenden Sie configure-runtime im Verbose-Modus.

% maven configure-runtime -Dinteractive

Sie müssen diesen Befehl im Allgemeinen nur einmal ausführen.Änderungen der Domain-Umgebung erfordern eine Neukonfiguration. Weitere Informationen finden Sie im Abschnitt zu häufig gestellten Fragen.Standardwerte zur Laufzeitkonfiguration finden Sie in glassfish/bootstrap/project.properties:

domain.name="domain1"
instance.name="server"
admin.user="admin"
admin.password="adminadmin"
admin.port="4848"
instance.port"="8080"
orb.port="3700"
imq.port="7676"
https.port="8181"

Das Maven-Ziel 'configure-runtime' erstellt eine Einzelinstanz-Domain, ähnlich GlassFish V1. Wenn Sie eine Cluster-Modus-Domain von GlassFish V2 erstellen möchten, führen Sie den folgenden Befehl aus:
% maven configure-cluster

Starten Sie den Server mit dem folgenden Befehl. Alle GlassFish-Server-Befehle befinden sich im Verzeichnis <glassfish.root>/publish/bin.Weitere Informationen zur Server-Verwaltung finden Sie in der Dokumentation zur Sun Java System Application Server PE-Serie der Version 8.Ein großer Teil dieser Dokumentation gilt auch für Version 9.Hinweis: Derzeit unterstützt GlassFish nur die Befehlszeilenoption für alle Plattformen.

% asadmin start-domain

Bereinigen des Servers

% maven clobber

Hiermit werden alle Skripte und Jar-Dateien zur Ausführung des Servers entfernt. Es werden alle Elemente unter glassfish.home entfernt. Anschließend müssen Sie wieder mit Schritt 2 beginnen.

Bereinigen von Build/Server: Sie können während der Entwicklung alle drei zuvor genannten Ziele verwenden. Aktualisieren Sie die Quellen mit Ihrer bevorzugten IDE und verwenden Sie einen der folgenden Befehle für einen bereits erstellten Arbeitsbereich, um diesen wieder in seinen Ausgangszustand zu versetzen und Ihre Änderungen erneut zu erstellen und zu überprüfen.

Wenn Sie die Module bereinigen möchten, um erzeugte Dateien (z. B. .class, .properties) zu löschen und die erneute Kompilierung vorzubereiten, führen Sie den folgenden Befehl aus:
```
% maven clean (oder maven -Dmodules=mail,activation clean)
```
Wenn Sie die in Schritt 5 weiter oben aufgeführte Server-Konfiguration bereinigen möchten, verwenden Sie den nachfolgenden Befehl, um den Server zu bereinigen und hierbei Administration Server, domain1 zu löschen und den Server wieder in den Installationszustand zu versetzen. (Löscht die neuen, durch Token ersetzten Dateien in den Konfigurationsverzeichnissen unter ${glassfish.home}/bin.)
```
% maven clean-config
```
Sie können "maven clean-config" verwenden, wenn Sie Ihre Änderungen zur Domain und zum Start des Administrations-Servers überprüfen möchten. Sie können das Ziel "clobber" verwenden, um den Server zu löschen und einen neuen Server zu erhalten. Sie können "clean" verwenden, um Build-Dateien zu löschen und die Kompilierung vorzubereiten.

Ausführen von QuickLook-Tests: QuickLook-Tests bieten dem Entwickler eine Möglichkeit zum Testen wichtiger Funktionen im Anwendungsserver und zur Durchführung einer Funktionsprüfung, um sicherzustellen, dass alle wichtigen Komponenten fehlerfrei sind.

Das Auschecken des erforderlichen Tests aus glassfish/appserv-tests schlägt wie nachfolgend beschrieben fehl.

% cd glassfish/bootstrap
% maven checkout-quicklook

Einstellen von APS_HOME. Dies ist das Verzeichnis, in das Sie den Arbeitsbereich einschließlich Arbeitsplatz-Stammnamen ausgecheckt haben (z. B. /workspace/appserv-tests)

Einstellen von S1AS_HOME. Dies ist das Installationsverzeichnis für den GlassFish-Server (z. B. /workspace/publish/glassfish)

Die Installationseigenschaften finden sich unter ${APS_HOME}/config.properties und ermöglichen die Anpassung an Ihre Installation (z. B. admin.password, http.portetc.). Wenn Sie Standardwerte geändert haben, bearbeiten Sie diese Datei config.properties.

Stellen Sie vor den Tests sicher, dass der Server NICHT ausgeführt wird. Stoppen Sie den Server, wenn er bereits ausgeführt wird.

Führen Sie den Test durch:

% cd $APS_HOME
% maven runtest

Öffnen Sie die Datei ${APS_HOME}/test_results.html in einem Browser und prüfen Sie die Ergebnisse.

Ausführliche Anweisungen zur Durchführung von QuickLook-Tests finden Sie HIER.

Bei Problemen finden Sie weitere Informationen in der GlassFish Build FAQ-Wiki.

IDE-Unterstützung

Erstellen und Entwickeln von GlassFish mit NetBeans 4.1.

Weitere Informationen finden Sie in den Arbeitsbereichrichtlinien und in den Erstellungsverfahren.Außerdem können Sie FishEye verwenden, um die Änderungen im Arbeitsbereich zu prüfen

Erstellen von Glassfish für V2.1, SGES21_FS_BRANCH :

Nachfolgend werden die Schritte zur Erstellung von GlassFish Branch beschrieben:
% mkdir workspace % cd workspace % cvs -d :pserver:<userid>@cvs.dev.java.net:/cvs checkout -r SGES21_FCS_BRANCH glassfish/bootstrap

Für glassfish/bootstrap/project.properties aus der Verzweigung SGES21_FCS_BRANCH wurde die Variable "glassfish.cvstag" auf "glassfish.cvstag=SGES21_FCS_BRANCH" gesetzt. Die FCS-Verzweigungsquellen werden ausgecheckt und entsprechend erstellt.

Definieren Sie zwei GlassFish-Variablen namens glassfish.os.name, glassfish.cvs.username wie oben.

Anschließend:
% cd glassfish/bootstrap % maven checkout bootstrap-all build configure-runtime

Sie können festlegen, welches Ziel in den zuvor genannten Befehlen zwischen bootstrap und bootstrap-all ausgeführt wird, indem Sie hier die Details prüfen.

GlassFish Maven – Zielübersicht:

Name des Ziels	In der Regel verwendeter Befehl	Beschreibung
bootstrap	maven -Dmodules=admin bootstrap checkout build	Laden Sie die Datei glassfish-image-SNAPSHOT.jar herunter und entpacken Sie diese unter ${glassfish.home}(Server-Image), um die einzelnen Module zu erstellen.
bootstrap-all	maven checkout bootstrap-all build	Installieren Sie ein leeres GlassFish-Image, das nur die Binary-Abhängigkeiten enthält. Laden Sie dann individuelle Binary-Abhängigkeiten herunter und entpacken Sie diese in ${glassfish.home}. Anschließend werden alle Module aus Quellen erstellt.
checkout	maven checkout	Auschecken eines Moduls
build	maven build	Erstellen des Moduls
configure-runtime	maven configure-runtime	Konfigurieren von ${glassfish.home} mit einer Einzelinstanz-Domain
configure-cluster	maven configure-cluster	Konfigurieren der Domain mit Clustering-Funktionen für GlassFish V2
clean	maven clean clobber	Bereinigen des Moduls
clobber	maven clobber	Bereinigt das GlassFish-Server-Image – löscht das Verzeichnis ${glassfish.home. Muss zusammen mit "bootstrap-all" verwendet werden, um ein neues Image zu erhalten und das beschädigte Server-Image zu bereinigen.
clean-config	maven clean-config	Bereinigt den Server. Löschen von domain1 und der durch Token ersetzten Dateien in bin,config
-Dmodules=	maven -Dmodules=admin bootstrap checkout build	Bereinigen/Auschecken/Erstellen nur bestimmter Module: maven -Dmodules={durch Komma getrennte Liste} Zielname