Data Domain：如何对 Boostfs 安装、配置和装载问题进行故障处理

摘要: 本文可帮助用户识别和解决一些典型的 BOOSTFS 安装和配置问题。

本文适用于 本文不适用于 本文并非针对某种特定的产品。 本文并非包含所有产品版本。
查看其他资源

说明

BoostFS 是一个软件组件，可能会安装在某些操作系统中。它允许用户运行到 Data Domain 的 DD Boost 备份，而无需使用任何特定的备份应用程序，同时还可以利用使用已启用 Boost 的备份应用程序（如 NetBackup、NetWorker 或 Avamar）附带的一些功能。
 
有关更多“切中要害”的安装和利用率详细信息，请查看 Data Domain：加快了 Data Domain Boost 文件系统的配置步骤和详细信息。
 
但是，本知识库文章包含一些在配置和使用 BoostFS 时可能会发现的典型问题。它可作为这些典型错误、错误消息以及如何解决它们的快速参考。典型的此类错误是”Unable to install Boostfs onto Linux server," "Boostfs mount fails with error“或”Backup or restore fails with error“，仅举几例。
 

常见 BoostFS 问题

  1. 安装 BoostFS 软件时缺少所需的依赖项
如果在客户端 Linux 操作系统中安装提供的 BoostFS 软件 RPM 失败，请首先确定 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 （“USEr 空间中的文件系统”）要安装的二进制文件和库（BoostFS 基于 Linux 的 FUSE），以及任何提供 shell （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 客户端日志中可以看到的另一个可能的错误是，未从客户端解析 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 exist“（使用 Kerberos 身份验证时）
# 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
 
在 Data Domain 上，在设置密码箱和装载 BoostFS 时，验证分配给存储单元的 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
 
如果您打算在”/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 在 Linux 客户端命名空间中本地装载 DD Boost 存储单元。这样做需要特殊权限。这就是为什么”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 手册：fuse本超链接将引导您访问非 Dell Technologies 运营的网站。
 
在 /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 的备份应用程序，但它也在安装 BoostFS 的 Linux 客户端系统上受支持。设置 BoostFS 密码箱后，从 Linux 客户端命令行获取的 NetWorker 备份的一个示例如下（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
从其他戴尔用户那里查找问题的答案
支持服务
检查您的设备是否在支持服务涵盖的范围内。