2026 年 7 月 16 日

修改 Omnissa Access 中的 JDBC URL 連線參數

您可以在 Omnissa Access 中修改 JDBC 連線 URL 參數，以更新資料庫伺服器主機名稱、連接埠號碼或資料庫名稱。這通常在下列情況下需要執行：移轉至新的資料庫伺服器、為符合安全性合規要求而變更資料庫連接埠，或更新資料庫組態。

先決條件

對 Omnissa Access 應用裝置的 root 存取權。
新的資料庫連線參數，例如主機名稱、連接埠和資料庫名稱。
確認 Omnissa Access 應用裝置可透過新的連接埠存取資料庫伺服器

瞭解 JDBC URL 結構

Omnissa Access 中的 JDBC URL 字串會遵循與您的資料庫類型相對應的格式：

Microsoft SQL Server

jdbc:sqlserver://hostname:port;databaseName=database_name

PostgreSQL

jdbc:postgresql://hostname:port/database_name

連線參數位置

hostname：資料庫伺服器的 FQDN 或 IP 位址
port：TCP 連接埠號碼
- SQL Server 的預設值為 1433。
- PostgreSQL 的預設值為 5432。
database_name：Omnissa Access 資料庫的名稱

JDBC URL 範例

使用自訂連接埠的 SQL Server：jdbc:sqlserver://dbserver.example.com:14330;databaseName=saasdb
使用預設連接埠的 PostgreSQL：jdbc:postgresql://dbserver.example.com:5432/saasdb

程序

使用 SSH 用戶端，以 root 使用者身分登入 Omnissa Access 應用裝置。
(選用) 變更前先驗證資料庫連線能力：
```
/usr/local/horizon/bin/dbConnCheck '<jdbc_url>' '<db_username>' '<encrypted_password>'
```
其中：
- <jdbc_url> 是您從 runtime-config.properties 檔案取得的目前 JDBC 連線字串。
- <db_username> 是您的資料庫使用者名稱 (通常為 horizon)。
- <encrypted_password> 是 secure.datastore.jdbc.password 參數中的加密密碼。
  
  連線成功時會顯示：SUCCESS: Connection verified。

開啟執行階段組態檔以進行編輯。
例如：

vi /usr/local/horizon/conf/runtime-config.properties

找到 JDBC URL 參數。
參數名稱會因資料庫類型而異：
- 針對主要資料存放區：datastore.jdbc.url=
- 針對 SAAS 資料存放區：saas.datastore.jdbc.url=
修改 JDBC URL 字串以更新連線參數：
- 若要變更連接埠號碼：
  - 找出主機名稱後面的連接埠號碼 (例如 :1433)。
  - 將其取代為新的連接埠號碼 (例如 :14330)。
- 若要變更主機名稱：
  - 將主機名稱部分取代為新伺服器的 FQDN 或 IP 位址。
- 若要變更資料庫名稱，請更新對應的資料庫名稱，如下所示：
  - SQL Server：databaseName= 參數
  - **PostgreSQL：**最後一個 / 後面的資料庫名稱
    
    變更範例：
    
    從：
```
datastore.jdbc.url=jdbc:sqlserver://oldserver.example.com:1433;databaseName=saasdb
```
收件者：
```
datastore.jdbc.url=jdbc:sqlserver://newserver.example.com:14330;databaseName=saasdb
```
確認完整的 JDBC URL 正確無誤，並包含下列詳細資料：
- 通訊協定首碼 (jdbc:sqlserver:// 或 jdbc:postgresql://)
- 正確的主機名稱或 IP 位址
- 正確的連接埠號碼
- 正確的資料庫名稱
- 資料庫類型的正確語法
如果您也要變更資料庫密碼，請在同一個檔案中更新密碼參數：
```
secure.datastore.jdbc.password=encrypted_password
```
**附註：**如需密碼加密指示，請參閱在 Omnissa Access 中手動更新外部資料庫密碼並更新 JDBC 密碼屬性。
儲存 runtime-config.properties 檔案。
重新啟動之前，請先驗證與新資料庫伺服器及其連接埠的網路連線能力：
```
telnet new_hostname new_port_number
```
或者：
```
nc -zv new_hostname new_port_number
```
重新啟動 Omnissa Access 服務以套用變更：

service horizon-workspace restart

檢查服務狀態以確認服務已成功啟動：
```
service horizon-workspace status
```

監控記錄檔以查看是否有任何連線錯誤：

tail -f /opt/vmware/horizon/workspace/logs/horizon.log

對於叢集式部署，請在 Omnissa Access 叢集的所有節點上重複執行本程序前述的所有步驟。

驗證

登入 Omnissa Access 管理主控台。
導覽至儀表板以確認系統健全狀況。
確認資料庫連線運作正常。
測試使用者驗證與資源存取。

疑難排解

如果在完成變更後服務無法啟動：

確認 JDBC URL 語法符合您的資料庫類型。
確認防火牆規則允許透過新的連接埠進行連線。
檢查資料庫伺服器是否正在指定的連接埠上進行接聽。
檢閱 /opt/vmware/horizon/workspace/logs/horizon.log 以查看特定的錯誤訊息。
確認資料庫認證資料仍有效。