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

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

代理配置文件

Agent 配置文件（Linux 为 /etc/dcv-session-manager-agent/agent.conf，Windows 为 C:\Program Files\NICE\DCVSessionManagerAgent\conf\agent.conf）包含一些参数，可以配置这些参数以自定义 Session Manager 功能。您可以使用常用的文本编辑器编辑配置文件。

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

参数名称 必需 默认值 Description
agent.broker_host 是 指定 Broker 主机的 DNS 名称。
agent.broker_port 是 8445 指定用于与 Broker 通信的端口。
agent.ca_file 否 只有在 tls_strict 设置为 true 时才需要。指定验证 TLS 证书所需的证书（.pem）文件的路径。将自签名证书从 Broker 复制到 Agent。
agent.init_folder 否

  • /var/lib/dcv-session-manager-agent/init（Linux）

 指定主机服务器上的文件夹的路径，用于存储在创建 Amazon DCV 服务器会话时允许对其进行初始化的自定义脚本。您必须指定绝对路径。该文件夹必须是可以访问的，并且这些文件必须可供使用 CreateSessionsAPI InitFile请求参数的用户执行。
agent.tls_strict 否 true 指示是否应使用严格 TLS 验证。
agent.software_statement_path 否 只有在未使用默认软件声明时才需要。指定软件声明文件的路径。有关更多信息，请参阅 generate-software-statement。
agent.tags_folder 否

  • /etc/dcv-session-manager-agent（Linux）

  • C:\Program Files\NICE\DCVSessionManagerAgent\conf\tags (Windows)

 指定标签文件所在文件夹的路径。有关更多信息，请参阅 使用标签定位 Amazon DCV 服务器。
agent.autorun_folder 否

  • /var/lib/dcv-session-manager-agent/autorun（Linux）

  • C:\ProgramData\NICE\DcvSessionManagerAgent\autorun (Windows)

 指定主机服务器上的文件夹的路径，用于存储在会话启动时允许自动运行的脚本和应用程序。您必须指定绝对路径。该文件夹必须是可以访问的，并且这些文件必须可供使用 CreateSessionsAPI AutorunFile请求参数的用户执行。
agent.max_virtual_sessions 否 -1（无限制） 可以使用 Amazon DCV Session Manager 在 Amazon DCV 服务器上创建的最大虚拟会话数量。
agent.max_concurrent_sessions_per_user 否 1 单个用户可以使用 Amazon DCV Session Manager 在 Amazon DCV 服务器上创建的最大虚拟会话数量。
agent.broker_update_interval 否 30 指定将更新的数据发送到 Broker 之前等待的秒数。发送的数据包括 Amazon DCV 服务器和主机状态以及更新的会话信息。较低的值使 Session Manager 更早地发现运行 Agent 的系统上发生的变化，但会增加系统负载和网络流量。较高的值会降低系统和网络负载，但 Session Manager 对系统变化的响应速度变慢，因此不建议使用高于 120 的值。
log.level 否 info 指定日志文件的详细程度。提供了以下详细程度等级：

  • error - 提供最少的详细信息。仅包括错误。

  • warning - 包括错误和警告。

  • info - 默认详细程度。包括错误、警告和信息消息。

  • debug - 提供最多的详细信息。提供有助于调试问题的详细信息。
log.directory 否

  • /var/log/dcv-session-manager-agent/（Linux）

  • C:\ProgramData\NICE\DCVSessionManagerAgent\log (Windows)

 指定在其中创建日志文件的目录。
log.rotation 否 daily 指定日志文件轮换。有效值为：

  • hourly - 每小时轮换一次日志文件。

  • daily - 每天轮换一次日志文件。
log.max-file-size 否 10485760 在日志文件达到指定大小（以字节为单位）时，轮换日志文件。将创建新的日志文件，并将后续日志事件放置在新文件中。
log.rotate 否 9 轮换中保留的最大日志文件数量。每次发生轮换并达到该数量时，将删除最早的日志文件。