Red Hat Enterprise Linux環境のノード構成ファイルの作成
ノード構成ファイルは、ノードを起動して適切なネットワークおよびブロックストレージリソースに接続するために StorageGRID ホストサービスで必要となる情報をまとめた小さいテキストファイルです。ノード構成ファイルは仮想ノードに使用され、アプライアンスノードには使用されません。
ノード構成ファイルの場所
各StorageGRIDノードの構成ファイルを、そのノードを実行するホストのディレクトリに配置し /etc/storagegrid/nodes`ます。たとえば、HostAで管理ノード、ゲートウェイノード、およびストレージノードを1つずつ実行する場合は、3つのノード構成ファイルをHostAのに配置する必要があります `/etc/storagegrid/nodes
。
構成ファイルは、 vim や nano などのテキストエディタを使用して各ホストで直接作成することも、別の場所で作成して各ホストに移動することもできます。
ノード構成ファイルの命名
構成ファイルの名前は、の形式はです node-name.conf
。はノードに割り当てる名前です。 `node-name`この名前は StorageGRID インストーラに表示され、ノード移行などのノードのメンテナンス処理で使用されます。
ノード名は次のルールに従って付ける必要があります。
-
一意でなければなりません
-
1 文字目はアルファベットにする必要があります
-
A~Z と a~z のアルファベットを使用できます
-
0~9 の数字を使用できます
-
1 つまたは複数のハイフン( - )を含めることができます。
-
拡張子は含めず、32文字以下にする必要があります。
.conf
これらの命名規則に従わない内のファイルは、 `/etc/storagegrid/nodes`ホストサービスによって解析されません。
グリッドでマルチサイトトポロジを使用する場合の一般的なノード名は次のようになります。
site-nodetype-nodenumber.conf
たとえば、データセンター1の最初の管理ノードにを使用し、 dc2-sn3.conf`データセンター2の3番目のストレージノードにを使用できます `dc1-adm1.conf
。ただし、すべてのノード名がルールに従っていれば、別の名前にしてもかまいません。
ノード構成ファイルの内容
構成ファイルには、1行に1つのキーと1つの値を持つキーと値のペアが含まれています。キーと値のペアごとに、次のルールに従ってください。
-
キーと値は等号で区切る必要があり(`=`ます)、およびオプションの空白文字で区切る必要があります。
-
キーにスペースを含めることはできません。
-
値にはスペースを含めることができます。
-
先頭または末尾の空白は無視されます。
次の表に、サポートされているすべてのキーの値を示します。各キーには、次のいずれかの指定があります。
-
必須:すべてのノードまたは指定したノードタイプに必須
-
ベストプラクティス:オプション(推奨されますが)
-
オプション:すべてのノードでオプション
管理ネットワークキー
ADMIN_IP を指定します
値 | 名称 |
---|---|
このノードが属するグリッドのプライマリ管理ノードのグリッドネットワークの IPv4 アドレス。GRID_NETWORK_IP で指定した値を Node_type=VM_Admin_Node および ADMIN_NETWORK_role = Primary のグリッドノードに使用します。このパラメータを省略すると、 mDNS を使用してプライマリ管理ノードの検出が試行されます。
|
ベストプラクティス |
ADMIN_NETWORK_CONFIG
値 | 名称 |
---|---|
DHCP 、 STATIC 、または DISABLED |
オプション |
ADMIN_NETWORK_ESL
値 | 名称 |
---|---|
このノードが管理ネットワークゲートウェイを使用して通信するサブネット(CIDR表記)をカンマで区切ったリスト。 例: |
オプション |
ADMIN_NETWORK_GATEWAY
値 | 名称 |
---|---|
このノードのローカルの管理ネットワークゲートウェイの 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
値 | 名称 |
---|---|
コンテナ内の管理ネットワークインターフェイスの MAC アドレス。 このフィールドはオプションです。省略すると、 MAC アドレスが自動的に生成されます。 6 つの 16 進数値をコロンで区切って指定する必要があります。 例: |
オプション |
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 などのジャンボフレームに適した値に設定します。それ以外の場合は、デフォルト値のままにします。
例:
|
オプション |
ADMIN_NETWORK_TARGET
値 | 名称 |
---|---|
StorageGRID ノードで管理ネットワークのアクセスに使用するホストデバイスの名前。ネットワークインターフェイス名のみがサポートされています。通常、 GRID_NETWORK_TARGET または CLIENT_NETWORK _TARGET に指定したインターフェイス名とは別のインターフェイス名を使用します。 注:ボンドデバイスやブリッジデバイスをネットワークターゲットとして使用しないでください。ボンドデバイスの上に VLAN (または他の仮想インターフェイス)を設定するか、ブリッジと仮想イーサネット( veth )のペアを使用します。
例:
|
ベストプラクティス |
ADMIN_NETWORK_TARGET タイプ
値 | 名称 |
---|---|
interface(サポートされている値はこれだけです) |
オプション |
ADMIN_NETWORK_TARGET _TYPE_interface_clone_MAC
値 | 名称 |
---|---|
正しいか間違っているか StorageGRID コンテナで管理ネットワークのホストターゲットインターフェイスの MAC アドレスを使用するには、キーを「 true 」に設定して原因 に設定します。
MAC クローニングの詳細については、次の URL を参照してください |
ベストプラクティス |
ADMIN_NETWORK_ROLE
値 | 名称 |
---|---|
プライマリまたは非プライマリ このキーが必要なのは、NODE_TYPE = VM_ADMIN_Nodeの場合のみです。それ以外のタイプのノードの場合は指定しないでください。 |
NODE_TYPE = VM_Admin_Nodeの場合は必須 それ以外の場合はオプション。 |
ブロックデバイスキー
BLOBK_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に指定するブロックデバイスは4TB以上である必要があります。それ以外は4TB未満でもかまいません。 隙間を空けてはいけません。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 |
BLOBK_DEVICE_tables
値 | 名称 |
---|---|
このノードでデータベーステーブルの永続的なストレージに使用するブロックデバイススペシャルファイルのパスと名前。このキーが必要なのは、NODE_TYPE = VM_ADMIN_Nodeのノードだけです。それ以外のタイプのノードの場合は指定しないでください。 例:
|
必須 |
BLOBK_DEVICE_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
値 | 名称 |
---|---|
コンテナ内のクライアントネットワークインターフェイスの MAC アドレス。 このフィールドはオプションです。省略すると、 MAC アドレスが自動的に生成されます。 6 つの 16 進数値をコロンで区切って指定する必要があります。 例: |
オプション |
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 などのジャンボフレームに適した値に設定します。それ以外の場合は、デフォルト値のままにします。
例:
|
オプション |
client_network_target です
値 | 名称 |
---|---|
StorageGRID ノードでクライアントネットワークのアクセスに使用するホストデバイスの名前。ネットワークインターフェイス名のみがサポートされています。通常、 GRID_NETWORK_TARGET または ADMIN_NETWORK_TARGET に指定したインターフェイス名とは別のインターフェイス名を使用します。 注:ボンドデバイスやブリッジデバイスをネットワークターゲットとして使用しないでください。ボンドデバイスの上に VLAN (または他の仮想インターフェイス)を設定するか、ブリッジと仮想イーサネット( veth )のペアを使用します。
例:
|
ベストプラクティス |
client_network_target_type
値 | 名称 |
---|---|
interface(サポートされている値のみ) |
オプション |
client_network_target_type _interface_clone_MAC
値 | 名称 |
---|---|
正しいか間違っているか クライアントネットワークでホストターゲットインターフェイスの MAC アドレスを使用するには、キーを「 true 」に設定して StorageGRID コンテナを原因 します。
MAC クローニングの詳細については、次の URL を参照してください |
ベストプラクティス |
グリッドネットワークキー
GRID_NETWORK_CONFIG
値 | 名称 |
---|---|
STATIC または DHCP 指定しない場合のデフォルトはstaticです。 |
ベストプラクティス |
GRID_NETWORK_GATEWAY
値 | 名称 |
---|---|
このノードのローカルのグリッドネットワークゲートウェイの IPv4 アドレス。 GRID_NETWORK_IP および GRID_NETWORK_MASK で定義されるサブネットに属している必要があります。この値は、 DHCP によって設定されたネットワークでは無視されます。 グリッドネットワークのサブネットが 1 つだけでゲートウェイがない場合は、サブネットの標準のゲートウェイアドレス( X.Y.Z.1 )か、このノードの GRID_NETWORK_IP の値を使用します。このどちらかの値にしておけば、以降にグリッドネットワークを拡張するときに処理が簡単になります。 |
必須 |
GRID_NETWORK_IP
値 | 名称 |
---|---|
このノードのグリッドネットワークにおける IPv4 アドレス。このキーが必要なのは、GRID_NETWORK_CONFIG = STATICの場合のみです。それ以外の値の場合は指定しないでください。 例:
|
GRID_NETWORK_CONFIG = STATICの場合は必須 それ以外の場合はオプション。 |
GRID_NETWORK_MAC
値 | 名称 |
---|---|
コンテナ内のグリッドネットワークインターフェイスの MAC アドレス。 6 つの 16 進数値をコロンで区切って指定する必要があります。 例: |
オプション 省略すると、 MAC アドレスが自動的に生成されます。 |
GRID_NETWORK_MASK
値 | 名称 |
---|---|
このノードのグリッドネットワークにおける IPv4 ネットマスク。GRID_NETWORK_CONFIG = STATICの場合はこのキーを指定します。それ以外の値の場合は指定しないでください。 例:
|
GRID_NETWORK_IPを指定し、GRID_NETWORK_CONFIG = STATICを指定した場合に必要です。 それ以外の場合はオプション。 |
GRID_NETWORK_MTU
値 | 名称 |
---|---|
このノードのグリッドネットワークでの最大伝送ユニット( MTU )。GRID_NETWORK_CONFIG = DHCPの場合は指定しないでください。この値を指定する場合、 1280 ~ 9216 の範囲で指定する必要があります。省略すると、 1500 が使用されます。 ジャンボフレームを使用する場合は、 MTU を 9000 などのジャンボフレームに適した値に設定します。それ以外の場合は、デフォルト値のままにします。
例:
|
オプション |
GRID_NETWORK_TARGET
値 | 名称 |
---|---|
StorageGRID ノードでグリッドネットワークのアクセスに使用するホストデバイスの名前。ネットワークインターフェイス名のみがサポートされています。通常、 ADMIN_NETWORK_TARGET または ADMIN_NETWORK_TARGET に指定したインターフェイス名とは別のインターフェイス名を使用します。 注:ボンドデバイスやブリッジデバイスをネットワークターゲットとして使用しないでください。ボンドデバイスの上に VLAN (または他の仮想インターフェイス)を設定するか、ブリッジと仮想イーサネット( veth )のペアを使用します。 例:
|
必須 |
GRID_NETWORK_TARGET タイプ
値 | 名称 |
---|---|
interface(サポートされている値はこれだけです) |
オプション |
GRID_NETWORK_TARGET _TYPE_interface_clone_MAC
値 | 名称 |
---|---|
正しいか間違っているか グリッドネットワーク上のホストターゲットインターフェイスの MAC アドレスを使用するには、キーの値を「 true 」に設定して StorageGRID コンテナを原因 に設定します。
MAC クローニングの詳細については、次の URL を参照してください |
ベストプラクティス |
インストールパスワードキー(一時)
custom_temporary_password_hash
値 | 名称 |
---|---|
プライマリ管理ノードの場合は、インストール時にStorageGRIDインストールAPIのデフォルトの一時パスワードを設定します。 注:インストールパスワードはプライマリ管理ノードにのみ設定します。別のタイプのノードでパスワードを設定しようとすると、ノード構成ファイルの検証に失敗します。 この値を設定しても、インストールが完了しても効果はありません。 このキーを省略すると、デフォルトでは一時パスワードは設定されません。または、StorageGRIDインストールAPIを使用して一時パスワードを設定することもできます。 8文字以上32文字以下のパスワードの形式のSHA-512パスワードハッシュで このハッシュは、SHA-512モードのコマンドなどのCLIツールを使用して生成できます |
ベストプラクティス |
interfacesキー
interface_target_nnnn
値 | 名称 |
---|---|
このノードに追加するインターフェイスの名前とオプションの概要 。各ノードに複数のインターフェイスを追加できます。 _nnnn_には、追加する各interface_targetエントリに一意の番号を指定します。 値には、ベアメタルホスト上の物理インターフェイスの名前を指定します。その後、必要に応じて、カンマを追加してインターフェイスの概要 を指定します。このインターフェイスは、 VLAN インターフェイスのページと HA グループのページに表示されます。 例: トランクインターフェイスを追加する場合は、 StorageGRID で VLAN インターフェイスを設定する必要があります。アクセスインターフェイスを追加する場合は、そのインターフェイスをHAグループに直接追加できます。VLANインターフェイスを設定する必要はありません。 |
オプション |
最大RAMキー
MAXIMUM_RAM
値 | 名称 |
---|---|
このノードに使用を許可する RAM の最大容量。このキーを省略した場合、ノードでメモリは制限されません。本番用のノードについて設定するときは、システム RAM の合計容量よりも 24GB 以上、 16~32GB 以上小さい値を指定してください。
このフィールドの形式はです 例:
|
オプション |
ノードタイプキー
Node_type のように指定します
値 | 名称 |
---|---|
ノードのタイプ:
|
必須 |
ストレージタイプ
値 | 名称 |
---|---|
ストレージノードに含まれるオブジェクトのタイプを定義。詳細については、を参照してください "ストレージノードのタイプ"。このキーが必要なのは、NODE_TYPE = VM_Storage_Nodeのノードだけです。それ以外のタイプのノードの場合は指定しないでください。ストレージタイプ:
注:storage_typeを指定しない場合、ストレージノードタイプはデフォルトで組み合わせ(データとメタデータ)に設定されます。 |
オプション |
ポートの再マッピングキー
PORT_REMAP を参照してください
値 | 名称 |
---|---|
ノードが内部でのグリッドノードの通信または外部との通信に使用するポートを再マッピングします。ポートの再マッピングが必要になるのは、またはの説明に従って、StorageGRIDで使用される1つ以上のポートがエンタープライズネットワークポリシーによって制限されている場合です。"内部でのグリッドノードの通信""外部との通信" 重要:ロードバランサエンドポイントの設定に使用する予定のポートを再マッピングしないでください。
使用される形式は、 `network type/protocol/default port used by grid node/new port`です。 `network type`はgrid、admin、またはclient、 `protocol`はtcpまたはudpです。 例: カンマで区切ったリストを使用して複数のポートを再マッピングすることもできます。 例: |
オプション |
PORT_REMAP_INBOUND
値 | 名称 |
---|---|
指定したポートのインバウンド通信を再マッピングします。PORT_REMAP_INBOUNDを指定し、PORT_REMAPに値を指定しなかった場合、ポートのアウトバウンド通信は変更されません。 重要:ロードバランサエンドポイントの設定に使用する予定のポートを再マッピングしないでください。 使用される形式は、 `network type/protocol/remapped port/default port used by grid node`です。 `network type`はgrid、admin、またはclient、 `protocol`はtcpまたはudpです。 例: カンマで区切った複数のインバウンドポートを再マッピングすることもできます。 例: |
オプション |