16 de julio de 2026

Modificar los parámetros de conexión de la URL de JDBC en Omnissa Access

Puede modificar los parámetros de la URL de conexión de JDBC en Omnissa Access para actualizar el nombre de host del servidor de la base de datos, el número de puerto o el nombre de la base de datos. Esto suele ser necesario cuando se migra a un nuevo servidor de base de datos, se cambian los puertos de la base de datos para cumplir con las normas de seguridad o se actualizan las configuraciones de la base de datos.

Requisitos

Acceso raíz al dispositivo de Omnissa Access.
Los nuevos parámetros de conexión a la base de datos, como el nombre del host, el puerto y el nombre de la base de datos.
Accesibilidad al servidor de base de datos desde el dispositivo de Omnissa Access en el nuevo puerto.

Información sobre la estructura de URL de JDBC

La cadena URL de JDBC en Omnissa Access sigue el formato específico del tipo de base de datos:

Microsoft SQL Server

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

PostgreSQL

jdbc:postgresql://hostname:port/database_name

Ubicaciones de los parámetros de conexión

hostname: el FQDN o la dirección IP del servidor de base de datos
port: el número de puerto TCP
- El valor predeterminado para SQL Server es 1433.
- El valor predeterminado para PostgreSQL es 5432.
database_name: el nombre de la base de datos de Omnissa Access

Ejemplo de URL de JDBC

SQL Server con puerto personalizado: jdbc:sqlserver://dbserver.example.com:14330;databaseName=saasdb
PostgreSQL con puerto predeterminado: jdbc:postgresql://dbserver.example.com:5432/saasdb

Procedimiento

Con un cliente SSH, inicie sesión en el dispositivo Omnissa Access como usuario root.
(Opcional) Compruebe la conectividad de la base de datos antes de realizar cambios:
```
/usr/local/horizon/bin/dbConnCheck '<jdbc_url>' '<db_username>' '<encrypted_password>'
```
Donde:
- <jdbc_url> es la cadena de conexión de JDBC actual del archivo runtime-config.properties.
- <db_username> es el nombre de usuario de la base de datos (normalmente horizon).
- <encrypted_password> es la contraseña cifrada del parámetro secure.datastore.jdbc.password.
  
  Una conexión correcta muestra: SUCCESS: Connection verified.
Abra el archivo de configuración de tiempo de ejecución para editarlo.
Por ejemplo:
```
vi /usr/local/horizon/conf/runtime-config.properties
```
Busque el parámetro de URL de JDBC.
El nombre del parámetro varía según el tipo de base de datos:
- Para el almacén de datos principal: datastore.jdbc.url=
- Para el almacén de datos SAAS: saas.datastore.jdbc.url=
Modifique la cadena de URL de JDBC para actualizar los parámetros de conexión:
- Para cambiar el número de puerto:
  - Busque el número de puerto después del nombre de host (por ejemplo, :1433).
  - Reemplácelo por el nuevo número de puerto (por ejemplo, :14330).
- Para cambiar el nombre de host:
  - Reemplace la parte del nombre de host por la nueva dirección IP o el nuevo FQDN del servidor.
- Para cambiar el nombre de la base de datos, actualícelo de la siguiente forma:
  - SQL Server: el parámetro databaseName=
  - PostgreSQL: el nombre de la base de datos después del final /
    
    Ejemplo de cambio:
    
    Desde:
```
datastore.jdbc.url=jdbc:sqlserver://oldserver.example.com:1433;databaseName=saasdb
```
A:
```
datastore.jdbc.url=jdbc:sqlserver://newserver.example.com:14330;databaseName=saasdb
```
Compruebe que la URL de JDBC completa sea correcta, incluidos los siguientes detalles:
- Prefijo de protocolo (jdbc:sqlserver:// o jdbc:postgresql://)
- Nombre de host o dirección IP correctos
- Número de puerto correcto
- Nombre de base de datos correcto
- Sintaxis adecuada para el tipo de base de datos
Si también va a cambiar la contraseña de la base de datos, actualice el parámetro de contraseña en el mismo archivo:
```
secure.datastore.jdbc.password=encrypted_password
```
Nota: Consulte instrucciones sobre el cifrado de contraseñas en Actualizar manualmente la contraseña de la base de datos externa y actualizar la propiedad de contraseña de JDBC en Omnissa Access.
Guarde el archivo runtime-config.properties.
Antes de reiniciar, compruebe la conectividad de red con el nuevo servidor de base de datos y el puerto:
```
telnet new_hostname new_port_number
```
O bien:
```
nc -zv new_hostname new_port_number
```
Reinicie el servicio Omnissa Access para aplicar los cambios:

service horizon-workspace restart

Compruebe el estado del servicio para verificar que se inició correctamente:
```
service horizon-workspace status
```
Comprueba si hay errores de conexión en los archivos de registro:
```
tail -f /opt/vmware/horizon/workspace/logs/horizon.log
```
Para implementaciones en clúster, repita los pasos de este procedimiento en todos los nodos del clúster de Omnissa Access.

Verificación

Inicie sesión en la consola de administración de Omnissa Access.
Desplácese hasta el panel de control para comprobar el estado del sistema.
Confirme que la conectividad de la base de datos funciona correctamente.
Pruebe la autenticación de usuarios y el acceso a los recursos.

Solucionar problemas

Si el servicio no se inicia después de realizar cambios:

Compruebe que la sintaxis de la URL de JDBC sea correcta para el tipo de base de datos.
Confirme que las reglas de firewall permiten la conectividad en el nuevo puerto.
Compruebe que el servidor de base de datos esté escuchando en el puerto especificado.
Revise /opt/vmware/horizon/workspace/logs/horizon.log para comprobar si hay mensajes de error específicos.
Compruebe que las credenciales de la base de datos siguen siendo válidas.

Temas relacionados

¿Le resultó útil esta página?