Data Domain. Поиск и устранение неисправностей при установке, настройке и монтировании Boostfs

BOOSTFS — это программный компонент, который может быть установлен в некоторых операционных системах и обеспечивает возможность выполнения резервного копирования BOOST в DataDomain без использования какого-либо конкретного приложения резервного копирования, в то же время используя некоторые функции, предоставляемые при использовании приложения резервного копирования с поддержкой BOOST, такие как Netbackup, NetWorker и Avamar.

Более подробную информацию об установке и использовании см. в Data Domain: Инструкции по ускоренной настройке и подробные сведения для DataDomain BOOST FS Статья базы знаний.

Однако в этой статье содержатся некоторые типичные проблемы, которые могут возникнуть при настройке и использовании BOOSTFS, чтобы у заказчиков был краткий справочник по этим типичным ошибкам, сообщениям об ошибках и способам их решения. Типичными такими ошибками являются «Невозможно установить Boostfs на сервер Linux», «Сбой монтирования Boostfs с ошибкой» или «Сбой резервного копирования или восстановления с ошибкой», и это лишь некоторые из них.

1. При установке ПО

BOOST FS отсутствует необходимая зависимость Если не удается установить указанный программный RPM-пакет BOOSTFS в клиентской операционной системе Linux, сначала определите зависимости пакета для программного обеспечения BOOSTFS.

# rpm -qpR DDBoostFS-1.0.0.1-539441.rhel.x86_64.rpm предохранитель >= 2,8 fuse-libs >= 2.8 /бин/ш /бин/ш /бин/ш /бин/ш rpmlib(PayloadFilesHavePrefix) <= 4.0-1 rpmlib(CompressedFileNames) <= 3.0.4-1

В приведенном выше примере пакет запрашивает установку двоичных файлов и библиотек FUSE (файловая система в пространстве USEr) (BOOSTFS основан на FUSE в Linux), а также любой пакет, предоставляющий оболочку (sh) и библиотеки RPM по умолчанию. Следовательно, этот пакет BOOSTFS должен нормально устанавливаться в системе Linux, в которой был запущен "rpm".


2. См. Не удается смонтировать /mnt/mountpoint/: непредвиденная ошибка

При попытке смонтировать удаленное устройство хранения DD локально в клиенте Linux через BOOSTFS может появиться ошибка, описанная выше. Просмотрите файл журнала BOOSTFS в клиенте Linux. Например, в первом приведенном ниже примере файл защищенного хранилища не содержит записи для хоста dd2500-abc.datadomain.com:

# меньше /opt/emc/boostfs/log/ddboostfs_0_0.log 29 июля 03:45:25 22795 3267069888 [E] bfs_lockbox_get_user_info: Не удалось найти запись ключа dd2500-abc.datadomain.com:LSU2 в файле конфигурации /opt/emc/boostfs/lockbox/boostfs.lockbox. Не удалось найти запрошенную запись защищенного хранилища. 29 июля 03:45:25 22795 3267069888 [E] bfs_conn_lookup: сбой поиска подключения для файла /.boostfs_sysinfo узла 0. (0 контактов) 29 июля 03:45:25 22795 3267069888 [I] bfs_node_lookup: не удалось получить подключение для файла /.boostfs_sysinfo 29 июля 03:45:25 22795 3267069888 [E] bfs_initialize_mntopts: сбой инициализации

Решением в этом случае является добавление записи защищенного хранилища для целевого хоста DD и блока хранения, которые будут смонтированы локально. Синтаксис будет аналогичен приведенному ниже примеру:

# /opt/emc/boostfs/bin/boostfs lockbox set -u sysadmin -d dd2500-abc.datadomain.com -s LSU2 Введите пароль пользователя устройства хранения: Введите пароль пользователя устройства хранения еще раз, чтобы подтвердить следующее. Набор для входа в защищенное хранилище

Другая возможная ошибка, которая может отображаться в локальных журналах клиента BOOSTFS, — это имя хоста DD, которое не разрешается клиентом, например:

# меньше /opt/emc/boostfs/log/ddboostfs_0_0.log 29 июля 04:05:50 22882 3322156992 [E] bfs_conn_open: Не удалось подключиться (0 подключений): 5037 29 июля 04:05:50 22882 3322156992 [E] bfs_conn_lookup: не удалось выполнить поиск подключения для файла узла 0 /.boostfs_sysinfo. (0 контактов) 29 июля 04:05:50 22882 3322156992 [I] bfs_node_lookup: не удалось получить подключение для файла /.boostfs_sysinfo 29 июля 04:05:50 22882 3322156992 [E] bfs_initialize_mntopts: сбой инициализации

 
Решением в этом случае может быть либо добавление статического сопоставления IP-адресов в файл клиента Linux /etc/host, либо настройка сопоставления в используемом DNS-сервере.


3. См. Точка монтирования /mnt/mountpoint не пуста.
BoostFS нельзя смонтировать на непустой точке монтирования. Попробуйте установить пустую точку монтирования.

Указанная выше точка монтирования (/mnt/mountpoint) не может быть использована для отображения удаленного устройства хранения DD, так как в этой точке монтирования ранее не может быть смонтирована другая файловая система или содержаться какое-либо содержимое. /mnt/mountpoint/ должен быть пустым и неиспользуемым каталогом в клиенте Linux. Если путь уже имеет монтирование, необходимо указать другую точку монтирования. Пример.

# монтирование /dev/mapper/vg00-lv_root вкл./тип ext4 (rw) /dev/sda1 в /boot введите ext4 (rw) boostfs в /mnt/mountpoint типа fuse.boostfs (rw,nosuid,nodev)

В этом случае удаленный накопитель DD уже смонтирован в /mnt/mountpoint/ и, следовательно, не может быть повторно смонтирован в том же каталоге.


4. См. Зависает крепление DDBoostfs (возврат может занять даже более 10 минут)

Это может происходить, когда межсетевой экран между клиентом Linux и целевым устройством DD сбрасывает трафик на TCP-порты 111 и 2049. Убедитесь, что клиент Linux может установить связь между портами DD TCP 111 и 2049, а затем повторите попытку, например:

# /opt/emc/boostfs//bin/boostfs mount -d dd2500.domain.com -s LSU2 /mnt/mountpoint/

Вот пример того, что вы увидите в журналах BOOSTFS клиента Linux в таком случае:

# меньше /opt/emc/boostfs/log/ddboostfs_0_0.log 27 июля 06:34:53 32762 3724339136 [E] bfs_conn_open: Не удалось подключиться (0 подключений): 5037 27 июля 06:34:53 32762 3724339136 [E] bfs_conn_lookup: не удалось выполнить поиск подключения для файла /.boostfs_sysinfo узла 0. (0 контактов) 27 июля 06:34:53 32762 3724339136 [I] bfs_node_lookup: не удалось получить подключение для файла /.boostfs_sysinfo 27 июля 06:34:53 32762 3724339136 [E] bfs_initialize_mntopts: сбой инициализации

5. Операция не разрешена при попытке доступа к содержимому или вывода списка содержимого в пределах точки монтирования

# ls -l /mnt/точка монтирования/ ls: чтение каталога .: Операция запрещена Всего 0

Проблема может заключаться в отсутствии TCP-подключения к удаленным портам DD 111 и 2049 или в том, что срок проверки подлинности защищенного хранилища истек по какой-либо причине. Убедитесь, что клиент Linux по-прежнему может связаться с DD через указанные порты, и повторите попытку настройки защищенного хранилища для удаленной DD, устройства хранения и пользователя BOOST.


6. См. Недостаточно доступа или устройство хранения отсутствует при использовании аутентификации Kerberos.

# boostfs mount -s LSU3 -d dd2500.domain.com /mnt/mountpoint/ Недостаточный доступ к устройству хранения LSU3 или отсутствует

Если для защищенного хранилища используется проверка подлинности на основе Kerberos, вероятной причиной ошибки является истекший срок действия билета проверки подлинности Kerberos. Проверьте упомянутый тикет из Linux, как показано ниже:

# /opt/emc/boostfs/bin/boostfs kerberos query -s LSU3 -u username Главный клиент: username@DOMAIN.COM Допустимое начало: Вт авг 23 11:02:49 2016 Истекает: Вт авг 23 21:01:07 2016 Продлевать до: Вт авг 30 2016 11:02:49 Субъект-служба: krbtgt/DOMAIN. COM@DOMAIN.COM

Убедитесь, что на DDR назначенный пользователь BOOST устройству хранения совпадает с пользователем в клиенте Linux при настройке защищенного хранилища и подключении BOOSTFS (имя пользователя AD и имя пользователя устройства хранения данных должны совпадать):

# Отображение устройства хранения DDBoost Отчет о состоянии пользователя до компенсации имени (ГиБ) Физический пользователь — единица Размер (МиБ) --------------- -------------- ------ -------- --------------- ----------- Имя пользователя LSU3 0.0 RW - - --------------- -------------- ------ -------- --------------- -----------

Также убедитесь, что интервал между датой/временем в DD, клиенте Linux и сервером Kerberos (AD) не превышает 5 минут, иначе могут возникнуть проблемы с билетами, срок действия которых истек из-за несогласованного времени.

Ниже приведен пример того, что мы увидим в журналах DD, если разница во времени будет более 5 минут:

# лог смотреть отладку/ddfs.info 08/23 18:52:09.654 (TID 0x7f738141fb00): NFS3 принят 3000004b6 552 от 10.64.229.125:55042 08/23 18:52:09.660 (TID 0x7f738140c890): [dd_rpc2_nfs x3000004b6] dd_rpc_gss_print_error:117 — событие 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 — gss_error события, неуказанный сбой GSS. Вспомогательный код может содержать дополнительную информацию 08/23 18:52:09.660 (TID 0x7f738140c890): [dd_rpc2_nfs x3000004b6] dd_rpc_gss_print_error:141 — событие gss_error, слишком большое смещение часов 08/23 18:52:09.660 (TID 0x7f738140c890): [dd_rpc2_nfs x3000004b6] dd_rpc_gss_accept:217 — событие gss_accept_failed, maj=851968, min2529638949 23.08 18:52:09.660 (TID 0x7f73814233f0): NFS3 уничтожил TCP 3000004b6

А это для журналов хоста BOOSTFS Linux:

# меньше /opt/emc/boostfs/log/ddboostfs_0_0.log 23 августа 18:04:39 1044 2019465280 [E] bfs_conn_open: Не удалось подключиться (0 подключений): 5075 23 августа 18:04:39 1044 2019465280 [E] bfs_conn_lookup: сбой поиска подключения для файла узла 0 /.boostfs_sysinfo. (0 контактов) 23 авг 18:04:39 1044 2019465280 [I] bfs_node_lookup: не удалось получить подключение для файла /.boostfs_sysinfo 23 авг 18:04:39 1044 2019465280 [E] bfs_initialize_mntopts: сбой инициализации

7.  Монтирование BoostFS с проверкой подлинности Kerberos завершается сбоем со следующей ошибкой: «Не удается получить доступ к защищенному хранилищу или не удается найти запись защищенного хранилища». 

# /opt/emc/boostfs/bin/boostfs mount -s LSU3 -d dd2500.domain.com /mnt/mountpoint/ Не удается получить доступ к защищенному хранилищу, или не удается найти запись защищенного хранилища

 
Если вы намерены использовать параметры конфигурации BOOSTFS в "/opt/emc/boostfs/etc/boostfs.conf", проверьте в файле параметр "[global]" и убедитесь, что он не закомментирован (для того, чтобы какая-либо из глобальных опций работала, ключевое слово "[global]" должно быть раскомментировано). Это ключевое слово по умолчанию закомментировано.

Пример содержимого файла конфигурации BOOSTFS «/opt/emc/boostfs/etc/boostfs.conf»:

# Комментарии после пары option value не допускаются. # ############################################################################# [весь мир] # Имя хоста или IP-адрес Data Domain. # data-domain-system=dd2500.domain.com

Пример выходных данных, которые вы увидите в журналах BOOSTFS клиента Linux:

# меньше /opt/emc/boostfs/log/ddboostfs_0_0.log 24 авг 08:23:35 27227 3565582272 [E] bfs_lockbox_get_user_info: Не удалось найти запись ключа dd2500-rtp2.techsupp.local:LSU3 в файле конфигурации /opt/emc/boostfs/lockbox/boostfs.lockbox. Не удалось найти запрошенную запись защищенного хранилища. 24 августа 08:23:35 27227 3565582272 [E] bfs_conn_lookup: сбой поиска подключения для файла /.boostfs_sysinfo узла 0. (0 контактов) 24 августа 08:23:35 27227 3565582272 [I] bfs_node_lookup: не удалось получить подключение для файла /.boostfs_sysinfo 24 августа 08:23:35 27227 3565582272 [E] bfs_initialize_mntopts: сбой инициализации

Кроме того, ошибка может быть вызвана использованием другого имени хоста, устройства хранения или имени пользователя BOOST в команде «mount» клиента Linux по сравнению с теми, которые использовались для настройки защищенного хранилища, или теми, которые соответствуют целевому DD. Убедитесь, что все имена совпадают в DD, защищенном хранилище BOOSTFS и команде «mount».


8. См.  Попытка установить учетные данные пользователя «boostfs» завершается сбоем со следующей ошибкой :

bfs_krb5_err_handler: Ошибка Kerberos: -1765328360 [ERROR_MESSAGE=Не удалось получить начальные учетные данные.]

Невозможно задать учетные

данные Kerberos 1. Проверьте правильность учетных данных пользователя Active Directory, выполнив вход в контроллер домена с учетными данными пользователя Active Directory
2. Убедитесь, что разница между временем клиента Linux и сервером Kerberos составляет не более 5 минут. Для аутентификации Kerberos требуется, чтобы время часов было выбрано с интервалом не более 5 минут.



9. См. При монтировании BOOSTFS в клиенте Linux все заканчивается ошибкой «fusermount: mount failed: Эксплуатация запрещена».

Это может быть связано с рядом причин. «fusermount» — базовая команда Linux, которая использует FUSE для локального монтирования устройства хранения DD BOOST в пространстве имен клиента Linux. Для этого требуются особые привилегии. Вот почему "fusermount" является двоичным файлом SUID в клиенте Linux:

# ls -l /usr/bin/fusermount -rwsr-xr-x. 1 root root 38680 11 мая 2019 г. /usr/bin/fusermount

Наличие двоичного файла SUID означает, что независимо от того, что пользователь пытается смонтировать устройство хранения данных, «fusermount» будет работать с привилегиями «root». Если «fusermount» не является SUID для пользователя root, то только пользователь root клиента Linux может подключить удаленное устройство хранения BOOST. Это может не быть проблемой, если монтирование настроено в /etc/fstab, но может быть проблемой, когда монтирование будет выполняться пользователем, не имеющим прав root.


10. См. BOOSTFS монтируется нормально, но попытки получить доступ к содержимому блока хранения в точке монтирования завершаются сбоем с ошибками

разрешенийПри монтировании устройства хранения вручную с помощью команды DataDomain «boostfs» или /etc/fstab (или даже «mount.fuse» из интерфейса командной строки) базовая реализация FUSE по умолчанию разрешает доступ к файлам только с идентификатором пользователя клиента Linux, с помощью которого смонтирована BOOSTFS. Таким образом, если монтирование было выполнено от имени пользователя root, только пользователь root сможет получить доступ к файлам. Если монтирование было выполнено от имени пользователя "postgres" (для резервного копирования БД PostgreSQL), только этот пользователь будет иметь разрешение на доступ к файлам.

Если по разным причинам необходимо, чтобы другие пользователи могли получить доступ к файлам в смонтированном хранилище из облака Linux, может потребоваться настройка файла /etc/fuse.conf. Более подробную информацию можно найти здесь:
http://manpages.ubuntu.com/manpages/bionic/en/man8/mount.fuse.8.html

Вам нужно будет установить следующую опцию в /etc/fuse.conf:

       user_allow_other
              Разрешить пользователям, не имеющим прав доступа root, указывать параметры монтирования allow_other или allow_root (см. раздел
              ниже).
Затем при монтаже накопителя BOOST в командной строке используйте следующие команды:
 

       allow_other
              Этот параметр переопределяет меру безопасности, ограничивающую доступ к файлам для пользователя
              Монтирование файловой системы.  Таким образом, все пользователи (включая root) могут получить доступ к файлам.  Это
              по умолчанию разрешен только для root, но это ограничение можно снять с помощью
              Опция конфигурации, описанная выше (user_allow_other).

 

Вопросы, связанные с конфигурацией BOOSTFS:

1. Какое максимальное количество секций точек монтирования можно определить в конфигурационном файле boostfs?
Количество подключений в разделе точки монтирования файла boostfs.conf не ограничено. 

# Разделы точек монтирования разделены тегами [mountpoint] # # [/путь/к/смонтировать] # [/mnt/bofs] # Имя хоста или IP-адрес Data Domain. # data-domain-system=dd2500-1.yourdomain.com # Блок хранения # storage-unit=su-name # Имя пользователя блока хранения # storage-unit-username=sysadmin # Подкаталог в устройстве хранения для монтирования # имя-каталога=путь/к/подкаталогу

2. NetWorker поддерживает BOOSTFS по умолчанию и может выполнять монтирование «на лету» для выполнения определенных задач и резервного копирования

Несмотря на то, что NetWorker является приложением резервного копирования с поддержкой BOOST, оно также поддерживает BOOSTFS в клиентских системах Linux, где оно установлено. Один из примеров резервной копии NW, сделанной из клиентской командной строки Linux после настройки защищенного хранилища BOOSTFS, выглядит следующим образом (резервная копия PostgreSQL):

# nsroappbackup -z /nsr/apps/config/backup_postgresql.cfg 174908:(pid 16487):Сохранение данных резервной копии в пуле 'DB'. 175019:(pid 16487):Получена информация о привязке управления носителем на хосте «dd.example.com». 174910:(pid 16487):Подключено к процессу nsrmmd на хосте «dd.example.com». + /usr/pgsql-11/bin/pg_dump --file=/nsr/apps/tmp/e3106c82_294324_16487/dump.sql --format=plain Продолжилась обработка с возвращенным значением 0. + /bin/cp /data/postgresql.conf /nsr/apps/tmp/e3106c82_294324_16487/ Продолжилась обработка с возвращенным значением 0. Файлы в наборе сохранения 'PostgreSQL_postgres_backuppostgre_full' на момент времени '01/04/20 15:40:36': Размер: Name. 2645 dump.sql 24000 postgresql.conf 2 Файл(ы) 26645 байт Команда резервного копирования «/nsr/apps/config/scripts/backup-postgre-dbon1-full.sh» успешно завершена. Резервное копирование выполнено успешно.

После настройки задания резервного копирования его также можно запустить из графического интерфейса пользователя NW и отслеживать ход его выполнения.messages.engineering отобразит записи журнала, подобные приведенной ниже, когда монтирование, инициированное NW:

1 апр 15:20:49 dd.example.com ddfs[17040]: ПРИМЕЧАНИЕ: ddboost-client.example.com-49808<>: Boostfs: 1 апр 15:22:52.395 16275 704915520 [I] Версия плагина DDBoost: [7.0.0.0.633508] 1 апр 15:20:49 dd.example.com ddfs[17040]: ПРИМЕЧАНИЕ: ddboost-client.example.com-49808<>: Boostfs: 1 апр 15:22:52.395 16275 704915520 [I] Информация о версии BoostFS: [BOOSTFS:7.0.0.0-633922 ПРЕДОХРАНИТЕЛЬ:2.9.7] 1 апр 15:20:49 dd.example.com ddfs[17040]: ПРИМЕЧАНИЕ: ddboost-client.example.com-49808<>: Boostfs: 1 апр 15:22:52.395 16275 704915520 [я] bfs_lib_init: Монтаж dd.example.com:LSU_NAME на /mnt/mountpoint