Los geht's
Erstellen Sie Knoten-Konfigurationsdateien für Ubuntu oder Debian-Bereitstellungen
Änderungen vorschlagen
PDFs
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
.confErweiterung
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. 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: |
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: |
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, selbst 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: |
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_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 |
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_000 erforderlich; der Rest ist optional. Das für BLOCK_DEVICE_RANGEDB_000 angegebene Blockgerät muss mindestens 4 TB betragen; die anderen können kleiner sein. Lassen Sie keine Lücken. Wenn Sie BLOCK_DEVICE_RANGEDB_005 angeben, müssen Sie auch BLOCK_DEVICE_RANGEDB_004 angeben. Hinweis: Zur Kompatibilität mit bestehenden Bereitstellungen werden zweistellige Schlüssel für aktualisierte Knoten unterstützt. 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: |
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: |
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: |
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: 1500 8192 |
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: |
INTERFACES_TARGET_nnnnn |
O |
Name und optionale Beschreibung für eine zusätzliche Schnittstelle, die Sie diesem Node hinzufügen möchten. Jeder Node kann mehrere zusätzliche Schnittstellen hinzugefügt werden. Geben Sie bei nnnnn eine eindeutige Nummer für jeden EINTRAG INTERFACES_TARGET an an, den Sie hinzufügen. Geben Sie für den Wert den Namen der physischen Schnittstelle auf dem Bare-Metal-Host an. Fügen Sie dann optional ein Komma hinzu und geben Sie eine Beschreibung der Schnittstelle an, die auf der Seite VLAN-Schnittstellen und der Seite HA-Gruppen angezeigt wird. Beispiel: Wenn Sie eine Trunk-Schnittstelle hinzufügen, müssen Sie eine VLAN-Schnittstelle in StorageGRID konfigurieren. Wenn Sie eine Zugriffsoberfläche hinzufügen, können Sie die Schnittstelle direkt einer HA-Gruppe hinzufügen. Sie müssen keine VLAN-Schnittstelle konfigurieren. |
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. Siehe Anweisungen für die Administration von StorageGRID Für eine Beschreibung dessen, was Metadaten reserviert Platz ist. Das Format für dieses Feld lautet Beispiele:
Hinweis: Wenn Sie diese Option verwenden möchten, müssen Sie Kernel-Unterstützung für Speicher-cgroups aktivieren. |
NODE_TYPE |
R |
Node-Typ: VM_Admin_Node VM_Storage_Node VM_Archive_Node VM_API_Gateway |
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_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:
|