16 juillet 2026

Modifiez les paramètres de connexion de l'URL JDBC dans Omnissa Access

Vous pouvez modifier les paramètres de l'URL de connexion JDBC dans Omnissa Access pour mettre à jour le nom d'hôte du serveur de base de données, le numéro de port ou le nom de la base de données. Cette opération est généralement nécessaire lors de la migration vers un nouveau serveur de base de données, de la modification des ports de base de données à des fins de conformité de la sécurité ou de la mise à jour des configurations de base de données.

Conditions préalables

Accès racine au dispositif Omnissa Access.
Les nouveaux paramètres de connexion à la base de données, tels que le nom d'hôte, le port et le nom de la base de données.
Accessibilité du serveur de base de données depuis le dispositif Omnissa Access sur le nouveau port

Présentation de la structure d'URL de JDBC

La chaîne d'URL JDBC dans Omnissa Access respecte le format spécifique à votre type de base de données :

Microsoft SQL Server

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

PostgreSQL

jdbc:postgresql://hostname:port/database_name

Emplacements des paramètres de connexion

hostname : nom de domaine complet ou adresse IP de votre serveur de base de données
port : numéro de port TCP
- La valeur par défaut est 1433 pour SQL Server.
- La valeur par défaut est 5432 pour PostgreSQL.
database_name : nom de la base de données Omnissa Access

Exemples d'URL JDBC

SQL Server avec port personnalisé : jdbc:sqlserver://dbserver.example.com:14330;databaseName=saasdb
PostgreSQL avec le port par défaut : jdbc:postgresql://dbserver.example.com:5432/saasdb

Procédure

À l'aide d'un client SSH, connectez-vous au dispositif Omnissa Access en tant qu'utilisateur racine.
(Facultatif) Vérifiez la connectivité de la base de données avant d'apporter des modifications :
```
/usr/local/horizon/bin/dbConnCheck '<jdbc_url>' '<db_username>' '<encrypted_password>'
```
Où :
- <jdbc_url> est votre chaîne de connexion JDBC actuelle du fichier runtime-config.properties.
- <db_username> est le nom d'utilisateur de votre base de données (généralement horizon).
- <encrypted_password> est le mot de passe chiffré du paramètre secure.datastore.jdbc.password.
  
  Une connexion réussie affiche SUCCESS: Connection verified.
Ouvrez le fichier de configuration runtime à des fins de modification.
Par exemple :
```
vi /usr/local/horizon/conf/runtime-config.properties
```
Recherchez le paramètre URL JDBC.
Le nom du paramètre varie selon le type de base de données :
- Pour la banque de données principale : datastore.jdbc.url=
- Pour la banque de données SAAS : saas.datastore.jdbc.url=
Modifiez la chaîne d'URL JDBC pour mettre à jour les paramètres de connexion :
- Pour modifier le numéro du port :
  - Recherchez le numéro de port après le nom d'hôte (exemple :1433).
  - Remplacez le par votre nouveau numéro de port (exemple :14330).
- Pour modifier le nom d'hôte :
  - Remplacez la partie du nom d'hôte par le nouveau nom de domaine complet ou la nouvelle adresse IP du serveur.
- Pour modifier le nom de la base de données, mettez à jour le nom de base de données approprié, comme suit :
  - SQL Server : paramètre databaseName=
  - PostgreSQL : nom de la base de données après le / final
    
    Exemple de modification :
    
    De :
```
datastore.jdbc.url=jdbc:sqlserver://oldserver.example.com:1433;databaseName=saasdb
```
À :
```
datastore.jdbc.url=jdbc:sqlserver://newserver.example.com:14330;databaseName=saasdb
```
Vérifiez que l'URL JDBC complète est correcte, y compris les détails suivants :
- Préfixe de protocole (jdbc:sqlserver:// ou jdbc:postgresql://)
- Nom d'hôte ou adresse IP correct
- Numéro de port correct
- Nom de base de données correct
- Syntaxe appropriée pour le type de base de données
Si vous modifiez également le mot de passe de la base de données, mettez à jour le paramètre de mot de passe dans le même fichier :
```
secure.datastore.jdbc.password=encrypted_password
```
Remarque : pour connaître les instructions de chiffrement des mots de passe, reportez-vous à la section Mettre à jour manuellement le mot de passe de la base de données externe et la propriété du mot de passe JDBC dans Omnissa Access.
Enregistrez le fichier runtime-config.properties.
Avant de redémarrer, vérifiez la connectivité réseau au nouveau serveur et au nouveau port de la base de données :
```
telnet new_hostname new_port_number
```
Ou :
```
nc -zv new_hostname new_port_number
```
Redémarrez le service Omnissa Access pour appliquer les modifications :

service horizon-workspace restart

Vérifiez que le service démarre en contrôlant l'état du service :
```
service horizon-workspace status
```
Surveillez les fichiers journaux pour détecter toute erreur de connexion :
```
tail -f /opt/vmware/horizon/workspace/logs/horizon.log
```
Pour les déploiements mis en cluster, répétez toutes les étapes précédentes de cette procédure sur tous les nœuds de votre cluster Omnissa Access.

Vérification

Connectez-vous à la console d'administration d'Omnissa Access.
Accédez au tableau de bord pour vérifier la santé du système.
Vérifiez que la connectivité de la base de données fonctionne correctement.
Testez l'authentification utilisateur et l'accès aux ressources.

Résolution des problèmes

Si le service ne parvient pas à démarrer après avoir apporté des modifications :

Vérifiez que la syntaxe de l'URL JDBC est correcte pour votre type de base de données.
Confirmez que les règles de pare-feu autorisent la connectivité sur le nouveau port.
Vérifiez que le serveur de base de données écoute le port spécifié.
Vérifiez /opt/vmware/horizon/workspace/logs/horizon.log pour détecter des messages d'erreur spécifiques.
Vérifiez que les informations d'identification de la base de données sont toujours valides.

Rubriques connexes

Cette page vous a-t-elle été utile ?