Skip to main content
Hay disponible una nueva versión de este producto.
Se proporciona el idioma español mediante traducción automática para su comodidad. En caso de alguna inconsistencia, el inglés precede al español.

Cree archivos de configuración de nodos para implementaciones de Ubuntu o Debian

Colaboradores

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 .conf extensió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-nodetype-nodenumber.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.

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:

1.1.1.1

10.224.4.81

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:

1.1.1.1

10.224.4.81

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:

255.255.255.0

255.255.248.0

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:

1500

8192

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:

bond0.1002

ens256

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 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:

/dev/disk/by-path/pci-0000:03:00.0-scsi-0:0:0:0

/dev/disk/by-id/wwn-0x600a09800059d6df000060d757b475fd

/dev/mapper/sgws-adm1-audit-logs

BLOCK_DEVICE_RANGEDB_000

BLOCK_DEVICE_RANGEDB_001

BLOCK_DEVICE_RANGEDB_002

BLOCK_DEVICE_RANGEDB_003

BLOCK_DEVICE_RANGEDB_004

BLOCK_DEVICE_RANGEDB_005

BLOCK_DEVICE_RANGEDB_006

BLOCK_DEVICE_RANGEDB_007

BLOCK_DEVICE_RANGEDB_008

BLOCK_DEVICE_RANGEDB_009

BLOCK_DEVICE_RANGEDB_010

BLOCK_DEVICE_RANGEDB_011

BLOCK_DEVICE_RANGEDB_012

BLOCK_DEVICE_RANGEDB_013

BLOCK_DEVICE_RANGEDB_014

BLOCK_DEVICE_RANGEDB_015

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_000; el resto es opcional. El dispositivo de bloque especificado para BLOCK_DEVICE_RANGEDB_000 debe tener al menos 4 TB; los demás pueden ser más pequeños.

No deje espacios. Si especifica BLOCK_DEVICE_RANGEDB_005, también debe especificar BLOCK_DEVICE_RANGEDB_004.

Nota: Para la compatibilidad con las implementaciones existentes, las claves de dos dígitos son compatibles con los nodos actualizados.

Ejemplos:

/dev/disk/by-path/pci-0000:03:00.0-scsi-0:0:0:0

/dev/disk/by-id/wwn-0x600a09800059d6df000060d757b475fd

/dev/mapper/sgws-sn1-rangedb-000

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:

/dev/disk/by-path/pci-0000:03:00.0-scsi-0:0:0:0

/dev/disk/by-id/wwn-0x600a09800059d6df000060d757b475fd

/dev/mapper/sgws-adm1-tables

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:

/dev/disk/by-path/pci-0000:03:00.0-scsi-0:0:0:0

/dev/disk/by-id/wwn-0x600a09800059d6df000060d757b475fd

/dev/mapper/sgws-sn1-var-local

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:

1.1.1.1

10.224.4.81

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:

1.1.1.1

10.224.4.81

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:

255.255.255.0

255.255.248.0

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:

1500

8192

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:

bond0.1003

ens423

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 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:

1.1.1.1

10.224.4.81

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:

255.255.255.0

255.255.248.0

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:

1500 8192

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:

bond0.1001

ens192

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 MAC:

INTERFACES_TARGET_nnnn

O

Nombre y descripción opcional para una interfaz adicional que se desea añadir a este nodo. Puede añadir varias interfaces adicionales a cada nodo.

Para nnnn, especifique un número único para cada entrada_DESTINO_INTERFACES que esté agregando.

Para el valor, especifique el nombre de la interfaz física en el host de configuración básica. A continuación, de manera opcional, añada una coma y proporcione una descripción de la interfaz, que se muestra en la página interfaces VLAN y en la página grupos de alta disponibilidad.

Por ejemplo: INTERFACES_TARGET_01=ens256, Trunk

Si añade una interfaz troncal, debe configurar una interfaz VLAN en StorageGRID. Si agrega una interfaz de acceso, puede agregar la interfaz directamente a un grupo de alta disponibilidad; no es necesario configurar una interfaz de VLAN.

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 Instrucciones para administrar StorageGRID Para obtener una descripción de lo que es el espacio reservado de metadatos.

El formato de este campo es <number><unit>, donde <unit> puede ser b, k, m, o. g.

Ejemplos:

24g

38654705664b

Nota: Si desea utilizar esta opción, debe activar el soporte de núcleo para grupos de memoria.

TIPO_NODO

R

Tipo de nodo:

VM_Admin_Node VM_Storage_Node VM_Archive_Node VM_API_Gateway

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: <network type>/<protocol>/<default port used by grid node>/<new port>, donde <network type> es grid, administrador o cliente, y el protocolo es tcp o udp.

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: <network type>/<protocol:>/<remapped port >/<default port used by grid node>, donde <network type> es grid, administrador o cliente, y el protocolo es tcp o udp.

Por ejemplo:

PORT_REMAP_INBOUND = grid/tcp/3022/22

Información relacionada

Directrices sobre redes