代理程式組態檔

Broker 組態檔案 (/etc/dcv-session-manager-broker/session-manager-broker.properties) 包含可設定為自訂工作階段管理員功能的參數。您可以使用偏好的文字編輯器來編輯組態檔案。

注意

該/etc/dcv-session-manager-broker/session-manager-broker.properties文件包含敏感數據。根據預設，其寫入存取權限限制為 root，其讀取存取權限僅限於 root 使用者和執行代理程式的使用者。依預設，這是dcvsmbroker使用者。代理程式會在啟動時檢查檔案是否具有預期的權限。

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

參數名稱	必要	預設值	描述
broker-java-home	否		指定代理程式將使用的 Java 主目錄路徑，而非系統預設目錄的路徑。如果設置，代理將<broker-java-home>/bin/java在啟動時使用。 提示：代理需要 Java 運行時環境 11，如果缺少作為成功安裝後的依賴關係，則會安裝它。如果版本 11 未設置為默認 Java 環境，則可以使用以下命令獲取其主目錄： $ sudo alternatives --display java
session-screenshot-max-width	否	160	指定使用擷取的工作階段螢幕擷取畫面的最大寬度 (以像素為單位) GetSessionScreenshotsAPI。
session-screenshot-max-height	否	100	指定使用擷取的工作階段螢幕快照的最大高度 (以像素為單位) GetSessionScreenshotsAPI。
session-screenshot-format	否	png	使用拍攝的工作階段螢幕擷取畫面的影像檔案格式GetSessionScreenshotsAPI。
create-sessions-queue-max-size	否	1000	可排入佇列的未履行CreateSessionsAPI要求數目上限。當佇列已滿時，新的未履行要求會遭到拒絕。
create-sessions-queue-max-time-seconds	否	1800	未滿足的CreateSessionsAPI要求可以保留在佇列中的時間上限 (以秒為單位)。如果請求無法在指定的時間內滿足，則會失敗。
session-manager-working-path	是	/tmp	指定 Broker 寫入操作所需檔案的目錄路徑。此目錄必須僅供代理人存取。
enable-authorization-server	是	true	指定代理程式是否為用來產生用戶端 OAuth 2.0 存取權杖的驗證伺服器APIs。
enable-authorization	是	true	啟用或停用用戶端授權。如果您啟用用戶端授權，用戶端API必須在提出要求時提供存取權杖。API如果您停用用戶端授權，用戶端APIs可以在沒有存取權杖的情況下發出
enable-agent-authorization	是	true	啟用或停用代理程式授權。如果您啟用代理程式授權，則代理程式在與代理程式通訊時必須提供存取 Token。
delete-session-duration-hours	否	1	指定經過多少小時，刪除的工作階段會變成不可見且不再由DescribeSessionAPI呼叫傳回的時數。
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	指定 Broker 繫結用於代理程式連線之主機的 IP 位址。
agent-to-broker-connector-key-store-file	是		指定用於TLS代理程式連線的金鑰存放區。
agent-to-broker-connector-key-store-pass	是		指定金鑰存放區通行證。
broker-to-broker-port	是	47100	指定用於 broker-to-broker 連線的連接埠。
broker-to-broker-bind-host	否	0.0.0.0	指定代理程式繫結 broker-to-broker連線之主機的 IP 位址。
broker-to-broker-discovery-port	是	47500	指定代理程式用來探索彼此的連接埠。
broker-to-broker-discovery-addresses	否		指定叢集中其他代理程式的 IP 位址和連接埠 ip_address:port 格式。如果有多個經紀人，請用逗號分隔值。如果您指定broker-to-broker-discovery-multicast-group、broker-to-broker-discovery-multicast-portbroker-to-broker-discovery-AWS-region、或broker-to-broker-discovery-AWS-alb-target-group-arn，請省略此參數。
broker-to-broker-discovery-multicast-group	否		指定要 broker-to-roker 探索的多點傳送群組。如果您指定broker-to-broker-discovery-addressesbroker-to-broker-discovery-aws-region、或broker-to-broker-discovery-AWS-alb-target-group-arn，請省略此參數。
broker-to-broker-discovery-multicast-port	否		指定要 broker-to-broker 探查的多點傳送連接埠。如果您指定broker-to-broker-discovery-addressesbroker-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-groupbroker-to-broker-discovery-multicast-port、或broker-to-broker-discovery-addresses，請省略此參數。
broker-to-broker-discovery-AWS-alb-target-group-arn	否		要 broker-to-broker 探查ARN的應用程式負載平衡器目標群組使用者。如果您指定broker-to-broker-discovery-multicast-groupbroker-to-broker-discovery-multicast-port、或broker-to-broker-discovery-addresses，請省略此參數。
broker-to-broker-distributed-memory-max-size-mb	否	4096	指定單一代理程式用來儲存NICEDCV工作階段資料的關閉堆積記憶體數量上限。
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。	所以此 AWS 張貼指 CloudWatch 標的區域。
max-api-requests-per-秒	否	1000	指定代理程式 API 在限制之前每秒可處理的要求數目上限。
enable-throttling-forwarded-for-header	否	false	如果設置為true節流，則從 X-福爾-用於頭（如果存在）檢索呼叫者 IP。
create-sessions-number-of-retries-on-failure	否	2	指定在NICEDCV伺服器主機上建立工作階段要求失敗後，要執行的重試次數上限。設定為 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 表的前置詞 (有助於區分使用相同的代理程式叢集的多個代理程式叢集 AWS 帳戶）。只允許字母數字字元、點、破折號和下劃線。
jdbc-connection-url	否	只有在設定enable-persistence為true且persistence-db設定為時才需要mysql。	指定與 MariaB/ 我的SQL資料庫的連線URL；它包含端點和資料庫名稱。網址應該具有以下格式： jdbc:mysql://<db_endpoint>:<db_port>/<db_name>?createDatabaseIfNotExist=true 其中<db_endpoint>是 MariadB/ 我的SQL數據庫端點，<db_port>是數據庫端口，<db_name>是數據庫名稱。
jdbc-user	否	只有在設定enable-persistence為true且persistence-db設定為時才需要mysql。	指定可以存取 MariaB/ SQL 我的資料庫的使用者名稱。
jdbc-password	否	只有在設定enable-persistence為true且persistence-db設定為時才需要mysql。	指定可以存取 MariaB/ SQL 我的資料庫之使用者的密碼。
seconds-before-deleting-unreachable-dcv-server	否	1800	指定從系統中刪除無法連線之伺服器的秒數。