[AIX Solaris HP-UX Linux Windows]

Installation de fichiers d'application d'entreprise en les ajoutant à un répertoire contrôlé

Vous pouvez installer un fichier d'application d'entreprise sur un serveur d'applications 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 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 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.

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 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 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 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

  1. Vérifiez que le serveur d'applications sur lequel vous souhaitez installer le fichier d'application d'entreprise est en cours d'exécution.
  2. 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é.

  3. Affichez la structure de fichiers de l'ordinateur et trouvez 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 :
    • [AIX Solaris HP-UX Linux Windows]racine_serveur_app/profiles/nom_profil_serveur_app/monitoredDeployableApps/servers/nom_serveur
    Dans le cas des serveurs autonomes, le produit crée automatiquement un répertoire contrôlé nom_serveur.
  4. 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.

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.

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
  1. 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]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]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.
  2. Localisez le répertoire contrôlé.

    [AIX Solaris HP-UX Linux Windows]Le répertoire contrôlé du profil autonome AppSrv02 est racine_serveur_app/profiles/AppSrv02/monitoredDeployableApps/servers/serveur1.

  3. Copiez le fichier DynaCacheEsi.ear du répertoire racine_serveur_app/installableApps dans le répertoire contrôlé.
  4. Vérifiez que le répertoire destiné aux applications installées existe.
    • [AIX Solaris HP-UX Linux Windows]racine_serveur_app/profiles/AppSrv02/installedApps/nom_cellule/DynaCacheEsi.ear
  5. Vérifiez que DynaCacheEsi.ear est dans la liste des applications d'entreprise installées 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é.


Icône indiquant le type de rubrique Rubrique de tâche



Icône d'horodatage Dernière mise à jour: last_date
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=cord&product=was-base-dist&topic=trun_app_install_dragdrop
Nom du fichier : trun_app_install_dragdrop.html