Créez des fichiers de configuration de nœuds pour les déploiements Ubuntu ou Debian
Suggérer des modifications
PDF
Les fichiers de configuration des nœuds sont de petits fichiers texte qui fournissent les informations dont le service hôte StorageGRID a besoin pour démarrer un nœud et le connecter à des ressources de stockage bloc et réseau appropriées. Les fichiers de configuration des nœuds sont utilisés pour les nœuds virtuels et ne sont pas utilisés pour les nœuds de l'appliance.
Où placer les fichiers de configuration des nœuds ?
Vous devez placer le fichier de configuration de chaque noeud StorageGRID dans le /etc/storagegrid/nodes répertoire de l'hôte sur lequel le nœud va s'exécuter. Par exemple, si vous prévoyez d'exécuter un nœud d'administration, un nœud de passerelle et un nœud de stockage sur HostA, vous devez placer trois fichiers de configuration de nœud dans /etc/storagegrid/nodes Sur HostA. Vous pouvez créer les fichiers de configuration directement sur chaque hôte à l'aide d'un éditeur de texte, tel que vim ou nano, ou les créer ailleurs et les déplacer vers chaque hôte.
Comment nommer les fichiers de configuration du nœud ?
Les noms des fichiers de configuration sont importants. Le format est node-name.conf, où node-name est un nom que vous attribuez au nœud. Ce nom apparaît dans le programme d'installation StorageGRID et sert aux opérations de maintenance de nœud, telles que la migration de nœud.
Les noms de nœud doivent respecter les règles suivantes :
-
Doit être unique
-
Doit commencer par une lettre
-
Peut contenir les caractères A à Z et a à z
-
Peut contenir les chiffres 0 à 9
-
Peut contenir un ou plusieurs traits d'Union (-)
-
Ne doit pas comporter plus de 32 caractères, sans le
.confextension
Tous les fichiers dans /etc/storagegrid/nodes qui ne suivent pas ces conventions de dénomination ne seront pas analysées par le service hôte.
Si une topologie multisite est planifiée pour votre grille, il se peut qu'un schéma de nommage de nœud type soit :
site-nodetype-nodenumber.conf
Par exemple, vous pouvez utiliser dc1-adm1.conf Pour le premier nœud d'administration dans Data Center 1, et dc2-sn3.conf Pour le troisième nœud de stockage dans Data Center 2. Toutefois, vous pouvez utiliser n'importe quel schéma, à condition que tous les noms de nœud suivent les règles d'attribution de nom.
Que contient un fichier de configuration de nœud ?
Les fichiers de configuration contiennent des paires clé/valeur, avec une clé et une valeur par ligne. Pour chaque paire clé/valeur, vous devez respecter les règles suivantes :
-
La clé et la valeur doivent être séparées par un signe égal (
=) et blanc facultatif. -
Les clés ne peuvent pas contenir d'espace.
-
Les valeurs peuvent contenir des espaces intégrés.
-
Tout espace blanc de début ou de fin est ignoré.
Certaines clés sont requises pour chaque nœud, tandis que d'autres sont optionnelles ou uniquement nécessaires pour certains types de nœuds.
Le tableau définit les valeurs acceptables pour toutes les clés prises en charge. Dans la colonne du milieu :
R: Requis + BP: Meilleures pratiques + O: Facultatif
| Clé | R, BP OU O ? | Valeur |
|---|---|---|
IP_ADMIN |
PA |
Adresse IPv4 du réseau Grid du nœud d'administration principal de la grille à laquelle ce nœud appartient. Utilisez la même valeur que celle spécifiée pour GRID_NETWORK_IP pour le nœud de grille avec NODE_TYPE = VM_Admin_Node et ADMIN_ROLE = Primary. Si vous omettez ce paramètre, le nœud tente de détecter un nœud d'administration principal à l'aide de mDNS. Remarque : cette valeur est ignorée et peut être interdite sur le noeud d'administration principal. |
CONFIG_RÉSEAU_ADMIN |
O |
DHCP, STATIQUE OU DÉSACTIVÉ |
ADMIN_NETWORK_ESL |
O |
Liste de sous-réseaux séparés par des virgules en notation CIDR à laquelle ce nœud doit communiquer à l'aide de la passerelle Admin Network. Exemple : |
PASSERELLE_RÉSEAU_ADMIN |
O (R) |
Adresse IPv4 de la passerelle réseau d'administration locale pour ce nœud. Doit être sur le sous-réseau défini par ADMIN_NETWORK_IP et ADMIN_NETWORK_MASK. Cette valeur est ignorée pour les réseaux configurés par DHCP. Remarque : ce paramètre est requis si ADMIN_NETWORK_ESL est spécifié. Exemples :
|
IP_RÉSEAU_ADMIN |
O |
Adresse IPv4 de ce nœud sur le réseau d'administration. Cette clé n'est requise que lorsque ADMIN_NETWORK_CONFIG = STATIQUE ; ne la spécifiez pas pour d'autres valeurs. Exemples :
|
ADMIN_NETWORK_MAC |
O |
Adresse MAC de l'interface réseau Admin dans le conteneur. Ce champ est facultatif. Si elle est omise, une adresse MAC est générée automatiquement. Doit être composé de 6 paires de chiffres hexadécimaux séparés par deux-points. Exemple : |
ADMIN_NETWORK_MASK |
O |
Masque de réseau IPv4 pour ce nœud, sur le réseau d'administration. Cette clé n'est requise que lorsque ADMIN_NETWORK_CONFIG = STATIQUE ; ne la spécifiez pas pour d'autres valeurs. Exemples :
|
MTU_RÉSEAU_ADMIN |
O |
Unité de transmission maximale (MTU) pour ce nœud sur le réseau Admin. Ne spécifiez pas si ADMIN_NETWORK_CONFIG = DHCP. Si elle est spécifiée, la valeur doit être comprise entre 1280 et 9216. Si omis, 1500 est utilisé. Si vous souhaitez utiliser des trames jumbo, définissez la valeur MTU sur une valeur adaptée aux trames jumbo, comme 9000. Sinon, conservez la valeur par défaut. IMPORTANT : la valeur MTU du réseau doit correspondre à la valeur configurée sur le port du commutateur auquel le nœud est connecté. Dans le cas contraire, des problèmes de performances réseau ou une perte de paquets peuvent se produire. Exemples :
|
CIBLE_RÉSEAU_ADMIN |
PA |
Nom de l'unité hôte que vous utiliserez pour accéder au réseau d'administration par le nœud StorageGRID. Seuls les noms d'interface réseau sont pris en charge. En général, vous utilisez un nom d'interface différent de celui spécifié pour GRID_NETWORK_TARGET ou CLIENT_NETWORK_TARGET. Remarque : n'utilisez pas de périphérique de liaison ou de pont comme cible réseau. Configurez un VLAN (ou une autre interface virtuelle) sur le périphérique de liaison, ou utilisez un pont et une paire Ethernet virtuelle (veth). Meilleure pratique:spécifiez une valeur même si ce nœud ne possède pas d'adresse IP de réseau Admin initialement. Vous pouvez ensuite ajouter une adresse IP de réseau d'administration plus tard, sans avoir à reconfigurer le nœud sur l'hôte. Exemples :
|
TYPE_CIBLE_RÉSEAU_ADMIN |
O |
Interface (Il s'agit de la seule valeur prise en charge.) |
ADMIN_NETWORK_TARGET_TYPE_INTERFACE_CLONE_MAC |
PA |
Vrai ou faux Définissez la clé sur « true » pour que le conteneur StorageGRID utilise l'adresse MAC de l'interface hôte cible sur le réseau d'administration. Meilleure pratique: dans les réseaux où le mode promiscuous serait nécessaire, utilisez la clé ADMIN_NETWORK_TARGET_TYPE_INTERFACE_CLONE_MAC. Pour plus de détails sur le clonage MAC : |
RÔLE_ADMINISTRATEUR |
R |
Primaire ou non primaire Cette clé n'est requise que lorsque NODE_TYPE = VM_Admin_Node ; ne la spécifiez pas pour d'autres types de nœuds. |
JOURNAUX_AUDIT_BLOC_PÉRIPHÉRIQUE |
R |
Chemin et nom du fichier spécial de périphérique de bloc ce nœud utilisera pour le stockage persistant des journaux d'audit. Cette clé n'est requise que pour les nœuds avec TYPE_NOEUD = VM_Admin_noeud ; ne la spécifiez pas pour d'autres types de noeuds. Exemples :
|
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 |
Chemin et nom du fichier spécial de périphérique de bloc ce nœud utilisera pour le stockage objet permanent. Cette clé n'est requise que pour les nœuds avec TYPE_NOEUD = VM_Storage_noeud ; ne la spécifiez pas pour d'autres types de noeuds. Seul LE BLOC_DEVICE_RANGEDB_000 est requis ; le reste est facultatif. Le dispositif de bloc spécifié pour BLOCK_DEVICE_RANGEDB_000 doit être d'au moins 4 To ; les autres peuvent être plus petits. Ne laissez pas d'espace. Si vous spécifiez BLOCK_DEVICE_RANGEDB_005, vous devez également spécifier BLOCK_DEVICE_RANGEDB_004. Remarque : pour la compatibilité avec les déploiements existants, les clés à deux chiffres sont prises en charge pour les nœuds mis à niveau. Exemples :
|
BLOQUER_LES_TABLES_PÉRIPHÉRIQUES |
R |
Chemin et nom du fichier spécial de l'unité de bloc ce noeud sera utilisé pour le stockage persistant des tables de base de données. Cette clé n'est requise que pour les nœuds avec TYPE_NOEUD = VM_Admin_noeud ; ne la spécifiez pas pour d'autres types de noeuds. Exemples :
|
BLOCK_DEVICE_VAR_LOCAL |
R |
Chemin et nom du fichier spécial de périphérique de bloc ce nœud utilisera pour son stockage persistant /var/local. Exemples :
|
CONFIG_RÉSEAU_CLIENT |
O |
DHCP, STATIQUE OU DÉSACTIVÉ |
PASSERELLE_RÉSEAU_CLIENT |
O |
Adresse IPv4 de la passerelle réseau client locale pour ce nœud, qui doit se trouver sur le sous-réseau défini par CLIENT_NETWORK_IP et CLIENT_NETWORK_MASK. Cette valeur est ignorée pour les réseaux configurés par DHCP. Exemples :
|
IP_RÉSEAU_CLIENT |
O |
Adresse IPv4 de ce nœud sur le réseau client. Cette clé n'est requise que lorsque CLIENT_NETWORK_CONFIG = STATIQUE ; ne la spécifiez pas pour d'autres valeurs. Exemples :
|
CLIENT_RÉSEAU_MAC |
O |
Adresse MAC de l'interface réseau client dans le conteneur. Ce champ est facultatif. Si elle est omise, une adresse MAC est générée automatiquement. Doit être composé de 6 paires de chiffres hexadécimaux séparés par deux-points. Exemple : |
MASQUE_RÉSEAU_CLIENT |
O |
Masque de réseau IPv4 pour ce nœud sur le réseau client. Cette clé n'est requise que lorsque CLIENT_NETWORK_CONFIG = STATIQUE ; ne la spécifiez pas pour d'autres valeurs. Exemples :
|
MTU_CLIENT_RÉSEAU |
O |
Unité de transmission maximale (MTU) pour ce nœud sur le réseau client. Ne spécifiez pas si CLIENT_NETWORK_CONFIG = DHCP. Si elle est spécifiée, la valeur doit être comprise entre 1280 et 9216. Si omis, 1500 est utilisé. Si vous souhaitez utiliser des trames jumbo, définissez la valeur MTU sur une valeur adaptée aux trames jumbo, comme 9000. Sinon, conservez la valeur par défaut. IMPORTANT : la valeur MTU du réseau doit correspondre à la valeur configurée sur le port du commutateur auquel le nœud est connecté. Dans le cas contraire, des problèmes de performances réseau ou une perte de paquets peuvent se produire. Exemples :
|
CIBLE_RÉSEAU_CLIENT |
PA |
Nom du périphérique hôte que vous utiliserez pour accéder au réseau client par le nœud StorageGRID. Seuls les noms d'interface réseau sont pris en charge. En général, vous utilisez un nom d'interface différent de celui spécifié pour GRID_NETWORK_TARGET ou ADMIN_NETWORK_TARGET. Remarque : n'utilisez pas de périphérique de liaison ou de pont comme cible réseau. Configurez un VLAN (ou une autre interface virtuelle) sur le périphérique de liaison, ou utilisez un pont et une paire Ethernet virtuelle (veth). Meilleure pratique : Indiquez une valeur même si ce nœud ne possède pas d'adresse IP de réseau client au départ. Vous pouvez ensuite ajouter une adresse IP du réseau client ultérieurement, sans avoir à reconfigurer le nœud sur l'hôte. Exemples :
|
TYPE_CIBLE_RÉSEAU_CLIENT |
O |
Interface (Cette valeur est prise en charge uniquement.) |
CLIENT_RÉSEAU_CIBLE_TYPE_INTERFACE_CLONE_MAC |
PA |
Vrai ou faux Définissez la clé sur « true » pour que le conteneur StorageGRID utilise l'adresse MAC de l'interface cible hôte sur le réseau client. Meilleure pratique: dans les réseaux où le mode promiscuous serait nécessaire, utilisez plutôt la clé CLIENT_NETWORK_TARGET_TYPE_INTERFACE_CLONE_MAC. Pour plus de détails sur le clonage MAC : |
CONFIG_RÉSEAU_GRID |
PA |
STATIQUE ou DHCP (Statique par défaut si non spécifié.) |
PASSERELLE_RÉSEAU_GRILLE |
R |
Adresse IPv4 de la passerelle réseau Grid locale pour ce nœud, qui doit se trouver sur le sous-réseau défini par GRID_NETWORK_IP et GRID_NETWORK_MASK. Cette valeur est ignorée pour les réseaux configurés par DHCP. Si le réseau Grid est un sous-réseau unique sans passerelle, utilisez soit l'adresse de passerelle standard pour le sous-réseau (X. Y.1), soit la valeur DE GRID_NETWORK_IP de ce nœud. Ces valeurs simplifient les extensions potentielles du réseau Grid. |
IP_RÉSEAU_GRID |
R |
Adresse IPv4 de ce nœud sur le réseau Grid. Cette clé n'est requise que lorsque GRID_NETWORK_CONFIG = STATIQUE ; ne la spécifiez pas pour d'autres valeurs. Exemples :
|
GRID_RÉSEAU_MAC |
O |
Adresse MAC de l'interface réseau de la grille dans le conteneur. Ce champ est facultatif. Si elle est omise, une adresse MAC est générée automatiquement. Doit être composé de 6 paires de chiffres hexadécimaux séparés par deux-points. Exemple : |
GRID_NETWORK_MASK |
O |
Masque de réseau IPv4 pour ce nœud sur le réseau Grid. Cette clé n'est requise que lorsque GRID_NETWORK_CONFIG = STATIQUE ; ne la spécifiez pas pour d'autres valeurs. Exemples :
|
GRID_NETWORK_MTU |
O |
Unité de transmission maximale (MTU) pour ce nœud sur le réseau Grid. Ne spécifiez pas si GRID_NETWORK_CONFIG = DHCP. Si elle est spécifiée, la valeur doit être comprise entre 1280 et 9216. Si omis, 1500 est utilisé. Si vous souhaitez utiliser des trames jumbo, définissez la valeur MTU sur une valeur adaptée aux trames jumbo, comme 9000. Sinon, conservez la valeur par défaut. IMPORTANT : la valeur MTU du réseau doit correspondre à la valeur configurée sur le port du commutateur auquel le nœud est connecté. Dans le cas contraire, des problèmes de performances réseau ou une perte de paquets peuvent se produire. IMPORTANT : pour des performances réseau optimales, tous les nœuds doivent être configurés avec des valeurs MTU similaires sur leurs interfaces réseau Grid. L'alerte Grid Network MTU mismatch est déclenchée en cas de différence importante dans les paramètres MTU pour le réseau Grid sur les nœuds individuels. Les valeurs MTU ne doivent pas nécessairement être identiques pour tous les types de réseau. Exemples : 1500 8192 |
CIBLE_RÉSEAU_GRILLE |
R |
Nom de l'unité hôte que vous utiliserez pour accéder au réseau Grid par le nœud StorageGRID. Seuls les noms d'interface réseau sont pris en charge. En général, vous utilisez un nom d'interface différent de celui spécifié pour ADMIN_NETWORK_TARGET ou CLIENT_NETWORK_TARGET. Remarque : n'utilisez pas de périphérique de liaison ou de pont comme cible réseau. Configurez un VLAN (ou une autre interface virtuelle) sur le périphérique de liaison, ou utilisez un pont et une paire Ethernet virtuelle (veth). Exemples :
|
TYPE_CIBLE_RÉSEAU_GRILLE |
O |
Interface (Il s'agit de la seule valeur prise en charge.) |
GRID_NETWORK_TARGET_TYPE_INTERFACE_CLONE_MAC |
BP |
Vrai ou faux Définissez la valeur de la clé sur « true » pour que le conteneur StorageGRID utilise l'adresse MAC de l'interface cible de l'hôte sur le réseau de la grille. Meilleure pratique: dans les réseaux où le mode promiscuous serait nécessaire, utilisez la clé GRID_NETWORK_TARGET_TYPE_INTERFACE_CLONE_MAC. Pour plus de détails sur le clonage MAC : |
INTERFACE_TARGET_nnnn |
O |
Nom et description facultative d'une interface supplémentaire que vous souhaitez ajouter à ce nœud. Vous pouvez ajouter plusieurs interfaces supplémentaires à chaque nœud. Pour nnnn, spécifiez un numéro unique pour chaque entrée INTERFACE_TARGET que vous ajoutez. Pour la valeur, spécifiez le nom de l'interface physique sur l'hôte bare-Metal. Ensuite, si vous le souhaitez, ajoutez une virgule et fournissez une description de l'interface, qui s'affiche sur la page des interfaces VLAN et sur la page des groupes haute disponibilité. Par exemple : Si vous ajoutez une interface de jonction, vous devez configurer une interface VLAN dans StorageGRID. Si vous ajoutez une interface d'accès, vous pouvez l'ajouter directement à un groupe haute disponibilité ; il n'est pas nécessaire de configurer une interface VLAN. |
RAM_MAXIMALE |
O |
Quantité maximale de RAM que ce nœud est autorisé à consommer. Si cette clé est omise, le nœud n'a aucune restriction de mémoire. Lorsque vous définissez ce champ pour un nœud de niveau production, indiquez une valeur inférieure d'au moins 24 Go et de 16 à 32 Go à la mémoire RAM totale du système. Remarque : la valeur de la RAM affecte l'espace réservé des métadonnées réelles d'un nœud. Voir la "Description de l'espace réservé aux métadonnées". Le format de ce champ est Exemples :
Remarque : si vous souhaitez utiliser cette option, vous devez activer la prise en charge du noyau pour les groupes de mémoire. |
TYPE_NŒUD |
R |
Type de nœud : VM_Admin_Node VM_Storage_Node VM_Archive_Node VM_API_Gateway |
SCHÉMA DE PORT |
O |
Permet de remapper tout port utilisé par un nœud pour les communications internes de nœud de grille ou les communications externes. Le remappage des ports est nécessaire si les stratégies de mise en réseau d'entreprise limitent un ou plusieurs ports utilisés par StorageGRID, comme décrit dans "Communications internes sur les nœuds de la grille" ou "Communications externes". IMPORTANT : ne mappez pas les ports que vous prévoyez d'utiliser pour configurer les noeuds finaux de l'équilibreur de charge. Remarque : si seul PORT_REMAPPAGE est défini, le mappage que vous spécifiez est utilisé pour les communications entrantes et sortantes. Si PORT_REMAPPAGE_INBOUND est également spécifié, PORT_REMAPPAGE s'applique uniquement aux communications sortantes. Le format utilisé est : Par exemple :
|
PORT_REMAPPAGE_ENTRANT |
O |
Mappe de nouveau les communications entrantes sur le port spécifié. Si vous spécifiez PORT_REMAP_INBOUND mais que vous ne spécifiez pas de valeur pour PORT_REMAP, les communications sortantes pour le port sont inchangées. IMPORTANT : ne mappez pas les ports que vous prévoyez d'utiliser pour configurer les noeuds finaux de l'équilibreur de charge. Le format utilisé est : Par exemple :
|