代理程式組態檔案 - Amazon DCV Session Manager

本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

代理程式組態檔案

代理程式組態檔案 (/etc/dcv-session-manager-agent/agent.conf適用於 Linux 和 macOS，C:\Program Files\NICE\DCVSessionManagerAgent\conf\agent.conf適用於 Windows) 包含可設定為自訂 Session Manager 功能的參數。您可以使用偏好的文字編輯器編輯組態檔案。

下表列出代理程式組態檔案中的參數。

參數名稱 必要 預設值 Description
agent.broker_host 是 指定代理程式主機的 DNS 名稱。
agent.broker_port 是 8445 指定要與代理程式通訊的連接埠。
agent.ca_file 否 只有在 tls_strict 設定為 時才需要true。指定驗證 TLS 憑證所需的憑證 (.pem) 檔案路徑。將自我簽署憑證從代理程式複製到代理程式。
agent.init_folder 否

  • /var/lib/dcv-session-manager-agent/init (Linux)

 指定主機伺服器上資料夾的路徑，用於存放建立 Amazon DCV 伺服器工作階段時允許初始化的自訂指令碼。您必須指定絕對路徑。資料夾必須可供存取，且檔案必須可供使用 CreateSessions API 的 InitFile 請求參數的使用者執行。
agent.tls_strict 否 true 指出是否應使用嚴格的 TLS 驗證。
agent.software_statement_path 否 只有在不使用預設軟體陳述式時才需要。指定軟體陳述式檔案的路徑。如需詳細資訊，請參閱generate-software-statement。
agent.tags_folder 否

  • /etc/dcv-session-manager-agent (Linux/macOS)

  • 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)

 指定主機伺服器上資料夾的路徑，用於存放允許在工作階段啟動時自動執行的指令碼和應用程式。您必須指定絕對路徑。資料夾必須可供存取，且檔案必須可供使用 CreateSessions API 的 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 指定傳送更新後的資料至代理程式前所等待的秒數。傳送的資料包括 Amazon DCV 伺服器和主機狀態，以及更新的工作階段資訊。較低的值可讓 Session Manager 更清楚代理程式執行所在系統發生的變化，但會增加系統負載和網路流量。較高的值可減少系統和網路負載，但 Session Manager 對系統變更的回應較少，因此120不建議高於 的值。
agent.enable_query_logged_in_users 否 true 啟用在 Windows 上取得記錄的使用者。為 true 時， 會查詢系統的實際登入使用者。當 false 時， 會傳回「未知」
log.level 否 info 指定日誌檔案的詳細程度。可用的詳細資訊等級如下：

  • error- 提供最少的詳細資訊。僅包含錯誤。

  • warning- 包含錯誤和警告。

  • info- 預設詳細程度。包含錯誤、警告和資訊訊息。

  • debug- 提供最詳細的資訊。提供有助於偵錯問題的詳細資訊。
log.directory 否

  • /var/log/dcv-session-manager-agent/ (Linux/macOS)

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

 指定要在其中建立日誌檔案的目錄。
log.rotation 否 daily 指定日誌檔案輪換。有效的值如下：

  • hourly- 每小時輪換日誌檔案。

  • daily- 日誌檔案每天輪換。
log.max-file-size 否 10485760 當日誌檔案大小達到指定的位元組大小時，它將被輪換。將建立新的日誌檔案，並將進一步的日誌事件放置在新的檔案中。
log.rotate 否 9 輪換中保留的日誌檔案數目上限。每次輪換發生且達到此數字時，都會刪除最舊的日誌檔案。