「Data Domain:Boostfsのインストール、構成、マウントの問題をトラブルシューティングする方法

概要: この記事は、BOOSTFSのインストールと構成に関する一般的な問題を特定して解決するのに役立ちます。

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

手順

BoostFSは、一部のオペレーティング システムにインストールされているソフトウェア コンポーネントです。これにより、ユーザーは特定のバックアップ アプリケーションを使用せずにData DomainへのDD Boostバックアップを実行できます。また、NetBackup、NetWorker、AvamarなどのBoost対応バックアップ アプリケーションの使用に伴う機能の一部も活用できます。
 
「要点を押さえた」インストールと使用率の詳細については、 Data Domain: Data Domain Boostファイル システムの優先構成手順と詳細
 
ただし、このKBには、BoostFSの構成および使用時に発生する可能性のある一般的な問題の一部が含まれています。一般的なエラー、エラー メッセージ、およびその解決方法に関するクイック リファレンスとして役立ちます。このようなエラーの典型は「Unable to install Boostfs onto Linux server," "Boostfs mount fails with error」または「Backup or restore fails with errorいくつか例を挙げます。
 

BoostFSの一般的な問題

  1. BoostFSソフトウェアのインストール時に必要な依存関係が見つからない
提供されたBoostFSソフトウェアRPMをクライアントLinuxオペレーティング システムにインストールできない場合は、まず、BoostFSソフトウェアに必要なパッケージの依存関係を判断します。
# rpm -qpR DDBoostFS-1.0.0.1-539441.rhel.x86_64.rpm
fuse >= 2.8
fuse-libs >= 2.8
/bin/sh
/bin/sh
/bin/sh
/bin/sh
rpmlib(PayloadFilesHavePrefix) <= 4.0-1
rpmlib(CompressedFileNames) <= 3.0.4-1
 
上記の例では、パッケージは FUSE ("Filesystem in USEr space")バイナリとライブラリをインストールする(BoostFSはLinuxの FUSE)、シェル (sh)とデフォルトのRPMライブラリ。したがって、このBoostFSパッケージはLinuxシステムに通常どおりインストールされます。rpm」がオンになっています。
 
  1. Cannot mount /mnt/mountpoint/: unexpected error
上記のエラーは、BoostFSを介してLinuxクライアントにリモートData Domainストレージ ユニットをローカルにマウントしようとすると発生することがあります。LinuxクライアントでBoostFSログ ファイルを確認します。たとえば、次の最初の例では、ロックボックス ファイルにホストのエントリーが含まれていません data.domain.comファイルに置き換えます。
# less /opt/emc/boostfs/log/ddboostfs_0_0.log
Jul 29 03:45:25 22795 3267069888 [E] bfs_lockbox_get_user_info: Failed to find key entry data.domain.com:LSU2 in config file /opt/emc/boostfs/lockbox/boostfs.lockbox. The requested Lockbox entry could not be found.
Jul 29 03:45:25 22795 3267069888 [E] bfs_conn_lookup: connection lookup failed for node 0 file /.boostfs_sysinfo. (0 connections)
Jul 29 03:45:25 22795 3267069888 [I] bfs_node_lookup: failed to obtain a connection for file /.boostfs_sysinfo
Jul 29 03:45:25 22795 3267069888 [E] bfs_initialize_mntopts: initialization failed
 
この場合のソリューションは、デスティネーションData Domainホストとストレージ ユニットをローカルにマウントするためのロックボックス エントリーを追加することです。構文は次の例のようになります。
# /opt/emc/boostfs/bin/boostfs lockbox set -u sysadmin -d data.domain.com -s LSU2
Enter storage unit user password:
Enter storage unit user password again to confirm:
Lockbox entry set
 
ローカルのBoostFSクライアント ログに表示される可能性のあるもう1つのエラーは、Data Domainホスト名がクライアントから解決されないことです。例:
# less /opt/emc/boostfs/log/ddboostfs_0_0.log
Jul 29 04:05:50 22882 3322156992 [E] bfs_conn_open: connect failed (0 connections): 5037
Jul 29 04:05:50 22882 3322156992 [E] bfs_conn_lookup: connection lookup failed for node 0 file /.boostfs_sysinfo. (0 connections)
Jul 29 04:05:50 22882 3322156992 [I] bfs_node_lookup: failed to obtain a connection for file /.boostfs_sysinfo
Jul 29 04:05:50 22882 3322156992 [E] bfs_initialize_mntopts: initialization failed
 
この場合のソリューションは、LinuxクライアントのIPマッピングに静的ホスト名を追加することです /etc/host ファイルを指定するか、使用している DNS サーバーでマッピングを構成します。
 
  1. The mount point /mnt/mountpoint is nonempty.
BoostFS cannot be mounted on a nonempty mount point. Please try mounting on an empty mount point.
 
上記のメッセージは、指定されたマウントポイント (/mnt/mountpoint)を使用してリモートData Domainストレージ ユニットを表示することはできません。これは、マウント ポイントに以前に別のファイル システムをマウントしたり、コンテンツを含めたりすることができないためです。 /mnt/mountpoint/ Linuxクライアント内の空の未使用ディレクトリーである必要があります。パスにすでにマウントがある場合は、別のマウント ポイントを指定します。例:
# mount /dev/mapper/vg00-lv_root on / type ext4 (rw) /dev/sda1 on /boot type ext4 (rw) boostfs on /mnt/mountpoint type fuse.boostfs (rw,nosuid,nodev)
 
この例では、リモートData Domainストレージ ユニットはすでに次の場所にマウントされています。 /mnt/mountpoint/ したがって、同じディレクトリーに再度マウントすることはできません。
 
  1. BoostFSマウントが応答を停止する(回復するまでに10分以上かかる場合もある)
これは、LinuxクライアントとターゲットData Domainデバイス間にあるファイアウォールがTCPポート111および2049へのトラフィックをドロップしている場合に発生する可能性があります。LinuxクライアントがTCPポート111および2049でData Domainに到達できることを確認してから、再試行してください。例:
# /opt/emc/boostfs//bin/boostfs mount -d data.domain.com -s LSU2 /mnt/mountpoint/
 
以下は、このような場合にLinuxクライアントのBoostFSログに表示される内容の例です。
# less /opt/emc/boostfs/log/ddboostfs_0_0.log
Jul 27 06:34:53 32762 3724339136 [E] bfs_conn_open: connect failed (0 connections): 5037
Jul 27 06:34:53 32762 3724339136 [E] bfs_conn_lookup: connection lookup failed for node 0 file /.boostfs_sysinfo. (0 connections)
Jul 27 06:34:53 32762 3724339136 [I] bfs_node_lookup: failed to obtain a connection for file /.boostfs_sysinfo
Jul 27 06:34:53 32762 3724339136 [E] bfs_initialize_mntopts: initialization failed
 
  1. Operation not permittedマウント ポイントの下にあるコンテンツにアクセスしたり、コンテンツを表示したりしようとすると、
# ls -l /mnt/mountpoint/
ls: reading directory .: Operation not permitted
total 0
 
問題は、リモートData Domainポート111および2049へのTCP接続がないか、ロックボックス認証の有効期限が切れている可能性があります。Linuxクライアントが指定されたポート上のData Domainに引き続きアクセスできることを確認し、リモートData Domain、ストレージ ユニット、DD Boostユーザーのロックボックスの設定を再試行します。
 
  1. Insufficient access to or storage-unit does not existKerberos認証を使用する場合
# boostfs mount -s LSU3 -d data.domain.com /mnt/mountpoint/
Insufficient access to or storage-unit LSU3 does not exist
 
ロックボックスにKerberos認証を使用している場合、エラーの原因として最も可能性が高いのは、Kerberos認証チケットの有効期限が切れていることです。以下のように、Linuxから上記のチケットを確認します。
# /opt/emc/boostfs/bin/boostfs kerberos query -s LSU3 -u username
Client Principal: username@DOMAIN.COM
Valid Starting: Tue Aug 23 11:02:49 2016
Expires: Tue Aug 23 21:01:07 2016
Renew Until: Tue Aug 30 11:02:49 2016
Service Principal: krbtgt/DOMAIN.COM@DOMAIN.COM
 
ロックボックスを設定してBoostFSをマウントする際に、Data Domainで、ストレージ ユニットに割り当てられているDD BoostユーザーがLinuxクライアントのユーザーと一致することを確認します。ADユーザー名とストレージユニット ユーザー名は同一である必要があります。
# ddboost storage-unit show
Name   Pre-Comp (GiB)   Status   User       Report Physical   Tenant-Unit
                                               Size (MiB)
----   --------------   ------   --------   ---------------   -----------
LSU3              0.0   RW       username                 -   -
----   --------------   ------   --------   ---------------   -----------
 
また、Data Domain、Linuxクライアント、Kerberosサーバー(AD)の日時の差が5分以内であることを確認します。時間に一貫性がないために期限切れになったチケットの問題は、チケットが離れすぎている場合に発生する可能性があります。
 
時間が5分以上異なる場合にData Domainログに表示される内容の例を次に示します。
# log watch debug/ddfs.info
08/23 18:52:09.654 (tid 0x7f738141fb00): nfs3 accepted 3000004b6 552 from 10.10.10.10:55042
08/23 18:52:09.660 (tid 0x7f738140c890): [dd_rpc2_nfs x3000004b6] dd_rpc_gss_print_error:117 - event gss_error, gss_accept_sec_context failed: maj=0xd0000, min=0x96c73a25
08/23 18:52:09.660 (tid 0x7f738140c890): [dd_rpc2_nfs x3000004b6] dd_rpc_gss_print_error:126 - event gss_error, Unspecified GSS failure. Minor code may provide more information
08/23 18:52:09.660 (tid 0x7f738140c890): [dd_rpc2_nfs x3000004b6] dd_rpc_gss_print_error:141 - event gss_error, Clock skew too great
08/23 18:52:09.660 (tid 0x7f738140c890): [dd_rpc2_nfs x3000004b6] dd_rpc_gss_accept:217 - event gss_accept_failed, maj=851968, min2529638949
08/23 18:52:09.660 (tid 0x7f73814233f0): nfs3 destroyed tcp 3000004b6
 
これらはBoostFS Linuxホスト ログ用です。
# less /opt/emc/boostfs/log/ddboostfs_0_0.log
Aug 23 18:04:39 1044 2019465280 [E] bfs_conn_open: connect failed (0 connections): 5075
Aug 23 18:04:39 1044 2019465280 [E] bfs_conn_lookup: connection lookup failed for node 0 file /.boostfs_sysinfo. (0 connections)
Aug 23 18:04:39 1044 2019465280 [I] bfs_node_lookup: failed to obtain a connection for file /.boostfs_sysinfo
Aug 23 18:04:39 1044 2019465280 [E] bfs_initialize_mntopts: initialization failed
 
  1. Kerberos認証を使用したBoostFSマウントがエラー「Not able to access lockbox or lockbox entry cannot be found
# /opt/emc/boostfs/bin/boostfs mount -s LSU3 -d data.domain.com /mnt/mountpoint/
Not able to access lockbox or lockbox entry cannot be found
 
「」のBoostFS構成オプションを使用する場合は、次の手順を実行します。/opt/emc/boostfs/etc/boostfs.conf」を確認します。[global]」設定を変更し、コメントアウトされていないことを確認します。キーワード「[global]" はデフォルトでコメント化されており、グローバル オプションを機能させるにはコメント解除する必要があります。
 
BoostFSのコンテンツの例/opt/emc/boostfs/etc/boostfs.conf" 構成ファイル:
# Comments are not allowed after the option value pair.
#
#############################################################################
[global]
# Data Domain Hostname or IP address
# data-domain-system=data.domain.com
 
LinuxクライアントのBoostFSログからの出力例は次のとおりです。
# less /opt/emc/boostfs/log/ddboostfs_0_0.log
Aug 24 08:23:35 27227 3565582272 [E] bfs_lockbox_get_user_info: Failed to find key entry datadomain.techsupp.local:LSU3 in config file /opt/emc/boostfs/lockbox/boostfs.lockbox. The requested Lockbox entry could not be found.
Aug 24 08:23:35 27227 3565582272 [E] bfs_conn_lookup: connection lookup failed for node 0 file /.boostfs_sysinfo. (0 connections)
Aug 24 08:23:35 27227 3565582272 [I] bfs_node_lookup: failed to obtain a connection for file /.boostfs_sysinfo
Aug 24 08:23:35 27227 3565582272 [E] bfs_initialize_mntopts: initialization failed
 
このエラーは、Linuxクライアントで異なるホスト名、ストレージ ユニット名、またはDD Boostユーザー名を使用した結果である可能性もあります。mount」コマンドと比較して、ロックボックスのセットアップに使用されたコマンド、またはターゲットData Domainに対応するコマンドと比較します。Data Domain、BoostFSロックボックス、および「mount" コマンドを使用します。
 
  1. boostfs" ユーザー資格情報が次のエラーで失敗します。
bfs_krb5_err_handler: Kerberos error: -1765328360 [ERROR_MESSAGE=Failed getting initial credentials.]
 
Kerberos認証情報を設定できません。
  1. Active Directoryユーザー資格情報を使用してDCにログインし、Active Directoryユーザー資格情報が正しいことを確認します。
  2. LinuxクライアントとKerberosサーバーの時刻の差が5分以内であることを確認します。Kerberos認証では、クロック タイムの間隔が5分以内である必要があります。
 
  1. LinuxクライアントでBoostFSをマウントすると、「fusermount: mount failed: Operation not permitted.
これは、いくつかの理由のいずれかが原因である可能性があります。」fusermount" は、最終的に FUSE DD Boostストレージ ユニットをLinuxクライアント ネームスペースにローカルにマウントします。これを行うには、特別な権限が必要です。だから「fusermount" は、Linux クライアントの SUID バイナリです。
# ls -l /usr/bin/fusermount
-rwsr-xr-x. 1 root root 38680 May 11 2019 /usr/bin/fusermount
 
SUIDバイナリーであるため、ユーザーがストレージ ユニットのマウントの試行を実行しているかどうかにかかわらず、「fusermount" はroot" 特権。もし"fusermount" は SUID を root、Linuxクライアントのみ root ユーザーは、リモートBOOSTストレージ ユニットをマウントできます。これは、マウントを /etc/fstabですが、非root ユーザーはマウントを実行する必要があります。
 
  1. BoostFSマウントは問題ないが、マウント ポイントでストレージ ユニットのコンテンツにアクセスしようとすると、権限エラーで失敗する
Data Domain「boostfs" コマンドや /etc/fstab (あるいは「mount.fuse" と表示されます)。 FUSE Linuxクライアントへのファイルへのアクセスのみを許可する実装 userid BoostFSをマウントしました。したがって、マウントがrootとして行われた場合、rootのみがファイルにアクセスできます。マウントがユーザー「postgres"(PostgreSQLデータベースをバックアップする場合)は、このユーザーのみがファイルにアクセスする権限を持ちます。
 
マウントされたストレージ ユニット内のファイルに他のユーザーがLinuxクラウドからアクセスできる必要がある場合、 /etc/fuse.conf チューニングが必要な場合があります。詳細については、こちらをご覧ください。Ubuntu Manpage: fuseこのハイパーリンクをクリックすると、デル・テクノロジーズ以外のWebサイトにアクセスします。
 
で次のオプションを設定します。 /etc/fuse.confファイルに置き換えます。
user_allow_other
       Allow non-root users to specify the allow_other or allow_root mount options (see below).
次に、BOOSTストレージ ユニットをマウントするときにコマンド ラインから次のコマンドを使用します。
allow_other
       This option overrides the security measure restricting file access to the user mounting the filesystem.
       So all users (including root) can access the files. This option is by default only allowed to root, but
       this restriction can be removed with the configuration option described above (user_allow_other).
 
  1. BoostFSは、証明書を使用した一方向または双方向の認証をサポートしていません。リアルタイム イベントを監視するには、 two-way-password を指定します。
Aug  1 15:46:39.436 4632 1188 [I] [ddp log] [1218:4A4] number of sslquery 1
Aug  1 15:46:39.436 4632 1188 [E] [ddp log] [1218:4A4] number of ssl_query_failed2 = 1
 
  1. ストレージ ユニットをマウントするときにSSLのエラーが発生した場合は、ネットワークがクライアントとData Domain間のMTUを減らしていないことを確認します。
  2. 証明書を使用した一方向または双方向の認証を要求するようにData Domainが構成されていないことを確認します。
    # ddboost option show
    Option                           Value
    ------------------------------   -------
    distributed-segment-processing   enabled
    virtual-synthetics               enabled
    global-authentication-mode       two-way
    global-encryption-strength       medium
    ------------------------------   -------
    
    # ddboost clients show config
    Client   Encryption Strength   Authentication Mode
    ------   -------------------   -------------------
    *        medium**                two-way
    ------   -------------------   -------------------
    (**) The global security settings take precedence over these client(s) specific settings.
  3. 構成を次のように変更できるかどうかをお客様に尋ねます two-way-password または noneの詳細を確認してください。
    ddboost option set global-authentication-mode none global-encryption-strength {none | medium | high}
    
    or
    
    ddboost option set global-authentication-mode two-way-password global-encryption-strength {medium | high}
  4. クライアントも一方向または双方向である必要がある場合は、BoostFSがData Domainにマウントできるように、これも変更する必要があります。次のうちどの変更を選択するかについて許可をリクエストします。Data Domainの現在の設定が「none」の場合、変更を加える必要はありません。BoostFSマウントのテストに進みます。
    # ddboost client show config
    Client   Encryption Strength   Authentication Mode
    ------   -------------------   -------------------
    *        none**                none
    ------   -------------------   -------------------
    1. オプション1: 既存の構成を変更して two-way-password 既存の暗号化強度。
      ddboost clients modify * authentication-mode two-way-password encryption-strength { medium | high}
    2. オプション2: この現在のBoostFSマウント クライアントに新しいクライアントを追加します。
      ddboost clients modify <client hostname> authentication-mode two-way-password encryption-strength medium

その他の情報

BoostFS構成に関する質問:

  1. BoostFS構成ファイルで定義できるマウント ポイント セクションの最大数はいくつですか?
マウント ポイント セクションのマウント数に制限はありません。 boostfs.conf ファイルで定義)を使用することが重要です。
# Mount point sections are separated by [mountpoint] tags
#

# [/path/to/mount]
# [/mnt/bofs]
# Data Domain Hostname or IP address
# data-domain-system=data.domain.com

# Storage Unit
# storage-unit=su-name

# Storage Unit Username
# storage-unit-username=sysadmin

# Subdirectory within the storage-unit to mount to
# directory-name=path/to/subdir
 
  1. NetWorkerはBoostFSをサポートしていますか。
NetWorkerはデフォルトでBoostFSをサポートしており、特定のタスクとバックアップを実行するためのオンザフライ マウントを処理できます。
 
NetWorkerはDD Boost対応のバックアップ アプリケーションですが、NetWorkerがインストールされているLinuxクライアント システムではBoostFSもサポートします。BoostFSロックボックスを設定した後、Linuxクライアントのコマンド ラインから取得したNetWorkerバックアップの例の1つは、次のようになります(PostgreSQLバックアップ)。
# nsroappbackup -z /nsr/apps/config/backup_postgresql.cfg
174908:(pid 16487):Saving the backup data in the pool 'DB'.
175019:(pid 16487):Received the media management binding information on the host 'dd.example.com'.
174910:(pid 16487):Connected to the nsrmmd process on the host 'dd.example.com'. + /usr/pgsql-11/bin/pg_dump --file=/nsr/apps/tmp/e3106c82_294324_16487/dump.sql --format=plain
Continued processing with the returned value 0. + /bin/cp /data/postgresql.conf /nsr/apps/tmp/e3106c82_294324_16487/
Continued processing with the returned value 0.
The files in the save set 'PostgreSQL_postgres_backuppostgre_full' at time '01/04/20 15:40:36' are:
               Size:   Name:
			    2645   dump.sql
			   24000   postgresql.conf
			    2 File(s)       26645 bytes
The backup command '/nsr/apps/config/scripts/backup-postgre-dbon1-full.sh' completed successfully.
The backup completed successfully.
 
バックアップ ジョブが構成されると、NetWorker UIからバックアップ ジョブを開始し、進行状況を監視することもできます。Data Domainで、 /ddr/var/log/debug/messages.engineering NetWorkerによって発行されたマウントが実行されると、次のようなログ エントリーが表示されます。
Apr 1 15:20:49 dd.example.com ddfs[17040]: NOTICE: ddboost-<client.example.com-49808>: Boostfs:
Apr 1 15:22:52.395 16275 704915520 [I] DDBoost Plugin Version is: [7.0.0.0.633508]
Apr 1 15:20:49 dd.example.com ddfs[17040]: NOTICE: ddboost-<client.example.com-49808>: Boostfs:
Apr 1 15:22:52.395 16275 704915520 [I] BoostFS Version info: [BOOSTFS:7.0.0.0-633922 FUSE:2.9.7]
Apr 1 15:20:49 dd.example.com ddfs[17040]: NOTICE: ddboost-<client.example.com-49808>: Boostfs:
Apr 1 15:22:52.395 16275 704915520 [I] bfs_lib_init: Mounting dd.example.com:LSU_NAME on /mnt/mountpoint

対象製品

Data Domain

製品

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