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 クライアントを使用して、Omnissa Access アプライアンスに root ユーザーとしてログインします。
（オプション）変更を加える前に、データベースの接続を確認します。
```
/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 を確認します。
データベース認証情報がまだ有効であることを確認します。