Creación de un nuevo clúster uniforme

Cómo crear un nuevo clúster uniforme.

Procedimiento

Cree un archivo que describa cómo desea que sea el propio clúster en términos de repositorios completos.
Como cualquier clúster, dos repositorios completos actúan como almacenes centrales de información sobre el clúster.
Específicamente, debe describir los nombres y los nombres de conexión para los dos repositorios completos en este clúster.
Nota: Esto se realiza antes de que se cree nada (incluidos los gestores de colas), y el siguiente proceso a continuación incluye la creación de estos gestores de colas.
Por ejemplo, imagine que está configurando un clúster uniforme denominado UNICLUS, con los miembros del gestor de colas QMA, QMB, QMC y QMD. En este ejemplo, QMA y QMB serán los repositorios completos, con QMC y QMD como repositorios parciales. Un archivo de configuración de ejemplo, uniclus.ini:
```
AutoCluster:
   Repository2Conname=QMA.dnsname(1414)
   Repository2Name=QMA
   Repository1Conname=QMB.dnsname(1414)
   Repository1Name=QMB
   ClusterName=UNICLUS
   Type=Uniform
```
Los campos RepositoryNConname se utilizan como el atributo conname para que otros miembros del clúster definan los remitentes de clúster (CLUSSDR) para ellos, y puede ser una lista de conexiones para un gestor de colas de varias instancias y opcionalmente puede incluir el puerto.
Cree un archivo de configuración de ejemplo, uniclus.mqsc que contiene las definiciones MQSC que desea que se apliquen a todos los miembros del clúster.
Hay una línea obligatoria necesaria en este archivo, que es una definición de un canal receptor de clúster (CLUSRCVR), con un atributo CLUSTER del nombre de clúster automático (normalmente mediante la inserción de +AUTOCL+) y un nombre de canal que incluye la inserción +QMNAME+.
Esto describe cómo otros miembros del clúster uniforme se conectan a cada gestor de colas y se utilizan como una plantilla de cómo conectarse también a los otros gestores de colas. Una definición de ejemplo puede ser algo parecido a:
```
define channel('+AUTOCL+_+QMNAME+') chltype(clusrcvr) trptype(tcp) 
conname(+CONNAME+) cluster('+AUTOCL+') replace
```
Cuando se configuran clústeres automáticos, una definición de un canal receptor de clúster puede utilizar algunas inserciones adicionales en los campos CLUSTER, CONNAME y CHANNEL para permitir que la definición sea idéntica en todos los gestores de colas del clúster uniforme. Esto incluye:

+AUTOCL+

Nombre automático del clúster

+QMNAME+

Nombre del gestor de colas que se está creando

+CONNAME+

Variable definida durante la creación del gestor de colas, utilizando el parámetro -iv o en la stanza Variables qm.ini, para su uso en la serie de parámetro de nombre de conexión. El nombre de la variable puede ser cualquier valor.
Recuerde que los nombres de canal tienen una limitación de 20 caracteres, por lo que tanto el valor con las inserciones como cuando se sustituyen las inserciones, debe ajustarse a dicha limitación. Un archivo de ejemplo puede tener el aspecto siguiente:
```
*##########################################################################
* Compulsory section for all uniform cluster queue managers
*##########################################################################
define channel('+AUTOCL+_+QMNAME+') chltype(clusrcvr) trptype(tcp) conname(+CONNAME+) cluster('+AUTOCL+') replace
*
*##########################################################################
* Configuration for all queue managers
*##########################################################################
define QL(APPQ) maxdepth(99999999) replace
define QL(APPQ2) maxdepth(99999999) replace
define channel(CLIENTCHL) chltype(svrconn) trptype(tcp) replace
```
Haga que estos dos archivos estén disponibles en cada una de las máquinas que alojarán un miembro de clúster uniforme.
Por ejemplo, /shared/uniclus.ini y /shared/uniclus.mqsc.
En cada una de estas máquinas, cree el gestor de colas.
En la línea de mandatos, proporcione:
1. Una solicitud para iniciar un escucha, en el puerto esperado
2. Una solicitud de configuración INI automática (-ii) que apunta al archivo de configuración de clúster automático (uniclus.ini)
3. Una solicitud de configuración MQSC automática (-ic) que apunta al archivo de configuración MQSC que incluye una definición de CLUSRCVR para el clúster uniforme.
4. Un CONNAME para este gestor de colas.
En el host para QMA:
```
crtmqm -p 1414 -ii /shared/uniclus.ini -ic /shared/uniclus.mqsc -iv CONNAME=QMA.dnsname(1414) QMA
strmqm QMA
```
Cada gestor de colas del clúster uniforme se crea con una línea de mandatos casi idéntica: todas las diferencias entre el repositorio completo y parcial se gestionan automáticamente para un clúster uniforme.
En el host para QMB:
```
crtmqm -p 1414 -ii /shared/uniclus.ini -ic /shared/uniclus.mqsc -iv CONNAME=QMB.dnsname(1414) QMB
strmqm QMB
```
En el host para QMC:
```
crtmqm -p 1414 -ii /shared/uniclus.ini -ic /shared/uniclus.mqsc -iv CONNAME=QMC.dnsname(1414) QMC
strmqm QMC
```
En el host para QMD:
```
crtmqm -p 1414 -ii /shared/uniclus.ini -ic /shared/uniclus.mqsc -iv CONNAME=QMD.dnsname(1414) QMD
strmqm QMD
```
Qué sucede automáticamente:
A medida que se inicia el gestor de colas, las definiciones del archivo uniclus.ini se aplican al archivo qm.ini. Para obtener más información, consulte Configuración automática de qm.ini al iniciar. Esto añade la definición AutoCluster al archivo qm.ini.

Si el gestor de colas se denomina en la stanza AutoCluster como uno de los repositorios completos, se convierte automáticamente para que sea un repositorio completo, similar a emitir el mandato MQSC ALTER QMGR REPOS (ClusterName), de lo contrario se convierte en un repositorio parcial, similar a emitir el mandato MQSC ALTER QMGR REPOS ('').

Cuando se procesa la definición del canal receptor del clúster para el clúster automático, los canales de emisor del clúster se definen desde este gestor de colas a todos los repositorios completos de la stanza AutoCluster (excluyendo el gestor de colas local si este es uno de los repositorios completos). Estos canales emisores heredan todos los atributos de canal comunes del receptor de clúster local que se ha definido.
Atención: Aunque los canales se crean sin intervención manual adicional, son objetos de canal administrativo que se pueden visualizar y gestionar como para cualquier otra definición de canal. No debe confundir estos objetos con canales emisores de clúster 'autodefinidos', creados transitoriamente y bajo demanda por el clúster para direccionar el tráfico de mensajes.

Qué hacer a continuación

Verificar la configuración de clúster uniforme

Cuando el parámetro ClusterName se establece correctamente, y el gestor de colas es miembro del clúster con nombre, se emite el mensaje AMQ9883 para confirmar que el clúster se identifica ahora como un clúster uniforme.

A continuación, puede utilizar funciones de clúster uniforme como, por ejemplo, el equilibrado de aplicaciones automático. Durante el inicio del gestor de colas, si se ha establecido este parámetro, pero el nombre no es un nombre de clúster IBM® MQ válido, el nombre se ignora y se emite el mensaje de error AMQ9882 .

Si el nombre es un nombre de clúster válido, pero no existen canales de clúster para el clúster identificado, se emite el mensaje de aviso AMQ9881 al registro de errores del gestor de colas para permitir que el administrador identifique y corrija esta situación.

Verificar la configuración de clúster automatizado

Si ha utilizado el soporte de clúster automático para configurar el clúster uniforme, puede verificar que los gestores de colas especificados como repositorios completos ahora están configurados correctamente como tales, utilizando mandatos runmqsc:

QMA:
     1 : dis qmgr repos
AMQ8408I: Display Queue Manager details.
   QMNAME(QMA)                             REPOS(UNICLUS)

Mientras que los repositorios parciales no están configurados como repositorios:

QMC:
     1 : dis qmgr repos
AMQ8408I: Display Queue Manager details.
   QMNAME(QMC)                             REPOS( )

Además, debe poder ver que los canales emisores de clúster (CLUSSDR) se han configurado desde cada gestor de colas a los demás repositorios completos, utilizando el nombre de canal del archivo de configuración MQSC:

QMA:
     1 : dis chl(UNICLUS*) conname
AMQ8414I: Display Channel details.
   CHANNEL(UNICLUS_QMA)                    CHLTYPE(CLUSRCVR)
   CONNAME(QMA.dnsname(1414))
AMQ8414I: Display Channel details.
   CHANNEL(UNICLUS_QMB)                    CHLTYPE(CLUSSDR)
   CONNAME(QMB.dnsname(1414))

QMC:
     1 : dis chl(UNICLUS*) conname
AMQ8414I: Display Channel details.
   CHANNEL(UNICLUS_QMA)                    CHLTYPE(CLUSSDR)
   CONNAME(QMA.dnsname(1414))
AMQ8414I: Display Channel details.
   CHANNEL(UNICLUS_QMB)                    CHLTYPE(CLUSSDR)
   CONNAME(QMB.dnsname(1414))
AMQ8414I: Display Channel details.
   CHANNEL(UNICLUS_QMC)                    CHLTYPE(CLUSRCVR)
   CONNAME(QMC.dnsname(1414))