Paramètres de l'application d'entreprise

Cette page permet de configurer une application d'entreprise.

Pour afficher cette page de la console d'administration, sélectionnez Applications > Applications d'entreprise > nom_application.

Concepts connexes
crun_classload.html
crun_entapp.html
crun_app_moduleversion.html

Tâches connexes
trun_appl.html

Références connexes
udat_nestjcaconfac.html
uejb_rimod.html
ucws_rlibref.html
uprs_rsession_manager.html
urun_rtargetmap.html
ucws_rvars.html
rcfg_objectnames.html

Nom

Indique le nom logique de l'application. Le nom de l'application doit être unique dans une cellule et ne peut pas comporter de caractère non admis.

Le nom de l'application ne peut pas commencer par un point (.), ne peut pas commencer ni se terminer par un espace et ne peut pas contenir les caractères suivants :

Caractères non admis
/   barre oblique avant $    signe dollar '    apostrophe
\   barre oblique arrière =    signe égal "   guillemets
*  astérisque %  signe pourcentage |     barre verticale
,   virgule +    signe plus <   crochet gauche
:   deux-points @  signe arobas    crochet droit
;   point-virgule #    signe dièse &  perluète (et signe)
?  point d'interrogation ]]> Aucun nom spécifique n'existe pour cette combinaison de caractères
Type de données Chaîne

Fichiers binaires d'application

Spécifie le répertoire dans lequel le fichier EAR de l'application sera installé. Le paramètre Fichiers binaires d'application est identique à la zone Répertoire dans lequel installer l'application des assistants d'installation et de mise à jour de l'application.

La valeur par défaut est RACINE_INSTALL_APPnom_cellule, où la variable RACINE_INSTALL_APP correspond à racine_install/installedApps; exemple : C:\WebSphere\AppServer\profiles\nom_profil\installedApps\nom_cellule.

Vous pouvez spécifier un chemin d'accès absolu ou utiliser une variable de mappe des chemins d'accès telle que ${MY_APPS}. Vous pouvez utiliser une variable de mappe des chemins d'accès dans toute installation mais elle est particulièrement utile lors de l'installation d'une application dans un cluster comportant des membres sur des noeuds hétérogènes car, dans de tels cas, il peut ne pas être possible de spécifier un chemin d'accès absolu. La variable de mappe des chemins d'accès peut également contenir une variable WebSphere Application Server ${CELL}, qui indique le nom de la cellule ; exemple : ${MY_APP}/${CELL}.

Vous pouvez définir des variables WebSphere Application Server dans la page Variables WebSphere de la console d'administration, à laquelle vous pouvez accéder en sélectionnant Environnement > Variables WebSphere.

Type de données Chaîne
Unités Nom de chemin d'accès complet

Utiliser les métadonnées des fichiers binaires

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 application resource) de l'application.

Le paramètre Utiliser les métadonnées des fichiers binaires est identique à la zone Utilisation de la configuration binaire dans les assistants d'installation et de mise à jour. Sélectionnez-le pour des applications installées sur des cibles de déploiement 6.x uniquement.

Type de données Booléen
Par défaut false

Activer la distribution

Indique si WebSphere Application Server développe ou supprime les fichiers binaires de l'application dans la destination de l'installation. 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é. Les fichiers binaires sont également supprimés lors de la désinstallation et les modifications sont sauvegardées dans la configuration. Si vous désactivez cette option, vous devez vous assurer que les fichiers binaires d'application sont développés de manière appropriée dans les répertoires de destination de tous les noeuds sur lesquels l'application est exécutée.

Important : Si vous désactivez cette option et que vous ne copiez ni ne développez les fichiers binaires de l'application dans les noeuds, vous ne pourrez pas déplacer les fichiers binaires de l'application vers les noeuds en effectuant ultérieurement une sauvegarde de la configuration ou une synchronisation manuelle.

Le paramètre Activer la distribution est identique à la zone Distribution de l'application dans les assistants d'installation et de mise à jour.

Type de données Booléen
Par défaut true

Validation

Indique si WebSphere Application Server é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, avertit les utilisateurs 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 à laquelle fait référence l'application est définie dans la portée de la cible de déploiement de cette application.

La ressource peut être définie sur le serveur, son noeud, sa cellule ou le cluster si le serveur appartient à un cluster. 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.

Le paramètre Validation est identique à la zone Entrée de validation désactivée/avertissement/échec dans les assistants d'installation et de mise à jour.

Type de données Chaîne
Par défaut avertissement

Mode du chargeur de classes

Indique si le chargeur de classe doit d'abord effectuer la recherche dans le chargeur de classe parent ou dans le chargeur de classe de l'application afin de charger une classe. Le mode standard pour les chargeurs de classe de kit de développement et ceux de WebSphere Application Server est Parent en premier. Si vous indiquez Parent en dernier, votre application peut substituer des classes contenues dans le chargeur de classe parent, mais cette action peut éventuellement aboutir à l'exception ClassCastException ou à des erreurs LinkageErrors si vous avez utilisé conjointement des classes substituées et des classes non substituées.

Les options possibles sont Parent en premier et Parent en dernier. Par défaut, la recherche s'effectue d'abord dans le chargeur de classe parent, puis dans le chargeur de classe d'application pour charger une classe.

Pour que votre application utilise la configuration de la journalisation Jakarta Commons dans WebSphere Application Server, associez le mode du chargeur de classe de l'application à Parent en premier. Pour que votre application remplace la configuration de la journalisation Jakarta Commons dans WebSphere Application Server, elle doit fournir la configuration sous une forme prise en charge par la journalisation Jakarta Commons et ce mode de chargeur de classe doit être associé à Parent en dernier. De plus, pour remplacer la configuration par défaut, définissez le mode chargeur de classe de chaque module Web de façon à ce qu'il charge la fabrique de journalisation appropriée.

Type de données Chaîne
Par défaut Parent en premier

Règle du chargeur de classes WAR

Indique si un seule chargeur de classe doit être utilisé pour charger tous les fichiers WAR de l'application ou si un chargeur de classe différent doit être utilisé pour chaque fichier WAR.

Les options possibles sont Application et Module. Par défaut, chaque fichier WAR est chargé par un chargeur de classe distinct.

Type de données Chaîne
Par défaut Module

Activer le rechargement des classes

Indique si le rechargement des classes est activé lors de la mise à jour des fichiers d'application.

Pour les modules EJB ou non Web, la sélection de l'option Activer le rechargement des classes attribue à reloadEnabled la valeur true dans le fichier deployment.xml pour l'application. Si la définition des classes d'une application est modifiée, l'environnement d'exécution du serveur d'applications arrête et redémarre l'application afin de recharger les classes mises à jour.

Dans le cas des modules Web tels que les servlets et les fichiers JSP (JavaServer page), ceux-ci ne sont rechargés par le conteneur Web que si le paramètre d'extension IBM reloadingEnabled (dans le fichier ibm-web-ext.xmi) a pour valeur true. Vous pouvez attribuer la valeur true au paramètre reloadingEnabled lorsque vous éditez les descripteurs de déploiement étendus de votre module Web dans un outil d'assemblage.

Pour activer le rechargement d'un module Web lorsque vous souhaitez aussi activer le rechargement des modules EJB et des modules autres que Web :

  1. Associez le paramètre d'extension IBM reloadingEnabled à la valeur true dans le fichier ibm-web-ext.xmi.
  2. Sélectionnez la propriété Activation du rechargement de la classe.
  3. Attribuez à la propriété Intervalle de rechargement une valeur supérieure à zéro (par exemple, entre 1 et 2147483647).

Pour activer le rechargement d'un module Web seul, sans activer celui des modules EJB et des modules autres que Web :

  1. Associez le paramètre d'extension IBM reloadingEnabled à la valeur true dans le fichier ibm-web-ext.xmi.
  2. Dans le fichier ibm-web-ext.xmi, associez l'attribut d'extension IBM reloadInterval à une valeur supérieure à zéro (par exemple, 1 à 2147483647).
  3. Ne sélectionnez pas la propriété Activation du rechargement de la classe.

Pour désactiver le rechargement d'un module Web, associez le paramètre d'extension IBM reloadingEnabled à la valeur false dans le fichier ibm-web-ext.xmi. Ou, si l'extension IBM reloadingEnabled du module Web figurant dans le fichier ibm-web-ext.xmi est associée à la valeur true, pour désactiver le rechargement à l'aide de la console d'administration :

  1. sélectionnez la propriété Activation du rechargement de la classe,
  2. associez la propriété Intervalle de rechargement à la valeur zéro (0).
Type de données Booléen
Par défaut false

Intervalle de rechargement

Indique le nombre de secondes pendant lequel le système de fichiers de l'application doit être parcouru à la recherche de 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.

Le paramètre Intervalle de rechargement est identique à la zone Intervalle de rechargement en secondes dans les assistants d'installation et de mise à jour.

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

L'intervalle de rechargement indiqué ici remplace la valeur spécifiée dans les extensions IBM de chaque module autre que Web du fichier EAR (qui remplace lui-même l'intervalle de rechargement indiqué dans les extensions IBM du fichier EAR). L'attribut d'intervalle de rechargement n'a d'effet que si le rechargement des classes est activé.

Les valeurs possibles sont comprises entre 0 et 2147483647.

Type de données Entier
Unités Secondes
Par défaut 3

Pondération de démarrage

Indique l'ordre de lancement des applications lors du démarrage du serveur. L'application dont la pondération de démarrage est la plus faible est lancée la première.

Type de données Entier
Par défaut 1
Plage 0 à 2147483647

Activer l'application en arrière-plan

Indique si l'application doit s'initialiser totalement avant le démarrage du serveur.

Le paramètre par défaut false indique que le démarrage du serveur n'aboutit pas tant que l'application n'a pas démarré.

Le paramètre true indique à WebSphere Application Server que l'application peut démarrer sur une unité d'exécution en arrière-plan et que le démarrage du serveur peut par conséquent avoir lieu sans attendre le lancement de l'application. Ainsi, l'application ne sera éventuellement pas prête à fonctionner au moment où le serveur d'applications démarre.

Ce paramètre s'applique uniquement si l'application est exécutée sur un serveur d'applications version 6.

Type de données Booléen
Par défaut false

Créer des MBeans pour les ressources

Indique s'il faut créer des fichiers MBean pour diverses ressources (telles que des servlets ou des fichiers JSP) dans une application à son démarrage. Par défaut, des fichiers MBean sont créés.

Type de données Booléen
Par défaut true

Onglet Stratégies de service

Vous pouvez consulter les attributs relatifs aux stratégies de service suivants :

Classes de travail HTTP Développez les éléments pour afficher ou gérer les classes de travail pour les demandes HTTP.
Classes de travail SOAP Développez les éléments pour afficher ou gérer les classes de travail pour les demandes SOAP.
A partir de cet onglet, vous pouvez effectuer les opérations ci-après.
  • Cliquez sur Afficher la topologie de la stratégie de service pour voir la stratégie de service et les classes de travail dans une arborescence.
  • Gérez les classes de travail en les sélectionnant pour un type de demande donné et en cliquant sur Nouveau ou Supprimer, ou développez une classe de travail existante et cliquez sur Editer les masques HTTP pour ajouter un URI à la liste des membres de la classe de travail ou le supprimer.
  • Gérez les conditions de règle :
    • Pour créer une règle, cliquez sur Ajouter une règle. Une fois la règle ajoutée, vous pouvez la modifier dans le panneau des détails relatifs à la règle.
    • Pour supprimer une règle existante, cliquez sur Supprimer une règle.
    • Pour utiliser une règle existante, entrez-la dans la zone Si et classez-la dans la classe de transaction appropriée.
    • Pour prioriser les règles s'il en existe plusieurs pour une classe de travail, cliquez sur Vers le haut ou Vers le bas. L'ordre des règles est un élément clé pour l'identification des correspondances. Si une correspondance est trouvée avec la première règle, les règles qui suivent ne sont pas appliquées.
    • Si une classe de travail ne possède aucune règle, associez l'URI à une classe de transaction de la liste.
  • Cliquez sur Appliquer ou OK pour valider vos nouveaux paramètres de règle.

Onglet Stratégies de routage

Vous pouvez consulter les attributs relatifs aux stratégies de routage suivants :

Classes de travail HTTP Développez les éléments pour afficher ou gérer les classes de travail pour les demandes HTTP.
Classes de travail SOAP Développez les éléments pour afficher ou gérer les classes de travail pour les demandes SOAP.
A partir de cet onglet, vous pouvez effectuer les opérations ci-après.
  • Cliquez sur Afficher la topologie de la stratégie de routage pour voir la stratégie de routage et les classes de travail dans une arborescence.
  • Gérez les classes de travail en les sélectionnant pour un type de demande donné et en cliquant sur Nouveau ou Supprimer, ou développez une classe de travail existante et cliquez sur Editer les masques HTTP pour ajouter un URI à la liste des membres de la classe de travail ou le supprimer.
  • Gérez les conditions de règle :
    • Pour créer une règle, cliquez sur Ajouter une règle. Une fois la règle ajoutée, vous pouvez la modifier dans le panneau des détails relatifs à la règle.
    • Pour supprimer une règle existante, cliquez sur Supprimer une règle.
    • Pour prioriser les règles s'il en existe plusieurs pour une classe de travail, cliquez sur Vers le haut ou Vers le bas. L'ordre des règles est un élément clé pour l'identification des correspondances. Si une correspondance est trouvée avec la première règle, les règles qui suivent ne sont pas appliquées.
    • A chaque fois que vous modifiez une nouvelle règle, cliquez sur Appliquer pour cette règle.
    • Si une classe de travail ne possède pas de règle, associez-la à l'une des classes de transaction suivantes :
      • Autoriser le routage vers : Sélectionnez le nom de l'édition dans la liste Sélectionner le nom de l'édition ici.
      • Refuser le routage avec un code retour : Sélectionnez le nom de l'édition dans la liste Sélectionnez le nom de l'édition ici et le type de code retour dans la zone Entrer le code retour.
      • Rediriger le routage vers : Sélectionnez le nom de l'édition dans la liste Sélectionner le nom de l'édition ici et entrez l'URI dans la zone Entrer l'URI de redirection.
      • Autoriser le routage d'affinité client vers : Sélectionnez le nom de l'édition dans la liste Sélectionnez le nom de l'édition ici.
  • Cliquez sur Appliquer ou OK pour valider vos nouveaux paramètres de règle.