16. Juli 2026

Ändern der JDBC-URL-Verbindungsparameter in Omnissa Access

Sie können die URL-Parameter der JDBC-Verbindung in Omnissa Access ändern, um den Hostnamen des Datenbankservers, die Portnummer oder den Datenbanknamen zu aktualisieren. Dies ist in der Regel erforderlich, wenn Sie zu einem neuen Datenbankserver migrieren, Datenbankports zur Sicherheitsübereinstimmung ändern oder Datenbankkonfigurationen aktualisieren.

Voraussetzungen

Root-Zugriff auf die Omnissa Access-Appliance.
Die neuen Datenbankverbindungsparameter, wie z. B. Hostname, Port und Datenbankname.
Zugriff auf den Datenbankserver über die Omnissa Access-Appliance auf dem neuen Port

Grundlegendes zur JDBC-URL-Struktur

Die JDBC-URL-Zeichenfolge in Omnissa Access verwendet das für Ihren Datenbanktyp spezifische Format:

Microsoft SQL Server

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

PostgreSQL

jdbc:postgresql://hostname:port/database_name

Speicherorte der Verbindungsparameter

hostname: Der FQDN oder die IP-Adresse Ihres Datenbankservers
port: Die Nummer des TCP-Ports
- Der Standardwert lautet 1433 für SQL Server.
- Der Standardwert lautet 5432 für PostgreSQL.
database_name: Der Name der Omnissa Access-Datenbank

Beispiel für JDBC-URLs

SQL Server mit benutzerdefiniertem Port: jdbc:sqlserver://dbserver.example.com:14330;databaseName=saasdb
PostgreSQL mit Standardport: jdbc:postgresql://dbserver.example.com:5432/saasdb

Vorgehensweise

Melden Sie sich mithilfe eines SSH-Clients als Root-Benutzer bei der Omnissa Access-Appliance an.
(Optional) Überprüfen Sie die Datenbankverbindung, bevor Sie Änderungen vornehmen:
```
/usr/local/horizon/bin/dbConnCheck '<jdbc_url>' '<db_username>' '<encrypted_password>'
```
Hierbei gilt:
- <jdbc_url> ist Ihre aktuelle JDBC-Verbindungszeichenfolge aus der Datei „runtime-config.properties“.
- <db_username> ist Ihr Datenbankbenutzername (in der Regel horizon).
- <encrypted_password> ist das verschlüsselte Kennwort aus dem Parameter secure.datastore.jdbc.password.
  
  Eine erfolgreiche Verbindung zeigt Folgendes an: SUCCESS: Connection verified.
Öffnen Sie die Laufzeitkonfigurationsdatei zur Bearbeitung.
Beispiel:
```
vi /usr/local/horizon/conf/runtime-config.properties
```
Suchen Sie nach dem JDBC-URL-Parameter.
Der Parametername variiert je nach Datenbanktyp:
- Für den Hauptdatenspeicher: datastore.jdbc.url=
- Für den SAAS-Datenspeicher: saas.datastore.jdbc.url=
Ändern Sie die JDBC-URL-Zeichenfolge, um die Verbindungsparameter zu aktualisieren:
- So ändern Sie die Portnummer:
  - Suchen Sie die Portnummer nach dem Hostnamen (Beispiel :1433).
  - Ersetzen Sie sie durch Ihre neue Portnummer (Beispiel :14330).
- So ändern Sie den Hostnamen:
  - Ersetzen Sie den Hostnamenanteil durch den FQDN oder die IP-Adresse des neuen Servers.
- Zum Ändern des Datenbanknamens aktualisieren Sie den entsprechenden Datenbanknamen, wie z. B.:
  - SQL Server: der Parameter databaseName=
  - PostgreSQL: der Datenbankname nach letztem /
    
    Änderungsbeispiel:
    
    Von:
```
datastore.jdbc.url=jdbc:sqlserver://oldserver.example.com:1433;databaseName=saasdb
```
An:
```
datastore.jdbc.url=jdbc:sqlserver://newserver.example.com:14330;databaseName=saasdb
```
Stellen Sie sicher, dass die vollständige JDBC-URL korrekt ist, einschließlich der folgenden Details:
- Protokollpräfix (jdbc:sqlserver:// oder jdbc:postgresql://)
- Korrekter Hostname oder korrekte IP-Adresse
- Korrekte Portnummer
- Korrekter Datenbankname
- Geeignete Syntax für Ihren Datenbanktyp
Wenn Sie auch das Datenbankkennwort ändern, aktualisieren Sie den Kennwortparameter in derselben Datei:
```
secure.datastore.jdbc.password=encrypted_password
```
Hinweis: Anweisungen zur Kennwortverschlüsselung finden Sie unter Manuelles Aktualisieren des Kennworts der externen Datenbank und Aktualisieren der JDBC-Kennworteigenschaft in Omnissa Access.
Speichern Sie die Datei runtime-config.properties.
Überprüfen Sie vor dem Neustart die Netzwerkverbindung mit dem neuen Datenbankserver und Port:
```
telnet new_hostname new_port_number
```
Oder:
```
nc -zv new_hostname new_port_number
```
Starten Sie den Omnissa Access-Dienst neu, um Änderungen anzuwenden:

service horizon-workspace restart

Stellen Sie sicher, dass der Dienst erfolgreich gestartet wird, indem Sie den Dienststatus überprüfen:
```
service horizon-workspace status
```
Überwachen Sie die Protokolldateien auf Verbindungsfehler:
```
tail -f /opt/vmware/horizon/workspace/logs/horizon.log
```
Wiederholen Sie für geclusterte Bereitstellungen alle vorangehenden Schritte in diesem Verfahren auf allen Knoten in Ihrem Omnissa Access-Cluster.

Verifizierung

Melden Sie sich bei der Omnissa Access-Admin-Konsole an.
Navigieren Sie zum Dashboard, um den Systemzustand zu überprüfen.
Bestätigen Sie, dass die Datenbankverbindung ordnungsgemäß funktioniert.
Testen Sie die Benutzerauthentifizierung und den Ressourcenzugriff.

Fehlerbehebung

Wenn der Dienst nach dem Anwenden der Änderungen nicht gestartet werden kann, gehen Sie folgendermaßen vor:

Stellen Sie sicher, dass die JDBC-URL-Syntax für Ihren Datenbanktyp korrekt ist.
Bestätigen Sie, dass die Firewallregeln eine Verbindung mit dem neuen Port zulassen.
Stellen Sie sicher, dass der Datenbankserver den angegebenen Port überwacht.
Überprüfen Sie /opt/vmware/horizon/workspace/logs/horizon.log auf bestimmte Fehlermeldungen.
Stellen Sie sicher, dass die Anmeldedaten für die Datenbank weiterhin gültig sind.