Table des matières

Guide d'installation et de configuration de Sun GlassFish Web Stack

Ce document décrit comment installer et configurer Sun GlassFish Web Stack et ses composants sur des plates-formes Solaris et Linux.

Introduction

Sun GlassFish Web Stack est une plate-forme d'applications Web en Open Source complet composée de Apache, lighttpd, MySQL, PHP, Tomcat, Glassfish, Ruby, et Python. Il est livré avec la prise en charge de la structure de mémoire cache (memcached), le débogage de trace dynamique (DTRace), Xdebug et la structure de sécurité PHP avancée (Suhosin).

Sun GlassFish Web Stack est disponible pour Solaris, OpenSolaris, et Red Hat Enterprise Linux.

Composants de Sun GlassFish Web Stack

Le tableau répertorie les principaux composants regroupés dans Sun GlassFish Web Stack.

Distributions de Sun GlassFish Web Stack

Sun GlassFish Web Stack est distribué sous deux versions différentes.

• Version de package natif : Il s'agit de la version non réadressable de la distribution Sun GlassFish Web Stack. Elle peut être installée uniquement dans les répertoires système spécifiés dans la section relative à la structure des répertoires de Sun GlassFish Web Stack. Ce guide traite de la version de package natif par défaut.
• Distribution de IPS/pkg(5) non fourni en standard : La distribution est basée sur Image Packaging System (IPS). Cette distribution peut être installée dans le répertoire de votre choix.

La distribution de l'IPS/pkg(5) non fourni en standard offre des avantages conséquents, qui sont :

• Installation non racine : prend en charge l'installation de Sun GlassFish Web Stack sans droits d'accès root ou d'administration.
• Installation réadressable : permet d'installer plusieurs copies de Sun GlassFish Web Stack sur le même système.
• Structure add-on simplifiée : mécanisme simplifié d'installation, de mise à jour et de désinstallation de composants.

Installation de Sun GlassFish Web Stack

Cette section traite de l'installation de Sun GlassFish Web Stack sur les plates-formes Solaris, OpenSolaris, et Linux.

Permissions d'utilisateur

Cette section décrit les permissions d'utilisateur requises pour l'installation de Sun GlassFish Web Stack.

Version de package natif

L'administration système ou les privilèges root sont nécessaire pour procéder à l'installation du package natif.

Distribution de IPS/pkg(5) non fourni en standard :

La distribution de IPS/pkg(5) non fourni en standard de Sun GlassFish Web Stack peut être installée sans les privilèges root ou d'administration. Si vous procédez à l'installation en tant qu'utilisateur root, la propriété de fichier et de répertoire ainsi que l'identité d'exécution correspondront à celles de l'installation du package natif (par ex., webservd pour Apache ou Lighttpd). Si l'ID utilisateur de démon requis n'existe pas encore, l'installation échouera et le système invitera l'utilisateur à la créer manuellement. Si vous procédez à l'installation en tant qu'utilisateur nonroot, tous les fichiers et répertoires appartiendront à l'utilisateur exécutant l'installation, qui définira également l'identité d'exécution.

Dépendances de système d'exploitation de Sun GlassFish Web Stack

Des dépendances spécifiques existent sur les plates-formes Solaris et Red Hat Enterprise Linux. Veuillez d'abord procéder à l'installation des packages dépendants. Le tableau suivant résume les dépendances des différents composants Sun GlassFish Web Stack.

Note La liste des dépendances n'est pas exhaustive. Seuls les packages importants y figurent.

Avertissement Le programme d'installation de la distribution de IPS/pkg(5) non fourni en standard de Sun GlassFish Web Stack est dans l'incapacité de vérifier les dépendances de système d'exploitation. Vous devez procéder à une vérification croisée avec le tableau des dépendances suivant et installer les packages dépendants requis avant de procéder à l'installation des composants Sun GlassFish Web Stack correspondants.

Note Sur la version Red Hat Enterprise Linux x86_64, Sun GlassFish Web Stack dépend également des versions 32 bits des packages répertoriés.

Installation de Sun GlassFish Web Stack sur les plates-formes Solaris et Linux

Pour installer Sun GlassFish Web Stack, procédez comme suit.

1. Téléchargez le package Sun GlassFish Web Stack à partir de la page de téléchargement de Sun GlassFish Web Stack, http://www.sun.com/systems/solutions/amp/getit.jsp. La page de téléchargement fournit des packages pour RedHat Enterprise Linux (x86 et x86_64) et Solaris (x86, x86_64, et Sparc). Téléchargez le package correspondant à votre plate-forme.
2. Extrayez le fichier tar.gz contenant le programme d'installation de Sun GlassFish Web Stack.

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

   Cette commande permet de développer les fichiers d'installation Web Stack dans le répertoire actuel ; il peut être préférable de procéder à cette étape dans un répertoire temporaire.

3. Pour commencer l'installation, exécutez le script d'installation. La liste des commandes disponibles du programme d'installation est présentée dans le tableau suivant.

Installation du serveur Sun GlassFish Enterprise.

Le serveur Sun GlassFish Enterprise est livré avec son propre programme d'installation et peut être installé à l'aide de l'assistant d'installation correspondant. Vous pouvez installer le serveur GlassFish Enterprise en exécutant le programme d'installation en mode interface graphique :

./sges-2_1-solaris-sparc.bin sur plate-forme Solaris SPARC

./sges-2_1-solaris-i586.bin sur plate-forme Solaris x86

./sges-2_1-linux.bin sur plate-forme Linux

Pour obtenir des informations plus détaillées, voir Guide d'installation du serveur GlassFish Enterprise 2.1 (en anglais).

Installation de Sun GlassFish Web Stack sur une plate-forme OpenSolaris.

Pour obtenir des informations sur l'installation de Sun GlassFish Web Stack sur une plate-forme OpenSolaris, voir Guide de démarrage de Web Stack pour OpenSolaris (en anglais)

Installation de la distribution de IPS/pkg(5) non livré en standard de Sun GlassFish Web Stack

La distribution de IPS/pkg(5) non livré en standard de Sun GlassFish Web Stack est fournie sous la forme d'une distribution réduite. Un jeu réduit de composants de base Web Stack est préinstallé. Les composants restants sont disponibles dans un répertoire se trouvant sur un réseau. La distribution Web Stack contient une interface de ligne de commande (pkg) qui permet d'installer des composants supplémentaires ou de mettre à jour les composants installés, et une interface graphique (updatetool), qui vous aide dans les tâches d'installation.

Configuration de la distribution de IPS/pkg(5) non livré en standard pour Sun GlassFish Web Stack

Pour configurer la distribution de IPS/pkg(5) non livré en standard de Sun GlassFish Web Stack, procédez comme suit.

1. Téléchargez le package de la distribution de IPS/pkg(5) non livré en standard de Sun GlassFish Web à partir de la page de téléchargement de Sun GlassFish Web Stack. http://www.sun.com/systems/solutions/amp/getit.jsp. La page de téléchargement fournit des packages pour RedHat Enterprise Linux (x86 et x86_64) et Solaris (x86, x86_64, et Sparc). Téléchargez le package correspondant à votre plate-forme.
2. Extrayez le fichier tar.gz contenant la distribution de IPS/pkg(5) non fourni en standard à l'emplacement que vous souhaitez.  

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

3. Modifiez l'emplacement en définissant le répertoire webstack-1.5 (si vous le souhaitez, renommez ce répertoire). Le même répertoire deviendra le répertoire d'installation pour tous les composants Sun GlassFish Web Stack. Vous pouvez déplacer ou renommer ce répertoire à votre guise. Ce répertoire contient les binaires importants suivants, que vous utiliserez pour gérer les composants Sun GlassFish Web Stack.
   • ./bin/pkg : Interface de ligne de commande pour la distribution de IPS/pkg(5) non livré en standard.
   • ./bin/updatetool : Interface graphique pour la distribution de IPS/pkg(5) non livré en standard.
   • ./bin/setup-webstack : utilitaire postinstallation pour la distribution de IPS/pkg(5) non livré en standard. Vous devez l'exécuter après l'installation des packages via l'interface de ligne de commande.

Note Pour installer et mettre à jour des packages à l'aide de la distribution de IPS/pkg(5) non livré en standard, vous avez besoin d'une connexion Internet en état de marche.

Utilisation de l'interface de ligne de commande de la distribution de IPS/pkg(5) non livré en standard

Vous pouvez utilisez la commande /bin/pkg pour installer les packages Sun GlassFish Web Stack à partir de la ligne de commande. Certaines des commandes principales sont présentées dans le tableau suivant.

Note Vous devez exécuter ./bin/setup-webstack après avoir exécuté la commande ./bin/pkg install.

Vous pouvez consulter la section Composants de Sun GlassFish Web Stack ou la liste de commandes -a pour obtenir la liste des noms de package valides.

Pour plus d'informations sur la commande pkg , voir la page de manuel pkg(5) et le centre de mise à jour Update Center Wiki.

Utilisation de l'interface graphique de la distribution de IPS/pkg(5) non livré en standard

La distribution de IPS/pkg(5) non livré en standard de Sun GlassFish Web Stack est livrée avec l'outil d'interface graphique appelé Update Tool. Update Tool peut être appelé à l'aide de la commande suivante :

./bin/updatetool 

L'outil de mise à jour permet de réaliser les tâches suivantes :

• Installer de nouveaux packages add-on
• Gérer les mises à jour de packages
• Afficher des informations sur les packages installés

Pour installer des packages, cliquez sur l'élément 'Add-ons disponibles' situé sur la barre latérale. Sélectionnez les packages que vous souhaitez installer et cliquez sur la flèche verte 'Installer'.

Pour mettre à jour les packages, cliquez sur l'élément 'Mises à jour disponibles' situé sur la barre latérale. Sélectionnez les packages que vous souhaitez mettre à jour et cliquez sur la flèche 'Mettre à jour'.

Pour plus d'informations sur l'outil de mise à jour, reportez-vous à l'aide en ligne. Accédez à l'aide en ligne en cliquant sur 'Aide > Contenus' de la barre de menu principale.

Mise à niveau vers Sun GlassFish Web Stack 1.5

Sun GlassFish Web Stack 1.5 contient un nombre important de solutions de débogage, de mise à jour de sécurité et de composants actualisés. Voir les Notes de version Sun GlassFish Web Stack 1.5 pour plus d'informations.

Utilisez la commande d'installation avec -u switch pour effectuer une mise à niveau automatique des packages installés de Sun GlassFish Web Stack.

./install -u 

Warning Les mises à jour effectuées à l'aide de l'outil de gestion du package système ne sont pas prises en charge et peuvent entraîner une corruption du programme.

Note Vous ne pouvez pas combiner les packages version 1.4 et 1.5. Vous devez mettre à niveau tous les composants installés.

Gestion des services Sun GlassFish Web Stack

Sun GlassFish Web Stack installe un certain nombre de services sur le système. Le tableau suivant répertorie les services Sun GlassFish Web Stack ainsi que leurs commandes de lancement/arrêt.

Démarrage automatique de services dans Linux

Dans Linux, le fait de démarrer ou d'arrêter un service entraîne le démarrage ou l'arrêt d'un service dans une session système donnée dans laquelle la commande a été exécutée. Pour démarrer automatiquement un service dans Linux, il doit être défini au niveau d'exécution par défaut du système.

Par exemple, pour définir le serveur Web Apache au niveau d'exécution 3 et 5, utilisez la commande suivante :

chkconfig --level 35 sun-apache22 on 

Structure de répertoires de Sun GlassFish Web Stack

Cette section présente la structure de répertoire des composants de Sun GlassFish Web Stack. Les fichiers de Sun GlassFish Web Stack sont installés dans trois répertoires différents :

OPT_ROOT : Répertoire d'installation d'application.

ETC_ROOT : Répertoire de configuration de l'application.

VAR_ROOT: Répertoire de données de l'application.

Les chemins des répertoires varient en fonction de la plate-forme. Le tableau suivant répertorie les emplacements de répertoire sur les plates-formes Solaris, Linux et OpenSolaris.

Fichiers de serveur HTTP Apache

La liste suivante décrit la structure de répertoires du serveur HTTP Apache et les modules plug-in complémentaires :

Modules mod_fcgid, mod_jk,mod_security, et mod_dtrace sont préinstallés avec le serveur HTTP Apache. Pour obtenir des informations sur ces modules, voir http://fastcgi.coremail.cn/doc.htm, http://tomcat.apache.org/connectors-doc/generic_howto/quick.html, http://www.modsecurity.org/documentation/index.html, et http://prefetch.net/projects/apache_modtrace/mod_dtrace.c

Fichiers de base de données MySQL

La liste suivante répertorie la structure de répertoires du serveur de base de données MySQL.

Fichiers PHP

La liste suivante décrit la structure de répertoires pour PHP :

Note Les extensions PHP telles que APC, DTrace, XDebug, suhosin, et tcpwrap  sont désactivées par défaut. Pour activer ces extensions, vous devez effacer les commentaires de la ligne correspondante (extensions=<module-name>.so) dans le fichier conf.d.

Fichiers Ruby

La liste suivante décrit la structure de répertoire pour Ruby :

Fichiers de serveur proxy Squid

La liste suivante décrit la structure de fichiers du serveur proxy Squid.

Ports réseau par défaut de Sun GlassFish Web Stack.

Sun GlassFish Web Stack utilise plusieurs ports réseau par défaut pour les opérations sur composants régulières. Le tableau suivant répertorie les ports par composant.

Extension de Sun GlassFish Web Stack

Sun GlassFish Web Stack peut facilement être étendu grâce à de nombreuses extensions tierces. Cela vous permet d'ajouter de nouvelles fonctions au logiciel existant. Pour compiler les extensions Sun GlassFish Web Stack, vous devez installer des packages de développement obligatoires sur votre système.

Exigences de compilateur :

Solaris 10 : Sun Studio 12 ou ultérieur.

Red Hat Enterprise Linux : RedHat avec prise en charge GCC à partir du répertoire de distribution.

Installation d'extensions PHP

Les extensions PHP sont disponibles sous deux formes, PECL (PHP Extension Community Library) et PEAR (PHP Extension and Application Repository). Les extensions PECL sont livrées en tant que code source C. Les extensions PECL sont des extensions compilées en langage C associées au noyau PHP. En tant que programmes C, les extensions PECL sont plus efficaces que les packages PEAR. PECL inclut des modules pour XML-analyse syntaxique, accès à des bases de données supplémentaires, courrier -analyse syntaxique, Perl ou Python intégré dans les scripts PHP.

Un package PEAR est distribué sous la forme d'un fichier TAR gzippé. Chaque archive est composée d'un code source écrit en PHP, généralement dans un style orienté sur l'objet. La plupart des packages PEAR sont prêt à être utilisés par les développeurs comme du code tiers ordinaire par l'inclusion simple d'instructions dans PHP.

Installation d'extensions PECL.

Les extensions PECL doivent être compilées en fichiers d'objet partagés (.so) avant d'être utilisées avec PHP.

La génération et l'installation de certaines extensions nécessitent des logiciels supplémentaires. L'installation d'une extension échoue si le logiciel supplémentaire ne se trouve pas dans PATH, et les messages d'erreur varient en fonction du logiciel requis et de l'extension en cours d'installation. Parmi les logiciels fréquemment requis figurent GNU Autoconf et re2c http://re2c.org/). 

Après l'installation de Sun Studio, exécutez la commande suivante pour télécharger, compiler et installer l'extension PECL :

 # OPT_ROOT/bin/pecl install <nom_extension> 

Si vous n'êtes pas sûr du nom de l'extension, utilisez la comande suivante pour obtenir une liste des extensions disponibles :

$ OPT_ROOT/bin/pecl list-all 

Installation d'extensions PEAR

Exécutez la commande suivante pour télécharger et installer l'extension PEAR :

# OPT_ROOT/bin/pear install <nom_extension> 

Installation d'extensions Python

Les extensions Python sont prise en charge par Easy Install. Easy Install est un module Python (easy_install) intégré aux outils de configuration qui vous permet de télécharger, construire, installer et générer automatiquement des packages Python. Easy_install est capable de télécharger et d'installer des extensions Python à partir du référentiel PyPI (Python Package Index)

Installation d'outils de configuration (easy_install)

Pour télécharger et installer les outils de configuration, utilisez les commandes suivantes. Pour compiler le package d'outils de configuration, Sun Studio doit être installé dans votre système. Vérifiez également que l'emplacement de Sun GlassFish Web Stack figure dans la variable système PATH. Vous éviterez ainsi les conflits avec l'installation de Python existante.

1. Téléchargez et extrayez le package source les outils de configuration Python sous http://pypi.python.org/pypi/setuptools#downloads. Téléchargez le fichier tar.gz (setuptools-0.6c9.tar.gz).
2. Pour compiler et installer le package d'outils de configuration, exécutez la commande suivante.

# python setup.py install 

Utilisation de easy_install

Easy-install est très facile d'utilisation. Utilisez simplement la commande suivante pour télécharger et installer l'extension Python.

# python easy_install.py <nom_package> 

Vous pouvez parcourir le référentiel PyPI en visitant http://pypi.python.org/pypi . 

Installation d'extensions Ruby (RubyGems)

Les extensions Ruby sont prises en charge par RubyGems. RubyGems est un gestionnaire de package pour le langage de programmation Ruby, qui fournit un format standard pour la distribution de programmes et de bibliothèques Ruby (dans un format autonome appelé « gem »), un outil conçu pour gérer facilement l'installation de gems, et un serveur destiné à leur distribution.

Utilisez la commande suivante pour installer l'extension Ruby (gem). Assurez vous que Sun GlassFish Web Stack figure dans la variable PATH.

# gem install <nom gem> 

Si vous n'êtes pas sûr du nom de gem, utilisez la commande suivante pour obtenir une liste de tous les gems disponibles :

# gem list -r -d 

Par exemple, lorsque vous installez le gem MySQL, les chemins vers les bibliothèques clientes MySQL 5.1 et les fichiers d'en-têtes doivent être fournis, comme suit :

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

Note Pour utiliser les gems, vous devez disposer d'un accès direct à Internet. Si votre système se trouve derrière un pare-feu ou utilise un serveur proxy, définissez la variable HTTP_PROXY .

Le répertoire référencé par GEM_HOME doit être accessible en écriture. Assurez-vous d'exécuter la commande suivante :

$ chmod -R a+w <GEM_HOME_PATH> 

Attention - Ne procédez pas aux tâches mentionnées précédemment, si GEM_HOME fait référence à $HOME/.gem.

Installation des extensions Apache

Les fonctions supplémentaires pour Apache sont disponibles sous la forme de modules plug-in issus de systèmes tiers. Elles peuvent être sous la forme d'un fichier source unique généré et installé par l'utilisateur exécutant apxs, ou d'une génération plus complexe prenant le chemin apxs comme argument de configuration.

Les modules sont générés individuellement pour Apache 32 bits ou 64 bits. (Une génération 64 bits de Apache n'est pas fournie pour Red Hat Enterprise Linux.)
Le compilateur utilisé par apxs doit être celui utilisé pour générer Apache. Sous OpenSolaris et Solaris 10, la commande cc se trouvant dans la variable PATH doit être Sun Studio. Si gcc est installé, il peut s'avérer nécessaire de manipuler la variable PATH pour indiquer d'abord Sun Studio. Sous Red Hat Enterprise Linux, gcc est utilisé.
Voici un exemple de génération de module dans laquelle les versions 32bits et 64 bits du module sont créées.

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

Cela créera mod_example.so dans les répertoires /var/apache2/2.2/libexec/mod_example.so et /var/apache2/2.2/libexec/64/mod_example.so.
La méthode recommandée pour charger et configurer le module est de créer un fichier dans /etc/apache2/2.2/conf.d avec les contenus suivants :

<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 

Les modules générés à l'aide d'un script de configuration fournissent généralement un --avec-apsx ou --avec -l'option apsx2. Indiquez le chemin d'accès à l'apsx 32bits ou 64bits, en fonction du mode requis.

Configuration avancée

Sun GlassFish Web Stack peut bénéficier des fonctions spécifiques du système d'exploitation Solaris telles que Solaris Zones, et DTrace. Pour plus d'informations, voir :

• Utilisation de Memcached avec Solaris Zones
• DTrace et Sun GlassFish Web Stack