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

概要: このナレッジベース記事では、BoostおよびBoostFSに関連する問題をトラブルシューティングする際に、DD Boostプラグイン ログを有効にする方法について説明します。これは、事前証明書ログと呼ばれます。

この記事は次に適用されます: この記事は次には適用されません: この記事は、特定の製品に関連付けられていません。 すべての製品パージョンがこの記事に記載されているわけではありません。

手順

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

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

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

一般的な注意事項:

  • 事前認証ログは、エンジニアリングまたはサポートによって明示的に要求された場合にのみ有効にします。
  • ディスク容量を注意深く監視します。ログは急速に増加する可能性があります。
  • 権限とファイルの配置が正しいことを確認します。
  • 取り外します .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_fileslog_file_size 必要に応じて。
  • ディスク領域が限られている場合は、ログを別の場所にリダイレクトできます。

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

  1. 作成 /DDLog ディレクトリ:
    • mkdir /DDLog
      chmod 777 /DDLog
  2. 作成 /ddboost_precert.ini を上記の構成で置き換えます。

  3. 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
  2. 作成 C:\DDLog をクリックし、完全な読み取り/書き込み権限を割り当てます。

  3. デバッグ ログを有効にしてBoostFSをアンマウントして再マウントします。


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

  1. 次を削除します: ddboost_precert.ini ファイルで定義)を使用することが重要です。
  2. 次を削除します: DDLog ディレクトリとその内容。
  3. BoostFSを再マウントして変更を適用します。
  4. BoostFSログの収集元 /opt/emc/boostfs/logの詳細を確認してください。

その他の情報

7.0より前のBoost/BoostFSバージョンの場合、次の表に示す場所に「ddboost_precert.ini」という名前の空のファイルを作成することで、事前認証ログが有効になります。これを行うと、次の表に示すように、DD Boost SDK APIでデフォルトの場所とファイル名へのログ記録が有効になります。

このツールは、エンジニアリング チームまたはサポート チームから要求された場合にのみ有効にする必要があります。生成されるログの量によっては、このログができるだけ早く無効になるように注意する必要があります。

 

オペレーティングシステム ファイルの場所 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 [1] C:\DDLog\ddboost_precert.log


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のファイルが4つ作成されるため、合計で2GBのディスク容量しか必要ありません

それぞれ512MBの4つのファイルがトラブルシューティングに必要なタイム フレームに対応していない場合は、パラメーター「num_log_files」と「log_file_size」を使用してファイルの量とサイズを調整してください

表示されている構成では、ログは表と同じ場所に作成されますが、オペレーティング システムのルート パーティションのサイズが十分でない場合は、別の場所にログを作成するオプションがあります

手記:このフォルダーは、ddboost_precert.iniファイルと同じパスに存在する必要があります(よく知っている人による確認を待っています。これが本当なら、通常は小さなルート以外のパーティションにログを書き込むことは不可能です)。 


.iniファイルが存在する場合(7.0以降の場合は、適切な内容が含まれる場合)、ddboost_precert.logという名前のログ ファイルが/DDLogフォルダーに生成されます(パスが構成されている場合)

すべてのAPIコールがファイルに記録されるため、ddboost_precert.log は非常に急速に増大する可能性があります。したがって、ログのためにクライアントの場所で使用可能なスペースの量に注意してください。パーティションがいっぱいになり、ダウンタイムが発生し、お客様に不便が生じる可能性があるためです

ログを停止するには、ファイル ddboost_precert.ini を削除すると、構成されたファイルにログが記録され、直ちに停止します。
 
ddboost_precert.iniファイルに対する変更を有効にするには、BOOSTFSをアンマウントしてから再マウントする必要があります
ddboostを使用している他のバックアップ ソフトウェアでは、ddboost_precert.iniファイルの有無を検出するためのログ ファイルが作成されない場合は、サービスの再起動が必要になる場合があります
 
[1]ddboost_precert.ini ファイルは、インストールディレクトリのルートに配置する必要があります。  次のように名前を付けることができます。D:\ など  ファイルを別のドライブに配置し、ログ ファイルが作成されない場合は、とにかくC:\を試してください。

=====================================================================================================

Linux boostfsサーバーで事前認証ログを有効にする手順

1.ディレクトリーDDLogを/DDLog

2として作成します。次の内容で/パスに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

 
3。上記の内容をファイル(ddboost_precert.ini

4)に保存します。/DDLog ディレクトリに書き込み権限があることを確認します。/DDLogディレクトリー内のすべてのファイルを指定します。

a. DDLog と ddboost_precert.ini
b. 'sudo chmod 777 DDLog/ ddboost_precert.ini'

5 を実行します。デバッグ レベルのBoostFSログを収集します。

ある。オプション'-o log-level=debug'
bを使用して、BoostFSマウント ポイントをアンマウントして再マウントします。/opt/emc/boostfs/etcディレクトリー内のboostfs.confファイルでログ レベルをアップデートすることもできます。この場合も、BoostFSドライブのunmount-mountが必要です。
c.BoostFSマウント ポイントでバックアップ操作を実行します。
d.ディレクトリー(/opt/emc/boostfs/log)内のすべてのファイルを指定してください


======================================================================================================

Windows BoostFS Server

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

2。C:ドライブの下にDDLogという名前のフォルダーを作成します。precertログ ファイルは、このフォルダーの下に作成されます。ログ ファイルを作成して追加できるように、DDLogディレクトリーに対するすべての読み取り/書き込み権限を提供してください。

メモ:
上記の構成では、それぞれ約500MBの事前認証ログ ファイルが最大3個作成されます
適切と見なされる場合は、num_log_filesとlog_file_sizeに異なる値を使用できます。 ただし、それぞれ500MBのファイルが3つあれば十分です
クライアント システムで1.5GBの空き容量を使用できない場合は、log_file_sizeの値を200に減らすことができます
事前認証ログを有効にする前に、クライアント システムに十分なディスク領域があることを確認してください。

3.オプション「-o log-level=debug」を使用して、BoostFSマウント ポイントをアンマウントして再マウント
します

クリーンアップ アクティビティーと事前証明書ログの無効化

問題の発生後に事前認証ログが収集されたら、次の手順で事前認証ログを無効にします。  これは、BoostFS SUを再マウントする前に実行する必要があります
1.C:からDDLogフォルダーとそのコンテンツを削除します
2。Cからddboost_precert.iniファイルを削除します。

=====================================================================================================

ddboostバックアップ アプリケーションを使用して、Linuxサーバーで事前認証ログを有効にします。

Linux ddboostサーバーでDDBoost事前認証ログを有効にする手順:

ディレクトリー/DDLogを作成します

2.次のコマンドを使用して、/DDLogディレクトリーのすべての権限をすべてのユーザーに付与します。

       $ chmod 777 /DDLog

3.次の内容でファイル/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

4.事前認証ログは/DDLogディレクトリー内に生成されます。
=======================================================================================


ddboostバックアップ アプリケーションを使用して、Windows Serverで事前認証ログを有効にします。  

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

2。C:ドライブの下にDDLogという名前のフォルダーを作成します。precertログ ファイルは、このフォルダーの下に作成されます。ログ ファイルを作成して追加できるように、DDLogディレクトリーに対するすべての読み取り/書き込み権限を提供してください。

メモ:
上記の構成では、それぞれ約500MBの事前認証ログ ファイルが最大3個作成されます
適切と見なされる場合は、num_log_filesとlog_file_sizeに異なる値を使用できます。 ただし、それぞれ500MBのファイルが3つあれば十分です
クライアント システムで1.5GBの空き容量を使用できない場合は、log_file_sizeの値を200に減らすことができます
事前認証ログを有効にする前に、クライアント システムに十分なディスク領域があることを確認してください。
 

クリーンアップ アクティビティーと事前証明書ログの無効化

問題発生後に事前認証ログが収集されたら、次の手順で事前認証ログを無効にします。
1.C:からDDLogフォルダーとそのコンテンツを削除します
2。Cからddboost_precert.iniファイルを削除します。

対象製品

Data Domain

製品

Data Domain
文書のプロパティ
文書番号: 000020437
文書の種類: How To
最終更新: 10 11月 2025
バージョン:  7
質問に対する他のDellユーザーからの回答を見つける
サポート サービス
お使いのデバイスがサポート サービスの対象かどうかを確認してください。