Erstellen von Knoten-Konfigurationsdateien
Konfigurationsdateien für die Nodes sind kleine Textdateien, die die Informationen liefern, die der StorageGRID-Host-Service benötigt, um einen Node zu starten und eine Verbindung zu den entsprechenden Netzwerk- und Block-Storage-Ressourcen herzustellen. Die Node-Konfigurationsdateien werden für virtuelle Nodes verwendet und nicht für Appliance-Nodes verwendet.
Wo lege ich die Knoten-Konfigurationsdateien ab?
Sie müssen die Konfigurationsdatei für jeden StorageGRID-Knoten im platzieren /etc/storagegrid/nodes
Verzeichnis auf dem Host, auf dem der Knoten ausgeführt wird. Wenn Sie beispielsweise einen Admin-Node, einen Gateway-Node und einen Storage-Node auf Hosta ausführen möchten, müssen Sie die Konfigurationsdateien mit drei Knoten in die Datei legen /etc/storagegrid/nodes
Auf Hosta. Sie können die Konfigurationsdateien direkt auf jedem Host mit einem Texteditor, wie z. B. vim oder nano, erstellen oder sie an einem anderen Ort erstellen und auf jeden Host verschieben.
Was bename ich die Node-Konfigurationsdateien?
Die Namen der Konfigurationsdateien sind erheblich. Das Format lautet node-name.conf
, Wo node-name
Ist ein Name, den Sie dem Node zuweisen. Dieser Name wird im StorageGRID Installer angezeigt und wird für Knotenwartungsvorgänge, z. B. für Node-Migration, verwendet.
Node-Namen müssen folgende Bedingungen erfüllen:
-
Muss eindeutig sein
-
Nur mit einem Buchstaben beginnen
-
Kann die Zeichen A bis Z und a bis z enthalten
-
Kann die Zahlen 0 bis 9 enthalten
-
Kann eine oder mehrere Bindestriche enthalten (-)
-
Darf nicht mehr als 32 Zeichen enthalten, wobei der nicht enthalten ist
.conf
Erweiterung
Alle Dateien in /etc/storagegrid/nodes
Wenn diese Namenskonventionen nicht eingehalten werden, wird dies vom Host-Service nicht geparst.
Wenn das Grid eine Topologie mit mehreren Standorten geplant ist, ist unter Umständen ein typisches Benennungsschema für Node möglich:
site-nodetype-nodenumber.conf
Beispielsweise können Sie verwenden dc1-adm1.conf
Für den ersten Admin-Node in Data Center 1 und dc2-sn3.conf
Für den dritten Storage-Node in Datacenter 2. Sie können jedoch ein beliebiges Schema verwenden, das Sie mögen, solange alle Knotennamen den Benennungsregeln folgen.
Was befindet sich in einer Node-Konfigurationsdatei?
Die Konfigurationsdateien enthalten Schlüssel-/Wertpaare mit einem Schlüssel und einem Wert pro Zeile. Für jedes Schlüssel-/Wertpaar müssen Sie folgende Regeln einhalten:
-
Der Schlüssel und der Wert müssen durch ein Gleichheitszeichen getrennt werden (
=
) Und optional Whitespace. -
Die Schlüssel können keine Leerzeichen enthalten.
-
Die Werte können eingebettete Leerzeichen enthalten.
-
Führende oder nachgestellte Leerzeichen werden ignoriert.
Einige Schlüssel sind für jeden Knoten erforderlich, während andere optional sind oder nur für bestimmte Node-Typen erforderlich sind.
Die Tabelle definiert die zulässigen Werte für alle unterstützten Schlüssel. In der mittleren Spalte:
R: Erforderlich + BP: Best Practice + O: Optional
Taste | R, BP ODER O? | Wert |
---|---|---|
ADMIN_IP |
BP |
Grid Network IPv4-Adresse des primären Admin-Knotens für das Grid, zu dem dieser Node gehört. Verwenden Sie denselben Wert, den Sie für GRID_NETWORK_IP für den Grid-Node mit NODE_TYPE = VM_Admin_Node und ADMIN_ROLE = Primary angegeben haben. Wenn Sie diesen Parameter nicht angeben, versucht der Node, einen primären Admin-Node mit mDNS zu ermitteln. Siehe „ Hinweis: Dieser Wert wird auf dem primären Admin-Node ignoriert und kann möglicherweise nicht verwendet werden. |
ADMIN_NETWORK_CONFIG |
O |
DHCP, STATISCH ODER DEAKTIVIERT |
ADMIN_NETWORK_ESL |
O |
Kommagetrennte Liste von Subnetzen in CIDR-Notation, mit denen dieser Knoten über das Admin Network-Gateway kommunizieren soll. Beispiel: 172.16.0.0/21,172.17.0.0/21 |
ADMIN_NETWORK_GATEWAY |
O (R) |
IPv4-Adresse des lokalen Admin-Netzwerk-Gateways für diesen Node. Muss sich im Subnetz befinden, das von ADMIN_NETWORK_IP und ADMIN_NETWORK_MASKE definiert ist. Dieser Wert wird bei DHCP-konfigurierten Netzwerken ignoriert. Hinweis: Dieser Parameter ist erforderlich, wenn ADMIN_NETWORK_ESL angegeben wird. Beispiele:
|
ADMIN_NETWORK_IP |
O |
IPv4-Adresse dieses Knotens im Admin-Netzwerk. Dieser Schlüssel ist nur erforderlich, wenn ADMIN_NETWORK_CONFIG = STATISCH; nicht für andere Werte angeben. Beispiele:
|
ADMIN_NETWORK_MAC |
O |
Die MAC-Adresse für die Admin-Netzwerkschnittstelle im Container. Dieses Feld ist optional. Wenn keine Angabe erfolgt, wird automatisch eine MAC-Adresse generiert. Muss aus 6 Hexadezimalziffern bestehen, die durch Doppelpunkte getrennt werden. Beispiel: b2:9c:02:c2:27:10 |
ADMIN_NETWORK_MASKE |
O |
IPv4-Netmask für diesen Node im Admin-Netzwerk. Dieser Schlüssel ist nur erforderlich, wenn ADMIN_NETWORK_CONFIG = STATISCH; nicht für andere Werte angeben. Beispiele:
|
ADMIN_NETWORK_MTU |
O |
Die maximale Übertragungseinheit (MTU) für diesen Knoten im Admin-Netzwerk. Geben Sie nicht an, ob ADMIN_NETWORK_CONFIG = DHCP ist. Wenn angegeben, muss der Wert zwischen 1280 und 9216 liegen. Wenn weggelassen wird, wird 1500 verwendet. Wenn Sie Jumbo Frames verwenden möchten, setzen Sie die MTU auf einen für Jumbo Frames geeigneten Wert, z. B. 9000. Behalten Sie andernfalls den Standardwert bei. WICHTIG: Der MTU-Wert des Netzwerks muss mit dem Wert übereinstimmen, der auf dem Switch-Port konfiguriert ist, an den der Knoten angeschlossen ist. Andernfalls können Probleme mit der Netzwerkleistung oder Paketverluste auftreten. Beispiele:
|
ADMIN_NETWORK_TARGET |
BP |
Name des Host-Geräts, das Sie für den Administratornetzwerkzugriff durch den StorageGRID-Knoten verwenden werden. Es werden nur Namen von Netzwerkschnittstellen unterstützt. Normalerweise verwenden Sie einen anderen Schnittstellennamen als den für GRID_NETWORK_TARGET oder CLIENT_NETWORK_TARGET angegebenen Namen. Hinweis: Verwenden Sie keine Bond- oder Bridge-Geräte als Netzwerkziel. Konfigurieren Sie entweder ein VLAN (oder eine andere virtuelle Schnittstelle) auf dem Bond-Gerät oder verwenden Sie ein Bridge- und virtuelles Ethernet-Paar (veth). Best Practice: Geben Sie einen Wert an, auch wenn dieser Knoten zunächst keine Admin-Netzwerk-IP-Adresse hat. Anschließend können Sie später eine Admin-Netzwerk-IP-Adresse hinzufügen, ohne den Node auf dem Host neu konfigurieren zu müssen. Beispiele:
|
ADMIN_NETWORK_TARGET_TYPE |
O |
Schnittstelle (Dies ist der einzige unterstützte Wert.) |
ADMIN_NETWORK_TARGET_TYPE_INTERFACE_CLONE_MAC |
BP |
Richtig oder falsch Setzen Sie den Schlüssel auf „true“, damit der StorageGRID-Container die MAC-Adresse der Host-Zielschnittstelle im Admin-Netzwerk verwendet. Best Practice: in Netzwerken, in denen der promiskuious-Modus erforderlich wäre, verwenden Sie stattdessen DEN ADMIN_NETWORK_TARGET_TYPE_INTERFACE_CLONE_MAC-Schlüssel. Weitere Informationen zum Klonen von MAC-Adressen finden Sie in den Überlegungen und Empfehlungen zum Klonen von MAC-Adressen. |
ADMIN_ROLLE |
R |
Primärer oder nicht primärer Storage Dieser Schlüssel ist nur erforderlich, wenn NODE_TYPE = VM_Admin_Node; nicht für andere Node-Typen angeben. |
BLOCK_DEVICE_AUDIT_LOGS |
R |
Pfad und Name der Sonderdatei für Blockgeräte, die dieser Node für die persistente Speicherung von Prüfprotokollen verwendet. Dieser Schlüssel ist nur für Knoten mit NODE_TYPE = VM_Admin_Node erforderlich; geben Sie ihn nicht für andere Node-Typen an. Beispiele:
|
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 |
Pfad und Name der Sonderdatei für das Blockgerät wird dieser Node für den persistenten Objekt-Storage verwenden. Dieser Schlüssel ist nur für Knoten mit NODE_TYPE = VM_Storage_Node erforderlich; geben Sie ihn nicht für andere Node-Typen an. Es ist nur BLOCK_DEVICE_RANGEDB_00 erforderlich; der Rest ist optional. Das für BLOCK_DEVICE_RANGEDB_00 angegebene Blockgerät muss mindestens 4 TB betragen; die anderen können kleiner sein. Hinweis: Keine Lücken hinterlassen. Wenn Sie BLOCK_DEVICE_RANGEDB_05 angeben, müssen Sie auch BLOCK_DEVICE_RANGEDB_04 angeben. Beispiele:
|
BLOCK_DEVICE_TABLES |
R |
Pfad und Name der Sonderdatei des Blockgerätes, die dieser Knoten für die dauerhafte Speicherung von Datenbanktabellen verwendet. Dieser Schlüssel ist nur für Knoten mit NODE_TYPE = VM_Admin_Node erforderlich; geben Sie ihn nicht für andere Node-Typen an. Beispiele:
|
BLOCK_DEVICE_VAR_LOCAL |
R |
Pfad und Name der Sonderdatei für das Blockgerät wird dieser Node für seinen persistenten Speicher /var/local verwenden. Beispiele:
|
CLIENT_NETWORK_CONFIG |
O |
DHCP, STATISCH ODER DEAKTIVIERT |
CLIENT_NETWORK_GATEWAY |
O |
IPv4-Adresse des lokalen Client-Netzwerk-Gateways für diesen Node, der sich im Subnetz befinden muss, das durch CLIENT_NETWORK_IP und CLIENT_NETWORK_MASK definiert ist. Dieser Wert wird bei DHCP-konfigurierten Netzwerken ignoriert. Beispiele:
|
CLIENT_NETWORK_IP |
O |
IPv4-Adresse dieses Knotens im Client-Netzwerk. Dieser Schlüssel ist nur erforderlich, wenn CLIENT_NETWORK_CONFIG = STATISCH; nicht für andere Werte angeben. Beispiele:
|
CLIENT_NETWORK_MAC |
O |
Die MAC-Adresse für die Client-Netzwerkschnittstelle im Container. Dieses Feld ist optional. Wenn keine Angabe erfolgt, wird automatisch eine MAC-Adresse generiert. Muss aus 6 Hexadezimalziffern bestehen, die durch Doppelpunkte getrennt werden. Beispiel: b2:9c:02:c2:27:20 |
CLIENT_NETWORK_MASK |
O |
IPv4-Netzmaske für diesen Knoten im Client-Netzwerk. Dieser Schlüssel ist nur erforderlich, wenn CLIENT_NETWORK_CONFIG = STATISCH; nicht für andere Werte angeben. Beispiele:
|
CLIENT_NETWORK_MTU |
O |
Die maximale Übertragungseinheit (MTU) für diesen Knoten im Client-Netzwerk. Geben Sie nicht an, ob CLIENT_NETWORK_CONFIG = DHCP ist. Wenn angegeben, muss der Wert zwischen 1280 und 9216 liegen. Wenn weggelassen wird, wird 1500 verwendet. Wenn Sie Jumbo Frames verwenden möchten, setzen Sie die MTU auf einen für Jumbo Frames geeigneten Wert, z. B. 9000. Behalten Sie andernfalls den Standardwert bei. WICHTIG: Der MTU-Wert des Netzwerks muss mit dem Wert übereinstimmen, der auf dem Switch-Port konfiguriert ist, an den der Knoten angeschlossen ist. Andernfalls können Probleme mit der Netzwerkleistung oder Paketverluste auftreten. Beispiele:
|
CLIENT_NETWORK_TARGET |
BP |
Name des Host-Geräts, das Sie für den Zugriff auf das Client-Netzwerk durch den StorageGRID-Knoten verwenden werden. Es werden nur Namen von Netzwerkschnittstellen unterstützt. Normalerweise verwenden Sie einen anderen Schnittstellennamen als der für GRID_NETWORK_TARGET oder ADMIN_NETWORK_TARGET angegeben wurde. Hinweis: Verwenden Sie keine Bond- oder Bridge-Geräte als Netzwerkziel. Konfigurieren Sie entweder ein VLAN (oder eine andere virtuelle Schnittstelle) auf dem Bond-Gerät oder verwenden Sie ein Bridge- und virtuelles Ethernet-Paar (veth). Best Practice: Geben Sie einen Wert an, auch wenn dieser Knoten zunächst keine Client Network IP Adresse hat. Anschließend können Sie später eine Client-Netzwerk-IP-Adresse hinzufügen, ohne den Node auf dem Host neu konfigurieren zu müssen. Beispiele:
|
CLIENT_NETWORK_TARGET_TYPE |
O |
Schnittstelle (Dieser Wert wird nur unterstützt.) |
CLIENT_NETWORK_TARGET_TYPE_INTERFACE_CLONE_MAC |
BP |
Richtig oder falsch Setzen Sie den Schlüssel auf „true“, damit der StorageGRID-Container die MAC-Adresse der Host-Zielschnittstelle im Client-Netzwerk verwenden kann. Best Practice: in Netzwerken, in denen der promiskuious-Modus erforderlich wäre, verwenden Sie stattdessen DEN CLIENT_NETWORK_TARGET_TYPE_INTERFACE_CLONE_MAC-Schlüssel. Weitere Informationen zum Klonen von MAC-Adressen finden Sie in den Überlegungen und Empfehlungen zum Klonen von MAC-Adressen. |
GRID_NETWORK_CONFIG |
BP |
STATISCH oder DHCP (Ist standardmäßig STATISCH, wenn nicht angegeben.) |
GRID_NETWORK_GATEWAY |
R |
IPv4-Adresse des lokalen Grid-Netzwerk-Gateways für diesen Node, der sich im Subnetz befinden muss, das durch GRID_NETWORK_IP und GRID_NETWORK_MASKE definiert ist. Dieser Wert wird bei DHCP-konfigurierten Netzwerken ignoriert. Wenn das Grid-Netzwerk ein einzelnes Subnetz ohne Gateway ist, verwenden Sie entweder die Standard-Gateway-Adresse für das Subnetz (X.Z.1) oder den GRID_NETWORK_IP-Wert dieses Knotens; jeder Wert wird mögliche zukünftige Grid-Netzwerk-Erweiterungen vereinfachen. |
GRID_NETWORK_IP |
R |
IPv4-Adresse dieses Knotens im Grid-Netzwerk. Dieser Schlüssel ist nur erforderlich, wenn GRID_NETWORK_CONFIG = STATISCH; nicht für andere Werte angeben. Beispiele:
|
GRID_NETWORK_MAC |
O |
Die MAC-Adresse für die Grid-Netzwerkschnittstelle im Container. Dieses Feld ist optional. Wenn keine Angabe erfolgt, wird automatisch eine MAC-Adresse generiert. Muss aus 6 Hexadezimalziffern bestehen, die durch Doppelpunkte getrennt werden. Beispiel: b2:9c:02:c2:27:30 |
GRID_NETWORK_MASKE |
O |
IPv4-Netzmaske für diesen Knoten im Grid-Netzwerk. Dieser Schlüssel ist nur erforderlich, wenn GRID_NETWORK_CONFIG = STATISCH; nicht für andere Werte angeben. Beispiele:
|
GRID_NETWORK_MTU |
O |
Die maximale Übertragungseinheit (MTU) für diesen Knoten im Grid-Netzwerk. Geben Sie nicht an, ob GRID_NETWORK_CONFIG = DHCP ist. Wenn angegeben, muss der Wert zwischen 1280 und 9216 liegen. Wenn weggelassen wird, wird 1500 verwendet. Wenn Sie Jumbo Frames verwenden möchten, setzen Sie die MTU auf einen für Jumbo Frames geeigneten Wert, z. B. 9000. Behalten Sie andernfalls den Standardwert bei. WICHTIG: Der MTU-Wert des Netzwerks muss mit dem Wert übereinstimmen, der auf dem Switch-Port konfiguriert ist, an den der Knoten angeschlossen ist. Andernfalls können Probleme mit der Netzwerkleistung oder Paketverluste auftreten. WICHTIG: Für die beste Netzwerkleistung sollten alle Knoten auf ihren Grid Network Interfaces mit ähnlichen MTU-Werten konfiguriert werden. Die Warnung Grid Network MTU mismatch wird ausgelöst, wenn sich die MTU-Einstellungen für das Grid Network auf einzelnen Knoten erheblich unterscheiden. Die MTU-Werte müssen nicht für alle Netzwerktypen identisch sein. Beispiele:
|
GRID_NETWORK_TARGET |
R |
Name des Hostgeräts, das Sie für den Netzzugang über den StorageGRID-Knoten verwenden werden. Es werden nur Namen von Netzwerkschnittstellen unterstützt. Normalerweise verwenden Sie einen anderen Schnittstellennamen als den für ADMIN_NETWORK_TARGET oder CLIENT_NETWORK_TARGET angegebenen. Hinweis: Verwenden Sie keine Bond- oder Bridge-Geräte als Netzwerkziel. Konfigurieren Sie entweder ein VLAN (oder eine andere virtuelle Schnittstelle) auf dem Bond-Gerät oder verwenden Sie ein Bridge- und virtuelles Ethernet-Paar (veth). Beispiele:
|
GRID_NETWORK_TARGET_TYPE |
O |
Schnittstelle (Dies ist der einzige unterstützte Wert.) |
GRID_NETWORK_TARGET_TYPE_INTERFACE_CLONE_MAC |
BP |
Richtig oder falsch Setzen Sie den Wert des Schlüssels auf „true“, um den StorageGRID-Container dazu zu bringen, die MAC-Adresse der Host-Zielschnittstelle im Grid-Netzwerk zu verwenden. Best Practice: in Netzwerken, in denen der promiskuious-Modus erforderlich wäre, verwenden Sie stattdessen DEN GRID_NETWORK_TARGET_TYPE_INTERFACE_CLONE_MAC-Schlüssel. Weitere Informationen zum Klonen von MAC-Adressen finden Sie in den Überlegungen und Empfehlungen zum Klonen von MAC-Adressen. |
MAXIMUM_RAM |
O |
Der maximale RAM-Umfang, den dieser Node nutzen darf. Wenn dieser Schlüssel nicht angegeben ist, gelten für den Node keine Speicherbeschränkungen. Wenn Sie dieses Feld für einen Knoten auf Produktionsebene festlegen, geben Sie einen Wert an, der mindestens 24 GB und 16 bis 32 GB kleiner als der gesamte RAM des Systems ist. Hinweis: Der RAM-Wert wirkt sich auf den tatsächlich reservierten Metadatenspeicherplatz eines Knotens aus. Eine Beschreibung des reservierten Speicherplatzes für Metadaten finden Sie in der Anleitung zum Verwalten von StorageGRID. Das Format für dieses Feld lautet Beispiele: 24 g 38654705664b Hinweis: Wenn Sie diese Option verwenden möchten, müssen Sie Kernel-Unterstützung für Speicher-cgroups aktivieren. |
NODE_TYPE |
R |
Node-Typ:
|
PORT_NEU ZUORDNEN |
O |
Ordnet alle von einem Node verwendeten Ports für interne Grid Node-Kommunikation oder externe Kommunikation neu zu. Ports müssen neu zugeordnet werden, wenn Netzwerkrichtlinien eines oder mehrere von StorageGRID verwendete Ports beschränken. Dies wird unter „ WICHTIG: Die Ports, die Sie für die Konfiguration von Load Balancer-Endpunkten planen, nicht neu zuordnen. Hinweis: Wenn nur PORT_REMAP eingestellt ist, wird die von Ihnen angegebene Zuordnung sowohl für eingehende als auch für ausgehende Kommunikation verwendet. Wenn AUCH PORT_REMAP_INBOUND angegeben wird, gilt PORT_REMAP nur für ausgehende Kommunikation. Das verwendete Format ist: Beispiel: PORT_REMAP = client/tcp/18082/443 |
PORT_REMAP_INBOUND |
O |
Ordnet die eingehende Kommunikation dem angegebenen Port erneut zu. Wenn Sie PORT_REMAP_INBOUND angeben, jedoch keinen Wert für PORT_REMAP angeben, wird die ausgehende Kommunikation für den Port nicht geändert. WICHTIG: Die Ports, die Sie für die Konfiguration von Load Balancer-Endpunkten planen, nicht neu zuordnen. Das verwendete Format ist: Beispiel: PORT_REMAP_INBOUND = grid/tcp/3022/22 |