Installation de fichiers d'application d'entreprise à l'aide de la console

L'installation de fichiers de l'application Java™ Platform, Enterprise Edition (Java EE) consiste à placer des modules d'application d'entreprise, Web, de bean enterprise (EJB) ou autres sur un serveur ou un cluster configuré pour les gérer. Les fichiers installés qui se lancent et s'exécutent correctement sont considérés déployés.

Avant de commencer

Avant d'installer les fichiers d'une application d'entreprise, vérifiez que vous installez les fichiers de l'application sur un cible de déploiement compatible. Si cette cible n'est pas compatible, sélectionnez-en une autre.

En option, déterminez si l'application que vous installez utilise les fichiers de bibliothèque également utilisés par les autres applications déployées. Vous pouvez définir une bibliothèque partagée pour chacun de ces fichiers partagés. L'utilisation de bibliothèques partagées réduit le nombre de copies des fichiers de bibliothèque sur votre poste de travail ou sur votre serveur.

Pourquoi et quand exécuter cette tâche

Pour installer de nouveaux fichiers d'application d'entreprise dans une configuration WebSphere Application Server, vous disposez des options suivantes :

  • Console d'administration
  • Scripts wsadmin
  • Déploiement de répertoire contrôlé
  • Fichier de propriétés de l'application
  • Programmes Java MBean

Ces étapes décrivent comment utiliser la console d'administration pour installer une application, un composant EJB, une archive SIP (Session Initiation Protocol, une archive SAR ou un module Web.

Eviter les incidents Eviter les incidents: Lorsque vous exécutez les étapes dans l'assistant d'installation d'application, cliquez sur Annuler pour quitter si vous décidez de ne pas installer l'application. N'oubliez pas de cliquer sur Annuler dans la page d'installation de l'application avant d'accéder à une autre page.gotcha

Procédure

  1. Cliquez sur Applications > Nouvelle application > Nouvelle application d'entreprise dans l'arborescence de navigation de la console.
  2. Sur la première page Préparation à l'installation de l'application :
    1. Indiquez le chemin d'accès complet au fichier d'application d'entreprise source (fichier .ear également appelé fichier EAR).

      Le fichier EAR que vous installez peut se trouver sur le poste client (poste qui exécute le navigateur Web) ou sur le poste serveur (poste auquel est connecté le client). Si vous définissez un fichier EAR sur le poste client, la console d'administration recharge alors le fichier EAR sur le poste sur lequel est exécutée la console et procède à l'installation de l'application.

      Vous pouvez également spécifier un fichier WAR (Web archive), SAR ou JAR (Java archive) autonome pour l'installation.

      [IBM i]Si le fichier EAR réside sur la machine du serveur et que le serveur est un serveur IBM® i, vérifiez que le profil utilisateur QEJBSVR possède le droit d'accès *R sur le fichier EAR et au moins le droit d'accès *X sur tous les répertoires figurant dans le chemin contenant le fichier EAR.

      Eviter les incidents Eviter les incidents: Si vous tentez d'installer une application depuis un système de fichiers distant et que la machine virtuelle Java (JVM) est enregistrée en tant que service Microsoft Windows, la console d'administration n'affiche pas d'unité réseau mappée. Dans ce cas, le service Windows s'exécute comme nouvelle session de connexion avec un identificateur de sécurité (SID) différent de celui de la session utilisateur. Par conséquent, le service ne peut pas manipuler l'unité de réseau mappée qui est établie par la connexion utilisateur. Pour installer l'application depuis un système de fichiers distant, vous devez utiliser la commande WASService pour désenregistrer la machine JVM dans le service Windows. Pour plus d'informations, voir la documentation sur la commande WASService.gotcha
    2. Cliquez sur Suivant.
  3. Dans la deuxième page Préparation de l'installation de l'application :
    1. Indiquez si toutes les options d'installation sont affichées.
      Raccourci - Ne demander que si des informations supplémentaires sont requises
      Permet d'afficher l'étape de mappage de module ainsi que les étapes nécessitant l'indication des informations requises pour que l'installation de l'application réussisse.
      Détaillé - Afficher tous les paramètres et options d'installation
      Permet d'afficher toutes les options d'installation.
    2. Indiquez s'il faut générer des liaisons par défaut.

      Sélectionnez Générer des liaisons par défaut pour que le produit fournisse des valeurs par défaut pour les liaisons JNDI incomplètes et les autres liaisons d'application. Le produit ne modifie pas les liaisons existantes.

      Vous n'avez pas besoin de préciser les valeurs JNDI pour les interfaces bean EJB, home locale, home distante ou métier des modules EJB 3.x. Le produit affecte les valeurs par défaut du conteneur lors de l'exécution. De même, il n'est pas nécessaire d'indiquer des valeurs JNDI pour les références EJB dans un module EJB 3. x ou Web 2.4 ou d'une version suivante, car le produit effectue automatiquement la résolution des cibles pendant la phase d'exécution. Même lorsque vous sélectionnez Générer des liaisons par défaut, le produit ne génère pas de valeurs par défaut pour les valeurs JNDI, mais pour d'autres liaisons comme l'hôte virtuel.

      Nouvelle fonction Nouvelle fonction:
      Par défaut, les ressources par défaut préconfigurées ne sont pas utilisées pour les liaisons Java EE. Sélectionnez Use Java EE default bindings pour que les liaisons générées soient définies par défaut pour Java EE.newfeat

      Vous pouvez personnaliser les valeurs par défaut utilisées lors de la génération des liaisons par défaut. La rubrique Préparation de l'installation de l'application - Paramètres de génération des liaisons décrit la personnalisation disponible et fournit des exemples de liaisons.

    3. Cliquez sur Suivant. Si des avertissements concernant la sécurité s'affichent, cliquez sur Continuer. Les pages Installation d'une nouvelle application s'affichent. Si vous choisissez de générer des liaisons par défaut, vous pouvez passer directement à l'étape Récapitulatif. La rubrique Exemple : Installation d'un fichier EAR utilisant les liaisons par défaut contient un exemple de procédure.
  4. Indiquez les valeurs des options d'installation comme il convient.

    Vous pouvez cliquer sur un numéro d'étape pour passer directement à la page associée au lieu de cliquer sur Suivant. Le contenu de l'application ou du module que vous installez détermine les pages disponibles.

    Tableau 1. Descriptions des pages de l'assistant. Le tableau répertorie et décrit chacune des pages de l'assistant.
    Page Description
    Sélectionner les options d'installation Dans la page Sélectionner les options d'installation, affectez des valeurs aux paramètres spécifiques au produit. Des valeurs par défaut sont employées si vous n'indiquez rien.
    Mappage des modules vers les serveurs Dans la page Mappage des modules vers les serveurs, définissez les cibles de déploiement où vous souhaitez installer les modules contenus dans l'application. Les modules peuvent être installés sur la même cible de déploiement ou répartis sur plusieurs cibles de déploiement. Chaque module doit être mappé vers un serveur cible.

    Sur des produits monoserveurs, une cible de déploiement peut être un serveur d'applications ou un serveur Web.

    Sur des produits utilisant plusieurs serveurs, la cible de déploiement peut être un serveur d'applications, un cluster de serveurs d'applications ou un serveur Web.

    Indiquez les options requises pour compiler les JSP Si le paramètre Précompilation des fichiers JavaServer Pages est activé dans la page Sélectionner les options d'installation et que l'application utilise des fichiers JSP (JavaServer Pages), vous pouvez définir des options de compilation JSP dans la page Fournir des options pour compiler les pages JSP.
    Fournir des noms JNDI pour les beans Dans la page Noms JNDI pour les beans, indiquez un nom JNDI pour chaque bean enterprise de tous les modules EJB 2.1 et versions antérieures. Vous devez indiquer un nom JNDI pour chaque bean enterprise défini dans l'application. Par exemple, pour le module EJB MyBean.jar, définissez MyBean.

    Comme pour les modules EJB 3.x, vous pouvez préciser les noms d'interface JNDI, JNDI home locale, JNDI home distante ou ne pas en indiquer. Si vous n'indiquez pas de valeur, le produit en fournit une par défaut.

    Lier un métier EJB Dans la page >Lier un métier EJB, vous pouvez préciser les noms JNDI d'interface métier pour les modules EJB 3.x. Si vous indiquez un nom JNDI pour un bean dans la page Nom JNDI pour les beans, n'indiquez pas de nom JNDI d'interface métier dans cette page pour le même bean. Inversement, si vous n'indiquez pas de nom JNDI pour un bean, vous pouvez préciser un nom JNDI d'interface métier. Si vous n'indiquez pas de nom JNDI d'interface métier, le produit fournit un conteneur par défaut. Pour une vue sans interface, la valeur de l'interface métier est une chaîne vide ("").
    Mappage des sources de données par défaut pour les modules contenant des beans entity 1.x Si l'application utilise des modules EJB contenant des beans CMP (Container Managed Persistence) basés sur la spécification EJB 1.x, pour Mappage des sources de données par défaut pour les modules contenant des beans entity 1.x, spécifiez un nom JNDI pour la source de données par défaut des modules EJB. La source de données par défaut des modules EJB est facultative si les sources de données sont indiquées pour des beans CMP individuels.
    Mappage des références d'EJB vers les beans. Dans la page Mappage de références EJB avec des beans, si l'application définit des références EJB, indiquez des noms JNDI pour les beans enterprise qui représentent les noms logiques définis dans les références EJB.

    Si la référence EJB provient d'un module EJB 3.x ou Web 2.4 ou d'une version suivante, le nom JNDI est facultatif. Pour des modules antérieurs, chaque référence EJB définie dans l'application doit être liée à un fichier EJB.

    Si Autoriser la résolution automatique des cibles de référence d'EJB est activé, le nom JNDI est facultatif pour tous les modules. Le produit fournit une valeur de conteneur par défaut ou résout automatiquement la référence EJB pour les liaisons incomplètes.

    Mappage des références de ressources vers les ressources Si l'application définit des références de ressources pour Mappage de références de ressources vers des ressources, indiquez des noms JNDI pour les ressources qui représentent les noms logiques définis dans les références de ressources. Vous pouvez également spécifier le nom de configuration de connexion et les propriétés d'authentification de la ressource. Une fois les propriétés d'authentification spécifiées, cliquez sur OK pour enregistrer les valeurs et revenir à l'étape de mappage. Vous pouvez, si vous le souhaitez, indiquer des propriétés de source de données étendues pour activer une source de données utilisant un regroupement hétérogène pour se connecter à une base de données DB2. Chaque référence de ressource définie dans l'application doit être associée à une ressource définie dans la configuration de WebSphere Application Server avant que vous ne cliquiez sur Terminer dans la page Récapitulatif.
    Mappage des hôtes virtuels pour les modules Web Si l'application utilise des modules Web, pour Mappage des hôtes virtuels pour les modules Web, sélectionnez dans la liste l'hôte virtuel devant être associé à un module Web défini dans l'application. Le numéro de port défini dans la définition d'hôte virtuel est utilisé dans l'URL utilisée pour accéder aux artefacts, tels que les servlets et les fichiers JSP dans le module Web. Chaque module Web doit être associé à un hôte virtuel. Si tous les hôtes virtuels requis ne sont pas définis, une erreur de validation se produit dès que vous cliquez sur Terminer dans la page Récapitulatif.
    Mapper les rôles de sécurité vers les utilisateurs/groupes Si des rôles de sécurité sont définis dans le descripteur de déploiement de l'application, indiquez les utilisateurs et les groupes associés à chaque rôle de sécurité à l'étape Mappage des rôles de sécurité vers les utilisateurs/groupes. Sélectionnez Rôle pour sélectionner tous les rôles ou des rôles individuels. Vous pouvez indiquer si des utilisateurs prédéfinis, tels que Tous les utilisateurs ou Tous les utilisateurs authentifiés, sont associés à chacun des rôles. Pour sélectionner des utilisateurs ou des groupes spécifiques dans le registre des utilisateurs :
    1. Sélectionnez un rôle et cliquez sur Rechercher les utilisateurs ou Rechercher les groupes.
    2. Dans la page Rechercher les utilisateurs ou les groupes, qui s'affiche, entrez les critères de recherche afin d'extraire une liste d'utilisateurs ou de groupes depuis le registre des utilisateurs.
    3. Sélectionnez les utilisateurs ou les groupes de votre choix dans la fenêtre de résultats.
    4. Cliquez sur OK pour mapper les utilisateurs ou les groupes sélectionnés au rôle sélectionné dans la page Mappage des rôles de sécurité vers les utilisateurs/groupes.
    Mappage des règles d'exécution RunAs sur les utilisateurs Si des rôles d'exécution Run As sont définis dans le descripteur de déploiement de l'application, pour Mappage des rôles RunAs vers les utilisateurs, indiquez un nom d'utilisateur Run As et un mot de passe d'exécution pour chaque rôle Run As. Les rôles d'exécution Run As sont utilisés par les beans enterprise devant s'exécuter en tant que rôle particulier lors de l'interaction avec un autre bean enterprise. Sélectionnez Rôle pour sélectionner tous les rôles ou des rôles individuels. Après avoir sélectionné un rôle, entrez les valeurs pour le nom d'utilisateur et le mot de passe, vérifiez ce dernier et cliquez sur Valider.
    Assurez-vous que toutes les méthodes 1.x non protégées ont le niveau de protection correct Si l'application contient des beans CMP EJB 1.x pour lesquels des méthodes d'EJB ne possèdent pas de droits d'accès, indiquez si vous souhaitez conserver ces méthodes non protégées ou si vous souhaitez en interdire l'accès pour S'assurer que toutes les méthodes 1.x non protégées ont le niveau de protection correct.
    Liaison des programmes d'écoute pour les beans gérés par message Si l'application contient des beans enterprise gérés par messages, pour Liaison des programmes d'écoute pour les beans gérés par messages, fournissez un nom de port d'écoute ou un nom JNDI de spécification d'activation pour chaque bean géré par messages.
    Mappage des sources de données par défaut pour les modules contenant des beans entity 2.x Si l'application utilise des modules EJB qui contiennent des beans CMP fondés sur la spécification EJB 2.x, pour Spécification de la source de données par défaut pour les modules contenant les beans entity 2.x, indiquez un nom JNDI pour la source de données par défaut et le type d'autorisation des ressources devant être utilisé pour la source de données par défaut des modules EJB. Vous pouvez également spécifier un nom de configuration de connexion et des propriétés d'authentification pour la source de données. Lors de la création des propriétés d'authentification, cliquez sur OK pour enregistrer les valeurs et revenir à l'étape de mappage. En option, vous pouvez indiquer des propriétés de source de données étendues pour activer une source de données utilisant un regroupement hétérogène pour se connecter à une base de données DB2. La source de données par défaut des modules EJB est facultative si les sources de données sont indiquées pour des beans CMP individuels.
    Mapper les sources de données pour tous les beans CMP 2.x Si l'application contient des beans CMP basés sur la spécification EJB 2.x, indiquez, pour chaque bean CMP 2.x, un nom JNDI et le type d'autorisation des ressources pour les sources de données qui doivent être utilisées, dans la page Mappage des sources de données pour tous les beans CMP 2.x.

    Vous pouvez également spécifier un nom de configuration de connexion et des propriétés d'authentification pour la source de données. Lors de la création des propriétés d'authentification, cliquez sur OK pour enregistrer les valeurs et revenir à l'étape de mappage. L'attribut de source de données est facultatif pour les beans CMP individuels si une source de données par défaut est indiquée pour le module EJB qui contient les beans CMP. Si aucune source de données par défaut n'est définie pour le module EJB et les beans CMP individuels, une erreur de validation se produit dès que vous cliquez sur Terminer et l'installation est annulée.

    Assurez-vous que toutes les méthodes 2.x non protégées ont le niveau de protection correct Si l'application contient des beans CMP EJB 2.x pour lesquels aucune autorisation de méthode n'est définie dans les descripteurs de déploiement pour certaines méthodes d'EJB, dans la page S'assurer que toutes les méthodes 2.x non protégées ont le niveau de protection correct, indiquez si vous voulez affecter un rôle aux méthodes non protégées, ajouter des méthodes à la liste d'exclusion ou les marquer comme étant désélectionnées. Les méthodes ajoutées à la liste d'exclusion sont marquées comme étant non appelables. Pour les méthodes marquées comme étant désélectionnées, aucun vérification d'autorisation n'est effectuée avant qu'elles soient appelées.
    Indiquez les options requises pour le déploiement d'EJB Si le paramètre Déploiement de beans enterprise est activé dans la page Sélectionner les options d'installation, vous pouvez indiquer les options de l'outil de déploiement d'EJB dans la page Fournir des options pour effectuer le déploiement EJB. Dans cette page, vous pouvez indiquer des chemins d'accès aux classes, des options RMIC, des types de base de données et des noms de schémas de base de données supplémentaires devant être utilisés lors de l'exécution de l'outil de déploiement EJB.

    Vous pouvez indiquer dans cette page des options pour l'outil de déploiement d'EJB lorsque vous installez ou mettez à jour une application qui contient des modules EJB. L'outil de déploiement EJB s'exécute pendant l'installation des modules EJB 1.x ou 2.x. L'outil de déploiement d'EJB ne fonctionne pas lors de l'installation des modules EJB 3.x.

    Mappage des bibliothèques partagées Dans les pages Références de bibliothèque partagée et Mappage de bibliothèque partagée, spécifiez les fichiers de bibliothèque partagée que votre application ou vos modules Web utilisent. Il doit exister une bibliothèque partagée définie pour associer votre application ou votre module au fichier de bibliothèque.
    Mapper des relations de bibliothèque partagée Dans la page Mapper des relations de bibliothèque partagée de l'assistant, indiquez des identificateurs de relation et des noms d'unité de composition pour les bibliothèques partagées utilisées par les modules dans votre application enterprise EE.

    Lors de l'installation de votre application d'entreprise, le produit crée une unité de composition pour chaque relation de bibliothèque partagée de l'application de niveau métier que vous avez spécifiée dans la zone Nom de l'application métier de la page Sélection des options d'installation.

    Options de rechargement JSP des modules Web Si l'application utilise des modules Web, configurez le rechargement des classes des fichiers JSP (JavaServer Pages) à l'étape Options de rechargement JSP des modules Web.
    Mappage des racines de contexte des modules Web Si l'application utilise des modules Web qui sont définis dans le descripteur de déploiement de l'application XML, indiquez une racine de contexte pour chacun des modules Web dans cette application à l'étape Mappage des racines de contexte des modules Web.

    Le produit n'inclut pas les modules Web depuis les annotations dans cette page

    Initialisation des paramètres initiaux des servlets Si l'application utilise des modules Web qui prennent en charge Servlet 2.5, à l'étape Initialisation des paramètres initiaux des servlet, indiquez ou remplacez les paramètres initiaux transmis à la méthode d'initialisation des filtres de servlet des modules Web.

    Cette page indique les servlets du descripteur de déploiement XML du module. Les informations de déploiement de servlet provenant des annotations ne sont pas disponibles dans cette page.

    Mappage des entrées d'environnement des modules EJB Si l'application utilise des modules EJB, configurez les entrées d'environnement des modules EJB, tels que les beans gérés par messages, session ou entity à l'étape Mappage des entrées d'environnement des modules EJB.
    Mappage des entrées d'environnement des modules client Si vous déployez un ou plusieurs modules client d'application, définissez les entrées d'environnement des modules client déployés comme fichiers JAR lors de l'étape Mappage des entrées d'environnement des modules client. Pour afficher la page Mappage des entrées d'environnement des modules client, sélectionnez l'option Déployer les modules client dans la page Sélection des options d'installation page.
    Mappage des entrées d'environnement des modules Web Si l'application utilise des modules Web qui prennent en charge Servlet 2.5, à l'étape Mappage des entrées d'environnement des modules Web, configurez les entrées d'environnement des modules Web tels que les servlets et les fichiers JSP.
    Mappage des entrées d'environnement pour le niveau application Si votre application définit une ou plusieurs entrées d'environnement, pour Mappage des entrées d'environnement pour le niveau application, configurez les entrées d'environnement d'applications qui sont déployées en tant que fichiers EAR.
    Mappage des références d'entrée d'environnement vers les ressources Si l'application contient des références d'environnement de ressources, à l'étape Mappage des références d'entrée d'environnement vers les ressources, indiquez des noms JNDI désignant des ressources correspondant aux noms logiques définis dans ces références. Si une ressource n'est pas associée à chaque référence d'environnement de ressources, une erreur de validation se produit dès que vous cliquez sur Terminer.
    Utilisation adéquate de l'identité système Si l'option Identité d'exécution (RunAs) a la valeur Identité système dans l'application, vous pouvez remplacer cette valeur par Rôle RunAs et indiquer le nom d'utilisateur et le mot de passe destiné au rôle d'exécution à l'étape Utilisation correcte de l'identité système. Lorsque la valeur Identité système est sélectionnée, l'appel s'effectue à l'aide de l'ID du serveur de sécurité WebSphere Application Server. Ce dernier doit être utilisé avec précaution en raison du nombre important de droits qui lui est associé.
    Niveaux d'isolation corrects pour toutes les références de ressource Si l'application comporte des références de ressources mappées vers des ressources faisant appel en arrière-plan à une base de données Oracle, indiquez ou corrigez le niveau d'isolement adapté aux ressources de ce type à l'étape Correction des niveaux d'isolement pour toutes les références de ressource. Les bases de données Oracle prennent en charge uniquement les niveaux d'isolement ReadCommitted et Serializable.
    Mapper le fournisseur JASPI Dans la page Fournisseur JASPI, vous pouvez définir des valeurs pour remplacer les paramètres JASPI de la configuration de sécurité globale ou de domaine. Par défaut, une application hérite des paramètres JASPI définis dans la configuration de sécurité globale ou de domaine de WebSphere Application Server et les modules Web héritent des paramètres de l'application.
    Liaison des références de destination de message aux objets administrés Si l'application utilise des beans gérés par message, indiquez le nom JNDI de l'objet administré J2C pour lier la référence de destination des messages aux beans gérés par message, à l'étape Liaison des références de destination de message aux objets administrés.

    Si la référence de destination des messages provient d'un module EJB 3.0 ou version ultérieure, le nom JNDI est facultatif et la phase d'exécution fournit une une valeur de conteneur par défaut.

    Avertissement : Si plusieurs références de destination de messages sont liées à la même destination de message, un seul nom JNDI est collecté. Lorsqu'une référence de destination de message est liée à la même destination de message qu'un bean géré par message que le nom JNDI de destination a déjà été collecté, le nom JNDI de destination de la référence de destination du message n'est pas collecté.
    Fourniture de noms JNDI pour les objets JCA Si l'application contient un fichier .rar imbriqué pour Fourniture de noms JNDI pour les objets JCA, indiquez le nom et le nom JNDI de chaque fabrique de connexion objet administré et spécification d'activation.
    Liaison de J2C activationspecs aux noms JNDI de destination Si l'application contient un fichier .rar imbriqué, que la valeur Destination est attribuée à sa propriété activationSpec et que son type analysé est javax.jms.Destination, indiquez la valeur jndiName pour chaque activation qui lui est liée, à l'étape Liaison de J2C ActivationSpec aux noms JNDI de destination.
    Sélection de l'ID du système dorsal en cours Si l'application comporte des modules EJB pour lesquels un code de déploiement a été généré pour plusieurs bases de données dorsales à l'aide d'un outil d'assemblage, indiquez l'ID dorsal représentant la base de données dorsale à utiliser lors de l'exécution du module EJB, à l'étape Sélection de l'ID du système dorsal en cours.

    Pour plus d'informations sur les bases de données dorsales, voir les rubriques relatives à l'outil de déploiement EJB.

    Cette étape n'est pas présentée si le paramètre Déploiement de beans enterprise est activé dans la page Sélectionner les options d'installation et si un type de base de données autre que Aucun est spécifié dans la page Fournir des options pour effectuer le déploiement EJB.

    Métadonnées des modules Si votre application comporte des modules EJB 3.x ou Web 2.5, vous pouvez verrouiller les descripteurs de déploiement pour un ou plusieurs de ces modules. Si vous définissez l'attribut metadata-complete sur true et verrouillez les descripteurs de déploiement, le produit écrit le descripteur de déploiement du module complet, incluant les informations de déploiement des annotations, au format XML.
    Fourni des options pour effectuer le déploiement des services Web Si le paramètre Déploiement de services Web est activé dans la page Sélection des options d'installation et que l'application utilise des services Web, vous pouvez définir des options pour la commande wsdeploy dans la page Fournir des options pour effectuer le déploiement de services Web. Pour plus d'informations sur cette page, consultez la description des options wsdeploy -cp et -jardir.
    Configurez les propriétés de la distribution de requête à distance Si vous utilisez un distributeur de requête à distance, vous devez préalablement le configurer. Le répartiteur de requêtes distantes est une extension connectable au conteneur Web qui permet d'inclure dans des infrastructures, servlets et pages JSP (JavaServer Pages) d'application un contenu extérieur à la machine virtuelle Java de la ressource en cours d'exécution, dans le cadre de la réponse renvoyée au client. Pour plus d'informations sur l'emplacement de configuration de ces propriétés dans la console d'administration, voir les paramètres de propriétés du répartiteur distant.
    Affichage de l'ID de génération du module Si le fichier MANIFEST.MF d'un module d'une application d'entreprise contient un identificateur de génération, cette page l'affiche.
  5. Dans la page Récapitulatif, vérifiez la cellule, le noeud et le serveur sur lesquels les modules d'application doivent être installés :
    1. A côté de Cellule/Noeud/Serveur, cliquez sur Cliquez ici.
    2. Vérifiez les paramètres.
    3. Revenez à la page Récapitulatif.
    4. Cliquez sur Finish.

Résultats

Plusieurs messages s'affichent et indiquent si l'installation du fichier d'application a abouti.

Si la valeur avertissement (sélectionnée par défaut) est associée à l'option Entrée de validation désactivée/avertissement/échec dans la page Sélection des options d'installation, plusieurs avertissements de validation peuvent apparaître. Si la valeur échec est utilisée, les avertissements liés à la validation peuvent provoquer des erreurs.

Si vous recevez une exception OutOfMemory et que le fichier d'application source ne s'installe pas, il se peut que votre système ne dispose pas de la mémoire suffisante ou que l'application contienne trop de modules pour s'installer sur le serveur. Dans ce cas, vérifiez le fichier SystemOut.log ou SystemErr.log, ainsi que les fichiers FFDC (outil de diagnostic de premier niveau) des machines impliquées dans l'erreur, afin de déterminer les processus Java et le système à l'origine de l'erreur. Sur le système sur lequel l'exception s'est produite, essayez d'augmenter la taille maximale de segment de mémoire Java de 256 mégaoctets. Pour plus d'informations, voir la documentation sur l'optimisation de la machine virtuelle IBM pour Java. Après avoir ajusté la taille maximale de segment de mémoire Java, essayez d'installer à nouveau le fichier d'application. Selon la quantité de mémoire requise pour l'installation de cette application, vous devrez peut-être augmenter plusieurs fois la taille maximale de segment de mémoire. si vous atteignez la taille maximale prise en charge pour votre machine virtuelle Java et que le problème persiste, essayez de conditionner à nouveau votre application de sorte qu'elle dispose de moins de modules.

[z/OS]Si vous utilisez l'assistant d'installation dans un navigateur Internet Explorer, l'installation de l'application échouera de façon intermittente. Le navigateur Internet Explorer n'envoie pas toutes les données chiffrées attendues par le serveur. Pour installer l'application, utilisez l'assistant d'installation d'application du navigateur Firefox 1.5 ou une version ultérieure, ou utilisez l'outil wsadmin.

[z/OS]Sur les systèmes d'exploitation z/OS, les fichiers d'application d'une taille supérieure à 10 Mo peuvent ne pas s'installer. Lorsque la propriété personnalisée protocol_http_large_data_inbound_buffer du serveur d'applications a la valeur (0) (valeur par défaut) vous ne pouvez pas installer des fichiers de plus de 10 Mo. Affectez à la propriété protocol_http_large_data_inbound_buffer une valeur supérieure à la taille du fichier de l'application. Si, par exemple, le fichier EAR à installer est de 15 Mo, affectez à protocol_http_large_data_inbound_buffer la valeur 20 Mo :
  1. Cliquez sur Serveurs > Types de serveurs > Serveurs d'applications WebSphere > nom_serveur > Infrastructure de serveur > Administration > Propriétés personnalisées.
  2. Affectez à la propriété personnalisée protocol_http_large_data_inbound_buffer du serveur d'applications la valeur 20000000.
  3. Arrêtez, puis redémarrez le serveur d'applications.
  4. Essayez de réinstaller le fichier EAR.

Que faire ensuite

Une fois le fichier d'application installé, procédez comme suit :

  1. Sauvegardez les modifications de la configuration.

    Par exemple, cliquez sur le lien Sauvegarder dans les messages d'installation de l'application.

    L'application est enregistrée dans la configuration d'administration et les fichiers d'application sont copiés dans le répertoire cible, qui correspond par défaut à racine_serveur_app/installedApps/nom_cellule ou au répertoire indiqué.

    Dans le cas d'un serveur unique, les fichiers d'application sont copiés dans le répertoire cible lorsque les modifications sont sauvegardées.

    Dans le cas de plusieurs serveurs, les fichiers sont copiés sur des noeuds distants lorsque la configuration sur le gestionnaire de déploiement se synchronise à celle sur des noeuds individuels.

    Si vous avez cliqué sur le lien Sauvegarder dans les messages d'installation de l'application, la page Préparation à l'installation de l'application réapparaît. Cliquez sur Applications > Types d'application > Applications WebSphere enterprise pour quitter cette page et retrouver votre application dans la liste des applications installées.

  2. Démarrer l'application.
  3. Testez l'application. Par exemple, entrez l'URL de l'application déployée dans la barre du navigateur Web et contrôlez les performances de l'application. Si nécessaire, modifiez la configuration de l'application.

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-nd-mp&topic=trun_app_instwiz
Nom du fichier : trun_app_instwiz.html