Configuración inicial del clúster

El instalador deja un clúster operativo: los nodos están en funcionamiento, los pools de la capa de almacenamiento están creados, los agregados están ensamblados, y el ID del clúster y la redundancia están definidos. A partir de ahí comienza el trabajo del administrador, que consta de dos partes distintas: comprobar lo que se ha ensamblado y establecer los parámetros que la plataforma deja deliberadamente en manos del administrador.

Los ajustes del clúster se dividen en dos grupos que se comportan de forma distinta. vStack Center almacena los parámetros de nivel de clúster, como la política de inicio de sesión, y los aplica de inmediato. Los parámetros de nivel de nodo los envía a los nodos: la interfaz confirma que el valor se ha enviado, pero si el nodo lo ha aplicado solo se ve en la siguiente lectura. La consecuencia práctica es que debe volver a leer los parámetros de los nodos después de escribirlos.

Algunas capacidades del clúster se controlan mediante indicadores de funcionalidad (feature flags). Un indicador determina si una operación está disponible en absoluto: la configuración de nodos solo funciona cuando node_config_management está habilitado. Compruebe el indicador antes de buscar un problema de permisos.

La secuencia siguiente es el mínimo necesario: comprobar la composición del clúster, establecer los parámetros de los nodos, asegurarse de que los nodos y los servicios de los pools están habilitados y fijar la política de inicio de sesión. La creación de usuarios, redes y el primer VDC forma parte de la operación habitual y se describe en la sección "Administración".

Cuándo usarlo

Inmediatamente después de que los nodos formen un clúster y la interfaz web esté disponible. Este procedimiento no es necesario al conectarse a un clúster ya configurado.

Requisitos previos

• El clúster está ensamblado y la interfaz web responde; consulte Comprobar el despliegue de vStack Center. La instalación de los nodos se describe en la documentación de vStack OS.
• Una cuenta con el rol Cluster master: todas las operaciones de esta sección, excepto la lectura de los ajustes de seguridad, solo están disponibles para este rol.
• Para la configuración de nodos, la feature gate node_config_management está habilitada.
• vStack Center versión 3.0.5.

Compruebe la composición y el estado del clúster

Las comprobaciones de aceptación responden a una pregunta: ¿ve el clúster exactamente el hardware previsto y está todo operativo? Las discrepancias son más fáciles de detectar antes de añadir máquinas virtuales al clúster.

1. Despliegue Provider Data Center en el árbol de navegación y abra la página del clúster por su nombre. En la pestaña Resources (recursos), la tabla con las columnas Node name, Node health y Consuming debe tener una fila por cada nodo previsto, y Node health debe ser normal en todos los nodos.

   Una cuenta con el privilegio View Cluster Status Map (full) puede ver la composición completa del clúster. Con el privilegio View Cluster Status Map (dashboard), los datos son los mismos, pero la interfaz solo muestra un resumen.

2. Compare la capacidad total con el diseño. En la misma pestaña, el clúster muestra los núcleos, la memoria y el espacio en disco totales y usados.

   Estas métricas están disponibles para los roles Cluster master y Resource viewer.

   En un clúster nuevo casi no hay nada en uso, y el total de núcleos, memoria y capacidad debe coincidir con el cálculo basado en las configuraciones de los nodos.

3. Vaya a la pestaña Storage Resources (recursos de almacenamiento). En la tabla ZFS pools, con las columnas GUID, Name, Health, Consuming, Scrubbing, Resilvering, Current node y Capacity (RAW), cada pool debe tener Health en ONLINE y Current node rellenado.

   Esta sección solo está disponible para el rol Cluster master. El clúster recopila los datos de los pools desde los nodos, por lo que la tabla se rellena con un breve retraso. Si está vacía, actualice la página.

Establezca los parámetros de los nodos

vStack Center no elige los parámetros de los nodos: los establece el administrador, y el clúster envía los valores a los nodos. Un ajuste se aplica a todo el clúster o a un único nodo; en este último caso, solo ese nodo recibe el valor.

La confirmación en la interfaz significa que el valor se ha enviado al nodo, no que el nodo ya lo haya aplicado. Vuelva a leer los parámetros después de escribirlos.

1. Abra la configuración de nodos y establezca el parámetro necesario. El clúster acepta nombres de su lista de referencia: los parámetros ajustables de ZFS vfs.zfs.* y los límites de vCPU hw.vmm.vcpu_limit.*. Rechaza cualquier otro nombre con el código -23122. Para enviar el cambio a todo el clúster, no seleccione ningún nodo; para enviarlo a un solo nodo, seleccione ese nodo.

   La operación está disponible para el rol Cluster master cuando la feature gate node_config_management está habilitada.

2. Vuelva a leer los parámetros y compruebe que el clúster devuelve los valores que ha establecido.

Si una escritura falla, el motivo es uno de los siguientes: la cuenta no tiene el rol Cluster master (-403); la feature gate node_config_management está deshabilitada (-23110); el conjunto de parámetros tiene un formato no válido (-23108); se especificó un parámetro desconocido (-23121) o un parámetro no admitido por vStack Center (-23122); el parámetro no tiene la clase solicitada (-23123); el parámetro no es escalar (-23120); el valor numérico está por debajo del mínimo (-23124) o por encima del máximo (-23125); el clúster no pudo obtener el mapa de parámetros (-23109); o no se pudo enviar el comando al agente del nodo (-23133). La lista para las lecturas es más corta: -403, -23110, -23108, -23121, -23122, -23123, -23109 y -23133. El clúster comprueba si el valor es escalar y si está dentro de los límites numéricos solo en las escrituras, por lo que -23120, -23124 y -23125 solo los devuelven las escrituras. La lista de parámetros tiene su propio código: cuando la feature gate está deshabilitada, devuelve -23301.

Habilite los nodos y los servicios

Un nodo o un servicio tiene dos dimensiones de estado: administrativa y operativa. El administrador establece el estado administrativo, que también se usa para retirar un nodo del servicio por mantenimiento. El estado operativo muestra lo que realmente le ocurre al objeto. Las comprobaciones de aceptación examinan ambos: deben coincidir. Los servicios del clúster incluyen los servicios de los pools de la capa de almacenamiento, con nombres como zpool_ssd01, y los servicios del sistema, como svc_unbound.

Todas las operaciones de este grupo solo están disponibles para el rol Cluster master y se ejecutan de inmediato.

1. Si un nodo está deshabilitado, habilítelo: abra la página del clúster, seleccione el nodo y habilítelo. La operación inversa retira el nodo del servicio y también es necesaria antes del mantenimiento.
2. Habilite el servicio del pool e inícielo en el nodo necesario. Las operaciones inversas son detener el servicio y deshabilitarlo.
3. Vuelva a la composición del clúster y compruebe que los estados administrativo y operativo del objeto modificado coinciden: el nodo está en servicio y el servicio del pool está en ejecución.

Si un cambio de estado falla, el motivo es uno de los siguientes: la cuenta no tiene el rol Cluster master (tanto los nodos como los servicios devuelven el mismo error, -403); el número de nodo tiene un formato no válido (-20122 al habilitar o deshabilitar un nodo, -20522 al iniciar un servicio en un nodo); o el clúster rechazó el comando (-713). El clúster también devuelve -713 para un comando dirigido a un nodo o servicio que no existe en el clúster.

Fije la política de inicio de sesión

Los ajustes de inicio de sesión son los únicos ajustes del clúster que conviene cambiar antes de crear los primeros usuarios: se aplican de inmediato a todas las cuentas. La configuración consta de dos partes: la complejidad de las contraseñas y la protección contra ataques de fuerza bruta (el número de intentos fallidos, la ventana de recuento y la duración del bloqueo).

Parámetro	Restricción	Qué define
Número máximo de intentos fallidos de inicio de sesión	Entero, al menos 1	Cuántos intentos fallidos se permiten antes del bloqueo
Ventana de recuento de intentos, minutos	Entero, al menos 1	El intervalo durante el cual el clúster cuenta los intentos fallidos
Duración del bloqueo, minutos	Entero, al menos 0	Cuánto dura el bloqueo; 0 significa que solo puede levantarse manualmente
Longitud mínima de la contraseña	Entero, al menos 1	No se puede establecer una contraseña más corta
Exigir una letra mayúscula	Interruptor	No se acepta una contraseña sin letra mayúscula
Exigir una letra minúscula	Interruptor	No se acepta una contraseña sin letra minúscula
Exigir un dígito	Interruptor	No se acepta una contraseña sin dígito
Exigir un carácter especial	Interruptor	No se acepta una contraseña sin carácter especial

1. Abra Settings (ajustes) y haga clic en Security policy (política de seguridad). El formulario se abre con los valores actuales.

   Todos los usuarios autenticados pueden ver el bloque de complejidad de las contraseñas. Solo el rol Cluster master puede ver los ajustes de protección contra fuerza bruta.

2. Cambie los parámetros necesarios y guarde el formulario. Los campos que no haya cambiado conservan sus valores.

3. Vuelva a abrir el formulario y compruebe que muestra los nuevos valores.

Compruebe el resultado

El clúster supera las comprobaciones de aceptación si se cumplen cinco condiciones:

• la pestaña Resources de la página del clúster tiene una fila por cada nodo, y Node health es normal en todos los nodos;
• todos los pools de la tabla ZFS pools de la pestaña Storage Resources tienen Health en ONLINE;
• el total de núcleos, memoria y capacidad coincide con el cálculo basado en las configuraciones de los nodos;
• la configuración de nodos devuelve los valores de los parámetros que ha establecido;
• el formulario Security policy muestra la política de inicio de sesión que ha configurado.

Si no funciona

• La configuración de nodos no está disponible (-23110 en lecturas y escrituras, -23301 para la lista de parámetros). La feature gate node_config_management está deshabilitada: no se pueden establecer parámetros de nodo hasta que se habilite. Compruebe el estado del indicador en la configuración del clúster.
• No se pudo enviar el comando al agente del nodo (-23133). No hay ningún agente que reciba la configuración. Espere a que arranquen los nodos y compruebe la composición del clúster en la pestaña Resources.
• La interfaz confirmó el guardado, pero el valor en el nodo no cambió. La confirmación solo significa que el valor se envió al nodo. Vuelva a leer los parámetros; si se devuelve el valor anterior, repita la escritura.
• El valor no se acepta (-23124 por debajo del mínimo, -23125 por encima del máximo). El parámetro numérico está fuera del rango permitido. Compruebe los límites y vuelva a intentarlo.
• Un nodo o servicio no cambia de estado (-713). El clúster rechazó el comando: no hay ningún nodo o servicio con ese número o nombre, o no se pudo enviar el comando a los nodos. Compruebe el número de nodo y el nombre del servicio en la pestaña Resources y repita la operación.
• La composición del clúster o la tabla ZFS pools está incompleta. El clúster recopila los datos de nodos y pools desde los nodos y los devuelve con retraso. Actualice la página cuando todos los nodos hayan terminado de arrancar. Si la sección no se abre en absoluto (-403), la cuenta no tiene el privilegio necesario.
• La cuenta está bloqueada hasta que intervenga un administrador (-123). Así se comporta una duración de bloqueo igual a cero: el bloqueo solo puede levantarse manualmente. Establezca un valor mayor que cero si se necesita el desbloqueo automático. El código -124 indica un bloqueo temporal y se devuelve junto con la hora hasta la que permanece en vigor.
• El inicio de sesión falla (-119). La contraseña es incorrecta o el usuario no existe. Si el usuario existe, el error incluye el recuento de intentos fallidos: cuántos intentos se han contabilizado y cuántos quedan antes del bloqueo.

Métodos de la API

Las operaciones de esta página están disponibles a través de la API: get-statusmap, cluster-totals, pools-list, node-config-set, node-config-get, cluster-node-enable, cluster-node-disable, cluster-service-enable, cluster-service-disable, cluster-service-start, cluster-service-stop, auth-security-settings-get, auth-security-settings-set: consulte la referencia de la API.

Consulte también

• Requisitos de hardware y de red: documentación de vStack OS, la referencia para comprobar la configuración aceptada.
• Comprobar el hardware y la red del clúster: cómo verificarlo a través de vStack Center.
• Crear un VDC con Unified Storage: el siguiente paso tras las comprobaciones de aceptación del clúster.