為Ubuntu或Debian部署建立節點組態檔案
節點組態檔案是小型的文字檔、可提供StorageGRID 支援此支援所需的資訊、以啟動節點並將其連線至適當的網路和區塊儲存資源。節點組態檔案用於虛擬節點、不用於應用裝置節點。
我該將節點組態檔案放在何處?
您必須在中放置每StorageGRID 個支援節點的組態檔 /etc/storagegrid/nodes
節點執行所在主機上的目錄。例如、如果您打算在主機A上執行一個管理節點、一個閘道節點和一個儲存節點、則必須在其中放置三個節點組態檔案 /etc/storagegrid/nodes
在主機A上。您可以使用文字編輯器(例如vim或nANO)直接在每個主機上建立組態檔、也可以在其他位置建立組態檔、然後將其移至每個主機。
我該如何命名節點組態檔?
組態檔的名稱很重要。格式為 node-name.conf
、其中 node-name
是您指派給節點的名稱。此名稱會顯示在StorageGRID 《Iserfor Installer(英文):用於節點維護作業(例如節點移轉)。
節點名稱必須遵循下列規則:
-
必須是唯一的
-
必須以字母開頭
-
可以包含A到Z和a到z的字元
-
可包含0到9的數字
-
可包含一或多個連字號(-)
-
不得超過32個字元、不包括
.conf
擴充
中的任何檔案 /etc/storagegrid/nodes
不遵循這些命名慣例的情況、將不會由主機服務進行剖析。
如果您的網格規劃了多站台拓撲、則一般的節點命名方案可能是:
site-nodetype-nodenumber.conf
例如、您可以使用 dc1-adm1.conf
適用於資料中心1中的第一個管理節點、以及 dc2-sn3.conf
適用於資料中心2的第三個儲存節點。不過、只要所有節點名稱都遵循命名規則、您就可以使用任何想要的配置。
節點組態檔案中有什麼內容?
組態檔包含金鑰/值配對、每行一個金鑰和一個值。對於每個金鑰/值配對、您必須遵循下列規則:
-
金鑰和值必須以等號分隔 (
=
)和選用空白。 -
金鑰不得包含空格。
-
這些值可以包含內嵌空格。
-
任何前置或後置空白都會被忽略。
每個節點都需要某些金鑰、而其他金鑰則是選用的、或只有特定節點類型才需要。
下表定義所有支援金鑰的可接受值。在中間欄:
-
R*:必要+ Bp:最佳實務+ O:選用
金鑰 | R、Bp或O? | 價值 |
---|---|---|
管理IP |
血壓 |
此節點所屬網格之主要管理節點的網格網路IPv6位址。使用您為GRID_NETWORD_IP所指定的相同值、表示網格節點的node_type = VM_admin_Node和admin_role = Primary。如果省略此參數、節點會嘗試使用mDNS探索主要管理節點。 附註:此值會在主要管理節點上被忽略、而且可能被禁止。 |
admin_network_config |
O |
DHCP、靜態或停用 |
admin_network_esl |
O |
以逗號分隔的子網路清單、以 CIDR 表示法表示此節點應使用管理網路閘道進行通訊。 範例: |
管理網路閘道 |
o(* R*) |
此節點的本機管理網路閘道的IPv4位址。必須位於由admin_network_ip和admin_network_mask定義的子網路上。DHCP設定的網路會忽略此值。 附註:如果指定了admin_network_esl、則需要此參數。 範例:
|
admin_network_ip |
O |
管理網路上此節點的IPV4位址。只有當 Admin_network_config = 靜態時才需要此金鑰;請勿將其指定為其他值。 範例:
|
admin_network_MAC |
O |
容器中管理網路介面的MAC位址。 此欄位為選用欄位。如果省略、會自動產生MAC位址。 必須為6對以分號分隔的十六進位數字。 範例: |
admin_network_mask |
O |
管理網路上此節點的IPv4網路遮罩。只有當 Admin_network_config = 靜態時才需要此金鑰;請勿將其指定為其他值。 範例:
|
admin_network_MTU |
O |
管理網路上此節點的最大傳輸單元(MTU)。如果 Admin_network_config = DHCP 、請勿指定。如果指定、則值必須介於1280和9216之間。如果省略、則使用1500。 如果您要使用巨型框架、請將MTU設為適合巨型框架的值、例如9000。否則、請保留預設值。 重要:網路的MTU值必須符合節點所連接之交換器連接埠上所設定的值。否則、可能會發生網路效能問題或封包遺失。 範例:
|
管理網路目標 |
血壓 |
將用於StorageGRID 由節點存取管理網路的主機裝置名稱。僅支援網路介面名稱。一般而言、您使用的介面名稱不同於GRID_NETWORD_Target或用戶端網路目標所指定的介面名稱。
最佳實務做法:即使此節點最初沒有管理網路IP位址、仍請指定值。然後、您可以在稍後新增管理網路IP位址、而不需重新設定主機上的節點。 範例:
|
管理網路目標類型 |
O |
介面 (這是唯一支援的值。) |
管理網路目標類型介面複製_MAC |
血壓 |
是非題 將金鑰設為「true」、以使用StorageGRID 管理網路上主機目標介面的MAC位址來使該容器失效。 *最佳實務做法:*在需要混雜模式的網路中、請改用admin_network_target類型_interface_clone _MAC金鑰。 如需更多有關MAC複製的詳細資訊: |
admin_role |
|
主要或非主要 只有當 node_type = vm_admin_Node 時、才需要此金鑰;請勿針對其他節點類型指定此金鑰。 |
block_device_napping_logs |
|
此節點將用於持續儲存稽核記錄的區塊裝置特殊檔案路徑和名稱。只有節點類型 = VM_Admin_Node 的節點才需要此金鑰;請勿針對其他節點類型指定此金鑰。 範例:
|
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 |
|
此節點將用於持續物件儲存的區塊裝置特殊檔案路徑和名稱。只有節點類型 = VM_Storage_Node 的節點才需要此金鑰;請勿針對其他節點類型指定此金鑰。 只需要block_device_rNGedb_000;其餘的則為選用項目。為block_device_RANGEDB_000指定的區塊裝置必須至少為4 TB、其他的則可能較小。 不要留下落差。如果您指定block_device_RANGEDB_005、您也必須指定block_device_RANGEDB_004。 附註:為了與現有部署相容、升級的節點支援兩位數金鑰。 範例:
|
block_device_Tables |
|
此節點將用於持續儲存資料庫表格的區塊裝置特殊檔案路徑和名稱。只有節點類型 = VM_Admin_Node 的節點才需要此金鑰;請勿針對其他節點類型指定此金鑰。 範例:
|
block_device_var_local |
|
此節點將用於其/var/local持續儲存設備的區塊裝置特殊檔案路徑和名稱。 範例:
|
用戶端網路組態 |
O |
DHCP、靜態或停用 |
用戶端網路閘道 |
O |
此節點的本機用戶端網路閘道的IPv4位址、必須位於用戶端網路IP和用戶端網路遮罩所定義的子網路上。DHCP設定的網路會忽略此值。 範例:
|
用戶端網路IP |
O |
用戶端網路上此節點的IPv4位址。只有當 client_network_config = static 時才需要此金鑰;請勿將其指定為其他值。 範例:
|
用戶端網路_MAC |
O |
容器中用戶端網路介面的MAC位址。 此欄位為選用欄位。如果省略、會自動產生MAC位址。 必須為6對以分號分隔的十六進位數字。 範例: |
用戶端網路遮罩 |
O |
用戶端網路上此節點的IPV4網路遮罩。只有當 client_network_config = static 時才需要此金鑰;請勿將其指定為其他值。 範例:
|
用戶端網路MTU |
O |
用戶端網路上此節點的最大傳輸單位(MTU)。不要指定 client_network_config = DHCP 。如果指定、則值必須介於1280和9216之間。如果省略、則使用1500。 如果您要使用巨型框架、請將MTU設為適合巨型框架的值、例如9000。否則、請保留預設值。 重要:網路的MTU值必須符合節點所連接之交換器連接埠上所設定的值。否則、可能會發生網路效能問題或封包遺失。 範例:
|
用戶端網路目標 |
血壓 |
供客戶端網路存取使用StorageGRID 的主機裝置名稱、由支援節點存取。僅支援網路介面名稱。一般而言、您使用的介面名稱不同於GRID_NETWORD_Target或admin_network_target所指定的介面名稱。
*最佳實務做法:*指定值、即使此節點一開始不會有用戶端網路IP位址。之後您可以新增用戶端網路IP位址、而不需重新設定主機上的節點。 範例:
|
用戶端網路目標類型 |
O |
介面 (僅支援此值。) |
用戶端網路目標類型介面複製_MAC |
血壓 |
是非題 將金鑰設為「true」、使StorageGRID 「支援」容器使用用戶端網路上主機目標介面的MAC位址。 *最佳實務做法:*在需要混雜模式的網路中、請改用用戶端網路連線目標類型介面介面複製_MAC金鑰。 如需更多有關MAC複製的詳細資訊: |
GRID_NET_CONFIG |
血壓 |
靜態或DHCP (如果未指定、則預設為靜態。) |
GRID_NET_gateway |
|
此節點的本機網格網路閘道的IPv4位址、必須位於GRID_NETNET_IP和GRID_NET_MASK定義的子網路上。DHCP設定的網路會忽略此值。 如果Grid Network是沒有閘道的單一子網路、請使用子網路的標準閘道位址(X YY.1)或此節點的GRID_NETNET_IP值;這兩個值都能簡化未來可能的Grid Network擴充。 |
GRID_NET_IP |
|
Grid Network上此節點的IPv4位址。只有當 GRIN_NETWORD_CONFIG = STATIC 時才需要此機碼;不要為其他值指定此機碼。 範例:
|
GRID_NET_MAC |
O |
容器中Grid Network介面的MAC位址。 此欄位為選用欄位。如果省略、會自動產生MAC位址。 必須為6對以分號分隔的十六進位數字。 範例: |
GRID_NET_MA遮 罩 |
O |
Grid Network上此節點的IPV4網路遮罩。只有當 GRIN_NETWORD_CONFIG = STATIC 時才需要此機碼;不要為其他值指定此機碼。 範例:
|
GRID_NET_MTU |
O |
Grid Network上此節點的最大傳輸單位(MTU)。不要指定 grid_network_config = DHCP 。如果指定、則值必須介於1280和9216之間。如果省略、則使用1500。 如果您要使用巨型框架、請將MTU設為適合巨型框架的值、例如9000。否則、請保留預設值。 重要:網路的MTU值必須符合節點所連接之交換器連接埠上所設定的值。否則、可能會發生網路效能問題或封包遺失。 重要:為獲得最佳網路效能、所有節點都應在其Grid Network介面上設定類似的MTU值。如果個別節點上Grid Network的MTU設定有顯著差異、則會觸發* Grid Network MTU mismis*警示。所有網路類型的 MTU 值都不一定相同。 範例: 1500 8192 |
GRID_NETWORD_target |
|
您將用於StorageGRID 由節點存取Grid Network的主機裝置名稱。僅支援網路介面名稱。一般而言、您使用的介面名稱與針對admin_network_target或client_network_target所指定的介面名稱不同。
範例:
|
GRID_NETWORD_TAR_type |
O |
介面 (這是唯一支援的值。) |
GRID_NETWORD_PROM_type_interface_clone _MAC |
|
是非題 將金鑰的值設為「true」、使StorageGRID 該容器使用Grid Network上主機目標介面的MAC位址。 *最佳實務做法:*在需要混雜模式的網路中、請改用GRID_NETNETWORD_TAR_AT_type_interface_clone _MAC金鑰。 如需更多有關MAC複製的詳細資訊: |
interface_target_nnnn |
O |
要新增至此節點的額外介面名稱和選用說明。您可以為每個節點新增多個額外介面。 對於 nnn 、請為您要新增的每個 interface_target 項目指定唯一的編號。 針對該值、指定裸機主機上實體介面的名稱。接著、您可以選擇性地新增一個逗號、並提供介面說明、該介面會顯示在「VLAN介面」頁面和「HA群組」頁面上。 例如: 如果您新增主幹介面、則必須在StorageGRID 功能鏈路的資訊鏈路中設定VLAN介面。如果您新增存取介面、可以直接將介面新增至 HA 群組、而不需要設定 VLAN 介面。 |
最大RAM |
O |
允許此節點使用的最大RAM量。如果省略此金鑰、則節點沒有記憶體限制。為正式作業層級節點設定此欄位時、請指定至少24 GB、且16至32 GB的值、小於系統總RAM。 附註:RAM值會影響節點的實際中繼資料保留空間。請參閱 "中繼資料保留空間的說明"。 此欄位的格式為 範例:
附註:如果您要使用此選項、則必須啟用記憶體cGroups的核心支援。 |
節點類型 |
|
節點類型: VM_admin_Node VM_Storage_Node VM_Archive_Node VM_API_Gateway |
連接埠重新對應 |
O |
重新對應節點用於內部網格節點通訊或外部通訊的任何連接埠。如果企業網路原則限制 StorageGRID 使用的一或多個連接埠、則必須重新對應連接埠、如所述 "內部網格節點通訊" 或 "外部通訊"。
附註:如果只設定port_remap、則指定的對應會同時用於傳入和傳出通訊。如果也指定port_remap_inbound、則port_remap僅適用於傳出通訊。 使用的格式為: 例如:
|
連接埠_remap_inbound |
O |
將傳入通訊重新對應至指定的連接埠。如果您指定 port_remap_inbound 、但未指定 port_remap 值、則連接埠的輸出通訊將維持不變。
使用的格式為: 例如:
|