Crie arquivos de configuração de nó para implantações Ubuntu ou Debian
Sugerir alterações
PDFs
Os arquivos de configuração de nó são pequenos arquivos de texto que fornecem as informações que o serviço de host do StorageGRID precisa para iniciar um nó e conectá-lo à rede apropriada e bloquear recursos de armazenamento. Os arquivos de configuração de nós são usados para nós virtuais e não são usados para nós do dispositivo.
Onde coloco os arquivos de configuração do nó?
Você deve colocar o arquivo de configuração para cada nó do StorageGRID /etc/storagegrid/nodes no diretório no host onde o nó será executado. Por exemplo, se você planeja executar um nó de administrador, um nó de gateway e um nó de armazenamento no HostA, você deve colocar três arquivos de configuração de nó no /etc/storagegrid/nodes HostA. Você pode criar os arquivos de configuração diretamente em cada host usando um editor de texto, como vim ou nano, ou você pode criá-los em outro lugar e movê-los para cada host.
O que nomeo os arquivos de configuração do nó?
Os nomes dos arquivos de configuração são significativos. O formato é node-name.conf, onde node-name é um nome atribuído ao nó. Esse nome aparece no Instalador do StorageGRID e é usado para operações de manutenção de nós, como a migração de nós.
Os nomes dos nós devem seguir estas regras:
-
Deve ser único
-
Deve começar com uma letra
-
Pode conter os carateres De A a Z e de a a z
-
Pode conter os números de 0 a 9
-
Pode conter um ou mais hífens (-)
-
Não deve ter mais de 32 carateres, não incluindo a
.confextensão
Quaisquer arquivos /etc/storagegrid/nodes que não sigam essas convenções de nomenclatura não serão analisados pelo serviço host.
Se você tiver uma topologia de vários locais planejada para sua grade, um esquema típico de nomes de nós pode ser:
site-nodetype-nodenumber.conf
Por exemplo, você pode usar dc1-adm1.conf para o primeiro nó de administrador no data center 1 e dc2-sn3.conf para o terceiro nó de storage no data center 2. No entanto, você pode usar qualquer esquema que desejar, desde que todos os nomes de nós sigam as regras de nomenclatura.
O que está em um arquivo de configuração de nó?
Os arquivos de configuração contêm pares chave/valor, com uma chave e um valor por linha. Para cada par chave/valor, você deve seguir estas regras:
-
A chave e o valor devem ser separados por um sinal igual (
=) e espaço em branco opcional. -
As teclas não podem conter espaços.
-
Os valores podem conter espaços incorporados.
-
Qualquer espaço em branco à frente ou à direita é ignorado.
Algumas chaves são necessárias para cada nó, enquanto outras são opcionais ou apenas necessárias para determinados tipos de nó.
A tabela define os valores aceitáveis para todas as chaves suportadas. Na coluna do meio:
R: Necessário e BP: Melhor prática e o: Opcional
| Chave | R, BP OU O? | Valor |
|---|---|---|
ADMIN_IP |
BP |
Rede de grade IPv4 endereço do nó de administração principal para a grade à qual esse nó pertence. Use o mesmo valor que você especificou para GRID_NETWORK_IP para o nó de grade com NODE_TYPE e ADMIN_ROLE. Se você omitir esse parâmetro, o nó tentará descobrir um nó Admin primário usando mDNS. Nota: Este valor é ignorado, e pode ser proibido, no nó Admin principal. |
ADMIN_NETWORK_CONFIG |
O |
DHCP, ESTÁTICO OU DESATIVADO |
ADMIN_NETWORK_ESL |
O |
Lista de sub-redes separadas por vírgulas na notação CIDR à qual esse nó deve se comunicar usando o gateway de rede Admin. Exemplo: |
ADMIN_NETWORK_GATEWAY |
O (R) |
Endereço IPv4 do gateway de rede de administração local para este nó. Deve estar na sub-rede definida por ADMIN_network_IP e ADMIN_network_MASK. Este valor é ignorado para redes configuradas por DHCP. Nota: Este parâmetro é necessário se ADMIN_NETWORK_ESL for especificado. Exemplos:
|
ADMIN_NETWORK_IP |
O |
Endereço IPv4 deste nó na rede Admin. Esta chave só é necessária quando ADMIN_NETWORK_CONFIG é ESTÁTICA; não a especifique para outros valores. Exemplos:
|
ADMIN_NETWORK_MAC |
O |
O endereço MAC da interface de rede de administração no contentor. Este campo é opcional. Se omitido, um endereço MAC será gerado automaticamente. Deve ser 6 pares de dígitos hexadecimais separados por dois pontos. Exemplo: |
ADMIN_NETWORK_MASK |
O |
IPv4 máscara de rede para este nó, na rede Admin. Esta chave só é necessária quando ADMIN_NETWORK_CONFIG é ESTÁTICA; não a especifique para outros valores. Exemplos:
|
ADMIN_NETWORK_MTU |
O |
A unidade de transmissão máxima (MTU) para este nó na rede Admin. Não especifique se ADMIN_NETWORK_CONFIG é DHCP. Se especificado, o valor deve estar entre 1280 e 9216. Se omitido, 1500 é usado. Se você quiser usar quadros jumbo, defina o MTU para um valor adequado para quadros jumbo, como 9000. Caso contrário, mantenha o valor padrão. IMPORTANTE: O valor MTU da rede deve corresponder ao valor configurado na porta do switch à qual o nó está conetado. Caso contrário, problemas de desempenho da rede ou perda de pacotes podem ocorrer. Exemplos:
|
ADMIN_NETWORK_TARGET |
BP |
Nome do dispositivo host que você usará para acesso à rede de administração pelo nó StorageGRID. Apenas são suportados nomes de interface de rede. Normalmente, você usa um nome de interface diferente do que foi especificado para GRID_NETWORK_TARGET ou CLIENT_network_TARGET. Nota: Não use dispositivos bond ou bridge como destino de rede. Configure uma VLAN (ou outra interface virtual) em cima do dispositivo de ligação ou use um par bridge e Ethernet virtual (vete). Prática recomendada:Especifique um valor mesmo que este nó não tenha inicialmente um endereço IP de rede Admin. Em seguida, você pode adicionar um endereço IP de rede Admin mais tarde, sem ter que reconfigurar o nó no host. Exemplos:
|
ADMIN_NETWORK_TARGET_TYPE |
O |
Interface (Este é o único valor suportado.) |
ADMIN_NETWORK_TARGET_TYPE_INTERFACE_CLONE_MAC |
BP |
Verdadeiro ou Falso Defina a chave como "true" para fazer com que o contentor StorageGRID use o endereço MAC da interface de destino do host na rede de administração. Prática recomendada: em redes onde o modo promíscuo seria necessário, use a chave ADMIN_NETWORK_TARGET_TYPE_INTERFACE_CLONE_MAC em vez disso. Para obter mais detalhes sobre clonagem MAC: |
ADMIN_ROLE |
R |
Primário ou não primário Esta chave só é necessária quando NODE_TYPE: VM_Admin_Node; não a especifique para outros tipos de nó. |
BLOCK_DEVICE_AUDIT_LOGS |
R |
Caminho e nome do arquivo especial do dispositivo de bloco que este nó usará para armazenamento persistente de logs de auditoria. Esta chave é necessária apenas para nós com NODE_TYPE: VM_Admin_Node; não a especifique para outros tipos de nó. Exemplos:
|
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 |
Caminho e nome do arquivo especial do dispositivo de bloco que este nó usará para armazenamento de objetos persistente. Esta chave é necessária apenas para nós com NODE_TYPE: VM_Storage_Node; não a especifique para outros tipos de nó. Somente block_DEVICE_RANGEDB_000 é necessário; o resto é opcional. O dispositivo de bloco especificado para block_DEVICE_RANGEDB_000 deve ter pelo menos 4 TB; os outros podem ser menores. Não deixe lacunas. Se você especificar block_DEVICE_RANGEDB_005, você também deve especificar BLOCK_DEVICE_RANGEDB_004. Nota: Para compatibilidade com implantações existentes, chaves de dois dígitos são suportadas para nós atualizados. Exemplos:
|
BLOCK_DEVICE_TABLES |
R |
Caminho e nome do arquivo especial do dispositivo de bloco este nó usará para armazenamento persistente de tabelas de banco de dados. Esta chave é necessária apenas para nós com NODE_TYPE: VM_Admin_Node; não a especifique para outros tipos de nó. Exemplos:
|
BLOCK_DEVICE_VAR_LOCAL |
R |
Caminho e nome do arquivo especial do dispositivo de bloco este nó usará para seu armazenamento persistente /var/local. Exemplos:
|
CLIENT_NETWORK_CONFIG |
O |
DHCP, ESTÁTICO OU DESATIVADO |
CLIENT_NETWORK_GATEWAY |
O |
Endereço IPv4 do gateway de rede de cliente local para este nó, que deve estar na sub-rede definida por CLIENT_network_IP e CLIENT_network_MASK. Este valor é ignorado para redes configuradas por DHCP. Exemplos:
|
CLIENT_NETWORK_IP |
O |
Endereço IPv4 deste nó na rede do cliente. Esta chave só é necessária quando CLIENT_NETWORK_CONFIG é ESTÁTICA; não a especifique para outros valores. Exemplos:
|
CLIENT_NETWORK_MAC |
O |
O endereço MAC da interface de rede do cliente no contentor. Este campo é opcional. Se omitido, um endereço MAC será gerado automaticamente. Deve ser 6 pares de dígitos hexadecimais separados por dois pontos. Exemplo: |
CLIENT_NETWORK_MASK |
O |
IPv4 máscara de rede para este nó na rede do cliente. Esta chave só é necessária quando CLIENT_NETWORK_CONFIG é ESTÁTICA; não a especifique para outros valores. Exemplos:
|
CLIENT_NETWORK_MTU |
O |
A unidade de transmissão máxima (MTU) para este nó na rede do cliente. Não especifique se CLIENT_NETWORK_CONFIG é DHCP. Se especificado, o valor deve estar entre 1280 e 9216. Se omitido, 1500 é usado. Se você quiser usar quadros jumbo, defina o MTU para um valor adequado para quadros jumbo, como 9000. Caso contrário, mantenha o valor padrão. IMPORTANTE: O valor MTU da rede deve corresponder ao valor configurado na porta do switch à qual o nó está conetado. Caso contrário, problemas de desempenho da rede ou perda de pacotes podem ocorrer. Exemplos:
|
CLIENT_NETWORK_TARGET |
BP |
Nome do dispositivo host que você usará para acesso à rede do cliente pelo nó StorageGRID. Apenas são suportados nomes de interface de rede. Normalmente, você usa um nome de interface diferente do que foi especificado para GRID_Network_TARGET ou ADMIN_network_TARGET. Nota: Não use dispositivos bond ou bridge como destino de rede. Configure uma VLAN (ou outra interface virtual) em cima do dispositivo de ligação ou use um par bridge e Ethernet virtual (vete). Prática recomendada: Especifique um valor mesmo que este nó não tenha inicialmente um endereço IP de rede do cliente. Em seguida, você pode adicionar um endereço IP da rede do cliente mais tarde, sem ter que reconfigurar o nó no host. Exemplos:
|
CLIENT_NETWORK_TARGET_TYPE |
O |
Interface (Este é apenas o valor suportado.) |
CLIENT_NETWORK_TARGET_TYPE_INTERFACE_CLONE_MAC |
BP |
Verdadeiro ou Falso Defina a chave como "true" para fazer com que o contentor StorageGRID use o endereço MAC da interface de destino do host na rede do cliente. Melhor prática: em redes onde o modo promíscuo seria necessário, use a chave CLIENT_NETWORK_TARGET_TYPE_INTERFACE_CLONE_MAC em vez disso. Para obter mais detalhes sobre clonagem MAC: |
GRID_NETWORK_CONFIG |
BP |
ESTÁTICO ou DHCP (O padrão é ESTÁTICO se não for especificado.) |
GRID_NETWORK_GATEWAY |
R |
Endereço IPv4 do gateway de rede local para este nó, que deve estar na sub-rede definida por GRID_Network_IP e GRID_NETWORK_MASK. Este valor é ignorado para redes configuradas por DHCP. Se a rede de Grade for uma única sub-rede sem gateway, use o endereço de gateway padrão para a sub-rede (X.Y.z.1) ou o valor GRID_Network_IP deste nó; qualquer valor simplificará expansões futuras de rede de Grade. |
GRID_NETWORK_IP |
R |
Endereço IPv4 deste nó na rede de Grade. Esta chave só é necessária quando GRID_NETWORK_CONFIG é ESTÁTICA; não a especifique para outros valores. Exemplos:
|
GRID_NETWORK_MAC |
O |
O endereço MAC da interface Grid Network no contentor. Este campo é opcional. Se omitido, um endereço MAC será gerado automaticamente. Deve ser 6 pares de dígitos hexadecimais separados por dois pontos. Exemplo: |
GRID_NETWORK_MASK |
O |
IPv4 máscara de rede para este nó na rede de Grade. Esta chave só é necessária quando GRID_NETWORK_CONFIG é ESTÁTICA; não a especifique para outros valores. Exemplos:
|
GRID_NETWORK_MTU |
O |
A unidade de transmissão máxima (MTU) para este nó na rede de Grade. Não especifique se GRID_NETWORK_CONFIG é DHCP. Se especificado, o valor deve estar entre 1280 e 9216. Se omitido, 1500 é usado. Se você quiser usar quadros jumbo, defina o MTU para um valor adequado para quadros jumbo, como 9000. Caso contrário, mantenha o valor padrão. IMPORTANTE: O valor MTU da rede deve corresponder ao valor configurado na porta do switch à qual o nó está conetado. Caso contrário, problemas de desempenho da rede ou perda de pacotes podem ocorrer. IMPORTANTE: Para obter o melhor desempenho da rede, todos os nós devem ser configurados com valores MTU semelhantes em suas interfaces Grid Network. O alerta incompatibilidade de MTU da rede de Grade é acionado se houver uma diferença significativa nas configurações de MTU para a rede de Grade em nós individuais. Os valores de MTU não precisam ser os mesmos para todos os tipos de rede. Exemplos: 1500 8192 |
GRID_NETWORK_TARGET |
R |
Nome do dispositivo host que você usará para acesso à rede de Grade pelo nó StorageGRID. Apenas são suportados nomes de interface de rede. Normalmente, você usa um nome de interface diferente do que foi especificado para ADMIN_NETWORK_TARGET ou CLIENT_network_TARGET. Nota: Não use dispositivos bond ou bridge como destino de rede. Configure uma VLAN (ou outra interface virtual) em cima do dispositivo de ligação ou use um par bridge e Ethernet virtual (vete). Exemplos:
|
GRID_NETWORK_TARGET_TYPE |
O |
Interface (Este é o único valor suportado.) |
GRID_NETWORK_TARGET_TYPE_INTERFACE_CLONE_MAC |
BP |
Verdadeiro ou Falso Defina o valor da chave como "true" para fazer com que o contentor StorageGRID use o endereço MAC da interface de destino do host na rede de Grade. Melhor prática: em redes onde o modo promíscuo seria necessário, use a chave GRID_NETWORK_TARGET_TYPE_INTERFACE_CLONE_MAC em vez disso. Para obter mais detalhes sobre clonagem MAC: |
Interface_TARGET_nnnn |
O |
Nome e descrição opcional para uma interface extra que você deseja adicionar a este nó. Você pode adicionar várias interfaces extras a cada nó. Para nnnnn, especifique um número exclusivo para cada entrada INTERFACE_TARGET que você está adicionando. Para o valor, especifique o nome da interface física no host bare-metal. Em seguida, opcionalmente, adicione uma vírgula e forneça uma descrição da interface, que é exibida na página interfaces VLAN e na página grupos HA. Por exemplo: Se você adicionar uma interface de tronco, deverá configurar uma interface de VLAN no StorageGRID. Se você adicionar uma interface de acesso, poderá adicionar a interface diretamente a um grupo HA; não será necessário configurar uma interface VLAN. |
MÁXIMO_RAM |
O |
A quantidade máxima de RAM que este nó pode consumir. Se esta chave for omitida, o nó não tem restrições de memória. Ao definir este campo para um nó de nível de produção, especifique um valor que seja pelo menos 24 GB e 16 a 32 GB menor que a RAM total do sistema. Nota: O valor da RAM afeta o espaço reservado de metadados real de um nó. Consulte "Descrição do que é Metadata Reserved Space". O formato deste campo é Exemplos:
Nota: Se você quiser usar essa opção, você deve habilitar o suporte do kernel para cgroups de memória. |
NODE_TYPE (TIPO DE NÓ) |
R |
Tipo de nó: VM_Admin_Node VM_Storage_Node VM_Archive_Node VM_API_Gateway |
PORT_REMAP |
O |
Remapeia qualquer porta usada por um nó para comunicações internas de nó de grade ou comunicações externas. O remapeamento de portas é necessário se as políticas de rede empresarial restringirem uma ou mais portas usadas pelo StorageGRID, conforme descrito em "Comunicações internas do nó da grade" ou "Comunicações externas". IMPORTANTE: Não remapegue as portas que você está planejando usar para configurar pontos de extremidade do balanceador de carga. Nota: Se apenas PORT_REMAP estiver definido, o mapeamento especificado será usado para comunicações de entrada e saída. Se Port_REMAP_INBOUND também for especificado, PORT_REMAP se aplica apenas às comunicações de saída. O formato usado é: Por exemplo:
|
PORT_REMAP_INBOUND |
O |
Remapeia as comunicações de entrada para a porta especificada. Se você especificar PORT_REMAP_INBOUND, mas não especificar um valor para PORT_REMAP, as comunicações de saída para a porta não serão alteradas. IMPORTANTE: Não remapegue as portas que você está planejando usar para configurar pontos de extremidade do balanceador de carga. O formato usado é: Por exemplo:
|