Documents de configuration

WebSphere Application Server stocke les données de configuration dans plusieurs documents dans une hiérarchie de répertoires en cascade. La plupart des documents de configuration contient des données XML.

Les documents de configuration décrivent le serveur, sa configuration et son contenu.

Hiérarchie des répertoires des documents

Les modifications apportées aux documents de configuration sont stockées dans le référentiel de cellules.

Au sommet de la hiérarchie se trouve le répertoire cells. Il contient un sous-répertoire pour la cellule. Le nom du sous-répertoire de la cellule est identique à celui de la cellule. Par exemple, les documents de configuration d'une cellule nommée cell1 se trouvent dans le sous-répertoire cell1.

Les sous-répertoires de la cellule contiennent l'ensemble des documents du noeud et du serveur de la cellule.

Chaque sous-répertoire de cellule contient les fichiers et sous-répertoires suivants :

  • Le fichier cell.xml, qui fournit des données de configuration pour la cellule.
  • Des fichiers tels que security.xml, virtualhosts.xml, resources.xml et variables.xml, qui fournissent des données de configuration valables sur tous les noeuds de la cellule.

  • le sous-répertoire nodes, qui contient un sous-répertoire pour le noeud de la cellule. Le nom des sous-répertoires des noeuds correspond au nom des noeuds.

    Le sous-répertoire de noeud contient des fichiers tels que variables.xml et resources.xml, qui fournissent des données de configuration valables sur tout le noeud. Ces fichiers portent le même nom que ceux figurant dans le répertoire des cellules. Les configurations spécifiées dans ces documents de noeuds remplacent les configurations spécifiées dans les documents de cellules ayant le même nom. Par exemple, si une variable donnée se trouve dans les fichiers variables.xml à la fois au niveau de la cellule et au niveau du noeud, le serveur du noeud utilise la définition de variable qui se trouve dans le document de noeud et ignore la définition du document de cellule.

    Le sous-répertoire de noeud contient un sous-répertoire pour le serveur défini sur le noeud. Le nom du sous-répertoire est identique à celui de la cellule. Le sous-répertoire de serveur contient un fichier server.xml, qui fournit les données de configuration spécifiques au serveur. Les sous-répertoires de serveur peuvent contenir des fichiers tels que security.xml, resources.xml et variables.xml qui fournissent des données de configuration valables uniquement pour ce serveur. Les configurations spécifiées dans ces documents de serveur remplacent les configurations spécifiées dans les documents de noeud et de cellule ayant le même nom.

  • le sous-répertoire applications, qui contient un sous-répertoire pour chaque application déployée dans la cellule. Les noms des sous-répertoires des applications correspondent aux noms des applications déployées.

    Chaque sous-répertoire d'application déployée comporte un fichier deployment.xml qui contient les données de configuration du déploiement de l'application. Chaque sous-directoire comporte également un sous-directoire META-INF, lequel héberge un fichier de descripteurs de déploiement d'application J2EE (Java™ 2 Platform, Enterprise Edition) ainsi que des fichiers de liaisons et des fichiers d'extension de déploiement IBM®. Les sous-répertoires des applications déployées contiennent également des sous-répertoires pour tous les fichiers.war et les fichiers .jar de bean entity de l'application. Les fichiers binaires tels que les fichiers .jar font également partie de la structure de configuration.

Voici un exemple de structure de fichier :

cells
  cell1
     cell.xml resources.xml virtualhosts.xml variables.xml security.xml
     nodes
        nodeX
           node.xml variables.xml resources.xml serverindex.xml
           serverA
              server.xml variables.xml        
     applications
        sampleApp1
           deployment.xml
           META-INF
              application.xml ibm-application-ext.xml ibm-application-bnd.xml
        sampleApp2
           deployment.xml
           META-INF
              application.xml ibm-application-ext.xml ibm-application-bnd.xml

Modification des documents de configuration

Vous pouvez utiliser l'un des outils d'administration (console, wsadmin, API Java) pour modifier les documents de configuration ou directement les éditer. Il est conseillé d'utiliser la console d'administration car elle valide les modifications que vous apportez aux configurations. "Description des documents de configuration" indique si vous pouvez éditer un document à l'aide des outils d'administration ou si vous devez l'éditer directement.

Conversion des fichiers de configuration

Le référentiel de configuration maître de WebSphere Application Server stocke les fichiers de configuration de tous les noeuds de la cellule. Lorsque vous migrez le gestionnaire de déploiement d'une version de WebSphere Application Server vers une autre, les fichiers de configuration stockés dans le référentiel maître des noeuds de l'ancienne version sont convertis au format de la nouvelle version.

Une fois la conversion effectuée, le gestionnaire de déploiement peut traiter les fichiers de configuration de manière uniforme. Toutefois, les noeuds d'une ancienne version ne peuvent pas utiliser tels quels les fichiers de configuration au format de la nouvelle version. WebSphere Application Server remédie à cet incident en synchronisant les fichiers de configuration du référentiel maître avec un noeud d'une ancienne version. Les fichiers de configuration sont d'abord convertis au format de l'ancienne version, avant d'être expédiés au noeud. WebSphere Application Server effectue les transformations suivantes sur les documents de configuration :
  • Il convertit l'espace de noms XML du format de la nouvelle version au format de l'ancienne version ;
  • Il supprime les attributs des documents de niveau cellule qui ne s'appliquent qu'à la nouvelle version ;
  • Il supprime les nouvelles définitions de ressources qui ne sont pas acceptées par les noeuds de l'ancienne version.

Icône indiquant le type de rubrique Rubrique de concept



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=ccfg_confdoc
Nom du fichier : ccfg_confdoc.html