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 los servidores de aplicaciones disponibles, sus configuraciones y su contenido.

Jerarquía de directorios de documentos

La jerarquía en cascada de los directorios y la estructura de los documentos permiten duplicar varios nodos y así sincronizar las actividades de todos los servidores de una célula. En un entorno de WebSphere Application Server, Network Deployment, los cambios realizados en los documentos de configuración del repositorio de células se duplican automáticamente en los mismos documentos de configuración que se almacenan en los nodos de toda la célula.

En el nivel superior de la jerarquía está el directorio de cells. Contiene un subdirectorio para cada célula. Los nombres de los subdirectorios de las células coinciden con los nombres de las células. Por ejemplo, la célula cell1 tiene los documentos de configuración en el subdirectorio cell1. El nombre de la célula debe ser distinto del par de nombres de clúster.

En el nodo de WebSphere Application Server, Network Deployment, los subdirectorios de la célula contienen el conjunto completo de documentos para cada nodo y servidor de toda la célula. En los otros nodos, el conjunto de documentos está limitado a lo aplicable a ese nodo específico. Si un documento de configuración sólo se aplica a node1, ese documento existirá en la configuración en node1 y en la configuración de WebSphere Application Server, Network Deployment, pero no en los otros nodos 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 security.xml, virtualhosts.xml, resources.xml y variables.xml, que proporcionan datos de configuración que se aplican a todos los nodos de la célula.

  • El subdirectorio clusters, que contiene un subdirectorio para cada clúster de la célula. Los nombres de los subdirectorios de los clústeres coinciden con los nombres de los clústeres.

    Cada subdirectorio del clúster contiene un archivo cluster.xml, que proporciona datos de configuración específicos de ese clúster.

  • El subdirectorio nodes, que contiene un subdirectorio para cada nodo de la célula. Los nombres de los subdirectorios de los nodos coinciden con los nombres de los nodos.

    Cada subdirectorio de nodo contiene archivos como variables.xml y resources.xml, que proporcionan los datos de configuración que se aplican en 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 de nivel de célula y de nivel de nodo, todos los servidores del nodo utilizan la definición del documento de nodo e ignoran la definición que incluye el documento de célula.

    Cada subdirectorio de nodo contiene un subdirectorio para cada servidor que esté definido en el nodo. Los nombres de los subdirectorios coinciden con los nombres de los servidores. Todo subdirectorio de servidor contiene un archivo server.xml, que proporciona los datos de configuración específicos de dicho 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
           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

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.

For transitioning users For transitioning users: Las siguientes definiciones de variable de z/OS ya no existen en los documentos de configuración de la versión 8.x:
  • private_Enable_zWAS_for_64bit en el ámbito de servidor variables.xml
  • AMODE=64en processDefinition de control, sirviente o procesos de adjunto en server.xml
  • was.com.ibm.websphere.zos.jvmmodeen processDefinition para los procesos de control en server.xml
En la Versión 8.0, no verá AMODE=64en los argumentos del mandato Start para el proceso del servidor. Para ver la modalidad de bits actual del servidor:
  • Con wsadmin, ejecute los mandatos AdminTask para obtener la modalidad de bits utilizado.
  • Utilizando la consola administrativa, consulte Ejecutar modalidad JVM en 64 bits en la página de valores de servidor de aplicaciones. Pulse Servidores > Tipos de servidor > Servidores de aplicaciones de WebSphere > nombre_servidor.
trns

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-nd-mp&topic=ccfg_confdoc
File name: ccfg_confdoc.html