お知らせ：当社は、お客様により充実したサポート情報を迅速に提供するため、本ページのコンテンツは機械翻訳を用いて日本語に翻訳しています。正確かつ最新のサポート情報をご覧いただくには、本内容の英語版を参照してください。

1. 前提条件とシステム要件   

1.1 Qntrl Bridgeをインストールして使用するための前提条件は何ですか？   

Qntrl Bridgeをインストールする前に、次の前提条件を満たしていることを確認してください。

• Bridgeをインストールするには、管理者権限（Windows）またはsudo権限（Linux／macOS）が必要です。

• インストール後にBridgeサービスを実行するために、管理者以外（Windows）またはroot以外（Linux／macOS）のローカルユーザーアカウントが必要です。

• BridgeホストからQntrlエンドポイントへ、HTTPS／WSS（ポート443）経由でアウトバウンドのインターネットアクセスができる必要があります。

• Bridgeサービスユーザーに、Bridgeのインストールディレクトリに対する読み取りおよび書き込み権限が必要です。

管理者権限またはroot権限が必要なのはインストール時のみです。セキュリティ上の理由から、Bridgeサービス自体は管理者以外またはroot以外のユーザーアカウントで実行する必要があります。

1.2 Qntrl Bridgeのハードウェア要件とソフトウェア要件は何ですか？   

• Java Runtime Environment（JRE）
• PostgreSQLデータベース

1.3 BridgeはrootユーザーまたはAdministratorユーザーとしてインストールできますか？   

1.4 Bridgeをインストールする前に必要なネットワークアクセスは何ですか？   

Bridgeホストから次のQntrlエンドポイントへのアウトバウンドアクセスが必要です。

ポート443経由のアウトバウンドHTTPSトラフィックが、WebSocket（WSS）接続をブロックまたは変更する形で介入されていないことを確認してください。

• macOSでは、次のような保護されたフォルダーにBridgeをインストールしないでください。
• デスクトップ
• 書類
• ダウンロード
  

1. Linuxでは、Bridgeサービスユーザーにインストールディレクトリーへの読み取りおよび書き込みアクセス権があることを確認してください。
   

2.3 インストール後にBridgeがQntrlに表示されないのはなぜですか？   

これは通常、BridgeがQntrlに登録できなかったことを示します。

3. ［設定］→［Bridge］→［Bridge］に移動し、Bridgeの項目が表示されているか確認します。

4. 表示されていない場合は、次の宛先へのアウトバウンド接続を確認してください。
   

1. core.qntrl.com
   

2. bridgews.qntrl.com
   

5. ポート443でのHTTPS／WSSトラフィックが許可されていることを確認します。

6. ファイアウォール、プロキシ、またはセキュリティアプライアンスがWebSocketトラフィックをブロックしていないか確認します。

7. logs.txt または wrapper.log.gz で、登録エラーまたはWebSocketエラーを確認します。
   

3. Bridgeの起動に関する問題   

3.1 Bridgeを起動または停止するには   

Bridgeサービスを起動または停止するには、次のコマンドを使用します。

Linux／macOS：

Windows：

3.2 Bridgeを再起動するには   

Linux／macOS：

sh <Bridge-path>/bin/bridge.sh restart

Windows（コマンドライン）：

<Bridge-path>\bin\bridge.bat restart

Windows（Bridge UIを使用）： 

［設定（⚙）］→［Bridge］→［Bridge］に移動し、対象のBridgeの横にある［操作］メニューをクリックして、［再起動］を選択します。

3.3 Bridgeの起動に失敗した場合の対処方法   

問題を特定して解決するには、次の手順に従ってください。

手順1：Bridgeログの確認

• 次の場所に移動します：<Bridge-path>/logs/

• 次のログファイルを確認します。

• logs.txt– Bridgeの起動エラーまたは実行時エラーがないか確認します。

• wrapper.log.gz – logs.txtが利用できない場合は、このファイルを確認します。

Qntrlサポートとログを共有する必要がある場合は、次のコマンドを使用します。

• Linux／macOS：<Bridge-path>/bin/bridge.sh send_logs

• Windows：<Bridge-path>\bin\bridge.bat send_logs

手順2：ポートの空き状況の確認  

次のポートが他のアプリケーションで使用されていないことを確認します。

手順3：ディレクトリー権限の確認  

BridgeサービスユーザーにBridgeのインストールディレクトリーへの読み取りおよび書き込みアクセス権があることを確認します。権限が不足していると、Bridgeがログファイルを作成できず、正常に起動できない場合があります。

手順4：アウトバウンド接続の確認  

• core.qntrl.com
• bridgews.qntrl.com

手順5：プロキシ設定の確認  

ご利用の環境でアウトバウンドプロキシを使用している場合は、正しく設定されていることを確認します。詳しくは、プロキシ設定を参照してください。

プロキシ設定を更新した後、Bridgeを再起動し、正常に起動することを確認します。

3.4 Windowsでシステム再起動後にBridgeが起動しない場合の対処方法   

解決方法

1. Windowsサービスを開きます。
2. Qntrl Bridgeが一覧に表示され、実行中であることを確認します。
3. 実行中でない場合は、次のコマンドを使用して手動で起動します：<Bridge-path>\bin\bridge.bat start
4. Qntrl Bridgeサービスのスタートアップの種類を［自動］に設定します。
5. サービスの起動に失敗した場合は、Bridgeログを確認します。
   

プロキシがWebSocketトラフィックをブロックまたは変更している場合に発生することがあります。

• プロキシでポート443経由のWebSocketトラフィックが許可されていることを確認します。

• 認証が必要な場合は、プロキシの認証情報を確認します。

• SSLインスペクションによってTLS接続が切断されていないか確認します。

• 必要に応じて、QntrlエンドポイントをSSLインスペクションの対象から除外するか、プロキシCA証明書をBridgeトラストストアにアップロードします。証明書の問題を参照してください。
  

7. 証明書の問題   

7.1 Bridgeが内部ドメインまたはIPを呼び出す際に証明書エラーが発生するのはなぜですか？   

対象の内部サービスで、Bridgeホストで信頼されていない自己署名証明書、またはプライベートCAによって発行された証明書が使用されている場合に発生することがあります。

対処方法：

1. 証明書を抽出します。
   
1. openssl s_client -connect <domain:port> -showcerts
   
2. 証明書ブロック（-----BEGIN CERTIFICATE----- ... -----END CERTIFICATE-----の部分）のみをコピーし、.pemファイルとして保存します。または、ブラウザーから証明書をエクスポートします。
2. 証明書をBridgeにアップロードします。

1. Bridge Agent Web UIをhttp://<bridge-host>:8500で開きます。

2. /account/sslに移動します。

3. トラストストアセクションで、エクスポートした.pem証明書をアップロードします。

アップロードした証明書はBridgeトラストストアに追加され、対象サービスとの安全な接続を確立するために使用されます。

7.2 Bridge Web UIでHTTPSを有効にするには   

Bridge Web UIをhttp://<bridge-host>:8500/account/sslで開き、証明書の詳細を入力します。

利用可能な項目は次のとおりです。

• 自己署名証明書：サーバー証明書と秘密鍵をアップロードします。

• CA署名証明書：サーバー証明書、秘密鍵、および証明書チェーン内の適切なルート証明書と中間証明書をアップロードします。
  

これらのコマンドを実行する前に、必要な管理者権限またはsudo権限があることを確認してください。

9. 複数のBridgeインスタンス   

9.1 同じQntrl組織に複数のBridgeインスタンスをインストールできますか？   

はい。同じQntrl組織に複数のBridgeインスタンスをインストールして接続できます。

複数のBridgeインスタンスは、次の場合に役立ちます。

• 異なるネットワークセグメントへの接続（例：DMZと内部LAN）

• 本番環境と非本番環境の分離

• 異なる種類のワークロードをBridgeインスタンス間で分散

  

9.2 複数のBridgeインスタンス間でタスクはどのように分散されますか？   

Qntrlは、利用可能なBridgeインスタンスで構成される負荷分散クラスター全体にタスクを分散し、ワークロードの均衡と全体的な可用性の向上に役立ちます。クラスターにBridgeインスタンスを追加すると、利用可能なインスタンス間でタスクが自動的に分散されます。

負荷分散クラスターの設定の詳細については、Bridgeの負荷分散クラスタリングを参照してください。

 

9.3 1つのBridgeインスタンスが利用できなくなった場合はどうなりますか？   

同じQntrl組織内で設定されている、他の利用可能なBridgeインスタンスにタスクを再ルーティングできます。

高可用性の設定については、 Bridgeクラスターを参照してください。

10. データベース（PostgreSQL）   

10.1 Bridgeで同梱データベースの代わりに外部PostgreSQLインスタンスを使用できますか？   

はい。Bridgeは外部PostgreSQLインスタンスの使用に対応しています。

次のいずれかの方法で設定できます。

• インストール時：プロンプトが表示されたら、外部PostgreSQLインスタンスを指定します。

• インストール後：次のコマンドを実行します。

• Linux／macOS：bin/bridge.sh configure_postgres

• または、PostgreSQLの設定を次のファイルで直接更新します。 <Bridge-path>/conf/postgres.xml

10.2 Bridgeに同梱されているPostgreSQLのバージョンは何ですか？   

BridgeにはPostgreSQL 16.4が含まれています。

デフォルトでは、同梱データベースは次のように設定されています。

• 待ち受けはlocalhostのみです

• ポート8501を使用します

• 外部からはアクセスできません
  

10.3 Bridgeはどのデータベースに接続できますか？   

Bridgeは、対象システム上の次のデータベースへの接続に対応しています。

データベース	対応バージョン
MySQL	5.x、8.x
PostgreSQL	14以降
Oracle	19c、21c
SQL Server	2019、2022

新しいバージョンのデータベースで更新版のJDBCドライバーが必要な場合は、既存のドライバーを互換性のあるバージョンに置き換えてください。

11. ログと診断   

11.1 Bridgeのログファイルはどこにありますか？   

11.2 Bridgeログでは何を確認すればよいですか？   

ログファイルで、次の種類のエラーを確認してください。

11.3 BridgeがQntrlに接続されていることを確認するには？   

Bridgeの接続は、次のいずれかの方法で確認できます。

• Bridge Web UI（http://<bridge-host>:8500）を開き、Bridgeの接続ステータスを確認します。

• WebSocket接続の成功とBridge登録のメッセージがないか、logs.txtを確認します。