Vous pouvez installer un fichier d'application d'entreprise sur un serveur
d'applications ou un cluster en faisant glisser ou en copiant
un fichier d'archive d'entreprise (EAR), un fichier d'archive d'application Web (WAR), un fichier d'archive Java™ (JAR) ou un fichier d'archive SIP (Session Initiation
Protocol) (SAR) vers un répertoire contrôlé. Un fichier d'application d'entreprise doit être conforme à la spécification Java EE
(Java Platform, Enterprise Edition).
Avant de commencer
Développez et assemblez le fichier EAR, JAR, WAR ou SAR. Vous pouvez utiliser un outil d'assemblage pris en charge tel qu'un
produit IBM® Rational Application
Developer for WebSphere Software
pour spécifier des liaisons et assembler le fichier.
L'installation d'un fichier EAR, JAR, WAR ou SAR en l'ajoutant à un répertoire contrôlé ne modifie pas les liaisons JNDI (Java Naming and Directory) et les autres liaisons d'application. Si vous devez définir des valeurs de liaison au cours du déploiement, utilisez l'assistant d'installation d'applications de la console d'administration, un script wsadmin ou un fichier de propriétés définissant les liaisons pour installer le fichier.
Reportez-vous à la rubrique Installation des fichiers
d'application d'entreprise via l'ajout de fichiers de propriétés à un répertoire contrôlé.
Par défaut, le déploiement des répertoires contrôlés
n'est pas activé. Le déploiement par répertoire contrôlé doit être activé avant son utilisation. Voir Définition
des valeurs de déploiement d'un répertoire contrôlé.
Restriction : L'installation d'un fichier EAR, JAR, WAR ou SAR en l'ajoutant
à un répertoire contrôlé est disponible uniquement sur des systèmes d'exploitation répartis et z/OS. Elle n'est pas prise en charge sur les systèmes d'exploitation IBM i.
Eviter les incidents: N'utilisez pas le déploiement de répertoire contrôlé dans un environnement de production dans lequel l'application doit rester disponible en permanence. Dans les environnements de production, utilisez plutôt un processus automatisé qui déplace les mises à jour des applications vers chaque serveur d'applications en commençant par éliminer les requêtes
de chaque serveur, en mettant à jour l'application, puis en redémarrant le serveur. Pour plus d'informations sur ce processus automatisé,
voir
IBM WebSphere Developer Technical Journal: Maintain continuous
availability while updating WebSphere Application Server enterprise
applications.
gotcha
Pourquoi et quand exécuter cette tâche
Vous pouvez
déployer un fichier EAR, JAR, WAR ou SAR sur un serveur d'applications ou un cluster en faisant glisser ou en copiant le fichier vers un répertoire contrôlé.
Le répertoire contrôlé des serveurs d'applications de base (autonomes) est le répertoire monitoredDeployableApps/servers/nom_du_serveur du profil du serveur d'applications.
Pour les gestionnaires de déploiement, les répertoires contrôlés sont les répertoires monitoredDeployableApps/servers/server_name, monitoredDeployableApps/nodes/node_name/servers/server_name
et monitoredDeployableApps/clusters/cluster_name du profil du gestionnaire de déploiement.
Par défaut, le produit analyse le répertoire contrôlé à la recherche de nouvelles applications toutes les 5 secondes au maximum. Une fois qu'il a trouvé un nouveau fichier EAR, JAR, WAR ou SAR dans le répertoire contrôlé, le produit l'installe sur le serveur d'applications ou le cluster et démarre l'application ou le module.
Après que vous avez ajouté un fichier EAR au répertoire contrôlé, le produit crée une copie temporaire du fichier EAR
dans un autre répertoire et installe le fichier sur le serveur. Une fois que vous avez ajouté un fichier JAR, WAR ou SAR au répertoire contrôlé, le produit crée une copie temporaire du fichier d'archive dans un autre répertoire, encapsule le fichier d'archive dans un fichier EAR appelé archive_extension.ear et installe le nouveau fichier EAR. Par exemple, simpleApp.war est installé en tant que simpleApp_war.ear. Le fichier d'archive d'origine
que vous avez ajouté au répertoire contrôlé n'est pas modifié.
Vous pouvez utiliser la même méthode pour mettre à jour des fichiers d'application. Si vous ajoutez ultérieurement un fichier EAR, JAR, WAR ou SAR mis à jour au même répertoire contrôlé, le produit arrête l'application déployée précédemment, installe le fichier mis à jour sur le serveur d'applications ou le cluster et démarre l'application ou le module mis à jour. Par exemple, supposons que vous ayez déployé précédemment my_app.ear en le faisant glisser vers un répertoire contrôlé. Si vous faites ensuite glisser un fichier appelé my_app.ear vers le répertoire contrôlé, le produit remplace le fichier EAR déployé précédemment par le fichier EAR mis à jour de même nom. Le serveur ou le cluster doit être en cours d'exécution pour que le produit
remarque les modifications apportées aux fichiers dans son répertoire contrôlé.
Un explorateur graphique peut être utilisé pour faire glisser le fichier EAR, JAR, WAR ou SAR. Vous pouvez également utiliser les commandes du système d'exploitation pour copier un fichier dans un sous-répertoire contrôlé monitoredDeployableApps.
Procédure
- Vérifiez que le serveur d'applications ou le membre de cluster sur lequel vous souhaitez installer le fichier d'application d'entreprise est en cours d'exécution.
- Vérifiez que le déploiement à partir du répertoire contrôlé est activé.
Reportez-vous à la rubrique Définition des valeurs de
déploiement de répertoire contrôlé.
- Affichez la structure de fichiers de l'ordinateur et trouvez ou créez le répertoire contrôlé.
Le répertoire contrôlé des serveurs d'applications de base (autonomes) se trouve sous le profil du serveur. Le chemin du répertoire est le suivant :
racine_serveur_app/profiles/nom_profil_serveur_app/monitoredDeployableApps/servers/nom_serveur
racine_serveur_app/AppServer/profiles/default/monitoredDeployableApps/servers/nom_serveur
Dans le cas des serveurs autonomes, le produit crée automatiquement un répertoire contrôlé
nom_serveur.
Pour les serveurs d'applications sur un noeud géré (fédéré) d'un gestionnaire de déploiement, créez un répertoire contrôlé sous le profil du gestionnaire de déploiement. Le chemin du répertoire est le suivant :
racine_serveur_app/profiles/nom_profil_gestionnaire_déploiement/monitoredDeployableApps/servers/nom_serveur
racine_serveur_app/AppServer/profiles/default/monitoredDeployableApps/servers/nom_serveur
Dans le cas des serveurs d'applications d'un noeud fédéré, vous devez créer le répertoire
nom_serveur. Le nom du répertoire doit correspondre à celui d'un serveur existant.
Pour définir un serveur spécifique en tant que répertoire contrôlé, alors que plusieurs noeuds fédérés hébergent des serveurs du même nom, indiquez le noeud et le serveur du répertoire contrôlé. Créez les répertoires
/nodes/nom_noeud/servers/nom_serveur sous le profil du gestionnaire de déploiement. Le chemin du répertoire est le suivant :
racine_serveur_app/profiles/nom_profil_gestionnaire_déploiement/monitoredDeployableApps/nodes/nom_noeud/servers/nom_serveur
racine_serveur_app/DeploymentManager/profiles/default/monitoredDeployableApps/nodes/nom_noeud/servers/nom_serveur
Vous devez créer des répertoires pour le noeud et le serveur. Le répertoire
nom_noeud doit correspondre à celui d'un noeud existant. Le répertoire
nom_serveur doit correspondre à celui d'un serveur existant sur le noeud.
Créez le répertoire contrôlé des clusters directement sous le profil du gestionnaire de déploiement. Le chemin du répertoire est le suivant :
racine_serveur_app/profiles/nom_profil_gestionnaire_déploiement/monitoredDeployableApps/clusters/nom_cluster
racine_serveur_app/DeploymentManager/profiles/default/monitoredDeployableApps/clusters/nom_cluster
Vous devez créer le répertoire contrôlé
nom_cluster.
Le nom du répertoire doit correspondre à celui d'un cluster existant.
- Copiez le fichier EAR, JAR, WAR ou SAR à déployer dans le répertoire contrôlé.
A moins que vous ne vouliez mettre à jour un fichier déjà déployé, choisissez un fichier qui n'est pas encore déployé sur le répertoire contrôlé cible.
Pour déployer un fichier dans un répertoire contrôlé d'un gestionnaire de déploiement, alors qu'il a déjà été déployé dans un autre répertoire contrôlé du même gestionnaire, supprimez le fichier du répertoire contrôlé cible qui le contient déjà avant de l'ajouter dans le nouveau répertoire contrôlé cible. Dans la présente édition, un fichier d'applications ne peut exister que dans un seul répertoire contrôlé d'un même gestionnaire de déploiement.
Résultats
Le produit ajoute un répertoire portant le même nom que le fichier au répertoire installedApps/nom_cellule du profil.
De même, le produit écrit des messages relatifs au déploiement d'application dans le fichier SystemOut.log du répertoire racine_serveur_app/logs/nom_serveur.
Les messages commencent par la clé de message CWLDD.
Ils indiquent que le produit a déployé le fichier d'application et que l'application est en cours d'exécution.
Remarque : Cette rubrique fait référence à un ou plusieurs des fichiers journaux de serveur d'applications. Il est recommandé de configurer le serveur de telle sorte qu'il utilise l'infrastructure de journalisation et de trace HPEL (High Performance Extensible Logging) à la place des fichiers SystemOut.log, SystemErr.log, trace.log et activity.log sur les systèmes distribués et IBM i. Vous pouvez également utiliser HPEL conjointement avec vos fonctions de journalisation z/OS natives. Si vous utilisez l'infrastructure HPEL, vous pouvez accéder à toutes les informations de journalisation et de trace en utilisant l'outil de ligne de commande LogViewer à partir de votre répertoire bin de profil de serveur. Pour plus d'informations sur l'utilisation de HPEL, voir les informations sur l'utilisation de HPEL
en vue du traitement des incidents liés aux applications.
Dans le cas d'une installation à partir du répertoire contrôlé d'un gestionnaire de déploiement, le produit ne démarre pas automatiquement l'application ou le module si l'agent de noeud ou le serveur est arrêté. Si l'agent de noeud est arrêté, le produit installe l'application ou le module au niveau du gestionnaire de déploiement, mais ne synchronise pas les modifications avec le noeud et ne démarre pas l'application ou le module. Les modifications sont appliquées au noeud au prochain démarrage de l'agent assorti d'une synchronisation.
Si le serveur est arrêté
mais que l'agent de noeud est en cours d'exécution, le produit installe l'application
ou le module et synchronise les modifications avec le noeud, mais ne démarre pas le serveur.
Exemple
Supposions que vous vouliez installer le fichier modèle DynaCacheEsi.ear en copiant le fichier EAR dans un répertoire contrôlé. Ce fichier est disponible dans le répertoire racine_serveur_app/installableApps.
Déploiement d'un fichier EAR sur un serveur d'applications autonome- Vérifiez que le serveur d'applications sur lequel vous souhaitez installer le fichier DynaCacheEsi.ear est en cours d'exécution.
La commande serverStatus -all vous permet de savoir si le serveur est en cours.
La commande startServer nom_serveur démarre le serveur.
![[AIX Solaris HP-UX Linux Windows]](../images/dist.gif)
Supposons, par exemple, que le nom du profil du serveur d'applications soit AppSrv02. Exécutez la commande
serverStatus à partir d'une invite de commande dans le répertoire
racine_serveur_app/profiles/AppSrv02/bin :
serverStatus -all
Si le serveur n'est pas en cours d'exécution, démarrez-le.
![[AIX Solaris HP-UX Linux Windows]](../images/dist.gif)
Par exemple, pour démarrer un serveur d'applications appelé serveur1 sur AppSrv02, exécutez la commande
startServer à partir d'une invite de commande dans le répertoire
racine_serveur_app/profiles/AppSrv02/bin :
startServer server1
Le message
Serveur
serveur1 prêt pour l'e-business indique que le serveur est en cours d'exécution.
- Localisez le répertoire contrôlé.
Le répertoire contrôlé du profil autonome AppSrv02 est racine_serveur_app/profiles/AppSrv02/monitoredDeployableApps/servers/serveur1.
- Copiez le fichier DynaCacheEsi.ear du répertoire racine_serveur_app/installableApps dans le répertoire contrôlé.
- Vérifiez que le répertoire destiné aux applications installées existe.
racine_serveur_app/profiles/AppSrv02/installedApps/nom_cellule/DynaCacheEsi.ear
racine_serveur_app/profiles/default/installedApps/nom_cellule/DynaCacheEsi.ear
- Vérifiez que DynaCacheEsi.ear est dans la liste des applications d'entreprise installées et s'exécute.
Déploiement d'un fichier EAR sur le noeud fédéré d'un gestionnaire de déploiement- Vérifiez que le serveur d'applications du noeud fédéré sur lequel vous souhaitez installer le fichier DynaCacheEsi.ear est en cours d'exécution.
La commande serverStatus -all vous permet de savoir si le serveur est en cours. La commande startServer nom_serveur démarre le serveur.
![[AIX Solaris HP-UX Linux Windows]](../images/dist.gif)
Supposons, par exemple, que le serveur d'applications serveur1 soit sur un noeud dont le nom de profil est AppSrv01. Exécutez la commande
serverStatus à partir d'une invite de commande dans le répertoire
racine_serveur_app/profiles/AppSrv01/bin :
serverStatus -all
Si le serveur n'est pas en cours d'exécution, démarrez-le.
![[AIX Solaris HP-UX Linux Windows]](../images/dist.gif)
Par exemple, exécutez la commande
startServer à partir d'une invite de commande dans le répertoire
racine_serveur_app/profiles/AppSrv01/bin :
startServer server1
- Vérifiez que le fichier DynaCacheEsi.ear n'existe pas déjà dans un répertoire contrôlé du gestionnaire de déploiement.
Ajoutez un fichier d'application à un seul répertoire contrôlé
d'un gestionnaire de déploiement. Si vous ajoutez un fichier d'application dans un répertoire contrôlé d'un gestionnaire de déploiement dont un autre répertoire contrôlé contient déjà un fichier du même nom, le produit désinstalle le fichier d'application de l'ancien répertoire et l'installe dans le nouveau. Cependant, la nouvelle cible n'est pas synchronisée avec le déploiement, car le fichier existe toujours dans l'ancien répertoire contrôlé cible. Pour éviter les problèmes de synchronisation, vous devez supprimer DynaCacheEsi.ear de tous les répertoires contrôlés avant de l'ajouter au nouveau répertoire.
- Créez le répertoire contrôlé.
Les répertoires contrôlés des noeuds fédérés doivent être créés sous le profil du gestionnaire de déploiement, sauf si le répertoire du serveur cible existe déjà.
Supposons, par exemple, que le profil du gestionnaire de déploiement soit Dmgr01, et le serveur d'applications, serveur1.
- Accédez au répertoire /monitoredDeployableApps/servers :
racine_serveur_app/profiles/Dmgr01/monitoredDeployableApps/servers
racine_serveur_app/AppServer/profiles/default/monitoredDeployableApps/servers
- Si le répertoire serveur1 existe déjà dans le répertoire servers, passez à l'étape suivante.
Si le répertoire serveur1
n'existe pas, créez un répertoire nommé serveur1 dans
le répertoire /monitoredDeployableApps/servers.
Le répertoire contrôlé est :
racine_serveur_app/profiles/Dmgr01/monitoredDeployableApps/servers/serveur1
racine_serveur_app/AppServer/profiles/default/monitoredDeployableApps/servers/serveur1
- Copiez le fichier DynaCacheEsi.ear du répertoire racine_serveur_app/installableApps dans le répertoire contrôlé serveur1.
- Vérifiez que le répertoire destiné aux applications installées existe.
racine_serveur_app/profiles/AppSrv01/installedApps/nom_cellule/DynaCacheEsi.ear
racine_serveur_app/AppServer/profiles/default/installedApps/nom_cellule/DynaCacheEsi.ear
- Vérifiez que DynaCacheEsi.ear est dans la liste des applications d'entreprise installées sur le serveur et s'exécute.
Conseil : Pour définir un serveur spécifique en tant que répertoire contrôlé, alors que plusieurs noeuds fédérés hébergent des serveurs du même nom, indiquez le noeud et le serveur du répertoire contrôlé. Créez les répertoires
/nodes/nom_noeud/servers/nom_serveur sous le profil du gestionnaire de déploiement. Par exemple, si vous souhaitez que le
répertoire contrôlé soit le serveur d'applications serveur1 sur le noeud myNode01, le chemin de répertoire est le suivant :
racine_serveur_app/profiles/Dmgr01/monitoredDeployableApps/nodes/myNode01/servers/serveur1
racine_serveur_app/DeploymentManager/profiles/default/monitoredDeployableApps/nodes/myNode01/servers/serveur1
Ne spécifiez le noeud d'un répertoire contrôlé que si plusieurs serveurs portent le même nom.
Déploiement d'un fichier EAR sur le cluster d'un gestionnaire de déploiement- Vérifiez que les membres du cluster sur lequel vous souhaitez installer le fichier DynaCacheEsi.ear sont en cours d'exécution.
Dans l'exemple qui suit, le cluster contient un membre, myClusterMember01.
- La commande serverStatus -all vous permet de savoir si le cluster est en cours. La commande startServer myClusterMember01 démarre le membre du cluster.
![[AIX Solaris HP-UX Linux Windows]](../images/dist.gif)
Supposons, par exemple, que myClusterMember01 soit dans le profil AppSrv01. Exécutez la commande
serverStatus à partir d'une invite de commande dans le répertoire
racine_serveur_app/profiles/AppSrv01/bin :
serverStatus -all
Si le membre du cluster n'est pas en cours, exécutez la commande
startServer à partir d'une invite de commande dans le répertoire
racine_serveur_app/profiles/AppSrv01/bin :
startServer myClusterMember01
- Vérifiez que le fichier DynaCacheEsi.ear n'existe pas déjà dans un répertoire contrôlé du gestionnaire de déploiement.
- Créez le répertoire contrôlé.
Les répertoires contrôlés des clusters doivent être créés sous le profil du gestionnaire de déploiement, sauf si le répertoire du membre cible existe déjà.
![[AIX Solaris HP-UX Linux Windows]](../images/dist.gif)
Supposons, par exemple, que le profil du gestionnaire de déploiement soit Dmgr01 :
- Accédez au répertoire racine_serveur_app/profiles/Dmgr01/monitoredDeployableApps/clusters.
- Si le répertoire myCluster01 existe déjà dans le répertoire /clusters, passez à l'étape suivante.
Si le répertoire myCluster01 n'existe pas, créez-le dans le répertoire /clusters.
Le répertoire contrôlé est :
racine_serveur_app/profiles/Dmgr01/monitoredDeployableApps/clusters/myCluster01
racine_serveur_app/DeploymentManager/profiles/default/monitoredDeployableApps/clusters/myCluster01
- Copiez le fichier DynaCacheEsi.ear du répertoire racine_serveur_app/installableApps dans le répertoire contrôlé myCluster01.
- Vérifiez que le répertoire destiné aux applications installées existe.
racine_serveur_app/profiles/AppSrv01/installedApps/nom_cellule/DynaCacheEsi.ear
racine_serveur_app/AppServer/profiles/default/installedApps/nom_cellule/DynaCacheEsi.ear
- Vérifiez que DynaCacheEsi.ear est dans la liste des applications d'entreprise installées sur le membre du cluster et s'exécute.
Que faire ensuite
Testez l'application ou le module déployé. Par exemple, pointez
un navigateur Web sur l'URL d'une application déployée et vérifiez ses performances.
Si le déploiement échoue, lisez les messages figurant dans le fichier SystemOut.log, corrigez l'erreur et ajoutez à nouveau l'application ou le module au répertoire contrôlé.