Inhaltsverzeichnis

Sun GlassFish Web Stack Installations- und Konfigurationshandbuch

In diesem Dokument werden die Installation und die Konfigurierung von Sun GlassFish Web Stack und ihrer Komponenten auf Solaris- und Linux-Plattformen beschrieben.

Einleitung

Sun GlassFish Web Stack ist eine vollständige Open-Source-Webanwendungsplattform und setzt sich zusammen aus Apache, lighttpd, MySQL, PHP, Tomcat, Glassfish, Ruby und Python. Sie bietet den Support für Speichercaching (memcached), dynamisches Trace Debugging (DTrace), Xdebug und fortgeschrittenes PHP-Sicherheitssystem (Suhosin).

Sun GlassFish Web Stack ist verfügbar für Solaris, OpenSolaris und Red Hat Enterprise Linux.

Sun GlassFish Web Stack-Komponenten

In der Tabelle sind die primären Komponenten des Sun GlassFish Web Stack-Produktpakets aufgelistet.

Sun GlassFish Web Stack-Distributionen

Sun GlassFish Web Stack ist in zwei verschiedenen Distributionsversionen verfügbar.

• Native Package-Version: Dies ist die nicht verschiebbare Version der Sun GlassFish Web Stack-Distribution. Sie kann nur in den Systemverzeichnissen installiert werden, die im Abschnitt Sun GlassFish Web Stack-Verzeichnislayout aufgeführt sind. In diesem Handbuch wird standardmäßig die Native Package-Version behandelt.
• Unbundled IPS/pkg(5)-Distribution: Diese Distribution basiert auf dem Image Packaging System (IPS). Diese Distribution kann in einem von Ihnen frei gewählten Verzeichnis installiert werden.

Die Unbundled IPS/pkg(5)-Distribution bietet die folgenden wesentlichen Vorteile:

• Non-Root-Installation : Ermöglicht die Installation von Sun GlassFish Web Stack ohne Root- oder Administrator-Rechte.
• Verschiebbare Installation : Ermöglicht die Installation mehrerer Sun GlassFish Web Stack-Kopien auf dem gleichen System.
• Vereinfachtes Add-On-System : Vereinfachter Mechanismus bei der Installation, Aktualisierung und Deinstallation von Komponenten.

Installieren von GlassFish Web Stack

In diesem Abschnitt wird die Installation von Sun GlassFish Web Stack auf den Plattformen Solaris, OpenSolaris und Linux beschrieben.

Benutzerberechtigungen

In diesem Abschnitt werden die Benutzerberechtigungen erläutert, die zur Installation von Sun GlassFish Web Stack erforderlich sind.

Native Package-Version

Um die Installation der Native Package-Version durchzuführen, sind Systemadministrator- oder Root-Rechte erforderlich.

Unbundled IPS/pkg(5)-Distribution

Die Unbundled IPS/pkg) - Distribution von Sun GlassFish Web Stack kann mit oder ohne Administrator - oder Root-Rechte installiert werden. Wenn als Root-Benutzer installiert wird, stimmen Datei- und Verzeichniseigentumsrechte sowie die -Laufzeitidentität mit einer Native-Package-Installation überein (z. B. webservd für Apache oder Lighttpd). Wenn die erforderliche Daemon-Benutzer-ID noch nicht existiert, schlägt die Installation fehl und der Benutzer wird dazu aufgefordert, sie manuell zu erstellen. Wenn als Non-Root-Benutzer installiert wird, liegen die Eigentumsrechte für Dateien und Verzeichnisse bei dem Benutzer, der die Installation durchführt. Diese Identität wird dann auch als Laufzeitidentität verwendet.

Sun GlassFish Web Stack - Abhängigkeiten des Betriebssystems

Die Plattformen Solaris und Red Hat Enterprise Linux weisen plattformspezifische Abhängigkeiten auf. Installieren Sie zuerst die abhängigen Pakete. Die folgende Tabelle fasst die Abhängigkeiten für verschiedene Sun GlassFish Web Stack-Komponenten zusammen.

Hinweis Dies ist keine vollständige Liste der Abhängigkeiten. Nur die wichtigen Pakete sind hier aufgeführt.

Warnung Bei der Unbundled IPS/pkg(5)-Distribution des Sun GlassFish Web Stack-Installationsprogramms gibt es keine Möglichkeit, die Betriebssystemabhängigkeiten zu überprüfen. Sie müssen anhand der folgenden Abhängigkeiten-Tabelle eine Gegenprobe machen und alle erforderlichen abhängigen Pakete vor den jeweiligen Sun GlassFish Web Stack-Komponenten installieren.

Hinweis Bei der Version x86_64 von Red Hat Enterprise Linux ist Sun GlassFish Web Stack außerdem abhängig von der 32-Bit-Version der aufgelisteten Pakete.

Installieren von GlassFish Web Stack auf den Plattformen Solaris und Linux

Gehen Sie folgendermaßen vor, um Sun GlassFish Web Stack zu installieren

1. Laden Sie das Sun GlassFish Web Stack-Paket von der Sun GlassFish Web Stack-Download-Seite herunter http://www.sun.com/systems/solutions/amp/getit.jsp. Die Download-Seite bietet Pakete für RedHat Enterprise Linux (x86 und x86_64) und Solaris (x86, x86_64 und Sparc). Laden Sie das für Ihre Plattform relevante Paket herunter.
2. Extrahieren Sie die Datei tar.gz, die das Installationsprogramm für Sun GlassFish Web Stack enthält.

   gunzip -c xxx.tar.gz | tar xf - 

   Durch diesen Befehl werden die Web Stack-Installationsdateien in das aktuelle Verzeichnis expandiert. Wenn Sie möchten, können Sie diesen Schritt in einem temporären Verzeichnis ausführen.

3. Führen Sie das Installationsskript aus, um mit der Installation zu beginnen. Die folgende Tabelle zeigt die verfügbaren Befehle des Installationsprogramms.

Installieren des Sun GlassFish Enterprise-Servers

Der Sun GlassFish Enterprise-Server enthält sein eigenes Installationsprogramm und kann mithilfe des Installationsassistenten des GlassFish Enterprise-Servers installiert werden. Sie können den GlassFish Enterprise-Server installieren, indem Sie das Installationsprogramm im GUI-Modus ausführen:

./sges-2_1-solaris-sparc.bin auf der Plattform Solaris SPARC

./sges-2_1-solaris-i586.bin auf der Plattform Solaris x86

./sges-2_1-linux.bin auf der Linux-Plattform

Genauere Informationen finden Sie im Sun GlassFish Enterprise Server 2.1 Installationshandbuch.

Installieren von GlassFish Web Stack auf der Plattform OpenSolaris

Informationen zur Installation von Sun GlassFish Web Stack auf der Plattform OpenSolaris finden Sie im [Web Stack Getting Started Guide for OpenSolaris]

Installieren der Sun GlassFish Web Stack Unbundled IPS/pkg(5)-Distribution

Die Sun GlassFish Web Stack Unbundled IPS/pkg(5)-Distribution wird in Form einer minimierten Distribution geliefert. Ein kleiner Grundbestand an Web Stack-Komponenten ist vorinstalliert. Die verbleibenden Komponenten sind in einem netzwerkbasierten Repository verfügbar. Um zusätzliche Komponenten zu installieren oder installierte Komponenten zu aktualisieren, enthält die Web Stack-Distribution zur Hilfe bei der Installation sowohl eine Befehlszeilenschnittstelle (pkg) als auch eine grafische Benutzeroberfläche (updatetool).

Einrichten der Unbundled IPS/pkg(5)-Distribution für Sun GlassFish Web Stack

Gehen Sie folgendermaßen vor, um die Unbundled IPS/pkg(5)-Distribution für Sun GlassFish Web Stack einzurichten

1. Laden Sie das Paket Sun GlassFish Web Stack Unbundled IPS/pkg(5)-Distribution von der Sun GlassFish Web Stack-Download-Seite herunter http://www.sun.com/systems/solutions/amp/getit.jsp. Die Download-Seite bietet Pakete für RedHat Enterprise Linux (x86 und x86_64) und Solaris (x86, x86_64 und Sparc). Laden Sie das für Ihre Plattform relevante Paket herunter.
2. Extrahieren Sie die Datei tar.gz, die die Sun GlassFish Web Stack Unbundled IPS/pkg(5)-Distribution enthält, an eine beliebige gewünschte Position. 

   gunzip -c webstack-image-* | tar xf - 

3. Wechseln Sie in das Verzeichnis webstack-1.5 (Wenn Sie möchten, können Sie dieses Verzeichnis umbenennen). Dieses Verzeichnis wird zum Installationsverzeichnis für alle Sun GlassFish Web Stack-Komponenten. Sie können das Verzeichnis Ihren Wünschen entsprechend verschieben oder umbenennen. Dieses Verzeichnis enthält die folgenden wichtigen Binärdateien, die Sie verwenden, um Sun GlassFish Web Stack-Komponenten zu verwalten.
   • ./bin/pkg : Befehlszeilenschnittstelle für die Unbundled IPS/pkg(5)-Distribution.
   • ./bin/updatetool : Grafische Benutzeroberfläche für die Unbundled IPS/pkg(5)-Distribution.
   • ./bin/setup-webstack : Post-Installations-Dienstprogramm für die Unbundled IPS/pkg(5)-Distribution. Sie müssen es nach dem Installieren der Pakete über die Befehlszeilenschnittstelle ausführen.

Hinweis Um Pakete mit der Unbundled IPS/pkg(5)-Distribution zu installieren und zu aktualisieren, benötigen Sie eine funktionierende Internetverbindung.

Verwenden der Befehlszeilenschnittstelle der Unbundled IPS/pkg(5)-Distribution

Sie können den Befehl ./bin/pkg verwenden, um Sun GlassFish Web Stack-Pakete von der Befehlszeile aus zu installieren. Die folgende Tabelle zeigt einige wichtige Befehle des Installationsprogramms.

Hinweis Sie müssen ./bin/setup-webstack nach der Ausführung des Befehls {{./bin/pkg install}}ausführen.

Im Abschnitt Sun GlassFish Web Stack-Komponenten oder in der Befehlsliste -a finden Sie eine Liste gültiger Paketnamen.

Weitere Informationen zum Befehl pkg finden Sie auf der pkg(5)-Handbuchseite und im Update-Center-Wiki.

Verwenden der Benutzeroberfläche der Unbundled IPS/pkg(5)-Distribution

Die Sun GlassFish Web Stack Unbundled IPS/pkg(5)-Distribution wird mit einer Benutzeroberfläche geliefert, die auch als Updatetool bezeichnet wird. Updatetool kann durch folgenden Befehl aufgerufen werden:

./bin/updatetool 

Sie können mit Updatetool die folgenden Aufgaben durchführen:

• Neue Add-On-Pakete installieren
• Paketaktualisierungen verwalten
• Informationen zu den installierten Paketen anzeigen

Um Pakete zu installieren, klicken Sie auf das Element 'Verfügbare Add-Ons' auf der Seitenleiste. Wählen Sie die Pakete aus, die Sie installieren möchten, und klicken Sie auf den grünen 'Installieren'-Pfeil.

Um Pakete zu aktualisieren, klicken Sie auf das Element 'Verfügbare Aktualisierungen' auf der Seitenleiste. Wählen Sie die Pakete aus, die Sie aktualisieren wollen und klicken Sie auf den grünen 'Aktualisieren'-Pfeil.

Weitere Informationen zum Updatetool finden Sie in der Onlinehilfe. Zugang zur Onlinehilfe erhält man durch Anklicken von 'Hilfe > Inhalt' auf der Hauptmenüleiste.

Aufrüsten auf Sun GlassFish Web Stack 1.5

Sun GlassFish Web Stack 1.5 umfasst eine Reihe wichtiger Fehlerbehebungen, Sicherheitsaktualisierungen und aktualisierter Komponenten. Weitere Informationen finden Sie in den Sun GlassFish Web Stack 1.5 Versionshinweisen .

Sie können den Installationsbefehl mit -u-Schalter verwenden, um eine automatische Aktualisierung aller installierten Pakete von Sun GlassFish Web Stack durchzuführen.

./install -u 

Warnung Die Aufrüstung unter Verwendung des Systempaket-Verwaltungswerkzeugs wird nicht unterstützt und kann zur Beschädigung der Software führen.

Hinweis Sie können die Pakete der Versionen 1.4 und 1.5 nicht nebeneinander betreiben. Sie müssen alle installierten Komponenten aufrüsten.

Verwalten von Sun GlassFish Web Stack-Diensten

Mit Sun GlassFish Web Stack wird eine Reihe von Diensten auf dem System installiert. Die folgende Tabelle führt die Sun GlassFish Web Stack-Dienste und ihre Start-/Stopp-Befehle auf.

Automatisches Starten von Diensten unter Linux

Unter Linux führt das Starten oder Stoppen eines Dienstes lediglich dazu, dass der Dienst für diejenige Systemsitzung gestartet oder gestoppt wird, in der der Befehl ausgeführt wurde. Um einen Dienst unter Linux automatisch zu starten, muss er in den Standard-Runlevel des Systems eingegeben werden.

Um zum Beispiel Apache Webserver in Runlevel 3 und 5 einzugeben, können die folgenden Befehle verwendet werden:

chkconfig --level 35 sun-apache22 on 

Sun GlassFish Web Stack-Verzeichnislayout

In diesem Abschnitt wird das Verzeichnislayout von Sun GlassFish Web Stack-Komponenten vorgestellt. Sun GlassFish Web Stack-Dateien werden in drei verschiedenen Verzeichnissen installiert:

OPT_ROOT: Verzeichnis Anwendungsinstallation.

ETC_ROOT: Verzeichnis Anwendungskonfiguration.

VAR_ROOT: Verzeichnis Anwendungsdaten.

Die Verzeichnispfade sind von Plattform zu Plattform verschieden. Die folgende Tabelle führt die Verzeichnispositionen für die Plattformen Solaris, Linux und OpenSolaris auf.

Apache HTTP-Serverdateien

In der folgenden Liste wird das Verzeichnislyout für den Apache HTTP-Server und zusätzliche Plug-In-Module beschrieben:

Die Module mod_fcgid, mod_jk,mod_security und mod_dtrace werden mit dem Apache HTTP-Server vorinstalliert. Weitere Informationen zu diesen Modulen finden Sie unter http://fastcgi.coremail.cn/doc.htm, http://tomcat.apache.org/connectors-doc/generic_howto/quick.html, http://www.modsecurity.org/documentation/index.htmlund http://prefetch.net/projects/apache_modtrace/mod_dtrace.c

MySQL-Datenbankdateien

In der folgenden Liste wird das Verzeichnislayout für den MySQL-Datenbankserver beschrieben.

PHP-Dateien

In der folgenden Liste wird das Verzeichnislayout für PHP beschrieben:

Hinweis Die PHP-Erweiterungen, wie z. B. APC, DTrace, XDebug, suhosin}}und {{tcpwrap  sind standardmäßig inaktiviert. Um diese Erweiterungen zu aktivieren, müssen Sie die Kommentierung der entsprechenden Zeile (extensions=<module-name>.so) in der Datei conf.d entfernen.

Ruby-Dateien

In der folgenden Liste ist das Verzeichnislayout für Ruby beschrieben:

Squid Proxy-Server-Dateien

In der folgenden Liste wird das Verzeichnislayout für den Squid Proxy-Server beschrieben

Sun GlassFish Web Stack Standard-Netzwerkanschlüsse

Von Sun GlassFish Web Stack werden zum Betrieb der regulären Komponenten standardmäßig mehrere Netzwerkanschlüsse verwendet. In der folgenden Tabelle sind die Anschlüsse nach Komponenten aufgelistet.

Erweitern von Sun GlassFish Web Stack

Sun GlassFish Web Stack kann mittels Erweiterungen von Drittanbietern auf einfache Weise erweitert werden. Dies ermöglicht es Ihnen, der vorhandenen Software neue Funktionen hinzuzufügen. Um Sun GlassFish Web Stack-Erweiterungen zu kompilieren, müssen Sie obligatorische Entwicklungspakete auf Ihrem System installiert haben.

Anforderungen an den Compiler:

Solaris 10: Sun Studio 12 oder höher.

Red Hat Enterprise Linux: Von RedHat unterstützte GCC-Ausgabe aus dem Distributions-Repository.

Installieren von PHP-Erweiterungen

PHP-Erweiterungen sind in zwei Formen verfügbar: PECL (PHP-Erweiterung Community-Bibliothek) und PEAR (PHP-Erweiterung und Anwendungs-Repository). PECL-Erweiterungen werden als C-Quellcode geliefert. PECL-Erweiterungen sind als C-Spracherweiterungen kompiliert, die mit dem PHP-Kern verlinkt sind. Als C-Programme laufen PECL-Erweiterungen effizienter als PEAR-Pakete. PECL enthält Module für die XML-Syntaxanalyse, den Zugriff auf zusätzliche Datenbanken, Mail-Syntaxanalyse und das Einbetten von Perl oder Python in PHP-Skripte.

Ein PEAR-Paket wird als gzipped tar-Datei geliefert. Jedes Archiv besteht aus einem normalerweise in einem objektorientierten Stil in PHP geschriebenen Quellcode. Viele PEAR-Pakete können leicht von Entwicklern als gewöhnlicher Code Dritter durch einfache Include-Anweisungen in PHP verwendet werden.

Installieren von PECL-Erweiterungen

Die PECL-Erweiterungen müssen zu Dateien mit gemeinsam genutzten Objektdateien (.so) kompiliert werden, bevor sie mit PHP verwendet werden können.

Einige Erweiterungen erfordern zusätzliche Software, um erfolgreich erstellt und installiert zu werden. Das Installieren der Erweiterung schlägt fehl, wenn die zusätzliche Software nicht in PATH gefunden wird. Die Fehlermeldungen unterscheiden sich, je nach erforderlicher Software und Erweiterung, die installiert wird. Die zusätzliche Software, die üblicherweise erforderlich ist, umfasst GNU Autoconf und re2c (http://re2c.org/). 

Führen Sie den folgenden Befehl aus, um nach der Installation von Sun Studio die PECL-Erweiterung heruntrezuladen, zu kompilieren und zu installieren:

 # OPT_ROOT/bin/pecl install <extension name> 

Wenn Sie sich hinsichtlich des Erweiterungsnamens nicht sicher sind, können Sie mithilfe des folgenden Befehls eine Liste aller verfügbaren Erweiterungen aufrufen:

$ OPT_ROOT/bin/pecl list-all 

Installieren von PEAR-Erweiterungen

Führen Sie folgenden Befehl aus, um die PEAR-Erweiterung herunterzuladen und zu installieren:

# OPT_ROOT/bin/pear install <extension name> 

Installieren von Python-Erweiterungen

Python Erweiterungen werden von Easy Install unterstützt. Easy Install ist ein Python-Modul (easy_install), im Paket mit Setuptools, mit denen Sie Python-Pakete automatisch herunterladen, erstellen, installieren und verwalten können. Mit easy_install können Python-Erweiterungen aus dem PyPI-Repository (Python Package Index) heruntergeladen und installiert werden.

Installieren von Setuptools (easy_install)

Mit den folgenden Befehlen können Sie Setuptools herunterladen und installieren. Um das Setuptool-Paket zu kompilieren, muss Sun Studio in Ihrem System installiert sein. Stellen Sie außerdem sicher, dass der Speicherort von Sun GlassFish Web Stack in der PATH-Variable des Systems vorhanden ist. Dadurch werden alle Probleme mit der bestehenden Installation von Python vermieden.

1. Laden Sie das Python-Setuptools-Paket herunter und extrahieren Sie es von http://pypi.python.org/pypi/setuptools#downloads. Laden Sie die Datei tar.gz (setuptools-0.6c9.tar.gz) herunter.
2. Führen Sie den folgenden Befehl aus, um das Setuptools-Paket zu kompilieren und es zu installieren.

# python setup.py install 

Verwenden von easy_install

easy_install ist sehr einfach zu verwenden. Führen Sie lediglich folgenden Befehl aus, um die Python-Erweiterung herunterzuladen und zu installieren.

# python easy_install.py <package name> 

Sie können das PyPI-Repository durchblättern unter http://pypi.python.org/pypi . 

Installieren von Ruby-Erweiterungen (RubyGems)

Ruby-Erweiterungen werden von RubyGems unterstützt. RubyGems ist eine Paketverwaltung für die Ruby-Programmiersprache, die ein Standardformat für die Distribution von Ruby-Programmen und Bibliotheken bietet (in einem eigenständigen Format, das sich "Gem" nennt), ein Werkzeug, das entwickelt wurde, um die Installation von Gems leicht zu verwalten, und einen Server, um sie zu verteilen.

Verwenden Sie folgenden Befehl, um die Ruby-Erweiterung zu installieren (gem). Stellen Sie sicher, dass Sun GlassFish Web Stack sich in der PATH-Variable befindet.

# gem install <gem name> 

Wenn Sie sich hinsichtlich des Gem-Namens nicht sicher sind, können Sie mithilfe des folgenden Befehls eine Liste aller verfügbaren Gems aufrufen:

# gem list -r -d 

Wenn Sie z. B. das MySQL-Gem installieren, müssen die Pfade zu den MySQL 5.1 Client-Bibliotheken und Header-Dateien angegeben werden wie folgt:

# gem install mysql --with-mysql-include=/usr/mysql/5.1/include --with-mysql-lib=/usr/mysql/5.1/lib 

Hinweis Um Gem zu verwenden, müssen Sie direkten Zugang zum Internet haben. Wenn Ihr System sich hinter einer Firewall befindet oder wenn es einen Proxy-Server verwendet, legen Sie die Variable HTTP_PROXY fest.

Das Verzeichnis, auf das durch GEM_HOME verwiesen wird, sollte schreibbar sein. Achten Sie darauf, den folgenden Befehl auszuführen:

$ chmod -R a+w <GEM_HOME_PATH> 

Achtung - Führen Sie die zuvor erwähnten Aufgaben nicht aus, wenn GEM_HOME auf {{$HOME/.gem}}verweist.

Installieren von Apache-Erweiterungen

Zusätzliche Funktionen für Apache sind als Plug-In-Module über Drittanbieter erhältlich. Diese Module können einzelne Quelldateien sein, die vom Benutzer erstellt und installiert werden, indem er apxs oder einen komplexeren Build ausführt, der den Pfad nach apxs als ein Konfigurationsargument nimmt.

Die Module sind für 32-bit- oder zur 64-bit-Apache individuell erstellt. (Für Red Hat Enterprise Linux gibt es keinen 64-bit-Build.)
Der von apxs verwendete Compiler muss mit dem Compiler übereinstimmen, der zum Erstellen von Apache verwendet wurde. Auf OpenSolaris und Solaris 10 muss der in PATH gefundene CC-Befehl Sun Studio sein; wenn gcc installiert ist, müssen Sie möglicherweise PATH manipulieren, um zuerst auf Sun Studio hinzuweisen. Auf Red Hat Enterprise Linux wird gcc verwendet.
Hier sehen Sie ein Beispiel für einen Modul-Build, in dem sowohl 32-bit- als auch 64-bit-Versionen des Moduls erstellt werden:

$ pfexec /usr/apache2/2.2/bin/apxs -ci mod_example.c
$ pfexec /usr/apache2/2.2/bin/64/apxs -ci mod_example.c 

Auf diese Weise wird mod_example.so in den Verzeichnissen /var/apache2/2.2/libexec/mod_example.so und /var/apache2/2.2/libexec/64/mod_example.so erstellt.
Der empfohlene Weg, das Modul zu laden und zu konfigurieren, ist die Erstellung einer Datei in /etc/apache2/2.2/conf.d mit folgendem Inhalt:

<IfDefine 64bit>
LoadModule example_module /var/apache2/2.2/libexec/64/mod_example.so
</IfDefine>
<IfDefine !64bit>
LoadModule example_module /var/apache2/2.2/libexec/mod_example.so
</IfDefine>
#module configuration directives

Module, die unter Verwendung eines Konfigurationsskripts erstellt wurden, bieten üblicherweise a --mit-apxs oder --mit-apxs2-Option. Geben Sie den Pfad entweder zur 32-bit oder zur 64-bit apxs an, je nachdem, welcher Modus erforderlich ist.

Erweiterte Konfiguration

Sun GlassFish Web Stack kann den Vorteil spezieller Funktionen von Solaris OS, wie Solaris Zones und DTrace, nutzen. Weitere Informationen finden Sie unter:

• Verwenden von Memcaced mit Solaris Zones
• DTrace und Sun GlassFish Web Stack