Broker 配置文件 - NICE DCV Session Manager
Amazon Web Services 文档中描述的 Amazon Web Services 服务或功能可能因区域而异。要查看适用于中国区域的差异，请参阅 中国的 Amazon Web Services 服务入门 (PDF)。

本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

Broker 配置文件

Broker 配置文件 (/etc/dcv-session-manager-broker/session-manager-broker.properties) 包含一些参数，可以配置这些参数以自定义 Session Manager 功能。您可以使用常用的文本编辑器编辑配置文件。

注意

/etc/dcv-session-manager-broker/session-manager-broker.properties 文件包含敏感数据。默认情况下，其写入访问权限限制为根用户，其读取访问权限限制为根用户和运行 Broker 的用户。默认情况下，这是 dcvsmbroker 用户。Broker 在启动时检查文件是否具有预期的权限。

下表列出了 Broker 配置文件中的参数。

参数名称 必填 默认值 描述
broker-java-home 否 指定 Broker 将使用的 Java 主目录的路径，而不是系统默认目录的路径。如果已设置，Broker 将在启动时使用 <broker-java-home>/bin/java。

提示：Broker 需要使用 Java Runtime Environment 11；如果缺少该环境，在成功安装 Broker 时，它将其作为依赖项进行安装。如果版本 11 未设置为默认 Java 环境，可以使用以下命令获取其主目录：

$ sudo alternatives --display java
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 指定 Broker 将运行所需的文件写入到的目录路径。只能由 Broker 访问该目录。
enable-authorization-server 是 true 指定 Broker 是否为用于为客户端 API 生成 OAuth 2.0 访问令牌的身份验证服务器。
enable-authorization 是 true 启用或禁用客户端授权。如果启用客户端授权，则客户端 API 在发出 API 请求时必须提供访问令牌。如果禁用客户端授权，客户端 API 可以在没有访问令牌的情况下发出请求。
enable-agent-authorization 是 true 启用或禁用 Agent 授权。如果启用 Agent 授权，Agent 在与 Broker 通信时必须提供访问令牌。
delete-session-duration-hours 否 1 指定在经过多少小时后，删除的会话变得不可见，并且 DescribeSession API 调用不再返回这些会话。
connect-session-token-duration-minutes 否 60 指定 ConnectSession 令牌保持有效的分钟数。
client-to-broker-connector-https-port 是 8443 指定 Broker 侦听客户端连接的 HTTPS 端口。
client-to-broker-connector-bind-host 否 0.0.0.0 指定 Broker 为客户端连接绑定的主机的 IP 地址。
client-to-broker-connector-key-store-file 是 指定用于 TLS 客户端连接的密钥存储。
client-to-broker-connector-key-store-pass 是 指定密钥存储密码。
agent-to-broker-connector-https-port 是 8445 指定 Broker 侦听 Agent 连接的 HTTPS 端口。
agent-to-broker-connector-bind-host 否 0.0.0.0 指定 Broker 为 Agent 连接绑定的主机的 IP 地址。
agent-to-broker-connector-key-store-file 是 指定用于 TLS Agent 连接的密钥存储。
agent-to-broker-connector-key-store-pass 是 指定密钥存储密码。
broker-to-broker-port 是 47100 指定用于 Broker 到 Broker 连接的端口。
broker-to-broker-bind-host 否 0.0.0.0 指定 Broker 为 Broker 到 Broker 连接绑定的主机的 IP 地址。
broker-to-broker-discovery-port 是 47500 指定 Broker 用于发现对方的端口。
broker-to-broker-discovery-addresses 否 以 ip_address:port 格式指定一组 Broker 中的其他 Broker 的 IP 地址和端口。如果有多个 Broker，请使用逗号分隔这些值。如果指定 broker-to-broker-discovery-multicast-group、broker-to-broker-discovery-multicast-port、broker-to-broker-discovery-Amazon-region 或 broker-to-broker-discovery-Amazon-alb-target-group-arn，则省略该参数。
broker-to-broker-discovery-multicast-group 否 指定用于 Broker 到 Broker 发现的组播组。如果指定 broker-to-broker-discovery-addresses、broker-to-broker-discovery-aws-region 或 broker-to-broker-discovery-Amazon-alb-target-group-arn，则省略该参数。
broker-to-broker-discovery-multicast-port 否 指定用于 Broker 到 Broker 发现的组播端口。如果指定 broker-to-broker-discovery-addresses、broker-to-broker-discovery-Amazon-region 或 broker-to-broker-discovery-Amazon-alb-target-group-arn，则省略该参数。
broker-to-broker-discovery-Amazon-region 否 指定用于 Broker 到 Broker 发现的 Application Load Balancer 的 Amazon 区域。如果指定 broker-to-broker-discovery-multicast-group、broker-to-broker-discovery-multicast-port 或 broker-to-broker-discovery-addresses，则省略该参数。
broker-to-broker-discovery-Amazon-alb-target-group-arn 否 用于 Broker 到 Broker 发现的 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 指定单个 Broker 用于存储 NICE DCV 会话数据的最大堆外内存量。
broker-to-broker-key-store-file 是 指定用于 TLS Broker 连接的密钥存储。
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 时才需要。如果 Broker 安装在 Amazon EC2 实例上，则会从 IMDS 中检索区域。 在其中发布 CloudWatch 指标的 Amazon 区域。
max-api-requests-per-second 否 1000 指定 Broker API 在受到限制之前每秒可以处理的最大请求数。
enable-throttling-forwarded-for-header 否 false 如果设置为 true，则限制功能从 X-Forwared-For 标头（如果存在）中检索调用方 IP。
create-sessions-number-of-retries-on-failure 否 2 指定 NICE DCV 服务器主机上的创建会话请求失败后执行的最大重试次数。设置为 0 表示从不在失败时执行重试。
autorun-file-arguments-max-size 否 50 指定可以传递给自动运行文件的最大参数数量。
autorun-file-arguments-max-argument-length 否 150 指定每个自动运行文件参数的最大长度（字符数）。
enable-persistence 是 false 如果设置为 true，Broker 状态数据将持久保留在外部数据库中。
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 的更多信息，请参阅预置容量的定价。
dynamodb-table-wcu 否 只有在 enable-persistence 设置为 true 并且 persistence-db 设置为 dynamodb 时才需要。 指定每个 DynamoDB 表的写入容量单位 (WCU)。有关 WCU 的更多信息，请参阅预置容量的定价。
dynamodb-table-name-prefix 否 只有在 enable-persistence 设置为 true 并且 persistence-db 设置为 dynamodb 时才需要。 指定添加到每个 DynamoDB 表的前缀（用于区分使用同一 Amazon 账户的多个 Broker 集群）。仅允许使用字母数字字符、圆点、短划线和下划线。
jdbc-connection-url 否 只有在 enable-persistence 设置为 true 并且 persistence-db 设置为 mysql 时才需要。 指定 MariaDB/MySQL 数据库的连接 URL；它包含终端节点和数据库名称。该 URL 应采用以下格式：
jdbc:mysql://<db_endpoint>:<db_port>/<db_name>?createDatabaseIfNotExist=true
其中 <db_endpoint> 是 MariaDB/MySQL 数据库终端节点，<db_port> 是数据库端口，<db_name> 是数据库名称。
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 指定从系统中删除无法访问的服务器之前经过的秒数。