Manos a la obra
Creando archivos de configuración del nodo
Sugerir cambios
PDF
Los archivos de configuración de los nodos son archivos de texto pequeños que proporcionan la información que el servicio de host StorageGRID necesita para iniciar un nodo y conectarlo a la red adecuada y bloquear recursos de almacenamiento. Los archivos de configuración de los nodos se usan para los nodos virtuales y no se usan para los nodos del dispositivo.
¿Dónde se colocan los archivos de configuración del nodo?
Debe colocar el archivo de configuración para cada nodo StorageGRID en el /etc/storagegrid/nodes directorio en el host donde se ejecutará el nodo. Por ejemplo, si planea ejecutar un nodo de administración, un nodo de puerta de enlace y un nodo de almacenamiento en Hosta, debe colocar tres archivos de configuración de nodo en /etc/storagegrid/nodes En Hosta. Puede crear los archivos de configuración directamente en cada host mediante un editor de texto, como vim o nano, o bien puede crearlos en otro lugar y moverlos a cada host.
¿Qué nombre tienen los archivos de configuración del nodo?
Los nombres de los archivos de configuración son significativos. El formato es <node-name>.conf, donde <node-name> es un nombre que asigna al nodo. Este nombre aparece en el instalador de StorageGRID y se utiliza para operaciones de mantenimiento de nodos, como la migración de nodos.
Los nombres de los nodos deben seguir estas reglas:
-
Debe ser único
-
Debe comenzar por una letra
-
Puede contener los caracteres De La A a la Z y de la a a la Z.
-
Puede contener los números del 0 al 9
-
Puede contener uno o varios guiones (-)
-
No debe tener más de 32 caracteres, sin incluir el
.confextensión
Todos los archivos incluidos /etc/storagegrid/nodes que no sigan estas convenciones de nomenclatura no serán analizadas por el servicio host.
Si tiene una topología de varios sitios planificada para la cuadrícula, un esquema típico de nomenclatura de nodos podría ser:
<site>-<node type>-<node number>.conf
Por ejemplo, podría utilizar dc1-adm1.conf Para el primer nodo de administrador en el centro de datos 1, y. dc2-sn3.conf Para el tercer nodo de almacenamiento en el centro de datos 2. Sin embargo, puede utilizar cualquier esquema que desee, siempre que todos los nombres de nodo sigan las reglas de nomenclatura.
¿Qué hay en un archivo de configuración de nodo?
Los archivos de configuración contienen pares clave/valor, con una clave y un valor por línea. Para cada par clave/valor, debe seguir estas reglas:
-
La clave y el valor deben estar separados por un signo igual (
=) y espacios en blanco opcionales. -
Las teclas no pueden contener espacios.
-
Los valores pueden contener espacios incrustados.
-
Se ignora cualquier espacio en blanco inicial o final.
Algunas claves son necesarias para cada nodo, mientras que otras son opcionales o solo necesarias para ciertos tipos de nodo.
La tabla define los valores aceptables para todas las claves admitidas. En la columna central:
R: Requerido + BP: Mejor práctica + o: Opcional
| Clave | ¿R, BP O O? | Valor |
|---|---|---|
IP_ADMINISTRADOR |
BP |
La dirección IPv4 de red de grid del nodo de administrador principal para la cuadrícula a la que pertenece este nodo. Utilice el mismo valor especificado para GRID_NETWORK_IP para el nodo de grid con NODE_TYPE = VM_Admin_Node y ADMIN_ROLE = Primary. Si omite este parámetro, el nodo intenta detectar un nodo de administración principal con mDNS. Consulte «'Cómo los nodos de grid detectan el nodo de administración principal». Nota: Este valor se ignora, y podría estar prohibido, en el nodo de administración principal. |
ADMIN_NETWORK_CONFIG |
O |
DHCP, ESTÁTICO O DESHABILITADO |
ADMIN_NETWORK_ESL |
O |
Lista de subredes separadas por comas en la notación CIDR a la que este nodo se debe comunicar a través de la puerta de enlace de red de administración. Ejemplo: 172.16.0.0/21,172.17.0.0/21 |
ADMIN_NETWORK_GATEWAY |
O (R) |
La dirección IPv4 de la puerta de enlace de red de administrador local para este nodo. Debe estar en la subred definida por ADMIN_NETWORK_IP y ADMIN_NETWORK_MASK. Este valor se omite para redes configuradas con DHCP. Nota: Este parámetro es necesario si SE especifica ADMIN_NETWORK_ESL. Ejemplos:
|
IP_RED_ADMIN |
O |
La dirección IPv4 de este nodo en la red administrativa. Esta clave solo es necesaria cuando ADMIN_NETWORK_CONFIG = STATIC; no la especifique para otros valores. Ejemplos:
|
ADMIN_NETWORK_MAC |
O |
La dirección MAC de la interfaz de red de administración en el contenedor. Este campo es opcional. Si se omite, se generará automáticamente una dirección MAC. Debe tener 6 pares de dígitos hexadecimales separados por dos puntos. Ejemplo: b2:9c:02:c2:27:10 |
ADMIN_NETWORK_MASK |
O |
La máscara de red IPv4 para este nodo, en la red de administrador. Esta clave solo es necesaria cuando ADMIN_NETWORK_CONFIG = STATIC; no la especifique para otros valores. Ejemplos:
|
MTU_RED_ADMIN |
O |
La unidad de transmisión máxima (MTU) para este nodo en la red de administración. No especifique si ADMIN_NETWORK_CONFIG = DHCP. Si se especifica, el valor debe estar entre 1280 y 9216. Si se omite, se usa 1500. Si desea utilizar tramas gigantes, establezca el MTU en un valor adecuado para tramas gigantes, como 9000. De lo contrario, mantenga el valor predeterminado. IMPORTANTE: El valor MTU de la red debe coincidir con el valor configurado en el puerto del switch al que está conectado el nodo. De lo contrario, pueden ocurrir problemas de rendimiento de red o pérdida de paquetes. Ejemplos:
|
ADMIN_NETWORK_TARGET |
BP |
Nombre del dispositivo host que utilizará para el acceso a la red de administración mediante el nodo StorageGRID. Solo se admiten nombres de interfaces de red. Normalmente, se utiliza un nombre de interfaz diferente al especificado para GRID_NETWORK_TARGET o CLIENT_NETWORK_TARGET. Nota: No utilice dispositivos de enlace o puente como destino de red. Configure una VLAN (u otra interfaz virtual) en la parte superior del dispositivo de enlace o utilice un puente y un par Ethernet virtual (veth). Mejor práctica: especifique un valor aunque este nodo no tenga inicialmente una dirección IP de red de administración. Después, puede añadir una dirección IP de red de administrador más adelante, sin tener que volver a configurar el nodo en el host. Ejemplos:
|
ADMIN_NETWORK_TARGET_TYPE |
O |
Interfaz (Este es el único valor admitido). |
ADMIN_NETWORK_TARGET_TYPE_INTERFACE_CLONE_MAC |
BP |
Verdadero o Falso Establezca la clave en "TRUE" para que el contenedor StorageGRID use la dirección MAC de la interfaz de destino del host en la red de administración. Mejor práctica: en redes donde se requiera el modo promiscuo, utilice la clave ADMIN_NETWORK_TARGET_TYPE_INTERFACE_CLONE_MAC en su lugar. Para obtener más información sobre la clonación de direcciones MAC, consulte las consideraciones y recomendaciones para la clonación de direcciones MAC. |
ADMIN_ROLE |
R |
Primario o no primario Esta clave solo es necesaria cuando NODE_TYPE = VM_Admin_Node; no la especifique para otros tipos de nodos. |
BLOCK_DEVICE_AUDIT_LOGS |
R |
La ruta y el nombre del archivo especial del dispositivo de bloque que este nodo utilizará para el almacenamiento persistente de los registros de auditoría. Esta clave solo es necesaria para nodos con NODE_TYPE = VM_Admin_Node; no la especifique para otros tipos de nodo. Ejemplos:
|
BLOCK_DEVICE_RANGEDB_00 BLOCK_DEVICE_RANGEDB_01 BLOCK_DEVICE_RANGEDB_02 BLOCK_DEVICE_RANGEDB_03 BLOCK_DEVICE_RANGEDB_04 BLOCK_DEVICE_RANGEDB_05 BLOCK_DEVICE_RANGEDB_06 BLOCK_DEVICE_RANGEDB_07 BLOCK_DEVICE_RANGEDB_08 BLOCK_DEVICE_RANGEDB_09 BLOCK_DEVICE_RANGEDB_10 BLOCK_DEVICE_RANGEDB_11 BLOCK_DEVICE_RANGEDB_12 BLOCK_DEVICE_RANGEDB_13 BLOCK_DEVICE_RANGEDB_14 BLOCK_DEVICE_RANGEDB_15 |
R |
Ruta y nombre del archivo especial del dispositivo de bloque que este nodo utilizará para el almacenamiento de objetos persistente. Esta clave solo es necesaria para nodos con NODE_TYPE = VM_Storage_Node; no la especifique para otros tipos de nodo. Sólo SE requiere BLOCK_DEVICE_RANGEDB_00; el resto es opcional. El dispositivo de bloque especificado para BLOCK_DEVICE_RANGEDB_00 debe tener al menos 4 TB; los demás pueden ser más pequeños. Nota: No deje huecos. Si especifica BLOCK_DEVICE_RANGEDB_05, también debe especificar BLOCK_DEVICE_RANGEDB_04. Ejemplos:
|
BLOCK_DEVICE_TABLES |
R |
Ruta y nombre del archivo especial del dispositivo de bloque que este nodo utilizará para el almacenamiento persistente de tablas de bases de datos. Esta clave solo es necesaria para nodos con NODE_TYPE = VM_Admin_Node; no la especifique para otros tipos de nodo. Ejemplos:
|
BLOCK_DEVICE_VAR_LOCAL |
R |
Ruta y nombre del archivo especial del dispositivo de bloque que este nodo utilizará para su almacenamiento persistente /var/local. Ejemplos:
|
CLIENT_NETWORK_CONFIG |
O |
DHCP, ESTÁTICO O DESHABILITADO |
PUERTA_DE_ENLACE_RED_CLIENTE |
O |
Dirección IPv4 de la puerta de enlace de red de cliente local para este nodo, que debe estar en la subred definida por CLIENT_NETWORK_IP y CLIENT_NETWORK_MASK. Este valor se omite para redes configuradas con DHCP. Ejemplos:
|
IP_RED_CLIENTE |
O |
La dirección IPv4 de este nodo en la red cliente. Esta clave solo es necesaria cuando CLIENT_NETWORK_CONFIG = STATIC; no la especifique para otros valores. Ejemplos:
|
MAC_RED_CLIENTE |
O |
La dirección MAC de la interfaz de red de cliente en el contenedor. Este campo es opcional. Si se omite, se generará automáticamente una dirección MAC. Debe tener 6 pares de dígitos hexadecimales separados por dos puntos. Ejemplo: b2:9c:02:c2:27:20 |
MÁSCARA_RED_CLIENTE |
O |
La máscara de red IPv4 para este nodo en la red de cliente. Esta clave solo es necesaria cuando CLIENT_NETWORK_CONFIG = STATIC; no la especifique para otros valores. Ejemplos:
|
MTU_RED_CLIENTE |
O |
La unidad de transmisión máxima (MTU) para este nodo en la red cliente. No especifique si CLIENT_NETWORK_CONFIG = DHCP. Si se especifica, el valor debe estar entre 1280 y 9216. Si se omite, se usa 1500. Si desea utilizar tramas gigantes, establezca el MTU en un valor adecuado para tramas gigantes, como 9000. De lo contrario, mantenga el valor predeterminado. IMPORTANTE: El valor MTU de la red debe coincidir con el valor configurado en el puerto del switch al que está conectado el nodo. De lo contrario, pueden ocurrir problemas de rendimiento de red o pérdida de paquetes. Ejemplos:
|
DESTINO_RED_CLIENTE |
BP |
Nombre del dispositivo host que utilizará para el acceso a la red de cliente mediante el nodo StorageGRID. Solo se admiten nombres de interfaces de red. Normalmente, se utiliza un nombre de interfaz diferente al especificado para GRID_NETWORK_TARGET o ADMIN_NETWORK_TARGET. Nota: No utilice dispositivos de enlace o puente como destino de red. Configure una VLAN (u otra interfaz virtual) en la parte superior del dispositivo de enlace o utilice un puente y un par Ethernet virtual (veth). Mejor práctica: especifique un valor aunque este nodo no tenga inicialmente una dirección IP de red de cliente. Después puede añadir una dirección IP de red de cliente más tarde, sin tener que volver a configurar el nodo en el host. Ejemplos:
|
CLIENT_NETWORK_TARGET_TYPE |
O |
Interfaz (Solo se admite este valor). |
CLIENT_NETWORK_TARGET_TYPE_INTERFACE_CLONE_MAC |
BP |
Verdadero o Falso Establezca la clave en "true" para hacer que el contenedor StorageGRID utilice la dirección MAC de la interfaz de destino del host en la red cliente. Mejor práctica: en redes donde se requiera el modo promiscuo, utilice la clave CLIENT_NETWORK_TARGET_TYPE_INTERFACE_CLONE_MAC en su lugar. Para obtener más información sobre la clonación de direcciones MAC, consulte las consideraciones y recomendaciones para la clonación de direcciones MAC. |
GRID_NETWORK_CONFIG |
BP |
ESTÁTICO o DHCP (De forma predeterminada, ES ESTÁTICO si no se especifica.) |
PUERTA_DE_ENLACE_RED_GRID |
R |
Dirección IPv4 de la puerta de enlace de red local para este nodo, que debe estar en la subred definida por GRID_NETWORK_IP y GRID_NETWORK_MASK. Este valor se omite para redes configuradas con DHCP. Si la red de red es una subred única sin puerta de enlace, utilice la dirección de puerta de enlace estándar de la subred (X.30 Z.1) o el valor DE GRID_NETWORK_IP de este nodo; cualquiera de los dos valores simplificará las posibles futuras expansiones de red de cuadrícula. |
IP_RED_GRID |
R |
Dirección IPv4 de este nodo en la red de cuadrícula. Esta clave solo es necesaria cuando GRID_NETWORK_CONFIG = STATIC; no la especifique para otros valores. Ejemplos:
|
MAC_RED_GRID |
O |
La dirección MAC de la interfaz de red de red del contenedor. Este campo es opcional. Si se omite, se generará automáticamente una dirección MAC. Debe tener 6 pares de dígitos hexadecimales separados por dos puntos. Ejemplo: b2:9c:02:c2:27:30 |
GRID_NETWORK_MASK |
O |
Máscara de red IPv4 para este nodo en la red de cuadrícula. Esta clave solo es necesaria cuando GRID_NETWORK_CONFIG = STATIC; no la especifique para otros valores. Ejemplos:
|
MTU_RED_GRID |
O |
La unidad de transmisión máxima (MTU) para este nodo en la red Grid. No especifique si GRID_NETWORK_CONFIG = DHCP. Si se especifica, el valor debe estar entre 1280 y 9216. Si se omite, se usa 1500. Si desea utilizar tramas gigantes, establezca el MTU en un valor adecuado para tramas gigantes, como 9000. De lo contrario, mantenga el valor predeterminado. IMPORTANTE: El valor MTU de la red debe coincidir con el valor configurado en el puerto del switch al que está conectado el nodo. De lo contrario, pueden ocurrir problemas de rendimiento de red o pérdida de paquetes. IMPORTANTE: Para obtener el mejor rendimiento de red, todos los nodos deben configurarse con valores MTU similares en sus interfaces de red Grid. La alerta Red de cuadrícula MTU se activa si hay una diferencia significativa en la configuración de MTU para la Red de cuadrícula en nodos individuales. Los valores de MTU no tienen que ser iguales para todos los tipos de red. Ejemplos:
|
GRID_NETWORK_TARGET |
R |
Nombre del dispositivo host que utilizará para el acceso a la red de cuadrícula mediante el nodo StorageGRID. Solo se admiten nombres de interfaces de red. Normalmente, se utiliza un nombre de interfaz diferente al especificado para ADMIN_NETWORK_TARGET o CLIENT_NETWORK_TARGET. Nota: No utilice dispositivos de enlace o puente como destino de red. Configure una VLAN (u otra interfaz virtual) en la parte superior del dispositivo de enlace o utilice un puente y un par Ethernet virtual (veth). Ejemplos:
|
GRID_NETWORK_TARGET_TYPE |
O |
Interfaz (Este es el único valor admitido). |
GRID_NETWORK_TARGET_TYPE_INTERFACE_CLONE_MAC |
BP |
Verdadero o Falso Establezca el valor de la clave en "verdadero" para que el contenedor StorageGRID utilice la dirección MAC de la interfaz de destino del host en la red de red. Mejor práctica: en redes donde se requiera el modo promiscuo, utilice la clave GRID_NETWORK_TARGET_TYPE_INTERFACE_CLONE_MAC en su lugar. Para obtener más información sobre la clonación de direcciones MAC, consulte las consideraciones y recomendaciones para la clonación de direcciones MAC. |
RAM_MÁXIMA |
O |
La cantidad máxima de RAM que se permite que este nodo consuma. Si se omite esta clave, el nodo no tiene restricciones de memoria. Al establecer este campo para un nodo de nivel de producción, especifique un valor que sea al menos 24 GB y 16 a 32 GB menor que la RAM total del sistema. Nota: El valor de la RAM afecta al espacio reservado real de metadatos de un nodo. Consulte las instrucciones para administrar StorageGRID para obtener una descripción de lo que es el espacio reservado de metadatos. El formato de este campo es Ejemplos: 24 g. 3865470566b Nota: Si desea utilizar esta opción, debe activar el soporte de núcleo para grupos de memoria. |
TIPO_NODO |
R |
Tipo de nodo:
|
REASIGNAR_PUERTO |
O |
Reasigna cualquier puerto que usa un nodo para las comunicaciones internas del nodo de grid o las comunicaciones externas. Es necesario volver a asignar puertos si las políticas de red de la empresa restringen uno o más puertos utilizados por StorageGRID, como se describe en «'Comunicaciones internas de nodos de grid» o «'Comunicaciones externas». IMPORTANTE: No reasigne los puertos que va a utilizar para configurar puntos finales de equilibrador de carga. Nota: Si sólo SE establece PORT_REMAPP, la asignación que especifique se utiliza tanto para comunicaciones entrantes como salientes. Si TAMBIÉN se especifica PORT_REMAPP_INBOUND, PORT_REMAPP sólo se aplica a las comunicaciones salientes. El formato utilizado es: Por ejemplo: PORT_REMAP = client/tcp/18082/443 |
PORT_REMAPP_INBOUND |
O |
Reasigna las comunicaciones entrantes al puerto especificado. Si especifica PORT_REMAPP_INBOUND pero no especifica un valor para PORT_REMAPP, las comunicaciones salientes para el puerto no se modifican. IMPORTANTE: No reasigne los puertos que va a utilizar para configurar puntos finales de equilibrador de carga. El formato utilizado es: Por ejemplo: PORT_REMAP_INBOUND = grid/tcp/3022/22 |
"La forma en que los nodos de grid detectan el nodo de administrador principal"