Linux デプロイメント用の StorageGRID ノード構成ファイルを作成する
ノード設定ファイルは、StorageGRID ホストサービスがノードを起動し、適切なネットワークおよびブロックストレージリソースに接続するために必要な情報を提供する小さなテキストファイルです。ノード設定ファイルは仮想ノードに使用され、アプライアンスノードには使用されません。
|
|
「Linux」とは、RHEL、Ubuntu、またはDebianのいずれかの環境を指します。サポートされているバージョンの一覧については、 "NetApp Interoperability Matrix Tool(IMT)"を参照してください。 |
ノード設定ファイルの場所
各StorageGRIDノードの設定ファイルを、ノードが実行されるホスト上の `/etc/storagegrid/nodes`ディレクトリに配置します。たとえば、HostA 上で 1 つの管理ノード、1 つのゲートウェイノード、および 1 つのストレージノードを実行する予定の場合は、HostA の `/etc/storagegrid/nodes`に 3 つのノード設定ファイルを配置する必要があります。
設定ファイルは、vimやnanoなどのテキストエディタを使用して各ホスト上で直接作成することも、別の場所で作成してから各ホストに移動することもできます。
ノード設定ファイルの命名規則
設定ファイルの名前は重要です。フォーマットは node-name.conf、ここで `node-name`はノードに割り当てる名前です。この名前は StorageGRID インストーラーに表示され、ノード移行などのノードメンテナンス操作に使用されます。
ノード名は以下の規則に従う必要があります:
-
一意である必要があります。
-
文字で始めなければなりません
-
AからZ、およびaからzの文字を含めることができます。
-
0から9までの数字を含めることができます
-
ハイフン(-)を1つ以上含めることができます
-
文字数は32文字以内である必要があります( `.conf`拡張子は含まない)
`/etc/storagegrid/nodes`内のファイルのうち、これらの命名規則に従わないファイルは、ホストサービスによって解析されません。
グリッドに複数サイトのトポロジーを計画している場合、一般的なノード命名規則は次のようになります:
site-nodetype-nodenumber.conf
例えば、データセンター1の最初の管理ノードには `dc1-adm1.conf`を使用し、データセンター2の3番目のストレージノードには `dc2-sn3.conf`を使用することができます。ただし、すべてのノード名が命名規則に従っている限り、どのような命名規則を使用しても構いません。
ノード設定ファイルの内容
設定ファイルにはキーと値のペアが含まれており、1行に1つのキーと1つの値が記述されています。各キー/値ペアについて、以下のルールに従ってください:
-
キーと値は等号((
=)とオプションの空白文字で区切る必要があります。 -
キーにはスペースを含めることはできません。
-
値には空白が含まれる場合があります。
-
先頭または末尾の空白文字はすべて無視されます。
以下の表は、サポートされているすべてのキーの値を定義しています。各キーには、以下のいずれかの指定があります。
-
必須:すべてのノード、または指定されたノードタイプに必須です。
-
ベストプラクティス:必須ではありませんが、推奨します
-
オプション:すべてのノードでオプションです。
管理者ネットワークキー
ADMIN_IP
| Value | 指定 |
|---|---|
Linuxベースのノードをインストールするために使用する管理ノードのグリッドネットワーク IPv4 アドレス。復旧時には、プライマリ管理ノードの IP アドレスが利用可能な場合はそれを使用し、利用できない場合はプライマリ以外の管理ノードの IP アドレスを使用してください。このパラメータを省略した場合、ノードは mDNS を使用してプライマリ管理ノードを検出しようとします。 注:この値はプライマリ管理ノードでは無視され、禁止されている場合があります。 |
ベストプラクティス |
ADMIN_NETWORK_CONFIG
| Value | 指定 |
|---|---|
DHCP、STATIC、または DISABLED |
オプション |
ADMIN_NETWORK_ESL
| Value | 指定 |
|---|---|
このノードが管理ネットワークゲートウェイを使用して通信するサブネットを、CIDR表記でカンマ区切りで指定します。 例: |
オプション |
ADMIN_NETWORK_GATEWAY
| Value | 指定 |
|---|---|
このノードのローカル管理ネットワークゲートウェイのIPv4アドレス。ADMIN_NETWORK_IPとADMIN_NETWORK_MASKで定義されたサブネット上に存在する必要があります。この値は、DHCPで設定されたネットワークでは無視されます。 例:
|
`ADMIN_NETWORK_ESL`が指定されている場合は必須です。それ以外は任意です。 |
ADMIN_NETWORK_IP
| Value | 指定 |
|---|---|
管理ネットワーク上のこのノードのIPv4アドレス。このキーは、ADMIN_NETWORK_CONFIG = STATIC の場合にのみ必要です。その他の値の場合は指定しないでください。 例:
|
ADMIN_NETWORK_CONFIG = STATIC の場合に必須です。 それ以外は任意。 |
ADMIN_NETWORK_MAC
| Value | 指定 |
|---|---|
コンテナ内の管理ネットワークインターフェースの MAC アドレス。 この項目は任意です。省略した場合、MACアドレスは自動的に生成されます。 コロンで区切られた6組の16進数である必要があります。 例: |
オプション |
ADMIN_NETWORK_MASK
| Value | 指定 |
|---|---|
管理ネットワーク上のこのノードの IPv4 ネットマスク。ADMIN_NETWORK_CONFIG = STATIC の場合にこのキーを指定してください。その他の値の場合は指定しないでください。 例:
|
ADMIN_NETWORK_IPが指定されており、かつADMIN_NETWORK_CONFIG = STATICの場合に必須です。 それ以外は任意。 |
ADMIN_NETWORK_MTU
| Value | 指定 |
|---|---|
管理ネットワーク上のこのノードの最大伝送単位(MTU)。ADMIN_NETWORK_CONFIG = DHCP の場合は指定しないでください。指定する場合、値は 1280 から 9216 の間である必要があります。省略した場合、1500 が使用されます。 ジャンボフレームを使用する場合は、MTU をジャンボフレームに適した値(9000 など)に設定してください。それ以外の場合は、デフォルト値を維持してください。 重要:ネットワークの MTU 値は、ノードが接続されているスイッチ ポートに設定された値と一致する必要があります。一致していない場合、ネットワークのパフォーマンス低下やパケットロスが発生する可能性があります。 例:
|
オプション |
ADMIN_NETWORK_TARGET
| Value | 指定 |
|---|---|
StorageGRID ノードが管理ネットワークアクセスに使用するホストデバイスの名前。ネットワークインターフェイス名のみがサポートされています。通常、GRID_NETWORK_TARGET または CLIENT_NETWORK_TARGET で指定されたものとは異なるインターフェイス名を使用します。 注: ネットワークのターゲットとしてボンドデバイスやブリッジデバイスを使用しないでください。ボンドデバイスの上に VLAN (またはその他の仮想インターフェイス)を設定するか、ブリッジと仮想イーサネット (veth) のペアを使用します。 ベストプラクティス:このノードに初期状態では管理ネットワークのIPアドレスが割り当てられない場合でも、値を指定してください。そうすれば、ホスト上のノードを再設定することなく、後から管理ネットワークのIPアドレスを追加できます。 例:
|
ベストプラクティス |
ADMIN_NETWORK_TARGET_TYPE
| Value | 指定 |
|---|---|
インターフェース(サポートされている値はこれだけです。) |
オプション |
ADMIN_NETWORK_TARGET_TYPE_INTERFACE_CLONE_MAC
| Value | 指定 |
|---|---|
真か偽か キーを「true」に設定すると、StorageGRID コンテナは管理ネットワーク上のホストのターゲットインターフェイスの MAC アドレスを使用します。 ベストプラクティス: プロミスキャスモードが必要なネットワークでは、代わりに ADMIN_NETWORK_TARGET_TYPE_INTERFACE_CLONE_MAC キーを使用してください。 Linux 用 MAC クローン作成の詳細については、"MACアドレスのクローン作成に関する考慮事項と推奨事項"を参照してください。 |
ベストプラクティス |
ADMIN_ROLE
| Value | 指定 |
|---|---|
主要または非主要 このキーは、NODE_TYPE = VM_Admin_Node の場合にのみ必要です。他のノードタイプでは指定しないでください。 |
NODE_TYPE = VM_Admin_Node の場合に必須 それ以外は任意。 |
ブロックデバイスキー
BLOCK_DEVICE_AUDIT_LOGS
| Value | 指定 |
|---|---|
このノードが監査ログを永続的に保存するために使用するブロックデバイス特殊ファイルのパスと名前。 例:
|
NODE_TYPE = VM_Admin_Node のノードに必要です。他のノードタイプには指定しないでください。 |
BLOCK_DEVICE_RANGEDB_nnn
| Value | 指定 |
|---|---|
このノードが永続的なオブジェクトストレージに使用するブロックデバイス特殊ファイルのパスと名前。このキーは、NODE_TYPE = VM_Storage_Node のノードでのみ必要です。他のノードタイプでは指定しないでください。 BLOCK_DEVICE_RANGEDB_000のみが必須項目であり、その他はオプションです。BLOCK_DEVICE_RANGEDB_000 に指定するブロックデバイスは、少なくとも 4 TB である必要があります。その他のブロックデバイスは、それより小さくても構いません。 隙間を空けないでください。BLOCK_DEVICE_RANGEDB_005を指定する場合は、BLOCK_DEVICE_RANGEDB_004も指定する必要があります。 注:既存のデプロイメントとの互換性を確保するため、アップグレードされたノードでは2桁のキーがサポートされます。 例:
|
必須: 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 |
BLOCK_DEVICE_TABLES
| Value | 指定 |
|---|---|
このノードがデータベーステーブルの永続的な保存に使用するブロックデバイス特殊ファイルのパスと名前。このキーは、NODE_TYPE = VM_Admin_Node のノードでのみ必要です。他のノードタイプでは指定しないでください。 例:
|
必須 |
BLOCK_DEVICE_VAR_LOCAL
| Value | 指定 |
|---|---|
このノードが永続ストレージに使用するブロックデバイス特殊ファイルのパスと名前。 例:
|
必須 |
クライアントネットワークキー
CLIENT_NETWORK_CONFIG
| Value | 指定 |
|---|---|
DHCP、STATIC、または DISABLED |
オプション |
CLIENT_NETWORK_GATEWAY
Value |
指定 |
このノードのローカルクライアントネットワークゲートウェイのIPv4アドレス。このアドレスは、CLIENT_NETWORK_IPおよびCLIENT_NETWORK_MASKで定義されたサブネット上に存在する必要があります。この値は、DHCPで設定されたネットワークでは無視されます。 例:
|
オプション |
CLIENT_NETWORK_IP
| Value | 指定 |
|---|---|
クライアントネットワーク上のこのノードのIPv4アドレス。 このキーは、CLIENT_NETWORK_CONFIG = STATIC の場合にのみ必要です。その他の値の場合は指定しないでください。 例:
|
CLIENT_NETWORK_CONFIG = STATIC の場合に必須 それ以外は任意。 |
CLIENT_NETWORK_MAC
| Value | 指定 |
|---|---|
コンテナ内のクライアントネットワークインターフェイスの MAC アドレス。 この項目は任意です。省略した場合、MACアドレスは自動的に生成されます。 コロンで区切られた6組の16進数である必要があります。 例: |
オプション |
CLIENT_NETWORK_MASK
| Value | 指定 |
|---|---|
クライアントネットワーク上のこのノードのIPv4ネットマスク。 CLIENT_NETWORK_CONFIG = STATIC の場合にこのキーを指定してください。その他の値の場合は指定しないでください。 例:
|
CLIENT_NETWORK_IPが指定されており、かつCLIENT_NETWORK_CONFIG = STATICの場合に必須です。 それ以外は任意。 |
CLIENT_NETWORK_MTU
| Value | 指定 |
|---|---|
クライアントネットワーク上のこのノードの最大伝送単位(MTU)。CLIENT_NETWORK_CONFIG = DHCP の場合は指定しないでください。指定する場合、値は 1280 から 9216 の間である必要があります。省略した場合、1500 が使用されます。 ジャンボフレームを使用する場合は、MTU をジャンボフレームに適した値(9000 など)に設定してください。それ以外の場合は、デフォルト値を維持してください。 重要:ネットワークの MTU 値は、ノードが接続されているスイッチ ポートに設定された値と一致する必要があります。一致していない場合、ネットワークのパフォーマンス低下やパケットロスが発生する可能性があります。 例:
|
オプション |
CLIENT_NETWORK_TARGET
| Value | 指定 |
|---|---|
StorageGRID ノードがクライアントネットワークアクセスに使用するホストデバイスの名前。ネットワークインターフェイス名のみがサポートされています。通常、GRID_NETWORK_TARGET または ADMIN_NETWORK_TARGET に指定されたものとは異なるインターフェイス名を使用します。 注: ネットワークのターゲットとしてボンドデバイスやブリッジデバイスを使用しないでください。ボンドデバイスの上に VLAN (またはその他の仮想インターフェイス)を設定するか、ブリッジと仮想イーサネット (veth) のペアを使用します。 ベストプラクティス: このノードに初期状態でクライアントネットワークIPアドレスが割り当てられない場合でも、値を指定してください。そうすれば、ホスト上のノードを再設定することなく、後からクライアントネットワークのIPアドレスを追加できます。 例:
|
ベストプラクティス |
CLIENT_NETWORK_TARGET_TYPE
| Value | 指定 |
|---|---|
インターフェイス(これはサポートされている唯一の値です。) |
オプション |
CLIENT_NETWORK_TARGET_TYPE_INTERFACE_CLONE_MAC
| Value | 指定 |
|---|---|
真か偽か キーを「true」に設定すると、StorageGRID コンテナがクライアントネットワーク上のホストターゲットインターフェイスの MAC アドレスを使用するようになります。 ベストプラクティス: プロミスキャスモードが必要なネットワークでは、代わりに CLIENT_NETWORK_TARGET_TYPE_INTERFACE_CLONE_MAC キーを使用してください。 Linux 用 MAC クローン作成の詳細については、"MACアドレスのクローン作成に関する考慮事項と推奨事項"を参照してください。 |
ベストプラクティス |
グリッドネットワークキー
GRID_NETWORK_CONFIG
| Value | 指定 |
|---|---|
STATIC または DHCP 指定しない場合はデフォルトでSTATICになります。 |
ベストプラクティス |
GRID_NETWORK_GATEWAY
| Value | 指定 |
|---|---|
このノードのローカルグリッドネットワークゲートウェイのIPv4アドレス。このアドレスは、GRID_NETWORK_IPおよびGRID_NETWORK_MASKで定義されたサブネット上に存在する必要があります。この値は、DHCPで設定されたネットワークでは無視されます。 グリッドネットワークがゲートウェイのない単一のサブネットである場合は、サブネットの標準ゲートウェイアドレス(X.Y.Z.1)またはこのノードのGRID_NETWORK_IP値のいずれかを使用してください。どちらの値を使用しても、将来のグリッドネットワークの拡張が容易になります。 |
必須 |
GRID_NETWORK_IP
| Value | 指定 |
|---|---|
グリッドネットワーク上のこのノードのIPv4アドレス。このキーは、GRID_NETWORK_CONFIG = STATIC の場合にのみ必要です。他の値の場合は指定しないでください。 例:
|
GRID_NETWORK_CONFIG = STATIC の場合に必須 それ以外は任意。 |
GRID_NETWORK_MAC
| Value | 指定 |
|---|---|
コンテナ内のグリッドネットワークインターフェースのMACアドレス。 コロンで区切られた6組の16進数である必要があります。 例: |
オプション 省略した場合、MACアドレスは自動的に生成されます。 |
GRID_NETWORK_MASK
| Value | 指定 |
|---|---|
グリッドネットワーク上のこのノードのIPv4ネットマスク。GRID_NETWORK_CONFIG = STATIC の場合にこのキーを指定してください。その他の値の場合は指定しないでください。 例:
|
GRID_NETWORK_IPが指定され、GRID_NETWORK_CONFIG = STATICの場合に必須です。 それ以外は任意。 |
GRID_NETWORK_MTU
| Value | 指定 |
|---|---|
グリッドネットワーク上のこのノードの最大伝送単位(MTU)。GRID_NETWORK_CONFIG = DHCP の場合は指定しないでください。指定する場合、値は 1280 から 9216 の間である必要があります。省略した場合、1500 が使用されます。 ジャンボフレームを使用する場合は、MTU をジャンボフレームに適した値(9000 など)に設定してください。それ以外の場合は、デフォルト値を維持してください。 重要:ネットワークの MTU 値は、ノードが接続されているスイッチ ポートに設定された値と一致する必要があります。一致していない場合、ネットワークのパフォーマンス低下やパケットロスが発生する可能性があります。 重要:最適なネットワークパフォーマンスを実現するには、すべてのノードのグリッドネットワークインターフェースに同様のMTU値を設定する必要があります。個々のノードにおけるグリッドネットワークのMTU設定に大きな差異がある場合、*グリッドネットワークMTU不一致*アラートがトリガーされます。MTU値は、すべてのネットワークタイプで同じである必要はありません。 例:
|
オプション |
GRID_NETWORK_TARGET
| Value | 指定 |
|---|---|
StorageGRID ノードがグリッドネットワークアクセスに使用するホストデバイスの名前。ネットワークインターフェイス名のみがサポートされています。通常、ADMIN_NETWORK_TARGET または CLIENT_NETWORK_TARGET に指定されたものとは異なるインターフェイス名を使用します。 注: ネットワークのターゲットとしてボンドデバイスやブリッジデバイスを使用しないでください。ボンドデバイスの上に VLAN (またはその他の仮想インターフェイス)を設定するか、ブリッジと仮想イーサネット (veth) のペアを使用します。 例:
|
必須 |
GRID_NETWORK_TARGET_TYPE
| Value | 指定 |
|---|---|
インターフェース(サポートされている値はこれだけです。) |
オプション |
GRID_NETWORK_TARGET_TYPE_INTERFACE_CLONE_MAC
| Value | 指定 |
|---|---|
真か偽か キーの値を「true」に設定すると、StorageGRID コンテナがグリッド ネットワーク上のホスト ターゲット インターフェイスの MAC アドレスを使用するようになります。 ベストプラクティス: プロミスキャスモードが必要なネットワークでは、代わりに GRID_NETWORK_TARGET_TYPE_INTERFACE_CLONE_MAC キーを使用してください。 Linux 用 MAC クローン作成の詳細については、"MACアドレスのクローン作成に関する考慮事項と推奨事項"を参照してください。 |
ベストプラクティス |
インストールパスワードキー(一時的)
CUSTOM_TEMPORARY_PASSWORD_HASH
| Value | 指定 |
|---|---|
プライマリ管理ノードの場合、インストール時に StorageGRID インストール API のデフォルトの一時パスワードを設定します。 注: インストールパスワードは、プライマリ管理ノードにのみ設定してください。別のノードタイプでパスワードを設定しようとすると、ノード構成ファイルの検証が失敗します。 インストールが完了した後は、この値を設定しても効果はありません。 このキーを省略した場合、デフォルトでは一時パスワードは設定されません。または、StorageGRID インストール API を使用して一時パスワードを設定することもできます。 必ず このハッシュは、SHA-512モードの `openssl passwd`コマンドなどのCLIツールを使用して生成できます。 |
ベストプラクティス |
インターフェースキー
INTERFACE_TARGET_nnnn
| Value | 指定 |
|---|---|
このノードに追加したい追加インターフェースの名前と、必要に応じて説明を入力してください。各ノードには複数の追加インターフェースを追加できます。 nnnn については、追加する各 INTERFACE_TARGET エントリに一意の番号を指定してください。 値には、ベアメタル ホスト上の物理インターフェイスの名前を指定します。次に、必要に応じてカンマを追加し、インターフェイスの説明を入力します。この説明は、VLAN インターフェイス ページと HA グループ ページに表示されます。 例: トランクインターフェイスを追加する場合は、StorageGRID で VLAN インターフェイスを設定する必要があります。アクセスインターフェイスを追加する場合は、そのインターフェイスを直接 HA グループに追加できます。VLAN インターフェイスを設定する必要はありません。 |
オプション |
最大RAMキー
MAXIMUM_RAM
| Value | 指定 |
|---|---|
このノードが消費できる最大 RAM 容量。このキーを省略した場合、ノードにはメモリ制限はありません。本番環境のノードでこのフィールドを設定する場合は、システム全体の RAM 容量より 16~32 GB 少ない、少なくとも 24 GB 以上の値を指定してください。 注: RAM 値はノードの実際のメタデータのリザーブ スペースに影響します。"メタデータ リザーブ スペースとは何かについての説明"を参照してください。 このフィールドの形式は 例:
注:このオプションを使用するには、メモリ cgroups のカーネルサポートを有効にする必要があります。 |
オプション |
ノードタイプのキー
NODE_TYPE
| Value | 指定 |
|---|---|
ノードの種類:
|
必須 |
ストレージ タイプ
| Value | 指定 |
|---|---|
ストレージノードに格納されるオブジェクトの種類を定義します。詳細については、"ストレージノードの種類"を参照してください。このキーは、NODE_TYPE = VM_Storage_Node のノードでのみ必要です。他のノードタイプでは指定しないでください。ストレージの種類:
注:STORAGE_TYPEが指定されていない場合、ストレージノードのタイプはデフォルトでcombined (データとメタデータ)に設定されます。 |
オプション |
ポート再マッピングキー
|
|
ポート再マッピングのサポートは非推奨となり、今後のリリースで削除されます。再マッピングされたポートを削除するには、"ベアメタルホスト上のポートリマップを削除する"を参照してください。 |
PORT_REMAP
| Value | 指定 |
|---|---|
ノードが内部グリッドノード通信または外部通信に使用するポートを再マッピングします。エンタープライズ ネットワーク ポリシーによって StorageGRID が使用する 1 つ以上のポートの使用が制限されている場合、"内部でのGridノードの通信" または "外部通信" に説明するように、ポートの再マッピングが必要です。 重要:ロードバランサーのエンドポイントを設定するために使用する予定のポートを再マッピングしないでください。 注:PORT_REMAP のみが設定されている場合、指定したマッピングは受信通信と送信通信の両方に使用されます。PORT_REMAP_INBOUND も指定されている場合、PORT_REMAP は送信通信にのみ適用されます。 使用される形式は次のとおりです: 例: カンマ区切りのリストを使用して、複数のポートを再マッピングすることもできます。 例: |
オプション |
PORT_REMAP_INBOUND
| Value | 指定 |
|---|---|
受信通信を指定されたポートに再マッピングします。PORT_REMAP_INBOUNDを指定してもPORT_REMAPの値を指定しない場合、そのポートの送信通信は変更されません。 重要:ロードバランサーのエンドポイントを設定するために使用する予定のポートを再マッピングしないでください。 使用される形式は次のとおりです: 例: カンマ区切りのリストを使用して、複数の受信ポートを再マッピングすることもできます。 例: |
オプション |