![]() | |
Sun Java System Application Server Enterprise Edition 8.1 2005Q1 |
Guide de démarrage rapide
Bienvenue dans le Guide de démarrage rapide de Sun Java System Application Server Enterprise Edition 8.1 2005Q1. Ce guide s’adresse aux développeurs, administrateurs système et administrateurs d’Application Server souhaitant découvrir les possibilités du logiciel Sun Java System Application Server Enterprise Edition 8.1 2005Q1.
Pour obtenir la dernière version de ce document, consultez la version en ligne disponible sur le site docs.sun.com à l'adresse :
http://docs.sun.com/app/docs/prod/sjs.asse
Il présente les étapes de base et les étapes avancées pour l’utilisation d’Application Server. Ces étapes sont décrites dans l’ordre où elles doivent être exécutées. Les étapes de base, qui nécessitent généralement moins de 45 minutes, sont traitées dans les sections suivantes :
Les étapes avancées, qui exigent environ 45 minutes, sont traitées dans les sections suivantes :
Les dernières sections de ce guide sont les suivantes : Nettoyage et Autres ressources.
Le tableau ci-dessous répertorie les noms de variable et les chemins d’accès par défaut des répertoires cités dans ce guide. Les noms de variable sont situés dans la première colonne alors que les chemins d’accès par défaut apparaissent dans la deuxième colonne.
À propos de l’administration d’Application ServerPour permettre aux administrateurs de gérer les instances de serveur et les clusters exécutés sur plusieurs hôtes, Application Server propose les outils suivants :
Ces outils se connectent à un serveur appelé serveur d’administration du domaine, instance Application Server spécialement désignée pour intervenir dans toutes les tâches d’administration. Le serveur d’administration du domaine offre une interface unique sécurisée pour la validation et l’exécution des commandes administratives, indépendamment de l’interface utilisée.
Un domaine constitue un ensemble de données de configuration, d’applications déployées et de machines avec un administrateur désigné. La définition du domaine décrit et permet de contrôler le fonctionnement de plusieurs applications, instances de serveur d’application autonomes et clusters, qui peuvent être répartis sur plusieurs machines. Lors de l’installation du serveur d’administration du domaine, un domaine par défaut appelé domain1 est toujours installé. Dans ce guide, vous travaillerez dans le domaine par défaut.
Pour effectuer la plupart des tâches présentées dans ce guide, vous ferez appel à la console d’administration.
Démarrage du serveur d’administration du domaineCette rubrique, la première des trois rubriques de base, comprend les étapes suivantes :
Démarrage du serveur d’administration
Pour démarrer le serveur d’administration, procédez comme suit :
- Ajoutez le répertoire rép_install/bin/ à la variable d’environnement PATH :
C Shell :
setenv PATH rép_install/bin:$PATH
Bourne Shell :
PATH=rép_install/bin:$PATH
export PATH- Définissez la variable d’environnement relative à l’utilisateur administrateur, afin de ne pas devoir la retaper à chaque commande :
C Shell :
setenv AS_ADMIN_USER utilisateur_admin
Bourne Shell :
AS_ADMIN_USER=utilisateur_admin
export AS_ADMIN_USER- Démarrez le serveur en entrant la commande suivante à partir du répertoire rép_install :
asadmin start-domain domain1
Lorsque vous êtes invité à entrer le mot de passe de l'administrateur et le mot de passe principal, entrez les mots de passe saisis lors de l'installation.
- Un message vous informant du démarrage du serveur d’administration du domaine s’affiche :
Démarrage du domaine domain1. Veuillez patienter. Journal redirigé vers rép_domaine/domain1/logs/server.log...- Lorsque le processus de démarrage est terminé, le message suivant s’affiche :
Le domaine domain1 a démarré.
Connexion à la console d’administration
La console d’administration est une interface de navigation qui simplifie un certain nombre de tâches d’administration et de configuration. Elle est généralement utilisée pour effectuer les opérations suivantes :
- déployer des applications et annuler leur déploiement ;
- activer, désactiver et gérer les applications ;
- configurer les ressources et d’autres paramètres de serveur ;
- configurer les clusters et les agents de nud ;
- gérer les instances de serveur et les clusters ;
- sélectionner et afficher les fichiers journaux.
Pour plus d’informations sur l’utilisation de la console d’administration, consultez l’aide en ligne ou le manuel Sun Java System Application Server Enterprise Edition 8.1 2005Q1 Administration Guide.
Pour vous connecter à la console d’administration :
- saisissez l’adresse suivante dans votre navigateur :
https://hôtelocal:4849/asadmin
Comme la console d’administration est une application Web sécurisée, vous devez indiquer https au lieu de http.
Remplacez la variable hôtelocal par le nom du système sur lequel le serveur d’administration du domaine est exécuté.
4849 correspond au numéro de port par défaut de la console d’administration. Si vous avez changé le numéro de port au cours de l’installation, utilisez le nouveau numéro à la place.
- Lorsque la fenêtre de connexion s’affiche, entrez le nom d’administrateur et le mot de passe.
- Cliquez sur Connexion.
La console d’administration qui apparaît se présente comme suit :
Dans le volet de gauche, vous sélectionnez les éléments à gérer dans l’arborescence proposée. Dans le volet de droite, différentes tâches d’administration sont proposées sous l’en-tête « Tâches courantes ».
Astuce
Cliquez sur l’onglet Enregistrement pour enregistrer le logiciel si vous ne l’avez pas encore fait.
Examen du fichier journal
Les instances d’Application Server et le serveur d’administration du domaine génèrent des fichiers journaux annotés dans le système de fichiers. Par défaut, les erreurs, les avertissements ou les messages d’informations utiles sont tous consignés. Pour consulter le fichier journal du serveur d’administration :
- Dans la liste « Tâches courantes » du volet de droite, cliquez sur « Rechercher les fichiers journaux » afin d’ouvrir une nouvelle fenêtre de navigateur pour le visionneur de journaux.
- Dans la fenêtre du visionneur de journaux, sélectionnez un serveur dans la liste déroulante Nom d’instance et cliquez sur Rechercher. Les dernières entrées du fichier journal du serveur d’administration du domaine s’affichent.
- Parcourez les messages et recherchez les messages AVERTISSEMENT ou GRAVE indiquant que des problèmes ont été détectés lors du démarrage du serveur.
Vous pouvez fermer le visionneur de journaux à tout moment. Après avoir créé les clusters et déployé les applications, consultez les fichiers journaux si l’une ou l’autre des opérations ne s’est pas déroulée correctement. Le visionneur de journaux permet de consulter les fichiers journaux de n’importe quelle instance Application Server en cours d’exécution dans le domaine.
Pour plus d’informations sur le fichier journal, reportez-vous au manuel Sun Java System Application Server Enterprise Edition 8.1 2005Q1 Administration Guide.
Dans cette section, vous avez démarré le serveur d’administration du domaine et vérifié qu’il fonctionnait. Vous vous êtes également connecté à la console d’administration et avez utilisé le visionneur de journaux. Vous pouvez interrompre ici le parcours Démarrage rapide si vous ne souhaitez pas continuer.
Création d’un clusterCette section, la deuxième des trois sections de base, explique comment créer un cluster contenant deux instances Application Server. Pour plus de facilité, le cluster fonctionne au sein d’une seule machine. Cette rubrique comprend les sections suivantes :
Démarrage de l’agent de nud
Un agent de nud est un processus léger exécuté sur chaque machine faisant partie du domaine d’administration Application Server. L’agent de nud est responsable du démarrage et de l’arrêt des instances du serveur sur l’hôte. Il collabore également avec le serveur d’administration du domaine pour créer des instances Application Server.
Un agent de nud doit être présent sur une machine pour chaque domaine Application Server auquel appartient la machine. Si vous avez sélectionné le composant Agent de nud lors de l’installation, un agent de nud par défaut appelé nom_hôte a été créé.
Pour démarrer l’agent de nud par défaut :
- Dans la fenêtre de terminal, entrez la commande suivante :
asadmin start-node-agent nom_hôte
Remplacez la variable nom_hôte par le nom de l’hôte sur lequel fonctionne Application Server.
- Lorsque vous y êtes invité, fournissez le mot de passe principal.
L’agent de nud démarre et établit la connexion avec le serveur d’administration du domaine. Si ce dernier ne fonctionne pas, il est possible que l’agent de nud ne puisse pas démarrer.
Définition du cluster
Un cluster est un groupe d’instances de serveur (généralement réparties sur plusieurs hôtes) qui partagent les mêmes configurations, ressources et applications. Il facilite l’équilibrage de charge sur les instances de serveur et offre une haute disponibilité via le basculement. Vous pouvez créer des clusters répartis sur plusieurs machines et les gérer avec l’aide du processus Agent de nud installé sur chaque machine. Dans ce guide, pour simplifier, notre exemple de cluster se trouve sur un seul hôte, celui-là même sur lequel fonctionne le serveur d’administration du domaine.
Vous devez déjà avoir démarré le processus Agent de nud sur chaque machine, comme décrit dans la section précédente. Lorsque vous spécifiez les instances lors de la création du cluster, vous devez associer l’instance à un agent de nud en cours d’exécution pour la machine sur laquelle vous voulez exécuter l’instance. Les noms d’agent de nud et d’instance doivent être uniques sur tous les clusters créés dans un domaine.
Pour créer un cluster :
- Connectez-vous à la console d’administration sur https://hôtelocal:4849 si vous ne l’avez pas encore fait.
Remplacez la variable hôtelocal par le nom du système sur lequel le serveur d’administration du domaine est exécuté.
4849 correspond au numéro de port par défaut de la console d’administration. Si vous avez changé le numéro de port au cours de l’installation, utilisez le nouveau numéro à la place.
- Dans le volet de droite, sous Tâches courantes, cliquez sur Créer un cluster pour afficher la page de saisie Création d’un cluster.
- Saisissez FirstCluster pour le nom du nouveau cluster.
- Dans la liste déroulante des modèles de configuration disponibles, sélectionnez la configuration default-config et choisissez Créer une copie de la configuration sélectionnée.
- Cliquez deux fois sur le bouton Ajouter, afin de créer deux entrées pour spécifier deux instances pour le cluster.
- Tapez i1 et i2 comme noms d’instance. Le nom de la machine locale est automatiquement attribué au nom de l’agent de nud.
Vous obtenez un écran comparable à celui-ci :
- Cliquez sur OK. Le processus de création peut prendre quelques minutes.
Remarque
Cet exercice nécessite des numéros de port automatiquement assignés pour HTTP, HTTPS, IIOP et IIOPS. Vous pouvez les modifier ultérieurement si vous le souhaitez.
Une fois le processus de création terminé, la page Cluster correctement créé apparaît et FirstCluster figure dans l’arborescence du volet de gauche. Une copie du modèle de configuration default-config a été réalisée pour ce cluster et le nom FirstCluster-config lui a été attribué.
- Dans le volet de gauche, développez Clusters et cliquez sur FirstCluster pour afficher la pages des informations générales sur les clusters.
- Cliquez sur l’onglet Instances pour afficher i1 et i2, à savoir les instances que vous avez créées.
Dans cette section, vous avez créé un cluster simple sur une machine unique. Vous pouvez également créer des clusters répartis sur plusieurs machines en suivant les mêmes étapes de base (à condition que le logiciel soit installé et que l’agent de nud soit en cours d’exécution sur chaque machine).
Vous pouvez interrompre ici le parcours Démarrage rapide si vous ne souhaitez pas continuer.
Déploiement d’une applicationCette section, la troisième des trois rubriques de base, comprend les étapes suivantes :
Déploiement de l’exemple d’application
Ce guide utilise l’exemple d’application clusterjsp pour montrer les possibilités d’équilibrage de charge sur les chemins Web.
- Cliquez sur le bouton Accueil pour accéder à la page Tâches courantes si vous n’y êtes pas déjà.
- Dans le volet de droite, sous Tâches courantes, cliquez sur Déployer une application d’entreprise.
- Dans la zone de texte Fichier à télécharger, cliquez sur Parcourir et placez-vous sur rép_install/samples/ee-samples/highavailability/apps/clusterjsp/clusterjsp.ear.
- Cliquez sur Suivant pour afficher la page Déployer une application d’entreprise.
- Faites défiler la page jusqu’à la section Cibles.
- Sélectionnez FirstCluster dans la liste des éléments disponibles, et cliquez sur Ajouter pour le déplacer vers la liste des éléments sélectionnés.
- Cliquez sur OK.
L’application clusterjsp est maintenant déployée sur FirstCluster.
Cet écran confirme que l’application clusterjsp est déployée sur FirstCluster.
Vérification de l’application clusterisée
Au cours de cette étape, vous allez démarrer le cluster et vérifier que l’application est accessible sur les deux instances.
Pour démarrer le cluster :
- Dans l’arborescence du volet de gauche, cliquez sur le nud FirstCluster sous Clusters.
- Dans le volet de droite, cliquez sur l’onglet Général s’il n’est pas déjà actif.
- Cliquez sur le bouton Démarrer les instances pour démarrer le cluster.
- Vérifiez qu’il a bien été démarré en contrôlant le champ État qui doit indiquer les instances en cours d’exécution.
Pour accéder à l’application sur chaque instance :
- Saisissez l’adresse suivante dans votre navigateur :
http://hôtelocal:port/clusterjsp
Remplacez la variable hôtelocal par le nom du système sur lequel le serveur d’administration du domaine est exécuté.
Remplacez la variable port par la valeur de HTTP-LISTENER-PORT pour i1. Cet exemple utilise http://localhost:38081/clusterjsp.
- Ajoutez des données d’attribut de session.
- Examinez les informations d’hôte et de session affichées. Par exemple :
- Ajoutez des données de session et cliquez sur le bouton Ajouter à la session.
- Répétez cette procédure pour l’instance i2 en tapant l’URL suivante dans votre navigateur :
http://hôtelocal:38080/clusterjsp
Dans cette section, vous avez déployé une application sur un cluster et testé la disponibilité de l’application sur toutes les instances du cluster.
Félicitations ! Vous venez de terminer les étapes de base de ce guide de démarrage rapide. Vous pouvez interrompre ici le parcours Démarrage rapide si vous ne souhaitez pas continuer avec les étapes avancées.
Configuration de l’équilibrage de chargeUn équilibreur de charge est généralement déployé en amont d’un cluster. Il :
- permet de répartir une application ou un service horizontalement sur plusieurs hôtes physiques (ou logiques) tout en continuant à afficher une URL unique à l’utilisateur ;
- préserve l’utilisateur des défaillances de l’hôte ou des pannes du serveur, lorsqu’il est utilisé avec la réplication de session ;
- améliore la sécurité en masquant le réseau interne pour l’utilisateur.
Application Server comprend des plug-ins d’équilibrage de charge pour les serveurs Web classiques tels que Apache, et Sun Java System Web Server.
Cette section fournit des instructions relatives au téléchargement et à la configuration du logiciel Sun Java System Web Server afin de lui faire jouer le rôle de programme d’équilibrage de charge pour le cluster de serveurs Application Server. Pour réaliser cette procédure, vous devez disposer de suffisamment de mémoire pour exécuter Web Server sur votre système en plus du serveur d’administration de domaine et des deux instances Application Server que vous avez créées précédemment dans ce guide. Un système doté de 512 Mo à 1024 Mo de mémoire est conseillé.
Cette rubrique présente les étapes suivantes :
Installation du logiciel Web Server
Si vous avez déjà installé le logiciel Web Server et pouvez identifier une instance Web Server qui servira de programme d’équilibrage de charge, notez l’emplacement de cette instance sur le système de fichiers et passez à la section Installation du plug-in d’équilibrage de charge.
Si vous utilisez le logiciel Sun Java Enterprise System, Web Server est sélectionné automatiquement pour être installé si vous avez choisi d'installer le plug-in d'équilibrage de charge. Toutefois, vous pouvez également installer le logiciel Web Server à l'aide de la procédure suivante :
- Lancez le programme d’installation de Java Enterprise System.
- Sélectionnez Sun Java System Web Server dans la page de sélection des composants.
- Sélectionnez Configurer maintenant pour que le système vous invite à configurer Web Server lors de son installation.
- Dans ce cas, définissez une instance Web Server par défaut.
Si vous utilisez un logiciel Sun Java System Application Server autonome ou que vous n’avez pas accès au programme d’installation de Sun Java Enterprise System, installez le logiciel Web Server en procédant comme suit :
- Accédez à la page http://www.sun.com/downloads. Faites défiler la page jusqu’à l’en-tête Web & Proxy Servers et cliquez sur Web Servers.
- Téléchargez Web Server 6.1 Service Pack 2 ou ultérieur pour l’environnement linguistique et la plate-forme de votre choix.
Pour procéder au téléchargement, vous devez vous connecter avec le nom d’utilisateur et le mot de passe que vous avez enregistrés auprès de MySunSM, Sun StoreSM, SunSolveSM ou du centre de support en ligne. Si vous n’avez pas encore de compte de connexion, vous pouvez vous enregistrer en ligne.
- Suivez les instructions d’installation du logiciel Web Server. Vous devez :
- Lors de l’installation de Web Server, le serveur d’administration pour Web Server est configuré et vous êtes invité à définir une instance Web Server par défaut.
Installation du plug-in d’équilibrage de charge
Pour installer le plug-in d’équilibrage de charge :
- Exécutez le programme d’installation du logiciel que vous utilisez : Sun Java Enterprise System ou le logiciel autonome Sun Java System Application Server.
- Dans l’écran de sélection des composants à installer, sélectionnez Load Balancing Plugin.
Dans le programme d'installation de Sun Java Enterprise System, vous devez développer l'élément Application Server pour afficher le plug-in d'équilibrage de charge. Par défaut, celui-ci n'est pas sélectionné pour l'installation.
Création de la configuration de l’équilibreur de charge
Vous allez de nouveau agir en interaction avec le serveur d’administration du domaine Application Server. Vous devez disposer d’un environnement d’exécution de shell pour cette section.
- Créez une configuration d'équilibreur de charge nommée MyLbConfig destinée au cluster FirstCluster :
asadmin create-http-lb-config --target FirstCluster MyLbConfig
- Activez le cluster FirstCluster et l’application clusterjsp qui y est déployée pour l'équilibrage de charge HTTP :
asadmin enable-http-lb-server FirstCluster
asadmin enable-http-lb-application --name clusterjsp FirstCluster
- Créez un vérificateur de maintenance pour l'équilibreur de charge, permettant le signalement de la reprise d'une instance défaillante.
asadmin create-http-health-checker --interval 10 --config MyLbConfig FirstCluster
L'intervalle est le délai en nombre de secondes observé par le vérificateur entre deux contrôles d'une instance défaillante.
- Exportez la configuration dans un fichier loadbalancer.xml
asadmin export-http-lb-config --config MyLbConfig loadbalancer.xml
- Copiez loadbalancer.xml dans le répertoire rép_install_web_server/https-nom_hôte/config/loadbalancer.xml
Démarrage de l’équilibreur de charge
Si l’instance Web Server jouant le rôle d’équilibreur de charge n’est pas déjà en cours d’exécution, démarrez le logiciel Web Server à l'aide de la commande suivante :
Si l’instance Web Server jouant le rôle d’équilibreur de charge n’est pas déjà en cours d’exécution, redémarrez le logiciel Web Server à l'aide de la commande suivante :
Vérification de l’équilibrage de charge
- Pour afficher la première page de l’application clusterjsp, tapez l’URL suivante dans votre navigateur :
http://hôtelocal:port_web_server/clusterjsp
Remplacez la variable hôtelocal par le nom du système sur lequel Web Server est exécuté.
Remplacez la variable port_web_server par la valeur de l’attribut de port de l’élément LS dans rép_install_web_server/https-nom_hôte/config/server.xml. Pour cet exemple, le port 38000 est utilisé.
Une page comparable à celle de la section Vérification de l’application clusterisée apparaît.
- Examinez les informations d’hôte et de session affichées. Par exemple :
- Le numéro de port du serveur est 38000, le port de Web Server. L’équilibreur de charge a fait suivre la requête vers les deux instances du cluster.
- En utilisant un navigateur différent, ou le même navigateur sur une machine différente, créez une nouvelle session. Les requêtes effectuées à partir du même navigateur sont « rémanentes » et accèdent à la même instance.
Ces sessions doivent être réparties sur les deux instances du cluster. Pour vérifier que c’est bien le cas, consultez les fichiers journaux d’accès au serveur à l’emplacement suivant :
- Installation Solaris Java Enterprise System :
/var/opt/SUNWappserver/nodeagents/nom_agent_nud/i1/logs/access/server_access_log
/var/opt/SUNWappserver/nodeagents/nom_agent_nud/i2/logs/access/server_access_log- Installation Linux Java Enterprise System :
/var/opt/sun/appserver/nodeagents/nom_agent_nud/i1/logs/access/server_access_log
/var/opt/sun/appserver/nodeagents/nom_agent_nud/i2/logs/access/server_access_log- Installations Application Server autonomes :
rép_install/nodeagents/nom_agent_noeud/i1/logs/access/server_access_log
rép_install/nodeagents/nom_agent_nud/i2/logs/access/server_access_log- Ajoutez une paire nom/valeur (Name=Name Value=Duke) à stocker dans HttpSession.
- Cliquez sur le bouton Ajouter aux données de la session.
- Vérifiez que les données de la session ont été ajoutées.
Dans cette section, vous avez créé une instance devant servir pour l’équilibrage de charge et défini une configuration d’équilibrage de charge. Vous avez également vérifié l’équilibrage de charge.
Pour configurer et vérifier le basculement de session HTTP, passez à la section Configuration du basculement haute disponibilité.
NettoyagePour procéder au nettoyage, vous pouvez désinstaller Application Server en suivant les étapes de la section Option 1 : désinstallation globale, ou vous pouvez tout simplement supprimer l’exemple de cluster que vous venez de créer en suivant les étapes de la section Option 2 : suppression de l’exemple de cluster.
Attention
Si vous prévoyez d'effectuer les procédures décrites dans la section À propos des clusters haute disponibilité et de HADB, ne procédez pas au nettoyage maintenant. Démarrez la section À propos des clusters haute disponibilité et de HADB puis, lorsque vous êtes prêt, effectuez le nettoyage à l'aide des procédures décrites dans cette section.
Option 1 : désinstallation globale
Pour désinstaller complètement l’application :
- Arrêtez les processus Application Server à l’aide des commandes suivantes :
asadmin stop-cluster FirstCluster
asadmin stop-node-agent hostname
asadmin stop-domain domain1
À ce stade, tous les processus liés à Application Server sont arrêtés.
- Désinstallez Application Server.
Dans une installation Java Enterprise System, exécutez var/sadm/prod/entsys/uninstall, puis effectuez la procédure indiquée dans l'Assistant de désinstallation.
Dans une installation Application Server autonome, exécutez rép_install/uninstall, puis effectuez la procédure indiquée dans l'Assistant de désinstallation.
- Si vous avez installé Web Server pour cet exercice, arrêtez l’instance Web Server servant d’équilibreur de charge et désinstallez le produit Web Server. Vous pouvez arrêter l’instance de la manière suivante :
rép_install_web_server/https-nom_hôte/stop
- Si vous souhaitez désinstaller le produit Web Server, exécutez le programme de désinstallation à partir de rép_install_web_server.
Option 2 : suppression de l’exemple de cluster
Pour supprimer uniquement FirstCluster (l’exemple de cluster haute disponibilité) et l’exemple d’application utilisé dans cet exercice :
- Arrêtez les processus Application Server et effacez la configuration :
asadmin stop-cluster FirstCluster
asadmin disable-http-lb-server FirstCluster
asadmin delete-http-lb-ref --config MyLbConfig FirstCluster
asadmin delete-http-lb-config MyLbConfig
asadmin delete-instance i1
asadmin delete-instance i2
asadmin delete-cluster FirstCluster
asadmin undeploy clusterjsp
- Arrêtez l’instance Web Server jouant le rôle d’équilibreur de charge :
rép_install_web_server/https-nom_hôte/stop
- Renommez le fichier loadbalancer.xml situé sous rép_install_web_server/https-nom_hôte/config en loadbalancer.xml.sav
Félicitations ! Vous venez de terminer la procédure de démarrage rapide pour Application Server.
Autres ressourcesD’autres ressources vous permettant d’en apprendre davantage sur le logiciel Application Server et son utilisation sont disponibles :