Documentos de configuración

WebSphere Application Server almacena datos de configuración en varios documentos en una jerarquía de directorios en cascada. La mayor parte de los documentos de configuración tienen contenido XML.

Los documentos de configuración describen el servidor, su configuración y su contenido.

Jerarquía de directorios de documentos

Los cambios realizados en los documentos de la configuración se almacenan en el repositorio de la célula.

En el nivel superior de la jerarquía está el directorio de cells. Contiene un subdirectorio para la célula. El nombre del subdirectorio de la célula coincide con el nombre de la célula. Por ejemplo, la célula cell1 tiene los documentos de configuración en el subdirectorio cell1.

Los subdirectorios de la célula contienen el conjunto completo de documentos para el nodo y el servidor de la célula.

Cada subdirectorio de célula tiene los siguientes archivos y subdirectorios:

  • El archivo cell.xml que proporciona datos de configuración para la célula.
  • Los archivos como, por ejemplo, security.xml, virtualhosts.xml, resources.xml y variables.xml, que proporcionan los datos de configuración que se aplican al nodo de la célula.

  • El subdirectorio nodes, que contiene un subdirectorio para el nodo de la célula. Los nombres del subdirectorio nodes coinciden con el nombre del nodo.

    El subdirectorio nodes contiene archivos como, por ejemplo, variables.xml y resources.xml, que proporciona datos de configuración que se aplican a todo el nodo. Tenga en cuenta que estos archivos tienen el mismo nombre que los del directorio de la célula que los contiene. Las configuraciones especificadas en estos documentos de nodos alteran temporalmente las configuraciones especificadas en los documentos de las células que tengan el mismo nombre. Por ejemplo, si una variable determinada está en los archivos variables.xml a nivel de célula y a nivel de nodo, el servidor del nodo utiliza la definición de la variable del documento del nodo e ignora la definición del documento de la célula.

    El subdirectorio nodes contiene un subdirectorio para el servidor definido en el nodo. El nombre del subdirectorio coincide con el nombre del servidor. El subdirectorio del servidor contiene un archivo server.xml que proporciona datos de configuración específicos del servidor. Los subdirectorio de servidor pueden contener archivos como security.xml, resources.xml y variables.xml, que proporcionan datos de configuración que se aplican sólo al servidor. Las configuraciones especificadas en estos documentos de servidor alteran temporalmente las configuraciones especificadas en los documentos de las células y los nodos que contienen que tengan el mismo nombre.

  • El subdirectorio applications, que contiene un subdirectorio para cada aplicación desplegada en la célula. Los nombres de los subdirectorios de las aplicaciones coinciden con los nombres de las aplicaciones desplegadas.

    Todo subdirectorio de una aplicación desplegada contiene un archivo deployment.xml que alberga los datos de configuración del despliegue de la aplicación. Asimismo, todos los subdirectorios tienen también un subdirectorio META-INF que contiene un archivo de descriptor de despliegue de aplicaciones J2EE (Java™ 2 Platform, Enterprise Edition), los archivos de extensiones de despliegue IBM® y los archivos de enlaces. Los subdirectorios de las aplicaciones desplegadas también contienen subdirectorios para todos los archivos .war y .jar de beans de entidad de la aplicación. Los archivos binarios como, por ejemplo, los archivos .jar, también forman parte de la estructura de la configuración.

El siguiente es un ejemplo de una estructura de archivos:

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

Cambio de los documentos de configuración

Puede utilizar una de las herramientas administrativas (consola, wsadmin, API de Java) para modificar los documentos de configuración o editarlos directamente. Es preferible utilizar la consola administrativa dado que valida los cambios realizados en la configuración. "Descripciones de documentos de configuración" indica si puede editar un documento utilizando las herramientas administrativas o si debe editarlo directamente.

Transformación de los archivos de configuración

El repositorio maestro de configuración de WebSphere Application Server almacena archivos de configuración de todos los nodos de la célula. Cuando se actualiza el gestor de despliegue de un release de WebSphere Application Server a otro, los archivos de configuración que se almacenan en el repositorio maestro de los nodos en el release anterior se convierten al formato del nuevo release.

Con esta conversión, el gestor de despliegue puede procesar los archivos de configuración de forma uniforme. No obstante, los nodos en un release anterior no pueden utilizar directamente los archivos de configuración que están en el formato del nuevo release. WebSphere Application Server soluciona este problema cuando sincroniza los archivos de configuración del repositorio maestro con un nodo en un release anterior. Los archivos de configuración se transforman primero al formato del release anterior antes de enviarse al nodo. WebSphere Application Server realiza las siguientes transformaciones en los documentos de configuración:
  • Cambia el espacio de nombres XML del formato del nuevo release al formato del release anterior
  • Quita los atributos de los documentos a nivel de célula que se aplican sólo al nuevo release
  • Quita las nuevas definiciones de recursos que no se entienden en los nodos del release anterior

Icon that indicates the type of topic Concept topic



Timestamp icon Last updated: last_date
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=cord&product=was-base-dist&topic=ccfg_confdoc
File name: ccfg_confdoc.html