トラブルシューティングに関するFAQ

トラブルシューティングに関するFAQ

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

1. QntrlでBridgeをインストールして使用するための前提条件 

  • インストールには管理者権限が必要です。
  • Java Runtime Environment（JRE）が必要です。利用できない場合は、Bridge Agentに同梱されているJavaを使用できます。
 

2. Qntrl Bridgeをインストールして使用するためのシステム要件   

コンポーネント

最小

推奨

プロセッサ

4コア

16コア

プロセッサ速度

2GHz

3GHz以上

RAM

2GB

16GB

ストレージ

2GB**

5GB**

Notes
ストレージは、Bridgeのインストールと操作ログに必要な容量を指します。

 

3. Bridgeを非rootユーザーとしてインストールする理由   

セキュリティのベストプラクティスとPostgreSQLの互換性要件により、Bridgeは非root（非管理者）サービスユーザーとして実行する必要があります。Bridgeをrootユーザーとして実行すると、権限の競合やデータベースの問題が発生する可能性があります。

4. Qntrl Bridgeのインストールに対応しているOS   

Qntrl Bridgeは、以下のOSに対応しています。

Windows：

  • Windows 8、10、11

  • Windows Server 2012、2016、2019

Linux：

  • Ubuntu 18以降

  • CentOS 7以降

  • Red Hat 6以降

その他のOSバージョンでも動作する場合がありますが、パフォーマンスは保証されません。

 

5. 別のフォルダーにインストールした場合にBridgeが起動しない理由（Linux／macOS）   

  • インストールディレクトリーにBridgeサービスおよびサービスユーザーがアクセスできることを確認してください。

  • macOS：Bridgeをデスクトップ、書類などの保護されたフォルダーにインストールしないでください。

6. Bridgeのダウンロードとインストール   

  • ［設定］→［詳細設定］→［Bridge］→［ダウンロード］に移動します。
  • 使用するOSを選択し、BridgeのZIPファイルをダウンロードします。
  • ZIPファイルを展開し、ヘルプページに記載されているインストール手順に従います。 

7. Bridgeの起動と停止   

ターミナルで以下のコマンドを実行して、Bridgeを起動または停止できます。
Linux／Mac：

sh <Bridge-path>/bin/bridge.sh start# 起動
sh <Bridge-path>/bin/bridge.sh stop# 停止

Windows：

<Bridge-path>\bin\bridge.bat start # 起動
<Bridge-path>\bin\bridge.bat stop# 停止

 

8. LinuxでBridgeが起動しない原因  

  • 次のコマンドでシステムサービスログを確認します：journalctl -u qntrl_bridge.service

  • wrapper.log が logs フォルダーにない場合、権限が正しく設定されていない可能性があります。次のコマンド sh /Bridge/bin/set_permissions.sh をBridgeサービスユーザーとして実行します。

 

9. macOSでBridgeが起動しない原因  

wrapper.log が logs フォルダーにない場合、権限が正しく設定されていない可能性があります。次のコマンド sh /Library/Bridge/bin/set_permissions.sh をBridgeサービスユーザーとして実行します。

10. Linux／Mac OSでのBridgeの再起動  

ターミナルで次のコマンドを実行して再起動します。

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

 

11. WindowsでのBridgeの再起動  

ターミナルで次のコマンドを実行すると、Bridgeを再起動できます。

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

または

［設定］（設定）→［サービス］→［Qntrl Bridge］に移動し、サービスを再起動します。

 

12. Bridgeが動作しない場合の再インストール 

ターミナルでBridgeフォルダーに移動し、次のコマンドを実行します。  

Linux／Mac：

sudo sh bin/bridge.sh remove
sudo sh bin/bridge.sh installstart

Windows：

sudo bin\bridge.bat remove
sudo bin\bridge.bat installstart

 

13. Bridgeが非アクティブな場合の確認事項   

  • Bridgeが起動し、正しいポートで実行されていることを確認します。
  • 実行されていない場合は、sh<Bridge-path>/bin/bridge.sh startを使用します。
  • Bridgeが正しいポートで実行されているにもかかわらず非アクティブな場合は、<Bridge-path>/logs フォルダー内のログファイル（特に logs.txt と wrapper.log）でエラーを確認します。
 

14.  システム再起動後にBridgeが起動しない場合（Windows）  の対応

  • Windowsの［サービス］に移動し、［Qntrl Bridge］が実行されているか確認します。
  • 実行されていない場合は、Windowsターミナルで次のコマンド <Bridge-path>\bin\bridge.bat startを実行し、Bridgeを手動で起動します。
  • 失敗した場合は、Bridgeログでエラーを確認します。
 

15. Bridgeのアンインストール   

Windows：

ターミナルで次のコマンドを実行すると、Bridgeをアンインストールできます。

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

すべてのBridgeファイルを手動で削除するには、コマンドプロンプト（cmd）で次のコマンドを使用します。

rd /s /q <Bridge-path> # (CMD)
Remove-Item -Recurse -Force <Bridge-path> # (PowerShell)

 

Linux／Mac：

ターミナルで次のコマンドを実行すると、Bridgeをアンインストールできます。

sh <Bridge-Path>/bin/bridge.sh remove

すべてのBridgeファイルを手動で削除するには、次のコマンドを使用します。

rm -rf <Bridge-Path>

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

 

16. 1つの組織への複数のBridgeのインストール可否

はい。同じQntrlアカウントに複数のBridgeをインストールして関連付けることができます。

 

17. 同一マシンでの複数のBridgeの実行可否

はい。各Bridgeの設定ファイルを変更し、適切に設定してください。

18. Bridgeでの外部PostgreSQLインスタンスの使用可否   

はい、Bridgeは外部PostgreSQLに対応しています

  • インストール時、または後からbin/bridge.sh configure_postgresを使用して設定できます。

  • または、conf/postgres.xml内のプロパティを変更して設定することもできます。

19. BridgeからローカルドメインまたはIPを呼び出す際の証明書エラーの原因   

通常、信頼できる証明書のない非公開ドメインを呼び出している場合に発生します。

解決方法。

  1. 証明書の抽出
    1. openssl s_client -connect <domain:port> -showcerts
    2. 証明書セクションのみをコピーし、.pemファイルとして保存します。
    3. または、ブラウザーからエクスポートします。
  2. Bridgeへのアップロード
    1. Bridge Agent UIで/account/sslに移動します。
    2. .pemファイルをトラストストアセクションにアップロードします。

 

20.  Bridgeをインストールして起動した後、Bridgeセクションに表示されない場合  

  • 対象のマシンがQntrlドメインにネットワーク接続できることを確認します。

  • プロキシを使用している場合は、Bridgeでプロキシ設定が正しく構成されていることを確認します。

  • デバッグにはログを参照してください。