在 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

连接参数位置

• 主机名：数据库服务器的 FQDN 或 IP 地址
• 端口：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

过程

1. 使用 SSH 客户端，以 root 用户身份登录到 Omnissa Access 设备。

2. （可选）在进行更改之前验证数据库连接：

   /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。

3. 打开运行时配置文件进行编辑。
   例如：

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

4. 找到 JDBC URL 参数。
   参数名称因数据库类型而异：
   

   • 对于主数据存储：datastore.jdbc.url=
   • 对于 SAAS 数据存储：saas.datastore.jdbc.url=

5. 修改 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
   

6. 确认完整的 JDBC URL 正确无误，包括以下详细信息：

   • 协议前缀（jdbc:sqlserver:// 或 jdbc:postgresql://）
   • 正确的主机名或 IP 地址
   • 正确的端口号
   • 正确的数据库名称
   • 适用于数据库类型的语法

7. 如果还要更改数据库密码，请更新同一文件中的 password 参数：

   secure.datastore.jdbc.password=encrypted_password
   

   **注意：**有关密码加密说明，请参阅在 Omnissa Access 中手动更新外部数据库密码并更新 JDBC 密码属性。

8. 保存 runtime-config.properties 文件。

9. 在重新启动之前，请验证与新数据库服务器和端口的网络连接：

   telnet new_hostname new_port_number
   

   或：
   

   nc -zv new_hostname new_port_number
   

10. 重新启动 Omnissa Access 服务以应用更改：

service horizon-workspace restart

11. 通过检查服务状态验证服务是否成功启动：

    service horizon-workspace status
    

12. 监控日志文件以确定是否存在任何连接错误：

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

13. 对于集群式部署，请在 Omnissa Access 集群中的所有节点上重复此过程中的所有上述步骤。
    

验证

1. 登录 Omnissa Access 管理控制台。
2. 导航到“仪表板”以验证系统运行状况。
3. 确认数据库连接正常运行。
4. 测试用户身份验证和资源访问权限。

故障排除

如果在进行更改后服务无法启动，请执行以下操作：

• 确认 JDBC URL 语法是适用于数据库类型的正确语法。
• 确认防火墙规则允许新端口上的连接。
• 检查数据库服务器是否正在侦听指定的端口。
• 查看 /opt/vmware/horizon/workspace/logs/horizon.log 以确定是否存在特定的错误消息。
• 确认数据库凭据仍然有效。

相关主题

• 在 Omnissa Access 中手动更新外部数据库密码并更新 JDBC 密码属性
• 管理 Omnissa Access 外部数据库设置
• 创建 Omnissa Access 服务数据库