為 Linux 部署建立 StorageGRID 節點組態檔
節點組態檔是小型文字檔案,其中包含 StorageGRID 主機服務啟動節點並將其連接到對應的網路和區塊儲存資源所需的資訊。節點組態檔用於虛擬節點,不用於應用裝置節點。
|
|
「Linux」指的是 RHEL、Ubuntu 或 Debian 部署。如需支援版本的清單,請參閱 "NetApp 互作業性矩陣工具(IMT)"。 |
節點組態檔位置
將每個 StorageGRID 節點的組態檔案放置在節點將執行之主機上的 `/etc/storagegrid/nodes`目錄中。例如、如果您計畫在 HostA 上執行一個管理節點、一個閘道節點和一個儲存節點、則必須在 HostA 上的 `/etc/storagegrid/nodes`中放置三個節點組態檔案。
${post_edited_translations.segment}
${post_edited_translations.segment}
組態檔案的名稱非常重要。格式為 node-name.conf,其中 node-name 是您指派給節點的名稱。此名稱會顯示在 StorageGRID 安裝程式中,並用於節點維護作業(例如節點移轉)。
${post_edited_translations.segment}
-
${post_edited_translations.segment}
-
${post_edited_translations.segment}
-
${post_edited_translations.segment}
-
${post_edited_translations.segment}
-
可以包含一個或多個連字符(-)
-
必須不超過 32 個字元,不包括
.conf副檔名
任何 `/etc/storagegrid/nodes`中不符合這些命名慣例的檔案,都不會由主機服務進行解析。
${post_edited_translations.segment}
site-nodetype-nodenumber.conf
例如,您可以使用 dc1-adm1.conf 作為資料中心 1 中的第一個管理節點,並使用 dc2-sn3.conf 作為資料中心 2 中的第三個儲存節點。不過,只要所有節點名稱都符合命名規則,您可以使用任何您喜歡的配置。
節點組態檔案的內容
組態檔案包含鍵值對,每行包含一個鍵和一個值。對於每個鍵值對,請遵循以下規則:
-
金鑰與值必須以等號 (
=)和選用的空格隔開。 -
${post_edited_translations.segment}
-
這些值可以包含內嵌空格。
-
${post_edited_translations.segment}
下表定義了所有受支援鍵的值。每個鍵都有以下幾種表示方式之一:
-
${post_edited_translations.segment}
-
最佳實務:可選,但建議執行
-
Optional:所有節點均可選擇
管理員網路金鑰
ADMIN_IP
| 價值 | 指定 |
|---|---|
您要用來安裝 Linux 型節點的管理節點的 Grid Network IPv4 位址。若要恢復,請在主要管理節點可用時使用其 IP;否則,請使用非主要管理節點的 IP。如果省略此參數,節點將嘗試使用 mDNS 探索主要管理節點。 注意:此值在主要管理節點上將被忽略,且可能被禁止。 |
${post_edited_translations.segment} |
${post_edited_translations.segment}
| 價值 | 指定 |
|---|---|
DHCP、STATIC 或 DISABLED |
選用 |
ADMIN_NETWORK_ESL
| 價值 | 指定 |
|---|---|
以逗號分隔的 CIDR 表示法子網路清單,此節點應使用管理網路閘道與其通訊。 範例: |
選用 |
${post_edited_translations.segment}
| 價值 | 指定 |
|---|---|
此節點的本機管理網路閘道的 IPv4 位址。必須位於由 ADMIN_NETWORK_IP 和 ADMIN_NETWORK_MASK 定義的子網路內。對於 DHCP 設定的網路,此值將被忽略。 範例:
|
若 `ADMIN_NETWORK_ESL`已指定,則為必填項。否則為選填項。 |
ADMIN_NETWORK_IP
| 價值 | 指定 |
|---|---|
此節點在管理網路上的 IPv4 位址。僅當 ADMIN_NETWORK_CONFIG = STATIC 時才需要此金鑰;對於其他值,請勿指定此金鑰。 範例:
|
當 ADMIN_NETWORK_CONFIG = STATIC 時為必填。 否則為可選。 |
ADMIN_NETWORK_MAC
| 價值 | 指定 |
|---|---|
Container 中管理網路介面的 MAC 位址。 此欄位為選填項。如果省略,系統將自動產生 MAC 位址。 必須是 6 對十六進位數字,用冒號分隔。 範例: |
選用 |
ADMIN_NETWORK_MASK
| 價值 | 指定 |
|---|---|
此節點在管理網路上的 IPv4 子網路遮罩。當 ADMIN_NETWORK_CONFIG = STATIC 時,請指定此鍵;對於其他值,請勿指定。 範例:
|
如果指定了 ADMIN_NETWORK_IP 且 ADMIN_NETWORK_CONFIG = STATIC,則此為必填項。 否則為可選。 |
ADMIN_NETWORK_MTU
| 價值 | 指定 |
|---|---|
此節點在管理網路上的最大傳輸單元 (MTU)。如果 ADMIN_NETWORK_CONFIG = DHCP,則無需指定。如果指定,則該值必須介於 1280 和 9216 之間。如果省略,則使用 1500。 如果要使用巨型幀,請將 MTU 設定為適合巨型幀的值,例如 9000。否則,請保留預設值。 重要提示:網路的 MTU 值必須與節點所連接的交換器連接埠上設定的值相符。否則,可能會出現網路效能問題或封包遺失。 範例:
|
選用 |
ADMIN_NETWORK_TARGET
| 價值 | 指定 |
|---|---|
StorageGRID 節點用於管理網路存取的主機設備名稱。僅支援網路介面名稱。通常,您使用的介面名稱應與 GRID_NETWORK_TARGET 或 CLIENT_NETWORK_TARGET 指定的介面名稱不同。 注意:請勿使用綁定或橋接裝置作為網路目標。請在綁定裝置上設定 VLAN (或其他虛擬介面),或使用橋接和虛擬乙太網路 (veth) 配對。 最佳實務:即使此節點最初沒有管理網路 IP 位址,也應指定一個值。這樣,您稍後可以新增管理網路 IP 位址,而無需在主機上重新設定該節點。 範例:
|
${post_edited_translations.segment} |
ADMIN_NETWORK_TARGET_TYPE
| 價值 | 指定 |
|---|---|
介面(這是唯一支援的值。) |
選用 |
ADMIN_NETWORK_TARGET_TYPE_INTERFACE_CLONE_MAC
| 價值 | 指定 |
|---|---|
對還是錯 將該鍵設為「true」,使 StorageGRID Container 使用管理網路上主機目標介面的 MAC 位址。 *最佳實務:*在需要混雜模式的網路中,請改用 ADMIN_NETWORK_TARGET_TYPE_INTERFACE_CLONE_MAC 金鑰。 有關 Linux 系統下 MAC 位址複製的更多詳細資訊,請參閱"MAC 位址複製的注意事項與建議" |
${post_edited_translations.segment} |
ADMIN_ROLE
| 價值 | 指定 |
|---|---|
主要或非主要 只有當 NODE_TYPE = VM_Admin_Node 時才需要此鍵;對於其他節點類型,請勿指定此鍵。 |
當 NODE_TYPE = VM_Admin_Node 時為必填項 否則為可選。 |
區塊裝置金鑰
BLOCK_DEVICE_AUDIT_LOGS
| 價值 | 指定 |
|---|---|
此節點將用於持續儲存稽核日誌的區塊裝置特殊檔案的路徑和名稱。 範例:
|
對於 NODE_TYPE = VM_Admin_Node 的節點,此項目為必填項。其他節點類型無需指定。 |
BLOCK_DEVICE_RANGEDB_nnn
| 價值 | 指定 |
|---|---|
此節點將用於持續物件儲存的區塊裝置特殊檔案的路徑和名稱。此金鑰僅對 NODE_TYPE = VM_Storage_Node 的節點是必要的;其他節點類型無需指定。 僅 BLOCK_DEVICE_RANGEDB_000 為必要項目;其餘項目為選用。為 BLOCK_DEVICE_RANGEDB_000 指定的區塊裝置容量必須至少為 4 TB;其他區塊裝置容量可以更小。 不要留空。如果指定了 BLOCK_DEVICE_RANGEDB_005,則也必須指定 BLOCK_DEVICE_RANGEDB_004。 注意:為了與現有部署相容,升級後的節點支援兩位數金鑰。 範例:
|
必要: 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 |
區塊設備表
| 價值 | 指定 |
|---|---|
此節點將用於持續儲存資料庫表的區塊裝置特殊檔案的路徑和名稱。此金鑰僅對 NODE_TYPE = VM_Admin_Node 的節點是必要的;其他節點類型無需指定。 範例:
|
必填 |
BLOCK_DEVICE_VAR_LOCAL
| 價值 | 指定 |
|---|---|
此節點將用於其 `/var/local`持續儲存的區塊裝置特殊檔案的路徑和名稱。 範例:
|
必填 |
用戶端網路金鑰
CLIENT_NETWORK_CONFIG
| 價值 | 指定 |
|---|---|
DHCP、STATIC 或 DISABLED |
選用 |
CLIENT_NETWORK_GATEWAY
價值 |
指定 |
此節點的本機用戶端網路閘道的 IPv4 位址,該閘道必須位於由 CLIENT_NETWORK_IP 和 CLIENT_NETWORK_MASK 定義的子網路中。對於 DHCP 設定的網路,此值將被忽略。 範例:
|
選用 |
CLIENT_NETWORK_IP
| 價值 | 指定 |
|---|---|
用戶端網路上此節點的 IPv4 位址。 只有當 CLIENT_NETWORK_CONFIG = STATIC 時才需要此鍵;對於其他值,請勿指定此鍵。 範例:
|
當 CLIENT_NETWORK_CONFIG = STATIC 時為必填 否則為可選。 |
CLIENT_NETWORK_MAC
| 價值 | 指定 |
|---|---|
Container 中用戶端網路介面的 MAC 位址。 此欄位為選填項。如果省略,系統將自動產生 MAC 位址。 必須是 6 對十六進位數字,用冒號分隔。 範例: |
選用 |
CLIENT_NETWORK_MASK
| 價值 | 指定 |
|---|---|
用戶端網路上此節點的 IPv4 子網路遮罩。 當 CLIENT_NETWORK_CONFIG = STATIC 時,請指定此鍵;對於其他值,請勿指定。 範例:
|
如果指定了 CLIENT_NETWORK_IP 且 CLIENT_NETWORK_CONFIG = STATIC,則此項目為必填項。 否則為可選。 |
CLIENT_NETWORK_MTU
| 價值 | 指定 |
|---|---|
此節點在用戶端網路上的最大傳輸單元 (MTU)。如果 CLIENT_NETWORK_CONFIG = DHCP,則無需指定。如果指定,則該值必須介於 1280 和 9216 之間。如果省略,則使用 1500。 如果要使用巨型幀,請將 MTU 設定為適合巨型幀的值,例如 9000。否則,請保留預設值。 重要提示:網路的 MTU 值必須與節點所連接的交換器連接埠上設定的值相符。否則,可能會出現網路效能問題或封包遺失。 範例:
|
選用 |
CLIENT_NETWORK_TARGET
| 價值 | 指定 |
|---|---|
StorageGRID 節點用於用戶端網路存取的主機設備名稱。僅支援網路介面名稱。通常,您使用的介面名稱應與 GRID_NETWORK_TARGET 或 ADMIN_NETWORK_TARGET 指定的介面名稱不同。 注意:請勿使用綁定或橋接裝置作為網路目標。請在綁定裝置上設定 VLAN (或其他虛擬介面),或使用橋接和虛擬乙太網路 (veth) 配對。 *最佳實務:*即使此節點最初沒有用戶端網路 IP 位址,也應指定一個值。這樣,您稍後可以新增用戶端網路 IP 位址,而無需在主機上重新設定該節點。 範例:
|
${post_edited_translations.segment} |
CLIENT_NETWORK_TARGET_TYPE
| 價值 | 指定 |
|---|---|
介面(這是唯一支援的值。) |
選用 |
CLIENT_NETWORK_TARGET_TYPE_INTERFACE_CLONE_MAC
| 價值 | 指定 |
|---|---|
對還是錯 將該鍵設為「true」,使 StorageGRID Container 使用用戶端網路上主機目標介面的 MAC 位址。 *最佳實務:*在需要混雜模式的網路中,請改用 CLIENT_NETWORK_TARGET_TYPE_INTERFACE_CLONE_MAC 金鑰。 有關 Linux 系統下 MAC 位址複製的更多詳細資訊,請參閱"MAC 位址複製的注意事項與建議" |
${post_edited_translations.segment} |
網格網路金鑰
GRID_NETWORK_CONFIG
| 價值 | 指定 |
|---|---|
靜態或 DHCP 如果未指定,則預設為 STATIC。 |
${post_edited_translations.segment} |
GRID_NETWORK_GATEWAY
| 價值 | 指定 |
|---|---|
此節點的本機 Grid Network 閘道的 IPv4 位址,該位址必須位於由 GRID_NETWORK_IP 和 GRID_NETWORK_MASK 定義的子網路中。對於設定了 DHCP 的網路,此值將被忽略。 如果 Grid Network 是沒有閘道的單一子網路,則可以使用子網路的標準閘道位址 (X.Y.Z.1) 或此節點的 GRID_NETWORK_IP 值;這兩個值都將簡化未來 Grid Network 潛在的擴充。 |
必填 |
GRID_NETWORK_IP
| 價值 | 指定 |
|---|---|
此節點在網格網路上的 IPv4 位址。僅當 GRID_NETWORK_CONFIG = STATIC 時才需要此金鑰;對於其他值,請勿指定此金鑰。 範例:
|
當 GRID_NETWORK_CONFIG = STATIC 時為必填項 否則為可選。 |
GRID_NETWORK_MAC
| 價值 | 指定 |
|---|---|
Container 中網格網路介面的 MAC 位址。 必須是 6 對十六進位數字,用冒號分隔。 範例: |
選用 如果省略,則會自動產生 MAC 位址。 |
GRID_NETWORK_MASK
| 價值 | 指定 |
|---|---|
此節點在網格網路上的 IPv4 子網路遮罩。當 GRID_NETWORK_CONFIG = STATIC 時,請指定此鍵;對於其他值,請勿指定。 範例:
|
${post_edited_translations.segment} 否則為可選。 |
${post_edited_translations.segment}
| 價值 | 指定 |
|---|---|
此節點在網格網路上的最大傳輸單元 (MTU)。如果 GRID_NETWORK_CONFIG = DHCP,則無需指定。如果指定,則該值必須介於 1280 和 9216 之間。如果省略,則使用 1500。 如果要使用巨型幀,請將 MTU 設定為適合巨型幀的值,例如 9000。否則,請保留預設值。 重要提示:網路的 MTU 值必須與節點所連接的交換器連接埠上設定的值相符。否則,可能會出現網路效能問題或封包遺失。 重要提示:為獲得最佳網路效能,所有節點的網格網路介面應設定相似的 MTU 值。如果各節點的網格網路 MTU 設定有顯著差異,則會觸發 Grid Network MTU mismatch 警示。並非所有網路類型的 MTU 值都必須相同。 範例:
|
選用 |
${post_edited_translations.segment}
| 價值 | 指定 |
|---|---|
您將用於 StorageGRID 節點進行網格網路存取的主機裝置名稱。僅支援網路介面名稱。通常,您會使用與為 ADMIN_NETWORK_TARGET 或 CLIENT_NETWORK_TARGET 指定的名稱不同的介面名稱。 注意:請勿使用綁定或橋接裝置作為網路目標。請在綁定裝置上設定 VLAN (或其他虛擬介面),或使用橋接和虛擬乙太網路 (veth) 配對。 範例:
|
必填 |
${post_edited_translations.segment}
| 價值 | 指定 |
|---|---|
介面(這是唯一支援的值。) |
選用 |
${post_edited_translations.segment}
| 價值 | 指定 |
|---|---|
對還是錯 將該鍵的值設為「true」,使 StorageGRID Container 使用 Grid Network 上主機目標介面的 MAC 位址。 *最佳實務:*在需要混雜模式的網路中,請改用 GRID_NETWORK_TARGET_TYPE_INTERFACE_CLONE_MAC 金鑰。 有關 Linux 系統下 MAC 位址複製的更多詳細資訊,請參閱"MAC 位址複製的注意事項與建議" |
${post_edited_translations.segment} |
${post_edited_translations.segment}
${post_edited_translations.segment}
| 價值 | 指定 |
|---|---|
${post_edited_translations.segment} 注意:僅在主要管理節點上設定安裝密碼。如果嘗試在其他類型的節點上設定密碼,節點組態檔案驗證將會失敗。 ${post_edited_translations.segment} 如果省略此鍵,則預設不會設定臨時密碼。或者,您可以使用 StorageGRID 安裝 API 設定臨時密碼。 必須是格式為 可以使用 CLI 工具產生此雜湊值,例如在 SHA-512 模式下的 `openssl passwd`命令。 |
${post_edited_translations.segment} |
${post_edited_translations.segment}
INTERFACE_TARGET_nnnn
| 價值 | 指定 |
|---|---|
您要新增至此節點的額外介面名稱及選用執行摘要。每個節點可以新增多個額外介面。 對於 nnnn,請為要新增的每個 INTERFACE_TARGET 條目指定一個唯一的數字。 對於該值,請指定裸機主機上實體介面的名稱。然後,您可以選擇新增逗號並提供介面執行摘要,該執行摘要將顯示在 VLAN 介面頁面和 HA 群組頁面上。 範例: 如果您新增 Trunk 介面,則必須在 StorageGRID 中設定 VLAN 介面。如果您新增存取介面,可以直接將該介面新增至 HA 群組,而不需要設定 VLAN 介面。 |
選用 |
最大 RAM 金鑰
${post_edited_translations.segment}
| 價值 | 指定 |
|---|---|
此節點允許使用的最大 RAM 容量。如果省略此鍵,則該節點沒有記憶體容量限制。為生產級節點設定此欄位時,請指定一個至少為 24 GB 且比系統總 RAM 少 16 到 32 GB 的值。 注意:RAM 值會影響節點的實際中繼資料保留空間。請參閱"中繼資料保留空間的執行摘要"。 此欄位的格式為 範例:
${post_edited_translations.segment} |
選用 |
${post_edited_translations.segment}
${post_edited_translations.segment}
| 價值 | 指定 |
|---|---|
${post_edited_translations.segment}
|
必填 |
${post_edited_translations.segment}
| 價值 | 指定 |
|---|---|
定義儲存節點所包含的物件類型。如需詳細資訊,請參閱 "${post_edited_translations.segment}"。只有當節點的 NODE_TYPE = VM_Storage_Node 時,才需要此鍵值;請勿針對其他節點類型指定此鍵值。儲存類型:
注意:如果未指定 STORAGE_TYPE,則儲存節點類型預設為組合(資料和中繼資料)。 |
選用 |
${post_edited_translations.segment}
|
|
已取代對連接埠重新對應的支援,且將在未來的版本中移除。若要移除重新對應的連接埠,請參閱 "移除裸機主機上的連接埠重映射"。 |
PORT_REMAP
| 價值 | 指定 |
|---|---|
重新映射節點用於內部網格節點通訊或外部通訊的任何連接埠。如果企業連網政策限制了 StorageGRID 使用的一個或多個連接埠(如 "${post_edited_translations.segment}" 或 "${post_edited_translations.segment}" 所述),則必須重新映射連接埠。 重要提示:請勿重新對應您規劃用於設定負載平衡器端點的連接埠。 附註:如果僅設定 PORT_REMAP,則您指定的對應會同時用於傳入和傳出通訊。如果同時指定了 PORT_REMAP_INBOUND,則 PORT_REMAP 僅適用於傳出通訊。 使用的格式為: 範例: ${post_edited_translations.segment} 範例: |
選用 |
PORT_REMAP_INBOUND
| 價值 | 指定 |
|---|---|
將傳入通訊重新對應至指定的連接埠。如果您指定 PORT_REMAP_INBOUND 但未指定 PORT_REMAP 的值,則該連接埠的傳出通訊將保持不變。 重要提示:請勿重新對應您規劃用於設定負載平衡器端點的連接埠。 使用的格式為: 範例: ${post_edited_translations.segment} 範例: |
選用 |