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.
Ils décrivent les serveurs d'applications disponibles, leur configuration et leur contenu.
Hiérarchie des répertoires des documents
La hiérarchie en cascade des répertoires et la structure des documents prennent en charge la réplication multi-noeud pour synchroniser les activités de tous les serveurs d'une cellule. Dans un environnement WebSphere Application Server, Network Deployment, les modifications apportées aux documents de configuration dans le référentiel d'une cellule sont automatiquement dupliquées dans les mêmes documents de configuration stockés sur les noeuds de la cellule.
Au sommet de la hiérarchie se trouve le répertoire cells. Il contient un sous-répertoire pour chaque cellule. Le nom des sous-répertoires des cellules correspond au nom de chaque cellule. Par exemple, les documents de configuration d'une cellule nommée cell1 se trouvent dans le sous-répertoire cell1. Le nom de la cellule doit être différent de la paire de noms de l'ensemble.
Sur le noeud WebSphere Application Server, Network Deployment, les sous-répertoires de la cellule contiennent l'ensemble des documents de chaque noeud et serveur de la cellule. Sur les autres noeuds, l'ensemble des documents est limité à ce qui s'applique à un noeud spécifique. Si un document de configuration s'applique uniquement au node1, alors ce document existe dans la configuration sur node1 et dans la configuration WebSphere Application Server, Network Deployment, mais sur aucun autre noeud 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 clusters, qui contient un sous-répertoire pour chaque cluster
défini dans la cellule. Les noms des sous-répertoires de clusters correspondent aux noms des
clusters.
Chaque sous-répertoire de cluster contient un fichier cluster.xml, qui fournit les données de configuration spécifiques à ce cluster.
- le sous-répertoire nodes, qui contient un sous-répertoire pour chaque noeud de la cellule. Le nom des sous-répertoires des noeuds correspond au nom des noeuds.
Chaque 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, tous les serveurs du noeud utilisent la définition de variable qui se trouve dans le document de noeud et ignorent la définition du document de cellule.
Chaque sous-répertoire de noeud contient un sous-répertoire pour chaque serveur défini sur le noeud. Le nom des sous-répertoires correspond au nom des serveurs. Chaque sous-répertoire de serveur contient un fichier server.xml qui fournit les données de configuration spécifiques d'un 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
nodeAgent
server.xml variables.xml
nodeY
node.xml variables.xml resources.xml serverindex.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.

- private_Enable_zWAS_for_64bit dans la portée de serveur variables.xml
- AMODE=64 dans processDefinition pour les processus de contrôle, de serviteur ou adjunct dans server.xml
- was.com.ibm.websphere.zos.jvmmode dans processDefinition pour les processus de contrôle dans server.xml
- En utilisant wsadmin, exécutez les commandes AdminTask.
- En utilisant la console d'administration, voir Exécution en mode JVM 64 bits dans la page des paramètres du serveur d'applications. Cliquez sur .
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.
- 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.