8.8. openvswitch_agent.ini
このセクションでは、/etc/neutron/plugins/ml2/openvswitch_agent.ini
ファイルのオプションを説明します。
8.8.1. DEFAULT
以下の表は、/etc/neutron/plugins/ml2/openvswitch_agent.ini
ファイルの [DEFAULT]
グループで使用できるオプションの概要をまとめたものです。
.
設定オプション = デフォルト値 | 型 | 説明 |
---|---|---|
| ブール値 | true に設定すると、ログレベルはデフォルトの INFO レベルではなく DEBUG に設定されます。 |
| リスト値 | logger=LEVEL ペアのパッケージロギングレベルのリスト。このオプションは、log_config_append が設定されている場合は無視されます。 |
| ブール値 | 非推奨の致命的なステータスを有効または無効にします。 |
instance_format = [instance: %(uuid)s] | 文字列値 | ログメッセージで渡されるインスタンスの形式。 |
instance_uuid_format = [instance: %(uuid)s] | 文字列値 | ログメッセージで渡されるインスタンス UUID の形式。 |
| 文字列値 | ロギング設定ファイルの名前。このファイルは、既存のロギング設定ファイルに追加されます。ロギング設定ファイルの詳細は、Python のロギングモジュールのドキュメントを参照してください。ロギング設定ファイルを使用すると、すべてのロギング設定が設定ファイルで設定され、その他のロギング設定オプションは無視されます (例:log-date-format)。 |
| 文字列値 | ログレコードの %%(asctime)s のフォーマット文字列を定義します。デフォルト:%(default)sこのオプションは、log_config_append が設定されている場合は無視されます。 |
| 文字列値 | (オプション)log_file の相対パスに使用されるベースディレクトリー。このオプションは、log_config_append が設定されている場合は無視されます。 |
| 文字列値 | (オプション) ロギング出力を送信するログファイルの名前。デフォルトが設定されていない場合、ロギングは use_stderr で定義されているように stderr に送信されます。このオプションは、log_config_append が設定されている場合は無視されます。 |
| 整数値 | ログファイルがローテーションされるまでの時間。このオプションは、log_rotation_type が "interval" に設定されていない限り無視されます。 |
| 文字列値 | ローテーション間隔の種別。次のローテーションをスケジューリングする際に、最後のファイル変更の時刻 (またはサービスの起動時刻) が使用されます。 |
| 文字列値 | ログローテーションの種別。 |
| 文字列値 | コンテキスト付きログメッセージに使用するフォーマット文字列。oslo_log.formatters.ContextFormatter により使用されます。 |
| 文字列値 | メッセージのロギングレベルが DEBUG の場合にログメッセージに追加する追加のデータ。oslo_log.formatters.ContextFormatter により使用されます。 |
| 文字列値 | コンテキストが定義されていない場合に、ログメッセージに使用するフォーマット文字列。oslo_log.formatters.ContextFormatter により使用されます。 |
| 文字列値 | この形式で、例外出力の各行の前に接頭辞が付けられます。oslo_log.formatters.ContextFormatter により使用されます。 |
| 文字列値 | logging_context_format_string で使用される %(user_identity)s のフォーマット文字列を定義します。oslo_log.formatters.ContextFormatter により使用されます。 |
| 整数値 | ローテーションされたログファイルの最大数。 |
| 整数値 | ログファイルの最大サイズ (MB 単位)。"log_rotation_type" が "size" に設定されていない場合は、このオプションは無視されます。 |
| ブール値 | エラーイベントの公開を有効または無効にします。 |
| 整数値 | rate_limit_interval ごとのログ記録されたメッセージの最大数。 |
| 文字列値 | レート制限で使用されるログレベル名:CRITICAL、ERROR、INFO、WARNING、DEBUG または空の文字列。rate_limit_except_level 以上のレベルのログはフィルターされません。空の文字列は、すべてのレベルがフィルターされることを意味します。 |
| 整数値 | ログのレート制限の間隔 (秒数)。 |
| 整数値 | RPC 呼び出しからの応答を待つ最大時間 (秒単位)。 |
| 文字列値 | ログ行を受け取る syslog ファシリティー。このオプションは、log_config_append が設定されている場合は無視されます。 |
| ブール値 | ロギング用の journald を有効にします。systemd 環境で実行している場合は、ジャーナルサポートを有効にしたい場合があります。その場合、ログメッセージに加えて構造化されたメタデータが含まれる journal ネイティブプロトコルが使用されます。このオプションは、log_config_append が設定されている場合は無視されます。 |
| ブール値 | ロギングに JSON 形式を使用します。このオプションは、log_config_append が設定されている場合は無視されます。 |
| ブール値 | ロギングに syslog を使用します。既存の syslog 形式は非推奨であり、後に RFC5424 に従うように変更されます。このオプションは、log_config_append が設定されている場合は無視されます。 |
| ブール値 | 出力を Windows イベントログに記録します。 |
| ブール値 | 出力を標準エラーに記録します。このオプションは、log_config_append が設定されている場合は無視されます。 |
| ブール値 | ファイルシステムを監視するように設計されたログハンドラーを使用します。ログファイルが移動または削除されると、このハンドラーは、指定されたパスで新しいログファイルを即時に開きます。これは、log_file オプションを指定し、Linux プラットフォームが使用される場合にのみ有効です。このオプションは、log_config_append が設定されている場合は無視されます。 |
8.8.2. agent
以下の表は、/etc/neutron/plugins/ml2/openvswitch_agent.ini
ファイルの [agent]
グループで使用できるオプションの概要をまとめたものです。
設定オプション = デフォルト値 | 型 | 説明 |
---|---|---|
| ブール値 | ローカル ARP レスポンダーがサポートされる場合は有効にします。OVS 2.1 および ML2 l2opulation ドライバーが必要です。スイッチが (オーバーレイをサポートしている場合)、オーバーレイへのコストのかかる ARP ブロードキャストを実行せずに、ローカルで ARP 要求に応答できるようにします。enable_distributed_routing が True に設定されている場合は、設定ファイルの設定に関係なく、エージェントでは arp_responder が自動的に True に設定されます。 |
| ブール値 | エージェントを有効にして、スマート NIC ポートを処理します。 |
| ブール値 | GRE/VXLAN トンネルを伝送する発信 IP パケットに don't fragment (DF) ビットを設定または設定します。 |
| ブール値 | 開始時にフローテーブルをリセットします。これを True に設定すると、短いトラフィックが中断します。 |
| ブール値 | l2 エージェントを DVR モードで実行させます。 |
| ブール値 | True に設定すると、許可される egress ユニキャストトラフィックはアクション NORMAL を使用しません。許可される egress パケットは、ユニキャストトラフィックの最終的な egress テーブルの出力フローに対応します。 |
| リスト値 | 使用するエクステンションリスト |
| ブール値 | ML2 l2population メカニズムドライバーを使用して、リモート MAC および IP を確認し、トンネルのスケーラビリティーを向上させます。 |
| ブール値 | インターフェイスの変更について ovsdb を監視することにより、ポーリングを最小限に抑えます。 |
| 整数値 | ovsdb モニターの通信が失われた後に ovsdb モニターを再試行するまで待機する秒数。 |
| ブール値 | 発信 IP パケットを転送する GRE/VXLAN トンネルのトンネルヘッダーチェックサムを設定または設定します。 |
| リスト値 | エージェントがサポートするネットワークタイプ (gre、vxlan、および/ または geneve)。 |
| 整数値 | veth インターフェイスの MTU サイズ |
| ポート値 | VXLAN トンネルに使用する UDP ポート。 |
8.8.3. network_log
以下の表は、/etc/neutron/plugins/ml2/openvswitch_agent.ini
ファイルの [network_log]
グループで使用できるオプションの概要をまとめたものです。
設定オプション = デフォルト値 | 型 | 説明 |
---|---|---|
| 整数値 | rate_limit あたりの最大パケット数。 |
| 文字列値 | エージェント側の出力ログファイルパス、デフォルトの syslog ファイル。 |
| 整数値 | 1 秒あたりの最大パケットロギング。 |
8.8.4. ovs
以下の表は、/etc/neutron/plugins/ml2/openvswitch_agent.ini
ファイルの [ovs]
グループで使用できるオプションの概要をまとめたものです。
設定オプション = デフォルト値 | 型 | 説明 |
---|---|---|
| リスト値 | フラットネットワークおよび VLAN ネットワークに使用する、物理ネットワーク名をエージェントのノード固有の Open vSwitch ブリッジ名にマッピングする <physical_network>:<bridge> タプルのコンマ区切りリスト。ブリッジ名の長さは 11 を超えないようにする必要があります。各ブリッジは存在している必要があり、ポートとして設定された物理ネットワークインターフェイスが必要です。サーバーに設定したすべての物理ネットワークには、各エージェント上の適切なブリッジへのマッピングが必要です。注意: このマッピングからブリッジを削除する場合は、エージェントによって管理されないため、必ずブリッジからブリッジを切断してください。 |
| 文字列値 | 使用する OVS データパス。system はデフォルト値で、カーネルデータパスに対応します。ユーザー空間データパスを有効にするには、この値を netdev に設定します。 |
| ブール値 | QoS 拡張機能が有効な場合、パケットマーキングを無効にします。skb_priority、sbk_mark、および出力キューフィールドがサポートされ、オフロードできるようになるまで、ハードウェアオフロードで OVS を使用する場合は、このオプションを有効にする必要があります。このオプションが有効になっている場合、レート QoS ルール (帯域幅制限または最小帯域幅) は VirtIO ポートに対して機能しません。 |
| 文字列値 | トンネルブリッジ用の統合ブリッジのピアパッチポート。 |
| 文字列値 | 使用する統合ブリッジ。適切な理由がない限り、このパラメーターを変更しないでください。これは OVS 統合ブリッジの名前です。ハイパーバイザーごとに 1 つがあります。統合ブリッジは、仮想 パッチベイ として機能します。すべての VM VIF は、このブリッジに接続されてから、ネットワーク接続に従って パッチが当てられます。 |
| IP アドレス値 | ローカルオーバーレイ (tunnel) ネットワークエンドポイントの IP アドレス。ホストネットワークインターフェイスのいずれかにある IPv4 アドレスまたは IPv6 アドレスを使用します。この値の IP バージョンは、neutron サーバーノード上の ML2 プラグイン設定ファイルの overlay_ip_version オプションの値と一致する必要があります。 |
| 整数値 | コントローラーを接続しているローカルスイッチを待つタイムアウト (秒単位)。 |
| 整数値 | コントローラーへのローカルスイッチ接続の間隔 (秒単位)。0 を値として指定すると、非アクティブプローブが無効になります。 |
| IP アドレス値 | OpenFlow 接続をリッスンするアドレス。 |
| ポート値 | OpenFlow 接続をリッスンするポート。 |
| 整数値 | 単一の OpenFlow 要求を待つタイムアウト (秒単位)。 |
| 文字列値 | OVSDB バックエンドの接続文字列。すべての ovsdb コマンドに使用され、監視時に ovsdb-client によって使用されます。 |
| ブール値 | OVSDB デバッグログの有効化 |
| リスト値 | <bridge>:<egress_bw>:<ingress_bw> タプルのコンマ区切りリスト。指定のブリッジで利用可能な帯域幅が指定の方向に表示されます。方向は、VM の視点から行われます。帯域幅は、1 秒あたりのキロバイト単位 (kbps) で測定されます。ブリッジは bridge_mappings に値として表示されるはずです。ただし、bridge_mappings のすべてのブリッジをここに記載する必要があるわけではありません。ここで記載されていないブリッジでは、配置にリソースプロバイダーを作成したり、インベントリーを報告したりすることはありません。省略の方向は、対応するクラスのインベントリーを報告しないことを意味します。 |
| 文字列値 | リソースプロバイダーの親を見つけるために使用されるデフォルトのハイパーバイザー名。このオプションが設定されていない場合、標準的な名前が使用されます |
| dict 値 | ブリッジのハイパーバイザーへのマッピング:<bridge>:<hypervisor>,... ハイパーバイザー名は、リソースプロバイダーツリーの親を見つけるために使用されます。ハイパーバイザー名が、そのハイパーバイザーを管理する nova-compute によって認識される resource_provider_default_hypervisor 設定オプションの値と異なる場合にのみ、設定する必要があります。 |
| dict 値 | Key:Value ペアは、リソースプロバイダーのインベントリーのレポート中に使用されるデフォルトを指定します。それぞれのタイプを持つ、考えられるキー: allocation_ratio:float、max_unit:int、min_unit:int、reserved:int、step_size:int。https://docs.openstack.org/api-ref/placement/#update-resource-provider-inventories も参照してください。 |
| 文字列値 | OVSDB との対話時に使用する認証局 (CA) 証明書。"ssl:" 接頭辞 ovsdb_connection を使用する場合は必須 |
| 文字列値 | OVSDB との対話時に使用する SSL 証明書ファイル。"ssl:" 接頭辞 ovsdb_connection を使用する場合は必須 |
| 文字列値 | OVSDB との対話時に使用する SSL 秘密鍵ファイル。"ssl:" 接頭辞 ovsdb_connection を使用する場合は必須 |
| 文字列値 | 統合ブリッジ用のトンネルブリッジのピアパッチポート。 |
| 文字列値 | 使用するトンネルブリッジ。 |
| 文字列値 | OVS vhost-user ソケットディレクトリー。 |
8.8.5. securitygroup
以下の表は、/etc/neutron/plugins/ml2/openvswitch_agent.ini
ファイルの [securitygroup]
グループで使用できるオプションの概要をまとめたものです。
設定オプション = デフォルト値 | 型 | 説明 |
---|---|---|
| ブール値 | ipset を使用して、iptables ベースのセキュリティーグループをスピードアップします。ipset サポートを有効にするには、ipset が L2 エージェントノードにインストールする必要があります。 |
| ブール値 | サーバーで neutron セキュリティーグループ API を有効にするかどうかを制御します。セキュリティーグループを使用しない場合や、nova セキュリティーグループ API を使用する場合は false にする必要があります。 |
| 文字列値 | L2 エージェントのセキュリティーグループファイアウォール用のドライバー |
| リスト値 | 16 進数 ("0x" で始まる) で、許可されるイーサネットタイプのコンマ区切りリスト。たとえば、"0x4008" は InfiniBand を許可します。 |