Paramètres de préparation à l'installation de l'application

Cette page permet d'installer une application (fichier EAR) ou un module (fichier JAR ou WAR).

Pour afficher la page de la console d'administration, sélectionnez Applications > Installation d'une nouvelle application.

Suivez les étapes décrites dans cette page pour installer une application ou un module. Vous devez au moins exécuter la première étape, puis ultérieurement la totalité des étapes suivantes ou seulement certaines d'entre elles, selon que vous installez une application, un module EJB ou un module Web.

Chemin
Indique le chemin d'accès complet au fichier .ear, .jar, ou .war pour l'application d'entreprise.

Utilisez Chemin d'accès local si les fichiers d'application et du navigateur se trouvent sur la même machine (que le serveur soit ou non également sur cette même machine).

Utilisez Chemin d'accès au serveur si le fichier d'application réside sur un noeud du contexte de cellule actuel. Vous pouvez parcourir le système de fichiers complet d'un noeud si l'agent de noeud ou le gestionnaire de déploiement est en cours d'exécution sur le noeud sélectionné. Seuls les fichiers .ear, .jar ou .war apparaissent pendant l'exploration.

Lors de l'installation de l'application, les fichiers de l'application sont téléchargés d'un poste client exécutant un navigateur vers le poste serveur exécutant la console d'administration afin d'y être déployés. Dans de tels cas, le navigateur Web exécutant la console d'administration est utilisé pour sélectionner les modules EAR, WAR ou JAR à télécharger sur la machine serveur.

Toutefois, dans certains cas, les fichiers d'application se trouvent dans le système de fichiers d'un noeud d'une cellule. Pour que le serveur d'applications installe ces fichiers, utilisez l'option Chemin d'accès au serveur.

Vous pouvez également utiliser cette option pour spécifier un fichier d'application résidant déjà sur la machine exécutant le serveur d'applications. Par exemple, sous Windows NT, la valeur de la zone peut être C:\WebSphere\AppServer\installableApps\test.ear. Si vous installez un module WAR autonome, vous devez également indiquer la racine du contexte.

Racine du contexte
Spécifie la racine du contexte de l'application Web (WAR).

Cette zone est utilisée uniquement pour installer un fichier WAR autonome. La racine du contexte est combinée avec le mappage de servlet défini (à partir du fichier WAR) pour composer l'URL complète que les utilisateurs saisissent pour accéder au servlet. Par exemple, si la racine du contexte est /gettingstarted et que le mappage du servlet est MaSession, l'URL est http://host:port/gettingstarted/MaSession.

Générer des liaisons par défaut
Indique si des liaisons doivent être générées par défaut. si vous sélectionnez la case, toute liaison incomplète dans l'application est remplie avec les valeurs par défaut. Les liaisons existantes ne sont pas modifiées.

En choisissant cette option, vous pouvez passer directement à l'étape Résumé et installer l'application si aucune des étapes n'est marquée d'un astérisque (*) de couleur rouge. Ce dernier indique que l'étape comporte des données incomplètes et qu'une valeur valide doit lui être affectée. Dans le panneau Résumé, vérifiez la cellule, le noeud et le serveur sur lequel l'application va être installée.

Les liaisons sont générées comme suit :

La stratégie par défaut est suffisante pour la plupart des applications ou au moins pour la plupart des liaisons de la plupart des applications. Toutefois, elle ne fonctionne pas si :

Dans de tels cas, vous pouvez modifier le comportement avec un document XML (stratégie personnalisée). Utilisez la zone Fichier de liaisons spécifique pour spécifier une stratégie personnalisée et reportez-vous à l'aide sur la zone pour obtenir des exemples.

Préfixes
Spécifie les préfixes à utiliser pour les noms JNDI générés.
Remplacer
Indique si les liaisons existantes doivent être ou non remplacées.

Si cette case est cochée, les liaisons existantes sont remplacées par celles qui sont générées.

Liaisons CMP EJB 1.1
Spécifie le nom JNDI de la source de données par défaut.

Si le bouton d'option Liaisons par défaut des CMP EJB 1.1 est sélectionné, indiquez le nom JNDI de la source de données par défaut devant être utilisée avec les beans CMP 1.1. Spécifiez également l'ID utilisateur et le mot de passe pour cette source de données par défaut.

Liaisons de la fabrique de connexions
Spécifie le nom JNDI de la source de données par défaut.

Si le bouton d'option Liaisons de la fabrique de connexions par défaut est sélectionné, indiquez le nom JNDI de la source de données par défaut devant être utilisée avec les liaisons. Indiquez également l'autorisation de ressource.

Hôte virtuel
Indique l'hôte virtuel des modules WAR.
Fichier de liaisons spécifiques
Indique un fichier de liaisons qui remplace la liaison par défaut.

Modifiez le comportement de la liaison par défaut à l'aide d'un document XML (stratégie personnalisée aka). Les stratégies personnalisées étendent la stratégie par défaut de telle sorte que vous n'avez qu'à personnaliser les zones où cette dernière est insuffisante. Autrement dit, vous n'avez qu'à décrire comment vous souhaitez modifier les liaisons générées par la stratégie par défaut. Il ne vous est pas nécessaire de définir les liaisons pour l'application entière.

Ci-dessous figurent de courts exemples de la procédure de remplacement de divers aspects du générateur de liaisons par défaut.

Contrôle d'un nom JNDI d'EJB

<?xml version="1.0"?>
<!DOCTYPE dfltbndngs SYSTEM "dfltbndngs.dtd">
<dfltbndngs>
  <module-bindings>
    <ejb-jar-binding>
      <jar-name>helloEjb.jar</jar-name>
<!-- ce nom doit correspondre au nom de module du fichier .ear -->
      <ejb-bindings>
        <ejb-binding>
         <ejb-name>HelloEjb</ejb-name>
<!-- ceci doit correspondre à l'entrée <ejb-name> du DD de jar d'EJB -->
         <jndi-name>com/acme/ejb/HelloHome</jndi-name>
        </ejb-binding>
      </ejb-bindings>
    </ejb-jar-binding>
  </module-bindings>
</dfltbndngs>

Définition de liaison de fabrique de connexions pour un fichier JAR EJB

<!DOCTYPE dfltbndngs SYSTEM "dfltbndngs.dtd">
<dfltbndngs>
  <module-bindings>
    <ejb-jar-binding>
      <jar-name>yourEjb20.jar</jar-name>
      <connection-factory>
        <jndi-name>eis/jdbc/YourData_CMP</jndi-name>
        <res-auth>Container</res-auth>
      </connection-factory>
    </ejb-jar-binding>
  </module-bindings>
</dfltbndngs>

Définition de la liaison de fabrique de connexion pour un fichier EJB

<?xml version="1.0">
<!DOCTYPE dfltbndngs SYSTEM "dfltbndngs.dtd">
<dfltbndngs>
  <module-bindings>
    <ejb-jar-binding>
      <jar-name>yourEjb20.jar</jar-name>
      <ejb-bindings>
        <ejb-binding>
          <ejb-name>YourCmp20</ejb-name>
<!-- ceci correspond à la balise ejb-name dans le descripteur de déploiement -->
          <connection-factory>
           <jndi-name>eis/jdbc/YourData_CMP</jndi-name>
           <res-auth>PerConnFact</res-auth>
          </connection-factory>
        </ejb-binding>
      </ejb-bindings>
    </ejb-jar-binding>
 </module-bindings>
</dfltbndngs>

Remplacement d'une liaison de référence de ressource à partir d'un fichier WAR, JAR EJB ou d'un fichier JAR client J2EE

Ci-après figure un exemple de code de remplacement d'une liaison de référence de ressource à partir d'un fichier WAR. Utilisez un code similaire pour remplacer une liaison de référence de ressource à partir d'un fichier JAR EJB ou d'un fichier JAR client J2EE.

<?xml version="1.0"?>
<!DOCTYPE dfltbndngs SYSTEM "dfltbndngs.dtd">
<dfltbndngs>
  <module-bindings>
    <war-binding>
      <jar-name>hello.war</jar-name>
      <resource-ref-bindings>
        <resource-ref-binding>
          <!-- ce qui suit doit correspondre à la référence de ressource dans le DD -->
          <resource-ref-name>jdbc/MyDataSrc</resource-ref-name>
          <jndi-name>war/override/dataSource</jndi-name>
        </resource-ref-binding>
      </resource-ref-bindings>
    </war-binding>
  </module-bindings>
</dfltbndngs>

Remplacement des ports d'écoute JMS MDB

<?xml version="1.0"?>
<!DOCTYPE dfltbndngs SYSTEM "dfltbndngs.dtd">
<dfltbndngs>
  <module-bindings>
    <ejb-jar-binding>
      <jar-name>YourEjbJar.jar</jar-name>
      <ejb-bindings>
        <ejb-binding>
          <ejb-name>YourMDB</ejb-name>
          <listener-port>yourMdbListPort</listener-port>
        </ejb-binding>
      </ejb-bindings>
    </ejb-jar-binding>
  </module-bindings>
</dfltbndngs>

Informations connexes

Boutons de la console administrative