Versionshinweise zu Sun GlassFish Enterprise Server 2.1

Kapitel 2 Info zu Sun GlassFish Enterprise Server

Enterprise Server &; ist ein mit der Java EE 5-Plattform kompatibler Server für die Entwicklung und Bereitstellung von Java EE-Anwendungen und auf Java-Technologie basierenden Webservices in großen Produktionsumgebungen.

Dieses Kapitel hat folgenden Inhalt:

Neues in Sun GlassFish Enterprise Server 2.1

Fehlerbehebungen und Verbesserungen – Die folgende Tabelle führt die in dieser Version behobenen Fehler auf.

Bug-ID 

Beschreibung 

6571044 

Domäne kann nicht gestartet werden, sunpkcs11.jar nicht vorhanden.

6165528 

Domänen, die in einem anderen custom-path als im Verzeichnis as-install/domains erstellt wurden, werden nicht direkt aktualisiert

Sun GlassFish Enterprise Server-Funktionen

Diese Funktionen wurden in Sun Java System Application Server 9.1 eingeführt. Sun GlassFish Enterprise Server umfasst die folgenden Funktionen:

Hardware- und Softwareanforderungen

In diesem Abschnitt sind die Anforderungen aufgelistet, die vor der Installation des Sun GlassFish Enterprise Server-Produkts erfüllt sein müssen.

Unterstützte Plattformen

In der folgenden Tabelle sind die Betriebssysteme aufgeführt, mit denen Sun GlassFish Enterprise Server 2.1 kompatibel ist.

Tabelle 2–1 Unterstützte Betriebssysteme

Betriebssystem 

Mindest-Arbeitsspeicher 

Empfohlener Arbeitsspeicher 

Mindest- festplatten- speicher 

Empfohlener Festplattenspeicher 

JVM 

Sun Solaris 9, 10 (SPARC) 

Solaris 9, 10 (x86) 

512 MB 

512 MB 

250 MB frei 

500 MB frei 

J2SE 5.0 

Java SE 6 

Sun Solaris 10, 64–Bit (SPARC, x86) 

512 MB 

512 MB 

250 MB frei 

500 MB frei 

J2SE 5.0 

Java SE 6 

RedHat Enterprise Linux 4.0, 5.x  

512 MB 

1 GB 

250 MB frei 

500 MB frei 

J2SE 5.0 

Java SE 6 

SuSE Linux Enterprise Server 10 SP1 

512 MB 

1 GB 

250 MB frei 

500 MB frei 

J2SE 5.0 

Java SE 6 

SuSE Linux Enterprise Server 10 SP1, 64–Bit 

512 MB 

1 GB 

250 MB frei 

500 MB frei 

J2SE 5.0 

Java SE 6 

Ubuntu Linux, Hardy-Version 

512 MB 

1 GB 

250 MB frei 

500 MB frei 

J2SE 5.0 

Java SE 6 

AIX 5.2, 5.3 

512 MB 

1 GB 

250 MB frei 

500 MB frei 

J2SE 5.0 

Windows Server 2000 SP4+ 

Windows 2000 Advanced Server SP4+ 

Windows Server 2003  

Windows XP Pro SP1+ 

Windows Vista 

1 GB 

2 GB 

500 MB frei 

1 GB frei 

J2SE 5.0 

Java SE 6 

Macintosh (Intel, Power) 

Nur für die Entwicklung unterstützt. 

512 MB 

512 MB 

250 MB frei 

500 MB frei 

Java SE 5 

OpenSolaris 

Nur Testsupport 

512 MB 

512 MB 

250 MB frei 

500 MB frei 

Java SE 5 

Java SE 6 


Hinweis –

Es wird empfohlen, das NTFS-Dateisystem anstelle von FAT oder FAT32 zu verwenden, wenn Sie Enterprise Server auf einer Microsoft Windows-Plattform ausführen.


Unter UNIXTM können Sie die Version Ihres Betriebssystems überprüfen, indem Sie den Befehl uname ausführen. Um den Festplattenspeicherplatz anzuzeigen, führen Sie den Befehl df aus.


Hinweis –

MacOS wird zwar nicht für die Produktion unterstützt, jedoch für Entwicklungszwecke. Informationen zum Herunterladen des Macintosh-Betriebssystems finden Sie auf der Downloadseite von GlassFish oder über die SDK-Seite, auf der Mac aufgeführt ist. Zum Beispiel auf der JavaEE 5 SDK Update 5-Downloadseite https://cds.sun.com/is-bin/INTERSHOP.enfinity/WFS/CDS-CDS_Developer-Site/en_US/-/USD/ViewProductDetail-Start?ProductRef=java_ee_sdk-5_05-nojdk-oth-JPR@CDS-CDS_Developer.


Unterstützung der Systemvirtualisierung

Bei der Systemvirtualisierung handelt es sich um eine Technologie, mit der mehrere Instanzen eines Betriebssystems auf einer gemeinsam genutzten Hardware unabhängig voneinander ausgeführt werden können. Auf der Funktionsebene erkennt die auf einem Betriebssystem in einer virtualisierten Umgebung bereitgestellte Software im Allgemeinen nicht, dass die zugrunde liegende Plattform virtualisiert wurde. Sun testet seine Sun Java System-Produkte auf ausgewählten Systemvirtualisierungs- und Betriebssystemkombinationen, um sicherzustellen, dass diese Produkte in virtualisierten Umgebungen mit zulässiger Größe und Konfiguration weiterhin so arbeiten wie auf nicht virtualisierten Systemen. Informationen zur Sun-Unterstützung für Sun Java System-Produkte in virtualisierten Umgebungen finden Sie unter System Virtualization Support in Sun Java System Products .

Wichtige Informationen zu Patches

Patch-Anforderungen für Solaris

Für Benutzer der Betriebssysteme Solaris 10 (x86 SPARC) wird empfohlen, das ?von Sun empfohlene Patch-Cluster” zu installieren. Dieses Patch-Cluster ist erhältlich unter ?Recommended and Security Patches” auf der Website SunSolve .

JDK-Version

Für Enterprise Server wird mindestens Version 1.5.0_14 von JDK erfordert (zertifiziert).

ProcedureSo wechseln Sie zur unterstützten Java SE-Version

Sie können durch Bearbeiten der Datei asenv zur unterstützten Java SE-Version wechseln, wie hier beschrieben.

  1. Wenn dies noch nicht erfolgt ist, installieren Sie die neue Java SE-Version auf Ihrem System.

    Java SE SDK kann von der Seite http://java.sun.com/javase

  2. Stoppen Sie Enterprise Server.

    • Über die Befehlszeile:

      install_dir/bin/asadmin stop-domain

    • Über die Administrationskonsole:

      1. Klicken Sie auf den Application Server-Knoten.

      2. Klicken Sie auf Instanz anhalten.

  3. Ändern Sie in der Datei Installationsverzeichnis/config/asenv.conf (unter Windows asenv.bat ) den Wert für AS_JAVA, sodass auf das neue Java-Basisverzeichnis verwiesen wird:

  4. Ändern Sie in der Datei as-install/samples/common.properties die Zeile, die mit com.sun.aas.javaRoot beginnt,. sodass sie auf das neue Java-Basisverzeichnis verweist.

  5. Starten Sie Application Server neu.

    • Über die Befehlszeile:

      as-install/bin/asadmin start-domain

    • Über die Administrationskonsole:

      1. Klicken Sie auf den Application Server-Knoten.

      2. Klicken Sie auf Instanz starten.

Apache Ant-Version

Version 1.6.5 von Apache Ant kommt auf allen Betriebssystemen im Paket mit &ProductName ausgenommen Ubuntu Linux. Version 1.7.0 von Apache Ant kommt im Paket mit Ubuntu Linux und wird mit Enterprise Server verwendet.

JDBC-Treiber und -Datenbanken

In Tabelle 2–2 sind Datenbanken und Treiber aufgeführt, welche die Java EE-Kompatibilitätsanforderungen erfüllen. Alle unterstützten Konfigurationen von Sun GlassFish Enterprise Server müssen mindestens eine Datenbank-/Treiberkombination aus dieser Tabelle enthalten, wie z. B. das Paket aus Java-DB-Datenbank und -Treiber. Darüber hinaus bietet Enterprise Server Unterstützung für JDBC-Konnektivität zu zusätzlichen DBMS mit entsprechendem JDBC-Treiber.

Tabelle 2–2 Java EE-kompatible JDBC-Treiber

JDBC-Treiberhersteller 

JDBC-Treibertyp 

Unterstützte Datenbank-Server 

Derby-Netzwerkclient 

Typ 4 

Derby 10.2 

DataDirect 3.6.x, 3.7.x

Typ 4 

Oracle 10g 

Oracle 9i 

Sybase ASE 15 

MS SQL 2005 

DB2 9.1 

DB2 8.2 

MySQL Connector/J Driver 5.1.6 

Typ 4 

MySQL 5.0 

Oracle 10G 

Typ 4 

Oracle 10g 

-RAC 

PostGres 

Typ 4 

8.2.x

In Tabelle 2–3 sind alle zusätzlichen Datenbanken und Treiber aufgeführt, für die in der Enterprise Server FCS-Version Unterstützung geplant ist.

Tabelle 2–3 Unterstützte JDBC-Treiber und -Datenbanken (Enterprise Server FCS)

JDBC-Treiberhersteller 

JDBC-Treibertyp 

Unterstützte Datenbank-Server 

Oracle OCI 

Typ 2 

Oracle 9i 

IBM DB2 

Typ 2 

DB2 9.1 

Im Allgemeinen unterstützt Enterprise Server 2.1 alle JDBC-Treiber, welche der Java EE-Spezifikation entsprechen.

Verwendung der gebündelten Java DB-Datenbank

In diesem Abschnitt werden Anweisungen zur Verwendung der Java DB-Datenbankanwendung in Kombination mit Enterprise Server 2.1 dargestellt. Java DB basiert auf der Apache Derby-Datenbank.

Starten und Anhalten der Java DB-Datenbank

In Sun GlassFish Enterprise Server werden zwei neue asadmin-Befehle zum Starten und Anhalten des Java DB-Netzwerkservers eingeführt.

Java DB-Dienstprogrammskripts

Die im Lieferumfang von Enterprise Server 2.1 enthaltene Java DB-Konfiguration umfasst Skripts, die Sie bei der Verwendung von Java DB unterstützen können. Die folgenden Skripts können im Verzeichnis as-install/javadb/bin verwendet werden:

ProcedureSo konfigurieren Sie Ihre Umgebung zur Ausführung der Java DB-Dienstprogrammskripts:

  1. Stellen Sie sicher, dass die JAVA_HOME-Umgebungsvariable das Verzeichnis angibt, in dem das JDK installiert ist.

  2. Legen Sie fest, dass die Umgebungsvariable DERBY_HOME auf das Verzeichnis as-install/javadb verweist.

Siehe auch

Weitere Informationen zu diesen Dienstprogrammen finden Sie in der folgenden Derby-Dokumentation:

Versionen von Message Queue

Message Queue 4.3 ist für dateibasierte Installationen mit Enterprise Server gebündelt. Für Installationen auf Basis von UNIX-Paketen wird Message Queue 4.1.1 angeboten. Dieses Produkt bietet die gleichen Funktionen wie 4.3. Trotz der Versionsnummerierung ist Message Queue 4.1.1 mit Message Queue abwärtskompatibel.

Der eingebettete Sun GlassFish Message Queue-Code, der als Bestandteil von Enterprise Server geliefert wird, wird üblicherweise nur an einer entsprechenden Version von Message Queue Broker getestet und zertifiziert. Das bedeutet, dass die Verwendung des gelieferten eingebetteten Message Queue-Codes zum Herstellen einer Verbindung mit einem Remote-Message Queue-Broker (ohne Verwaltung durch Enterprise Server), auf dem eine andere Version des Message Queue-Codes läuft, nicht unterstützt wird.

Webserver

In diesem Abschnitt werden die Webserver aufgeführt, die für Sun GlassFish Enterprise Server unterstützt werden.

Tabelle 2–4 Unterstützte Webserver

Web Server 

Version 

Betriebssystem 

Sun Java System Web Server (32–Bit) 

6.1, 7.0 

Solaris SPARC 8, 9, 10  

Solaris x86 9, 10

Red Hat Enterprise Linux 2.1 Update 2, 3.0 Update 1 

Apache Web Server (32–Bit) 

2.0.x, 2.2.x 

Solaris SPARC 9, 10 

Solaris x86 10

Red Hat Enterprise Linux 2.1 Update 2, 3.0 Update 1 

Microsoft IIS (32–Bit) 

5.0+ 

Windows Server 2003 

Windows 2000 Advanced Server Service Pack 4+ 

Es werden nur 32-Bit-Plattformen unterstützt.

Browser

In diesem Abschnitt werden die Browser aufgelistet, die für Sun GlassFish Enterprise Server 2.1 unterstützt werden.

Tabelle 2–5 Unterstützte Webbrowser

Browser 

Version 

Mozilla 

1.7.12 

Internet Explorer 

6.0 Service Pack 2, 7.0 

Firefox 

1.5.x, 2.x

Safari 

Netscape 

8.0.4, 8.1, 9.0, 9.0.x

HADB-Anforderungen und unterstützte Plattformen

Neben den unter Hardware- und Softwareanforderungen aufgelisteten Anforderungen müssen Sie sicherstellen, dass Ihr System die unten zum Ausführen von HADB aufgelisteten Anforderungen erfüllt.


Hinweis –

HADB wird nur mit dem Enterprise Server 2.1 Enterprise-Profil gebündelt. Beachten Sie ferner, dass die Java-Komponenten des Systems mit JDK 5 erstellt und mit JDK 1.5 getestet wurden.


Unterstützte Plattformen

Anforderungen an den Host für den HADB-Server


Hinweis –

Stellen Sie sicher, dass das Schreibcaching auf Geräten deaktiviert ist, auf denen HADB-Daten- und Protokolldateien gespeichert werden. Das Schreibcaching ist auf einigen Solaris-Plattformen standardmäßig aktiviert; zum Beispiel Solaris x86.


Anforderungen an den Host für das HADB-Management

Anforderungen an den Host für den HADB-Client

Upgrade von Enterprise Server

Vollständige Anleitungen zum Upgrade von einer früheren Version von Enterprise Server auf die aktuelle Version finden Sie im Sun GlassFish Enterprise Server 2.1 Upgrade guide.

Weitere Anforderungen

Die folgenden weiteren Anforderungen müssen erfüllt sein, bevor die Software Sun GlassFish Enterprise Server installiert wird.

APIs der Java EE 5-Plattform

Sun GlassFish Enterprise Server 2.1 unterstützt die Java EE 5-Plattform. In der folgenden Tabelle sind die erweiterten APIs aufgelistet, die auf der Java EE 5-Plattform verfügbar sind.

Tabelle 2–6 Wesentliche API-Änderungen auf der Java EE 5-Plattform

API 

JSR 

Java EE 5

Java Platform, Enterprise Edition 5

JSR 244

Webservice-Technologien

Implementierung von Enterprise-Webservices 

JSR 109

Java API for XML-Based Web Services (JAX-WS) 2.0

JSR 224

Java API for XML-Based RPC (JAX-RPC) 1.1

JSR 101

Java Architecture for XML Binding (JAXB) 2.0

JSR 222

SOAP with Attachments API for Java (SAAJ)

JSR 67

Streaming API for XML

JSR 173

Webservice-Metadaten für die Java-Plattform 

JSR 181

Komponentenmodelltechnologien

Enterprise JavaBeans 3.0

JSR 220

J2EE Connector Architecture 1.5

JSR 112

Java Servlet 2.5

JSR 154

JavaServer Faces 1.2

JSR 252

JavaServer Pages 2.1

JSR 245

JavaServer Pages Standard Tag Library 1.2

JSR 52

Verwaltungstechnologien

J2EE Management

JSR 77

J2EE Application Deployment

JSR 88

Java Authorization Contract for Containers

JSR 115

Andere Java EE-Technologien

Allgemeine Annotationen für die Java-Plattform 

JSR 250

Java Transaction API (JTA)

JSR 907

JavaBeans Activation Framework (JAF) 1.1

JSR 925

JavaMail

JSR 919

Java Message Service API

JSR 914

Java Persistence API

JSR 220

Java EE 5 SDK

Sun GlassFish Enterprise Server 2.1 ist als Bestandteil von Java EE 5 SDK verfügbar.

Es gibt zwei Java EE 5 SDK-Versionen:

Darüber hinaus können Sie diese SDK-Distributionen mit dem JDK oder mit den NetBeans 5.5.1-Tools herunterladen. Weitere Informationen finden Sie auf der Download-Seite unter http://java.sun.com/javaee/downloads/index.jsp.


Hinweis –

GlassFish v2.1 und Enterprise Server 2.1 können nicht mit NetBeans 5.5 zum Entwickeln von Java EE-Anwendungen verwendet werden. Sie müssen NetBeans 5.5.1 verwenden.


Wechsel zu einer anderen unterstützten Java-Version

Sun GlassFish Enterprise Server 2.1 erfordert Java SE 5.0 oder höher als zugrunde liegende JVM. Wenn Sie von einer Java-Version zu einer anderen wechseln möchten, müssen Sie folgende allgemeine Schritte durchführen. (Windows und Unix)


Hinweis –

Ein Downgrade auf eine frühere Java-Version wird nicht empfohlen, nachdem eine Domäne mit einer neueren Java VM erstellt wurde. Wenn Sie ein Downgrade für Ihre JVM durchführen müssen, sollte dies auf Domänenbasis erfolgen. Im Folgenden werden die erforderlichen Schritte beschrieben:


ProcedureSo wechseln sie zu einer anderen unterstützten Java-Version

  1. Laden Sie das gewünschte Java SDK (nicht die JRE) herunter, und installieren Sie es auf Ihrem System – sofern noch nicht geschehen.

    Java SDK kann von folgenden Websites heruntergeladen werden: http://java.sun.com/j2se.

  2. Starten Sie die Domäne, für die Sie das JDK ändern möchten:


    as-install/bin/asadmin start-domain domain-name
    
  3. Melden Sie sich an der Administrationskonsole an, und ändern Sie die JVM-Attribute für die Domäne.

    Sie sollten insbesondere die JAVA_HOME-Variable auf der Seite mit den JVM-Einstellungen für die Domäne ändern.

    Alternativ können Sie den Befehl asadmin verwenden:


    as-install/bin/asadmin set "server.java-config.java-home=Path-To-Java-Home"

Bekannte Kompatibilitätsprobleme in Java ES 5

Es bestehen zwei Kompatibilitätsprobleme zwischen Enterprise Server 2.1. und Java ES 5 (JES 5) bekannt.

  1. Die JES5 Service Registry ist aufgrund der JSF 1.2-Version, die &ProductName 2.1. bereitstellt, nicht mit Enterprise Server 2.1 kompatibel. Die Service Registry muss auf JES5u1 aufgerüstet werden, bevor Enterprise Server auf 2.1 aufgerüstet wird. Diese Einschränkung wird auch in der Service Registry-Dokumentation dargestellt.

  2. Der JES5 Portal Server ist aufgrund der von Enterprise Server bereitgestellten JSF 1.2-Version nicht mit Enterprise Server 2.1 kompatibel. Portal Server muss auf JES5u1 aufgerüstet werden, bevor der Upgrade auf 2.1 erfolgt.

    In einem Java ES 5-Setup, in dem Portal Server auf Enterprise Server 8.2 vorliegt, wird der Portal Server durch einen Upgrade von ProductName 8.2 auf 2.1 unbrauchbar. Enterprise Server 2.1 verwendet JSF 1.2, aber die JSF-Portlet-Brücke in Release 5 Portal Server unterstützt JSF 1.2 nicht. Unter Solaris/Linux muss der Portal Server auf JavaES5 Update 1 aufgerüstet werden. Führen Sie unter Windows keinen Upgrade von Enterprise Server auf 2.1 aus, wenn Sie den Release 5 Portal Server weiterhin verwenden möchten, da Portal Server in Java ES 5 Update 1 unter Windows nicht unterstützt wird.

Funktionen, die nicht unter allen Betriebssystemen unterstützt werden

Einige Funktionen von Enterprise Server werden nicht unter allen Betriebssystemen unterstützt. In den folgenden Unterabschnitten finden Sie Einzelheiten zu diesen Funktionen.

Funktionen, die unter AIX-Betriebssystemen nicht unterstützt werden

Wenn Sie ein AIX-Betriebssystem verwenden, gelten folgende Einschränkungen:

Funktionen, die unter Linux-Betriebssystemen nicht unterstützt werden

Wenn Sie ein Linux-Betriebssystem verwenden, gelten folgende Einschränkungen:

Funktionen, die unter Ubuntu-Betriebssystemen nicht unterstützt werden

Wenn Sie das Ubuntu Linux-Betriebssystem verwenden, gelten die folgenden Einschränkungen:

Verwenden des Update-Centers

Das Update-Center bietet automatisierte Enterprise Server-Updates sowie einen einfachen Zugang zu zusätzlichen Komponenten.

Wenn das Update-Center aktiviert ist, werden automatisierte Software-Updates durchgeführt. Bei diesem automatisierten Update-Prozess erfasst das Update-Center die folgenden Daten, um diese an Sun Microsystems (oder seinen Service-Provider) zu übermitteln:

Es werden keine persönlich identifizierbaren Informationen nachverfolgt. Es werden keine persönlich identifizierbaren Informationen mit anderen Daten verknüpft oder für Reporting-Zwecke verwendet.

ProcedureSo verwenden Sie das Update-Center

Um eine explizite Einwilligung für die automatisierten Updates sicherzustellen, ist das Update-Center standardmäßig deaktiviert. Zum Aktualisieren des Update-Centers für periodische Prüfungen und automatisierte Updates führen Sie die folgenden Schritte aus:

  1. Starten Sie das Update-Center.

    • Unter Unix: as-install/updatecenter/bin/updatetool

    • Unter Windows: as-install\updatecenter\bin\updatetool.bat

  2. Wählen Sie die Registerkarte "Einstellungen".

  3. Ändern Sie im Fenster "Update-Planung" den Wert im Dropdown-Listenfeld "Nach Updates suchen" von "Nie (Manuell)" in einen gewünschten Wert. Lege Sie z. B. tägliche oder wöchentliche Prüfungen fest.

  4. Geben Sie den gewünschten Wochentag und die Uhrzeit für das Update an.

  5. Klicken Sie auf "Speichern", um die Änderungen zu speichern.

    Das Update-Center prüft nun gemäß dem festgelegten Zeitplan automatisch, ob Updates für SailFin- oder Enterprise Server-Komponenten verfügbar sind. Wenn ein Update verfügbar ist, wird das Update-Center gestartet, und Sie erhalten Informationen zur Komponente, die aktualisiert werden kann.

Upgrading von Enterprise Server auf Ubuntu-Betriebssystemen

Auf Ubuntu Linux-Betriebssystemen führt das Installieren von GlassFish v2 nicht dazu, dass vorhandene Installationen von GlassFish v1 ersetzt werden. Das Skript asadmin in /usr/bin übernimmt die Verwaltung von GlassFish v2. Um GlassFish v1 zu verwalten, verwenden Sie das lokale Dienstprogramm asadmin in /usr/share/sunappserver/bin. Für ein Upgrade der v1-Domäne auf v2 verwenden Sie das Tool asupgrade in /usr/share/glassfishv2/bin.

Wenn mithilfe des globalen Skripts asadmin eine v1-Domäne gestartet wird, wird das Upgrade-Tool automatisch aufgerufen. Dies führt jedoch zu einem Fehler. Ursache dafür ist ein Programmierfehler, der den standardmäßigen Domänenspeicherort des Servers für andere Plattformen (keine Ubuntu-Plattformen) verwendet. Um diesen Fehler zu vermeiden, verwenden Sie stattdessen das Tool asupgrade.

Aktivieren von vorab durchgeführten Abrufvorgängen für Beziehungen auf mehreren Ebenen

Vorab durchgeführte Abrufvorgänge für Informationen zu Beziehungen auf mehreren Ebenen werden für CMP 2.1-Entity-Beans unterstützt.

Zum Aktivieren der vorab durchgeführten Abrufvorgänge für Beziehungen auf mehreren Ebenen setzen Sie die folgende Eigenschaft:


-Dcom.sun.jdo.spi.persistence.support.sqlstore.MULTILEVEL_PREFETCH=true

Weitere Informationen zu diesem Thema finden Sie unter Relationship Prefetching in Sun GlassFish Enterprise Server 2.1 Developer’s Guide.

Weitere Informationen zur WSIT-Integration

Detaillierte Informationen zum WSIT-Status finden Sie auf der Seite WSIT Status Notes . Auch das The WSIT Tutorial umfasst Informationen zur Verwendung von WSIT mit Enterprise Server.