翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

# ブローカー設定ファイル
<a name="broker-file"></a>

ブローカー設定ファイル (`/etc/dcv-session-manager-broker/session-manager-broker.properties`) には、セッションマネージャー機能をカスタマイズするために設定できるパラメータが含まれています。希望するテキストエディタを使用して設定ファイルを手動で編集することができます。

**注記**  
`/etc/dcv-session-manager-broker/session-manager-broker.properties` ファイルには機密データが含まれています。デフォルトでは、書き込みアクセスはルートに制限され、読み取りアクセスはルートおよびブローカーを実行しているユーザーに制限されます。デフォルトでは、これは `dcvsmbroker` ユーザーです。ブローカーの起動時に、期待される許可がファイルに含まれていることが確認されます。

下表にブローカー設定ファイルのパラメータを示します。


| パラメータ名 | 必須 | デフォルトの値 | 説明 | 
| --- | --- | --- | --- | 
| broker-java-home | いいえ |  | ブローカーがシステムのデフォルトディレクトリの代わりに使用する Java ホームディレクトリのパスを指定します。設定すると、ブローカーは起動時に <broker-java-home>/bin/java を使用します。 **ヒント**: ブローカーには Java ランタイム環境 11 が必要であり、インストールが成功したときに依存関係として欠落している場合はインストールされます。バージョン 11 がデフォルトの Java 環境として設定されていない場合は、以下のコマンドを使用してホームディレクトリを取得できます。 <pre>$ sudo alternatives --display java</pre>  | 
| session-screenshot-max-width | いいえ | 160 | GetSessionScreenshots API を使用して、セッションスクリーンショットの最大幅 (ピクセル単位) を指定します。 | 
| session-screenshot-max-height | いいえ | 100 | GetSessionScreenshots API を使用して、セッションスクリーンショットの最大高さ (ピクセル単位) を指定します。 | 
| session-screenshot-format | いいえ | png | GetSessionScreenshots API を使用して撮影したセッションスクリーンショットのイメージファイル形式です。 | 
| create-sessions-queue-max-size | いいえ | 1000 | キューに入る可能性がある未処理の CreateSessions API リクエストの最大数です。キューがいっぱいになると、新たな未処理リクエストは拒否されます。 | 
| create-sessions-queue-max-time-seconds | いいえ | 1800 | 未処理の CreateSessions API リクエストがキューに残留できる最長時間 (秒) です。リクエストは、指定時間内に処理されないと失敗します。 | 
| session-manager-working-path | はい | /tmp | 操作に必要なファイルがブローカーにより書き込まれるディレクトリへのパスを指定します。このディレクトリにはブローカーしかアクセスできません。 | 
| enable-authorization-server | はい | true | ブローカーをクライアント API の OAuth 2.0 アクセストークンの生成に使用される認証サーバーにするかどうかを指定します。 | 
| enable-authorization | はい | true | クライアント認可を有効または無効にします。クライアント認可を有効にした場合、API リクエストの実行時にクライアント API からアクセストークンが提供される必要があります。クライアント認可を無効にすると、クライアント API によりアクセストークンなしでリクエストが実行されます。 | 
| enable-agent-authorization | はい | true | エージェント認可を有効または無効にします。エージェント認可を有効にした場合、ブローカーとの通信時にエージェントからアクセストークンが提供される必要があります。 | 
| delete-session-duration-hours | いいえ | 1 | 削除されたセッションが非表示になって DescribeSession API コールによって返されなくなるまでの時間数を指定します。廃止: delete-session-duration-hours は delete-session-duration-seconds へ変更されます。バージョン 2024.0-493 から利用可能です。 | 
| delete-session-duration-seconds | いいえ | 3600 | 削除されたセッションが非表示になって DescribeSession API コールによって返されなくなるまでの秒数を指定します。このパラメータは、廃止された delete-session-duration-hours パラメータと置き換わります。バージョン 2024.0-493 以降で利用可能です。 | 
| connect-session-token-duration-minutes | いいえ | 60 | ConnectSession トークンの有効状態が維持される時間を分単位で指定します。 | 
| client-to-broker-connector-https-port | はい | 8443 | ブローカーによりクライアント接続に対してリッスンされる HTTPS ポートを指定します。 | 
| client-to-broker-connector-bind-host | いいえ | 0.0.0.0 | ブローカーによりクライアント接続に対してバインドされるホストの IP アドレスを指定します。 | 
| client-to-broker-connector-key-store-file | はい |  | TLS クライアント接続に使用されるキーストアを指定します。 | 
| client-to-broker-connector-key-store-pass | はい |  | キーストアのパスを指定します。 | 
| agent-to-broker-connector-https-port | はい | 8445 | ブローカーによりエージェント接続に対してリッスンされる HTTPS ポートを指定します。 | 
| agent-to-broker-connector-bind-host | いいえ | 0.0.0.0 | ブローカーによりエージェント接続に対してバインドされるホストの IP アドレスを指定します。 | 
| agent-to-broker-connector-key-store-file | はい |  | TLS エージェント接続に使用するキーストアを指定します。 | 
| agent-to-broker-connector-key-store-pass | はい |  | キーストアのパスを指定します。 | 
| broker-to-broker-port | はい | 47100 | ブローカー間接続に使用するポートを指定します。 | 
| broker-to-broker-bind-host | いいえ | 0.0.0.0 | ブローカーによりブローカー間接続に対してバインドされるホストの IP アドレスを指定します。 | 
| broker-to-broker-discovery-port | はい | 47500 | ブローカーの相互検出に使用するポートを指定します。 | 
| broker-to-broker-discovery-addresses | いいえ |  | フリート内の他のブローカーの IP アドレスとポートを ip\$1address:port 形式で指定します。ブローカーが複数ある場合は、値をカンマで区切ります。broker-to-broker-discovery-multicast-group、broker-to-broker-discovery-multicast-port、broker-to-broker-discovery-AWS-region、 または broker-to-broker-discovery-AWS-alb-target-group-arn を指定した場合は、このパラメータを省略します。 | 
| broker-to-broker-discovery-multicast-group | いいえ |  | ブローカー間検出用のマルチキャストグループを指定します。broker-to-broker-discovery-addresses、broker-to-broker-discovery-aws-region、または broker-to-broker-discovery-AWS-alb-target-group-arn を指定した場合は、このパラメータを省略します。 | 
| broker-to-broker-discovery-multicast-port | いいえ |  | ブローカー間検出用のマルチキャストポートを指定します。broker-to-broker-discovery-addresses、broker-to-broker-discovery-AWS-region、または broker-to-broker-discovery-AWS-alb-target-group-arn を指定した場合は、このパラメータを省略します。 | 
| broker-to-broker-discovery-AWS-region | いいえ |  | ブローカーからブローカーへの検出に使用されるアプリケーションロードバランサーの AWS リージョンを指定します。broker-to-broker-discovery-multicast-group、broker-to-broker-discovery-multicast-port、または broker-to-broker-discovery-addresses を指定した場合は、このパラメータを省略します。 | 
| broker-to-broker-discovery-AWS-alb-target-group-arn | いいえ |  | ブローカー間検出に使用する Application Load Balancer ターゲットグループの ARN です。broker-to-broker-discovery-multicast-group、broker-to-broker-discovery-multicast-port、または broker-to-broker-discovery-addresses を指定した場合は、このパラメータを省略します。 | 
| broker-to-broker-distributed-memory-max-size-mb | いいえ | 4096 | Amazon DCV セッションデータを保存するために単一ブローカーによって使用されるオフヒープメモリの最大量を指定します。 | 
| broker-to-broker-key-store-file | はい |  | TLS ブローカー接続に使用するキーストアを指定します。 | 
| broker-to-broker-key-store-pass | はい |  | キーストアのパスを指定します。 | 
| enable-cloud-watch-metrics | いいえ | false | Amazon CloudWatch メトリクスを有効または無効にします。CloudWatch メトリクスを有効にした場合は、cloud-watch-region に対して値を指定する必要があります。 | 
| cloud-watch-region | いいえ | enable-cloud-watch-metrics が true に設定されている場合のみ必須です。ブローカーが Amazon EC2 インスタンスにインストールされている場合、リージョンは IMDS から取得されます。 | CloudWatch メトリクスが投稿される AWS リージョン。 | 
| max-api-requests-per-second | いいえ | 1000 | ブローカー API がスロットリングされる前に 1 秒間で処理できるリクエストの最大数を指定します。 | 
| enable-throttling-forwarded-for-header | いいえ | false | true に設定されている場合、スロットリングにより X-Forwared-For ヘッダー (存在する場合) から発信者 IP が検索されます。 | 
| create-sessions-number-of-retries-on-failure | いいえ | 2 | Amazon DCV サーバーホストでセッション作成リクエストが失敗した場合、その後に実行される再試行回数の上限を指定します。失敗時に再試行されないようにする場合は 0 に設定します。 | 
| autorun-file-arguments-max-size | いいえ | 50 | 自動実行ファイルに渡される引数の最大数を指定します。 | 
| autorun-file-arguments-max-argument-length | いいえ | 150 | 各自動実行ファイルの最大長を文字数で指定します。 | 
| enable-persistence | はい | false | true に設定されている場合、ブローカーのステータスデータは外部データベースに残されます。 | 
| persistence-db | いいえ | enable-persistence が true に設定されている場合のみ必須です。 | 残存のために使用するデータベースを指定します。サポートされる値は dynamodb と mysql のみです。 | 
| dynamodb-region | いいえ | enable-persistence が true に設定されて persistence-db が dynamodb に設定されている場合のみ必須です。 | DynamoDB テーブルの作成とアクセスが実行されるリージョンを指定します。 | 
| dynamodb-table-rcu | いいえ | enable-persistence が true に設定されて persistence-db が dynamodb に設定されている場合のみ必須です。 | 各 DynamoDB テーブルの読み取りキャパシティーユニット (RCU) を指定します。RCU の詳細については、「[プロビジョンドキャパシティーの料金](https://aws.amazon.com/dynamodb/pricing/provisioned/)」を参照してください。 | 
| dynamodb-table-wcu | いいえ | enable-persistence が true に設定されて persistence-db が dynamodb に設定されている場合のみ必須です。 | 各 DynamoDB テーブルの書き込みキャパシティーユニット (WCU) を指定します。WCU の詳しい情報については、「[プロビジョンドキャパシティーの料金](https://aws.amazon.com/dynamodb/pricing/provisioned/)」を参照してください。 | 
| dynamodb-table-name-prefix | いいえ | enable-persistence が true に設定されて persistence-db が dynamodb に設定されている場合のみ必須です。 | 各 DynamoDB テーブルに追加するプレフィックスを指定します (同じ AWS アカウントを使用して複数のブローカークラスターを区別するのに役立ちます）。英数字、ドット、ダッシュ、下線のみを使用できます。 | 
| jdbc-connection-url | いいえ | enable-persistence が true に設定されて persistence-db が mysql に設定されている場合のみ必須です。 | MariaDB/MySQL データベースへの接続 URL を指定します。このデータベースには、エンドポイントとデータベース名が含まれます。URL は次の形式とします: <pre>jdbc:mysql://<db_endpoint>:<db_port>/<db_name>?createDatabaseIfNotExist=true</pre> <db\$1endpoint> が MariaDB/MySQL データベースエンドポイントである場合、<db\$1port> はデータベースポートになり、<db\$1name> はデータベース名になります。 | 
| jdbc-user | いいえ | enable-persistence が true に設定されて persistence-db が mysql に設定されている場合のみ必須です。 | MariaDB/MySQL データベースにアクセスできるユーザーの名前を指定します。 | 
| jdbc-password | いいえ | enable-persistence が true に設定されて persistence-db が mysql に設定されている場合のみ必須です。 | MariaDB/MySQL データベースにアクセスできるユーザーのパスワードを指定します。 | 
| seconds-before-deleting-unreachable-dcv-server | いいえ | 1800 | アクセスできない Amazon DCV サーバーがシステムから削除されるまでの秒数を指定します。 | 
| seconds-before-deleting-sessions-unreachable-server | いいえ |  | アクセスできない Amazon DCV サーバーのセッションがシステムから削除されるまでの秒数を指定します。アクセスできないサーバーからのセッションの削除は、デフォルトで無効になっています。アクセスできないサーバーからのセッションの削除を有効にするには、有効な値を指定します。 | 
| session-screenshot-max-width | いいえ | 160 | [GetSessionScreenshots](https://docs.aws.amazon.com/dcv/latest/sm-dev/GetSessionScreenshots.html) API を使用して、セッションスクリーンショットの最大幅 (ピクセル単位) を指定します。session-screenshot-max-width が[ウェブクライアント設定ファイル](https://docs.aws.amazon.com/dcv/latest/access-console/web-client-config-files.html)で設定されている場合は優先され、このデフォルト値が上書きされます。なお、これは最大幅であるため、実際のスクリーンショット解像度は低くなる可能性があります。 | 
| session-screenshot-max-height | いいえ | 100 | [GetSessionScreenshots](https://docs.aws.amazon.com/dcv/latest/sm-dev/GetSessionScreenshots.html) API を使用して、セッションスクリーンショットの最大高さ (ピクセル単位) を指定します。session-screenshot-max-height が[ウェブクライアント設定ファイル](https://docs.aws.amazon.com/dcv/latest/access-console/web-client-config-files.html)で設定されている場合は優先され、このデフォルト値が上書きされます。なお、これは最大高さであるため、実際のスクリーンショット解像度は低くなる可能性があります。 |