8.7. neutron.conf
本項では、/etc/neutron/neutron.conf
ファイルのオプションについて説明します。
8.7.1. DEFAULT
以下の表には、/etc/neutron/neutron.conf
ファイルの [DEFAULT]
グループで使用できるオプションの概要をまとめています。
.
設定オプション = デフォルト値 | タイプ | 説明 |
---|---|---|
| 整数値 | エージェントがダウンしていると見なされる秒数です。適切なためにエージェントが停止していることを確認するために、少なくとも 2 回の report_interval にする必要があります。 |
| ブール値 | オフラインの DHCP エージェントからネットワークを自動的に削除します。 |
| ブール値 | オフラインの L3 エージェントからオンライン L3 エージェントへのルーターの自動再スケジュール。 |
| ブール値 | 一括 API の使用を許可する |
| ブール値 | Neutron での IP アドレスのオーバーラップを許可します。注記: Neutron が Nova セキュリティーグループと併用されている場合は、以下のパラメーターを False に設定する必要があります。 |
`api_extensions_path = ` | 文字列値 | API エクステンションのパス。これには、コロンで区切られたパスのリストを使用できます。例: api_extensions_path = extensions:/path/to/more/exts:/even/more/exts.neutron.extensions の パス がこれに追加されるので、拡張がある場合はここで指定する必要がありません。 |
| 文字列値 | api サービスの paste.deploy 設定のファイル名 |
| 整数値 | サービスの個別の API ワーカープロセスの数。指定のない場合は、デフォルトの CPU 数で最高のパフォーマンスを得るために利用可能な CPU の数と同じになり、RAM 使用率は上限になります。 |
| 文字列値 | 使用する認証のタイプ |
| 整数値 | ソケットを設定するバックログリクエストの数 |
| 文字列値 | Neutron が VIF に使用するベース MAC アドレス最初の 3 オクテットは変更しません。4 番目のオクテットが 00 でない場合は、これも使用されます。他は無作為に生成されます。 |
| ホストのアドレス値 | バインド先のホスト IP。 |
| ポート値 | バインドするポート |
| 整数値 | クライアント接続のソケット操作のタイムアウト。受信接続がこの秒数の間アイドル状態であると、閉じられます。0 の値は、永久に待機することを意味します。 |
| 整数値 | 接続有効期限ポリシーのプールサイズ制限 |
| 整数値 | プールのアイドル状態の接続の存続期間(秒単位) |
| 文字列値 | トピックがスコープ設定されるデフォルトの変換。transport_url オプションで指定した変換名で上書きできます。 |
| 文字列値 | Neutron が使用するコアプラグイン |
| ブール値 | true に設定すると、ログレベルはデフォルトの INFO レベルではなく DEBUG に設定されます。 |
| リスト値 | アベイラビリティーゾーンのデフォルト値はヒントです。アベイラビリティーゾーンを認識するスケジューラーは、リソース availability_zone_hints が空の場合にこれを使用します。複数のアベイラビリティーゾーンをコンマ区切りの文字列で指定できます。この値は空白にすることができます。この場合、リソースの availability_zone_hints が空であっても、リソースのスケジューリング中にアベイラビリティーゾーンが高可用性のために考慮されます。 |
| リスト値 | logger=LEVEL ペアのパッケージロギングレベルの一覧。このオプションは、log_config_append が設定されている場合は無視されます。 |
| ブール値 | DHCP エージェントへのリソース操作通知送信の許可 |
| 整数値 | テナントネットワークをホストするためにスケジュールされている DHCP エージェントの数。この数が 1 を超える場合、スケジューラーは特定のテナントネットワークに複数の DHCP エージェントを自動的に割り当て、DHCP サービスに高可用性を提供します。 |
| 整数値 | DHCP リース期間 (秒単位)。-1 を使用して、無限リース時間を使用するように dnsmasq に指示します。 |
| 文字列値 | エージェントによって負荷がレポートされるリソースタイプを表します。これには、「networks」、「subnets」、または「ports」を使用できます。指定すると (デフォルトがネットワークの場合)、サーバーはエージェントレポートの状態からエージェント設定オブジェクトの一部として送信される特定の負荷を抽出します。これは消費されるリソースの数で、すべての report_interval.dhcp_load_type は network_scheduler_driver = neutron.scheduler.dhcp_agent_scheduler.WeightScheduler と組み合わせて使用できます。network_scheduler_driver が WeightScheduler の場合、dhcp_load_type は分散されるリソースの選択を表すように設定できます。例: dhcp_load_type=networks |
| 文字列値 | ホスト名の構築に使用するドメイン |
| 文字列値 | Neutron が一意の DVR インスタンスに使用するベース mac アドレス最初の 3 オクテットは変更しません。4 番目のオクテットが 00 でない場合は、これも使用されます。他は無作為に生成されます。テナントポート用に割り当てられた MAC と混同しないようにするため、dvr_base_mac は base_mac とは異なる 必要 があります。4 つのオクテットの例は、dvr_base_mac = fa:16:3f:4f:00:00 のようになります。デフォルトは 3 オクテットです。 |
| ブール値 | 設定が DVR に設定されているかどうかを判断します。False の場合、DVR API 拡張は無効になります。 |
| ブール値 | enable_new_agents=False の場合、エージェントは admin_state_up=False で始まります。この場合、admin が admin_state_up を True に変更するまで、ユーザーのリソースはエージェントに自動的にスケジュールされません。 |
| ブール値 | admin_state_up False を使用してエージェントでサービスを有効にします。このオプションが False の場合、エージェントの admin_state_up が False になっていると、そのエージェント上のサービスが無効になります。このオプションに関係なく、自動スケジューリングでは、admin_state_up False のエージェントが選択されていません。ただし、このオプションが True の場合は、そのようなエージェントに手動でスケジュールすることができます。 |
| ブール値 | external_gateway_info に指定されていない場合は、enable_snat のデフォルト値を定義します。 |
| 整数値 | エグゼキューターがスレッディングまたはイベントレットの場合のエグゼキュータースレッドプールのサイズ。 |
| 文字列値 | 外部 DNS インテグレーションのドライバー。 |
| ブール値 | 非推奨の致命的なステータスを有効または無効にします。 |
| ブール値 | True の場合には、プラグインがフィルターパラメーターの検証を実行するかどうかを決定します。この設定が有効で、すべてのプラグインでサポートされる場合、フィルター検証が有効になります。 |
| 整数値 | 下層の物理ネットワークの MTU。Neutron はこの値を使用して、すべての仮想ネットワークコンポーネントの MTU を算出します。フラットネットワークおよび VLAN ネットワークの場合は、neutron はこの値を変更せずに使用します。VXLAN などのオーバーレイネットワークの場合には、neutron は自動的にこの値からオーバーレイプロトコルのオーバーヘッドを除算します。デフォルトは、Ethernet の標準値である 1500 です。 |
| ホストのアドレス値 | このマシンで実行している Neutron サーバー、エージェント、サービスが使用するホスト名。このマシンで実行しているすべてのエージェントとサービスは、同じホスト値を使用する必要があります。 |
instance_format = [instance: %(uuid)s] | 文字列値 | ログメッセージで渡されるインスタンスの形式。 |
instance_uuid_format = [instance: %(uuid)s] | 文字列値 | ログメッセージで渡されるインスタンスUUIDの形式。 |
| 文字列値 | 仮想インターフェースの管理に使用するドライバー。 |
| 文字列値 | 使用する Neutron IPAM (IP アドレス管理) ドライバーデフォルトでは、Neutron IPAM ドライバーの参照実装が使用されます。 |
| ブール値 | 自動サブネット CIDR 割り当ての IPv6 プレフィックス委任を有効にします。PD 対応環境でサブネットの割り当て用に IPv6 プレフィックス委任を有効にするには、True に設定します。CIDR または subnetpool ID を指定せずに IPv6 サブネット用にサブネット作成要求を行うユーザーには、Prefix Delegation メカニズムを介して CIDR が付与されます。PD を有効にすると、デフォルトの IPv6 サブネットプールの動作を上書きすることに注意してください。 |
| ブール値 | 仮想ルーターの HA モードを有効にします。 |
| 文字列値 | l3 HA 管理ネットワークに使用するサブネット。 |
`l3_ha_network_physical_name = ` | 文字列値 | HA ネットワークを作成できる物理ネットワーク名。 |
`l3_ha_network_type = ` | 文字列値 | HA ルーターの HA ネットワークの作成時に使用するネットワーク種別。デフォルトでは、または空の場合は最初の tenant_network_types が使用されます。これは、VRRP トラフィックがデフォルトではない特定のネットワークを使用する場合に役立ちます。 |
| 文字列値 | ロギング設定ファイルの名前。このファイルは、既存のロギング設定ファイルに追加されます。ロギング設定ファイルの詳細は、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 により使用されます。 |
| 整数値 | 許可するアドレスペアの最大数 |
| 整数値 | サブネットごとの DNS ネームサーバーの最大数 |
| 整数値 | 許可されるメッセージヘッダー行の最大サイズ。max_header_line は、大きなトークンを使用する際に増やす必要がある場合があります(特に、keystone が大きなサービスカタログの PKI トークンを使用するように設定された場合に生成されるトークン)。 |
| 整数値 | HA ルーターがスケジュールされる L3 エージェントの最大数。これを 0 に設定すると、ルーターはすべてのエージェントにスケジュールされます。 |
| 整数値 | ローテーションされたログファイルの最大数。 |
| 整数値 | ログファイルの最大サイズ(MB 単位)。「log_rotation_type」が「size」に設定されていない場合は、このオプションは無視されます。 |
| 整数値 | ルーターごとのルートの最大数 |
| 整数値 | サブネットごとのホストルートの最大数 |
`metadata_proxy_group = ` | 文字列値 | グループ (gid または名前) は、初期化後にメタデータプロキシーを実行します (空の場合: agent effective group)。 |
| 文字列値 | メタデータプロキシー UNIX ドメインソケットの場所。 |
`metadata_proxy_user = ` | 文字列値 | ユーザー (uid または名前) の初期化後にメタデータプロキシーを実行する (空の場合: agent effective user)。 |
| ブール値 | DHCP エージェントへの自動スケジューリングネットワークを許可します。 |
| 文字列値 | この文字列は、OpenStack Network API へのリンクで返される通常の URL の前に付けられます。空の場合 (デフォルト)、URL は変更せずに返されます。 |
| 文字列値 | DHCP エージェントへのネットワークのスケジューリングに使用するドライバー |
| ブール値 | ポートデータ (fixed_ips/floatingip) が変更される際に nova に通知を送信し、nova がキャッシュを更新できるようにします。 |
| ブール値 | ポートのステータスが変更になったときに nova に通知を送信する |
| 文字列値 | 単一の応答で返される項目の最大数。値は 無限 または負の整数で制限なしを意味します。 |
| 整数値 | タイムスタンプを減らすために定期的なタスクスケジューラーを開始する際の無作為に遅延する秒数。(0 に設定すると無効になります) |
| 整数値 | 実行中の定期的なタスク間の秒数。 |
| ブール値 | エラーイベントの公開を有効または無効にします。 |
| 整数値 | rate_limit_interval ごとのログ記録されたメッセージの最大数。 |
| 文字列値 | レート制限で使用されるログレベル名:CRITICAL、ERROR、INFO、WARNING、DEBUG または空の文字列。rate_limit_except_level 以上のレベルのログはフィルターされません。空の文字列は、すべてのレベルがフィルターされることを意味します。 |
| 整数値 | ログのレート制限の間隔(秒数)。 |
| 整数値 | リッスンする再試行を続ける秒数 |
| ブール値 | L3 エージェントへのルーターの自動スケジューリングを許可します。 |
| ブール値 | システム全体のフラグ。テナントが作成できるルーターのタイプを判断します。admin のみが上書き可能です。 |
| 文字列値 | デフォルトの L3 エージェントへのルータースケジューリングに使用するドライバー |
| 整数値 | RPC 接続プールのサイズ。 |
| 整数値 | RPC 呼び出しからの応答を待つ最大時間 (秒単位)。 |
| 整数値 | 呼び出しからの応答を待つ秒数。 |
| 整数値 | 状態レポートキュー専用の RPC ワーカープロセスの数。 |
| 整数値 | サービスの RPC ワーカープロセスの数。指定されていない場合、デフォルトは API ワーカー数の半分に等しくなります。 |
| 整数値 | 送信するイベントがある場合は nova にイベントを送信するまでの秒数。 |
| リスト値 | Neutron が使用するサービスプラグイン |
| 文字列値 | 子ワーカーロールに一致するようにプロセス名を設定します。利用可能なオプションは、off (以前の動作を保持)on (プロセスの名前を neutron-server: role (元の文字列) に変更します。brief (rename は on と同じですが、neutron-server: role などの元の文字列はありません。) |
| 文字列値 | Neutron の状態ファイルを保存する場所。このディレクトリーは、エージェントによって書き込み可能である必要があります。 |
| 文字列値 | ログ行を受け取る syslog ファシリティー。このオプションは、log_config_append が設定されている場合は無視されます。 |
| 整数値 | 各サーバーソケットの TCP_KEEPIDLE の値を設定します(秒単位)。OS X では対応していません。 |
| 文字列値 | メッセージングバックエンドに接続するためのネットワークアドレスおよびオプションのユーザー認証情報(URL 形式)。想定される形式は次のとおりです。 driver://[user:pass@]host:port[,[userN:passN@]hostN:portN]/virtual_host?query 例:rabbit://rabbitmq:password@127.0.0.1:5672// URL のフィールドの詳細は、https://docs.openstack.org/oslo.messaging/latest/reference/transport.htmlで oslo_messaging.TransportURL のドキュメントを参照してください。 |
| ブール値 | ロギング用のjournald を有効にします。systemd 環境で実行している場合は、ジャーナルサポートを有効にしたい場合があります。その場合、ログメッセージに加えて構造化されたメタデータが含まれるjournalネイティブプロトコルが使用されます。このオプションは、log_config_append が設定されている場合は無視されます。 |
| ブール値 | ロギングに JSON 形式を使用します。このオプションは、log_config_append が設定されている場合は無視されます。 |
| ブール値 | ロギングに syslog を使用します。既存の syslog 形式は非推奨であり、後に RFC5424 に従うように変更されます。このオプションは、log_config_append が設定されている場合は無視されます。 |
| ブール値 | 出力をWindows イベントログに記録します。 |
| ブール値 | API サーバーでの SSL の有効化 |
| ブール値 | 出力を標準エラーに記録します。このオプションは、log_config_append が設定されている場合は無視されます。 |
| ブール値 | True の場合には、プラグインが VLAN トランスペアレントネットワークの作成に対応していれば、そのタイプのネットワークの作成を許可します。 |
| ブール値 | ファイルシステムを監視するように設計されたログハンドラーを使用します。ログファイルが移動または削除されると、このハンドラーは、指定されたパスで新しいログファイルを即時に開きます。これは、log_file オプションを指定し、Linux プラットフォームが使用される場合にのみ有効です。このオプションは、log_config_append が設定されている場合は無視されます。 |
| 整数値 | wsgi で使用される greenthread のプールのサイズ |
| ブール値 | False の場合は、クライアントのソケット接続を明示的に閉じます。 |
| 文字列値 | ログ行を生成するためにテンプレートとして使用される Python 形式の文字列。client_ip、date_time、request_line、status_code、body_length、wall_seconds をこの形式にフォーマットできます。 |