Cette page permet d'indiquer les options d'installation d'une application Java Platform, Enterprise Edition (Java EE) sur une cible de déploiement WebSphere Application Server. Des valeurs par défaut sont employées pour ces options si vous n'indiquez rien. Après l'installation de l'application, vous pouvez indiquer des valeurs pour la plupart de ces options depuis une page de paramètres d'application d'entreprise.
Pour afficher cette page de la console d'administration, cliquez sur Applications > Nouvelle application > Nouvelle application d'entreprise, puis indiquez les valeurs adaptées à votre application dans les pages Préparation de l'installation de l'application.
La page Sélection des options d'installation est la même pour les assistants d'installation et de mise à jour d'application.
Indiquez si vous devez précompiler des fichiers JSP (JavaServer Pages) dans le cadre de l'installation. Par défaut, les fichiers JSP ne sont pas précompilés.
Pour cette option, effectuez l'installation uniquement sur une cible de déploiement des versions 6.1 ou ultérieures.
Si vous sélectionnez Précompilation des fichiers JavaServer Pages et que vous tentez d'installer votre application sur une cible de déploiement antérieure (version 5.x par exemple), l'installation sera rejetée. Vous pouvez déployer des applications uniquement vers des cibles de déploiement de même version que le produit. Si les applications sont ciblées vers des serveurs dont la version est antérieure à celle du produit, le déploiement est impossible.
Type de données | Booléen |
Valeur par défaut | false |
Indique le répertoire dans lequel le fichier EAR (entreprise archive) doit être installé.
Par défaut, le fichier EAR est installé dans le répertoire racine_profil/installedApps/nom_cellule/nom_application.ear.
Les choix disponibles sont les suivants :
La valeur par défaut est ${APP_INSTALL_ROOT}/nom_cellule, où la variable ${APP_INSTALL_ROOT} est racine_profil/installedApps. Un répertoire ayant le nom du fichier EAR de l'application en cours d'installation est ajouté à ${APP_INSTALL_ROOT}/nom_cellule. Ainsi, si vous n'indiquez un répertoire, le fichier EAR est installé dans le répertoire racine_profil/installedApps/nom_cellule/nom_application.ear.
Si vous indiquez un répertoire dans la zone Répertoire dans lequel installer l'application, l'application est installée dans le répertoire chemin_spécifié/nom_application.ear. Autrement dit, un répertoire portant le nom de fichier EAR de l'application installée est ajouté à la suite du chemin que vous spécifiez dans la zone Répertoire dans lequel installer l'application. Par exemple, si vous installez Clock.ear et indiquez C:/myapps sur des machines Windows, l'application est installée dans le répertoire myapps/Clock.ear. La variable ${APP_INSTALL_ROOT} est définie sur le chemin spécifié.
Si vous souhaitez exporter l'application à partir d'une cellule et installer ultérieurement l'application exportée dans une autre cellule, indiquez la variable ${CELL} à lapremière installation de l'application. Par exemple, indiquez ${APP_INSTALL_ROOT}/${CELL} pour ce paramètre. L'exportation de l'application crée un fichier EAR étendu, ainsi appelé parce qu'il contient à la fois l'application elle-même et sa configuration de déploiement. La configuration de déploiement conserve le nom de la cellule de l'installation initiale dans le répertoire de destination sauf si vous indiquez la variable ${CELL}. La définition de la variable ${CELL} permet de s'assurer que le répertoire de destination possède le nom de la cellule en cours et non celui de la cellule d'origine.
Le fichier EAR exporté est appelé fichier EAR étendu parce qu'il contient à la fois l'application elle-même et sa configuration de déploiement. La valeur utilisée dans la zone Répertoire dans lequel installer l'application lors de la précédente installation de l'application est mémorisée dans la configuration de déploiement. Sauf si vous spécifiez une valeur différente dans la zone Répertoire dans lequel installer l'application, le fichier EAR étendu sera installé dans le même répertoire que celui de l'installation précédente.
Si vous n'avez pas indiqué la variable ${CELL} lors de l'installation initiale, la configuration de déploiement utilise le nom de la cellule de l'installation initiale dans le répertoire de destination. En cas d'installation sur une autre cellule, indiquez le répertoire ${APP_INSTALL_ROOT}/nom_cellule/nom_application.ear, où nom_cellule est le nom de la cellule dans laquelle vous souhaitez installer le fichier EAR étendu. Si vous ne désignez pas explicitement la cellule courante dans la partie nom_cellule du chemin d'installation, le nom de la cellule d'origine sera utilisé, même si vous installez le fichier EAR étendu dans une cellule portant un nom différent.
Vous pouvez indiquer un chemin absolu ou utiliser une variable de mappe de chemins d'accès comme ${MY_APPS}. Vous pouvez utiliser une variable de mappe de chemins d'accès dans n'importe quelle installation.
Une variable de mappe des chemins d'accès s'avère indispensable lors de l'installation d'une application dans un cluster dont les membres font partie de noeuds hétérogènes car, dans ce cas, il n'existe aucun autre moyen de spécifier un chemin d'accès absolu. Une WebSphere Application Server variable ${CELL} désignant le nom de cellule actuel peut également figurer dans la variable de mappe des chemins d'accès. Par exemple, ${MY_APP}/${CELL}. Vous pouvez définir des variables WebSphere Application Server dans la page de la console Variables WebSphere, en cliquant sur Environnement > Variables WebSphere.
La zone Répertoire dans lequel installer l'application est similaire au paramètre Emplacement (chemin complet) de la page des fichiers binaires d'application.
Type de données | Chaîne |
Unité | Nom de chemin d'accès complet |
Indique si, à l'installation, le produit doit développer (extraire) les fichiers binaires de l'application dans l'emplacement d'installation et s'il doit les supprimer à la désinstallation. Par défaut, la distribution de l'application est activée. Les fichiers binaires des applications installées sont développés dans le répertoire indiqué.
Dans le cas de produits monoserveurs, les fichiers binaires sont supprimés lors de la désinstallation et de la sauvegarde des modifications dans la configuration.
Dans le cas de produits multiserveurs, les fichiers binaires sont supprimés lors de la désinstallation, de la sauvegarde des modifications dans la configuration, et de la synchronisation des modifications.
Si vous désactivez cette option, vous devez vous assurer que les fichiers binaires de l'application sont étendus de manière appropriée dans les répertoires de destination de tous les noeuds sur lesquels l'application s'exécute.
La zone Distribution de l'application est similaire au paramètre Activer la distribution, l'extension et le nettoyage binaires après la désinstallation de la page des fichiers binaires d'application.
Type de données | Booléen |
Valeur par défaut | true |
Indique si le serveur d'applications utilise les liaisons, les extensions et les descripteurs de déploiement situés au même endroit que le document de déploiement de l'application, le fichier deployment.xml (par défaut), ou ceux qui se trouvent dans le fichier EAR (Enterprise Archive) de l'application. Sélectionnez ce paramètre uniquement pour les applications installées sur les cibles de déploiement des versions 6.0 ou ultérieures. Ce paramètre n'est pas valide pour des applications installées sur des cibles de déploiement 5.x.
La valeur par défaut (false) signifie que les descripteurs de liaison, d'extension et de déploiement situés dans deployment.xml ne peuvent pas être utilisés. Pour utiliser les descripteurs de liaison, d'extension et de déploiement situés dans le fichier EAR, activez ce paramètre (true).
La zone Utiliser la configuration binaire est similaire au paramètre Utiliser les informations de configuration en binaire de la page des fichiers binaires d'application.
Type de données | Booléen |
Valeur par défaut | false |
Indiquez si l'outil EJBDeploy est exécuté lors de l'installation de l'application.
L'outil de déploiement EJB s'exécute lors de 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.0.
Pour cette option, effectuez l'installation uniquement sur une cible de déploiement des versions 6.1 ou ultérieures.
Si vous sélectionnez Déploiement de beans enterprise et que vous tentez d'installer votre application sur une cible de déploiement plus récente (version 6.0 par exemple), l'installation est rejetée. Vous pouvez uniquement déployer des applications vers des cibles dont la version de WebSphere est identique à celle du produit. Si les applications sont ciblées vers des serveurs dont la version est antérieure à celle du produit, le déploiement est impossible.
De plus, si vous sélectionnez Déploiement des beans enterprise et spécifiez un type de base de données dans la page Fournir les options pour effectuer le déploiement d'EJB, les ID dorsaux précédemment définis pour tous les modules EJB sont écrasés par le type de base de données choisi. Pour activer les ID dorsaux pour les modules EJB individuels, paramétrez le type de base de données à "" (null) dans la page Fournir les options pour effectuer le déploiement d'EJB.
L'activation de ce paramètre peut provoquer l'exécution du programme d'installation pendant plusieurs minutes.
Type de données | Booléen |
Valeur par défaut | true (false pour les modules EJB 3.0) |
Indique le nom logique de l'application. Un nom d'application doit être unique au sein de la cellule et ne peut pas contenir de caractère non pris en charge.
Un nom d'application ne peut pas commencer par un point (.)et ne peut pas contenir d'espace en début ou en fin de nom, ni les caractères suivants :
Caractères non autorisés | ||
---|---|---|
⁄ barre oblique | $ signe dollar | ' apostrophe |
\ barre oblique inversée | = signe égale | " guillemet |
* astérisque | % signe pourcentage | | barre verticale |
, virgule | + signe plus | < signe inférieur à |
: signe deux-points | @ arobase | > signe supérieur à |
; point-virgule | # dièse | & perluète |
? point d'interrogation | ]]> Aucun nom spécifique n'existe pour cette combinaison de caractères. |
La zone Nom de l'application est similaire au paramètre Nom de la page des paramètres d'application d'entreprise.
Type de données | Chaîne |
Indique s'il faut créer des MBeans pour des ressources telles que des servlets ou des fichiers JSP dans une application à son démarrage. Par défaut, des MBeans sont créés.
La zone est similaire au paramètre Créer des MBeans pour les ressources de la page de comportement au démarrage.
Type de données | Booléen |
Valeur par défaut | true |
Indique si la phase d'exécution du produit détecte des modifications apportées aux classes de l'application lorsque celle-ci est en cours d'exécution. Si ce paramètre est activé, lorsque les classes d'application sont modifiées, l'application est arrêtée et redémarrée afin de charger les classes mises à jour.
Par défaut, le rechargement des classes n'est pas activé.
Cette zone est similaire au paramètre Remplacer les paramètres de rechargement de classe des modules Web et EJB de la page de chargement de classe et de détection de mise à jour.
Type de données | Booléen |
Valeur par défaut | false |
Indique le nombre de secondes nécessaire au scannage du système de fichiers de l'application dans le but de rechercher les fichiers mis à jour. La valeur par défaut correspond à celle de l'attribut de l'intervalle de rechargement dans le fichier d'extension IBM (META-INF/ibm-application-ext.xmi) du fichier EAR.
L'attribut d'intervalle de rechargement n'a d'effet que si le rechargement des classes est activé.
Pour activer le rechargement, spécifiez une valeur supérieure à zéro (par exemple, 1 à 2147483647). Pour désactiver le rechargement, spécifiez zéro (0). Les valeurs possibles sont comprises entre 0 et 2147483647.
La zone Intervalle de rechargement en secondes est identique au paramètre Intervalle d'interrogation des fichiers mis à jour de la page Chargement de classes et détection de mise à jour.
Type de données | Entier |
Unité | Secondes |
Valeur par défaut | 3 |
Indique si l'outil de déploiement des services Web wsdeploy s'exécute lors de l'installation de l'application.
L'outil génère le code permettant d'exécuter des applications utilisant des services Web. Par défaut, l'outil wsdeploy n'est pas exécuté. Vous devez activer ce paramètre si le fichier EAR contient des modules utilisant des services Web et que l'outil wsdeploy n'a pas encore été exécuté sur ce fichier. Pour ce faire, choisissez l'option de menu Déployer dans un outil d'assemblage ou à partir de la ligne de commande.
Pour cette option, effectuez l'installation uniquement sur une cible de déploiement des versions 6.1 ou ultérieures.
Si vous sélectionnez Déploiement de services Web et tentez d'installer votre application sur une cible de déploiement antérieure, version 5.x par exemple, l'installation est rejetée. Vous pouvez déployer des applications uniquement vers des cibles dont la version est identique à celle du produit. Si les applications sont ciblées vers des serveurs dont la version est antérieure à celle du produit, le déploiement est impossible.
Type de données | Booléen |
Valeur par défaut | false |
Indique si le produit étudie les références d'application indiquées lors de l'installation ou de la mise à jour de l'application et, si la validation est activée, s'il vous avertit de références erronées ou de l'échec de l'opération.
Une application fait généralement référence à des ressources à l'aide de sources de données pour les beans CMP (container managed persistence) ou de références de ressources et d'environnement de ressources définies dans des descripteurs de déploiement. La validation vérifie si la ressource référée par l'application est définie dans la portée de la cible de déploiement de cette application.
Sélectionnez désactivée si vous ne souhaitez aucune validation de ressource, avertissement pour des messages d'avertissement au sujet de références incorrectes de ressources, ou échec pour arrêter des opérations en échec en raison de références erronées de ressources.
La zone Entrée de validation désactivée/avertissement/échec est identique au paramètre Validation de la référence d'application de la page des paramètres d'application d'entreprise.
Type de données | Chaîne |
Valeur par défaut | avertissement |
Indique si la configuration imbriquée doit être traitée. Une configuration imbriquée se compose de fichiers, tels que resource.xml et variables.xml. Une fois sélectionnée ou portant la valeur true, la configuration imbriquée est chargée sur la portée de l'application à partir du fichier .ear. Si le fichier .ear n'a pas de configuration imbriquée, la valeur par défaut est false. Si le fichier .ear comporte une configuration imbriquée, la valeur par défaut est true.
Ce paramètre concerne l'installation des fichiers EAR étendus. Vous obtenez un fichier EAR étendu quand vous exportez une application installée.
Si la valeur du paramètre est false, un fichier EAR étendu est installé comme n'importe quelle autre application et le produit ignore sa configuration intégrée.
Si vous avez exporté l'application à partir d'une cellule autre que la cellule active et que vous n'avez pas spécifié la variable $(CELL) pour Répertoire d'installation de l'application quand vous avez installé l'application au départ, désélectionnez ce paramètre (valeur false) pour développer le fichier EAR étendu dans le répertoire racine_profil/installedApps/nom_cellule_active. Sinon, si vous avez sélectionné ce paramètre (valeur true), le fichier EAR étendu est développé dans le répertoire racine_profil/installedApps/nom_cellule_origine, où nom_cellule_origine désigne la cellule où l'application a été installée au départ. Si, lors de la première installation de l'application, vous avez spécifié la variable $(CELL) dans la zone Répertoire d'installation de l'application, l'installation développe le fichier EAR étendu dans le répertoire racine_profil/installedApps/nom_cellule_active.
Type de données | Booléen |
Valeur par défaut | false (non sélectionné) |
Indique les fichiers binaires des applications installées qui sont développés dans le répertoire indiqué.
L'option Distribution de l'application doit être activée pour définir les droits d'accès aux fichiers.
Vous pouvez définir les droits d'accès aux fichiers dans la zone de texte. Vous pouvez également définir certains droits d'accès aux fichiers fréquemment utilisés en les sélectionnant dans la liste à choix multiples. Les sélections de la liste remplacent les autorisations des fichiers définis dans la zone de texte.
Vous pouvez définir dans la liste une ou plusieurs chaînes de droit d'accès aux fichiers suivantes. En sélectionnant plusieurs options, vous combinez les chaînes de droit d'accès aux fichiers.
Option de la liste à choix multiples | Chaîne de droit d'accès aux fichiers définie |
---|---|
Tous les fichiers sont accessibles en lecture mais pas en écriture | .*=755 |
Autorise l'exécution des fichiers exécutables | .*\.dll=755#.*\.so=755#.*\.a=755#.*\.sl=755 |
Les fichiers HTML et images sont accessibles en lecture à quiconque | .*\.htm=755#.*\.html=755#.*\.gif=755#.*\.jpg=755 |
Au lieu d'utiliser la liste à choix multiples pour indiquer les droits d'accès aux fichiers, vous pouvez définir une chaîne de droit d'accès dans la zone de texte. Les droits d'accès aux fichiers utilisent une chaîne dont le format est le suivant :
masque_nom_fichier=droit#masque_nom_fichier=droit
où masque_nom_fichier est un filtre de nom de fichier à caractères génériques (par exemple, .*\\.jsp pour tous les fichiers JSP), droit fournit les listes de contrôle d'accès (ACL) aux fichiers et # est le séparateur entre plusieurs entrées de masque_nom_fichier et droits. Si # est un caractère d'une chaîne modèle_nom_fichier, utilisez plutôt \#.
Si plusieurs masques de nom de fichier et droits d'accès aux fichiers dans la chaîne correspondent à un URI dans l'application, le produit utilise le droit applicable le plus strict pour le fichier. Par exemple, si la chaîne de droit d'accès aux fichiers est .*\\.jsp=775#a.*\\.jsp=754, le fichier abc.jsp possède le droit d'accès aux fichiers 754.
1 | /opt/WebSphere/profiles/AppSrv01/installedApps/MyCell/MyApp.ear/MyWarModule.war |
2 | /opt/WebSphere/profiles/AppSrv01/installedApps/MyCell/MyApp.ear/MyWarModule.war/MyJsp.jsp |
3 | /opt/WebSphere/profiles/AppSrv01/installedApps/MyCell/MyApp.ear/MyWarModule.war/META-INF/MANIFEST.MF |
4 | /opt/WebSphere/profiles/AppSrv01/installedApps/MyCell/MyApp.ear/MyWarModule.war/WEB-INF/classes/MyClass.class |
5 | /opt/WebSphere/profiles/AppSrv01/installedApps/MyCell/MyApp.ear/MyWarModule.war/mydir/MyClass2.class |
6 | /opt/WebSphere/profiles/AppSrv01/installedApps/MyCell/MyApp.ear/MyWarModule.war/META-INF |
Les résultats de la correspondance des masques de fichiers sont les suivants :
/opt/WebSphere/profiles/AppSrv01/installedApps/MyCell/MyApp.ear/MyWarModule.war/MyJsp.jspSupposez que vous indiquez la chaîne de masque de fichiers suivante :
.*MyApp.ear$=755#.*\.jsp=644Les résultats de la correspondance des masques de fichiers sont les suivants :
Sous Windows, le droit d'accès en lecture d'un fichier
ne peut pas être désactivé. Avec des bits de droit d'accès de type POSIX, le bit signalant qu'un fichier est lisible (readable) est 4, inscriptible (writable) 2 et exécutable (executable) 1. Par conséquent, le droit d'accès à un fichier sur une plateforme Windows est 5 ou 7. Par ailleurs, POSIX offre des
droits d'accès user, group et world.
Sous Windows, seuls les droits d'accès user peuvent être affectés à un fichier. Les bits de droits d'accès group et world sont ignorés.
Les droits d'accès spécifiés ici le sont au niveau de l'application. Vous pouvez également indiquer les droits d'accès aux fichiers binaires d'actif dans la configuration définie au niveau du noeud. Les droits d'accès aux fichiers définis au niveau du noeud représentent les droits d'accès les plus étendus qui puissent être accordés aux fichiers binaires d'application. Les droits d'accès définis ici au niveau application peuvent être identiques ou plus stricts que ceux définis au niveau du noeud.
Ce paramètre est similaire à la zone Droits d'accès aux fichiers de la page des fichiers binaires d'application.
Type de données | Chaîne |
Indique une chaîne non éditable identifiant la version de génération de l'application.
La zone Identificateur de compilation de l'application est identique à la zone Niveau de compilation de l'application dans la page Fichiers binaires d'application.
Type de données | Chaîne |
Indique si une application peut distribuer des inserts dans des ressources de modules Web situés dans des machines virtuelles Java différentes dans un environnement de noeuds gérés au travers du mécanisme de distributeur de requête.
Cette zone est identique à la zone Autoriser la distribution d'inserts à des ressources distantes dans la page Propriétés de distribution des requêtes distantes.
Type de données | Booléen |
Valeur par défaut | false |
Indique si une application d'entreprise peut servir une requête d'insert à partir d'une application.
Cette zone est identique à la zone Autoriser le service d'inserts depuis des ressources distantes dans la page Propriétés de distribution des requêtes distantes.
Type de données | Booléen |
Valeur par défaut | false |
Indique si le produit crée une application de niveau métier avec l'application d'entreprise en cours d'installation ou transforme l'application d'entreprise en une unité appartenant à une application de niveau métier existante.
La valeur par défaut consiste à créer une nouvelle application de niveau métier avec un paramètre de valeur WebSphere:blaname=Anyasset,blaedition=BASE. Lorsque vous effectuez une sélection dans la liste déroulante pour créer une application de niveau métier, le produit crée une application de niveau métier du même nom que votre application d'entreprise. Si une application au niveau métier avec le nom de l'application d'entreprise existe déjà, le produit ne crée pas une nouvelle application au niveau métier ; il ajoute l'application d'entreprise sous la forme d'une unité de composition à l'application métier.
Pour ajouter votre application d'entreprise à une application de niveau métier existante, sélectionnez une application de niveau métier existante dans la liste déroulante. Le produit transforme votre application d'entreprise en une unité appartenant à une application de niveau métier existante.
Type de données | Chaîne |
Valeur par défaut | Créez une application de niveau métier portant le même nom que
l'application d'entreprise en cours d'installation. WebSphere:blaname=Anyasset,blaedition=BASE |
Indique si les modules Web peuvent expédier des demandes simultanément sur des unités d'exécution séparées et, si c'est le cas, si le serveur ou le client expédie les demandes. Les expéditions simultanées peuvent améliorer les temps de réponse des servlets.
N'activez pas l'expédition asynchrone des demandes si les opérations correspondantes dépendent les unes des autres. Sélectionnez Désactivé. Cela entraînerait des erreurs.
Sélectionnez Côté serveur pour activer l'expédition simultanée des demandes par le serveur. Sélectionnez Côté client pour activer l'expédition simultanée des demandes par le client.
Type de données | Chaîne |
Valeur par défaut | Désactivé |
Indique si le produit affecte des valeurs JNDI par défaut aux cibles de référence EJB ou effectue une résolution automatique des cibles de référence EJB incomplètes.
Sélectionnez cette option pour activer la résolution automatique des cibles de référence EJB si les références proviennent de modules EJB 2.1 ou antérieurs, ou de modules Web 2.3 ou antérieurs. Si vous activez cette option, le conteneur d'exécution fournit une valeur par défaut ou effectue automatiquement la résolution de toute référence EJB qui ne comporte pas de liaison.
Si vous sélectionnez Génération des liaisons par défaut dans la page Préparation de l'installation de l'application, il n'est pas nécessaire de sélectionner cette option. Le produit génère des valeurs par défaut.
Si vous sélectionnez Autoriser la résolution automatique des cibles de référence d'EJB, tous les modules de l'application partagent la même cible de déploiement. Si vous sélectionnez cette option et que tous les modules de l'application ne partagent pas un serveur commun, le produit affiche un message d'avertissement et n'installe pas l'application après avoir cliqué sur Terminer sur la page Récapitulatif. Pour installer l'application, vous devez désélectionner ce paramètre avant de cliquer sur Terminer.
Type de données | Booléen |
Valeur par défaut | false |
Les liens marqués (en ligne) requièrent un accès à Internet.