Data Domain:DD Boost APIログの有効化 - 事前認証ログ

Summary: この記事では、BoostおよびBoostFSに関連する問題をトラブルシューティングするときに、Data Domain Boost(DD Boost)プラグインのログを有効にする方法について説明します。これは、事前証明書ログと呼ばれます。

This article applies to This article does not apply to This article is not tied to any specific product. Not all product versions are identified in this article.
Check out other resources

Instructions

メモ: デフォルトでは、DD Boostプラグインは詳細なAPIアクティビティをログに記録しません。を使用した事前証明書ログの有効化 ddboost_precert.ini ファイルを使用すると、より詳細な診断が可能になります。ファイルの配置が正しくない、権限がない、構成が不適切な場合、ログを生成できない場合があります。

API-Level(precert)のログ記録を有効にする理由:

  • DD BoostまたはBoostFSの操作が失敗するか、予期しない動作をしています。
  • エンジニアリングまたはサポートは、分析のために詳細なAPIレベルのログを要求します。
  • Boostアクティビティーが予期されているにもかかわらず、ログが生成されません。

一般的な注意事項

  • 事前認証ログは、エンジニアリングまたはサポートによって明示的に要求された場合にのみ有効にします。
  • ディスク容量を注意深く監視します。ログは急速に増加する可能性があります。
  • 権限とファイルの配置が正しいことを確認します。
  • 『Drivers and Utilities』ディスクを挿入します。 .ini ログを無効にする方法：
  • 変更を有効にするには、BoostFSをアンマウントしてから再マウントする必要があります。

OS別のファイルの場所

オペレーティング システム ddboost_precert.ini 場所 ddboost_precert.log 場所
Linux /ddboost_precert.ini /DDLog/ddboost_precert.log
Solaris /ddboost_precert.ini /DDLog/ddboost_precert.log
UNIX /ddboost_precert.ini /DDLog/ddboost_precert.log
Windows C:\ddboost_precert.ini C:\DDLog\ddboost_precert.log

7.0より前のBOOSTおよびBoostFSバージョンの場合

空のファイルの作成 ddboost_precert.ini 適切な場所(上の表を参照)。これにより、デフォルト パスへのログ記録が有効になります。

BOOSTおよびBoostFSバージョン7.0以降の場合

構成済みの ddboost_precert.ini 次の内容のファイル:

precert_enabled=true
num_log_files=4
log_file_size=512
log_file_name=ddboost_precert.log
log_file_dir=/DDLog
ddcl_logs_include=true
ddcl_logs_sev=4
  • この構成では、それぞれ512MB(合計2GB)のログ ファイルが4つ作成されます。
  • 調整機能 num_log_files 、 log_file_size 必要に応じて、以下を行います。
  • ディスク領域が限られている場合は、ログを別の場所にリダイレクトできます。

Linux BOOSTFSクライアントのセットアップ

  1. 作成 /DDLog にある次の各ログ ファイル：

mkdir /DDLog

chmod 777 /DDLog

  1. 作成 /ddboost_precert.ini を上記の構成で置き換えます。

 

  1. 保証 BoostFSがアンマウントされ、再マウントされている。

mount -o log-level=debug <mount_point>

 

Windows BOOSTFSクライアントのセットアップ

  1. 作成 C:\ddboost_precert.ini 以下の内容で:
precert_enabled=true
num_log_files=3
log_file_size=500
log_file_name=ddboost_precert.log
log_file_dir=C:\DDLog
ddcl_logs_include=true
ddcl_logs_sev=4
  1. 作成 C:\DDLog をクリックし、完全な読み取り/書き込み権限を割り当てます。
  2. アンマウントと再マウント デバッグ ログが有効になっているBoostFS。

クリーンアップとログの無効化

  1. を削除する。 ddboost_precert.ini ファイルは提供しません。
  2. を削除する。 DDLog ディレクトリとその内容。
  3. BoostFSを再マウントして変更を適用します。
  4. BoostFSログの収集元 /opt/emc/boostfs/log。

Additional Information

よくあるお問い合わせ（FAQ）

    質問: DD Boost事前認証ログとは何ですか? 
    答え: DD Boost事前認証ログは、DD BoostクライアントとData Domainシステム間のDD Boost APIトランザクションを記録する診断ログ機能です。一般的には、パフォーマンスの問題、障害、レイテンシー、通信の問題のトラブルシューティングに使用されます。

    質問: Precert Loggingは何をキャプチャしますか? 
    答え: 事前証明書ログは、読み取り処理、書き込み処理、バックアップ アクティビティ、リストア アクティビティ、DD Boostライブラリの相互作用、APIコールのタイミング情報、クライアント側のレイテンシー インジケータを含む、DD Boost APIアクティビティを収集します。これにより、DD Boost APIの動作を詳細に可視化し、トラブルシューティングとパフォーマンス分析に役立てることができます。

    質問: 事前認証ログが生成されないのはなぜですか? 
    答え: ddboost_precert.iniファイルが存在し、オペレーティング システムのルートにあり、ログ ディレクトリーが存在し、ログ ディレクトリーが書き込み可能であり、新しいバックアップまたはリストア操作が開始されていることを確認します。構成の欠如、誤った配置、権限の問題、新しいDD Boostアクティビティの欠如が最も一般的な原因です。

    質問: 事前証明書ログを有効にすると、すぐにログが生成されますか? 
    答え: いいえ。ログ ファイルは、新しいDD Boost APIリクエストを受信した場合にのみ生成されます。この構成では、ロギング機能のみが有効になります。

    質問: 現在実行中のバックアップで事前認証ログが生成されないのはなぜですか? 
    答え: 事前証明書ログは、構成の検出後に開始されたAPIアクティビティのみを収集します。既存のバックアップまたはリストア ジョブは、事前認証ログを生成せずに続行されます。

    質問: バックアップまたは復元ジョブを再開する必要がありますか? 
    答え: はい。事前認証ログを生成するには、新しいバックアップまたはリストア ジョブが必要です。  ログが有効化されたときにジョブがすでに実行されていた場合は、新しい操作を開始します。

    質問: 事前証明書ログが機能しない最も一般的な理由は何ですか? 
    答え: 一般的な原因は次のとおりです ddboost_precert.ini ルート レベルにない、誤って名前が付けられている ddboost_precert.ini.txt、ログディレクトリの欠落、または不十分な権限。構成とファイルシステムの問題が、最も頻繁に発生する原因です。

    質問: ddboost_precert.iniファイルはどこに配置する必要がありますか? 

    Linux: /ddboost_precert.ini. Windows: C:\ddboost_precert.ini.

    答え: ファイルは、オペレーティング システムのルート ディレクトリーに存在する必要があります。

    質問: ddboost_precert.iniファイルを別のフォルダーに保存できますか? 
    答え: いいえ。ファイルはルートに保存する必要があります。DD Boostプラグインは、オペレーティング システムのルート ディレクトリーのみをチェックします。

    質問: ファイルが実際にそうではないことを確認するにはどうすればよいですか 

    ddboost_precert.ini.txt

    エクスプローラーを開き、ファイル名拡張子を有効にして、ファイル名を確認します。
    答え: ファイル名が 

    ddboost_precert.ini and not ddboost_precert.ini.txt.

    質問: なぜですか DDLog ログを有効にした後、ディレクトリーは空ですか
    答え: 新しいバックアップ、リストア、または DDPCONNCHK テストしてアクティビティを生成します。  考えられる原因としては、新しいDD Boostアクティビティがない、権限の問題、構成ファイルが検出されなかったなどがあります。

    質問: とは DDPCONNCHK そして、なぜそれが役立つのですか? 
    回答： DDPCONNCHK は、DD Boostの接続性検証ツールです。これにより、DD Boost APIアクティビティーが生成され、証明書の事前ログが機能していることを迅速に確認できます。

    質問: できる DDPCONNCHK 構成のテストに使用しますか
    答え:  エンジニアは頻繁に DDPCONNCHK ログを有効にした後。はい。これは、問題を再現する前にログが生成されていることを確認する一般的な方法です。

    質問: 事前証明書ログが急速に増加するのはなぜですか
    答え:  事前認証ログでは、すべてのDD Boost APIコールが記録されます。大規模なバックアップ環境では、短時間に大量のログが生成される可能性があります。

    質問: どのくらいのディスク容量を割り当てる必要がありますか? 一般的な推奨事項は次のとおりです 

    num_log_files=3 and log_file_size=500.

    答え: これにより、ローテーションが発生する前に約1.5 GBのログ ストレージが提供されます。

    質問: 事前認証ログでファイル システムがいっぱいになることはありますか? 
    答え: ログは、監視されていない場合、大量のディスク領域を消費する可能性があります。はい。ファイル システムがいっぱいになると、バックアップの失敗、システム停止、サービスの中断が発生する可能性があります。

    質問: num_log_files目的は何ですか? 
    答え: このパラメーターは、保持されるローテーションされたログ ファイルの数を制御します。たとえば以下のようなものです。, num_log_files=3 creates ddboost_precert.log, ddboost_precert.log.1, and ddboost_precert.log.2。

    質問: log_file_sizeの目的は何ですか? 
    答え: このパラメーターは、各ログ ファイルの最大サイズをMB単位で定義します。たとえば、log_file_size=500に設定すると、ローテーション前に各ファイルを500 MBに拡張できます。

    質問: どうするs ddcl_logs_include=true しますか?
    答え:  これにより、事前認証ログ内のDD Boostクライアント ライブラリーのログ情報が有効になります。推奨設定は ddcl_logs_include=true.

    質問: 何をしないか ddcl_logs_sev=4 どういう意味ですか?
    答え:  このパラメーターは、ロギングの重大度を制御します。重大度レベル4では、詳細なトラブルシューティングとデバッグ情報が提供されます。

    質問: 私は必要ですか BoostFS 事前証明書ログに加えてデバッグ ログを使用するか? 
    答え: 追加のログ記録は必ずしも必要ではありません。次の目的で使用できます。 BoostFS-specific 問題が発生した場合、両方を有効にすると、多くの場合、より完全な診断画像が得られます。

    質問: たとえば、 BoostFS、アンマウントして再マウントする必要がありますか? 
    答え: アンマウントして再マウントすると、BoostFSアクティビティが再初期化されます。多くの場合、これは新しいDD Boostアクティビティを開始するのに役立ちます。

    質問: BoostFSデバッグ ログの正しい構文は何ですか
    答え:  正しい構文は次のとおりです。 -o log-level=debug。不使用 --o log-level=debug 1 つのダッシュのみが有効だからです。

    質問: BoostFSを再マウントすると、事前認証ログが突然表示されるのはなぜですか? 
    答え: 再マウントすると、BoostFSの新しい初期化サイクルが作成されます。新しいDD Boost APIアクティビティーが発生し、プラグインが構成ファイルを検出すると、ログが開始されます。

    質問: アプリケーションの再起動は、BoostFSの再マウントと同じですか? 
    答え: 通常は「はい」です。例としては、再起動が含まれます RMAN、バックアップ ソフトウェア、または実行中 DDPCONNCHK。新しいDD Boost APIアクティビティを作成するアクションによって、ログをトリガーできます。

    質問: できる RMAN BoostFSをアンマウントせずに証明書前ログを生成しますか? 
    答え: はい。新しい RMAN 通常は操作で十分です。 RMAN は、新しいDD Boost APIリクエストを直接開始できます。

    質問: 事前証明書ログを無効にするには、どうすればよいですか
    答え:  ddboost_precert.iniを削除するか、名前をddboost_precert.ini.disabledに変更します。

    質問: iniファイルを削除した後、ホストを再起動する必要がありますか? 
    答え: いいえ、再起動する必要はありません。 

    質問: Linuxではどのような権限を使用する必要がありますか? 権限の例は次のとおりです。 

    mkdir /DDLog, chmod 777 /DDLog, and chmod 777 /ddboost_precert.ini.

    答え: DD Boostプロセスは、構成ファイルを読み取り、ログ ディレクトリーに書き込むことができる必要があります。

    質問: BoostFSログはデフォルトでどこに保存されますか? 

    Linux: /opt/emc/boostfs/log. Windows: C:\BoostFS\Log.

    答え: これらの場所は、DD Boost事前認証ログとは別のものです。

    質問: BoostFSログと事前認証ログは同じものですか? 
    答え: いいえ。事前認証ログには、DD Boost APIトランザクション、ライブラリ通信、I/Oタイミング データが含まれます。BoostFSログには、マウント アクティビティ、ファイル システム操作、アプリケーション イベントが含まれます。

    質問: どのようなログをサポートに提供する必要がありますか? 
    答え: 関連するすべてのログを提供することで、トラブルシューティングを迅速化できます。問題に応じて、ddboost_precert.logを収集し、ローテーションされた事前認証ログ、BoostFSログ、 DDPCONNCHK 出力、アプリケーション ログ、要求されたサポート バンドル。

    質問: このKBに従ってもログが生成されない場合はどうすればよいですか? 
    答え: ddboost_precert.ini場所、ログ ディレクトリー リストなどの証拠を収集する DDPCONNCHK 出力、BoostFSマウント コマンド、権限情報。収集した情報をDellテクニカル サポートに送信して、詳細な分析を行います。

    Affected Products

    Data Domain

    Products

    Data Domain
    Article Properties
    Article Number: 000020437
    Article Type: How To
    Last Modified: 28 Aug 2026
    Version:  10
    Find answers to your questions from other Dell users
    Support Services
    Check if your device is covered by Support Services.