Data Domain：如何針對 Boostfs 安裝、組態及掛接問題進行故障診斷

摘要: 本文可協助使用者識別和解決一些常見的 BOOSTFS 安裝和組態問題。

受影響的產品

本文章適用於本文章不適用於本文無關於任何特定產品。本文未識別所有產品版本。

說明

BoostFS 是一種軟體元件，可能會安裝在某些作業系統中。它可讓使用者在不使用任何特定備份應用程式的情況下，執行 DD Boost 備份至 Data Domain，同時利用使用支援 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 問題

安裝 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），以及任何提供外殼的包（sh）和預設的 RPM 庫。因此，此 BoostFS 套件應在 Linux 系統中正常安裝”rpm“已被運行。

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 伺服器中配置映射。

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/ 因此無法在同一目錄中再次掛載。

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

」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 使用者設定密碼箱。

」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

使用 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命令。

嘗試設定「boostfs」使用者認證失敗，並出現下列錯誤：

bfs_krb5_err_handler: Kerberos error: -1765328360 [ERROR_MESSAGE=Failed getting initial credentials.]

無法設定 Kerberos 登入資料。

使用 Active Directory 使用者認證登入 DC，確認 Active Directory 使用者認證正確無誤。
確認 Linux 用戶端和 Kerberos 伺服器上的時間間隔不超過 5 分鐘。Kerberos 驗證要求時鐘時間相隔不超過 5 分鐘。

在 Linux 用戶端中掛接 BoostFS 失敗，並顯示錯誤「fusermount: mount failed: Operation not permitted.」

這可能是由於以下幾個原因中的任何一個所導致的。」fusermount」是最終使用的基礎 Linux 命令 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 使用者必須執行掛接。

BoostFS 掛接正常，但嘗試在掛接點存取儲存裝置內容失敗，並出現權限錯誤

使用 Data Domain 手動掛接儲存裝置時boostfs命令或 /etc/fstab （甚至”mount.fuse》中，它是預設值的基礎 FUSE 僅允許存取 Linux 用戶端檔案的實現 userid 安裝了 BoostFS。因此，如果掛接是以 root 身分進行，則只有 root 才能存取檔案。如果掛接是以使用者身份進行”postgres」（用於備份 PostgreSQL 資料庫），只有此使用者才有存取權限。

如果其他使用者必須能夠從 Linux 雲端存取掛接儲存裝置中的檔案，則 /etc/fuse.conf 可能需要調整。請參閱此處的更多詳細資料：Ubuntu 手冊頁：保險絲

設定下列選項 /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).

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

如果在掛接儲存裝置時發生 SSL 錯誤，請確認網路並未降低用戶端和 Data Domain 之間的 MTU。

請確定 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.

詢問客戶是否可以將組態變更為 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}

如果用戶端也需要為單向或雙向，也必須變更此設定以允許 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 組態相關問題：

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

NetWorker 是否支援 BoostFS？

NetWorker 預設支援 BoostFS，並可處理動態掛接以執行特定工作和備份。

儘管 NetWorker 是支援 DD Boost 的備份應用程式，但在安裝它的 Linux 用戶端系統上也支援 BoostFS。設定 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

檢查您的裝置是否在支援服務的涵蓋範圍內。

Data Domain：如何針對 Boostfs 安裝、組態及掛接問題進行故障診斷

摘要: 本文可協助使用者識別和解決一些常見的 BOOSTFS 安裝和組態問題。

說明

額外資訊

受影響的產品

說明

常見的 BoostFS 問題

其他資訊

BoostFS 組態相關問題：

受影響的產品

產品

文章屬性

向其他 Dell 使用者尋求您問題的答案

支援服務

文章屬性

向其他 Dell 使用者尋求您問題的答案

支援服務

Data Domain：如何針對 Boostfs 安裝、組態及掛接問題進行故障診斷

摘要: 本文可協助使用者識別和解決一些常見的 BOOSTFS 安裝和組態問題。

詳細文章

說明

額外資訊

受影響的產品

說明

常見的 BoostFS 問題

其他資訊

BoostFS 組態相關問題：

受影響的產品

產品

文章屬性

向其他 Dell 使用者尋求您問題的答案

支援服務

文章屬性

向其他 Dell 使用者尋求您問題的答案

支援服務