diff --git a/documentation/content/ru/books/handbook/zfs/_index.adoc b/documentation/content/ru/books/handbook/zfs/_index.adoc index b296f93b6c..3ad8d280ee 100644 --- a/documentation/content/ru/books/handbook/zfs/_index.adoc +++ b/documentation/content/ru/books/handbook/zfs/_index.adoc @@ -1,2536 +1,3753 @@ --- description: 'ZFS — это продвинутая файловая система, разработанная для решения основных проблем, присущих предыдущему программному обеспечению подсистем хранения данных' next: books/handbook/filesystems params: path: /books/handbook/zfs/ part: 'Часть III. Администрирование системы' prev: books/handbook/geom showBookMenu: 'true' tags: ["ZFS", "filesystem", "administration", "zpool", "features", "terminology", "RAID-Z"] -title: 'Глава 22. Файловая система Z (ZFS)' +title: 'Глава 23. Файловая система Z (ZFS)' weight: 26 --- [[zfs]] = Файловая система Z (ZFS) :doctype: book :toc: macro :toclevels: 1 :icons: font :sectnums: -:sectnumoffset: 22 +:sectnumoffset: 23 :partnums: :source-highlighter: rouge :experimental: :images-path: books/handbook/zfs/ ifdef::env-beastie[] ifdef::backend-html5[] :imagesdir: ../../../../images/{images-path} endif::[] ifndef::book[] include::shared/authors.adoc[] include::shared/mirrors.adoc[] include::shared/releases.adoc[] include::shared/attributes/attributes-{{% lang %}}.adoc[] include::shared/{{% lang %}}/teams.adoc[] include::shared/{{% lang %}}/mailing-lists.adoc[] include::shared/{{% lang %}}/urls.adoc[] toc::[] endif::[] ifdef::backend-pdf,backend-epub3[] include::../../../../../shared/asciidoctor.adoc[] endif::[] endif::[] ifndef::env-beastie[] toc::[] include::../../../../../shared/asciidoctor.adoc[] endif::[] ZFS — это продвинутая файловая система, разработанная для решения основных проблем, присущих предыдущему программному обеспечению подсистем хранения данных. -Первоначально разработанная в Sun(TM), дальнейшая разработка открытой версии ZFS переместилась в http://open-zfs.org[проект OpenZFS]. +Первоначально разработанная в Sun Microsystems(TM), дальнейшая разработка открытой версии ZFS переместилась в https://openzfs.org[проект OpenZFS]. ZFS имеет три основные цели проектирования: * Целостность данных: Все данные включают crossref:zfs[zfs-term-checksum,контрольную сумму]. ZFS вычисляет контрольные суммы и записывает их вместе с данными. При последующем чтении этих данных ZFS пересчитывает контрольные суммы. Если контрольные суммы не совпадают, что означает обнаружение одной или нескольких ошибок данных, ZFS попытается автоматически исправить ошибки, если доступны двойные-, зеркальные- или блоки чётности. * Объединенное хранилище: добавление физических устройств хранения в пул и выделение пространства из этого общего пула. Пространство доступно для всех файловых систем и томов и увеличивается за счет добавления новых устройств хранения в пул. * Производительность: механизмы кэширования обеспечивают повышенную производительность. crossref:zfs[zfs-term-arc,ARC] — это продвинутый кэш для чтения, основанный на оперативной памяти. ZFS предоставляет второй уровень кэша для чтения на основе диска — crossref:zfs[zfs-term-l2arc,L2ARC], а также кэш для синхронной записи на основе диска под названием crossref:zfs[zfs-term-zil,ZIL]. -Полный список возможностей и терминологии приведен в crossref:zfs[zfs-term, Особенности и терминология ZFS]. +Полный список возможностей и терминологии приведён в crossref:zfs[zfs-term, Особенности и терминология ZFS]. [[zfs-differences]] == Что отличает ZFS от других -ZFS — это не просто файловая система, она принципиально отличается от традиционных файловых систем. Объединение традиционно разделенных ролей менеджера томов и файловой системы даёт ZFS уникальные преимущества. Теперь файловая система осведомлена о структуре нижележащих дисков. Традиционные файловые системы могли существовать только на одном диске. Если было два диска, приходилось создавать две отдельные файловые системы. Традиционная конфигурация аппаратного RAID решала эту проблему, предоставляя операционной системе один логический диск, состоящий из пространства физических дисков, поверх которого операционная система размещала файловую систему. Даже в программных решениях RAID, таких как предоставляемые GEOM, файловая система UFS, находящаяся поверх RAID, считает, что работает с одним устройством. Комбинация менеджера томов и файловой системы в ZFS решает эту проблему и позволяет создавать файловые системы, которые совместно используют общий пул доступного хранилища. Одно из больших преимуществ осведомленности ZFS о физической структуре дисков заключается в том, что существующие файловые системы автоматически расширяются при добавлении дополнительных дисков в пул. Это новое пространство становится доступным для файловых систем. ZFS также может применять разные свойства к каждой файловой системе. Это делает полезным создание отдельных файловых систем и наборов данных вместо единой монолитной файловой системы. +ZFS — это не просто файловая система, она принципиально отличается от традиционных файловых систем. Объединение традиционно разделённых ролей менеджера томов и файловой системы даёт ZFS уникальные преимущества. Теперь файловая система осведомлена о структуре нижележащих дисков. Традиционные файловые системы могли существовать только на одном диске. Если было два диска, приходилось создавать две отдельные файловые системы. Традиционная конфигурация аппаратного RAID решала эту проблему, предоставляя операционной системе один логический диск, состоящий из пространства физических дисков, поверх которого операционная система размещала файловую систему. Даже в программных решениях RAID, таких как предоставляемые GEOM, файловая система UFS, находящаяся поверх RAID, считает, что работает с одним устройством. Комбинация менеджера томов и файловой системы в ZFS решает эту проблему и позволяет создавать файловые системы, которые совместно используют общий пул доступного хранилища. Одно из больших преимуществ осведомленности ZFS о физической структуре дисков заключается в том, что существующие файловые системы автоматически расширяются при добавлении дополнительных дисков в пул. Это новое пространство становится доступным для файловых систем. ZFS также может применять разные свойства к каждой файловой системе. Это делает полезным создание отдельных файловых систем и наборов данных вместо единой монолитной файловой системы. [[zfs-quickstart]] == Краткое руководство по началу работы +Установщик FreeBSD может установить систему непосредственно в пул ZFS, конфигурация, известная как Root-on-ZFS; см. crossref:bsdinstall[bsdinstall-part-zfs,Разметка диска с использованием Root-on-ZFS с помощью мастера]. В этом разделе показано, как создавать и управлять дополнительными пулами ZFS и наборами данных на работающей системе. + FreeBSD может монтировать пулы и наборы данных ZFS во время инициализации системы. Чтобы включить эту функцию, запустите: [source, shell] .... -# service zfs enable +# sysrc zfs_enable="YES" .... -или добавьте эту строку в [.filename]#/etc/rc.conf#: - -[.programlisting] -.... -zfs_enable="YES" -.... +Это добавляет `zfs_enable="YES"` в [.filename]#/etc/rc.conf#. Выполнение `service zfs enable` вносит то же изменение. Затем запустите службу: [source, shell] .... # service zfs start .... -Примеры в этом разделе предполагают использование трёх SCSI-дисков с именами устройств [.filename]#da0#, [.filename]#da1# и [.filename]#da2#. Пользователям оборудования SATA следует использовать имена устройств [.filename]#ada#. +Примеры в этом разделе предполагают использование трёх SATA-дисков с именами устройств [.filename]#ada0#, [.filename]#ada1# и [.filename]#ada2#. Пользователям оборудования SCSI/SAS следует использовать имена устройств [.filename]#da#, пользователям оборудования NVMe — имена устройств [.filename]#nda#. [[zfs-quickstart-single-disk-pool]] === Пул на одном диске -Чтобы создать простой, не избыточный пул, используя одно дисковое устройство: +Сначала создайте раздел GPT на пустом диске. Затем добавьте раздел типа `freebsd-zfs`, из которого создается один нерезервируемый пул: [source, shell] .... -# zpool create example /dev/da0 +# gpart create -s gpt ada1 +# gpart add -t freebsd-zfs ada1 +# zpool create example /dev/ada1p1 .... Для просмотра нового пула ознакомьтесь с выводом команды `df`: [source, shell] .... -# df -Filesystem 1K-blocks Used Avail Capacity Mounted on -/dev/ad0s1a 2026030 235230 1628718 13% / -devfs 1 1 0 100% /dev -/dev/ad0s1d 54098308 1032846 48737598 2% /usr -example 17547136 0 17547136 0% /example +# df /example +Filesystem 1K-blocks Used Avail Capacity Mounted on +example 17547136 0 17547136 0% /example .... Этот вывод показывает создание и монтирование пула `example`, который теперь доступен как файловая система. Создайте файлы для пользователей, чтобы посмотреть, что все работает: [source, shell] .... # cd /example # ls # touch testfile # ls -al total 4 drwxr-xr-x 2 root wheel 3 Aug 29 23:15 . drwxr-xr-x 21 root wheel 512 Aug 29 23:12 .. -rw-r--r-- 1 root wheel 0 Aug 29 23:15 testfile .... -Этот пул пока не использует расширенные функции и свойства ZFS. Чтобы создать набор данных в этом пуле с включенным сжатием: +Этот пул пока не использует расширенные функции и свойства ZFS. Чтобы создать набор данных в этом пуле с включённым сжатием: [source, shell] .... # zfs create example/compressed # zfs set compression=gzip example/compressed .... Набор данных `example/compressed` теперь представляет собой сжатую файловую систему ZFS. Попробуйте скопировать несколько больших файлов в [.filename]#/example/compressed#. Отключите сжатие с помощью: [source, shell] .... # zfs set compression=off example/compressed .... Чтобы отмонтировать файловую систему, используйте `zfs umount`, а затем проверьте с помощью `df`: [source, shell] .... # zfs umount example/compressed # df -Filesystem 1K-blocks Used Avail Capacity Mounted on -/dev/ad0s1a 2026030 235232 1628716 13% / -devfs 1 1 0 100% /dev -/dev/ad0s1d 54098308 1032864 48737580 2% /usr -example 17547008 0 17547008 0% /example +Filesystem 1K-blocks Used Avail Capacity Mounted on +example 17547008 0 17547008 0% /example .... Для повторного монтирования файловой системы, чтобы сделать её снова доступной, используйте `zfs mount` и проверьте с помощью `df`: [source, shell] .... # zfs mount example/compressed # df Filesystem 1K-blocks Used Avail Capacity Mounted on -/dev/ad0s1a 2026030 235234 1628714 13% / -devfs 1 1 0 100% /dev -/dev/ad0s1d 54098308 1032864 48737580 2% /usr example 17547008 0 17547008 0% /example example/compressed 17547008 0 17547008 0% /example/compressed .... Выполнение команды `mount` отображает пул и файловые системы: [source, shell] .... # mount -/dev/ad0s1a on / (ufs, local) +/dev/ada0p1 on / (ufs, local) devfs on /dev (devfs, local) -/dev/ad0s1d on /usr (ufs, local, soft-updates) +/dev/ada0p2 on /usr (ufs, local, soft-updates) example on /example (zfs, local) example/compressed on /example/compressed (zfs, local) .... Используйте наборы данных ZFS как любую файловую систему после создания. Настраивайте другие доступные функции для каждого набора данных по мере необходимости. В примере ниже создаётся новая файловая система с именем `data`. Предполагается, что файловая система содержит важные файлы, и для неё настроено хранение двух копий каждого блока данных. [source, shell] .... # zfs create example/data # zfs set copies=2 example/data .... Используйте `df` для просмотра данных и использования пространства: [source, shell] .... # df -Filesystem 1K-blocks Used Avail Capacity Mounted on -/dev/ad0s1a 2026030 235234 1628714 13% / -devfs 1 1 0 100% /dev -/dev/ad0s1d 54098308 1032864 48737580 2% /usr -example 17547008 0 17547008 0% /example -example/compressed 17547008 0 17547008 0% /example/compressed -example/data 17547008 0 17547008 0% /example/data +Filesystem 1K-blocks Used Avail Capacity Mounted on +/dev/ada0p1 2026030 235234 1628714 13% / +devfs 1 1 0 100% /dev +/dev/ada0p2 54098308 1032864 48737580 2% /usr +example 17547008 0 17547008 0% /example +example/compressed 17547008 0 17547008 0% /example/compressed +example/data 17547008 0 17547008 0% /example/data .... Обратите внимание, что все файловые системы в пуле имеют одинаковое доступное пространство. Использование `df` в этих примерах показывает, что файловые системы занимают столько места, сколько им нужно, и все используют один и тот же пул. ZFS устраняет такие понятия, как тома и разделы, и позволяет нескольким файловым системам совместно использовать один пул. Чтобы уничтожить файловые системы, а затем пул, который больше не нужен: [source, shell] .... # zfs destroy example/compressed # zfs destroy example/data # zpool destroy example .... [[zfs-quickstart-raid-z]] === RAID-Z Диски выходят из строя. Один из способов избежать потери данных при отказе диска — использование RAID. ZFS поддерживает эту возможность в своей конструкции пула. Пуллы RAID-Z требуют трёх или более дисков, но предоставляют больше полезного пространства, чем зеркальные пуллы. -В этом примере создаётся пул RAID-Z с указанием дисков для добавления в пул: +Этот пример создает пул RAID-Z. Сначала на каждом диске создаются разделы GPT, затем укажите эти разделы GPT для добавления в пул с помощью ключевого слова `raidz`: [source, shell] .... -# zpool create storage raidz da0 da1 da2 +# gpart create -s gpt ada0 +# gpart add -t freebsd-zfs ada0 +# gpart create -s gpt ada1 +# gpart add -t freebsd-zfs ada1 +# gpart create -s gpt ada2 +# gpart add -t freebsd-zfs ada2 +# zpool create storage raidz ada0p1 ada1p1 ada2p1 .... [NOTE] ==== -Sun(TM) рекомендует использовать от трёх до девяти устройств в конфигурации RAID-Z. Для сред, требующих единого пула из 10 или более дисков, рекомендуется разбить его на меньшие группы RAID-Z. Если доступно два диска, ZFS-зеркалирование обеспечит избыточность при необходимости. Подробнее см. в man:zpool[8]. +Рекомендовано использовать от трёх до девяти устройств в конфигурации RAID-Z. Для сред, требующих единого пула из 10 или более дисков, рекомендуется разбить его на меньшие группы RAID-Z. Если доступно два диска, ZFS-зеркалирование обеспечит избыточность при необходимости. Подробнее см. в man:zpool[8]. ==== Предыдущий пример создал пул `storage`. В этом примере в этом пуле создаётся новая файловая система с именем `home`: [source, shell] .... # zfs create storage/home .... Включить сжатие и сохранить дополнительную копию каталогов и файлов: [source, shell] .... # zfs set copies=2 storage/home # zfs set compression=gzip storage/home .... Чтобы сделать это новым домашним каталогом для пользователей, скопируйте пользовательские данные в этот каталог и создайте соответствующие символические ссылки: [source, shell] .... # cp -rp /home/* /storage/home # rm -rf /home /usr/home # ln -s /storage/home /home # ln -s /storage/home /usr/home .... -Данные пользователей теперь хранятся в только что созданном [.filename]#/storage/home#. Проверьте это, добавив нового пользователя и войдя в систему под его учётной записью. +Данные пользователя теперь хранятся в только что созданном [.filename]#/storage/home#. Проверьте это, добавив нового пользователя и войдя в систему под его учётной записью. Создайте снимок файловой системы для последующего отката: [source, shell] .... -# zfs snapshot storage/home@08-30-08 +# zfs snapshot storage/home@2026-07-11 .... ZFS создаёт снимки набора данных, а не отдельного каталога или файла. -Символ `@` является разделителем между именем файловой системы или именем тома. Перед удалением важного каталога создайте резервную копию файловой системы, а затем откатитесь к более раннему снимку, в котором каталог ещё существует: +Символ `@` является разделителем между именем файловой системы или тома и именем снимка. Перед удалением важного каталога создайте резервную копию файловой системы, а затем откатитесь к более раннему снимку, в котором каталог ещё существует: [source, shell] .... -# zfs rollback storage/home@08-30-08 +# zfs rollback storage/home@2026-07-11 .... Чтобы перечислить все доступные снимки, выполните команду `ls` в каталоге [.filename]#.zfs/snapshot# файловой системы. Например, чтобы увидеть сделанный снимок: [source, shell] .... # ls /storage/home/.zfs/snapshot .... Напишите скрипт для создания регулярных снимков пользовательских данных. Со временем снимки могут занимать много места на диске. Удалите предыдущий снимок с помощью команды: [source, shell] .... -# zfs destroy storage/home@08-30-08 +# zfs destroy storage/home@2026-07-11 .... После тестирования сделайте [.filename]#/storage/home# настоящим [.filename]#/home# с помощью следующей команды: [source, shell] .... # zfs set mountpoint=/home storage/home .... Выполните команды `df` и `mount`, чтобы убедиться, что система теперь распознает файловую систему как настоящий [.filename]#/home#: [source, shell] .... # mount -/dev/ad0s1a on / (ufs, local) +/dev/ada0p1 on / (ufs, local) devfs on /dev (devfs, local) -/dev/ad0s1d on /usr (ufs, local, soft-updates) +/dev/ada0p2 on /usr (ufs, local, soft-updates) storage on /storage (zfs, local) storage/home on /home (zfs, local) # df Filesystem 1K-blocks Used Avail Capacity Mounted on -/dev/ad0s1a 2026030 235240 1628708 13% / +/dev/ada0p1 2026030 235240 1628708 13% / devfs 1 1 0 100% /dev -/dev/ad0s1d 54098308 1032826 48737618 2% /usr +/dev/ada0p2 54098308 1032826 48737618 2% /usr storage 26320512 0 26320512 0% /storage storage/home 26320512 0 26320512 0% /home .... Настройка RAID-Z завершена. Для добавления ежедневных отчётов о состоянии созданных файловых систем в ночные запуски man:periodic[8] добавьте следующую строку в [.filename]#/etc/periodic.conf#: [.programlisting] .... daily_status_zfs_enable="YES" .... +man:periodic[8] также может выполнять запланированные проверки пула; см. crossref:zfs[zfs-zpool-scrub,Проверка пула]. + [[zfs-quickstart-recovering-raid-z]] === Восстановление RAID-Z Каждый программный RAID имеет метод контроля своего `состояния`. Просмотр состояния устройств RAID-Z осуществляется с помощью: [source, shell] .... # zpool status -x .... Если все пулы находятся в состоянии crossref:zfs[zfs-term-online,онлайн] и все работает нормально, сообщение будет следующим: [source, shell] .... all pools are healthy .... Если возникла проблема, например, диск находится в состоянии crossref:zfs[zfs-term-offline,оффлайн], состояние пула будет выглядеть так: [source, shell] .... pool: storage state: DEGRADED status: One or more devices has been taken offline by the administrator. - Sufficient replicas exist for the pool to continue functioning in a - degraded state. + Sufficient replicas exist for the pool to continue functioning in a + degraded state. action: Online the device using 'zpool online' or replace the device with - 'zpool replace'. - scrub: none requested + 'zpool replace'. + scan: none requested config: - NAME STATE READ WRITE CKSUM - storage DEGRADED 0 0 0 - raidz1 DEGRADED 0 0 0 - da0 ONLINE 0 0 0 - da1 OFFLINE 0 0 0 - da2 ONLINE 0 0 0 + NAME STATE READ WRITE CKSUM + storage DEGRADED 0 0 0 + raidz1-0 DEGRADED 0 0 0 + ada0p1 ONLINE 0 0 0 + ada1p1 OFFLINE 0 0 0 + ada2p1 ONLINE 0 0 0 errors: No known data errors .... -"OFFLINE" показывает, что администратор перевел [.filename]#da1# в автономный режим с помощью: +"OFFLINE" показывает, что администратор перевел [.filename]#ada1p1# в автономный режим с помощью: [source, shell] .... -# zpool offline storage da1 +# zpool offline storage ada1p1 .... -Выключите компьютер и замените диск [.filename]#da1#. Включите компьютер и верните [.filename]#da1# в пул: +Выключите компьютер и замените диск [.filename]#ada1p1#. Заново создайте GPT-раздел типа `freebsd-zfs` на новом диске. Включите компьютер и верните [.filename]#ada1p1# в пул: [source, shell] .... -# zpool replace storage da1 +# zpool replace storage ada1p1 .... Далее снова проверьте статус, на этот раз без `-x`, чтобы отобразить все пулы: [source, shell] .... # zpool status storage - pool: storage + pool: storage state: ONLINE - scrub: resilver completed with 0 errors on Sat Aug 30 19:44:11 2008 + scan: resilvered 3.21G in 00:04:36 with 0 errors on Sat Jul 11 10:32:19 2026 config: - NAME STATE READ WRITE CKSUM - storage ONLINE 0 0 0 - raidz1 ONLINE 0 0 0 - da0 ONLINE 0 0 0 - da1 ONLINE 0 0 0 - da2 ONLINE 0 0 0 + NAME STATE READ WRITE CKSUM + storage ONLINE 0 0 0 + raidz1-0 ONLINE 0 0 0 + ada0p1 ONLINE 0 0 0 + ada1p1 ONLINE 0 0 0 + ada2p1 ONLINE 0 0 0 errors: No known data errors .... В этом примере все в порядке. [[zfs-quickstart-data-verification]] === Проверка данных ZFS использует контрольные суммы для проверки целостности хранимых данных. Создание файловых систем автоматически включает их. [WARNING] ==== -Отключение контрольных сумм возможно, но _не_ рекомендуется! Контрольные суммы занимают мало места и обеспечивают целостность данных. Большинство функций ZFS не будут работать корректно при отключенных контрольных суммах. Их отключение не приведет к заметному повышению производительности. +Отключение контрольных сумм возможно, но _не_ рекомендуется! Контрольные суммы занимают мало места и обеспечивают целостность данных. Большинство функций ZFS не будут работать корректно при отключённых контрольных суммах. Их отключение не приведет к заметному повышению производительности. ==== Проверка контрольных сумм данных (называемая _scrubbing_) обеспечивает целостность пула `storage` с помощью: [source, shell] .... # zpool scrub storage .... -Продолжительность очистки зависит от объёма хранимых данных. Большие объёмы данных требуют пропорционально больше времени для проверки. Поскольку очистка интенсивно использует операции ввода-вывода, ZFS позволяет выполнять только одну очистку одновременно. После завершения очистки просмотрите статус с помощью `zpool status`: +Продолжительность очистки зависит от объёма хранимых данных. Большие объёмы данных требуют пропорционально больше времени для проверки. Поскольку очистка интенсивно использует операции ввода-вывода, ZFS позволяет выполнять только одну очистку на каждом пуле одновременно. После завершения очистки просмотрите статус с помощью `zpool status`: [source, shell] .... # zpool status storage - pool: storage + pool: storage state: ONLINE - scrub: scrub completed with 0 errors on Sat Jan 26 19:57:37 2013 + scan: scrub repaired 0B in 00:19:16 with 0 errors on Sat Jul 11 10:32:19 2026 config: - NAME STATE READ WRITE CKSUM - storage ONLINE 0 0 0 - raidz1 ONLINE 0 0 0 - da0 ONLINE 0 0 0 - da1 ONLINE 0 0 0 - da2 ONLINE 0 0 0 + NAME STATE READ WRITE CKSUM + storage ONLINE 0 0 0 + raidz1-0 ONLINE 0 0 0 + ada0p1 ONLINE 0 0 0 + ada1p1 ONLINE 0 0 0 + ada2p1 ONLINE 0 0 0 errors: No known data errors .... Отображение даты завершения последней очистки помогает определить, когда начать следующую. Регулярная очистка защищает данные от тихих повреждений и гарантирует целостность пула. См. man:zfs[8] и man:zpool[8] для других опций ZFS. [[zfs-zpool]] == Администрирование `zpool` Управление ZFS осуществляется с помощью двух основных утилит. Утилита `zpool` контролирует работу пула и позволяет добавлять, удалять, заменять и управлять дисками. Утилита crossref:zfs[zfs-zfs,`zfs`] позволяет создавать, уничтожать и управлять наборами данных, включая как crossref:zfs[zfs-term-filesystem,файловые системы], так и crossref:zfs[zfs-term-volume,тома]. [[zfs-zpool-create]] === Создание и удаление пулов хранения данных -Создание пула хранения ZFS требует принятия окончательного решения о нескольких параметрах, так как структура пула не может быть изменена после создания. Наиболее важное решение — это выбор типов vdev, в которые будут объединены физические диски. Подробнее о возможных вариантах см. в списке crossref:zfs[zfs-term-vdev,типов vdev]. После создания пула большинство типов vdev не позволяют добавлять диски в vdev. Исключения составляют зеркала (mirror), которые позволяют добавлять новые диски в vdev, и страйпы (stripe), которые могут быть преобразованы в зеркала путём добавления нового диска к vdev. Хотя добавление новых vdev расширяет пул, компоновка пула не может быть изменена после его создания. Вместо этого необходимо создать резервную копию данных, удалить пул и воссоздать его. +Самое важное решение при создании пула хранения ZFS — это выбор типов vdev для группировки физических дисков. См. список crossref:zfs[zfs-term-vdev,типов vdev] для получения подробной информации о возможных вариантах. Типы vdev определяют характеристики избыточности, ёмкости и производительности пула. Раскладка пула не фиксируется навсегда при его создании. Зеркала позволяют добавлять новые диски в vdev, а полосы (stripes) обновляются до зеркал путём присоединения нового диска к vdev. Vdev RAID-Z увеличиваются на один диск за раз с помощью crossref:zfs[zfs-zpool-raidz-expansion,расширения RAID-Z], которое требует OpenZFS 2.3 или более поздней версии, впервые доступной во FreeBSD 15.0. Добавление новых vdev расширяет пул в любое время, а crossref:zfs[zfs-zpool-attach,удаление верхних уровней vdev] возможно в определённых пределах. Изменение формы активного пула занимает время и пропускную способность ввода-вывода, поэтому выбор подходящих типов vdev заранее остаётся важным. -Создание простого зеркального пула: +Создайте простой зеркальный пул на дисках, содержащих GPT-разделы типа `freebsd-zfs`: [source, shell] .... -# zpool create mypool mirror /dev/ada1 /dev/ada2 +# zpool create mypool mirror /dev/ada1p1 /dev/ada2p1 # zpool status pool: mypool state: ONLINE - scan: none requested config: NAME STATE READ WRITE CKSUM mypool ONLINE 0 0 0 mirror-0 ONLINE 0 0 0 - ada1 ONLINE 0 0 0 - ada2 ONLINE 0 0 0 + ada1p1 ONLINE 0 0 0 + ada2p1 ONLINE 0 0 0 errors: No known data errors .... -Чтобы создать более одного vdev одной командой, укажите группы дисков, разделенные ключевым словом типа vdev, в данном примере `mirror`: +Чтобы создать более одного vdev одной командой, укажите группы дисков, разделённые ключевым словом типа vdev, в данном примере `mirror`: [source, shell] .... -# zpool create mypool mirror /dev/ada1 /dev/ada2 mirror /dev/ada3 /dev/ada4 +# zpool create mypool mirror /dev/ada1p1 /dev/ada2p1 mirror /dev/ada3p1 /dev/ada4p1 # zpool status pool: mypool state: ONLINE - scan: none requested config: NAME STATE READ WRITE CKSUM mypool ONLINE 0 0 0 mirror-0 ONLINE 0 0 0 - ada1 ONLINE 0 0 0 - ada2 ONLINE 0 0 0 + ada1p1 ONLINE 0 0 0 + ada2p1 ONLINE 0 0 0 mirror-1 ONLINE 0 0 0 - ada3 ONLINE 0 0 0 - ada4 ONLINE 0 0 0 + ada3p1 ONLINE 0 0 0 + ada4p1 ONLINE 0 0 0 errors: No known data errors .... Пулы также могут использовать разделы вместо целых дисков. Размещение ZFS в отдельном разделе позволяет одному диску иметь другие разделы для иных целей. В частности, это позволяет добавлять разделы с загрузочным кодом и файловыми системами, необходимыми для загрузки. Это даёт возможность загружаться с дисков, которые также являются членами пула. ZFS не приводит к снижению производительности на FreeBSD при использовании раздела вместо целого диска. Использование разделов также позволяет администратору _недоиспользовать_ диски, задействуя не всю их емкость. Если будущий заменяемый диск того же номинального размера, что и оригинальный, на самом деле имеет немного меньшую емкость, меньший раздел все равно поместится на заменяемом диске. Создание пула crossref:zfs[zfs-term-vdev-raidz,RAID-Z2] с использованием разделов: [source, shell] .... -# zpool create mypool raidz2 /dev/ada0p3 /dev/ada1p3 /dev/ada2p3 /dev/ada3p3 /dev/ada4p3 /dev/ada5p3 +# zpool create mypool raidz2 /dev/ada0p1 /dev/ada1p1 /dev/ada2p1 /dev/ada3p1 /dev/ada4p1 /dev/ada5p1 # zpool status pool: mypool state: ONLINE - scan: none requested config: NAME STATE READ WRITE CKSUM mypool ONLINE 0 0 0 raidz2-0 ONLINE 0 0 0 - ada0p3 ONLINE 0 0 0 - ada1p3 ONLINE 0 0 0 - ada2p3 ONLINE 0 0 0 - ada3p3 ONLINE 0 0 0 - ada4p3 ONLINE 0 0 0 - ada5p3 ONLINE 0 0 0 + ada0p1 ONLINE 0 0 0 + ada1p1 ONLINE 0 0 0 + ada2p1 ONLINE 0 0 0 + ada3p1 ONLINE 0 0 0 + ada4p1 ONLINE 0 0 0 + ada5p1 ONLINE 0 0 0 errors: No known data errors .... +ZFS выравнивает и подбирает размер своих минимальных записей для каждого vdev на основе значения `ashift` этого vdev, которое является логарифмом размера сектора по основанию 2. OpenZFS определяет размер сектора, сообщаемый дисками при создании vdev, и выбирает `ashift` соответствующим образом. Некоторые диски сообщают секторы в 512 байт для совместимости, но внутренне используют секторы в 4096 байт. Создавайте пулы на таких дисках с явным параметром `-o ashift=12`, чтобы принудительно установить выравнивание по 4096 байт: + +[source, shell] +.... +# zpool create -o ashift=12 mypool mirror /dev/ada1p1 /dev/ada2p1 +.... + +Установка переменной man:sysctl[8] `vfs.zfs.vdev.min_auto_ashift` в значение `12` дает тот же результат для создания пула и для последующих операций `zpool add` и `zpool attach`. `ashift` — это свойство каждого vdev, а не пула в целом. Оно фиксируется при создании vdev и не может быть изменено впоследствии, поэтому проверьте его перед записью данных в пул. + Уничтожьте пул, который больше не нужен, чтобы повторно использовать диски. Перед уничтожением пула необходимо размонтировать файловые системы в этом пуле. Если какой-либо набор данных используется, операция размонтирования завершится неудачей без уничтожения пула. Принудительное уничтожение пула выполняется с помощью `-f`. Это может привести к неопределённому поведению приложений, у которых были открыты файлы в этих наборах данных. +[[zfs-zpool-props]] +=== Свойства пулов + +Подобно наборам данных, пулы имеют свойства, которые сообщают о состоянии и управляют поведением. Отобразите каждое свойство пула с помощью `zpool get all _mypool_` или укажите конкретные свойства: + +[source, shell] +.... +# zpool get health,capacity mypool +NAME PROPERTY VALUE SOURCE +mypool health ONLINE - +mypool capacity 27% - +.... + +Измените изменяемое свойство с помощью `zpool set`: + +[source, shell] +.... +# zpool set comment="Backup pool" mypool +# zpool get comment mypool +NAME PROPERTY VALUE SOURCE +mypool comment Backup pool local +.... + +Такие свойства, как `size`, `capacity`, `fragmentation` и `health`, являются статусными значениями только для чтения. Другие изменяют поведение пула; в этой главе используется `autoexpand` для автоматического расширения пула (crossref:zfs[zfs-zpool-online,Увеличение размера пула]), `autoreplace` с горячими резервными дисками (crossref:zfs[zfs-zpool-spares,Горячие резервные диски и автоматическая замена с помощью zfsd]), `autotrim` на пулах с SSD (crossref:zfs[zfs-zpool-trim,TRIM and Initialization]) и `compatibility` для переносимых пулов (crossref:zfs[zfs-zpool-upgrade,Обновление пула дисков]). Устанавливайте свойства при создании пула, передавая `-o` команде `zpool create`, как показано выше с `ashift`. man:zpoolprops[7] описывает все свойства пула. + [[zfs-zpool-attach]] === Добавление и удаление устройств -Существует два способа добавления дисков в пул: подключение диска к существующему vdev с помощью `zpool attach` или добавление vdev в пул с помощью `zpool add`. Некоторые crossref:zfs[zfs-term-vdev,типы vdev] позволяют добавлять диски в vdev после его создания. +Существует два способа добавления дисков в пул: подключение диска к существующему vdev с помощью `zpool attach` или добавление vdev в пул с помощью `zpool add`. Некоторые crossref:zfs[zfs-term-vdev,типы vdev] позволяют добавлять диски в vdev после его создания. Виртуальные устройства (vdev) RAID-Z принимают новые диски исключительно посредством crossref:zfs[zfs-zpool-raidz-expansion,расширения RAID-Z]. Пул, созданный с одним диском, не обладает избыточностью. Он может обнаружить повреждение данных, но не может его исправить, так как нет другой копии данных. Свойство crossref:zfs[zfs-term-copies,Копии (copies)] может восстановить данные после небольшого сбоя, например, повреждённого сектора, но не обеспечивает такой же уровень защиты, как зеркалирование или RAID-Z. Начиная с пула, состоящего из однодискового vdev, используйте `zpool attach` для добавления нового диска в vdev, создавая зеркало. Также используйте `zpool attach` для добавления новых дисков в зеркальную группу, увеличивая избыточность и производительность чтения. При разметке дисков, используемых для пула, повторите разметку первого диска на втором. Используйте `gpart backup` и `gpart restore` для упрощения этого процесса. Обновите однодисковый vdev (stripe) [.filename]#ada0p3# до зеркала, присоединив [.filename]#ada1p3#: [source, shell] .... # zpool status pool: mypool state: ONLINE - scan: none requested config: NAME STATE READ WRITE CKSUM mypool ONLINE 0 0 0 ada0p3 ONLINE 0 0 0 errors: No known data errors # zpool attach mypool ada0p3 ada1p3 -Make sure to wait until resilvering finishes before rebooting. - -If you boot from pool 'mypool', you may need to update boot code on newly attached disk _ada1p3_. - -Assuming you use GPT partitioning and _da0_ is your new boot disk you may use the following command: - - gpart bootcode -b /boot/pmbr -p /boot/gptzfsboot -i 1 da0 +Make sure to wait until resilver is done before rebooting. # gpart bootcode -b /boot/pmbr -p /boot/gptzfsboot -i 1 ada1 +partcode written to ada1p1 bootcode written to ada1 # zpool status pool: mypool state: ONLINE status: One or more devices is currently being resilvered. The pool will continue to function, possibly in a degraded state. action: Wait for the resilver to complete. - scan: resilver in progress since Fri May 30 08:19:19 2014 - 527M scanned out of 781M at 47.9M/s, 0h0m to go - 527M resilvered, 67.53% done + scan: resilver in progress since Sat Jul 11 11:15:25 2026 + 738M scanned at 105M/s, 522M issued at 74.6M/s, 781M total + 522M resilvered, 66.84% done, 00:00:03 to go config: NAME STATE READ WRITE CKSUM mypool ONLINE 0 0 0 mirror-0 ONLINE 0 0 0 ada0p3 ONLINE 0 0 0 ada1p3 ONLINE 0 0 0 (resilvering) errors: No known data errors # zpool status pool: mypool state: ONLINE - scan: resilvered 781M in 0h0m with 0 errors on Fri May 30 08:15:58 2014 + scan: resilvered 781M in 00:00:16 with 0 errors on Sat Jul 11 11:18:36 2026 config: NAME STATE READ WRITE CKSUM mypool ONLINE 0 0 0 mirror-0 ONLINE 0 0 0 ada0p3 ONLINE 0 0 0 ada1p3 ONLINE 0 0 0 errors: No known data errors .... -Если добавление дисков к существующему vdev невозможно, как в случае с RAID-Z, альтернативным методом является добавление другого vdev в пул. Добавление vdev повышает производительность за счет распределения записей между vdev. Каждый vdev обеспечивает свою собственную избыточность. Возможно смешивание типов vdev, таких как `mirror` и `RAID-Z`, но это не рекомендуется. Добавление не избыточного vdev к пулу, содержащему mirror или RAID-Z vdev, подвергает риску данные во всем пуле. Распределение записей означает, что отказ не избыточного диска приведет к потере части каждого блока, записанного в пул. +Если добавление дисков к существующему vdev невозможно, альтернативным методом является добавление другого vdev в пул. Добавление vdev повышает производительность за счет распределения записей между vdev. Каждый vdev обеспечивает свою собственную избыточность. Возможно смешивание типов vdev, таких как `mirror` и `RAID-Z`, но это не рекомендуется. Добавление не избыточного vdev к пулу, содержащему mirror или RAID-Z vdev, подвергает риску данные во всем пуле. Распределение записей означает, что отказ не избыточного диска приведет к потере части каждого блока, записанного в пул. ZFS распределяет данные по всем vdev. Например, при использовании двух зеркальных vdev это фактически эквивалентно RAID 10, где записи распределяются по двум наборам зеркал. ZFS выделяет пространство таким образом, что каждый vdev достигает 100% заполненности одновременно. Наличие vdev с разным количеством свободного места снижает производительность, так как больше данных записывается на менее заполненный vdev. При подключении новых устройств к загрузочному пулу не забудьте обновить загрузочный код. Присоедините вторую группу зеркал ([.filename]#ada2p3# и [.filename]#ada3p3#) к существующему зеркалу: [source, shell] .... # zpool status pool: mypool state: ONLINE - scan: resilvered 781M in 0h0m with 0 errors on Fri May 30 08:19:35 2014 + scan: resilvered 781M in 00:00:16 with 0 errors on Sat Jul 11 12:11:56 2026 config: NAME STATE READ WRITE CKSUM mypool ONLINE 0 0 0 mirror-0 ONLINE 0 0 0 ada0p3 ONLINE 0 0 0 ada1p3 ONLINE 0 0 0 errors: No known data errors # zpool add mypool mirror ada2p3 ada3p3 # gpart bootcode -b /boot/pmbr -p /boot/gptzfsboot -i 1 ada2 +partcode written to ada2p1 bootcode written to ada2 # gpart bootcode -b /boot/pmbr -p /boot/gptzfsboot -i 1 ada3 +partcode written to ada3p1 bootcode written to ada3 # zpool status pool: mypool state: ONLINE - scan: scrub repaired 0 in 0h0m with 0 errors on Fri May 30 08:29:51 2014 + scan: resilvered 781M in 00:00:16 with 0 errors on Sat Jul 11 09:58:28 2026 +config: + + NAME STATE READ WRITE CKSUM + mypool ONLINE 0 0 0 + mirror-0 ONLINE 0 0 0 + ada0p3 ONLINE 0 0 0 + ada1p3 ONLINE 0 0 0 + mirror-1 ONLINE 0 0 0 + ada2p3 ONLINE 0 0 0 + ada3p3 ONLINE 0 0 0 + +errors: No known data errors +.... + +`zpool add` также присоединяет выделенные устройства журнала и кэша к существующему пулу. crossref:zfs[zfs-term-vdev-log,Журнал] vdev хранит журнал намерений ZFS на отдельном хранилище с низкой задержкой, ускоряя синхронные записи, такие как те, что выполняются базами данных и NFS. Зеркалируйте устройства журнала, потому что потеря незеркалированного устройства журнала вместе с сбоем системы стоит пулу последних нескольких секунд синхронных записей; см. раздел crossref:zfs[zfs-advanced-zil-slog,"Синхронные записи, ZIL и SLOG"] для рекомендаций по размеру и настройке. crossref:zfs[zfs-term-vdev-cache,Кэш] vdev расширяет crossref:zfs[zfs-term-arc,ARC] вторым уровнем кэша чтения на быстром хранилище. Устройства кэша не требуют избыточности, так как ZFS вместо этого читает любой блок, который не удалось прочитать из кэша, с исходных дисков пула. Содержимое кэша, crossref:zfs[zfs-term-l2arc,L2ARC], по умолчанию сохраняется после перезагрузки. + +Добавьте зеркальный журнальный vdev и NVMe-устройство кэша к существующему пулу: + +[source, shell] +.... +# zpool add mypool log mirror ada4p2 ada5p2 +# zpool add mypool cache nda0p2 +# zpool status mypool + pool: mypool + state: ONLINE + scan: resilvered 781M in 00:00:16 with 0 errors on Sat Jul 11 09:58:28 2026 config: NAME STATE READ WRITE CKSUM mypool ONLINE 0 0 0 mirror-0 ONLINE 0 0 0 ada0p3 ONLINE 0 0 0 ada1p3 ONLINE 0 0 0 mirror-1 ONLINE 0 0 0 ada2p3 ONLINE 0 0 0 ada3p3 ONLINE 0 0 0 + logs + mirror-2 ONLINE 0 0 0 + ada4p2 ONLINE 0 0 0 + ada5p2 ONLINE 0 0 0 + cache + nda0p2 ONLINE 0 0 0 errors: No known data errors .... -Удаление устройств vdev из пула невозможно, а удаление дисков из зеркала возможно только при сохранении достаточной избыточности. Если в группе зеркала остаётся единственный диск, эта группа перестает быть зеркалом и становится страйпом, что подвергает весь пул риску в случае выхода из строя оставшегося диска. +Команда `zpool detach` удаляет отдельные диски из зеркального виртуального устройства (vdev) при условии сохранения достаточной избыточности. Если в группе зеркала остаётся единственный диск, эта группа перестает быть зеркалом и становится страйпом, что подвергает весь пул риску в случае выхода из строя оставшегося диска. Удалить диск из трёхдисковой зеркальной группы: [source, shell] .... # zpool status pool: mypool state: ONLINE - scan: scrub repaired 0 in 0h0m with 0 errors on Fri May 30 08:29:51 2014 + scan: scrub repaired 0B in 00:01:11 with 0 errors on Sat Jul 11 03:14:02 2026 config: NAME STATE READ WRITE CKSUM mypool ONLINE 0 0 0 mirror-0 ONLINE 0 0 0 ada0p3 ONLINE 0 0 0 ada1p3 ONLINE 0 0 0 ada2p3 ONLINE 0 0 0 errors: No known data errors # zpool detach mypool ada2p3 # zpool status pool: mypool state: ONLINE - scan: scrub repaired 0 in 0h0m with 0 errors on Fri May 30 08:29:51 2014 + scan: scrub repaired 0B in 00:01:11 with 0 errors on Sat Jul 11 03:14:02 2026 +config: + + NAME STATE READ WRITE CKSUM + mypool ONLINE 0 0 0 + mirror-0 ONLINE 0 0 0 + ada0p3 ONLINE 0 0 0 + ada1p3 ONLINE 0 0 0 + +errors: No known data errors +.... + +`zpool remove` удаляет целые vdev верхнего уровня из пула. ZFS эвакуирует vdev, копируя все выделенные ему данные на другие vdev в пуле, а затем отсоединяет диски. Удаление работает для горячих резервов, кэша, журналов, специальных и дедупликационных устройств, а также для data vdev, которые являются одиночными дисками или зеркалами. Data vdev не могут быть удалены из пулов, содержащих vdev RAID-Z верхнего уровня, и все vdev верхнего уровня в пуле должны использовать одинаковый `ashift`. Эвакуация выполняется в фоновом режиме, и пул остается онлайн на протяжении всего процесса; следите за прогрессом с помощью `zpool status`. После завершения удаления ZFS сохраняет таблицу в памяти, сопоставляющую блоки удаленного vdev с их новыми местоположениями. Таблица небольшая, но постоянная; `zpool remove -n` оценивает использование памяти перед началом удаления. + +Удалите один из двух зеркальных vdev из пула: + +[source, shell] +.... +# zpool remove mypool mirror-1 +# zpool status mypool + pool: mypool + state: ONLINE + scan: scrub repaired 0B in 00:01:11 with 0 errors on Sat Jul 11 03:14:02 2026 +remove: Evacuation of mirror in progress since Sat Jul 11 10:15:31 2026 + 1.71G copied out of 2.32G at 111M/s, 73.71% done, 0h0m to go config: NAME STATE READ WRITE CKSUM mypool ONLINE 0 0 0 mirror-0 ONLINE 0 0 0 ada0p3 ONLINE 0 0 0 ada1p3 ONLINE 0 0 0 + mirror-1 ONLINE 0 0 0 + ada2p3 ONLINE 0 0 0 + ada3p3 ONLINE 0 0 0 + +errors: No known data errors +# zpool status mypool + pool: mypool + state: ONLINE + scan: scrub repaired 0B in 00:01:11 with 0 errors on Sat Jul 11 03:14:02 2026 +remove: Removal of vdev 1 copied 2.32G in 0h0m, completed on Sat Jul 11 10:15:53 2026 + 10.9K memory used for removed device mappings +config: + + NAME STATE READ WRITE CKSUM + mypool ONLINE 0 0 0 + mirror-0 ONLINE 0 0 0 + ada0p3 ONLINE 0 0 0 + ada1p3 ONLINE 0 0 0 + indirect-1 ONLINE 0 0 0 + +errors: No known data errors +.... + +Запись `indirect-1` является заполнителем для переотображённых блоков удалённого vdev и не содержит дисков. Отмените выполняющееся удаление с помощью `zpool remove -s`. + +[[zfs-zpool-raidz-expansion]] +=== Расширение RAID-Z + +Расширение RAID-Z увеличивает существующий vdev RAID-Z на один диск за раз, не изменяя его уровень чётности. + +[NOTE] +==== +Расширение RAID-Z требует OpenZFS 2.3 или более поздней версии, впервые доступной в FreeBSD 15.0. Пулы, созданные в более ранних версиях, требуют включения функции `raidz_expansion` с помощью `zpool upgrade` перед расширением. +==== + +Чтобы расширить vdev RAID-Z, выполните `zpool attach`, указав имя vdev RAID-Z, как показано в `zpool status`, и новый диск: + +[source, shell] +.... +# zpool attach mypool raidz2-0 ada6p3 +.... + +Расширение перераспределяет существующие данные по увеличенному набору дисков в фоновом режиме, при этом пул остается online и используется. Добавьте `-w`, чтобы заставить `zpool attach` ожидать завершения расширения. `zpool status` сообщает о ходе выполнения в строке `expand:`: + +[source, shell] +.... +# zpool status mypool + pool: mypool + state: ONLINE + scan: scrub repaired 0B in 06:14:36 with 0 errors on Sat Jul 11 04:31:19 2026 +expand: expansion of raidz2-0 in progress since Sat Jul 11 09:42:12 2026 + 1.83T / 5.36T copied at 186M/s, 34.14% done, 05:31:43 to go +config: + + NAME STATE READ WRITE CKSUM + mypool ONLINE 0 0 0 + raidz2-0 ONLINE 0 0 0 + ada0p3 ONLINE 0 0 0 + ada1p3 ONLINE 0 0 0 + ada2p3 ONLINE 0 0 0 + ada3p3 ONLINE 0 0 0 + ada4p3 ONLINE 0 0 0 + ada5p3 ONLINE 0 0 0 + ada6p3 ONLINE 0 0 0 errors: No known data errors .... +Когда расширение завершается, ёмкость нового диска становится доступной: + +[source, shell] +.... +# zpool status mypool | grep expand: +expand: expanded raidz2-0 copied 5.36T in 08:23:35, on Sat Jul 11 18:05:47 2026 +.... + +Блоки, записанные до расширения, сохраняют прежнее соотношение данных и чётности и продолжают занимать место соответствующим образом. Таким образом, полный прирост ёмкости от нового диска применяется к данным, записанным после расширения, тогда как старые данные выигрывают только при перезаписи, например, с помощью crossref:zfs[zfs-zfs-rewrite,`zfs rewrite`]. Повторите процедуру для увеличения vdev на несколько дисков, подключая их по одному. + +[[zfs-zpool-draid]] +=== Пулы dRAID + +dRAID — это вариант RAID-Z, который распределяет резервную емкость горячего резерва по всем дискам в vdev. crossref:zfs[zfs-term-vdev-draid,dRAID] vdev состоит из внутренних групп RAID-Z плюс опциональных _распределенных резервов_, равномерно распределенных по каждому диску. Когда диск выходит из строя, ZFS выполняет перестроение в распределенный резерв, читая и записывая на все оставшиеся диски параллельно, завершая процесс за долю времени, которое требуется для ресилверинга на один резервный диск. Замена вышедшего из строя диска затем перестраивает его из распределенного резерва, восстанавливая полную защиту. dRAID ориентирован на пулы с множеством дисков, где время перестроения RAID-Z становится опасно большим. + +Тип vdev описывает полную компоновку, согласно man:zpoolconcepts[7]: + +[.programlisting] +.... +draid[parity][:datad][:childrenc][:sparess] +.... + +_parity_ — это уровень чётности внутренних групп, от 1 до 3, по умолчанию 1. _data_ — это количество устройств данных на группу резервирования, по умолчанию 8. _children_ — это общее количество дисков, служащее перекрестной проверкой при перечислении многих устройств. _spares_ — это количество распределенных горячих резервов, по умолчанию 0. + +Создайте пул из 24-дискового vdev dRAID с двойной четностью, 8 дисками данных на группу избыточности и 2 распределенными резервными дисками: + +[source, shell] +.... +# zpool create mypool draid2:8d:24c:2s ada0 ada1 ada2 ada3 ada4 ada5 ada6 ada7 ada8 ada9 ada10 ada11 ada12 ada13 ada14 ada15 ada16 ada17 ada18 ada19 ada20 ada21 ada22 ada23 +.... + +Распределенные запасные диски отображаются в разделе `spares` в `zpool status`, с именами вроде `draid2-0-0` для первого запасного диска первого vdev. + +dRAID обменивает эффективность использования пространства на скорость перестроения. В отличие от RAID-Z, dRAID использует фиксированную ширину полосы, дополняя мелкие записи нулями. При стандартных 8 дисках данных и секторах 4 КБ минимальное выделение составляет 32 КБ, что снижает полезную ёмкость и эффективность сжатия для наборов данных, где преобладают мелкие блоки. Ёмкость распределённых запасных дисков также резервируется заранее, независимо от того, произойдёт ли сбой диска когда-либо. Объединение пула dRAID со crossref:zfs[zfs-zpool-special,специальным vdev] удерживает метаданные и мелкие блоки вне широких полос и возвращает большую часть потерянной эффективности. Для пулов с несколькими дисками RAID-Z остаётся лучшим выбором. + +[[zfs-zpool-special]] +=== Специальные классы выделения + +Специальные классы выделения привязывают vdev-устройства к конкретным типам данных пула. Vdev crossref:zfs[zfs-term-vdev-special,special] хранит метаданные пула, такие как непрямые блоки и dnode, а также, опционально, блоки данных небольших файлов. Vdev `dedup` хранит таблицы crossref:zfs[zfs-term-deduplication,дедупликации]. Размещение этих метаданных на быстрых устройствах, таких как зеркала NVMe, ускоряет операции, требовательные к метаданным, например обход каталогов, `zfs list` и поиск при дедупликации в пулах, состоящих в остальном из более медленных дисков. + +Добавьте зеркальный специальный vdev к существующему пулу: + +[source, shell] +.... +# zpool add mypool special mirror nda0 nda1 +.... + +Новые выделения метаданных затем направляются в специальный vdev; существующие метаданные остаются на месте, пока не будут перезаписаны. + +Установка свойства `special_small_blocks` набора данных позволяет специальному vdev хранить блоки данных размером до указанного значения: + +[source, shell] +.... +# zfs set special_small_blocks=16K mypool/projects +.... + +Допустимые значения — ноль, который отключает хранение блоков данных в специальном классе, или степень двойки от 512 байт до 1 МБ в FreeBSD 14.x; FreeBSD 15.0 принимает значения вплоть до максимального размера блока в 16 МБ. Установка этого свойства на `recordsize` набора данных отправляет все блоки данных этого набора данных в специальный класс. Когда специальный vdev заполняется, новые выделения перетекают обратно в обычный класс вместо сбоя. + +[WARNING] +==== +Специальный vdev — это не кэш. Он хранит единственную копию метаданных пула, выделенных ему, и его потеря уничтожает пул. Согласуйте избыточность special и dedup vdev с избыточностью data vdev, например, используя зеркало. +==== + +Удаление специального или дедупликационного vdev с помощью `zpool remove` возможно с учётом ограничений, описанных в crossref:zfs[zfs-zpool-attach,Добавление и удаление устройств]. На практике требование соответствия `ashift` часто препятствует удалению, когда специальный vdev использует устройства с иным размером сектора, чем data vdev. + [[zfs-zpool-status]] === Проверка состояния пула Статус пула важен. Если диск отключается или ZFS обнаруживает ошибку чтения, записи или контрольной суммы, соответствующий счетчик ошибок увеличивается. Вывод команды `status` показывает конфигурацию и состояние каждого устройства в пуле, а также состояние всего пула. Также отображаются действия, которые следует предпринять, и детали последнего crossref:zfs[zfs-zpool-scrub,`scrub`]. [source, shell] .... # zpool status pool: mypool state: ONLINE - scan: scrub repaired 0 in 2h25m with 0 errors on Sat Sep 14 04:25:50 2013 + scan: scrub repaired 0B in 02:25:36 with 0 errors on Sat Jul 11 06:51:26 2026 config: NAME STATE READ WRITE CKSUM mypool ONLINE 0 0 0 raidz2-0 ONLINE 0 0 0 ada0p3 ONLINE 0 0 0 ada1p3 ONLINE 0 0 0 ada2p3 ONLINE 0 0 0 ada3p3 ONLINE 0 0 0 ada4p3 ONLINE 0 0 0 ada5p3 ONLINE 0 0 0 errors: No known data errors .... +Опции подстраивают вывод под конкретную задачу: + +* `-v` выводит подробную информацию об ошибках данных, печатая полный список ошибок, обнаруженных с момента последней полной очистки пула, включая имена затронутых файлов. +* `-x` отображает состояние пулов с ошибками или пулов, которые в противном случае недоступны, скрывая исправные пулы. +* `-s` отображает количество медленных операций ввода-вывода на каждом конечном vdev, то есть операций, которые не завершились в течение 30 секунд. +* `-e` отображает только неисправные vdev, сокращая вывод для пулов с большим количеством устройств; этот флаг требует FreeBSD 14.1 или более поздней версии. +* `-p` отображает числа как точные, разбираемые значения вместо округлённых, удобочитаемых. +* `-t` отображает статус crossref:zfs[zfs-zpool-trim,TRIM] для каждого vdev. + +См. man:zpool-status[8] для полного списка опций. + [[zfs-zpool-clear]] === Сброс состояния ошибки При обнаружении ошибки ZFS увеличивает счетчики ошибок чтения, записи или контрольных сумм. Чтобы очистить сообщение об ошибке и сбросить счетчики, используйте команду `zpool clear _mypool_`. Сброс состояния ошибки может быть важен для автоматизированных скриптов, которые уведомляют администратора при возникновении ошибки в пуле. Без очистки старых ошибок скрипты могут не сообщать о новых ошибках. [[zfs-zpool-replace]] === Замена рабочего устройства Может потребоваться заменить один диск на другой. При замене рабочего диска процесс сохраняет старый диск в режиме онлайн во время замены. Пул никогда не переходит в состояние crossref:zfs[zfs-term-degraded,деградировавшего], что снижает риск потери данных. Выполнение команды `zpool replace` копирует данные со старого диска на новый. После завершения операции ZFS отключает старый диск от vdev. Если новый диск больше старого, можно расширить zpool, используя новое пространство. См. crossref:zfs[zfs-zpool-online,Расширение пула]. Заменить работающее устройство в пуле: [source, shell] .... # zpool status pool: mypool state: ONLINE - scan: none requested config: NAME STATE READ WRITE CKSUM mypool ONLINE 0 0 0 mirror-0 ONLINE 0 0 0 ada0p3 ONLINE 0 0 0 ada1p3 ONLINE 0 0 0 errors: No known data errors # zpool replace mypool ada1p3 ada2p3 Make sure to wait until resilvering finishes before rebooting. -When booting from the pool 'zroot', update the boot code on the newly attached disk 'ada2p3'. +When booting from the pool 'mypool', update the boot code on the newly attached disk 'ada2p3'. -Assuming GPT partitioning is used and [.filename]#da0# is the new boot disk, use the following command: +Assuming GPT partitioning is used and ada0 is the new boot disk, use the following command: - gpart bootcode -b /boot/pmbr -p /boot/gptzfsboot -i 1 da0 + gpart bootcode -b /boot/pmbr -p /boot/gptzfsboot -i 1 ada0 # gpart bootcode -b /boot/pmbr -p /boot/gptzfsboot -i 1 ada2 # zpool status pool: mypool state: ONLINE status: One or more devices is currently being resilvered. The pool will continue to function, possibly in a degraded state. action: Wait for the resilver to complete. - scan: resilver in progress since Mon Jun 2 14:21:35 2014 - 604M scanned out of 781M at 46.5M/s, 0h0m to go - 604M resilvered, 77.39% done + scan: resilver in progress since Sat Jul 11 14:21:35 2026 + 781M / 781M scanned, 604M / 781M issued at 101M/s + 604M resilvered, 77.39% done, 00:00:01 to go config: NAME STATE READ WRITE CKSUM mypool ONLINE 0 0 0 mirror-0 ONLINE 0 0 0 ada0p3 ONLINE 0 0 0 replacing-1 ONLINE 0 0 0 ada1p3 ONLINE 0 0 0 ada2p3 ONLINE 0 0 0 (resilvering) errors: No known data errors # zpool status pool: mypool state: ONLINE - scan: resilvered 781M in 0h0m with 0 errors on Mon Jun 2 14:21:52 2014 + scan: resilvered 781M in 00:00:17 with 0 errors on Sat Jul 11 14:21:52 2026 config: NAME STATE READ WRITE CKSUM mypool ONLINE 0 0 0 mirror-0 ONLINE 0 0 0 ada0p3 ONLINE 0 0 0 ada2p3 ONLINE 0 0 0 errors: No known data errors .... +На зеркальных vdev-устройствах добавление `-s` к `zpool replace` или `zpool attach` выполняет _последовательное восстановление_ вместо восстанавливающего ресильверинга. Последовательное восстановление копирует данные в порядке расположения на диске без проверки контрольных сумм каждого блока, восстанавливая избыточность гораздо быстрее. Поскольку копирование пропускает проверку контрольных сумм, ZFS автоматически запускает crossref:zfs[zfs-zpool-scrub,scrub] пула после завершения последовательного восстановления. Последовательное восстановление работает на зеркальных и crossref:zfs[zfs-zpool-draid,dRAID] vdev-устройствах, но не на RAID-Z. Перезапустите текущий resilver с начала с помощью `zpool resilver _mypool_`. + [[zfs-zpool-resilver]] === Обработка неисправных устройств Когда диск в пуле выходит из строя, устройство vdev, к которому принадлежит этот диск, переходит в crossref:zfs[zfs-term-degraded,деградировавшее] состояние. Данные остаются доступными, но с пониженной производительностью, поскольку ZFS вычисляет недостающие данные из доступной избыточности. Чтобы восстановить устройство vdev в полностью работоспособное состояние, замените вышедший из строя физический диск. Затем ZFS получает указание начать операцию crossref:zfs[zfs-term-resilver,восстановления]. ZFS пересчитывает данные с вышедшего из строя устройства из доступной избыточности и записывает их на заменённый диск. После завершения процесса устройство vdev возвращается в состояние crossref:zfs[zfs-term-online,онлайн]. Если vdev не имеет избыточности или если устройства вышли из строя и недостаточно избыточности для компенсации, пул переходит в состояние crossref:zfs[zfs-term-faulted,faulted]. Если недостаточно устройств для восстановления связи, пул становится неработоспособным, что требует восстановления данных из резервных копий. При замене вышедшего из строя диска имя отказавшего диска изменяется на GUID нового диска. Новый параметр имени устройства для `zpool replace` не требуется, если заменяющее устройство имеет то же имя устройства. Заменить вышедший из строя диск с помощью `zpool replace`: [source, shell] .... # zpool status pool: mypool state: DEGRADED status: One or more devices could not be opened. Sufficient replicas exist for the pool to continue functioning in a degraded state. action: Attach the missing device and online it using 'zpool online'. - see: http://illumos.org/msg/ZFS-8000-2Q - scan: none requested + see: https://openzfs.github.io/openzfs-docs/msg/ZFS-8000-2Q config: NAME STATE READ WRITE CKSUM mypool DEGRADED 0 0 0 mirror-0 DEGRADED 0 0 0 ada0p3 ONLINE 0 0 0 316502962686821739 UNAVAIL 0 0 0 was /dev/ada1p3 errors: No known data errors # zpool replace mypool 316502962686821739 ada2p3 # zpool status pool: mypool state: DEGRADED status: One or more devices is currently being resilvered. The pool will continue to function, possibly in a degraded state. action: Wait for the resilver to complete. - scan: resilver in progress since Mon Jun 2 14:52:21 2014 - 641M scanned out of 781M at 49.3M/s, 0h0m to go - 640M resilvered, 82.04% done + scan: resilver in progress since Sat Jul 11 14:52:21 2026 + 781M / 781M scanned, 641M / 781M issued at 128M/s + 640M resilvered, 82.04% done, 00:00:01 to go config: NAME STATE READ WRITE CKSUM mypool DEGRADED 0 0 0 mirror-0 DEGRADED 0 0 0 ada0p3 ONLINE 0 0 0 replacing-1 UNAVAIL 0 0 0 15732067398082357289 UNAVAIL 0 0 0 was /dev/ada1p3/old ada2p3 ONLINE 0 0 0 (resilvering) errors: No known data errors # zpool status pool: mypool state: ONLINE - scan: resilvered 781M in 0h0m with 0 errors on Mon Jun 2 14:52:38 2014 + scan: resilvered 781M in 00:00:17 with 0 errors on Sat Jul 11 14:52:38 2026 config: NAME STATE READ WRITE CKSUM mypool ONLINE 0 0 0 mirror-0 ONLINE 0 0 0 ada0p3 ONLINE 0 0 0 ada2p3 ONLINE 0 0 0 errors: No known data errors .... +[[zfs-zpool-spares]] +=== Горячие резервные диски и автоматическая замена с помощью zfsd + +Пулы с избыточными vdev могут регистрировать crossref:zfs[zfs-term-vdev-spare,горячие резервные] диски, которые находятся в режиме ожидания для замены вышедшего из строя устройства. Резервный диск должен быть не меньше устройства, которое он заменяет. Укажите резервные диски при создании пула, перечислив их после ключевого слова `spare`, как в `zpool create _mypool_ mirror _ada0p3_ _ada1p3_ spare _ada3p3_`, или добавьте их в существующий пул с помощью `zpool add`: + +[source, shell] +.... +# zpool add mypool spare ada3p3 +# zpool status + pool: mypool + state: ONLINE +config: + + NAME STATE READ WRITE CKSUM + mypool ONLINE 0 0 0 + mirror-0 ONLINE 0 0 0 + ada0p3 ONLINE 0 0 0 + ada1p3 ONLINE 0 0 0 + spares + ada3p3 AVAIL + +errors: No known data errors +.... + +Запасной диск остается неиспользуемым, отображаясь как `AVAIL`, пока устройство не выйдет из строя. Активируйте запасной диск вручную с помощью `zpool replace`, указав отказавшее устройство и запасной диск: + +[source, shell] +.... +# zpool replace mypool ada1p3 ada3p3 +# zpool status + pool: mypool + state: DEGRADED +status: One or more devices could not be opened. Sufficient replicas exist for + the pool to continue functioning in a degraded state. +action: Attach the missing device and online it using 'zpool online'. + see: https://openzfs.github.io/openzfs-docs/msg/ZFS-8000-2Q + scan: resilvered 781M in 00:00:21 with 0 errors on Sat Jul 11 09:14:33 2026 +config: + + NAME STATE READ WRITE CKSUM + mypool DEGRADED 0 0 0 + mirror-0 DEGRADED 0 0 0 + ada0p3 ONLINE 0 0 0 + spare-1 DEGRADED 0 0 0 + ada1p3 UNAVAIL 0 0 0 cannot open + ada3p3 ONLINE 0 0 0 + spares + ada3p3 INUSE currently in use + +errors: No known data errors +.... + +Запасной диск является временной мерой, и пул остается в этом состоянии, пока администратор не разрешит ситуацию. После физической замены вышедшего из строя диска и повторного зеркалирования нового устройства с помощью crossref:zfs[zfs-zpool-replace,`zpool replace`], верните запасной диск в режим ожидания с помощью `zpool detach _mypool_ _ada3p3_`. Чтобы вместо этого повысить запасной диск до постоянного члена vdev, отсоедините вышедшее из строя устройство с помощью `zpool detach _mypool_ _ada1p3_`. + +Свойство пула `autoreplace`, по умолчанию выключенное, управляет тем, что происходит, когда новый диск появляется в том же физическом месте, что и устройство, ранее принадлежавшее пулу. При установке `autoreplace` в значение `on`, ZFS автоматически заменяет старое устройство новым диском, не требуя команды `zpool replace`: + +[source, shell] +.... +# zpool set autoreplace=on mypool +.... + +На FreeBSD автоматические реакции на сбои, включая выполнение `autoreplace`, выполняются man:zfsd[8], демоном управления отказами ZFS в базовой системе. Демон не включён по умолчанию. Включите и запустите его с помощью команды: + +[source, shell] +.... +# sysrc zfsd_enable="YES" +# service zfsd start +.... + +man:zfsd[8] прослушивает события пула и: + +* Активирует горячий резерв, когда устройство исчезает из избыточного vdev или когда vdev становится деградировавшим или неисправным. +* Отмечает vdev как отказавший, когда он создает более 50 ошибок ввода-вывода или более 8 отложенных операций ввода-вывода за период в 60 секунд, затем активирует горячий резерв. +* Помечает vdev как деградировавший, когда он генерирует более 50 ошибок контрольной суммы за 60-секундный период, затем активирует горячий резерв. +* Возвращает устройство в онлайн-режим, когда оно снова появляется, запуская ресильверинг данных, записанных, пока оно отсутствовало. +* Заменяет отсутствующее устройство новым диском, который появляется в том же физическом местоположении, когда в пуле установлено значение `autoreplace` в `on`. +* Возвращает горячие резервы в режим ожидания после завершения ресильвера постоянной замены. + +[NOTE] +==== +FreeBSD использует man:zfsd[8] для управления отказами. Демон событий ZFS (ZED), присутствующий на платформах Linux OpenZFS, не является частью FreeBSD. +==== + +Изучите поток событий, который управляет этими решениями, с помощью `zpool events`. Добавление `-v` показывает полную полезную нагрузку каждого события, а `-f` оставляет команду работающей, выводя новые события по мере их поступления. ZFS также доставляет эти события в man:devd[8]. Правила в [.filename]#/etc/devd/zfs.conf# записывают их в системный журнал и служат шаблоном для пользовательских действий, таких как отправка почты при деградации пула. + [[zfs-zpool-scrub]] === Чистка пула -Регулярно выполняйте crossref:zfs[zfs-term-scrub,scrub] для пулов, желательно не реже одного раза в месяц. Операция `scrub` интенсивно использует диски и может снизить производительность во время выполнения. Избегайте периодов высокой нагрузки при планировании `scrub` или используйте crossref:zfs[zfs-advanced-tuning-scrub_delay,`vfs.zfs.scrub_delay`] для настройки относительного приоритета `scrub`, чтобы предотвратить замедление других задач. +Регулярно выполняйте crossref:zfs[zfs-term-scrub,scrub] для пулов, желательно не реже одного раза в месяц. Операция `scrub` интенсивно использует диски и может снизить производительность во время выполнения. Избегайте периодов высокой нагрузки при планировании `scrub` или снизьте его влияние с помощью настраиваемых параметров планировщика ввода-вывода, описанных в crossref:zfs[zfs-advanced-tuning,разделе «Настройка»]. [source, shell] .... # zpool scrub mypool # zpool status pool: mypool state: ONLINE - scan: scrub in progress since Wed Feb 19 20:52:54 2014 - 116G scanned out of 8.60T at 649M/s, 3h48m to go - 0 repaired, 1.32% done + scan: scrub in progress since Sat Jul 11 20:52:54 2026 + 130G / 8.60T scanned at 649M/s, 116G / 8.60T issued at 580M/s + 0B repaired, 1.32% done, 04:15:41 to go config: NAME STATE READ WRITE CKSUM mypool ONLINE 0 0 0 raidz2-0 ONLINE 0 0 0 ada0p3 ONLINE 0 0 0 ada1p3 ONLINE 0 0 0 ada2p3 ONLINE 0 0 0 ada3p3 ONLINE 0 0 0 ada4p3 ONLINE 0 0 0 ada5p3 ONLINE 0 0 0 errors: No known data errors .... -Если возникла необходимость отменить операцию scrub, выполните `zpool scrub -s _mypool_`. +Приостановите выполняющуюся проверку с помощью `zpool scrub -p _mypool_`, если она мешает другой работе; повторный запуск `zpool scrub _mypool_` возобновит её с того места, где она остановилась. Чтобы вместо этого отменить операцию проверки, выполните `zpool scrub -s _mypool_`. Команда `zpool scrub -w _mypool_` ожидает завершения проверки перед возвратом, что полезно в скриптах. Если после проверки сообщается об ошибках, `zpool scrub -e _mypool_` выполняет _проверку ошибок_, которая повторно проверяет только блоки с известными ошибками, завершаясь гораздо быстрее, чем полная проверка. Проверка ошибок требует OpenZFS 2.2, впервые включённого в FreeBSD 14.0. + +man:periodic[8] может автоматически запускать проверки. Чтобы проверить каждый пул, последняя проверка которого была более 35 дней назад, добавьте эту строку в [.filename]#/etc/periodic.conf#: + +[.programlisting] +.... +daily_scrub_zfs_enable="YES" +.... + +Установите `daily_scrub_zfs_default_threshold="_дней_"`, чтобы изменить количество дней между проверками. man:periodic.conf[5] также описывает пороговые значения для отдельных пулов. Установка `daily_status_zfs_enable="YES"` добавляет проверку состояния пула в ежедневный отчёт man:periodic[8]. [[zfs-zpool-selfheal]] === Самолечение Контрольные суммы, хранимые с блоками данных, позволяют файловой системе _самовосстанавливаться_. Эта функция автоматически исправляет данные, контрольная сумма которых не совпадает с записанной на другом устройстве, входящем в состав пула хранения. Например, в конфигурации зеркала с двумя дисками, где один из дисков начинает работать со сбоями и больше не может корректно хранить данные. Это становится ещё хуже, если данные долгое время не были доступны, как в случае долгосрочного архивного хранения. Традиционные файловые системы требуют выполнения команд для проверки и исправления данных, таких как man:fsck[8]. Эти команды занимают время, а в сложных случаях администратору приходится выбирать, какую операцию восстановления выполнить. Когда ZFS обнаруживает блок данных с несовпадающей контрольной суммой, он пытается прочитать данные с зеркального диска. Если этот диск может предоставить корректные данные, ZFS передаст их приложению и исправит данные на диске с ошибочной контрольной суммой. Это происходит без какого-либо вмешательства администратора в ходе обычной работы пула. -Следующий пример демонстрирует самовосстановление при создании зеркального пула из дисков [.filename]#/dev/ada0# и [.filename]#/dev/ada1#. +Следующий пример демонстрирует самовосстановление при создании зеркального пула из разделов [.filename]#/dev/ada0p1# и [.filename]#/dev/ada1p1#. [source, shell] .... -# zpool create healer mirror /dev/ada0 /dev/ada1 +# zpool create healer mirror /dev/ada0p1 /dev/ada1p1 # zpool status healer pool: healer state: ONLINE - scan: none requested config: NAME STATE READ WRITE CKSUM healer ONLINE 0 0 0 mirror-0 ONLINE 0 0 0 - ada0 ONLINE 0 0 0 - ada1 ONLINE 0 0 0 + ada0p1 ONLINE 0 0 0 + ada1p1 ONLINE 0 0 0 errors: No known data errors # zpool list -NAME SIZE ALLOC FREE CKPOINT EXPANDSZ FRAG CAP DEDUP HEALTH ALTROOT -healer 960M 92.5K 960M - - 0% 0% 1.00x ONLINE - +NAME SIZE ALLOC FREE CKPOINT EXPANDSZ FRAG CAP DEDUP HEALTH ALTROOT +healer 960M 111K 960M - - 0% 0% 1.00x ONLINE - .... Скопируйте какие-нибудь важные данные в пул для защиты от ошибок данных с использованием функции самовосстановления и создайте контрольную сумму пула для последующего сравнения. [source, shell] .... # cp /some/important/data /healer -# zfs list -NAME SIZE ALLOC FREE CAP DEDUP HEALTH ALTROOT -healer 960M 67.7M 892M 7% 1.00x ONLINE - +# zpool list +NAME SIZE ALLOC FREE CKPOINT EXPANDSZ FRAG CAP DEDUP HEALTH ALTROOT +healer 960M 67.7M 892M - - 0% 7% 1.00x ONLINE - # sha1 /healer > checksum.txt # cat checksum.txt SHA1 (/healer) = 2753eff56d77d9a536ece6694bf0a82740344d1f .... Симулируйте повреждение данных, записав случайные данные в начало одного из дисков в зеркале. Чтобы предотвратить восстановление данных ZFS при обнаружении, экспортируйте пул перед повреждением и снова импортируйте его после. [WARNING] ==== Это опасная операция, которая может уничтожить важные данные, и приведена здесь только для демонстрации. *Не пытайтесь* выполнить её во время нормальной работы хранилища данных. Также этот пример преднамеренного повреждения не должен выполняться на диске, содержащем файловую систему, не использующую ZFS на другом разделе. Не используйте имена дисковых устройств, кроме тех, что входят в пул. Убедитесь, что существуют резервные копии пула, и проверьте их перед выполнением команды! ==== [source, shell] .... # zpool export healer -# dd if=/dev/random of=/dev/ada1 bs=1m count=200 +# dd if=/dev/random of=/dev/ada1p1 bs=1m count=200 200+0 records in 200+0 records out 209715200 bytes transferred in 62.992162 secs (3329227 bytes/sec) # zpool import healer .... -Статус пула показывает, что на одном устройстве произошла ошибка. Обратите внимание, что приложения, читающие данные из пула, не получили некорректных данных. ZFS предоставил данные с устройства [.filename]#ada0# с правильными контрольными суммами. Чтобы найти устройство с неверной контрольной суммой, ищите то, у которого в столбце `CKSUM` указано ненулевое значение. +Статус пула показывает, что на одном устройстве произошла ошибка. Обратите внимание, что приложения, читающие данные из пула, не получили некорректных данных. ZFS предоставил данные с устройства [.filename]#ada0p1# с правильными контрольными суммами. Чтобы найти устройство с неверной контрольной суммой, ищите то, у которого в столбце `CKSUM` указано ненулевое значение. [source, shell] .... # zpool status healer - pool: healer - state: ONLINE - status: One or more devices has experienced an unrecoverable error. An - attempt was made to correct the error. Applications are unaffected. - action: Determine if the device needs to be replaced, and clear the errors - using 'zpool clear' or replace the device with 'zpool replace'. - see: http://illumos.org/msg/ZFS-8000-4J - scan: none requested - config: - - NAME STATE READ WRITE CKSUM - healer ONLINE 0 0 0 - mirror-0 ONLINE 0 0 0 - ada0 ONLINE 0 0 0 - ada1 ONLINE 0 0 1 + pool: healer + state: ONLINE +status: One or more devices has experienced an unrecoverable error. An + attempt was made to correct the error. Applications are unaffected. +action: Determine if the device needs to be replaced, and clear the errors + using 'zpool clear' or replace the device with 'zpool replace'. + see: https://openzfs.github.io/openzfs-docs/msg/ZFS-8000-9P +config: + + NAME STATE READ WRITE CKSUM + healer ONLINE 0 0 0 + mirror-0 ONLINE 0 0 0 + ada0p1 ONLINE 0 0 0 + ada1p1 ONLINE 0 0 1 errors: No known data errors .... -ZFS обнаружил ошибку и обработал её, используя избыточность на неповреждённом зеркальном диске [.filename]#ada0#. Сравнение контрольных сумм с исходными покажет, восстановлена ли согласованность пула. +ZFS обнаружил ошибку и обработал её, используя избыточность на неповреждённом зеркальном диске [.filename]#ada0p1#. Сравнение контрольных сумм с исходными покажет, восстановлена ли согласованность пула. [source, shell] .... # sha1 /healer >> checksum.txt # cat checksum.txt SHA1 (/healer) = 2753eff56d77d9a536ece6694bf0a82740344d1f SHA1 (/healer) = 2753eff56d77d9a536ece6694bf0a82740344d1f .... -Генерируйте контрольные суммы до и после намеренного изменения данных, пока данные в пуле ещё совпадают. Это демонстрирует, как ZFS способен автоматически обнаруживать и исправлять любые ошибки, когда контрольные суммы различаются. Обратите внимание, что это возможно только при наличии достаточной избыточности в пуле. Пул, состоящий из одного устройства, не обладает возможностями самовосстановления. Именно поэтому контрольные суммы так важны в ZFS — не отключайте их ни по какой причине. ZFS не требует использования man:fsck[8] или аналогичной программы проверки целостности файловой системы для обнаружения и исправления ошибок, а также поддерживает доступность пула даже при наличии проблемы. Теперь требуется операция scrub для перезаписи поврежденных данных на [.filename]#ada1#. +Генерируйте контрольные суммы до и после намеренного изменения данных, пока данные в пуле ещё совпадают. Это демонстрирует, как ZFS способен автоматически обнаруживать и исправлять любые ошибки, когда контрольные суммы различаются. Обратите внимание, что это возможно только при наличии достаточной избыточности в пуле. Пул, состоящий из одного устройства, не обладает возможностями самовосстановления. Именно поэтому контрольные суммы так важны в ZFS — не отключайте их ни по какой причине. ZFS не требует использования man:fsck[8] или аналогичной программы проверки целостности файловой системы для обнаружения и исправления ошибок, а также поддерживает доступность пула даже при наличии проблемы. Теперь требуется операция scrub для перезаписи поврежденных данных на [.filename]#ada1p1#. [source, shell] .... # zpool scrub healer # zpool status healer pool: healer state: ONLINE status: One or more devices has experienced an unrecoverable error. An - attempt was made to correct the error. Applications are unaffected. + attempt was made to correct the error. Applications are unaffected. action: Determine if the device needs to be replaced, and clear the errors - using 'zpool clear' or replace the device with 'zpool replace'. - see: http://illumos.org/msg/ZFS-8000-4J - scan: scrub in progress since Mon Dec 10 12:23:30 2012 - 10.4M scanned out of 67.0M at 267K/s, 0h3m to go - 9.63M repaired, 15.56% done + using 'zpool clear' or replace the device with 'zpool replace'. + see: https://openzfs.github.io/openzfs-docs/msg/ZFS-8000-9P + scan: scrub in progress since Sat Jul 11 10:34:02 2026 + 40.8M scanned at 20.4M/s, 24.9M issued at 12.4M/s, 67.0M total + 9.63M repaired, 37.16% done, 00:00:03 to go config: NAME STATE READ WRITE CKSUM healer ONLINE 0 0 0 mirror-0 ONLINE 0 0 0 - ada0 ONLINE 0 0 0 - ada1 ONLINE 0 0 627 (repairing) + ada0p1 ONLINE 0 0 0 + ada1p1 ONLINE 0 0 627 (repairing) errors: No known data errors .... -Операция scrub читает данные с [.filename]#ada0# и перезаписывает любые данные с некорректной контрольной суммой на [.filename]#ada1#, что отображается как `(repairing)` в выводе `zpool status`. После завершения операции состояние пула изменяется на: +Операция scrub читает данные с [.filename]#ada0p1# и перезаписывает любые данные с некорректной контрольной суммой на [.filename]#ada1p1#, что отображается как `(repairing)` в выводе `zpool status`. После завершения операции состояние пула изменяется на: [source, shell] .... # zpool status healer pool: healer state: ONLINE status: One or more devices has experienced an unrecoverable error. An attempt was made to correct the error. Applications are unaffected. action: Determine if the device needs to be replaced, and clear the errors - using 'zpool clear' or replace the device with 'zpool replace'. - see: http://illumos.org/msg/ZFS-8000-4J - scan: scrub repaired 66.5M in 0h2m with 0 errors on Mon Dec 10 12:26:25 2012 + using 'zpool clear' or replace the device with 'zpool replace'. + see: https://openzfs.github.io/openzfs-docs/msg/ZFS-8000-9P + scan: scrub repaired 66.5M in 00:00:06 with 0 errors on Sat Jul 11 10:34:08 2026 config: NAME STATE READ WRITE CKSUM healer ONLINE 0 0 0 mirror-0 ONLINE 0 0 0 - ada0 ONLINE 0 0 0 - ada1 ONLINE 0 0 2.72K + ada0p1 ONLINE 0 0 0 + ada1p1 ONLINE 0 0 2.72K errors: No known data errors .... -После завершения операции очистки, когда все данные синхронизированы с [.filename]#ada0# на [.filename]#ada1#, сбросьте сообщения об ошибках из состояния пула, выполнив команду `zpool clear`, как описано в разделе crossref:zfs[zfs-zpool-clear, Сброс состояния ошибки]. +После завершения операции очистки, когда все данные синхронизированы с [.filename]#ada0p1# на [.filename]#ada1p1#, сбросьте сообщения об ошибках из состояния пула, выполнив команду `zpool clear`, как описано в разделе crossref:zfs[zfs-zpool-clear, Сброс состояния ошибки]. [source, shell] .... # zpool clear healer # zpool status healer pool: healer state: ONLINE - scan: scrub repaired 66.5M in 0h2m with 0 errors on Mon Dec 10 12:26:25 2012 + scan: scrub repaired 66.5M in 00:00:06 with 0 errors on Sat Jul 11 10:34:08 2026 config: NAME STATE READ WRITE CKSUM healer ONLINE 0 0 0 mirror-0 ONLINE 0 0 0 - ada0 ONLINE 0 0 0 - ada1 ONLINE 0 0 0 + ada0p1 ONLINE 0 0 0 + ada1p1 ONLINE 0 0 0 errors: No known data errors .... Пулу возвращено полностью рабочее состояние, все счётчики ошибок теперь обнулены. -[[zfs-zpool-online]] -=== Увеличение размера пула - -Наименьшее устройство в каждом vdev ограничивает полезный размер избыточного пула. Замените наименьшее устройство на устройство большего размера. После завершения операции crossref:zfs[zfs-zpool-replace,замены] или crossref:zfs[zfs-term-resilver,пересинхронизации] пул может расшириться для использования ёмкости нового устройства. Например, рассмотрим зеркало из диска на 1 ТБ и диска на 2 ТБ. Полезное пространство составляет 1 ТБ. При замене диска на 1 ТБ другим диском на 2 ТБ процесс пересинхронизации копирует существующие данные на новый диск. Поскольку оба устройства теперь имеют ёмкость 2 ТБ, доступное пространство зеркала увеличивается до 2 ТБ. +[[zfs-zpool-trim]] +=== TRIM и инициализация -Начните расширение, используя `zpool online -e` для каждого устройства. После расширения всех устройств дополнительное пространство становится доступным для пула. +Твердотельные накопители и тонко выделяемое хранилище работают лучше всего, когда ZFS сообщает им, какие блоки больше не используются. `zpool trim` передаёт эту информацию каждому устройству в пуле, которое поддерживает команды TRIM или UNMAP: -[[zfs-zpool-import]] -=== Импорт и экспорт пулов +[source, shell] +.... +# zpool trim mypool +.... -_Экспортируйте_ пулы перед перемещением на другую систему. ZFS отмонтирует все наборы данных, помечая каждое устройство как экспортированное, но все ещё заблокированное, чтобы предотвратить использование другими дисками. Это позволяет импортировать пулы на других машинах, операционных системах с поддержкой ZFS и даже на аппаратных архитектурах другого типа (с некоторыми оговорками, см. man:zpool[8]). Если в наборе данных есть открытые файлы, используйте `zpool export -f` для принудительного экспорта пула. Используйте эту команду с осторожностью. Наборы данных будут принудительно отмонтированы, что может привести к неожиданному поведению приложений, работавших с открытыми файлами в этих наборах данных. +Выполните усечение одного устройства, указав его имя после пула, как в `zpool trim mypool nda0p3`. `zpool trim -w` ожидает завершения усечения, `-c` отменяет выполняющееся усечение, а `-s` приостанавливает его; повторный запуск `zpool trim` возобновляет приостановленное усечение. На устройствах, поддерживающих эту возможность, `zpool trim --secure` запрашивает безопасное усечение, при котором устройство гарантирует стирание данных, хранящихся на усечённых блоках. -Экспортируйте пул, который не используется: +`zpool status -t` показывает прогресс trim для каждого устройства: + +[source, shell] +.... +# zpool status -t mypool + pool: mypool + state: ONLINE + scan: scrub repaired 0B in 00:12:33 with 0 errors on Sat Jul 11 03:31:11 2026 +config: + + NAME STATE READ WRITE CKSUM + mypool ONLINE 0 0 0 + mirror-0 ONLINE 0 0 0 + nda0p3 ONLINE 0 0 0 (23% trimmed, started at Sat Jul 11 09:15:04 2026) + nda1p3 ONLINE 0 0 0 (22% trimmed, started at Sat Jul 11 09:15:04 2026) + +errors: No known data errors +.... + +Установка свойства пула `autotrim` в значение `on` заставляет ZFS непрерывно отправлять небольшие команды TRIM по мере освобождения пространства пулом: + +[source, shell] +.... +# zpool set autotrim=on mypool +.... + +Автоматическая утилизация пропускает небольшие освобожденные области и создает постоянную дополнительную нагрузку на устройства. Для большинства систем отключение `autotrim` и выполнение полной команды `zpool trim` по расписанию дает лучшие результаты. Начиная с FreeBSD 14.1 и более поздних версий, man:periodic[8] выполняет такую утилизацию ежедневно, если в [.filename]#/etc/periodic.conf# содержится `daily_trim_zfs_enable="YES"`. + +`zpool initialize` является аналогом процедуры усечения: она записывает шаблон во всё нераспределённое пространство на указанных устройствах или на каждое подходящее устройство в пуле, если имена устройств не заданы. Это заставляет нижележащее хранилище выделить пространство заранее, избегая задержек при первой записи на тонко подготовленные виртуальные диски, а также проверяет новые устройства перед тем, как доверить им данные. + +[source, shell] +.... +# zpool initialize mypool +.... + +Как и в случае с усечением, `-c` отменяет инициализацию, `-s` приостанавливает её, а `-w` ожидает её завершения; `-u` удаляет состояние инициализации с устройств. Подробнее см. man:zpool-trim[8] и man:zpool-initialize[8]. + +[[zfs-zpool-checkpoint]] +=== Контрольные точки пула + +`zpool checkpoint` сохраняет состояние всего пула, включая каждый набор данных и конфигурацию пула, так что последующий откат возвращает пул к точному состоянию, которое он имел при создании контрольной точки. Создавайте контрольную точку перед рискованными административными операциями, такими как обновление операционной системы, включение новых функций пула или реорганизация наборов данных: + +[source, shell] +.... +# zpool checkpoint mypool +.... + +Пул может хранить не более одной контрольной точки одновременно. Столбец `CKPOINT` команды `zpool list` показывает, сколько места занимает контрольная точка по мере расхождения пула с сохранённым состоянием: + +[source, shell] +.... +# zpool list mypool +NAME SIZE ALLOC FREE CKPOINT EXPANDSZ FRAG CAP DEDUP HEALTH ALTROOT +mypool 4.50T 1.42T 3.08T 221M - 4% 31% 1.00x ONLINE - +.... + +Чтобы откатить изменения, экспортируйте пул и импортируйте его снова с помощью `--rewind-to-checkpoint`: + +[source, shell] +.... +# zpool export mypool +# zpool import --rewind-to-checkpoint mypool +.... + +Перемотка (rewinding) отбрасывает все изменения, внесенные в пул после создания контрольной точки, включая более новые снимки и изменения свойств. Удалите контрольную точку, которая больше не нужна, чтобы освободить занимаемое ею пространство; `-w` ожидает завершения удаления: + +[source, shell] +.... +# zpool checkpoint -d -w mypool +.... + +Пока существует контрольная точка, ZFS отказывает в операциях, изменяющих структуру пула: `zpool remove`, `zpool attach`, `zpool detach`, `zpool split` и `zpool reguid`. Пространство, освобожденное после создания контрольной точки, не возвращается, пока контрольная точка не будет удалена, поэтому долгоживущая контрольная точка на активном пуле может заполнить его. + +[NOTE] +==== +Контрольная точка не является заменой приведенных в crossref:zfs[zfs-zfs-snapshot,снимков] или резервных копий. Она защищает от административных ошибок в течение короткого периода, располагается на тех же дисках, что и пул, а откат отбрасывает все, записанное после ее создания. +==== + +См. man:zpool-checkpoint[8] для подробностей. + +[[zfs-zpool-online]] +=== Увеличение размера пула + +Наименьшее устройство в каждом vdev ограничивает полезный размер избыточного пула. Замените наименьшее устройство на устройство большего размера. После завершения операции crossref:zfs[zfs-zpool-replace,замены] или crossref:zfs[zfs-term-resilver,пересинхронизации] пул может расшириться для использования ёмкости нового устройства. Например, рассмотрим зеркало из диска на 1 ТБ и диска на 2 ТБ. Полезное пространство составляет 1 ТБ. При замене диска на 1 ТБ другим диском на 2 ТБ процесс пересинхронизации копирует существующие данные на новый диск. Поскольку оба устройства теперь имеют ёмкость 2 ТБ, доступное пространство зеркала увеличивается до 2 ТБ. + +Пул не использует новую ёмкость автоматически по умолчанию. Установите свойство пула `autoexpand` в значение `on` перед заменой устройств, и пул увеличится, как только последнее устройство меньшего размера покинет vdev: + +[source, shell] +.... +# zpool set autoexpand=on mypool +.... + +Иначе, начните расширение, используя `zpool online -e` для каждого устройства. После расширения всех устройств дополнительное пространство становится доступным для пула. + +Чтобы увеличить размер vdev RAID-Z, добавив диск вместо замены существующих, см. crossref:zfs[zfs-zpool-raidz-expansion,Расширение RAID-Z]. + +[[zfs-zpool-import]] +=== Импорт и экспорт пулов + +_Экспортируйте_ пулы перед перемещением на другую систему. ZFS отмонтирует все наборы данных, помечая каждое устройство как экспортированное, но все ещё заблокированное, чтобы предотвратить использование другими дисками. Это позволяет импортировать пулы на других машинах, операционных системах с поддержкой ZFS и даже на аппаратных архитектурах другого типа (с некоторыми оговорками, см. man:zpool[8]). Если в наборе данных есть открытые файлы, используйте `zpool export -f` для принудительного экспорта пула. Используйте эту команду с осторожностью. Наборы данных будут принудительно отмонтированы, что может привести к неожиданному поведению приложений, работавших с открытыми файлами в этих наборах данных. + +Экспортируйте пул, который не используется: [source, shell] .... # zpool export mypool .... -Импорт пула автоматически монтирует наборы данных. Если такое поведение нежелательно, используйте `zpool import -N`, чтобы предотвратить это. `zpool import -o` устанавливает временные свойства для данного конкретного импорта. `zpool import altroot=` позволяет импортировать пул с базовой точкой монтирования вместо корня файловой системы. Если пул последний раз использовался в другой системе и не был корректно экспортирован, принудительно импортируйте его с помощью `zpool import -f`. `zpool import -a` импортирует все пулы, которые, по-видимому, не используются другой системой. +Импорт пула автоматически монтирует наборы данных. Если такое поведение нежелательно, используйте `zpool import -N`, чтобы предотвратить это. `zpool import -o` устанавливает временные свойства для данного конкретного импорта. `zpool import -o altroot=` позволяет импортировать пул с базовой точкой монтирования вместо корня файловой системы. Если пул последний раз использовался в другой системе и не был корректно экспортирован, принудительно импортируйте его с помощью `zpool import -f`. `zpool import -a` импортирует все пулы, которые, по-видимому, не используются другой системой. + +man:zpool-import[8] также предоставляет опции для восстановления поврежденных пулов. `zpool import -F` пытается откатить пул к более ранней группе транзакций, когда последние повреждены, отбрасывая последние несколько секунд записей. `zpool import -m` позволяет импортировать пул, у которого отсутствует выделенное устройство журнала. `zpool import -o readonly=on` импортирует пул в режиме только для чтения, предотвращая все записи, что полезно для анализа последствий или при спасении данных из отказывающего пула. `zpool import -R /mnt` объединяет `altroot=/mnt` с `cachefile=none`, сохраняя спасательный импорт от нарушения путей монтирования и кэша пулов работающей системы. Выведите список всех доступных пулов для импорта: [source, shell] .... # zpool import pool: mypool id: 9930174748043525076 state: ONLINE action: The pool can be imported using its name or numeric identifier. config: - mypool ONLINE - ada2p3 ONLINE + mypool ONLINE + ada0p1 ONLINE .... Импортируйте пул с альтернативным корневым каталогом: [source, shell] .... # zpool import -o altroot=/mnt mypool # zfs list -zfs list NAME USED AVAIL REFER MOUNTPOINT mypool 110K 47.0G 31K /mnt/mypool .... -[[zfs-zpool-upgrade]] -=== Обновление пула дисков +При загрузке сценарии запуска ZFS, включённые через `zfs_enable="YES"` в [.filename]#/etc/rc.conf#, импортируют каждый пул, записанный в [.filename]#/etc/zfs/zpool.cache#. Импорт пула автоматически добавляет его в этот файл кэша; свойство пула `cachefile` управляет этим поведением. Пулы, импортированные с `cachefile=none`, не восстанавливаются автоматически после перезагрузки. -После обновления FreeBSD или при импорте пула с системы, использующей более старую версию, вручную обновите пул до последней версии ZFS для поддержки новых функций. Перед обновлением учтите, может ли пул потребоваться для импорта на более старой системе. Обновление является необратимым процессом. Обновление старых пулов возможно, но понижение версии пулов с новыми функциями — нет. +[[zfs-zpool-import-geli]] +==== Импорт пула, зашифрованного GELI -Обновление пула v28 для поддержки `Feature Flags`: +Опция `Encrypt Disks` инсталлятора FreeBSD шифрует разделы пула с помощью man:geli[8], описанного в crossref:disks[disks-encrypting-geli,"Шифрование разделов диска"], а не с помощью crossref:zfs[zfs-native-encryption,собственного шифрования ZFS]. На установленной системе загрузчик запрашивает парольную фразу и подключает провайдеров перед монтированием корневого пула, но сама ZFS ничего не знает о шифровании: при загрузке с аварийного носителя или переносе дисков на другой хост `zpool import` не находит пул, пока провайдеры GELI не будут подключены. + +Присоедините зашифрованный [.filename]#freebsd-zfs# раздел каждого диска в пуле, указав парольную фразу, затем импортируйте пул: [source, shell] .... -# zpool status - pool: mypool - state: ONLINE -status: The pool is formatted using a legacy on-disk format. The pool can - still be used, but some features are unavailable. -action: Upgrade the pool using 'zpool upgrade'. Once this is done, the - pool will no longer be accessible on software that does not support feat - flags. - scan: none requested -config: - - NAME STATE READ WRITE CKSUM - mypool ONLINE 0 0 0 - mirror-0 ONLINE 0 0 0 - ada0 ONLINE 0 0 0 - ada1 ONLINE 0 0 0 - -errors: No known data errors -# zpool upgrade -This system supports ZFS pool feature flags. - -The following pools are formatted with legacy version numbers and are upgraded to use feature flags. -After being upgraded, these pools will no longer be accessible by software that does not support feature flags. +# geli attach ada0p4 +Enter passphrase: +# zpool import -f -R /mnt zroot +.... -VER POOL ---- ------------ -28 mypool +Используйте `gpart show`, чтобы определить разделы [.filename]#freebsd-zfs#; при стандартной раскладке установщика зашифрованный раздел — это [.filename]#p4#. Системы, установленные с устаревшей раскладкой, которая хранит отдельный незашифрованный загрузочный пул, дополнительно содержат файл ключа в [.filename]#/boot/encryption.key# в этом пуле; подключите эти провайдеры с помощью `geli attach -k /path/to/encryption.key`. -Use 'zpool upgrade -v' for a list of available legacy versions. -Every feature flags pool has all supported features enabled. -# zpool upgrade mypool -This system supports ZFS pool feature flags. +[[zfs-zpool-upgrade]] +=== Обновление пула дисков -Successfully upgraded 'mypool' from version 28 to feature flags. -Enabled the following features on 'mypool': - async_destroy - empty_bpobj - lz4_compress - multi_vdev_crash_dump -.... +После обновления FreeBSD или при импорте пула с системы, использующей более старую версию, вручную обновите пул, чтобы активировать поддержку новых функций. Перед обновлением учтите, может ли пул потребоваться для импорта на более старой системе. Обновление является необратимым процессом. Обновление старых пулов возможно, но понижение версии пулов с новыми функциями — нет. -Новые возможности ZFS станут доступны только после выполнения команды `zpool upgrade`. Используйте `zpool upgrade -v`, чтобы увидеть, какие новые возможности предоставляет обновление, а также какие функции уже поддерживаются. +Пулы больше не имеют единого номера версии. Вместо этого каждое изменение формата на диске представляет собой отдельный _признак_ (feature flag), описанный в man:zpool-features[7]. Признак _включается_ (enabled), когда пул разрешает его использование, и становится _активным_ (active), как только пул сохраняет данные, зависящие от него. Включённый, но неактивный признак не влияет на совместимость. Как только признак становится активным, программное обеспечение без его поддержки больше не может импортировать пул, хотя пулы, все активные признаки которых являются «совместимыми только для чтения», всё ещё допускают импорт в режиме только для чтения. -Обновление пула для поддержки новых флагов функций: +`zpool status` сообщает, когда поддерживаемые возможности не включены в пуле: [source, shell] .... -# zpool status +# zpool status mypool pool: mypool state: ONLINE -status: Some supported features are not enabled on the pool. The pool can - still be used, but some features are unavailable. +status: Some supported and requested features are not enabled on the pool. + The pool can still be used, but some features are unavailable. action: Enable all features using 'zpool upgrade'. Once this is done, the pool may no longer be accessible by software that does not support the features. See zpool-features(7) for details. - scan: none requested + scan: scrub repaired 0B in 00:11:03 with 0 errors on Sat Jul 11 03:15:41 2026 config: NAME STATE READ WRITE CKSUM mypool ONLINE 0 0 0 mirror-0 ONLINE 0 0 0 - ada0 ONLINE 0 0 0 - ada1 ONLINE 0 0 0 + ada0p1 ONLINE 0 0 0 + ada1p1 ONLINE 0 0 0 errors: No known data errors +.... + +Выполнение `zpool upgrade` без аргументов выводит список всех пулов с отключёнными возможностями: + +[source, shell] +.... # zpool upgrade This system supports ZFS pool feature flags. -All pools are formatted using feature flags. - Some supported features are not enabled on the following pools. Once a feature is enabled the pool may become incompatible with software that does not support the feature. See zpool-features(7) for details. +Обратите внимание, что функция «совместимость» (compatibility) пула может использоваться для предотвращения +обновлений функциональных возможностей. + POOL FEATURE --------------- -zstore - multi_vdev_crash_dump - spacemap_histogram - enabled_txg - hole_birth - extensible_dataset - bookmarks - filesystem_limits +mypool + zilsaxattr + head_errlog + blake3 + block_cloning + vdev_zaps_v2 +.... + +Используйте `zpool upgrade -v`, чтобы вывести список всех функций, поддерживаемых работающей системой, вместе с устаревшими номерами версий. Включите все поддерживаемые функции в пуле: + +[source, shell] +.... # zpool upgrade mypool This system supports ZFS pool feature flags. Enabled the following features on 'mypool': - spacemap_histogram - enabled_txg - hole_birth - extensible_dataset - bookmarks - filesystem_limits + zilsaxattr + head_errlog + blake3 + block_cloning + vdev_zaps_v2 +.... + +Пулы, которые должны оставаться импортируемыми на системах, работающих с более старым программным обеспечением ZFS, могут ограничивать, какие возможности `zpool create` и `zpool upgrade` включают, через свойство пула `compatibility`: + +[source, shell] .... +# zpool create -o compatibility=openzfs-2.1-freebsd mypool mirror /dev/ada0p1 /dev/ada1p1 +.... + +Установка свойства на существующем пуле с помощью `zpool set` также работает. Каждый именованный набор функций соответствует файлу в [.filename]#/usr/share/zfs/compatibility.d#, и значение по умолчанию `off` позволяет использовать все функции. Установка свойства не отключает уже включённые функции. [WARNING] ==== -Обновите загрузочный код на системах, которые загружаются с пула, чтобы поддержать новую версию пула. Используйте `gpart bootcode` для раздела, содержащего загрузочный код. Доступны два типа загрузочного кода в зависимости от способа загрузки системы: GPT (наиболее распространённый вариант) и EFI (для более современных систем). +Обновите загрузочный код на системах, которые загружаются с пула, чтобы поддержать новые свойства пула. Используйте `gpart bootcode` для раздела, содержащего загрузочный код. Доступны два типа загрузочного кода в зависимости от способа загрузки системы: GPT (наиболее распространённый вариант) и EFI (для более современных систем). Для загрузки в устаревшем режиме с использованием GPT используйте следующую команду: [source, shell] .... # gpart bootcode -b /boot/pmbr -p /boot/gptzfsboot -i 1 ada1 .... Для систем, использующих EFI для загрузки, выполните следующую команду: [source, shell] .... # mount -t msdosfs /dev/ada1p1 /boot/efi # cp /boot/loader.efi /boot/efi/efi/boot/BOOTX64.efi # cp /boot/loader.efi /boot/efi/efi/freebsd/loader.efi .... Данные инструкции применимы к системам amd64. В зависимости от архитектуры файл имеет другое имя. Обратитесь к man:uefi[8], чтобы узнать имена файлов, специфичных для конкретной архитектуры. Примените загрузочный код ко всем загрузочным дискам в пуле. Подробнее см. в man:gpart[8]. ==== [[zfs-zpool-history]] === Отображение записанной истории пулов ZFS записывает команды, которые изменяют пул, включая создание наборов данных, изменение свойств или замену диска. Просмотр истории создания пула полезен, так же как и проверка того, какой пользователь выполнил конкретное действие и когда. История не хранится в файле журнала, а является частью самого пула. Команда для просмотра этой истории называется `zpool history`: [source, shell] .... # zpool history History for 'tank': -2013-02-26.23:02:35 zpool create tank mirror /dev/ada0 /dev/ada1 -2013-02-27.18:50:58 zfs set atime=off tank -2013-02-27.18:51:09 zfs set checksum=fletcher4 tank -2013-02-27.18:51:18 zfs create tank/backup +2026-07-11.10:24:05 zpool create tank mirror /dev/ada0p1 /dev/ada1p1 +2026-07-11.18:50:58 zfs set atime=off tank +2026-07-11.18:51:09 zfs set checksum=fletcher4 tank +2026-07-11.18:51:18 zfs create tank/backup .... Вывод показывает команды `zpool` и `zfs`, изменяющие пул каким-либо образом, вместе с временной меткой. Команды вроде `zfs list` не включаются. Если имя пула не указано, ZFS отображает историю всех пулов. `zpool history` может отображать ещё больше информации при использовании опций `-i` или `-l`. Опция `-i` показывает события, инициированные пользователем, а также внутренние события ZFS, зарегистрированные в журнале. [source, shell] .... # zpool history -i History for 'tank': -2013-02-26.23:02:35 [internal pool create txg:5] pool spa 28; zfs spa 28; zpl 5;uts 9.1-RELEASE 901000 amd64 -2013-02-27.18:50:53 [internal property set txg:50] atime=0 dataset = 21 -2013-02-27.18:50:58 zfs set atime=off tank -2013-02-27.18:51:04 [internal property set txg:53] checksum=7 dataset = 21 -2013-02-27.18:51:09 zfs set checksum=fletcher4 tank -2013-02-27.18:51:13 [internal create txg:55] dataset = 39 -2013-02-27.18:51:18 zfs create tank/backup +2026-07-11.10:24:05 [txg:5] create pool version 5000; software version zfs-2.2.7-FreeBSD_gd75f9ee8b; uts myzfsbox 14.3-RELEASE 1403000 amd64 +2026-07-11.18:50:53 [txg:50] set tank (21) atime=0 +2026-07-11.18:50:58 zfs set atime=off tank +2026-07-11.18:51:04 [txg:53] set tank (21) checksum=7 +2026-07-11.18:51:09 zfs set checksum=fletcher4 tank +2026-07-11.18:51:13 [txg:55] create tank/backup (39) +2026-07-11.18:51:18 zfs create tank/backup .... Показать более подробную информацию, добавив `-l`. Отображение записей истории в длинном формате, включая такие сведения, как имя пользователя, выполнившего команду, и имя хоста, на котором произошло изменение. [source, shell] .... # zpool history -l History for 'tank': -2013-02-26.23:02:35 zpool create tank mirror /dev/ada0 /dev/ada1 [user 0 (root) on :global] -2013-02-27.18:50:58 zfs set atime=off tank [user 0 (root) on myzfsbox:global] -2013-02-27.18:51:09 zfs set checksum=fletcher4 tank [user 0 (root) on myzfsbox:global] -2013-02-27.18:51:18 zfs create tank/backup [user 0 (root) on myzfsbox:global] +2026-07-11.10:24:05 zpool create tank mirror /dev/ada0p1 /dev/ada1p1 [user 0 (root) on myzfsbox:global] +2026-07-11.18:50:58 zfs set atime=off tank [user 0 (root) on myzfsbox:global] +2026-07-11.18:51:09 zfs set checksum=fletcher4 tank [user 0 (root) on myzfsbox:global] +2026-07-11.18:51:18 zfs create tank/backup [user 0 (root) on myzfsbox:global] .... -Вывод показывает, что пользователь `root` создал зеркальный пул с дисками [.filename]#/dev/ada0# и [.filename]#/dev/ada1#. Также в командах после создания пула отображается имя хоста `myzfsbox`. Отображение имени хоста становится важным при экспорте пула с одной системы и импорте на другую. Можно различить команды, выполненные на другой системе, по имени хоста, записанному для каждой команды. +Вывод показывает, что пользователь `root` создал зеркальный пул с дисками [.filename]#/dev/ada0p1# и [.filename]#/dev/ada1p1#. Также в каждой команде отображается имя хоста `myzfsbox`. Отображение имени хоста становится важным при экспорте пула с одной системы и импорте на другую. Можно различить команды, выполненные на другой системе, по имени хоста, записанному для каждой команды. Объедините оба варианта с `zpool history`, чтобы получить максимально детальную информацию для любого заданного пула. История пула предоставляет ценную информацию при отслеживании выполненных действий или необходимости более детального вывода для отладки. [[zfs-zpool-iostat]] === Мониторинг производительности Встроенная система мониторинга может отображать статистику операций ввода-вывода пула в реальном времени. Она показывает объём свободного и занятого пространства в пуле, количество операций чтения и записи в секунду, а также используемую пропускную способность ввода-вывода. По умолчанию ZFS отслеживает и отображает все пулы в системе. Укажите имя пула, чтобы ограничить мониторинг только этим пулом. Простой пример: [source, shell] .... # zpool iostat capacity operations bandwidth pool alloc free read write read write ---------- ----- ----- ----- ----- ----- ----- data 288G 1.53T 2 11 11.3K 57.1K .... Чтобы непрерывно отслеживать активность ввода-вывода, укажите число в качестве последнего параметра, задающее интервал в секундах между обновлениями. Следующая строка статистики выводится после каждого интервала. Нажмите kbd:[Ctrl+C], чтобы остановить непрерывный мониторинг. Укажите второе число в командной строке после интервала, чтобы задать общее количество отображаемой статистики. Отображать более детальную статистику ввода-вывода с помощью `-v`. Каждое устройство в пуле отображается с отдельной строкой статистики. Это полезно для просмотра операций чтения и записи, выполняемых на каждом устройстве, и может помочь определить, замедляет ли какое-либо отдельное устройство работу пула. В этом примере показан зеркальный пул с двумя устройствами: [source, shell] .... # zpool iostat -v capacity operations bandwidth pool alloc free read write read write ----------------------- ----- ----- ----- ----- ----- ----- data 288G 1.53T 2 12 9.23K 61.5K mirror 288G 1.53T 2 12 9.23K 61.5K - ada1 - - 0 4 5.61K 61.7K - ada2 - - 1 4 5.04K 61.7K + ada1p1 - - 0 4 5.61K 61.7K + ada2p1 - - 1 4 5.04K 61.7K ----------------------- ----- ----- ----- ----- ----- ----- .... +`zpool iostat` предоставляет несколько более детальных представлений о конвейере ввода-вывода. `-l` (latency) добавляет столбцы со средней задержкой, разделяя общее время ожидания на время на диске и время, проведенное в различных очередях ввода-вывода. `-q` (queue) показывает количество ожидающих и активных операций в каждой очереди на vdev. `-w` выводит полные гистограммы задержек, а `-r` (request size) выводит гистограммы размеров запросов для каждого листового vdev. + +Столбцы задержки в `-l` позволяют легко заметить один медленный диск, который замедляет работу всего vdev: + +[source, shell] +.... +# zpool iostat -lv data + capacity operations bandwidth total_wait disk_wait syncq_wait asyncq_wait scrub trim rebuild +pool alloc free read write read write read write read write read write read write wait wait wait +---------- ----- ----- ----- ----- ----- ----- ----- ----- ----- ----- ----- ----- ----- ----- ----- ----- ------- +data 288G 1.53T 156 212 19.4M 26.6M 14ms 186ms 5ms 184ms 1us 2us 8ms 2ms - - - + mirror-0 288G 1.53T 156 212 19.4M 26.6M 14ms 186ms 5ms 184ms 1us 2us 8ms 2ms - - - + ada1p1 - - 79 106 9.7M 13.3M 3ms 5ms 3ms 4ms 1us 2us 1ms 1ms - - - + ada2p1 - - 77 106 9.7M 13.3M 212ms 187ms 208ms 183ms 1us 2us 15ms 3ms - - - +---------- ----- ----- ----- ----- ----- ----- ----- ----- ----- ----- ----- ----- ----- ----- ----- ----- ------- +.... + +В этом примере [.filename]#ada2p1# требует сотни миллисекунд дискового времени для операций ввода-вывода, которые его зеркальный партнёр [.filename]#ada1p1# выполняет за однозначные миллисекунды, при этом оба обрабатывают схожее количество операций. Запись в зеркало завершается только после того, как завершится самый медленный участник, поэтому задержка записи всего vdev отслеживает [.filename]#ada2p1#. Высокая задержка при нормальной работе, без ошибок чтения, записи или контрольных сумм в `zpool status`, часто указывает на диск, который выполняет внутренние повторы, и является кандидатом на замену. + +Скрипты, которым необходимо дождаться завершения фоновой активности пула, могут блокироваться на `zpool wait`: + +[source, shell] +.... +# zpool wait -t scrub,resilver mypool +.... + +Команда возвращает управление, как только ни одно из указанных действий, таких как `scrub`, `resilver`, `trim` или `remove`, не выполняется. Полный список действий приведён в man:zpool-wait[8]. + +[NOTE] +==== +`zpool status`, `zpool list`, `zpool get` и `zfs list` принимают `-j` для вывода JSON, который более устойчив для разбора скриптами, чем таблицы, читаемые человеком. Вывод JSON требует OpenZFS 2.3 или новее, впервые доступный во FreeBSD 15.0. +==== + [[zfs-zpool-split]] === Разделение пула хранения данных ZFS может разделить пул, состоящий из одного или нескольких зеркальных vdev, на два пула. Если не указано иное, ZFS отсоединяет последний элемент каждого зеркала и создаёт новый пул с теми же данными. Обязательно выполните пробный запуск операции с параметром `-n` сначала. Это отобразит детали запрошенной операции без её фактического выполнения. Это помогает убедиться, что операция выполнит то, что задумал пользователь. [[zfs-zfs]] == Управление с помощью утилиты`zfs` Утилита `zfs` позволяет создавать, удалять и управлять всеми существующими наборами данных ZFS в пределах пула. Для управления самим пулом используйте crossref:zfs[zfs-zpool,`zpool`]. [[zfs-zfs-create]] === Создание и удаление наборов данных В отличие от традиционных дисков и менеджеров томов, пространство в ZFS _не_ выделяется заранее. В традиционных файловых системах после разметки и выделения пространства невозможно добавить новую файловую систему без добавления нового диска. В ZFS создание новых файловых систем возможно в любое время. Каждый crossref:zfs[zfs-term-dataset,_набор данных_] обладает свойствами, включая такие функции, как сжатие, дедупликация, кэширование и квоты, а также другие полезные свойства, такие как режим только для чтения, чувствительность к регистру, сетевое общее использование файлов и точка монтирования. Возможно вложение наборов данных друг в друга, при этом дочерние наборы данных наследуют свойства от своих родительских. crossref:zfs[zfs-zfs-allow,Делегирование], crossref:zfs[zfs-zfs-send,репликация], crossref:zfs[zfs-zfs-snapshot,снимки], crossref:zfs[zfs-zfs-jail,клетки] позволяют администрировать и уничтожать каждый набор данных как единое целое. Создание отдельного набора данных для каждого типа или группы файлов имеет свои преимущества. Недостатком наличия большого количества наборов данных является то, что некоторые команды, такие как `zfs list`, будут выполняться медленнее, а монтирование сотен или даже тысяч наборов данных замедлит процесс загрузки FreeBSD. Создайте новый набор данных и включите для него crossref:zfs[zfs-term-compression-lz4,сжатие LZ4]: [source, shell] .... # zfs list NAME USED AVAIL REFER MOUNTPOINT mypool 781M 93.2G 144K none mypool/ROOT 777M 93.2G 144K none mypool/ROOT/default 777M 93.2G 777M / mypool/tmp 176K 93.2G 176K /tmp mypool/usr 616K 93.2G 144K /usr mypool/usr/home 184K 93.2G 184K /usr/home mypool/usr/ports 144K 93.2G 144K /usr/ports mypool/usr/src 144K 93.2G 144K /usr/src mypool/var 1.20M 93.2G 608K /var mypool/var/crash 148K 93.2G 148K /var/crash mypool/var/log 178K 93.2G 178K /var/log mypool/var/mail 144K 93.2G 144K /var/mail mypool/var/tmp 152K 93.2G 152K /var/tmp # zfs create -o compress=lz4 mypool/usr/mydataset # zfs list NAME USED AVAIL REFER MOUNTPOINT mypool 781M 93.2G 144K none mypool/ROOT 777M 93.2G 144K none mypool/ROOT/default 777M 93.2G 777M / mypool/tmp 176K 93.2G 176K /tmp mypool/usr 704K 93.2G 144K /usr mypool/usr/home 184K 93.2G 184K /usr/home mypool/usr/mydataset 87.5K 93.2G 87.5K /usr/mydataset mypool/usr/ports 144K 93.2G 144K /usr/ports mypool/usr/src 144K 93.2G 144K /usr/src mypool/var 1.20M 93.2G 610K /var mypool/var/crash 148K 93.2G 148K /var/crash mypool/var/log 178K 93.2G 178K /var/log mypool/var/mail 144K 93.2G 144K /var/mail mypool/var/tmp 152K 93.2G 152K /var/tmp .... Уничтожение набора данных выполняется гораздо быстрее, чем удаление файлов в наборе данных, так как не требует сканирования файлов и обновления соответствующих метаданных. Уничтожьте созданный набор данных: [source, shell] .... # zfs list NAME USED AVAIL REFER MOUNTPOINT mypool 880M 93.1G 144K none mypool/ROOT 777M 93.1G 144K none mypool/ROOT/default 777M 93.1G 777M / mypool/tmp 176K 93.1G 176K /tmp mypool/usr 101M 93.1G 144K /usr mypool/usr/home 184K 93.1G 184K /usr/home mypool/usr/mydataset 100M 93.1G 100M /usr/mydataset mypool/usr/ports 144K 93.1G 144K /usr/ports mypool/usr/src 144K 93.1G 144K /usr/src mypool/var 1.20M 93.1G 610K /var mypool/var/crash 148K 93.1G 148K /var/crash mypool/var/log 178K 93.1G 178K /var/log mypool/var/mail 144K 93.1G 144K /var/mail mypool/var/tmp 152K 93.1G 152K /var/tmp # zfs destroy mypool/usr/mydataset # zfs list NAME USED AVAIL REFER MOUNTPOINT mypool 781M 93.2G 144K none mypool/ROOT 777M 93.2G 144K none mypool/ROOT/default 777M 93.2G 777M / mypool/tmp 176K 93.2G 176K /tmp mypool/usr 616K 93.2G 144K /usr mypool/usr/home 184K 93.2G 184K /usr/home mypool/usr/ports 144K 93.2G 144K /usr/ports mypool/usr/src 144K 93.2G 144K /usr/src mypool/var 1.21M 93.2G 612K /var mypool/var/crash 148K 93.2G 148K /var/crash mypool/var/log 178K 93.2G 178K /var/log mypool/var/mail 144K 93.2G 144K /var/mail mypool/var/tmp 152K 93.2G 152K /var/tmp .... -В современных версиях ZFS команда `zfs destroy` выполняется асинхронно, и освобождённое пространство может появиться в пуле только через несколько минут. Используйте `zpool get freeing _имяпула_` для просмотра свойства `freeing`, которое показывает, какие наборы данных освобождают свои блоки в фоновом режиме. Если существуют дочерние наборы данных, например crossref:zfs[zfs-term-snapshot,снимки] или другие наборы данных, уничтожение родительского набора невозможно. Для удаления набора данных и его дочерних элементов используйте `-r`, чтобы рекурсивно удалить набор данных и его потомков. Опция `-n -v` позволяет вывести список наборов данных и снимков, которые будут удалены данной операцией, без фактического выполнения удаления. Также отображается пространство, которое будет освобождено после удаления снимков. +В современных версиях ZFS команда `zfs destroy` выполняется асинхронно, и освобождённое пространство может появиться в пуле только через несколько минут. Используйте команду `zpool get freeing _poolname_` для просмотра свойства `freeing`, которое показывает, сколько места ещё остаётся освободить в фоновом режиме. Используйте команду `zpool wait -t free _poolname_`, чтобы дождаться завершения фонового освобождения. Если существуют дочерние наборы данных, например crossref:zfs[zfs-term-snapshot,снимки] или другие наборы данных, уничтожение родительского набора невозможно. Для удаления набора данных и его дочерних элементов используйте `-r`, чтобы рекурсивно удалить набор данных и его потомков. Опция `-n -v` позволяет вывести список наборов данных и снимков, которые будут удалены данной операцией, без фактического выполнения удаления. Также отображается пространство, которое будет освобождено после удаления снимков. [[zfs-zfs-volume]] === Создание и удаление томов Том — это особый тип набора данных. Вместо монтирования в качестве файловой системы он представляется как блочное устройство в [.filename]#/dev/zvol/имя_пула/набор_данных#. Это позволяет использовать том для других файловых систем, в качестве дисков для виртуальной машины или сделать его доступным для других сетевых узлов с использованием таких протоколов, как iSCSI или HAST. Отформатируйте том с любой файловой системой или без файловой системы для хранения сырых данных. Для пользователя том выглядит как обычный диск. Размещение обычных файловых систем на этих _zvols_ предоставляет возможности, которых нет у обычных дисков или файловых систем. Например, использование свойства сжатия на томе объёмом 250 МБ позволяет создать сжатую файловую систему FAT. [source, shell] .... # zfs create -V 250m -o compression=on tank/fat32 # zfs list tank NAME USED AVAIL REFER MOUNTPOINT tank 258M 670M 31K /tank # newfs_msdos -F32 /dev/zvol/tank/fat32 # mount -t msdosfs /dev/zvol/tank/fat32 /mnt # df -h /mnt | grep fat32 Filesystem Size Used Avail Capacity Mounted on /dev/zvol/tank/fat32 249M 24k 249M 0% /mnt # mount | grep fat32 /dev/zvol/tank/fat32 on /mnt (msdosfs, local) .... +Создание тома резервирует в пуле достаточно места для хранения полного размера тома. Чтобы пропустить это резервирование, создайте _разреженный том_ (sparse volume), также известный как тонко выделенный том, с помощью `-s`: + +[source, shell] +.... +# zfs create -s -V 250g tank/bigdisk +.... + +Разреженные тома позволяют выделять больше пространства, чем фактически имеется в пуле. Записи в разреженный том могут завершиться ошибкой `ENOSPC`, когда в пуле заканчивается место, поэтому используйте разреженные тома только там, где потребитель тома допускает ошибки записи. + +Свойство `volmode` управляет тем, как ZFS предоставляет том операционной системе. Установка значения `full` предоставляет том как провайдер GEOM с максимальной функциональностью, а `geom` является псевдонимом для `full`. Установка значения `dev` предоставляет том как обычный узел устройства, скрывая любые разделы, которые он содержит. Тома с `volmode`, установленным в `none`, не предоставляются за пределами ZFS вообще, но по-прежнему поддерживают снимки, клоны и репликацию, что делает их полезными в качестве целей репликации. Свойство по умолчанию имеет значение `default`, которое откладывается на системную настройку `zvol_volmode`, описанную в man:zfs[4]. + +Тома хорошо работают в качестве виртуальных дисков для виртуальных машин man:bhyve[8] и как хранилище для экстентов iSCSI: объявите устройство тома как LUN в man:ctl.conf[5] и обслуживайте его с помощью man:ctld[8]. + +[WARNING] +==== +Не размещайте пространство подкачки на томах ZFS. Когда в системе недостаточно памяти, сам ZFS нуждается в памяти для завершения записи, которая освободила бы память, и система может зависнуть. Подробности см. в upstream-проблеме OpenZFS link:https://github.com/openzfs/zfs/issues/7734[openzfs/zfs#7734]. Вместо этого используйте выделенный раздел подкачки. +==== + Уничтожение тома во многом аналогично уничтожению обычного набора данных файловой системы. Операция выполняется почти мгновенно, но освобождение места может занять несколько минут и происходит в фоновом режиме. [[zfs-zfs-rename]] === Переименование набора данных Для изменения имени набора данных используйте `zfs rename`. Эту же команду можно использовать для изменения родительского набора данных. Переименование набора данных с изменением родительского набора приведёт к изменению значений свойств, унаследованных от родительского набора данных. Переименование набора данных размонтирует, а затем снова смонтирует его в новом месте (с учётом наследования от нового родительского набора данных). Чтобы предотвратить это поведение, используйте опцию `-u`. Переименовать набор данных и переместить его под другой родительский набор данных: [source, shell] .... # zfs list NAME USED AVAIL REFER MOUNTPOINT mypool 780M 93.2G 144K none mypool/ROOT 777M 93.2G 144K none mypool/ROOT/default 777M 93.2G 777M / mypool/tmp 176K 93.2G 176K /tmp mypool/usr 704K 93.2G 144K /usr mypool/usr/home 184K 93.2G 184K /usr/home mypool/usr/mydataset 87.5K 93.2G 87.5K /usr/mydataset mypool/usr/ports 144K 93.2G 144K /usr/ports mypool/usr/src 144K 93.2G 144K /usr/src mypool/var 1.21M 93.2G 614K /var mypool/var/crash 148K 93.2G 148K /var/crash mypool/var/log 178K 93.2G 178K /var/log mypool/var/mail 144K 93.2G 144K /var/mail mypool/var/tmp 152K 93.2G 152K /var/tmp # zfs rename mypool/usr/mydataset mypool/var/newname # zfs list NAME USED AVAIL REFER MOUNTPOINT mypool 780M 93.2G 144K none mypool/ROOT 777M 93.2G 144K none mypool/ROOT/default 777M 93.2G 777M / mypool/tmp 176K 93.2G 176K /tmp mypool/usr 616K 93.2G 144K /usr mypool/usr/home 184K 93.2G 184K /usr/home mypool/usr/ports 144K 93.2G 144K /usr/ports mypool/usr/src 144K 93.2G 144K /usr/src mypool/var 1.29M 93.2G 614K /var mypool/var/crash 148K 93.2G 148K /var/crash mypool/var/log 178K 93.2G 178K /var/log mypool/var/mail 144K 93.2G 144K /var/mail mypool/var/newname 87.5K 93.2G 87.5K /var/newname mypool/var/tmp 152K 93.2G 152K /var/tmp .... Переименование снимков выполняется той же командой. Из-за особенностей снимков, их переименование не может изменить родительский набор данных. Для рекурсивного переименования снимка укажите `-r`; это также переименует все снимки с таким же именем в дочерних наборах данных. [source, shell] .... # zfs list -t snapshot NAME USED AVAIL REFER MOUNTPOINT mypool/var/newname@first_snapshot 0 - 87.5K - # zfs rename mypool/var/newname@first_snapshot new_snapshot_name # zfs list -t snapshot NAME USED AVAIL REFER MOUNTPOINT mypool/var/newname@new_snapshot_name 0 - 87.5K - .... [[zfs-zfs-set]] === Установка свойств наборов данных Каждый набор данных ZFS имеет свойства, которые определяют его поведение. Большинство свойств автоматически наследуются от родительского набора данных, но могут быть переопределены локально. Установите свойство для набора данных с помощью `zfs set _свойство=значение набор_данных_`. Большинство свойств имеют ограниченный набор допустимых значений, `zfs get` отобразит каждое возможное свойство и допустимые значения. Использование `zfs inherit` возвращает большинство свойств к их унаследованным значениям. Также возможны пользовательские свойства. Они становятся частью конфигурации набора данных и предоставляют дополнительную информацию о наборе данных или его содержимом. Чтобы отличить эти пользовательские свойства от встроенных в ZFS, используйте двоеточие (`:`), чтобы создать пользовательское пространство имён для свойства. [source, shell] .... # zfs set custom:costcenter=1234 tank # zfs get custom:costcenter tank NAME PROPERTY VALUE SOURCE tank custom:costcenter 1234 local .... Чтобы удалить пользовательское свойство, используйте `zfs inherit` с параметром `-r`. Если пользовательское свойство не определено ни в одном из родительских наборов данных, эта опция удаляет его (но история пула всё равно сохраняет запись об изменении). [source, shell] .... # zfs inherit -r custom:costcenter tank # zfs get custom:costcenter tank NAME PROPERTY VALUE SOURCE tank custom:costcenter - - # zfs get all tank | grep custom:costcenter # .... [[zfs-zfs-set-share]] ==== Получение и установка свойств общего доступа -Два часто используемых и полезных свойства наборов данных — это параметры общих ресурсов NFS и SMB. Установка этих параметров определяет, будет ли ZFS предоставлять наборы данных в сети и как именно. В настоящее время FreeBSD поддерживает настройку только общего доступа NFS. Чтобы проверить текущее состояние общего ресурса, введите: +Два часто используемых и полезных свойства наборов данных — это параметры общего доступа NFS и SMB. Их установка определяет, экспортируются ли наборы данных ZFS в сеть и каким образом. Во FreeBSD ZFS интегрируется с NFS-сервером в базовой системе: установка свойства `sharenfs` экспортирует набор данных через man:mountd[8]. ZFS записывает запись экспорта в [.filename]#/etc/zfs/exports#, которую man:mountd[8] читает в дополнение к [.filename]#/etc/exports#. Для общего доступа к наборам данных требуется включенный NFS-сервер в [.filename]#/etc/rc.conf#: + +[.programlisting] +.... +zfs_enable="YES" +nfs_server_enable="YES" +.... + +Значение `sharenfs` может быть `on`, `off` или списком параметров man:exports[5], применяемых к экспорту. + +Чтобы получить текущее состояние общего каталога, введите: [source, shell] .... # zfs get sharenfs mypool/usr/home NAME PROPERTY VALUE SOURCE mypool/usr/home sharenfs on local -# zfs get sharesmb mypool/usr/home -NAME PROPERTY VALUE SOURCE -mypool/usr/home sharesmb off local .... Чтобы включить общий доступ к набору данных, введите: [source, shell] .... # zfs set sharenfs=on mypool/usr/home .... Установите другие параметры для общего доступа к наборам данных через NFS, такие как `-alldirs`, `-maproot` и `-network`. Чтобы задать параметры для набора данных, доступного через NFS, введите: [source, shell] .... # zfs set sharenfs="-alldirs,-maproot=root,-network=192.168.1.0/24" mypool/usr/home .... +Свойство `sharesmb` не работает во FreeBSD, так как библиотека совместного доступа реализует только NFS. Чтобы предоставить набор данных по SMB, установите пакет, например package:net/samba422[], и укажите путь смонтированного набора данных в его конфигурации. + +[[zfs-zfs-acl]] +=== NFSv4 ACL + +ZFS во FreeBSD хранит ACL в стиле NFSv4 нативно; свойство набора данных `acltype` по умолчанию имеет значение `nfsv4`. Каждый файл и каталог может нести список управления доступом наряду с традиционными битами разрешений, обеспечивая более тонкий контроль, чем модель владелец/группа/остальные. Отображайте и редактируйте эти списки с помощью man:getfacl[1] и man:setfacl[1]. + +Отобразить ACL файла: + +[source, shell] +.... +% getfacl /usr/home/alice/notes.txt +# file: /usr/home/alice/notes.txt +# owner: alice +# group: alice + owner@:rw-p--aARWcCos:-------:allow + group@:r-----a-R-c--s:-------:allow + everyone@:r-----a-R-c--s:-------:allow +.... + +Предоставьте дополнительному пользователю доступ на запись, добавив запись `allow`: + +[source, shell] +.... +% setfacl -m u:bob:rwp::allow /usr/home/alice/notes.txt +.... + +Два свойства наборов данных управляют тем, как ACL взаимодействуют с традиционной обработкой разрешений. Свойство `aclmode` (`discard`, `groupmask`, `passthrough` или `restricted`) определяет, что происходит с ACL, когда man:chmod[1] изменяет биты разрешений файла. При значении по умолчанию, `discard`, chmod удаляет все записи ACL, которые не представляют новый режим файла. Свойство `aclinherit` (`discard`, `noallow`, `restricted`, `passthrough` или `passthrough-x`) определяет, какие записи ACL новые файлы и каталоги наследуют от родительского каталога. При значении по умолчанию, `restricted`, унаследованные записи теряют разрешения `write_acl` и `write_owner`. + +Смотрите man:setfacl[1] и man:zfsprops[7] для полного синтаксиса записей и описаний свойств. + [[zfs-zfs-snapshot]] === Управление снимками crossref:zfs[zfs-term-snapshot,Снимки] — одна из самых мощных функций ZFS. Снимок предоставляет доступную только для чтения копию набора данных на определённый момент времени. Благодаря механизму Copy-On-Write (COW), ZFS быстро создаёт снимки, сохраняя старые версии данных на диске. Если снимков не существует, ZFS освобождает место для последующего использования при перезаписи или удалении данных. Снимки экономят дисковое пространство, записывая только различия между текущим набором данных и предыдущей версией. Создание снимков возможно для целых наборов данных, но не для отдельных файлов или каталогов. Снимок набора данных дублирует всё его содержимое. Это включает свойства файловой системы, файлы, каталоги, права доступа и так далее. Снимки не занимают дополнительного места при создании, но начинают потреблять пространство по мере изменения блоков, на которые они ссылаются. Рекурсивные снимки, созданные с помощью `-r`, формируют снимки с одинаковыми именами для набора данных и его дочерних элементов, обеспечивая согласованный снимок файловых систем на определённый момент времени. Это может быть важно, когда приложение использует файлы в связанных наборах данных или зависящие друг от друга. Без снимков резервная копия содержала бы файлы из разных моментов времени. Снимки в ZFS предоставляют множество функций, которых нет даже в других файловых системах с поддержкой снимков. Типичный пример использования снимков — быстрое резервное копирование текущего состояния файловой системы перед выполнением рискованных действий, таких как установка программного обеспечения или обновление системы. Если действие завершится неудачей, откат к снимку вернёт систему в состояние на момент его создания. Если обновление прошло успешно, снимок можно удалить для освобождения места. Без снимков неудачное обновление часто требует восстановления из резервных копий, что утомительно, отнимает много времени и может привести к простою системы, в течение которого она будет недоступна. Откат к снимкам выполняется быстро, даже во время обычной работы системы, с минимальным или нулевым временем простоя. Экономия времени огромна, особенно для многотерабайтных систем хранения, учитывая время, необходимое для копирования данных из резервной копии. Снимки не заменяют полное резервное копирование пула, но предлагают быстрый и простой способ сохранить копию набора данных на определённый момент времени. [[zfs-zfs-snapshot-creation]] ==== Создание снимков Для создания снимков используйте `zfs snapshot _наборданных_@_имяснимка_`. Добавление опции `-r` создаёт снимок рекурсивно с тем же именем для всех дочерних наборов данных. Создать рекурсивный снимок всего пула: [source, shell] .... # zfs list -t all NAME USED AVAIL REFER MOUNTPOINT mypool 780M 93.2G 144K none mypool/ROOT 777M 93.2G 144K none mypool/ROOT/default 777M 93.2G 777M / mypool/tmp 176K 93.2G 176K /tmp mypool/usr 616K 93.2G 144K /usr mypool/usr/home 184K 93.2G 184K /usr/home mypool/usr/ports 144K 93.2G 144K /usr/ports mypool/usr/src 144K 93.2G 144K /usr/src mypool/var 1.29M 93.2G 616K /var mypool/var/crash 148K 93.2G 148K /var/crash mypool/var/log 178K 93.2G 178K /var/log mypool/var/mail 144K 93.2G 144K /var/mail mypool/var/newname 87.5K 93.2G 87.5K /var/newname mypool/var/newname@new_snapshot_name 0 - 87.5K - mypool/var/tmp 152K 93.2G 152K /var/tmp # zfs snapshot -r mypool@my_recursive_snapshot # zfs list -t snapshot NAME USED AVAIL REFER MOUNTPOINT mypool@my_recursive_snapshot 0 - 144K - mypool/ROOT@my_recursive_snapshot 0 - 144K - mypool/ROOT/default@my_recursive_snapshot 0 - 777M - mypool/tmp@my_recursive_snapshot 0 - 176K - mypool/usr@my_recursive_snapshot 0 - 144K - mypool/usr/home@my_recursive_snapshot 0 - 184K - mypool/usr/ports@my_recursive_snapshot 0 - 144K - mypool/usr/src@my_recursive_snapshot 0 - 144K - mypool/var@my_recursive_snapshot 0 - 616K - mypool/var/crash@my_recursive_snapshot 0 - 148K - mypool/var/log@my_recursive_snapshot 0 - 178K - mypool/var/mail@my_recursive_snapshot 0 - 144K - mypool/var/newname@new_snapshot_name 0 - 87.5K - mypool/var/newname@my_recursive_snapshot 0 - 87.5K - mypool/var/tmp@my_recursive_snapshot 0 - 152K - .... Снимки не отображаются при обычной операции `zfs list`. Для вывода списка снимков добавьте `-t snapshot` к команде `zfs list`. Опция `-t all` показывает как файловые системы, так и снимки. Снимки не монтируются напрямую, поэтому в столбце `MOUNTPOINT` не отображается путь. ZFS не указывает доступное дисковое пространство в столбце `AVAIL`, так как снимки доступны только для чтения после их создания. Сравните снимок с исходным набором данных: [source, shell] .... # zfs list -rt all mypool/usr/home NAME USED AVAIL REFER MOUNTPOINT mypool/usr/home 184K 93.2G 184K /usr/home mypool/usr/home@my_recursive_snapshot 0 - 184K - .... Отображение набора данных и снимка вместе показывает, как снимки работают в стиле crossref:zfs[zfs-term-cow,COW]. Они сохраняют внесённые изменения (_дельту_), а не полное содержимое файловой системы заново. Это означает, что снимки занимают мало места при внесении изменений. Наблюдайте за использованием пространства ещё внимательнее, скопировав файл в набор данных, а затем создав второй снимок: [source, shell] .... # cp /etc/passwd /var/tmp # zfs snapshot mypool/var/tmp@after_cp # zfs list -rt all mypool/var/tmp NAME USED AVAIL REFER MOUNTPOINT mypool/var/tmp 206K 93.2G 118K /var/tmp mypool/var/tmp@my_recursive_snapshot 88K - 152K - mypool/var/tmp@after_cp 0 - 118K - .... Второй снимок содержит изменения в наборе данных после операции копирования. Это обеспечивает значительную экономию пространства. Обратите внимание, что размер снимка `_mypool/var/tmp@my_recursive_snapshot_` также изменился в столбце `USED`, показывая разницу между ним и последующим снимком. [[zfs-zfs-snapshot-diff]] ==== Сравнение снимков ZFS предоставляет встроенную команду для сравнения различий в содержимом между двумя снимками. Это полезно при наличии множества снимков, сделанных за определённый период, когда пользователь хочет увидеть, как файловая система изменялась со временем. Например, `zfs diff` позволяет пользователю найти последний снимок, который ещё содержит случайно удалённый файл. Применение этой команды к двум снимкам, созданным в предыдущем разделе, даёт следующий вывод: [source, shell] .... # zfs list -rt all mypool/var/tmp NAME USED AVAIL REFER MOUNTPOINT mypool/var/tmp 206K 93.2G 118K /var/tmp mypool/var/tmp@my_recursive_snapshot 88K - 152K - mypool/var/tmp@after_cp 0 - 118K - # zfs diff mypool/var/tmp@my_recursive_snapshot M /var/tmp/ + /var/tmp/passwd .... Команда выводит список изменений между указанным снимком (в данном случае `_mypool/var/tmp@my_recursive_snapshot_`) и активной файловой системой. Первый столбец показывает тип изменения: [.informaltable] [cols="20%,80%"] |=== |+ |Добавление пути или файла. |- |Удаление пути или файла. |M |Изменение пути или файла. |R |Переименование пути или файла. |=== Сравнивая вывод с таблицей, становится ясно, что ZFS добавил [.filename]#passwd# после создания снимка `_mypool/var/tmp@my_recursive_snapshot_`. Это также привело к изменению родительского каталога, смонтированного в `_/var/tmp_`. Сравнение двух снимков полезно при использовании функции репликации ZFS для передачи набора данных на другой хост в целях резервного копирования. Сравните два снимка, указав полное имя набора данных и имя снимка для обоих наборов: [source, shell] .... # cp /var/tmp/passwd /var/tmp/passwd.copy # zfs snapshot mypool/var/tmp@diff_snapshot # zfs diff mypool/var/tmp@my_recursive_snapshot mypool/var/tmp@diff_snapshot M /var/tmp/ + /var/tmp/passwd + /var/tmp/passwd.copy # zfs diff mypool/var/tmp@my_recursive_snapshot mypool/var/tmp@after_cp M /var/tmp/ + /var/tmp/passwd .... Администратор резервного копирования может сравнить два снимка, полученных от отправляющего хоста, и определить фактические изменения в наборе данных. Дополнительную информацию см. в разделе crossref:zfs[zfs-zfs-send,Репликация]. [[zfs-zfs-snapshot-rollback]] ==== Откат снимка состояния (Snapshot Rollback) Когда доступен хотя бы один снимок, можно в любой момент к нему вернуться. Чаще всего это необходимо, когда текущее состояние набора данных больше не является корректным или требуется более старая версия. Такие ситуации, как неудачные локальные тесты разработки, неудачные обновления системы, нарушающие её функциональность, или необходимость восстановления удалённых файлов или каталогов, встречаются довольно часто. Для возврата к снимку используйте команду `zfs rollback _имя_снимка_`. Если изменений много, операция займёт значительное время. В течение этого времени набор данных всегда остаётся в согласованном состоянии, подобно тому, как база данных, соответствующая принципам ACID, выполняет откат. Это происходит, пока набор данных находится в рабочем состоянии и доступен без необходимости простоя. После отката к снимку набор данных возвращается в то же состояние, в котором он находился на момент создания снимка. Откат к снимку удаляет все другие данные в наборе, не входящие в снимок. Создание снимка текущего состояния набора данных перед откатом к предыдущему — хорошая практика, если некоторые данные могут потребоваться позже. Таким образом, пользователь может переключаться между снимками, не теряя ценные данные. В первом примере выполняется откат к снимку, потому что неосторожная операция `rm` удалила больше данных, чем планировалось. [source, shell] .... # zfs list -rt all mypool/var/tmp NAME USED AVAIL REFER MOUNTPOINT mypool/var/tmp 262K 93.2G 120K /var/tmp mypool/var/tmp@my_recursive_snapshot 88K - 152K - mypool/var/tmp@after_cp 53.5K - 118K - mypool/var/tmp@diff_snapshot 0 - 120K - # ls /var/tmp passwd passwd.copy vi.recover # rm /var/tmp/passwd* # ls /var/tmp vi.recover .... На этом этапе пользователь замечает удаление лишних файлов и хочет вернуть их обратно. ZFS предоставляет простой способ восстановления с использованием отката, если регулярно создаются снимки важных данных. Чтобы вернуть файлы и начать заново с последнего снимка, выполните команду: [source, shell] .... # zfs rollback mypool/var/tmp@diff_snapshot # ls /var/tmp passwd passwd.copy vi.recover .... Операция отката восстановила набор данных до состояния последнего снимка. Также возможен откат к более раннему снимку, если после него были созданы другие снимки. При попытке выполнить это действие ZFS выдаст следующее предупреждение: [source, shell] .... # zfs list -rt snapshot mypool/var/tmp -AME USED AVAIL REFER MOUNTPOINT +NAME USED AVAIL REFER MOUNTPOINT mypool/var/tmp@my_recursive_snapshot 88K - 152K - mypool/var/tmp@after_cp 53.5K - 118K - mypool/var/tmp@diff_snapshot 0 - 120K - # zfs rollback mypool/var/tmp@my_recursive_snapshot cannot rollback to 'mypool/var/tmp@my_recursive_snapshot': more recent snapshots exist use '-r' to force deletion of the following snapshots: mypool/var/tmp@after_cp mypool/var/tmp@diff_snapshot .... Это предупреждение означает, что между текущим состоянием набора данных и снимком, к которому пользователь хочет выполнить откат, существуют другие снимки. Для завершения отката удалите эти снимки. ZFS не может отслеживать все изменения между различными состояниями набора данных, поскольку снимки доступны только для чтения. ZFS не удалит затронутые снимки, если пользователь явно не укажет параметр `-r`, подтверждая, что это желаемое действие. Если это действительно требуется, и вы осознаёте последствия потери всех промежуточных снимков, выполните команду: [source, shell] .... # zfs rollback -r mypool/var/tmp@my_recursive_snapshot # zfs list -rt snapshot mypool/var/tmp NAME USED AVAIL REFER MOUNTPOINT mypool/var/tmp@my_recursive_snapshot 8K - 152K - # ls /var/tmp vi.recover .... Вывод команды `zfs list -t snapshot` подтверждает удаление промежуточных снимков в результате выполнения `zfs rollback -r`. [[zfs-zfs-snapshot-snapdir]] ==== Восстановление отдельных файлов из снимков -Снимки хранятся в скрытом каталоге родительского набора данных: [.filename]#.zfs/snapshots/имя_снимка#. По умолчанию эти каталоги не отображаются даже при выполнении стандартной команды `ls -a`. Несмотря на то, что каталог не виден, доступ к нему осуществляется как к обычному каталогу. Свойство `snapdir` определяет, будут ли эти скрытые каталоги отображаться в списке содержимого каталога. Установка свойства в значение `visible` позволяет им появляться в выводе команды `ls` и других команд, работающих с содержимым каталогов. +Снимки хранятся в скрытом каталоге родительского набора данных: [.filename]#.zfs/snapshot/имя_снимка#. По умолчанию эти каталоги не отображаются даже при выполнении стандартной команды `ls -a`. Несмотря на то, что каталог не виден, доступ к нему осуществляется как к обычному каталогу. Свойство `snapdir` определяет, будут ли эти скрытые каталоги отображаться в списке содержимого каталога. Установка свойства в значение `visible` позволяет им появляться в выводе команды `ls` и других команд, работающих с содержимым каталогов. [source, shell] .... # zfs get snapdir mypool/var/tmp NAME PROPERTY VALUE SOURCE mypool/var/tmp snapdir hidden default # ls -a /var/tmp . .. passwd vi.recover # zfs set snapdir=visible mypool/var/tmp # ls -a /var/tmp . .. .zfs passwd vi.recover .... Восстановите отдельные файлы в предыдущее состояние, скопировав их из снимка обратно в родительский набор данных. Структура каталогов в [.filename]#.zfs/snapshot# содержит каталоги с именами, соответствующими ранее созданным снимкам, что упрощает их идентификацию. В следующем примере показано, как восстановить файл из скрытого каталога [.filename]#.zfs#, скопировав его из снимка, содержащего последнюю версию файла: [source, shell] .... # rm /var/tmp/passwd # ls -a /var/tmp . .. .zfs vi.recover # ls /var/tmp/.zfs/snapshot after_cp my_recursive_snapshot # ls /var/tmp/.zfs/snapshot/after_cp passwd vi.recover # cp /var/tmp/.zfs/snapshot/after_cp/passwd /var/tmp .... Даже если свойство `snapdir` установлено в hidden, выполнение команды `ls .zfs/snapshot` всё равно покажет содержимое этого каталога. Администратор решает, отображать ли эти каталоги. Это настройка для каждого набора данных. Копирование файлов или каталогов из скрытого [.filename]#.zfs/snapshot# достаточно просто. Попытка сделать наоборот приведёт к такой ошибке: [source, shell] .... # cp /etc/rc.conf /var/tmp/.zfs/snapshot/after_cp/ cp: /var/tmp/.zfs/snapshot/after_cp/rc.conf: Read-only file system .... Ошибка напоминает пользователю, что снимки доступны только для чтения и не могут изменяться после создания. Копирование файлов в каталоги снимков и их удаление оттуда запрещены, так как это изменило бы состояние набора данных, который они представляют. -Снимки занимают место в зависимости от того, насколько родительская файловая система изменилась с момента создания снимка. Свойство `written` снимка отслеживает используемое им пространство. +Снимки занимают место в зависимости от того, насколько родительская файловая система изменилась с момента создания снимка. Свойство `used` снимка отслеживает используемое им пространство. Его свойство `written` показывает, какой объём данных был записан на диск между предыдущим и текущим снимком. Для удаления снимков и освобождения пространства используйте `zfs destroy _набор_данных_@_снимок_`. Добавление `-r` рекурсивно удаляет все снимки с таким же именем в родительском наборе данных. Добавление `-n -v` к команде выводит список снимков, которые будут удалены, и оценку освобождаемого пространства без фактического выполнения операции удаления. +[[zfs-zfs-snapshot-hold]] +==== Удержания снимков + +Удержание (hold, crossref:zfs[zfs-term-hold,hold]) помечает снимок пользовательским тегом и предотвращает его уничтожение. Попытки уничтожить удерживаемый снимок с помощью `zfs destroy` завершаются ошибкой `EBUSY`. Снимок может иметь любое количество удержаний, каждое из которых идентифицируется уникальным именем тега. Удержания защищают снимки, которые всё ещё используются другими процессами, например, самый последний снимок, общий для обеих сторон цепочки репликации (см. crossref:zfs[zfs-zfs-send,Репликация]). Случайное уничтожение этого общего снимка приводит к тому, что следующая репликация должна будет начинаться с полного потока (full stream). + +Установите удержание с помощью `zfs hold _tag_ _snapshot_`. Добавление `-r` также устанавливает удержания на снимки с тем же именем во всех дочерних наборах данных. + +[source, shell] +.... +# zfs hold keepme mypool/var/tmp@my_recursive_snapshot +# zfs destroy mypool/var/tmp@my_recursive_snapshot +cannot destroy snapshot mypool/var/tmp@my_recursive_snapshot: dataset is busy +.... + +`zfs holds` выводит список удержаний на снимке, показывая имя тега и время установки каждого удержания: + +[source, shell] +.... +# zfs holds mypool/var/tmp@my_recursive_snapshot +NAME TAG TIMESTAMP +mypool/var/tmp@my_recursive_snapshot keepme Sat Jul 11 09:41 2026 +.... + +Снимите удержание с помощью `zfs release`. Уничтожение снимка снова становится возможным, как только снимается последнее удержание на нём: + +[source, shell] +.... +# zfs release keepme mypool/var/tmp@my_recursive_snapshot +# zfs destroy mypool/var/tmp@my_recursive_snapshot +.... + +См. man:zfs-hold[8] для получения дополнительной информации. + +[[zfs-zfs-bookmark]] +=== Закладки + +Перекрестная ссылка: zfs[zfs-term-bookmark,закладка] фиксирует момент времени, в который был создан снимок, без сохранения каких-либо данных снимка. Закладки почти не занимают места на диске, независимо от того, насколько изменится набор данных впоследствии. Как и снимок, закладка может служить источником инкрементальных данных для `zfs send`. В отличие от снимка, она не препятствует ZFS освобождать старые данные. Такое сочетание делает закладки полезными для инкрементальной репликации: после отправки снимка на другой пул создайте закладку на нем и уничтожьте его на отправляющей стороне, освобождая место, в то время как принимающая сторона сохраняет свою копию снимка. Смотрите раздел crossref:zfs[zfs-send-incremental,Инкрементальные резервные копии] для описания самого процесса репликации. + +Создайте закладку из снимка с помощью `zfs bookmark`. В именах закладок в качестве разделителя между именем набора данных и именем закладки используется `#`, так же как в именах снимков используется `@`. + +[source, shell] +.... +# zfs snapshot mypool/data@snap1 +# zfs send mypool/data@snap1 | zfs receive backup/data +# zfs bookmark mypool/data@snap1 mypool/data#snap1bm +# zfs destroy mypool/data@snap1 +.... + +Перечислите закладки с помощью `zfs list -t bookmark`: + +[source, shell] +.... +# zfs list -t bookmark mypool/data +NAME USED AVAIL REFER MOUNTPOINT +mypool/data#snap1bm - - 184K - +.... + +Когда наступает время для следующего инкрементального резервного копирования, создайте новый снимок и используйте закладку в качестве инкрементального источника: + +[source, shell] +.... +# zfs snapshot mypool/data@snap2 +# zfs send -i mypool/data#snap1bm mypool/data@snap2 | zfs receive backup/data +.... + +Это работает, поскольку принимающий пул всё ещё имеет снапшот _backup/data@snap1_, соответствующий закладке. Закладки служат только в качестве источников для инкрементального резервирования. Смонтировать закладку, выполнить откат к ней или восстановить файлы из неё невозможно, так как она не содержит данных. Дополнительную информацию см. в man:zfs-bookmark[8]. + [[zfs-zfs-clones]] === Управление клонами Клон — это копия снимка, которая рассматривается как обычный набор данных. В отличие от снимка, клон доступен для записи, может быть смонтирован и имеет свои собственные свойства. После создания клона с помощью команды `zfs clone` уничтожение исходного снимка становится невозможным. Чтобы изменить отношение «родитель-потомок» между клоном и снимком, используйте команду `zfs promote`. Продвижение клона делает снимок потомком клона, а не исходного родительского набора данных. Это изменит способ учёта пространства в ZFS, но не повлияет на фактически используемый объём. Клон можно смонтировать в любом месте иерархии файловой системы ZFS, а не только ниже исходного расположения снимка. Чтобы продемонстрировать функцию клонирования, используйте следующий набора данных в качестве примера: [source, shell] .... # zfs list -rt all camino/home/joe NAME USED AVAIL REFER MOUNTPOINT camino/home/joe 108K 1.3G 87K /usr/home/joe camino/home/joe@plans 21K - 85.5K - camino/home/joe@backup 0K - 87K - .... Типичное применение клонов — эксперименты с определённым набором данных, при этом снимок остаётся в качестве резервной копии на случай возникновения проблем. Поскольку снимки нельзя изменить, создаётся доступный для чтения и записи клон снимка. После достижения нужного результата в клоне, клон повышается до набора данных, а старая файловая система удаляется. Удаление родительского набора данных не является обязательным, так как клон и набор данных могут без проблем сосуществовать. [source, shell] .... # zfs clone camino/home/joe@backup camino/home/joenew # ls /usr/home/joe* /usr/home/joe: backup.txz plans.txt /usr/home/joenew: backup.txz plans.txt # df -h /usr/home Filesystem Size Used Avail Capacity Mounted on usr/home/joe 1.3G 31k 1.3G 0% /usr/home/joe usr/home/joenew 1.3G 31k 1.3G 0% /usr/home/joenew .... Создание клона делает его точной копией состояния набора данных на момент создания снимка. Теперь можно изменять клон независимо от исходного набора данных. Связь между ними осуществляется через снимок. ZFS записывает эту связь в свойстве `origin`. Повышение клона с помощью `zfs promote` делает клон независимым набором данных. Это удаляет значение свойства `origin` и отключает новый независимый набор данных от снимка. Вот пример: [source, shell] .... # zfs get origin camino/home/joenew NAME PROPERTY VALUE SOURCE camino/home/joenew origin camino/home/joe@backup - # zfs promote camino/home/joenew # zfs get origin camino/home/joenew NAME PROPERTY VALUE SOURCE camino/home/joenew origin - - .... После внесения изменений, таких как копирование [.filename]#loader.conf# в продвинутую клон-копию, например, старый каталог в этом случае становится устаревшим. Вместо него продвинутая клон-копия может его заменить. Для этого сначала выполните `zfs destroy` для старого набора данных, а затем `zfs rename` для клона, указав имя старого набора данных (или совершенно другое имя). [source, shell] .... # cp /boot/defaults/loader.conf /usr/home/joenew # zfs destroy -f camino/home/joe # zfs rename camino/home/joenew camino/home/joe # ls /usr/home/joe backup.txz loader.conf plans.txt # df -h /usr/home Filesystem Size Used Avail Capacity Mounted on usr/home/joe 1.3G 128k 1.3G 0% /usr/home/joe .... Клонированный снимок теперь является обычным набором данных. Он содержит все данные из исходного снимка, а также добавленные файлы, такие как [.filename]#loader.conf#. Клоны предоставляют полезные возможности пользователям ZFS в различных сценариях. Например, можно предоставлять клетки в виде снимков с различными наборами установленных приложений. Пользователи могут клонировать эти снимки и добавлять свои собственные приложения по своему усмотрению. После внесения необходимых изменений клоны можно повысить до полноценных наборов данных и предоставить их конечным пользователям для работы, как с обычными наборами данных. Это экономит время и снижает административные затраты при предоставлении таких клеток. +[[zfs-zfs-block-cloning]] +=== Блочное клонирование + +crossref:zfs[zfs-term-block-cloning,Блочное клонирование] обеспечивает копирование при записи для отдельных копий файлов. При его включении копирование файла с помощью man:cp[1] не дублирует данные файла. Вместо этого новый файл ссылается на те же блоки, что и оригинал, и ZFS записывает новые блоки только тогда, когда впоследствии изменяется один из файлов. man:cp[1] выполняет копирование с помощью man:copy_file_range[2], которое ZFS превращает в операции блочного клонирования, делая копии внутри пула практически мгновенными и изначально не потребляющими дополнительное пространство. + +В отличие от crossref:zfs[zfs-zfs-deduplication,дедупликация], блочное клонирование не поддерживает требующую много памяти таблицу контрольных сумм. Совместное использование происходит только в момент копирования, и запись одинаковых данных отдельными операциями по-прежнему сохраняет их дважды. В отличие от crossref:zfs[zfs-zfs-clones,клонов], блочное клонирование не требует снимка, работает с отдельными файлами, а не с целыми наборами данных, и не оставляет отношения `origin` после себя. + +Блочное клонирование требует возможности пула `block_cloning` из OpenZFS 2.2, впервые выпущенной в FreeBSD 14.0 (см. man:zpool-features[7]). Управляющая системная переменная man:sysctl[8] `vfs.zfs.bclone_enabled` определяет, создаёт ли ZFS блочные клоны на самом деле. По умолчанию она равна 0 в FreeBSD 14.x и 1 в FreeBSD 15.0. Пока sysctl равен 0, `copy_file_range()` возвращается к обычному копированию. Чтобы включить блочное клонирование в FreeBSD 14.x: + +[source, shell] +.... +# sysctl vfs.zfs.bclone_enabled=1 +vfs.zfs.bclone_enabled: 0 -> 1 +.... + +Чтобы сохранить эту настройку после перезагрузок, добавьте следующую строку в [.filename]#/etc/sysctl.conf#: + +[.programlisting] +.... +vfs.zfs.bclone_enabled=1 +.... + +Свойства пула `bcloneused`, `bclonesaved` и `bcloneratio` показывают пространство, используемое клонированными блоками, пространство, сэкономленное за счёт клонирования, и результирующий коэффициент экономии: + +[source, shell] +.... +# cp /var/tmp/database.dump /var/tmp/database.copy +# zpool list -o name,bcloneused,bclonesaved,bcloneratio mypool +NAME BCLONE_USED BCLONE_SAVED BCLONE_RATIO +mypool 1.7G 1.7G 2.00x +.... + [[zfs-zfs-send]] === Репликация -Хранение данных в единственном пуле в одном месте подвергает их рискам, таким как кража, стихийные бедствия или действия людей. Регулярное резервное копирование всего пула крайне важно. ZFS предоставляет встроенную функцию сериализации, которая может отправлять потоковое представление данных на стандартный вывод. Используя эту функцию, можно сохранять эти данные в другом пуле, подключенном к локальной системе, или отправлять их по сети на другую систему. Снимки являются основой для этой репликации (см. раздел о crossref:zfs[zfs-zfs-snapshot,снимках ZFS]). Команды, используемые для репликации данных, — это `zfs send` и `zfs receive`. +Хранение данных в единственном пуле в одном месте подвергает их рискам, таким как кража, стихийные бедствия или действия людей. Регулярное резервное копирование всего пула крайне важно. ZFS предоставляет встроенную функцию сериализации, которая может отправлять потоковое представление данных на стандартный вывод. Используя эту функцию, можно сохранять эти данные в другом пуле, подключённом к локальной системе, или отправлять их по сети на другую систему. Снимки являются основой для этой репликации (см. раздел о crossref:zfs[zfs-zfs-snapshot,снимках ZFS]). Команды, используемые для репликации данных, — это `zfs send` и `zfs receive`. Эти примеры демонстрируют репликацию ZFS с использованием следующих двух пулов: [source, shell] .... # zpool list NAME SIZE ALLOC FREE CKPOINT EXPANDSZ FRAG CAP DEDUP HEALTH ALTROOT backup 960M 77K 896M - - 0% 0% 1.00x ONLINE - mypool 984M 43.7M 940M - - 0% 4% 1.00x ONLINE - .... Имя пула _mypool_ — это основной пул, в который данные регулярно записываются и откуда они читаются. Используйте второй резервный пул _backup_ на случай, если основной пул станет недоступен. Обратите внимание, что этот переход на резервный пул не выполняется автоматически в ZFS, а должен быть осуществлён вручную системным администратором при необходимости. Используйте снимок (snapshot), чтобы обеспечить согласованную версию файловой системы для репликации. После создания снимка _mypool_ скопируйте его в пул _backup_ путём репликации снимков. Это не включает изменения, сделанные после последнего снимка. [source, shell] .... # zfs snapshot mypool@backup1 # zfs list -t snapshot NAME USED AVAIL REFER MOUNTPOINT mypool@backup1 0 - 43.6M - .... Теперь, когда снимок существует, используйте `zfs send` для создания потока, представляющего содержимое снимка. Сохраните этот поток в файл или примите его в другом пуле. Поток записывается в стандартный вывод, но перенаправьте его в файл или канал, иначе появится ошибка: [source, shell] .... # zfs send mypool@backup1 Error: Stream can not be written to a terminal. You must redirect standard output. .... -Для резервного копирования набора данных с помощью `zfs send` перенаправьте вывод в файл, расположенный в подключенном пуле резервных копий. Убедитесь, что в пуле достаточно свободного места для размещения отправленного снимка, то есть для данных, содержащихся в снимке, а не для изменений по сравнению с предыдущим снимком. +Для резервного копирования набора данных с помощью `zfs send` перенаправьте вывод в файл, расположенный в подключённом пуле резервных копий. Убедитесь, что в пуле достаточно свободного места для размещения отправленного снимка, то есть для данных, содержащихся в снимке, а не для изменений по сравнению с предыдущим снимком. [source, shell] .... # zfs send mypool@backup1 > /backup/backup1 # zpool list NAME SIZE ALLOC FREE CKPOINT EXPANDSZ FRAG CAP DEDUP HEALTH ALTROOT backup 960M 63.7M 896M - - 0% 6% 1.00x ONLINE - mypool 984M 43.7M 940M - - 0% 4% 1.00x ONLINE - .... Команда `zfs send` передала все данные из снимка _backup1_ в пул _backup_. Для автоматического создания и отправки таких снимков используйте задание man:cron[8]. Вместо хранения резервных копий в виде архивных файлов ZFS может получать их как активную файловую систему, обеспечивая прямой доступ к резервным данным. Для доступа к фактическим данным, содержащимся в этих потоках, используйте `zfs receive`, чтобы преобразовать потоки обратно в файлы и каталоги. В приведённом ниже примере объединяются `zfs send` и `zfs receive` с использованием конвейера для копирования данных из одного пула в другой. После завершения передачи данные можно использовать напрямую в целевом пуле. Реплицировать набор данных можно только в пустой набор данных. [source, shell] .... # zfs snapshot mypool@replica1 # zfs send -v mypool@replica1 | zfs receive backup/mypool -send from @ to mypool@replica1 estimated size is 50.1M +full send of mypool@replica1 estimated size is 50.1M total estimated size is 50.1M -TIME SENT SNAPSHOT +TIME SENT SNAPSHOT mypool@replica1 +10:22:01 9.75M mypool@replica1 +10:22:02 25.4M mypool@replica1 # zpool list NAME SIZE ALLOC FREE CKPOINT EXPANDSZ FRAG CAP DEDUP HEALTH ALTROOT backup 960M 63.7M 896M - - 0% 6% 1.00x ONLINE - mypool 984M 43.7M 940M - - 0% 4% 1.00x ONLINE - .... [[zfs-send-incremental]] ==== Инкрементные резервные копии `zfs send` также может определить разницу между двумя снимками и отправить отдельные различия между ними. Это экономит место на диске и время передачи. Например: [source, shell] .... # zfs snapshot mypool@replica2 # zfs list -t snapshot NAME USED AVAIL REFER MOUNTPOINT mypool@replica1 5.72M - 43.6M - mypool@replica2 0 - 44.1M - # zpool list NAME SIZE ALLOC FREE CKPOINT EXPANDSZ FRAG CAP DEDUP HEALTH ALTROOT backup 960M 61.7M 898M - - 0% 6% 1.00x ONLINE - mypool 960M 50.2M 910M - - 0% 5% 1.00x ONLINE - .... -Создайте второй снимок с именем _replica2_. Этот второй снимок содержит изменения, внесенные в файловую систему в период между текущим моментом и предыдущим снимком _replica1_. Использование `zfs send -i` с указанием пары снимков создаёт инкрементальный поток репликации, содержащий измененные данные. Это выполняется успешно, если исходный снимок уже существует на принимающей стороне. +Создайте второй снимок с именем _replica2_. Этот второй снимок содержит изменения, внесённые в файловую систему в период между текущим моментом и предыдущим снимком _replica1_. Использование `zfs send -i` с указанием пары снимков создаёт инкрементальный поток репликации, содержащий изменённые данные. Это выполняется успешно, если исходный снимок уже существует на принимающей стороне. [source, shell] .... -# zfs send -v -i mypool@replica1 mypool@replica2 | zfs receive /backup/mypool +# zfs send -v -i mypool@replica1 mypool@replica2 | zfs receive backup/mypool send from @replica1 to mypool@replica2 estimated size is 5.02M total estimated size is 5.02M -TIME SENT SNAPSHOT +TIME SENT SNAPSHOT mypool@replica2 # zpool list NAME SIZE ALLOC FREE CKPOINT EXPANDSZ FRAG CAP DEDUP HEALTH ALTROOT backup 960M 80.8M 879M - - 0% 8% 1.00x ONLINE - mypool 960M 50.2M 910M - - 0% 5% 1.00x ONLINE - # zfs list NAME USED AVAIL REFER MOUNTPOINT backup 55.4M 240G 152K /backup backup/mypool 55.3M 240G 55.2M /backup/mypool mypool 55.6M 11.6G 55.0M /mypool # zfs list -t snapshot NAME USED AVAIL REFER MOUNTPOINT backup/mypool@replica1 104K - 50.2M - backup/mypool@replica2 0 - 55.2M - mypool@replica1 29.9K - 50.0M - mypool@replica2 0 - 55.0M - .... -Инкрементный поток реплицировал измененные данные вместо полной копии _replica1_. Передача только различий заняла гораздо меньше времени и сэкономила место на диске, избегая копирования всего пула каждый раз. Это особенно полезно при репликации по медленной сети или при тарификации за каждый переданный байт. +Инкрементный поток реплицировал изменённые данные вместо полной копии _replica1_. Передача только различий заняла гораздо меньше времени и сэкономила место на диске, избегая копирования всего пула каждый раз. Это особенно полезно при репликации по медленной сети или при тарификации за каждый переданный байт. -Доступна новая файловая система _backup/mypool_ с файлами и данными из пула _mypool_. Указание `-p` копирует свойства наборов данных, включая настройки сжатия, квоты и точки монтирования. Указание `-R` копирует все дочерние наборы данных вместе с их свойствами. Автоматизируйте отправку и получение для создания регулярных резервных копий во втором пуле. +Доступна новая файловая система _backup/mypool_ с файлами и данными из пула _mypool_. Указание `-p` копирует свойства наборов данных, включая настройки сжатия, квоты и точки монтирования. Указание `-R` копирует все дочерние наборы данных вместе с их свойствами. Автоматизируйте отправку и получение для создания регулярных резервных копий во втором пуле. Раздел crossref:zfs[zfs-send-options,«Параметры потока отправки»] более подробно описывает эти и другие полезные параметры. + +[[zfs-send-options]] +==== Параметры отправки потока + +`zfs send` предоставляет параметры, которые управляют тем, что включает поток и насколько он компактен. Указание `-p` включает свойства набора данных, такие как настройки сжатия, квоты и точки монтирования, в поток. Указание `-R` генерирует пакет репликационного потока, который включает набор данных, все дочерние наборы данных, снимки, клоны и свойства вплоть до именованного снимка, и подразумевает `-p`. Пример в crossref:zfs[zfs-send-ssh,Отправка зашифрованных бекапов через SSH] использует `-R` для репликации полного дерева набора данных. Указание `-v` выводит информацию о сгенерированном потоке, включая отчет о ходе выполнения за секунду. + +Другие параметры изменяют формат блоков данных в потоке: + +* `-L` разрешает блоки размером более 128 КБ в потоке, сохраняя размер блоков на диске для наборов данных с `recordsize` выше 128 КБ вместо разделения таких блоков. +* `-e` создаёт более компактный поток, используя записи `WRITE_EMBEDDED` для крошечных блоков, которые функция пула `embedded_data` хранит непосредственно в указателе блока. +* `-c` отправляет блоки, сжатые на диске, в их сжатом виде, а не распаковывает их сначала, экономя время процессора на обеих системах и сокращая объем передаваемых данных для сжатых наборов данных. +* `-w` отправляет зашифрованный набор данных в необработанном виде, точно так, как он хранится на диске, и без загрузки его ключа шифрования, как описано в разделе crossref:zfs[zfs-encrypted-send,Отправка зашифрованных наборов данных]. Для незашифрованных наборов данных `-w` эквивалентно `-Lec`. + +Объединение этих параметров как `zfs send -Lec` является хорошим выбором по умолчанию для современных пулов. Принимающий пул должен поддерживать все возможности, которые использует поток, и `zfs receive` отклоняет поток, требующий возможности, отсутствующей в пуле. Смотрите man:zfs-send[8] и man:zpool-features[7] для полного списка параметров и возможностей пула, от которых они зависят. + +[[zfs-send-resume]] +==== Возобновляемые передачи + +Разорванное сетевое соединение или перезагрузка во время большой передачи обычно означает, что нужно начинать заново. Использование `zfs receive -s` сохраняет частично принятое состояние на принимающем наборе данных вместо его удаления, когда поток завершается преждевременно. + +[source, shell] +.... +# zfs send -v mypool@replica1 | zfs receive -s backup/mypool +full send of mypool@replica1 estimated size is 50.1M +total estimated size is 50.1M +TIME SENT SNAPSHOT mypool@replica1 +10:31:01 9.75M mypool@replica1 +^C +.... + +После прерывания принимающий набор данных сохраняет непрозрачный токен возобновления в своём свойстве `receive_resume_token`. Токен записывает, какой снимок содержал прерванный поток и какая его часть была получена. Передача токена команде `zfs send -t` создаёт новый поток, который продолжает с того места, где передача остановилась: + +[source, shell] +.... +# zfs get -H -o value receive_resume_token backup/mypool +1-1211c4f4a-f8-789c636064000310a501c49c50360710a715e5e7a69766a63040c1eabb735735ce8f8d5420c0e5c9e8d4d3d28a5388e4d3d200 +# zfs send -t $(zfs get -H -o value receive_resume_token backup/mypool) | zfs receive -s backup/mypool +.... + +Возобновлённая передача завершается нормально и удаляет сохранённое частичное состояние. Пока передача не возобновлена или не прервана, частичное состояние занимает место в принимающем пуле и блокирует другие приёмы в тот же набор данных. Чтобы отказаться от прерванной передачи вместо её возобновления, используйте `zfs receive -A` для удаления сохранённого частичного состояния: + +[source, shell] +.... +# zfs receive -A backup/mypool +.... [[zfs-send-ssh]] ==== Отправка зашифрованных резервных копий через SSH -Отправка потоков данных по сети — это хороший способ создания удалённой резервной копии, но у этого метода есть недостаток. Данные, передаваемые по сетевому соединению, не шифруются, что позволяет любому перехватить их и преобразовать обратно в данные без ведома отправителя. Это нежелательно при отправке потоков через интернет на удалённый хост. Используйте SSH для безопасного шифрования данных, передаваемых по сетевому соединению. Поскольку ZFS требует перенаправления потока из стандартного вывода, его легко передать через SSH с помощью конвейера. Чтобы содержимое файловой системы оставалось зашифрованным при передаче и на удалённой системе, рассмотрите возможность использования https://wiki.freebsd.org/PEFS[PEFS]. +Отправка потоков данных по сети — это хороший способ создания удалённой резервной копии, но у этого метода есть недостаток. Данные, передаваемые по сетевому соединению, не шифруются, что позволяет любому перехватить их и преобразовать обратно в данные без ведома отправителя. Это нежелательно при отправке потоков через интернет на удалённый хост. Используйте SSH для безопасного шифрования данных, передаваемых по сетевому соединению. Поскольку ZFS требует перенаправления потока из стандартного вывода, его легко передать через SSH с помощью конвейера. Чтобы содержимое файловой системы оставалось зашифрованным и на удалённой системе, используйте crossref:zfs[zfs-native-encryption,встроенное шифрование] и отправляйте набор данных в виде необработанного (raw) потока, как описано в crossref:zfs[zfs-encrypted-send,«Отправка зашифрованных наборов данных»]. Измените некоторые настройки и сначала примите меры безопасности. Здесь описаны необходимые шаги для операции `zfs send`; дополнительную информацию о SSH см. в crossref:security[openssh,"OpenSSH"]. Измените конфигурацию следующим образом: * Беспарольный доступ SSH между отправляющим и принимающим хостами с использованием SSH-ключей * Для отправки и получения потоков ZFS требуются привилегии пользователя `root`. Это подразумевает вход в принимающую систему под учётной записью `root`. * По соображениям безопасности вход пользователя `root` по умолчанию запрещён. * Используйте систему crossref:zfs[zfs-zfs-allow,Делегирование ZFS], чтобы разрешить пользователю без прав `root` на каждой системе выполнять соответствующие операции отправки и получения. На передающей системе: [source, shell] .... # zfs allow -u someuser send,snapshot mypool .... * Чтобы подключить пул, непривилегированный пользователь должен быть владельцем каталога, а обычные пользователи должны иметь разрешение на подключение файловых систем. На принимающей системе: [source, shell] .... # sysctl vfs.usermount=1 vfs.usermount: 0 -> 1 # echo vfs.usermount=1 >> /etc/sysctl.conf # zfs create recvpool/backup # zfs allow -u someuser create,mount,receive recvpool/backup # chown someuser /recvpool/backup .... Непривилегированный пользователь теперь может получать и монтировать наборы данных, а также реплицирует набор данных _home_ на удалённую систему: [source, shell] .... % zfs snapshot -r mypool/home@monday % zfs send -R mypool/home@monday | ssh someuser@backuphost zfs recv -dvu recvpool/backup .... -Создайте рекурсивный снимок с именем _monday_ для набора данных файловой системы _home_ в пуле _mypool_. Затем `zfs send -R` включает в поток набор данных, все дочерние наборы данных, снимки, клоны и настройки. Передайте вывод через SSH на ожидающий `zfs receive` на удалённом хосте _backuphost_. Рекомендуется использовать IP-адрес или полное доменное имя. Принимающая машина записывает данные в набор данных _backup_ в пуле _recvpool_. Добавление `-d` к `zfs recv` перезаписывает имя пула на принимающей стороне именем снимка. `-u` отключает монтирование файловых систем на принимающей стороне. Использование `-v` показывает подробности о передаче, включая затраченное время и объём переданных данных. +Создайте рекурсивный снимок с именем _monday_ для набора данных файловой системы _home_ в пуле _mypool_. Затем `zfs send -R` включает в поток набор данных, все дочерние наборы данных, снимки, клоны и настройки. Передайте вывод через SSH на ожидающий `zfs receive` на удалённом хосте _backuphost_. Рекомендуется использовать IP-адрес или полное доменное имя. Принимающая машина записывает данные в набор данных _backup_ в пуле _recvpool_. Добавление опции `-d` к команде `zfs recv` отбрасывает первый элемент пути отправленного снимка (обычно это имя пула) и присоединяет оставшуюся часть пути к принимаемому набору данных, создавая при необходимости все промежуточные файловые системы. `-u` отключает монтирование файловых систем на принимающей стороне. Использование `-v` показывает подробности о передаче, включая затраченное время и объём переданных данных. -[[zfs-zfs-quota]] -=== Квоты наборов данных, пользователей и групп +[[zfs-recv-corrective]] +==== Корректирующий приём -Используйте crossref:zfs[zfs-term-quota,Квоты наборов данных], чтобы ограничить объём пространства, используемого определённым набором данных. crossref:zfs[zfs-term-refquota,Референтные квоты] работают схожим образом, но учитывают пространство, используемое самим набором данных, исключая снимки и дочерние наборы данных. Аналогично, используйте crossref:zfs[zfs-term-userquota,пользовательские] и crossref:zfs[zfs-term-groupquota,групповые] квоты, чтобы предотвратить исчерпание всего пространства в пуле или наборе данных пользователями или группами. +Процедура проверки (scrub) обнаруживает поврежденные данные, но в пуле без достаточной избыточности она не может исправить повреждения и вместо этого сообщает о постоянных ошибках. Если на другом пуле существует неповрежденная копия затронутого снимка, корректирующий прием с помощью `zfs receive -c` восстанавливает поврежденные блоки на месте, используя поток отправки как источник здоровых данных. Набор данных остается на своем месте, без каких-либо откатов или переименований. -Следующие примеры предполагают, что пользователи уже существуют в системе. Перед добавлением пользователя в систему убедитесь, что вы сначала создали его домашний набор данных и установили `mountpoint` в `/home/_bob_`. Затем создайте пользователя и укажите домашний каталог на расположение `mountpoint` набора данных. Это правильно установит права владельца и группы без перекрытия уже существующих путей домашних каталогов. +[NOTE] +==== +Корректирующий приём требует OpenZFS 2.2, впервые поставленный во FreeBSD 14.0. +==== -Чтобы установить квоту набора данных в 10 ГБ для [.filename]#storage/home/bob#: +В этом примере проверка пула _mypool_ на одном диске обнаружила неустранимые повреждения: [source, shell] .... -# zfs set quota=10G storage/home/bob -.... - +# zpool status -v mypool + pool: mypool + state: ONLINE +status: One or more devices has experienced an error resulting in data + corruption. Applications may be affected. +action: Restore the file in question if possible. Otherwise restore the + entire pool from backup. + see: https://openzfs.github.io/openzfs-docs/msg/ZFS-8000-8A + scan: scrub repaired 0B in 00:01:22 with 1 errors on Sat Jul 11 09:14:37 2026 +config: + + NAME STATE READ WRITE CKSUM + mypool ONLINE 0 0 0 + ada0 ONLINE 0 0 2 + +errors: Permanent errors have been detected in the following files: + + /mypool/reports/summary-2026.db +.... + +Снимок _replica2_ по-прежнему ссылается на повреждённые блоки, а пул _backup_ содержит неповреждённую копию этого снимка. Отправьте снимок из пула backup и получите его корректирующе в соответствующий снимок на повреждённом пуле, затем выполните проверку (scrub), чтобы подтвердить восстановление: + +[source, shell] +.... +# zfs send backup/mypool@replica2 | zfs receive -c mypool@replica2 +# zpool scrub -w mypool +# zpool status mypool | grep errors: +errors: No known data errors +.... + +Поток должен содержать тот же снапшот, который существует на повреждённом наборе данных. Корректирующий приём восстанавливает только те блоки данных, которые присутствуют в потоке; он не может исправить метаданные или данные, записанные после создания снапшота. После этого всегда выполняйте crossref:zfs[zfs-zpool-scrub,scrub], чтобы убедиться, что пул больше не содержит повреждённых данных. + +[[zfs-zfs-quota]] +=== Квоты наборов данных, пользователей и групп + +Используйте crossref:zfs[zfs-term-quota,Квоты наборов данных], чтобы ограничить объём пространства, используемого определённым набором данных. crossref:zfs[zfs-term-refquota,Референтные квоты] работают схожим образом, но учитывают пространство, используемое самим набором данных, исключая снимки и дочерние наборы данных. Аналогично, используйте crossref:zfs[zfs-term-userquota,пользовательские] и crossref:zfs[zfs-term-groupquota,групповые] квоты, чтобы предотвратить исчерпание всего пространства в пуле или наборе данных пользователями или группами. Квоты проектов, описанные ниже, ограничивают занимаемое пространство для произвольного дерева каталогов. + +Следующие примеры предполагают, что пользователи уже существуют в системе. Перед добавлением пользователя в систему убедитесь, что вы сначала создали его домашний набор данных и установили `mountpoint` в `/home/_bob_`. Затем создайте пользователя и укажите домашний каталог на расположение `mountpoint` набора данных. Это правильно установит права владельца и группы без перекрытия уже существующих путей домашних каталогов. + +Чтобы установить квоту набора данных в 10 ГБ для [.filename]#storage/home/bob#: + +[source, shell] +.... +# zfs set quota=10G storage/home/bob +.... + Чтобы установить контрольную квоту в 10 ГБ для [.filename]#storage/home/bob#: [source, shell] .... # zfs set refquota=10G storage/home/bob .... Удалить квоту в 10 ГБ для [.filename]#storage/home/bob#: [source, shell] .... # zfs set quota=none storage/home/bob .... Общий формат `userquota@_пользователь_=_размер_`, и имя пользователя должно быть в одном из следующих форматов: * POSIX-совместимое имя, например _joe_. * Числовой идентификатор POSIX, например, _789_. * Имя SID, например, _joe.bloggs@example.com_. * Числовой идентификатор SID, например, _S-1-123-456-789_. Например, чтобы установить пользовательскую квоту в 50 ГБ для пользователя с именем _joe_: [source, shell] .... -# zfs set userquota@joe=50G +# zfs set userquota@joe=50G storage/home/joe .... Чтобы удалить любую квоту: [source, shell] .... -# zfs set userquota@joe=none +# zfs set userquota@joe=none storage/home/joe .... [NOTE] ==== Свойства квот пользователей не отображаются командой `zfs get all`. Пользователи без прав `root` не могут видеть квоты других, если им не предоставлена привилегия `userquota`. Пользователи с этой привилегией могут просматривать и устанавливать квоты для всех. ==== Общий формат для установки квоты группы: `groupquota@_группа_=_размер_`. Чтобы установить квоту для группы _firstgroup_ в 50 ГБ, используйте: [source, shell] .... -# zfs set groupquota@firstgroup=50G +# zfs set groupquota@firstgroup=50G storage/home .... Чтобы удалить квоту для группы _firstgroup_ или убедиться, что она не установлена, используйте вместо этого: [source, shell] .... -# zfs set groupquota@firstgroup=none +# zfs set groupquota@firstgroup=none storage/home .... Как и в случае с пользовательскими квотами, пользователи без прав `root` могут видеть квоты, связанные с группами, к которым они принадлежат. Пользователь с привилегией `groupquota` или `root` может просматривать и устанавливать квоты для всех групп. -Для отображения объёма пространства, используемого каждым пользователем в файловой системе или снимке, вместе с квотами, используйте `zfs userspace`. Для информации о группах используйте `zfs groupspace`. Подробнее о поддерживаемых опциях или о том, как отобразить только определённые опции, см. в man:zfs[1]. +Для отображения объёма пространства, используемого каждым пользователем в файловой системе или снимке, вместе с квотами, используйте `zfs userspace`. Для информации о группах используйте `zfs groupspace`. Подробнее о поддерживаемых опциях или о том, как отобразить только определённые опции, см. в man:zfs-userspace[8]. Привилегированные пользователи и `root` могут просмотреть квоту для [.filename]#storage/home/bob#, используя: [source, shell] .... # zfs get quota storage/home/bob .... +[[zfs-zfs-quota-project]] +==== Проектные квоты + +Квоты наборов данных и пользователей подходят не для любой структуры. Когда несколько деревьев каталогов, принадлежащих разным проектам, используют один набор данных, квоты проектов ограничивают пространство, потребляемое каждым деревом, вместо этого. Проект — это произвольный числовой идентификатор, присваиваемый файлам и каталогам. + +`zfs project` управляет идентификатором проекта файлов и каталогов. Установка флага наследования проекта на каталог приводит к тому, что новые файлы и подкаталоги, созданные внутри него, наследуют его идентификатор проекта. Чтобы назначить идентификатор проекта _42_ существующему дереву, рекурсивно установите флаг и идентификатор: + +[source, shell] +.... +# zfs project -s -p 42 -r /storage/proj +.... + +Наложить ограничение в 100 ГБ на все файлы, принадлежащие проекту _42_, с помощью свойства `projectquota`: + +[source, shell] +.... +# zfs set projectquota@42=100G storage +.... + +`zfs projectspace` отображает пространство, потребляемое каждым проектом на наборе данных, а также любые квоты: + +[source, shell] +.... +# zfs projectspace -o name,used,quota storage +NAME USED QUOTA +42 1.95G 100G +.... + +Свойство `projectobjquota` ограничивает количество объектов, которыми может владеть проект, аналогичным образом. Отобразите или очистите идентификатор проекта для каталога с помощью `zfs project -d` и `zfs project -C`. Подробности см. в man:zfs-project[8] и man:zfsprops[7]. + [[zfs-zfs-reservation]] === Резервирования crossref:zfs[zfs-term-reservation,Резервирования] гарантируют всегда доступный объём пространства в наборе данных. Зарезервированное пространство не будет доступно для других наборов данных. Эта полезная функция обеспечивает наличие свободного места для важных наборов данных или файлов журналов. Общий формат свойства `reservation` — `reservation=_размер_`, поэтому, чтобы установить резервирование в 10 ГБ для [.filename]#storage/home/bob#, используйте: [source, shell] .... # zfs set reservation=10G storage/home/bob .... Чтобы очистить любое резервирование: [source, shell] .... # zfs set reservation=none storage/home/bob .... Тот же принцип применяется к свойству `refreservation` для установки crossref:zfs[zfs-term-refreservation,Референсного резервирования], с общим форматом `refreservation=_размер_`. Эта команда показывает все и резервирования (`reservation`), и референсные резервирования (`refreservation`), существующие в [.filename]#storage/home/bob#: [source, shell] .... # zfs get reservation storage/home/bob # zfs get refreservation storage/home/bob .... [[zfs-zfs-compression]] === Сжатие ZFS предоставляет прозрачное сжатие. Сжатие данных на уровне блоков экономит место и увеличивает пропускную способность диска. Если данные сжимаются на 25%, то сжатые данные записываются на диск с той же скоростью, что и несжатые, что приводит к эффективной скорости записи в 125%. Сжатие также может быть отличной альтернативой crossref:zfs[zfs-zfs-deduplication,Дедупликации], так как не требует дополнительной памяти. -ZFS предлагает различные алгоритмы сжатия, каждый со своими компромиссами. Введение сжатия LZ4 в ZFS v5000 позволяет сжимать весь пул без значительного снижения производительности, характерного для других алгоритмов. Главное преимущество LZ4 — функция _раннего прерывания_. Если LZ4 не достигает как минимум 12,5% сжатия в заголовочной части данных, ZFS записывает блок без сжатия, чтобы избежать потерь процессорного времени на попытки сжать уже сжатые или несжимаемые данные. Подробнее о различных алгоритмах сжатия, доступных в ZFS, см. в разделе crossref:zfs[zfs-term-compression,Сжатие] терминологии. +ZFS предлагает различные алгоритмы сжатия, каждый со своими компромиссами. В OpenZFS 2.2 и новее для вновь создаваемых пулов и наборов данных по умолчанию установлено значение `compression=on`, которое выбирает алгоритм LZ4. Сжатие LZ4 позволяет сжимать весь пул без значительного снижения производительности, характерного для других алгоритмов. Главное преимущество LZ4 — функция _раннего прерывания_. Если LZ4 не достигает как минимум 12,5% сжатия в заголовочной части данных, ZFS записывает блок без сжатия, чтобы избежать потерь процессорного времени на попытки сжать уже сжатые или несжимаемые данные. Изменение свойства `compression` влияет только на новые записи; существующие данные сохраняют свою старую кодировку до тех пор, пока не будут перезаписаны (см. crossref:zfs[zfs-zfs-rewrite,«Перезапись существующих данных»]). Подробнее о различных алгоритмах сжатия, доступных в ZFS, см. в разделе crossref:zfs[zfs-term-compression,Сжатие] терминологии. Администратор может оценить эффективность сжатия, используя свойства набора данных. [source, shell] .... # zfs get used,compressratio,compression,logicalused mypool/compressed_dataset -NAME PROPERTY VALUE SOURCE -mypool/compressed_dataset used 449G - -mypool/compressed_dataset compressratio 1.11x - -mypool/compressed_dataset compression lz4 local -mypool/compressed_dataset logicalused 496G - +NAME PROPERTY VALUE SOURCE +mypool/compressed_dataset used 449G - +mypool/compressed_dataset compressratio 1.11x - +mypool/compressed_dataset compression lz4 local +mypool/compressed_dataset logicalused 496G - .... Набор данных использует 449 ГБ пространства (свойство `used`). Без сжатия он занял бы 496 ГБ пространства (свойство `logicalused`). Это даёт коэффициент сжатия 1.11:1. Сжатие может иметь неожиданный побочный эффект при использовании вместе с crossref:zfs[zfs-term-userquota,Квотами пользователей]. Квоты пользователей ограничивают фактическое пространство, которое пользователь занимает на наборе данных _после сжатия_. Если у пользователя есть квота в 10 ГБ, и он записывает 10 ГБ сжимаемых данных, он всё равно сможет сохранить больше данных. Если позже пользователь обновит файл, например базу данных, более или менее сжимаемыми данными, количество доступного ему пространства изменится. Это может привести к необычной ситуации, когда пользователь не увеличил фактический объём данных (свойство `logicalused`), но изменение степени сжатия привело к достижению предела его квоты. Сжатие может иметь схожий непредвиденный эффект при взаимодействии с резервными копиями. Квоты часто используются для ограничения хранимых данных, чтобы гарантировать наличие достаточного места для резервного копирования. Поскольку квоты не учитывают сжатие, ZFS может записать больше данных, чем поместилось бы при резервном копировании без сжатия. [[zfs-zfs-compression-zstd]] === Сжатие алгоритмом Zstandard -В OpenZFS 2.0 был добавлен новый алгоритм сжатия. Zstandard (Zstd) обеспечивает более высокие коэффициенты сжатия по сравнению с используемым по умолчанию LZ4, при этом работая значительно быстрее альтернативного gzip. OpenZFS 2.0 доступен начиная с FreeBSD 12.1-RELEASE в пакете package:sysutils/openzfs[] и является стандартным начиная с FreeBSD 13.0-RELEASE. +В OpenZFS 2.0 был добавлен алгоритм сжатия Zstandard (Zstd). Zstd обеспечивает более высокие коэффициенты сжатия по сравнению с используемым по умолчанию LZ4, при этом работая значительно быстрее альтернативного gzip. Zstd предоставляет широкий выбор уровней сжатия, обеспечивая детальный контроль над производительностью и степенью сжатия. Одним из основных преимуществ Zstd является то, что скорость распаковки не зависит от уровня сжатия. Для данных, которые записываются один раз, но часто читаются, Zstd позволяет использовать максимальные уровни сжатия без потери производительности при чтении. Даже при частом обновлении данных включение сжатия часто обеспечивает более высокую производительность. Одно из главных преимуществ связано с функцией сжатого ARC. Адаптивный кэш замещения (ARC Adaptive Replacement Cache) в ZFS хранит сжатую версию данных в оперативной памяти, распаковывая их при каждом обращении. Это позволяет хранить больше данных и метаданных в том же объёме памяти, повышая коэффициент попадания в кэш. -ZFS предлагает 19 уровней сжатия Zstd, каждый из которых обеспечивает постепенное увеличение экономии места в обмен на более медленное сжатие. Уровень по умолчанию — `zstd-3`, который обеспечивает лучшее сжатие, чем LZ4, без значительного снижения скорости. Уровни выше 10 требуют большого объёма памяти для сжатия каждого блока, и системы с менее чем 16 ГБ ОЗУ не должны их использовать. ZFS также использует подмножество уровней Zstd_fast_, которые работают быстрее, но обеспечивают меньшую степень сжатия. ZFS поддерживает уровни от `zstd-fast-1` до `zstd-fast-10`, от `zstd-fast-20` до `zstd-fast-100` с шагом 10, а также `zstd-fast-500` и `zstd-fast-1000`, которые обеспечивают минимальное сжатие, но обладают высокой производительностью. +ZFS предлагает 19 уровней сжатия Zstd, каждый из которых обеспечивает постепенное увеличение экономии места в обмен на более медленное сжатие. Уровень по умолчанию — `zstd-3`, который обеспечивает лучшее сжатие, чем LZ4, без значительного снижения скорости. Уровни выше 10 требуют большого объёма памяти для сжатия каждого блока, и системы с менее чем 16 ГБ ОЗУ не должны их использовать. ZFS также использует подмножество уровней Zstd _fast_, которые работают быстрее, но обеспечивают меньшую степень сжатия. ZFS поддерживает уровни от `zstd-fast-1` до `zstd-fast-10`, от `zstd-fast-20` до `zstd-fast-100` с шагом 10, а также `zstd-fast-500` и `zstd-fast-1000`, которые обеспечивают минимальное сжатие, но обладают высокой производительностью. Если ZFS не может получить необходимую память для сжатия блока с помощью Zstd, он переходит к сохранению блока в несжатом виде. Это маловероятно, за исключением случаев использования максимальных уровней Zstd на системах с ограниченной памятью. ZFS подсчитывает, сколько раз это произошло с момента загрузки модуля ZFS, с помощью `kstat.zfs.misc.zstd.compress_alloc_fail`. +[[zfs-zfs-rewrite]] +=== Перезапись существующих данных + +[NOTE] +==== +`zfs rewrite` требует OpenZFS 2.4, впервые выпущенный во FreeBSD 15.0. +==== + +Свойства, такие как `compression`, `checksum`, `dedup` и `copies`, влияют только на вновь записываемые данные. Их изменение оставляет существующие блоки сохранёнными как есть, и применение новых значений традиционно требовало цикла отправки/получения или копирования каждого файла туда и обратно. `zfs rewrite` вместо этого перезаписывает блоки существующих файлов на месте, как если бы они были атомарно прочитаны и записаны обратно, поэтому текущие значения свойств вступают в силу без этих обходных путей. + +Команда работает с файлами и каталогами, а не с именами наборов данных. Чтобы применить вновь выбранный алгоритм сжатия ко всему набору данных, выполните рекурсивный обход от его точки монтирования: + +[source, shell] +.... +# zfs set compression=zstd mypool/archive +# zfs rewrite -r /mypool/archive +.... + +Добавление `-v` выводит имя каждого перезаписанного файла. `-x` предотвращает переход рекурсии через точки монтирования в дочерние наборы данных, а `-o` и `-l` ограничивают перезапись диапазоном байт внутри файла. Изменения свойств, которые могли бы изменить логический размер блока, такие как `recordsize`, не влияют на перезаписанные файлы. + +Переписанные блоки — это новые блоки: снимки, сделанные до перезаписи, продолжают ссылаться на старые копии, поэтому использование дискового пространства может расти, пока эти снимки не будут уничтожены. `zfs rewrite` не работает через снимки по той же причине. Подробности см. в man:zfs-rewrite[8]. + [[zfs-zfs-deduplication]] === Дедупликация Когда включена перекрёстная crossref:zfs[zfs-term-deduplication,дедупликация], она использует контрольную сумму каждого блока для обнаружения дублирующихся блоков. Когда новый блок является дубликатом существующего блока, ZFS записывает новую ссылку на существующие данные вместо всего дублирующегося блока. Возможна значительная экономия места, если данные содержат много дублирующихся файлов или повторяющейся информации. Предупреждение: дедупликация требует большого объёма памяти, а включение сжатия обеспечивает большую часть экономии места без дополнительных затрат. -Для активации дедупликации установите свойство `dedup` в целевой пул: +`dedup` является свойством набора данных, а не свойством пула. Чтобы активировать дедупликацию, установите это свойство на наборе данных: [source, shell] .... # zfs set dedup=on pool .... -Дедупликация затрагивает только новые данные, записываемые в пул. Простое включение этой опции не приведёт к дедупликации уже записанных в пул данных. Пул с только что активированным свойством дедупликации будет выглядеть следующим образом: +Этот пример устанавливает свойство на корневом наборе данных пула _pool_, поэтому каждый набор данных в пуле наследует его. Ограничение дедупликации только наборами данных, которые действительно хранят данные с большим количеством дубликатов, позволяет поддерживать таблицу дедупликации меньшего размера. + +Дедупликация затрагивает только новые данные, записываемые в набор данных. Простое включение этой опции не приведёт к дедупликации уже записанных данных. В FreeBSD 15.0 crossref:zfs[zfs-zfs-rewrite,`zfs rewrite`] позволяет перезаписать существующие данные так, чтобы они прошли через дедупликацию. Пул с только что активированным свойством дедупликации будет выглядеть следующим образом: [source, shell] .... # zpool list NAME SIZE ALLOC FREE CKPOINT EXPANDSZ FRAG CAP DEDUP HEALTH ALTROOT pool 2.84G 2.19M 2.83G - - 0% 0% 1.00x ONLINE - .... Столбец `DEDUP` показывает фактический уровень дедупликации для пула. Значение `1.00x` означает, что данные пока не дедуплицированы. В следующем примере некоторые системные двоичные файлы копируются три раза в разные каталоги в пуле с дедупликацией, созданном выше. [source, shell] .... # for d in dir1 dir2 dir3; do > mkdir $d && cp -R /usr/bin $d & > done .... Для наблюдения за дедупликацией избыточных данных используйте: [source, shell] .... # zpool list NAME SIZE ALLOC FREE CKPOINT EXPANDSZ FRAG CAP DEDUP HEALTH ALTROOT pool 2.84G 20.9M 2.82G - - 0% 0% 3.00x ONLINE - .... -Столбец `DEDUP` показывает коэффициент `3.00x`. Обнаружение и дедупликация копий данных используют треть пространства. Потенциальная экономия пространства может быть огромной, но достигается за счет наличия достаточного объёма памяти для отслеживания дедуплицированных блоков. +Столбец `DEDUP` показывает коэффициент `3.00x`. Обнаружение и дедупликация копий данных используют треть пространства. Потенциальная экономия пространства может быть огромной, но достигается за счет наличия достаточного объёма памяти для отслеживания дедуплицированных блоков. ZFS хранит запись для каждого дедуплицированного блока в таблице дедупликации (crossref:zfs[zfs-term-deduplication,DDT]). Эмпирическое правило гласит, что требуется 5–6 ГБ оперативной памяти на 1 ТБ дедуплицированных данных. Когда таблица перестаёт помещаться в памяти, каждая запись вынуждает считывать элементы таблицы с диска, и производительность резко падает. Дедупликация не всегда полезна, если данные в пуле не содержат избыточности. ZFS может показать потенциальную экономию пространства, имитируя дедупликацию на существующем пуле: [source, shell] .... # zdb -S pool Simulated DDT histogram: bucket allocated referenced ______ ______________________________ ______________________________ refcnt blocks LSIZE PSIZE DSIZE blocks LSIZE PSIZE DSIZE ------ ------ ----- ----- ----- ------ ----- ----- ----- 1 2.58M 289G 264G 264G 2.58M 289G 264G 264G 2 206K 12.6G 10.4G 10.4G 430K 26.4G 21.6G 21.6G 4 37.6K 692M 276M 276M 170K 3.04G 1.26G 1.26G 8 2.18K 45.2M 19.4M 19.4M 20.0K 425M 176M 176M 16 174 2.83M 1.20M 1.20M 3.33K 48.4M 20.4M 20.4M 32 40 2.17M 222K 222K 1.70K 97.2M 9.91M 9.91M 64 9 56K 10.5K 10.5K 865 4.96M 948K 948K 128 2 9.50K 2K 2K 419 2.11M 438K 438K 256 5 61.5K 12K 12K 1.90K 23.0M 4.47M 4.47M 1K 2 1K 1K 1K 2.98K 1.49M 1.49M 1.49M Total 2.82M 303G 275G 275G 3.20M 319G 287G 287G dedup = 1.05, compress = 1.11, copies = 1.00, dedup * compress / copies = 1.16 .... -После завершения анализа пула командой `zdb -S` отображается коэффициент сокращения пространства, который был бы достигнут при активации дедупликации. В данном случае значение `1.16` указывает на низкий уровень экономии пространства, в основном обеспечиваемый сжатием. Активация дедупликации для этого пула не сэкономит значительного объёма пространства и не оправдает объём памяти, необходимый для её включения. Используя формулу _ratio = dedup * compress / copies_, системные администраторы могут планировать распределение хранилища, определяя, будет ли рабочая нагрузка содержать достаточное количество дублирующихся блоков, чтобы оправдать требования к памяти. Если данные достаточно хорошо сжимаемы, экономия пространства может быть значительной. Рекомендуется сначала включить сжатие, так как оно также значительно повышает производительность. Активируйте дедупликацию только в случаях, когда экономия пространства существенна и имеется достаточный объём доступной памяти для crossref:zfs[zfs-term-deduplication,DDT]. +После завершения анализа пула командой `zdb -S` отображается коэффициент сокращения пространства, который был бы достигнут при активации дедупликации. В данном случае значение `1.16` указывает на низкий уровень экономии пространства, в основном обеспечиваемый сжатием. Активация дедупликации для этого пула не сэкономит значительного объёма пространства и не оправдает объём памяти, необходимый для её включения. Используя формулу _ratio = dedup * compress / copies_, системные администраторы могут планировать распределение хранилища, определяя, будет ли рабочая нагрузка содержать достаточное количество дублирующихся блоков, чтобы оправдать требования к памяти. Если данные достаточно хорошо сжимаемы, экономия пространства может быть значительной. + +Быстрое дедуплицирование, переработанная реализация, снижающая эти затраты, требует OpenZFS 2.3 или более поздней версии, впервые доступной в FreeBSD 15.0. Быстрое дедуплицирование группирует обновления таблицы дедупликации в журнале на диске и сбрасывает их в таблицу в фоновом режиме, снижая случайный ввод-вывод, из-за которого классическая дедупликация была медленной. Свойство пула `dedup_table_quota` задаёт ограничение на размер таблицы на диске; ZFS прекращает добавлять новые записи, когда пул достигает лимита, а при значении по умолчанию `auto` размер выделенного vdev для дедупликации служит квотой. Свойство пула `dedup_table_size`, доступное только для чтения, сообщает текущий размер таблицы. `zpool ddtprune -p 30 pool` удаляет самые старые 30% записей таблицы, которые не дают экономии, поскольку на них ссылается только один блок; `-d _days_` вместо этого удаляет записи с одной ссылкой, старше указанного количества дней. `zpool status -DD pool` отображает статистику таблицы дедупликации, включая гистограмму блоков по количеству ссылок. Хранение таблицы на выделенном crossref:zfs[zfs-zpool-special,для дедупликации vdev], состоящем из быстрых устройств, обеспечивает быстрый поиск даже когда таблица превышает объём оперативной памяти. + +Хорошей практикой является сначала включить сжатие, так как сжатие также обеспечивает значительно повышенную производительность. Включайте дедупликацию в случаях, когда экономия значительна и имеется достаточно доступной памяти для crossref:zfs[zfs-term-deduplication,DDT]. [[zfs-zfs-jail]] === ZFS и клетки Используйте `zfs jail` и соответствующее свойство `jailed`, чтобы делегировать набор данных ZFS в crossref:jails[jails,Клетку]. `zfs jail _идентификатор_клетки_` присоединяет набор данных к указанной клетке, а `zfs unjail` отсоединяет его. Для управления набором данных изнутри клетки установите свойство `jail`. ZFS запрещает монтирование на хосте набора данных со свойством jail, так как его точки монтирования могут нарушить безопасность хоста. +Делегированный набор данных передает управление всем поддеревом администратору клетки, который может монтировать его, создавать дочерние наборы данных, делать снимки и изменять свойства, все это ограничено этим поддеревом. Для этого клетке необходимо включить параметры `allow.mount` и `allow.mount.zfs`, а параметр `enforce_statfs` установить на значение ниже 2. Обратитесь к man:jail[8] за подробностями об этих параметрах. + +Этот пример создаёт набор данных, помечает его как находящийся в клетке и прикрепляет его к запущенной клетке _myjail_: + +[source, shell] +.... +# zfs create mypool/jaildata +# zfs set jailed=on mypool/jaildata +# zfs jail myjail mypool/jaildata +.... + +Затем набор данных появляется в `zfs list` внутри клетки и доступен для управления там. `zfs unjail myjail mypool/jaildata` возвращает управление хосту. Дополнительную информацию см. в man:zfs-jail[8]. + +Начиная с FreeBSD 15.0, man:jail[8] автоматизирует подключение. Укажите наборы данных для делегирования в параметре клетки `zfs.dataset`, и man:jail[8] подключает их при запуске клетки. Наборы данных уже должны иметь установленный параметр `jailed=on`, а параметр требует `allow.mount.zfs`. Запись в [.filename]#/etc/jail.conf# с его использованием выглядит так: + +[.programlisting] +.... +myjail { + path = "/usr/local/jails/myjail"; + host.hostname = "myjail.example.org"; + exec.start = "/bin/sh /etc/rc"; + exec.stop = "/bin/sh /etc/rc.shutdown"; + allow.mount; + allow.mount.zfs; + enforce_statfs = 1; + zfs.dataset = "mypool/jaildata"; +} +.... + +Установка параметра клетки `zfs.mount_snapshot` в значение 1 дополнительно позволяет пользователям внутри клетки получать доступ к содержимому снимков ZFS в каталоге [.filename]#.zfs# делегированных файловых систем. + [[zfs-zfs-allow]] == Делегированное администрирование Комплексная система делегирования прав позволяет непривилегированным пользователям выполнять функции администрирования ZFS. Например, если домашний каталог каждого пользователя является набором данных, пользователям нужно разрешение на создание и удаление снимков своих домашних каталогов. Пользователь, выполняющий резервное копирование, может получить разрешение на использование функций репликации. ZFS позволяет скрипту статистики использования работать с доступом только к данным о занятом пространстве для всех пользователей. Также возможно делегирование права на делегирование разрешений. Делегирование прав доступно для каждой подкоманды и большинства свойств. [[zfs-zfs-allow-create]] === Делегирование создания наборов данных `zfs allow _someuser_ create _mydataset_` предоставляет указанному пользователю разрешение на создание дочерних наборов данных в выбранном родительском наборе данных. Важное замечание: создание нового набора данных включает его монтирование. Для этого необходимо установить параметр `vfs.usermount` в man:sysctl[8] FreeBSD в значение `1`, чтобы разрешить непривилегированным пользователям монтировать файловую систему. Ещё одно ограничение, направленное на предотвращение злоупотреблений: непривилегированные пользователи должны быть владельцами точки монтирования, куда монтируется файловая система. [[zfs-zfs-allow-allow]] === Делегирование права делегировать разрешения `zfs allow _someuser_ allow _mydataset_` предоставляет указанному пользователю возможность назначать любые разрешения, которые у него есть для целевого набора данных или его дочерних элементов, другим пользователям. Если пользователь имеет разрешение `snapshot` и разрешение `allow`, он может предоставить разрешение `snapshot` другим пользователям. +[[zfs-native-encryption]] +== Встроенное шифрование ZFS + +ZFS поддерживает встроенное шифрование наборов данных и данных, хранящихся в них. Так было не всегда: предыдущие решения полагались на шифрование на основе GELI во FreeBSD. Хотя этот подход безопасен, он не был так легко переносим на системы, отличные от FreeBSD, в которых отсутствовала поддержка GELI. Благодаря встроенному шифрованию ZFS зашифрованные наборы данных можно использовать на других системах, поддерживающих эту функцию пула, без зависимости от сторонних компонентов или встроенного шифрования операционной системы. + +Ещё одним преимуществом встроенного шифрования ZFS является то, что наборы данных не нужно расшифровывать для административных задач, таких как создание снимков, репликация или операции проверки целостности. Проверки целостности данных ZFS работают одинаково хорошо с нативно зашифрованными наборами данных, а сжатие также работает с зашифрованными наборами данных. + +Разные наборы данных в одном пуле могут использовать отдельные ключи независимо. Рассмотрим центральный файловый сервер, где разные пользователи хранят свои данные в зашифрованных домашних наборах данных. У пользователя A ключ отличается от ключа пользователя B. Оба пользователя могут работать параллельно и расшифровывать свои наборы данных по мере необходимости, не зная ключей расшифровки друг друга. Метод расшифровки также может полностью различаться между пользователями, не влияя друг на друга. Это позволяет хранить конфиденциальные данные разных пользователей в одном пуле, оставаясь защищёнными отдельными ключами. + +Перед использованием встроенного шифрования ZFS, учтите следующее: + +- Шифрование применяется на уровне набора данных, а не на уровне пула. +- Загрузка с зашифрованных наборов данных ZFS пока не поддерживается в загрузчике FreeBSD. +- Шифрование может быть включено только при создании набора данных, а не после. +- Блочный шифр, длина ключа и режим шифрования не могут быть изменены после того, как они были установлены. +- ZFS не шифрует метаданные. + +Последний пункт может показаться недостатком по сравнению с полнодисковым шифрованием. Однако он обеспечивает большую гибкость, позволяя разным ключам защищать наборы данных (datasets) в рамках одного пула, вместо того чтобы требовать один ключ или парольную фразу для разблокировки всего пула. В частности, ZFS шифрует следующее: + +* данные файла и zvol, +* атрибуты файлов, +* ACL, +* биты разрешений, +* листинги каталогов, +* Соответствия FUID, +* используемые пользователем/групповые используемые данные, и +* Дедуплицированные данные + +Некоторые метаданные и информация ZFS остаются незашифрованными, включая следующее: + +* структура и имя пула, +* имена наборов данных и снимков, +* иерархия наборов данных, +* свойства, +* размер файла +* пропуски в файлах, и +* Таблицы дедупликации + +Этот набор незашифрованных метаданных позволяет ZFS выполнять рутинные операции обслуживания, такие как `zpool scrub`, без предварительной расшифровки данных. В результате ZFS может обнаруживать и исправлять повреждённые зашифрованные данные, не обращаясь к незашифрованному содержимому файлов. + +Чтобы зашифровать существующие незашифрованные данные, скопируйте их в набор данных с включенным шифрованием. Это позволяет перенести данные в защищенное место в пуле, при условии предоставления парольной фразы для авторизации доступа. Обычно это делается путем загрузки ключа шифрования в память после подтверждения знания секрета, такого как парольная фраза. После загрузки ключа содержимое набора данных становится доступным для чтения и записи. Чтобы снова защитить набор данных, выгрузите ключ из памяти. Тогда ZFS сделает набор данных недоступным до тех пор, пока ключ не будет загружен снова. + +Когда шифрование включено, некоторые операции ZFS ведут себя иначе. ZFS применяет сжатие перед шифрованием, чтобы сохранить коэффициенты сжатия. Хотя ZFS обычно использует 256-битные контрольные суммы, шифрование заменяет их на 128-битную контрольную сумму и 128-битный код аутентификации сообщения (MAC), предоставляемый набором шифрования. Это обеспечивает дополнительную защиту от злонамеренного изменения данных. + +Когда дедупликация используется вместе с шифрованием, ZFS выполняет дедупликацию только в пределах зашифрованного набора данных, его снимков и его клонов. Это предотвращает утечку информации между зашифрованными наборами данных. Обратной стороной является более низкая эффективность дедупликации, поскольку ZFS не может сравнивать контрольные суммы по всему пулу. Тем не менее, дедупликация в сочетании с шифрованием всё равно раскрывает, какие блоки идентичны, и добавляет дополнительные накладные расходы на ЦП для каждого записываемого блока. + +У шифрования ZFS также есть и другие ограничения. Возможность `embedded_data` не может использоваться с шифрованием. Наборы данных с включенным шифрованием также не могут иметь свойство `copies`, установленное в 3, поскольку реализация хранит зашифрованные метаданные в том месте, где обычно размещалась бы третья копия. + +[[zfs-encrypted-dataset-creation]] +=== Создание зашифрованного набора данных + +Шифрование ZFS включается путем установки свойства `encryption=on` при создании набора данных. Установка этого свойства вне команды `zfs create` не включает шифрование задним числом, поскольку оно действует только во время создания набора данных. В следующем примере для монтирования зашифрованного набора данных после его создания используется парольная фраза. + +[source, shell] +.... +# zfs create -o encryption=on -o keyformat=passphrase -o keylocation=prompt zroot/secretdata +Enter passphrase: +Re-enter passphrase: +.... + +Если парольная фраза короче восьми символов, ZFS отклоняет её и не создаёт набор данных. После того как парольная фраза была введена правильно дважды, ZFS создаёт и монтирует набор данных в пуле. + +Любые данные, хранящиеся в зашифрованном наборе данных, остаются зашифрованными, пока они там находятся. Копирование данных из зашифрованного набора данных в незашифрованное место расшифровывает данные во время операции копирования. Затем вновь созданный набор данных можно при необходимости смонтировать в другом месте. + +[source, shell] +.... +# zfs set mountpoint=/secretdata zroot/secretdata +# echo "Hello FreeBSD!" > /secretdata/message +# cat /secretdata/message +Hello FreeBSD! +.... + +Как и ожидалось, данные в настоящее время доступны для чтения и записи любому, у кого есть доступ к набору данных. + +[[zfs-encrypted-dataset-properties]] +=== Свойства зашифрованных наборов данных + +Перечисление свойств собственного шифрования ZFS для набора данных выполняется с помощью следующей команды: + +[source, shell] +.... +# zfs get encryption,keylocation,keyformat zroot/secretdata +NAME PROPERTY VALUE SOURCE +zroot/secretdata encryption aes-256-gcm - +zroot/secretdata keylocation prompt local +zroot/secretdata keyformat passphrase - +.... + +Свойство `encryption` показывает `aes-256-gcm`, который в настоящее время является методом шифрования, используемым ZFS по умолчанию. Как указано в столбце `SOURCE`, ни это свойство, ни свойство `keyformat` нельзя изменить с помощью `zfs set` после создания набора данных. Смотрите раздел crossref:zfs[zfs-change-encryption-key,изменение ключа шифрования] для получения информации о том, как изменить некоторые из этих свойств. В следующей таблице перечислены свойства, связанные с шифрованием, используемые ZFS: + +[.informaltable] +[cols="10%,90%"] +|=== + +|[[zfs-term-encryptionroot]]encryptionroot +|Набор данных, из которого текущий набор данных наследует свой ключ шифрования. +Клоны наборов данных разделяют ключ шифрования своего исходного набора данных. + +|[[zfs-term-keyformat]]keyformat +a|Формат ключа шифрования. Возможные значения: `raw`, `hex` и `passphrase`. Как `raw`, так и `hex` ключи должны иметь длину 32 байта и содержать случайные значения. +|[[zfs-term-encryption]]encryption +a|Шифр, используемый для шифрования, состоящий из блочного шифра, длины ключа и режима шифрования. Свойства `encryption` и `keyformat` должны быть указаны при создании набора данных. Возможные значения свойства `encryption`: + + * `off` (по умолчанию), + * `on`, + * `aes-128-ccm`, + * `aes-192-ccm`, + * `aes-256-ccm`, + * `aes-128-gcm`, + * `aes-192-gcm` и + * `aes-256-gcm` (текущий стандарт при установке `on`). + +Это свойство нельзя изменить после того, как оно было установлено. + +|[[zfs-term-keystatus]]keystatus +a|Указывает, был ли успешно загружен ключ шифрования. Возможные значения: `none`, `available` и `unavailable`. + +|[[zfs-term-keylocation]]keylocation +a|Указывает местоположение, из которого следует загрузить ключ шифрования. Возможные значения: + +* `prompt`, +* `file://path/to/file`, +* `http://some.address` и +* `https://other.address` + +|[[zfs-term-pbkdf2iters]]pbkdf2iters +a|Количество итераций, используемых при получении ключа шифрования из парольной фразы. Это вынуждает злоумышленника выполнять большое количество вычислительно затратных операций хеширования. По мере роста вычислительной мощности это значение также следует увеличивать с текущего значения по умолчанию, равного 350000. +|=== + +[[zfs-unload-encryption-key]] +=== Выгрузка ключа шифрования + +Защита данных, хранящихся в зашифрованном наборе данных, требует двух шагов: сначала размонтировать набор данных, затем выгрузить ключ шифрования из памяти. Это различие важно. Размонтированный набор данных не защищён, если его ключ шифрования остаётся загруженным в памяти. Всегда выполняйте `zfs unload-key`, чтобы защитить данные. Чтобы снова получить доступ к набору данных, загрузите ключ и укажите парольную фразу, как описано в разделе crossref:zfs[zfs-load-encryption-key,загрузка ключа шифрования]. ZFS предотвращает выполнение `zfs unload-key`, пока набор данных всё ещё смонтирован. + +[source, shell] +.... +# zfs unmount zroot/secretdata +# zfs unload-key zroot/secretdata +.... + +Выполнение `zfs unload-key` несколько раз приводит к ошибке, указывающей на то, что ключ уже был выгружен. + +[[zfs-load-encryption-key]] +=== Загрузка ключа шифрования + +Прежде чем зашифрованный набор данных можно будет использовать, как и любой другой набор данных, необходимо загрузить его ключ шифрования и указать парольную фразу. На этом этапе свойство `keystatus` по-прежнему имеет значение `unavailable`, и монтирование набора данных завершается ошибкой, поскольку ключ ещё не был загружен: + +[source, shell] +.... +# zfs get keystatus zroot/secretdata +NAME PROPERTY VALUE SOURCE +zroot/secretdata keystatus unavailable - +# zfs mount zroot/secretdata +cannot mount 'zroot/secretdata': encryption key not loaded +.... + +Это указывает на то, что набор данных зашифрован и требует ключ шифрования. Чтобы смонтировать набор данных, выполните `zfs load-key` и введите парольную фразу при появлении запроса: + +[source, shell] +.... +# zfs load-key zroot/secretdata +Enter passphrase for 'zroot/secretdata': +# zfs get keystatus zroot/secretdata +NAME PROPERTY VALUE SOURCE +zroot/secretdata keystatus available - +.... + +Затем смонтируйте набор данных, чтобы сделать его доступным через иерархию файловой системы: + +[source, shell] +.... +# zfs mount zroot/secretdata +# mount|grep secretdata +zroot/secretdata on /secretdata (zfs, local, noatime, nfsv4acls) +.... + +Чтобы рекурсивно загрузить несколько ключей шифрования, укажите параметр `-r` с командой `zfs load-key`. Если ключ уже был загружен, ZFS сообщает об этом сообщением об ошибке. + +[source, shell] +.... +# zfs load-key zroot/secretdata +Key load error: Key already loaded for 'zroot/secretdata'. +.... + +Свойство `keystatus` также подтверждает, что ключ был загружен, сообщая значение `available`. Чтобы проверить, корректен ли пароль, не загружая ключ, используйте параметр `-n` для выполнения пробного запуска. + +[[zfs-change-encryption-key]] +=== Изменение ключа шифрования + +ZFS также поддерживает смену ключей шифрования, например, замену парольной фразы. Эта операция не требует повторного шифрования набора данных. Выполните следующую команду, чтобы изменить парольную фразу шифрования: + +[source, shell] +.... +# zfs change-key zroot/secretdata +Enter new passphrase for 'zroot/secretdata': +Re-enter new passphrase for 'zroot/secretdata': +.... + +Выполнение `zfs change-key` требует, чтобы текущий ключ был загружен. Если он не загружен, ZFS всё равно запросит новый ключ, но затем выведет предупреждение о том, что текущий ключ не был загружен. + +Команда `zfs change-key` также может изменять свойства `keylocation`, `keyformat` и `pbkdf2iters`, указывая их с помощью опции `-o`. Выполнение `zfs change-key` над зашифрованным дочерним набором данных делает его корнем шифрования, если он еще не является таковым. Чтобы предотвратить такое поведение и продолжить наследование ключа родительского набора, укажите опцию `-i`. + +Имейте в виду, что смена ключа шифрования родительского набора данных также меняет ключ для дочерних наборов данных, которые его наследуют. Следовательно, эти дочерние наборы данных продолжают использовать ключ шифрования родителя. Если дочерний набор данных должен использовать другой ключ, либо укажите другой `keyformat` при его создании, либо выполните `zfs change-key` для дочернего набора данных. Это создаст новый корень шифрования для дочернего элемента и разорвёт его наследование шифрования от родителя. + +Клоны ZFS зашифрованного набора данных всегда используют ключ шифрования своего исходного набора данных. В результате свойства `keystatus`, `keyformat`, `keylocation` и `pbkdf2iters` не наследуются, как другие свойства набора данных. Вместо этого они используют значения, определённые корнем шифрования. Чтобы определить корень шифрования, используйте свойство `encryptionroot` только для чтения. + +Если злоумышленник скомпрометировал ключ шифрования, смена парольной фразы с помощью `zfs change-key` не обязательно защитит существующие или вновь записанные данные. Новые данные продолжают шифроваться тем же мастер-ключом, что и существующие. Если злоумышленник получит как пользовательский ключ, так и соответствующий обёрнутый мастер-ключ, выполнение `zfs change-key` не перезапишет предыдущий мастер-ключ на диске. В результате старый мастер-ключ может оставаться доступным для анализа данных в течение неопределённого периода времени. + +Если мастер-ключ был скомпрометирован, предпочтительным решением является безопасное стирание нижележащих устройств хранения и создание нового пула. После этого восстановите данные из резервной копии в новый пул. Или создайте новый зашифрованный набор данных, перенесите данные с помощью `zfs send` и `zfs receive`, а затем выполните `zpool trim --secure`, чтобы стереть освободившееся пространство. Если нижележащее оборудование не поддерживает безопасный TRIM, вместо этого используйте `zpool initialize`. + +[[zfs-encrypted-send]] +=== Отправка зашифрованных наборов данных + +Репликация ZFS основана на отправке снимков наборов данных, которые также могут быть созданы из зашифрованных наборов данных. Полученные снимки остаются зашифрованными. + +[source, shell] +.... +# zfs snapshot zroot/secretdata@snap1 +.... + +В дополнение к crossref:zfs[zfs-send-ssh,отправке зашифрованных резервных копий через SSH], использование опции `-w` (raw) с командой `zfs send` передает зашифрованные блоки данных в целевой пул. Сырая отправка обеспечивает несколько преимуществ: + +* принимающая система никогда не видит данные в открытом виде. +* принимающая система не требует кодовую фразу, поскольку расшифровка не выполняется. +* Резервные копии можно отправлять без предварительной загрузки ключа шифрования. +* Ненадёжная система может получить зашифрованные данные, но не может расшифровать или изменить их без ключа шифрования. + +Чтобы отправить созданный выше снимок в виде необработанного потока в набор данных `secret` в пуле `backup`, введите следующую команду: + +[source, shell] +.... +# zfs send -w zroot/secretdata@snap1 | zfs recv backup/secret +.... + +Без опции `-w` команда `zfs send` передает данные в незашифрованном виде. Принимающая система затем может повторно зашифровать данные, используя другой ключ. Однако это предотвращает будущие инкрементальные «сырые» отправки на это место назначения. + +[[zfs-zfskeys]] +=== Загрузка ключей шифрования при загрузке + +Скрипт `zfskeys` из man:rc[8] загружает ключи шифрования при загрузке для зашифрованных наборов данных, чьё свойство `keylocation` указывает на файл ключа с URL-адресом `file://`. Скрипт запускается после импорта пула и перед монтированием файловых систем, поэтому наборы данных, обрабатываемые таким образом, монтируются автоматически во время обычного запуска ZFS. Скрипт не обрабатывает наборы данных с `keylocation=prompt`; загружайте их ключи вручную с помощью `zfs load-key` после загрузки системы. + +Чтобы переключить набор данных, созданный ранее, с парольной фразы на файл ключа, сгенерируйте 32 байта случайных данных в качестве нового ключа, ограничьте доступ к файлу ключа и измените ключ шифрования набора данных: + +[source, shell] +.... +# dd if=/dev/random of=/root/secretdata.key bs=32 count=1 +# chmod 600 /root/secretdata.key +# zfs change-key -o keyformat=raw -o keylocation=file:///root/secretdata.key zroot/secretdata +.... + +Включите скрипт в файле [.filename]#/etc/rc.conf#: + +[source, shell] +.... +# sysrc zfskeys_enable="YES" +.... + +По умолчанию сценарий загружает ключи всех зашифрованных наборов данных с расположением ключей `file://`. Чтобы ограничить загрузку ключей конкретными наборами данных, перечислите их в `zfskeys_datasets`, разделяя пробелами: + +[source, shell] +.... +# sysrc zfskeys_datasets="zroot/secretdata" +.... + +[WARNING] +==== +Любой, кто может прочитать файл ключа, сможет расшифровать набор данных. Держите файл ключа принадлежащим `root` с правами `600` и храните его на хранилище, которое само защищено, например, на зашифрованной корневой файловой системе или сменном носителе, который подключается только во время загрузки. +==== + +[[zfs-boot-environments]] +== Загрузочные окружения + +Загрузочное окружение — это загрузочный crossref:zfs[zfs-term-clone,клон] дерева наборов данных, которое содержит операционную систему. На системах, установленных с раскладкой Root-on-ZFS, эти наборы данных находятся в `zroot/ROOT`, а работающая система — в `zroot/ROOT/default`. Создание загрузочного окружения создаёт снимки и клоны корневых наборов данных, что занимает секунды и почти не потребляет места на диске, пока окружения не начнут расходиться. + +Управление загрузочными окружениями с помощью man:bectl[8]. Создайте новое окружение перед серьезным изменением, таким как обновление операционной системы или крупного пакета: + +[source, shell] +.... +# bectl create beforeupgrade +# bectl list +BE Active Mountpoint Space Created +default NR / 2.43G 2026-07-11 11:26 +beforeupgrade - - 328K 2026-07-11 11:31 +.... + +В столбце `Active` метка `N` обозначает окружение, используемое в данный момент, а `R` — то, которое станет активным после перезагрузки. + +Выполните обновление с помощью man:freebsd-update[8] или man:pkg[8] как обычно. Обновление изменяет активное окружение, тогда как `beforeupgrade` сохраняет систему в её прежнем состоянии. Если обновлённая система не загружается или работает некорректно, перезагрузитесь и выберите `beforeupgrade` из меню `Boot Environments` загрузчика FreeBSD. Выбор окружения в меню загрузчика влияет только на текущую загрузку. Чтобы сделать откат постоянным, активируйте это окружение: + +[source, shell] +.... +# bectl activate beforeupgrade +.... + +Выполнение `bectl activate -t _beName_` вместо этого активирует окружение только для следующей загрузки, что полезно при тестировании изменений на удаленной системе. + +Чтобы осмотреть или восстановить содержимое неактивного окружения без его загрузки, смонтируйте его во временное расположение: + +[source, shell] +.... +# bectl mount beforeupgrade +/tmp/be_mount.c1Xk +# bectl umount beforeupgrade +.... + +Уничтожьте окружение, которое больше не нужно, чтобы освободить занимаемое окружением пространство: + +[source, shell] +.... +# bectl destroy beforeupgrade +.... + +[TIP] +==== +Создание загрузочного окружения перед каждым man:freebsd-update[8] upgrade или крупной операцией man:pkg[8] обеспечивает мгновенный способ вернуться к заведомо исправной системе без восстановления из резервных копий. +==== + +[[zfs-be-applications]] +=== Загрузочные окружения и приложения + +Загрузочное окружение содержит только наборы данных в `zroot/ROOT`. В стандартной компоновке Root-on-ZFS это включает всю корневую файловую систему с [.filename]#/usr/local# и [.filename]#/var/db#, поэтому установленные пакеты и их метаданные откатываются вместе с операционной системой. Наборы данных за пределами `zroot/ROOT`, такие как `zroot/home`, `zroot/var/log` и `zroot/var/mail`, являются общими: каждое окружение видит одни и те же файлы, и активация более старого окружения не возвращает их в более раннее состояние. + +Спланируйте структуру набора данных с учётом этого разделения до того, как полагаться на загрузочные окружения. Данные, которые должны пережить откат, например базы данных приложения, установленного из пакетов, должны находиться в собственном наборе данных вне `zroot/ROOT`: + +[source, shell] +.... +# zfs create -o mountpoint=/var/db/postgres zroot/pgdata +.... + +При такой компоновке откат к более старой среде возвращает бинарные файлы сервера баз данных к их предыдущей версии, в то время как содержимое базы данных остается нетронутым. Обратное также верно: файлы, записанные в общие наборы данных при тестировании новой среды, сохраняются после переключения обратно, поэтому загрузочные среды не заменяют crossref:zfs[zfs-zfs-snapshot,снимки] этих наборов данных. + [[zfs-advanced]] == Сложные темы [[zfs-advanced-tuning]] === Настройка -Настройте параметры для оптимальной производительности ZFS в различных рабочих нагрузках. +Отрегулируйте параметры настройки, чтобы ZFS показывал наилучшую производительность для различных рабочих нагрузок. FreeBSD предоставляет параметры ядра ZFS как переменные man:sysctl[8] в разделе `vfs.zfs`; man:zfs[4] документирует каждый параметр и его значение по умолчанию. Установите значения, которые должны применяться с момента загрузки, в [.filename]#/boot/loader.conf#; изменяйте значения, доступные для изменения во время работы, с помощью man:sysctl[8] и сделайте их постоянными в [.filename]#/etc/sysctl.conf#. -* [[zfs-advanced-tuning-arc_max]] `_vfs.zfs.arc.max_` начиная с 13.x (`vfs.zfs.arc_max` для 12.x) - Верхний размер crossref:zfs[zfs-term-arc,ARC]. По умолчанию используется весь объём ОЗУ за исключением 1 ГБ или 5/8 от всего объёма ОЗУ, в зависимости от того, что больше. Используйте меньшее значение, если в системе работают другие демоны или процессы, которым может потребоваться память. Изменяйте это значение во время работы с помощью man:sysctl[8] и задавайте его в [.filename]#/boot/loader.conf# или [.filename]#/etc/sysctl.conf#. -* [[zfs-advanced-tuning-arc_meta_limit]] `_vfs.zfs.arc.meta_limit_` начиная с 13.x (`vfs.zfs.arc_meta_limit` для 12.x) — ограничивает объём crossref:zfs[zfs-term-arc,ARC], используемого для хранения метаданных. По умолчанию составляет одну четвертую от `vfs.zfs.arc.max`. Увеличение этого значения может повысить производительность при работе с большим количеством файлов и каталогов или частых операциях с метаданными, за счет уменьшения объёма данных файлов, помещающихся в crossref:zfs[zfs-term-arc,ARC]. Это значение можно изменить во время работы с помощью man:sysctl[8] в [.filename]#/boot/loader.conf# или [.filename]#/etc/sysctl.conf#. -* [[zfs-advanced-tuning-arc_min]] `_vfs.zfs.arc.min_` начиная с 13.x (`vfs.zfs.arc_min` для 12.x) - Нижний размер crossref:zfs[zfs-term-arc,ARC]. По умолчанию составляет половину от `vfs.zfs.arc.meta_limit`. Измените это значение, чтобы предотвратить вытеснение всего crossref:zfs[zfs-term-arc,ARC] другими приложениями. Настройка этого значения возможна во время выполнения с помощью man:sysctl[8], а также в [.filename]#/boot/loader.conf# или [.filename]#/etc/sysctl.conf#. -* [[zfs-advanced-tuning-vdev-cache-size]] `_vfs.zfs.vdev.cache.size_` - Предварительно выделенный объём памяти, зарезервированный в качестве кэша для каждого устройства в пуле. Общий объём используемой памяти будет равен этому значению, умноженному на количество устройств. Установите это значение при загрузке и в [.filename]#/boot/loader.conf#. -* [[zfs-advanced-tuning-min-auto-ashift]] `_vfs.zfs.min_auto_ashift_` - Минимальное значение `ashift` (размер сектора), автоматически используемое при создании пула. Значение является степенью двойки. Значение по умолчанию `9` соответствует `2^9 = 512`, то есть размеру сектора 512 байт. Чтобы избежать _усиления записи_ (write amplification) и получить наилучшую производительность, установите это значение равным наибольшему размеру сектора среди устройств в пуле. -+ -Обычные диски имеют секторы размером 4 КБ. Использование значения `ashift` по умолчанию (`9`) для таких дисков приводит к усилению записи на этих устройствах. Данные, которые должны быть записаны одним блоком 4 КБ, вместо этого записываются восемью блоками по 512 байт. ZFS пытается определить родной размер сектора всех устройств при создании пула, но диски с секторами 4 КБ сообщают, что их секторы имеют размер 512 байт для совместимости. Установка `vfs.zfs.min_auto_ashift` в значение `12` (`2^12 = 4096`) перед созданием пула заставляет ZFS использовать блоки 4 КБ для наилучшей производительности на таких дисках. +* `_vfs.zfs.arc.max_`— верхний размер crossref:zfs[zfs-term-arc,ARC]. Значение по умолчанию `0` позволяет ZFS автоматически определять размер ARC на основе объёма установленной оперативной памяти. Используйте меньшее значение, если в системе работают другие демоны или процессы, которым может потребоваться память. Смотрите crossref:zfs[zfs-advanced-arc,«Размер и мониторинг ARC»] для получения информации. Изменяйте это значение во время работы с помощью man:sysctl[8] и задавайте его в [.filename]#/boot/loader.conf# или [.filename]#/etc/sysctl.conf#. +* `_vfs.zfs.arc.min_`— нижний размер crossref:zfs[zfs-term-arc,ARC]. Значение по умолчанию `0` позволяет ZFS автоматически выбирать небольшое минимальное значение. Увеличьте это значение, чтобы предотвратить вытеснение всего ARC другими приложениями. Настройка этого значения возможна во время выполнения с помощью man:sysctl[8], а также в [.filename]#/boot/loader.conf# или [.filename]#/etc/sysctl.conf#. +* `_vfs.zfs.arc.meta_balance_` — баланс между кэшированием метаданных и данных файлов в crossref:zfs[zfs-term-arc,ARC]; значения выше `100` всё больше отдают предпочтение метаданным, по умолчанию — `500`. Увеличьте это значение, если рабочая нагрузка связана с операциями над большим количеством файлов и каталогов или частыми операциями с метаданными, ценой уменьшения объёма данных файлов, помещающихся в ARC. Этот настраиваемый параметр заменяет `vfs.zfs.arc.meta_limit`, который был удалён в OpenZFS 2.2. Изменяйте это значение в любое время с помощью man:sysctl[8]. +* `_vfs.zfs.vdev.min_auto_ashift_` - Минимальное значение `ashift` (размер сектора), автоматически используемое при создании пула. Значение является степенью двойки. Значение по умолчанию `9` соответствует `2^9 = 512`, то есть размеру сектора 512 байт. Чтобы избежать _усиления записи_ (write amplification) и получить наилучшую производительность, установите это значение равным наибольшему размеру сектора среди устройств в пуле. + -Принудительное использование блоков размером 4 КБ также полезно для пулов с запланированным обновлением дисков. Будущие диски используют секторы размером 4 КБ, а значения `ashift` нельзя изменить после создания пула. -+ -В некоторых конкретных случаях меньший размер блока 512 байт может быть предпочтительнее. При использовании с дисками 512 байт для баз данных или в качестве хранилища для виртуальных машин уменьшается объём передаваемых данных при небольших случайных чтениях. Это может обеспечить лучшую производительность при использовании меньшего размера записи ZFS. -* [[zfs-advanced-tuning-prefetch_disable]] `_vfs.zfs.prefetch.disable_` — Отключает предварительную выборку. Значение `0` включает её, а `1` отключает. По умолчанию используется `0`, если в системе не менее 4 ГБ оперативной памяти. Предварительная выборка работает, считывая блоки большего размера, чем запрошено, в раздел crossref:zfs[zfs-term-arc,ARC], в надежде, что данные скоро понадобятся. Если рабочая нагрузка включает большое количество случайных чтений, отключение предварительной выборки может улучшить производительность, сократив ненужные чтения. Это значение можно изменить в любое время с помощью man:sysctl[8]. -* [[zfs-advanced-tuning-vdev-trim_on_init]] `_vfs.zfs.vdev.trim_on_init_` — Управляет тем, будет ли для новых устройств, добавленных в пул, выполняться команда `TRIM`. Это обеспечивает наилучшую производительность и долговечность для SSD, но занимает дополнительное время. Если устройство уже было безопасно очищено, отключение этой настройки ускорит добавление нового устройства. Значение можно изменить в любой момент с помощью man:sysctl[8]. -* [[zfs-advanced-tuning-vdev-max_pending]] `_vfs.zfs.vdev.max_pending_` — Ограничивает количество ожидающих запросов ввода-вывода для каждого устройства. Более высокое значение поддерживает очередь команд устройства заполненной и может увеличить пропускную способность. Более низкое значение уменьшает задержки. Это значение можно изменить в любое время с помощью man:sysctl[8]. -* [[zfs-advanced-tuning-top_maxinflight]] `_vfs.zfs.top_maxinflight_` — Верхний предел количества необработанных операций ввода-вывода для каждого корневого crossref:zfs[zfs-term-vdev,vdev]. Ограничивает глубину очереди команд для предотвращения высокой задержки. Лимит применяется к каждому корневому vdev, то есть ограничение действует независимо для каждого crossref:zfs[zfs-term-vdev-mirror,зеркала], crossref:zfs[zfs-term-vdev-raidz,RAID-Z] или другого vdev. Значение можно изменить в любое время с помощью man:sysctl[8]. -* [[zfs-advanced-tuning-l2arc_write_max]] `_vfs.zfs.l2arc_write_max_` — Ограничивает объём данных, записываемых в crossref:zfs[zfs-term-l2arc,L2ARC] в секунду. Этот параметр увеличивает срок службы SSD, ограничивая объём данных, записываемых на устройство. Значение можно изменить в любой момент с помощью man:sysctl[8]. -* [[zfs-advanced-tuning-l2arc_write_boost]] `_vfs.zfs.l2arc_write_boost_` — Добавляет значение этого параметра к crossref:zfs[zfs-advanced-tuning-l2arc_write_max,`vfs.zfs.l2arc_write_max`] и увеличивает скорость записи на SSD до вытеснения первого блока из crossref:zfs[zfs-term-l2arc,L2ARC]. Эта "Фаза турборазогрева" снижает потерю производительности из-за пустого crossref:zfs[zfs-term-l2arc,L2ARC] после перезагрузки. Значение можно изменить в любое время с помощью man:sysctl[8]. -* [[zfs-advanced-tuning-scrub_delay]]`_vfs.zfs.scrub_delay_` — Количество тактов задержки между каждой операцией ввода-вывода во время перекрестного crossref:zfs[zfs-term-scrub,`scrub`]. Чтобы гарантировать, что `scrub` не мешает нормальной работе пула, если происходят другие операции ввода-вывода, `scrub` будет задерживаться между каждой командой. Это значение контролирует ограничение на общее количество IOPS (операций ввода-вывода в секунду) - , сгенерированных командой `scrub`. Гранулярность настройки определяется значением `kern.hz`, которое по умолчанию равно 1000 тикам в секунду. Изменение этого параметра приводит к изменению эффективного лимита IOPS. Значение по умолчанию — `4`, что даёт лимит: 1000 тиков/сек / 4 = 250 IOPS. Использование значения _20_ установит лимит: 1000 тиков/сек / 20 = 50 IOPS. Недавняя активность в пуле ограничивает скорость `scrub`, как определено в crossref:zfs[zfs-advanced-tuning-scan_idle,`vfs.zfs.scan_idle`]. Это значение можно изменить в любое время с помощью man:sysctl[8]. -* [[zfs-advanced-tuning-resilver_delay]] `_vfs.zfs.resilver_delay_` — количество миллисекунд задержки, вставляемой между каждым операцией ввода-вывода во время crossref:zfs[zfs-term-resilver,ресильверинга]. Чтобы гарантировать, что ресильверинг не мешает нормальной работе пула, при наличии других операций ввода-вывода ресильверинг будет добавлять задержку между каждой командой. Данный параметр ограничивает общее количество IOPS (операций ввода-вывода в секунду), генерируемых ресильверингом. ZFS определяет гранулярность настройки через значение `kern.hz`, которое по умолчанию равно 1000 тикам в секунду. Изменение этого параметра приводит к изменению эффективного лимита IOPS. Значение по умолчанию — 2, что даёт лимит: 1000 тиков/сек / 2 = 500 IOPS. Возвращение пула в состояние crossref:zfs[zfs-term-online,Online] может быть более важным, если выход из строя другого устройства может перевести пул в состояние crossref:zfs[zfs-term-faulted,Fault], что приведёт к потере данных. Значение 0 даст операции ресильверинга такой же приоритет, как и другим операциям, ускоряя процесс восстановления. Недавняя активность в пуле ограничивает скорость ресильверинга, как определено в crossref:zfs[zfs-advanced-tuning-scan_idle,`vfs.zfs.scan_idle`]. Этот параметр можно изменить в любое время с помощью man:sysctl[8]. -* [[zfs-advanced-tuning-scan_idle]] `_vfs.zfs.scan_idle_` - Количество миллисекунд с момента последней операции, после которого пул считается бездействующим. ZFS отключает ограничение скорости для crossref:zfs[zfs-term-scrub,`scrub`] и crossref:zfs[zfs-term-resilver,ресильверинга], когда пул бездействует. Это значение можно изменить в любое время с помощью man:sysctl[8]. -* [[zfs-advanced-tuning-txg-timeout]] `_vfs.zfs.txg.timeout_` — Максимальное количество секунд между группами crossref:zfs[zfs-term-txg,транзакций]. Текущая группа транзакций записывается в пул, и начинается новая группа транзакций, если с момента предыдущей группы транзакций прошло указанное время. Группа транзакций может запуститься раньше при записи достаточного объёма данных. Значение по умолчанию составляет 5 секунд. Увеличение этого значения может улучшить производительность чтения за счет задержки асинхронных записей, но это может привести к неравномерной производительности при записи группы транзакций. Это значение можно изменить в любое время с помощью man:sysctl[8]. +См. crossref:zfs[zfs-zpool-create,Создание и уничтожение пулов хранения] о том, почему пулы на дисках с секторами 4 КБ должны использовать `ashift` со значением 12. +* `_vfs.zfs.prefetch.disable_` — Отключает предварительную выборку. Значение `0` включает её, а `1` отключает. По умолчанию используется `0`. Предварительная выборка работает, считывая блоки большего размера, чем запрошено, в раздел crossref:zfs[zfs-term-arc,ARC], в надежде, что данные скоро понадобятся. Если рабочая нагрузка включает большое количество случайных чтений, отключение предварительной выборки может улучшить производительность, сократив ненужные чтения. Это значение можно изменить в любое время с помощью man:sysctl[8]. +* `_vfs.zfs.txg.timeout_` — Максимальное количество секунд между группами crossref:zfs[zfs-term-txg,транзакций]. Текущая группа транзакций записывается в пул, и начинается новая группа транзакций, если с момента предыдущей группы транзакций прошло указанное время. Группа транзакций может запуститься раньше при записи достаточного объёма данных. Значение по умолчанию составляет 5 секунд. Увеличение этого значения может улучшить производительность чтения за счет задержки асинхронных записей, но это может привести к неравномерной производительности при записи группы транзакций. Это значение можно изменить в любое время с помощью man:sysctl[8]. +* `_vfs.zfs.l2arc.write_max_` — Ограничивает объём данных, записываемых в crossref:zfs[zfs-term-l2arc,L2ARC] в секунду. Этот параметр увеличивает срок службы SSD, ограничивая объём данных, записываемых на устройство. Значение можно изменить в любой момент с помощью man:sysctl[8]. +* `_vfs.zfs.l2arc.write_boost_` — Добавляет значение этого параметра к `vfs.zfs.l2arc.write_max` и увеличивает скорость записи на SSD до вытеснения первого блока из crossref:zfs[zfs-term-l2arc,L2ARC]. Эта "Фаза турборазогрева" снижает потерю производительности из-за пустого L2ARC после перезагрузки. Значение можно изменить в любое время с помощью man:sysctl[8]. +* `_vfs.zfs.l2arc.rebuild_enabled_` - Обеспечивает сохранение содержимого crossref:zfs[zfs-term-l2arc,L2ARC] при перезагрузках. При значении по умолчанию `1`, ZFS перестраивает L2ARC из журнальных блоков, хранящихся на устройстве кэша, при импорте пула, избегая длительного периода прогрева, который потребовался бы пустому кэшу. Установите это значение в `0`, чтобы всегда начинать с пустого L2ARC. +* `_vfs.zfs.vdev.max_active_` — максимальное количество активных запросов ввода-вывода на каждом устройстве в пуле. Более высокое значение поддерживает очередь команд устройства заполненной и может увеличить пропускную способность. Более низкое значение уменьшает задержки. Это значение можно изменить в любое время с помощью man:sysctl[8]. +* `_vfs.zfs.vdev.*_min_active_` и `_vfs.zfs.vdev.*_max_active_` — нижний и верхний предел количества одновременных запросов ввода-вывода, которые планировщик отправляет каждому устройству для каждого класса ввода-вывода: `sync_read`, `sync_write`, `async_read`, `async_write`, `scrub` и других. Эти ограничения для каждого класса заменяют основанное на задержках ограничение crossref:zfs[zfs-term-scrub,scrub] и crossref:zfs[zfs-term-resilver,resilver], которое использовалось в более старых версиях ZFS. Например, увеличение `vfs.zfs.vdev.scrub_max_active` позволяет операциям проверки (scrub) использовать большую долю очереди каждого устройства, завершаясь быстрее за счет увеличения задержки операций ввода-вывода переднего плана. +* _`vfs.zfs.resilver_min_time_ms_`_ — минимальное количество времени в миллисекундах, которое crossref:zfs[zfs-term-resilver,resilver] тратит на работу между сбросами групп транзакций; по умолчанию равно `3000` (3 секунды). Увеличьте это значение, чтобы завершить процесс восстановления (resilver) быстрее, когда деградировавший пул находится под угрозой потери другого устройства, ценой замедления нормальной работы пула. Изменяйте это значение в любое время с помощью man:sysctl[8]. -[[zfs-advanced-i386]] -=== ZFS на i386 +[[zfs-advanced-arc]] +=== Определение размера ARC и мониторинг -Некоторые функции ZFS требуют значительных ресурсов памяти и могут потребовать настройки для повышения эффективности на системах с ограниченным объёмом ОЗУ. +ZFS хранит недавно и часто используемые данные и метаданные в оперативной памяти в crossref:zfs[zfs-term-arc,ARC]. ARC растет по мере необходимости до `vfs.zfs.arc.max` и снова уменьшается, когда другим программам нужна память, поэтому на выделенном сервере хранения нормально, что большая часть оперативной памяти используется. ARC хранит блоки в их сжатом виде на диске и распаковывает их при доступе. Этот _сжатый ARC_ позволяет тому же объему оперативной памяти кэшировать больше данных, увеличивая эффективную частоту попаданий. -==== Память +man:top[1] отображает текущий размер ARC в строке сводки по памяти. Дерево `kstat.zfs.misc.arcstats` из man:sysctl[8] предоставляет подробную статистику, включая текущий размер, целевой максимум, а также счетчики попаданий и промахов: -В качестве минимального значения общий объём оперативной памяти системы должен составлять не менее одного гигабайта. Рекомендуемый объём оперативной памяти зависит от размера пула и используемых возможностей ZFS. Общее правило — 1 ГБ оперативной памяти на каждый 1 ТБ дискового пространства. При использовании функции дедупликации рекомендуется выделять 5 ГБ оперативной памяти на каждый 1 ТБ хранилища. Хотя некоторые пользователи используют ZFS с меньшим объёмом оперативной памяти, системы под высокой нагрузкой могут завершаться аварийно из-за нехватки памяти. Для систем с объёмом оперативной памяти меньше рекомендуемого может потребоваться дополнительная настройка ZFS. +[source, shell] +.... +% sysctl kstat.zfs.misc.arcstats.size kstat.zfs.misc.arcstats.c_max kstat.zfs.misc.arcstats.hits kstat.zfs.misc.arcstats.misses +kstat.zfs.misc.arcstats.size: 8963041280 +kstat.zfs.misc.arcstats.c_max: 15843122176 +kstat.zfs.misc.arcstats.hits: 954912441 +kstat.zfs.misc.arcstats.misses: 21356847 +.... -==== Настройка ядра +package:filesystems/zfs-stats[] обобщает эти статистические данные в удобочитаемом отчете. -Из-за ограничений адресного пространства платформы i386(TM), пользователям ZFS на архитектуре i386(TM) необходимо добавить следующую опцию в файл конфигурации собственного ядра, пересобрать ядро и перезагрузить систему: +ARC возвращает память при нехватке ресурсов, но на системах, где ОЗУ разделяется между ZFS и другими крупными потребителями, такими как базы данных, виртуальные машины или клетки, конкуренция может вызывать неравномерную производительность с обеих сторон. Ограничение ARC оставляет предсказуемый объём памяти для других рабочих нагрузок. Например, чтобы ограничить ARC до 8 ГБ, добавьте эту строку в [.filename]#/boot/loader.conf#: [.programlisting] .... -options KVA_PAGES=512 +vfs.zfs.arc.max="8G" .... -Это расширяет адресное пространство ядра, позволяя настройке `vm.kvm_size` выйти за установленный предел в 1 ГБ или предел в 2 ГБ для PAE. Чтобы найти наиболее подходящее значение для этой опции, разделите желаемое адресное пространство в мегабайтах на четыре. В данном примере `512` для 2 ГБ. +Изменение `vfs.zfs.arc.max` с помощью man:sysctl[8] вступает в силу немедленно, хотя уменьшение теплого ARC освобождает память постепенно. -==== Настройки загрузчика +[[zfs-advanced-zil-slog]] +=== Синхронные записи, ZIL и SLOG -Увеличивает адресное пространство `kmem` на всех архитектурах FreeBSD. Тестовая система с 1 ГБ физической памяти показала улучшение после добавления этих параметров в `/boot/loader.conf` и последующей перезагрузки: +Каждый пул имеет crossref:zfs[zfs-term-zil,ZIL]. Приложения, запрашивающие синхронную семантику с помощью man:fsync[2] или флага `O_SYNC`, не получают подтверждение до тех пор, пока ZFS не зафиксирует соответствующую запись журнала намерений в стабильном хранилище. По умолчанию ZIL располагается на обычных vdev пула, поэтому каждая синхронная запись конкурирует с обычным вводом-выводом пула. Асинхронные записи обходят ZIL и записываются со следующей crossref:zfs[zfs-term-txg,транзакционной группой]. -[.programlisting] +Выделенный перекрестная ссылка:zfs[zfs-term-vdev-log,log] vdev, часто называемый _SLOG_ (отдельный журнал), перемещает ZIL на быстрое устройство: + +[source, shell] .... -vm.kmem_size="330M" -vm.kmem_size_max="330M" -vfs.zfs.arc.max="40M" -vfs.zfs.vdev.cache.size="5M" +# zpool add mypool log mirror nda0 nda1 .... -Для более подробного списка рекомендаций по настройке ZFS см. https://wiki.freebsd.org/ZFSTuningGuide[]. +SLOG помогает только рабочим нагрузкам, которые генерируют много синхронных записей, например, NFS-серверам и базам данных. Для чисто асинхронных рабочих нагрузок он не имеет значения. + +Несколько гигабайт ёмкости SLOG вполне достаточно: ZIL хранит максимум несколько секунд входящих записей, примерно объём одной группы транзакций, прежде чем ZFS запишет данные в их конечное расположение в пуле. Выбирайте SSD с защитой от потери питания и низкой задержкой устойчивой записи, а также зеркалируйте устройства журнала. ZFS читает ZIL только после сбоя, поэтому потеря незеркалированного SLOG вместе со сбоем системы приводит к потере записей, которые были подтверждены, но ещё не зафиксированы в пуле. + +Свойство `sync` набора данных управляет поведением синхронной записи: + +* `sync=standard` (по умолчанию) фиксирует синхронные записи в ZIL, а асинхронные записи — со следующей группой транзакций. +* `sync=always` обрабатывает каждую запись как синхронную, жертвуя производительностью ради безопасности, которая помогает только приложениям, которые не запрашивают синхронные записи, когда это необходимо. +* `sync=disabled` обрабатывает каждую запись как асинхронную. + +[WARNING] +==== +С `sync=disabled` ZFS подтверждает синхронные записи до того, как они достигнут стабильного хранилища. Сам пул остается согласованным, но после сбоя или отключения питания приложения и NFS-клиенты незаметно теряют до нескольких секунд данных, которые, как они считали, были безопасно записаны. Не используйте `sync=disabled` для баз данных, NFS-экспортов или любых других важных данных. +==== + +Свойство `logbias` регулирует, как ZFS использует журнал: `logbias=latency` (по умолчанию) предпочитает SLOG для минимизации задержки фиксации, тогда как `logbias=throughput` записывает синхронные данные напрямую в основной пул, оставляя ёмкость SLOG для наборов данных, чувствительных к задержке. Подробности см. в man:zfsprops[7]. + +[[zfs-advanced-directio]] +=== Прямой ввод-вывод + +[NOTE] +==== +Прямой ввод-вывод требует OpenZFS 2.3 или более поздней версии, впервые доступной в FreeBSD 15.0. +==== + +Свойство набора данных `direct` управляет тем, как ZFS обрабатывает запросы, сделанные с флагом `O_DIRECT`: + +* `direct=standard` (по умолчанию) учитывает `O_DIRECT`: корректно выровненные чтения и записи обходят crossref:zfs[zfs-term-arc,ARC]. +* `direct=always` обрабатывает каждое правильно выровненное чтение или запись как прямой запрос. +* `direct=disabled` беззвучно игнорирует `O_DIRECT` и обрабатывает каждый запрос через ARC. + +Прямой ввод-вывод позволяет избежать копирования в памяти и накладных расходов на кэширование ARC. В пулах очень быстрых NVMe-устройств эти накладные расходы могут доминировать над стоимостью самого ввода-вывода, а приложения, поддерживающие собственные кэши, например базы данных, тратят оперативную память впустую, кэшируя одни и те же данные дважды. Для таких рабочих нагрузок прямой ввод-вывод может увеличить пропускную способность и снизить использование памяти. + +ZFS по-прежнему проверяет контрольные суммы для прямых чтений и записей, поэтому защита целостности данных не изменяется. Прямые записи должны быть выровнены по значению `recordsize` набора данных; ZFS незаметно перенаправляет невыровненную часть запроса через ARC. См. man:zfsprops[7] для получения полных правил и ограничений по выравниванию. + +[[zfs-advanced-recordsize]] +=== `recordsize` и `volblocksize` + +Свойство `recordsize` задаёт наибольший блок, который ZFS использует для хранения файла в наборе данных, по умолчанию 128 КБ. Согласование размера блока с шаблоном ввода-вывода рабочей нагрузки позволяет избежать чтения и записи большего объёма данных, чем запрашивает приложение. + +Для баз данных, выполняющих небольшие случайные чтения и записи, установите `recordsize` равным размеру страницы базы данных, обычно 8 КБ или 16 КБ, до создания файлов базы данных. Для наборов данных, хранящих большие медиафайлы или потоки резервных копий, которые читаются и записываются последовательно, `recordsize=1M` снижает накладные расходы на метаданные и улучшает сжатие. Тома используют свойство `volblocksize` вместо этого, которое по умолчанию составляет 16 КБ и не может быть изменено после создания тома. + +Изменение `recordsize` влияет только на новые записанные файлы; существующие файлы сохраняют свой исходный размер блока. Даже crossref:zfs[zfs-zfs-rewrite,`zfs rewrite`] не применяет новое значение `recordsize` к существующим файлам, поскольку изменения свойств, влияющие на логический размер блока, не действуют на перезаписанные блоки; скопируйте файлы заново, чтобы сохранить их с новым значением. [[zfs-links]] == Дополнительные ресурсы +* https://openzfs.github.io/openzfs-docs/[Документация OpenZFS], включая руководства по производительности и настройке * https://openzfs.org/[OpenZFS] -* https://wiki.freebsd.org/ZFSTuningGuide[FreeBSD Wiki - Настройка ZFS] -* https://calomel.org/zfs_raid_speed_capacity.html[Calomel Blog - ZFS Raidz Performance, Capacity and Integrity] +* man:zfs[4] описывает каждый настраиваемый параметр ядра, man:zpoolconcepts[7] описывает типы vdev и структуру пула, а man:zfsprops[7] описывает каждое свойство набора данных +* Инструменты автоматизации снимков и репликации из коллекции портов: +** package:filesystems/zrepl[] - демон репликации, поддерживающий конфигурации push и pull, автоматическое управление снимками и возобновляемые передачи +** package:sysutils/sanoid[] — управление снимками на основе политик, с входящим в комплект `syncoid` для репликации по SSH +** package:filesystems/zfstools[] - автоматическая ротация снимков в стиле службы автоматических снимков OpenSolaris, запускаемая из man:cron[8] +** package:filesystems/zap[] - простое обслуживание снапшотов и удаленная репликация, настраиваемое через свойства ZFS вместо файла конфигурации [[zfs-term]] == Особенности и терминология ZFS -ZFS — это не просто файловая система, а принципиально иной подход. ZFS объединяет функции файловой системы и менеджера томов, позволяя добавлять новые устройства хранения в работающую систему и сразу же использовать новое пространство в существующих файловых системах пула. Благодаря объединению традиционно разделённых ролей, ZFS преодолевает прежние ограничения, которые мешали расширению RAID-групп. Устройство _vdev_ — это устройство верхнего уровня в пуле, которое может быть простым диском или RAID-преобразованием, таким как зеркало или массив RAID-Z. Файловые системы ZFS (называемые _наборами данных_) имеют доступ к объединённому свободному пространству всего пула. Используемые блоки из пула уменьшают доступное пространство для каждой файловой системы. Такой подход позволяет избежать распространённой проблемы с разбиением на разделы, когда свободное пространство фрагментируется между разделами. +ZFS принципиально отличается от традиционных файловых систем. ZFS объединяет функции файловой системы и менеджера томов, позволяя добавлять новые устройства хранения в работающую систему и сразу же использовать новое пространство в существующих файловых системах пула. Благодаря объединению традиционно разделённых ролей, ZFS преодолевает прежние ограничения, которые мешали расширению RAID-групп. Устройство _vdev_ — это устройство верхнего уровня в пуле, которое может быть простым диском или RAID-преобразованием, таким как зеркало или массив RAID-Z. Файловые системы ZFS (называемые _наборами данных_) имеют доступ к объединённому свободному пространству всего пула. Используемые блоки из пула уменьшают доступное пространство для каждой файловой системы. Такой подход позволяет избежать распространённой проблемы с разбиением на разделы, когда свободное пространство фрагментируется между разделами. [.informaltable] [cols="10%,90%"] |=== |[[zfs-term-pool]]pool |Пул (_pool_) — это базовая строительная единица ZFS. Оно состоит из одного или нескольких vdev — устройств хранения данных. На основе хранилища создаются файловые системы (наборы данных, datasets) или блочные устройства (тома, volumes). -Эти наборы данных и тома используют общий пул свободного пространства. Каждый пул имеет уникальное имя и GUID. Доступные функции определяются версией ZFS, используемой в пуле. +Эти наборы данных и тома используют общий пул свободного пространства. Каждый пул имеет уникальное имя и GUID. Пулы, созданные современной OpenZFS, имеют версию пула 5000; начиная с этой версии, отдельные возможности управляются с помощью _функциональных флагов_ (feature flags), а не номера версии. Подробнее см. man:zpool-features[7] и crossref:zfs[zfs-zpool-upgrade,«Обновление пула хранения»]. |[[zfs-term-vdev]]vdev Types -a|Пул состоит из одного или нескольких vdev, которые, в свою очередь, представляют собой отдельный диск или группу дисков, преобразованных в RAID. При использовании множества vdev ZFS распределяет данные между ними для повышения производительности и максимизации доступного пространства. Все vdev должны быть размером не менее 128 МБ. +a|Пул состоит из одного или нескольких vdev, которые, в свою очередь, представляют собой отдельный диск или группу дисков, преобразованных в RAID. При использовании множества vdev ZFS распределяет данные между ними для повышения производительности и максимизации доступного пространства. Все vdev должны быть размером не менее 64 МБ. -* [[zfs-term-vdev-disk]] _Диск_ — Самый базовый тип vdev — это стандартное блочное устройство. Это может быть целый диск (например, [.filename]#/dev/ada0# или [.filename]#/dev/da0#) или раздел ([.filename]#/dev/ada0p3#). В FreeBSD нет потери производительности при использовании раздела вместо целого диска. Это отличается от рекомендаций документации Solaris. +* [[zfs-term-vdev-disk]] _Диск_ — Самый базовый тип vdev — это стандартное блочное устройство. Это может быть целый диск (например, [.filename]#/dev/ada0#) или раздел ([.filename]#/dev/ada0p3#). В FreeBSD нет потери производительности при использовании раздела вместо целого диска. Это отличается от рекомендаций документации Solaris. + [CAUTION] ==== Настоятельно не рекомендуется использовать целый диск в составе загружаемого пула, так как это может сделать пул незагружаемым. Аналогично, не следует использовать целый диск в составе зеркала (mirror) или RAID-Z vdev. Надежное определение размера неразмеченного диска во время загрузки невозможно, и нет места для размещения загрузочного кода. ==== * [[zfs-term-vdev-file]] _Файл_ — Обычные файлы могут составлять пулы ZFS, что полезно для тестирования и экспериментов. Используйте полный путь к файлу в качестве пути к устройству в команде `zpool create`. * [[zfs-term-vdev-mirror]] _Зеркало (Mirror)_ - При создании зеркала укажите ключевое слово `mirror`, за которым следует список устройств-участников зеркала. Зеркало состоит из двух или более устройств, и все данные записываются на все устройства-участники. Зеркальный vdev будет хранить столько данных, сколько может поместиться на его самом маленьком устройстве. Зеркальный vdev может пережить отказ всех устройств, кроме одного, без потери данных. + [NOTE] ==== -Чтобы в любой момент обновить обычный vdev с одним диском до зеркального vdev, используйте команду `zpool -crossref:zfs[zfs-zpool-attach,attach]`. +Чтобы в любой момент обновить обычный vdev с одним диском до зеркального vdev, используйте команду `zpool crossref:zfs[zfs-zpool-attach,attach]`. ==== * [[zfs-term-vdev-raidz]] _RAID-Z_ - ZFS использует RAID-Z — вариацию стандартного RAID-5, которая обеспечивает лучшее распределение чётности и устраняет проблему "записи дырки RAID-5", когда данные и информация о чётности становятся несогласованными после неожиданного перезапуска. ZFS поддерживает три уровня RAID-Z, которые обеспечивают разную степень избыточности в обмен на уменьшение доступного пространства. ZFS использует RAID-Z1, RAID-Z2 и RAID-Z3 в зависимости от количества устройств чётности в массиве и количества дисков, которые могут отказать до того, как пул перестанет работать. + В конфигурации RAID-Z1 с четырьмя дисками по 1 ТБ доступное пространство составляет 3 ТБ, и пул сможет продолжать работу в деградированном режиме при отказе одного диска. Если другой диск выйдет из строя до замены и восстановления отказавшего диска, это приведет к потере всех данных пула. + -В конфигурации RAID-Z3 с восемью дисками по 1 ТБ том предоставит 5 ТБ доступного пространства и сможет работать при отказе трёх дисков. Sun(TM) рекомендует использовать не более девяти дисков в одном vdev. Если конфигурация состоит из большего количества дисков, рекомендуется разделить их на отдельные vdev и распределить данные пула между ними. +В конфигурации RAID-Z3 с восемью дисками по 1 ТБ том предоставит 5 ТБ доступного пространства и сможет работать при отказе трёх дисков. Традиционная рекомендация использовать не более девяти дисков в одном vdev. Если конфигурация состоит из большего количества дисков, рекомендуется разделить их на отдельные vdev и распределить данные пула между ними. + Конфигурация из двух RAID-Z2 vdev, каждый из которых состоит из 8 дисков, создаст аналог массива RAID-60. Емкость RAID-Z группы примерно равна размеру самого маленького диска, умноженному на количество дисков без чётности. Четыре диска по 1 ТБ в RAID-Z1 дают эффективный размер около 3 ТБ, а массив из восьми дисков по 1 ТБ в RAID-Z3 обеспечит 5 ТБ доступного пространства. -* [[zfs-term-vdev-spare]] _Резервный (Spare)_ - ZFS имеет специальный псевдо-vdev для отслеживания доступных горячих резервов. Обратите внимание, что установленные горячие резервы не развертываются автоматически; их необходимо вручную настроить для замены отказавшего устройства с помощью команды `zfs replace`. -* [[zfs-term-vdev-log]] _Журнал (Log)_ - Устройства журнала ZFS, также известные как журнал намерений ZFS (Intent Log) - (crossref:zfs[zfs-term-zil,ZIL]), перемещают журнал намерений с обычных устройств пула на выделенное устройство, обычно SSD. Наличие выделенного устройства журнала улучшает производительность приложений с большим объёмом синхронных записей, таких как базы данных. Возможно зеркалирование устройств журнала, но RAID-Z не поддерживается. При записи на несколько устройств журнала нагрузка будут балансироваться между ними. -* [[zfs-term-vdev-cache]] _Кэш (Cache)_ - Добавление кэширующих vdev к пулу увеличит - хранилище кэша в crossref:zfs[zfs-term-l2arc,L2ARC]. Зеркалирование устройств кэша невозможно. Поскольку устройство кэша хранит только новые копии существующих данных, риск потери данных отсутствует. ++ +Увеличение raidz-виртуального устройства (vdev) по одному диску за раз возможно с помощью crossref:zfs[zfs-zpool-raidz-expansion,расширения RAID-Z], которое требует OpenZFS 2.3 или новее, впервые доступной в FreeBSD 15.0. +* [[zfs-term-vdev-draid]] _dRAID_ — вариант RAID-Z, который распределяет данные, четность и резервную ёмкость по всем дискам-членам с использованием полос фиксированной ширины. Вместо выделенных горячих запасных дисков dRAID предоставляет _распределённые запасные_: резервную ёмкость, распределённую по каждому диску-члену, что позволяет отказавшему диску восстановиться последовательно на все остальные диски одновременно и восстановить избыточность намного быстрее, чем при традиционном восстановлении на один запасной диск. Задайте dRAID-виртуальное устройство как `draid[parity][:datad][:childrenc][:sparess]`, как описано в man:zpoolconcepts[7]. Подробнее см. crossref:zfs[zfs-zpool-draid,«Пулы dRAID»]. +* [[zfs-term-vdev-spare]] _Резервный (Spare)_ - ZFS имеет специальный псевдо-vdev для отслеживания доступных горячих резервов. Когда man:zfsd[8] включён, ZFS автоматически задействует установленные горячие запасные диски для замены отказавших устройств; в противном случае настройте их вручную для замены отказавшего устройства с помощью `zpool replace`. Подробнее см. crossref:zfs[zfs-zpool-spares,«Горячие запасные диски и автоматическая замена с zfsd»]. +* [[zfs-term-vdev-log]] _Журнал_ — каждый пул имеет журнал намерений ZFS (crossref:zfs[zfs-term-zil,ZIL]), который по умолчанию хранится на обычных устройствах пула. Выделенное журнальное виртуальное устройство (часто называемое SLOG) перемещает журнал намерений на отдельное устройство, обычно SSD. Наличие выделенного журнального устройства повышает производительность приложений с большим объёмом синхронных записей, например баз данных. Зеркалирование журнальных устройств возможно, но RAID-Z не поддерживается. При использовании большого количества журнальных устройств запись распределяется между ними. Подробнее см. crossref:zfs[zfs-advanced-zil-slog,"Синхронные записи, ZIL и SLOG"]. +* [[zfs-term-vdev-cache]] _Кэш (Cache)_ - Добавление кэширующих vdev к пулу увеличит хранилище кэша в crossref:zfs[zfs-term-l2arc,L2ARC]. Зеркалирование устройств кэша невозможно. Поскольку устройство кэша хранит только новые копии существующих данных, риск потери данных отсутствует. +* [[zfs-term-vdev-special]] _Специальное/Дедупликационное_ — виртуальные устройства классов распределения, которые хранят метаданные пула, опционально блоки небольших файлов (управляется свойством набора данных `special_small_blocks`) и таблицы дедупликации на быстрых устройствах, таких как SSD, ускоряя пул с более медленными дисками. Эти виртуальные устройства являются критичными для пула: потеря специального или дедупликационного виртуального устройства приводит к потере пула, поэтому обеспечьте им тот же уровень избыточности, что и для виртуальных устройств с данными. Подробнее см. crossref:zfs[zfs-zpool-special,«Классы специального распределения»]. |[[zfs-term-txg]] Группы транзакций (TXG) |Группы транзакций — это способ, которым ZFS объединяет изменения блоков и записывает их в пул. Группы транзакций являются атомарной единицей, используемой ZFS для обеспечения согласованности. ZFS назначает каждой группе транзакций уникальный 64-битный последовательный идентификатор. Одновременно может быть до трёх активных групп транзакций, каждая в одном из следующих состояний: * _Открытое (Open)_ — Новая группа транзакций начинается в открытом состоянии и принимает новые операции записи. Всегда существует группа транзакций в открытом состоянии, но она может отказать в приёме новых записей, если достигнут лимит. Как только открытая группа транзакций достигает -лимита или срабатывает crossref:zfs[zfs-advanced-tuning-txg-timeout,`vfs.zfs.txg.timeout`], группа переходит в следующее состояние. +лимита или срабатывает crossref:zfs[zfs-advanced-tuning,`vfs.zfs.txg.timeout`], группа переходит в следующее состояние. * _Завершающееся (Quiescing)_ — Краткое состояние, позволяющее завершить все ожидающие операции без блокировки создания новой открытой группы транзакций. Как только все транзакции в группе завершены, группа переходит в финальное состояние. * _Синхронизируемое (Syncing)_ — Запись всех данных группы транзакций в устойчивое хранилище. Этот процесс, в свою очередь, изменяет другие данные, такие как метаданные и карты пространства, которые ZFS также записывает в устойчивое хранилище. Процесс синхронизации включает несколько проходов. На первом и самом большом записываются все изменённые блоки данных; затем идут метаданные, которые могут потребовать нескольких проходов. Поскольку выделение пространства для блоков данных генерирует новые метаданные, состояние синхронизации не может завершиться, пока не будет выполнен проход, не использующий новое пространство. В состоянии синхронизации также завершаются _синхронизационные задачи_. Синхронизационные задачи — это административные операции, такие как создание или удаление снимков и наборов данных, завершающие изменение uberblock. Как только состояние синхронизации завершается, группа транзакций в Завершающемся состоянии переходит в Синхронизируемое. Все административные функции, такие как crossref:zfs[zfs-term-snapshot,`снимок`], записываются как часть группы транзакций. ZFS добавляет созданную синхронизационную задачу в открытую группу транзакций, и эта группа как можно быстрее переходит в синхронизируемое состояние, чтобы уменьшить задержку административных команд. |[[zfs-term-arc]]Adaptive Replacement Cache (ARC) |ZFS использует Adaptive Replacement Cache (ARC), а не более традиционный кэш Least Recently Used (LRU). LRU-кэш — это простой список элементов в кэше, отсортированный по времени последнего использования объекта, при этом новые элементы добавляются в начало списка. Когда кэш заполнен, освобождение места для более активных объектов происходит за счёт удаления элементов из конца списка. ARC состоит из четырёх списков: Most Recently Used (MRU) и Most Frequently Used (MFU), а также дополнительных "теневых" списков для каждого из них. Эти теневые списки отслеживают удалённые объекты, чтобы предотвратить их повторное добавление в кэш. Это увеличивает процент попаданий в кэш, исключая объекты, которые использовались лишь изредка. Ещё одно преимущество использования как MRU, так и MFU заключается в том, что сканирование всей файловой системы вытеснило бы все данные из MRU- или LRU-кэша в пользу только что прочитанного содержимого. В ZFS также присутствует MFU, который отслеживает наиболее часто используемые объекты, и кэш наиболее часто запрашиваемых блоков остаётся неизменным. |[[zfs-term-l2arc]]L2ARC |L2ARC — это второй уровень системы кэширования ZFS. Основной кэш (ARC) хранится в оперативной памяти. Поскольку объём доступной оперативной памяти часто ограничен, ZFS также может использовать crossref:zfs[zfs-term-vdev-cache,кэширующие vdev]. Твердотельные накопители (SSD) часто используются в качестве таких кэширующих устройств благодаря их более высокой скорости и меньшей задержке по сравнению -с традиционными жёсткими дисками. L2ARC полностью опционален, но его наличие увеличит скорость чтения +с традиционными жёсткими дисками. +L2ARC полностью опционален, но его наличие увеличит скорость чтения для кэшированных файлов на SSD, избавляя от необходимости читать с обычных дисков. -L2ARC также может ускорить crossref:zfs[zfs-term-deduplication,дедупликацию], поскольку таблица дедупликации (DDT), +L2ARC также может ускорить crossref:zfs[zfs-term-deduplication,дедупликацию], поскольку таблица дедупликации (DDT - deduplication table), которая не помещается в оперативную память, но помещается в L2ARC, будет работать значительно быстрее, -чем DDT, которую должны считать с диска. Ограничения на скорость записи данных -на кэширующие устройства предотвращают преждевременный износ SSD -из-за дополнительных операций записи. Пока кэш не заполнен (первый блок вытеснен для освобождения места), -записи в L2ARC ограничиваются суммой лимита записи и лимита ускорения, -а после - только лимитом записи. Пара значений man:sysctl[8] управляет этими ограничениями скорости. -crossref:zfs[zfs-advanced-tuning-l2arc_write_max,`vfs.zfs.l2arc_write_max`] контролирует количество байт, -записываемых в кэш в секунду, а crossref:zfs[zfs-advanced-tuning-l2arc_write_boost,`vfs.zfs.l2arc_write_boost`] -добавляется к этому лимиту во время "Фазы турбо-разогрева" (Write Boost). +чем DDT, которую должны считать с диска. +Начиная с OpenZFS 2.0, L2ARC является постоянным: после перезагрузки ZFS восстанавливает содержимое кэша из заголовков, хранящихся на кэширующем устройстве, вместо того чтобы начинать с пустого кэша. +Ограничения на скорость записи данных +на кэширующие устройства предотвращают преждевременный износ SSD из-за дополнительных операций записи. Пока кэш не заполнен (первый блок вытеснен для освобождения места), +записи в L2ARC ограничиваются суммой лимита записи и лимита ускорения, а после - только лимитом записи. +Пара значений man:sysctl[8] управляет этими ограничениями скорости. `vfs.zfs.l2arc.write_max` контролирует количество байт, записываемых в кэш в секунду,а `vfs.zfs.l2arc.write_boost` добавляется к этому лимиту до первого вытеснения из кэша. Подробнее смотрите раздел crossref:zfs[zfs-advanced-tuning,Настройка]. |[[zfs-term-zil]]ZIL -|ZIL ускоряет синхронные транзакции, используя устройства хранения, такие как SSD, которые быстрее, чем устройства в основном пуле хранения. Когда приложение запрашивает синхронную запись (гарантию того, что данные записаны на диск, а не просто кэшированы для последующей записи), запись данных в более быстрый ZIL с последующей выгрузкой на обычные диски значительно снижает задержки и повышает производительность. Синхронные нагрузки, такие как базы данных, выиграют от использования одного только ZIL. Обычные асинхронные операции записи, например, копирование файлов, вообще не используют ZIL. +|Журнал намерений ZFS (ZIL) — это запись на диске, которую ZFS использует для воспроизведения синхронных записей после сбоя. Каждый пул имеет ZIL; по умолчанию он занимает небольшой объём пространства на обычных устройствах пула. Когда приложение запрашивает синхронную запись (гарантию того, что данные сохранены на диске, а не просто закэшированы для последующей записи), ZFS сначала фиксирует данные в ZIL, а затем сбрасывает их в обычное хранилище со следующей группой транзакций. Перемещение ZIL на выделенное crossref:zfs[zfs-term-vdev-log,журнальное виртуальное устройство] (SLOG) на устройстве, более быстром, чем основное хранилище, например SSD, значительно снижает задержку и повышает производительность. Синхронные рабочие нагрузки, такие как базы данных, выиграют от одного только быстрого ZIL. Обычные асинхронные записи, например копирование файлов, вообще не используют ZIL. Подробнее см. crossref:zfs[zfs-advanced-zil-slog,"Синхронные записи, ZIL и SLOG"]. |[[zfs-term-cow]]Копирование при Записи (Copy-On-Write) |В отличие от традиционной файловой системы, ZFS записывает новый блок вместо перезаписи старых данных на том же месте. После завершения записи метаданные обновляются, указывая на новое местоположение. Если происходит обрыв записи (сбой системы или отключение питания во время записи файла), исходное содержимое файла остаётся доступным, а ZFS отменяет незавершённую запись. Это также означает, что ZFS не требует выполнения man:fsck[8] после неожиданного выключения. |[[zfs-term-dataset]]Набор данных (Dataset) |_Набор данных_ — это общий термин для файловой системы ZFS, тома, снимка или клона. Каждый набор данных имеет уникальное имя в формате _имяпула/путь@снимок_. Корень пула также является набором данных. Дочерние наборы данных имеют иерархические имена, подобные каталогам. Например, _mypool/home_, набор данных home, является дочерним для _mypool_ и наследует его свойства. Это можно расширить, создав _mypool/home/user_. Этот внучатый набор данных будет наследовать свойства от родительского и вышестоящего наборов данных. Установка свойств для дочернего набора данных позволяет переопределить значения по умолчанию, унаследованные от родительских наборов. Управление наборами данных и их дочерними элементами может быть crossref:zfs[zfs-zfs-allow,делегировано]. |[[zfs-term-filesystem]]Файловая система |Набор данных ZFS чаще всего используется как файловая система. Как и большинство других файловых систем, файловая система ZFS монтируется в определённое место иерархии каталогов системы и содержит собственные файлы и каталоги с правами доступа, флагами и другими метаданными. |[[zfs-term-volume]]Том |ZFS также может создавать тома, которые отображаются как дисковые устройства. Тома обладают многими функциями, аналогичными наборам данных, включая копирование при записи, снимки, клоны и контрольные суммы. Тома могут быть полезны для работы других файловых систем поверх ZFS, таких как виртуализация UFS или экспорт областей iSCSI. |[[zfs-term-snapshot]]Снимок (Snapshot) |Дизайн crossref:zfs[zfs-term-cow,copy-on-write] (COW) в ZFS позволяет создавать почти мгновенные, согласованные снимки с произвольными именами. После создания снимка набора данных или рекурсивного снимка родительского набора, который включит все дочерние наборы, новые данные записываются в новые блоки, но без освобождения старых блоков как свободного пространства. Снимок содержит исходную версию файловой системы, а активная файловая система — все изменения, сделанные после создания снимка, не используя дополнительного пространства. Новые данные, записанные в активную файловую систему, сохраняются в новых блоках. Снимок будет расти по мере того, как блоки перестают использоваться в активной файловой системе и остаются только в снимке. Монтирование этих снимков в режиме только для чтения позволяет восстановить предыдущие версии файлов. -crossref:zfs[zfs-zfs-snapshot,Откат] активной файловой системы к определённому +crossref:zfs[zfs-zfs-snapshot-rollback,Откат] активной файловой системы к определённому снимку возможен, отменяя все изменения, произошедшие после создания снимка. Каждый блок в пуле имеет счетчик ссылок, который отслеживает использование этого блока снимками, клонами, наборами данных или томами. По мере удаления файлов и снимков счетчик ссылок уменьшается, освобождая пространство, когда блок больше не используется. Если пометить снимки с помощью -crossref:zfs[zfs-zfs-snapshot,удержания (hold)], то это приведет к тому, что любая попытка удалить его вернет ошибку `EBUSY`. Каждый снимок может иметь удержания с уникальными именами. Команда crossref:zfs[zfs-zfs-snapshot,release] удаляет удержание, позволяя удалить снимок. Снимки, клонирование и откат работают с томами, но независимое монтирование — нет. +crossref:zfs[zfs-zfs-snapshot-hold,удержания (hold)], то это приведет к тому, что любая попытка удалить его вернет ошибку `EBUSY`. Каждый снимок может иметь удержания с уникальными именами. Команда crossref:zfs[zfs-zfs-snapshot-hold,release] удаляет удержание, позволяя удалить снимок. Снимки, клонирование и откат работают с томами, но независимое монтирование — нет. |[[zfs-term-clone]]Клон (Clone) |Также возможно клонирование снимка. Клон — это доступная для записи версия снимка, позволяющая файловой системе разветвляться как новый набор данных. Как и снимок, клон изначально не занимает дополнительного пространства. По мере записи новых данных в клон используются новые блоки, и размер клона увеличивается. При перезаписи блоков в клонированной файловой системе или томе счетчик ссылок на предыдущий блок уменьшается. Удалить снимок, на котором основан клон, невозможно, потому что клон зависит от него. Снимок является родителем, а клон — потомком. Клоны можно _повышать_, меняя эту зависимость местами, делая клон родителем, а предыдущего родителя — потомком. Эта операция не требует дополнительного пространства. Поскольку объём пространства, используемого родителем и потомком, меняется местами, это может повлиять на существующие квоты и резервирования. +|[[zfs-term-bookmark]]Bookmark +|Закладка фиксирует момент времени, в который был сделан снапшот, не сохраняя при этом никаких данных снапшота. +Закладки служат источником инкрементальных потоков crossref:zfs[zfs-zfs-send,`zfs send`], что позволяет уничтожить снапшот на отправляющей стороне, сохраняя возможность отправлять дальнейшие инкременты. +Создайте закладку из существующего снапшота с помощью `zfs bookmark`. +Подробности см. в crossref:zfs[zfs-zfs-bookmark,Закладки]. + +|[[zfs-term-hold]]Hold +|Удержание — это именованная метка, помещаемая на снимок, которая предотвращает его уничтожение. +Попытки уничтожить удерживаемый снимок завершаются с ошибкой `EBUSY`, пока не будут сняты все удержания с помощью `zfs release`. +Удержания защищают снимки, от которых всё ещё зависят инструменты резервного копирования и репликации. +Подробнее см. crossref:zfs[zfs-zfs-snapshot-hold,Удержания снимков]. + |[[zfs-term-checksum]]Контрольная сумма |Каждый блок также имеет контрольную сумму. Используемый алгоритм контрольной суммы является свойством для каждого набора данных, см. crossref:zfs[zfs-zfs-set,`set`]. Контрольная сумма каждого блока прозрачно проверяется при чтении, -что позволяет ZFS обнаруживать скрытые повреждения. Если прочитанные данные не соответствуют ожидаемой контрольной сумме, ZFS попытается восстановить данные из любого доступного резервирования, например, -зеркал или RAID-Z. Запуск проверки всех контрольных сумм выполняется с помощью crossref:zfs[zfs-term-scrub,`scrub`]. Доступные алгоритмы контрольных сумм включают: - +что позволяет ZFS обнаруживать скрытые повреждения. Если прочитанные данные не соответствуют +ожидаемой контрольной сумме, ZFS попытается восстановить данные из любого доступного резервирования, например, +зеркал или RAID-Z. Запуск проверки всех контрольных сумм выполняется с помощью crossref:zfs[zfs-term-scrub,`scrub`]. +Доступные алгоритмы контрольных сумм включают: * `fletcher2` * `fletcher4` * `sha256` +* `sha512` +* `skein` +* `edonr` +* `blake3` (since FreeBSD 14.0) -Алгоритмы `fletcher` работают быстрее, но `sha256` является криптографически стойким хешем и имеет гораздо меньшую вероятность коллизий ценой некоторого снижения производительности. Возможно отключение контрольных сумм, но это крайне не рекомендуется. +Алгоритмы `fletcher` работают быстрее, но криптографические хеши (`sha256`, `sha512`, `skein`, `edonr` и `blake3`) имеют значительно меньшую вероятность коллизий ценой некоторого снижения производительности. +Значение по умолчанию `on` в настоящее время выбирает `fletcher4`; crossref:zfs[zfs-term-deduplication,дедупликация] требует криптографического хеша, например `sha256`. +Возможно отключение контрольных сумм, но это крайне не рекомендуется. |[[zfs-term-compression]]Сжатие (compression) -|Каждый набор данных имеет свойство сжатия (compression), которое по умолчанию отключено. Установите это свойство в один из доступных алгоритмов сжатия. Это приведёт к сжатию всех новых данных, записываемых в набор данных. Помимо уменьшения используемого пространства, пропускная способность при чтении и записи часто увеличивается, поскольку требуется читать или записывать меньше блоков. +|Каждый набор данных имеет свойство сжатия (compression). Начиная с OpenZFS 2.2, для новых наборов данных сжатие включено по умолчанию (`compression=on`, что выбирает алгоритм LZ4). Установите это свойство в один из доступных алгоритмов сжатия. Это приведёт к сжатию всех новых данных, записываемых в набор данных. Помимо уменьшения используемого пространства, пропускная способность при чтении и записи часто увеличивается, поскольку требуется читать или записывать меньше блоков. [[zfs-term-compression-lz4]] -* _LZ4_ — добавлен в версии 5000 (флаги функций) пула ZFS и теперь является рекомендуемым алгоритмом сжатия. LZ4 работает примерно на 50% быстрее, чем LZJB, при работе с сжимаемыми данными и более чем в три раза быстрее при работе с несжимаемыми данными. LZ4 также распаковывает данные примерно на 80% быстрее, чем LZJB. На современных процессорах LZ4 часто может сжимать данные со скоростью более 500 МБ/с и распаковывать со скоростью более 1,5 ГБ/с (на одно ядро CPU). +* _LZ4_ — добавлен в версии 5000 (флаги функций) пула ZFS, LZ4 — это алгоритм, который выбирается параметром `compression=on`, и является рекомендуемым выбором для общего назначения. LZ4 работает примерно на 50% быстрее, чем LZJB, при работе с сжимаемыми данными и более чем в три раза быстрее при работе с несжимаемыми данными. LZ4 также распаковывает данные примерно на 80% быстрее, чем LZJB. На современных процессорах LZ4 часто может сжимать данные со скоростью более 500 МБ/с и распаковывать со скоростью более 1,5 ГБ/с (на одно ядро CPU). + +[[zfs-term-compression-zstd]] +* _ZSTD_ — Zstandard обеспечивает более высокую степень сжатия, чем LZ4, с настраиваемым компромиссом между скоростью и степенью сжатия, начиная от быстрых вариантов `zstd-fast` и заканчивая `zstd-19` для максимальной экономии места. Подробнее см. crossref:zfs[zfs-zfs-compression-zstd,«Сжатие Zstandard»]. [[zfs-term-compression-lzjb]] -* _LZJB_ — алгоритм сжатия по умолчанию. Создан Джеффом Бонвиком (одним из оригинальных создателей ZFS). LZJB обеспечивает хорошее сжатие с меньшей нагрузкой на CPU по сравнению с GZIP. В будущем алгоритм сжатия по умолчанию изменится на LZ4. +* _LZJB_ — устаревший алгоритм сжатия, создан Джеффом Бонвиком (одним из первоначальных создателей ZFS). LZJB обеспечивает хорошее сжатие с меньшей нагрузкой на CPU по сравнению с GZIP. LZ4 заменил его в качестве алгоритма по умолчанию, для новых наборов данных предпочитайте LZ4 или ZSTD. [[zfs-term-compression-gzip]] * _GZIP_ — популярный алгоритм потокового сжатия, доступный в ZFS. Одним из основных преимуществ использования GZIP является настраиваемый уровень сжатия. При установке свойства `compress` администратор может выбрать уровень сжатия от `gzip1` (минимальный уровень сжатия) до `gzip9` (максимальный уровень сжатия). Это позволяет администратору контролировать баланс между использованием CPU и экономией дискового пространства. [[zfs-term-compression-zle]] * _ZLE_ — Zero Length Encoding (кодирование нулевой длины) — это специальный алгоритм сжатия, который сжимает только непрерывные последовательности нулей. Этот алгоритм полезен, когда набор данных содержит большие блоки нулей. |[[zfs-term-copies]]Копии (copies) |Когда свойству `копии (copies)` присваивается значение больше 1, ZFS сохраняет копии каждого блока в crossref:zfs[zfs-term-filesystem,файловой системе] или crossref:zfs[zfs-term-volume,томе]. Установка этого свойства для важных наборов данных обеспечивает дополнительную избыточность, позволяющую восстановить блок, контрольная сумма которого не совпадает. В пулах без избыточности функция копирования является единственной формой избыточности. Функция копирования позволяет восстановиться после повреждения отдельного сектора или других незначительных повреждений, но не защищает пул от потери всего диска. + |[[zfs-term-deduplication]]Дедубликация (Deduplication) -|Контрольные суммы позволяют обнаруживать дублирующиеся блоки при записи данных. При дедупликации счетчик ссылок существующего идентичного блока увеличивается, что экономит место на диске. ZFS хранит таблицу дедупликации (DDT) в памяти для обнаружения дублирующихся блоков. Таблица содержит список уникальных контрольных сумм, расположение этих блоков и счетчик ссылок. При записи новых данных ZFS вычисляет контрольные суммы и сравнивает их со списком. При обнаружении совпадения используется существующий блок. Использование алгоритма контрольной суммы SHA256 с дедупликацией обеспечивает безопасное криптографическое хеширование. Дедупликация настраивается. Если `dedup` установлен в `on`, то совпадение контрольных сумм означает, что данные идентичны. Если `dedup` установлен в `verify`, ZFS выполняет побайтовую проверку данных, гарантируя их полное совпадение. Если данные не идентичны, ZFS зафиксирует коллизию хешей и сохранит два блока отдельно. Поскольку DDT должна хранить хеш каждого уникального блока, она потребляет значительный объём памяти. Общее правило — 5–6 ГБ оперативной памяти на 1 ТБ дедуплицированных данных. В ситуациях, когда невозможно иметь достаточно памяти для хранения всей DDT в оперативной памяти, производительность сильно снизится, так как DDT будет считываться с диска перед записью каждого нового блока. Дедупликация может использовать L2ARC для хранения DDT, что представляет собой компромисс между быстрой системной памятью и медленными дисками. Рекомендуется также рассмотреть использование сжатия, которое часто обеспечивает почти такую же экономию места без увеличения потребления памяти. +|Контрольные суммы позволяют обнаруживать дублирующиеся блоки при записи данных. При дедупликации счетчик ссылок существующего идентичного блока увеличивается, что экономит место на диске. ZFS хранит таблицу дедупликации (DDT) в памяти для обнаружения дублирующихся блоков. Таблица содержит список уникальных контрольных сумм, расположение этих блоков и счетчик ссылок. При записи новых данных ZFS вычисляет контрольные суммы и сравнивает их со списком. При обнаружении совпадения используется существующий блок. Использование алгоритма контрольной суммы SHA256 с дедупликацией обеспечивает безопасное криптографическое хеширование. Дедупликация настраивается. Если `dedup` установлен в `on`, то совпадение контрольных сумм означает, что данные идентичны. Если `dedup` установлен в `verify`, ZFS выполняет побайтовую проверку данных, гарантируя их полное совпадение. Если данные не идентичны, ZFS зафиксирует коллизию хешей и сохранит два блока отдельно. Поскольку DDT должна хранить хеш каждого уникального блока, она потребляет значительный объём памяти. Общее правило — 5–6 ГБ оперативной памяти на 1 ТБ дедуплицированных данных. В ситуациях, когда невозможно иметь достаточно памяти для хранения всей DDT в оперативной памяти, производительность сильно снизится, так как DDT будет считываться с диска перед записью каждого нового блока. Дедупликация может использовать L2ARC для хранения DDT, что представляет собой компромисс между быстрой системной памятью и медленными дисками. +Рекомендуется также рассмотреть использование сжатия, которое часто обеспечивает почти такую же экономию места без увеличения потребления памяти. +_Быстрая дедупликация_ (fast dedup) группирует обновления DDT в журнале, позволяет удалять устаревшие записи с помощью `zpool ddtprune` и ограничивает размер таблицы свойством пула `dedup_table_quota`; для неё требуется OpenZFS 2.3 или новее, впервые доступная в FreeBSD 15.0. Подробнее см. crossref:zfs[zfs-zfs-deduplication,«Дедупликация»]. + +|[[zfs-term-block-cloning]]Block Cloning +|Блочное клонирование позволяет копии файла ссылаться на блоки исходного файла, существующие на диске, вместо их дублирования, поэтому копия выполняется почти мгновенно и не занимает дополнительное место, пока ни один из файлов не изменится. +На FreeBSD man:cp[1] использует man:copy_file_range[2], поэтому обычные копии файлов становятся блочными клонами, когда эта функция включена (по умолчанию в FreeBSD 15.0). +Свойства пула `bcloneused`, `bclonesaved` и `bcloneratio` сообщают о полученной экономии места. +Подробности см. в crossref:zfs[zfs-zfs-block-cloning,Блочное клонирование]. |[[zfs-term-scrub]]Scrub |Вместо проверки согласованности, такой как man:fsck[8], в ZFS используется `scrub`. `scrub` читает все блоки данных в пуле и проверяет их контрольные суммы по сравнению с известными корректными контрольными суммами, хранящимися в метаданных. Периодическая проверка всех данных в пуле гарантирует восстановление повреждённых блоков до того, как они понадобятся. Проведение `scrub` не требуется после некорректного завершения работы, -но рекомендуется выполнять её хотя бы раз в три месяца. ZFS проверяет контрольные суммы каждого блока +но рекомендуется выполнять её хотя бы раз в месяц. ZFS проверяет контрольные суммы каждого блока при обычном использовании, но `scrub` обеспечивает проверку даже редко используемых блоков на тихую порчу данных. ZFS повышает безопасность данных в архивных системах хранения. -Настройте относительный приоритет `scrub` с помощью crossref:zfs[zfs-advanced-tuning-scrub_delay,`vfs.zfs.scrub_delay`], -чтобы предотвратить снижение производительности других задач в пуле из-за проверки. +Приостановите выполняющуюся проверку (scrub) с помощью `zpool scrub -p` и возобновите её позже, +снова запустив `zpool scrub`. Подробнее см. crossref:zfs[zfs-zpool-scrub,«Проверка пула»]. + +|[[zfs-term-checkpoint]]Checkpoint +|Контрольная точка сохраняет полное состояние пула в единый момент времени, включая изменения конфигурации всего пула, которые снимки не могут зафиксировать. +Возврат к контрольной точке с помощью `zpool import --rewind-to-checkpoint` отменяет всё, что произошло после её создания, например, включение функций пула, добавление или удаление vdev, или уничтожение наборов данных. +Пул может иметь не более одной контрольной точки одновременно. +Подробности см. в crossref:zfs[zfs-zpool-checkpoint,Контрольные точки пула]. + +|[[zfs-term-trim]]TRIM +|TRIM уведомляет SSD и другие накопители на флеш-памяти о блоках, которые пул больше не использует, позволяя устройству заранее стирать их и поддерживать производительность записи. +Запустите `zpool trim` вручную или установите свойство пула `autotrim` в значение `on`, чтобы непрерывно выполнять TRIM для освобожденного пространства. +Подробности см. в crossref:zfs[zfs-zpool-trim,TRIM и инициализация]. |[[zfs-term-quota]]Квота набора данных a|ZFS обеспечивает быстрый и точный учёт пространства для наборов данных, пользователей и групп, а также квоты и резервирование пространства. Это даёт администратору детальный контроль над распределением пространства и позволяет резервировать место для критически важных файловых систем. ZFS поддерживает различные типы квот: квоту набора данных, crossref:zfs[zfs-term-refquota,референтную квоту (refquota)], crossref:zfs[zfs-term-userquota,пользовательскую квоту] и crossref:zfs[zfs-term-groupquota,групповую квоту]. Квоты ограничивают общий размер набора данных и его потомков, включая снимки набора данных, дочерние наборы данных и снимки этих наборов данных. [NOTE] ==== Тома не поддерживают квоты, так как свойство `volsize` действует как неявная квота. ==== |[[zfs-term-refquota]]Квота ссылки |Референтная квота ограничивает объём пространства, который может занимать набор данных, устанавливая жёсткий лимит. Этот жёсткий лимит включает только пространство, на которое ссылается сам набор данных, и не учитывает пространство, используемое его потомками, такими как файловые системы или снимки. |[[zfs-term-userquota]]Квота пользователя |Пользовательские квоты полезны для ограничения объёма пространства, используемого указанным пользователем. |[[zfs-term-groupquota]]Квота группы |Квота группы ограничивает объём пространства, который может использовать указанная группа. |[[zfs-term-reservation]]Резервирование для набора данных |Свойство `reservation` позволяет гарантировать определённый объём пространства для конкретного набора данных и его потомков. Это означает, что установка резерва в 10 ГБ для [.filename]#storage/home/bob# предотвращает использование всего свободного пространства другими наборами данных, резервируя как минимум 10 ГБ для этого набора. -В отличие от обычного `reservation`, при crossref:zfs[zfs-term-refreservation,`refreservation`] пространство, используемое снимками и потомками, -не учитывается в резерве. Например, при создании снимка [.filename]#storage/home/bob# для успешного выполнения операции должно быть достаточно дискового пространства, помимо объёма `refreservation`. -Потомки основного набора данных не учитываются в объёме `refreservation` и, следовательно, не занимают зарезервированное пространство. - -Резервирование любого типа полезно в таких ситуациях, как планирование и тестирование распределения дискового пространства в новой системе, или для обеспечения достаточного места в файловых системах для аудио-логов, процедур восстановления системы и файлов. +В отличие от обычного `reservation`, при crossref:zfs[zfs-term-refreservation,`refreservation`] пространство, +используемое снимками и потомками наборов данных, +не учитывается в резерве. +Резервирование любого типа полезно в таких ситуациях, как планирование и тестирование распределения +дискового пространства в новой системе, или для обеспечения достаточного места в файловых системах для аудио-логов, процедур восстановления системы и файлов. |[[zfs-term-refreservation]]Референтное резервирование |Свойство `refreservation` позволяет гарантировать определённый объём пространства для использования конкретным набором данных _исключая_ его потомков. Это означает, что если установить резервирование в 10 ГБ для [.filename]#storage/home/bob#, а другой набор данных попытается использовать свободное пространство, то он оставит как минимум 10 ГБ, зарезервированных для [.filename]#storage/home/bob#. В отличие от обычного crossref:zfs[zfs-term-reservation,резервирования], пространство, используемое снимками и наборами-потомками, не учитывается в резервировании. Например, при создании снимка [.filename]#storage/home/bob# для успешного выполнения операции должно быть достаточно места на диске помимо объёма, указанного в `refreservation`. Наборы данных-потомки не учитываются в объёме `refreservation` и, следовательно, не уменьшают зарезервированное пространство. +|[[zfs-term-boot-environment]]Boot Environment +|Загрузочное окружение — это загрузочная копия наборов данных, содержащих систему FreeBSD, управляемая с помощью man:bectl[8]. +Создание загрузочного окружения перед обновлением системы позволяет загрузить предыдущую, заведомо рабочую систему из меню загрузчика, если обновление вызовет проблемы. +Подробности см. в crossref:zfs[zfs-boot-environments,Загрузочные окружения]. + |[[zfs-term-resilver]]Ресильверинг -|При замене вышедшего из строя диска ZFS необходимо заполнить новый диск утерянными данными. _Ресильверинг_ (resilvering — серебрение, восстановление зеркала) — это процесс использования информации о чётности, распределенной по оставшимся дискам, для вычисления и записи отсутствующих данных на новый диск. +|При замене вышедшего из строя диска ZFS должен заполнить новый диск утерянными данными. +_Ресилверинг_ — это процесс записи этих данных на заменяющее устройство: зеркала выполняют ресилверинг путём копирования данных с выживших участников, а RAID-Z восстанавливает их из информации о чётности, распределённой по оставшимся дискам. +В отличие от традиционной перестройки RAID, ресилверинг копирует только выделенные данные, а не каждый сектор устройства. +_Последовательный ресилверинг_ (`zpool attach -s` или `zpool replace -s`) перестраивает зеркальные и dRAID vdev-ы ещё быстрее, копируя блоки в порядке диска, пропуская проверку контрольных сумм и откладывая её на автоматически запланированную проверку (scrab). +Подробности см. в crossref:zfs[zfs-zpool-resilver,Dealing with Failed Devices]. + |[[zfs-term-online]]Online -|Пул или vdev в состоянии `Online` имеет подключенные и полностью работоспособные устройства-участники. Отдельные устройства в состоянии `Online` функционируют. +|Пул или vdev в состоянии `Online` имеет подключённые и полностью работоспособные устройства-участники. Отдельные устройства в состоянии `Online` функционируют. |[[zfs-term-offline]]Offline |Администратор переводит отдельные устройства в состояние `Offline`, если существует достаточная избыточность, чтобы избежать перевода пула или vdev в состояние crossref:zfs[zfs-term-faulted,Faulted]. Администратор может отключить диск для подготовки к его замене или для упрощения идентификации. |[[zfs-term-degraded]]Degraded |Пул или vdev в состоянии `Degraded` имеет один или несколько дисков, которые исчезли или вышли из строя. Пул по-прежнему можно использовать, но если другие устройства выйдут из строя, пул может стать невосстановимым. Повторное подключение отсутствующих устройств или замена неисправных дисков вернет пул в состояние crossref:zfs[zfs-term-online,Online] после того, -как повторно подключенное или новое устройство завершит процесс crossref:zfs[zfs-term-resilver,ресильверинга]. +как повторно подключённое или новое устройство завершит процесс crossref:zfs[zfs-term-resilver,ресильверинга]. |[[zfs-term-faulted]]Faulted |Пул или vdev в состоянии `Faulted` больше не функционирует. Доступ к данным становится невозможным. Пул или vdev переходит в состояние `Faulted`, когда количество отсутствующих или неисправных устройств превышает уровень избыточности vdev. Если отсутствующие устройства будут снова подключены, пул вернётся в состояние crossref:zfs[zfs-term-online,Online]. Недостаточная избыточность для компенсации количества неисправных дисков приводит к потере содержимого пула и требует восстановления из резервных копий. + +|[[zfs-term-unavail]]Unavail +|Устройство в состоянии `Unavail` не может быть открыто, поскольку оно отсутствует или недоступно. +Пул продолжает работать, если имеется достаточная избыточность для компенсации, функционируя в crossref:zfs[zfs-term-degraded,состоянии Degraded (деградировавшем)]. +Если вышестоящий vdev находится в состоянии `Unavail`, доступ к содержимому пула невозможен. + +|[[zfs-term-removed]]Removed +|Устройство в состоянии `Removed` было физически отсоединено во время работы системы. +Обнаружение удаления устройства зависит от аппаратного обеспечения и не поддерживается на некоторых платформах. +Когда устройство переподключается, man:zfsd[8] возвращает его в онлайн; если устройство не возвращается, zfsd активирует доступный горячий резерв вместо него. |=== + diff --git a/documentation/content/ru/books/handbook/zfs/_index.po b/documentation/content/ru/books/handbook/zfs/_index.po index e701a18c59..ad354897a8 100644 --- a/documentation/content/ru/books/handbook/zfs/_index.po +++ b/documentation/content/ru/books/handbook/zfs/_index.po @@ -1,7419 +1,12818 @@ # SOME DESCRIPTIVE TITLE # Copyright (C) YEAR The FreeBSD Project # This file is distributed under the same license as the FreeBSD Documentation package. # Vladlen Popolitov , 2025, 2026. msgid "" msgstr "" "Project-Id-Version: FreeBSD Documentation VERSION\n" -"POT-Creation-Date: 2026-05-09 23:29+0100\n" -"PO-Revision-Date: 2026-05-11 04:45+0000\n" +"POT-Creation-Date: 2026-08-06 22:55+0100\n" +"PO-Revision-Date: 2026-08-10 04:45+0000\n" "Last-Translator: Vladlen Popolitov \n" "Language-Team: Russian \n" "Language: ru\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" "Content-Transfer-Encoding: 8bit\n" "Plural-Forms: nplurals=3; plural=n%10==1 && n%100!=11 ? 0 : n%10>=2 && " "n%10<=4 && (n%100<10 || n%100>=20) ? 1 : 2;\n" "X-Generator: Weblate 4.17\n" #. type: YAML Front Matter: description #: documentation/content/en/books/handbook/zfs/_index.adoc:1 #, no-wrap msgid "ZFS is an advanced file system designed to solve major problems found in previous storage subsystem software" msgstr "ZFS — это продвинутая файловая система, разработанная для решения основных проблем, присущих предыдущему программному обеспечению подсистем хранения данных" #. type: YAML Front Matter: part #: documentation/content/en/books/handbook/zfs/_index.adoc:1 #, no-wrap msgid "Part III. System Administration" msgstr "Часть III. Администрирование системы" #. type: YAML Front Matter: title #: documentation/content/en/books/handbook/zfs/_index.adoc:1 #, no-wrap -msgid "Chapter 22. The Z File System (ZFS)" -msgstr "Глава 22. Файловая система Z (ZFS)" +msgid "Chapter 23. The Z File System (ZFS)" +msgstr "Глава 23. Файловая система Z (ZFS)" #. type: Title = #: documentation/content/en/books/handbook/zfs/_index.adoc:15 #, no-wrap msgid "The Z File System (ZFS)" msgstr "Файловая система Z (ZFS)" #. type: Plain text -#: documentation/content/en/books/handbook/zfs/_index.adoc:53 +#: documentation/content/en/books/handbook/zfs/_index.adoc:52 msgid "" "ZFS is an advanced file system designed to solve major problems found in " "previous storage subsystem software." msgstr "" "ZFS — это продвинутая файловая система, разработанная для решения основных " "проблем, присущих предыдущему программному обеспечению подсистем хранения " "данных." #. type: Plain text -#: documentation/content/en/books/handbook/zfs/_index.adoc:55 +#: documentation/content/en/books/handbook/zfs/_index.adoc:54 msgid "" -"Originally developed at Sun(TM), ongoing open source ZFS development has " -"moved to the http://open-zfs.org[OpenZFS Project]." +"Originally developed at Sun Microsystems(TM), ongoing open source ZFS " +"development has moved to the https://openzfs.org[OpenZFS Project]." msgstr "" -"Первоначально разработанная в Sun(TM), дальнейшая разработка открытой версии " -"ZFS переместилась в http://open-zfs.org[проект OpenZFS]." +"Первоначально разработанная в Sun Microsystems(TM), дальнейшая разработка " +"открытой версии ZFS переместилась в https://openzfs.org[проект OpenZFS]." #. type: Plain text -#: documentation/content/en/books/handbook/zfs/_index.adoc:57 +#: documentation/content/en/books/handbook/zfs/_index.adoc:56 msgid "ZFS has three major design goals:" msgstr "ZFS имеет три основные цели проектирования:" #. type: Plain text -#: documentation/content/en/books/handbook/zfs/_index.adoc:59 +#: documentation/content/en/books/handbook/zfs/_index.adoc:58 msgid "" "Data integrity: All data includes a crossref:zfs[zfs-term-checksum,checksum] " "of the data. ZFS calculates checksums and writes them along with the data. " "When reading that data later, ZFS recalculates the checksums. If the " "checksums do not match, meaning detecting one or more data errors, ZFS will " "attempt to automatically correct errors when ditto-, mirror-, or parity-" "blocks are available." msgstr "" "Целостность данных: Все данные включают crossref:zfs[zfs-term-checksum," "контрольную сумму]. ZFS вычисляет контрольные суммы и записывает их вместе с " "данными. При последующем чтении этих данных ZFS пересчитывает контрольные " "суммы. Если контрольные суммы не совпадают, что означает обнаружение одной " "или нескольких ошибок данных, ZFS попытается автоматически исправить ошибки, " "если доступны двойные-, зеркальные- или блоки чётности." #. type: Plain text -#: documentation/content/en/books/handbook/zfs/_index.adoc:60 +#: documentation/content/en/books/handbook/zfs/_index.adoc:59 msgid "" "Pooled storage: adding physical storage devices to a pool, and allocating " "storage space from that shared pool. Space is available to all file systems " "and volumes, and increases by adding new storage devices to the pool." msgstr "" "Объединенное хранилище: добавление физических устройств хранения в пул и " "выделение пространства из этого общего пула. Пространство доступно для всех " "файловых систем и томов и увеличивается за счет добавления новых устройств " "хранения в пул." #. type: Plain text -#: documentation/content/en/books/handbook/zfs/_index.adoc:65 +#: documentation/content/en/books/handbook/zfs/_index.adoc:62 msgid "" "Performance: caching mechanisms provide increased performance. crossref:" -"zfs[zfs-term-arc,ARC] is an advanced memory-based read cache. ZFS provides a " -"second level disk-based read cache with crossref:zfs[zfs-term-l2arc,L2ARC], " -"and a disk-based synchronous write cache named crossref:zfs[zfs-term-zil," -"ZIL]." +"zfs[zfs-term-arc,ARC] is an advanced memory-based read cache. ZFS provides " +"a second level disk-based read cache with crossref:zfs[zfs-term-l2arc," +"L2ARC], and a disk-based synchronous write cache named crossref:zfs[zfs-term-" +"zil,ZIL]." msgstr "" "Производительность: механизмы кэширования обеспечивают повышенную " "производительность. crossref:zfs[zfs-term-arc,ARC] — это продвинутый кэш " "для чтения, основанный на оперативной памяти. ZFS предоставляет второй " -"уровень кэша для чтения на основе диска — crossref:zfs[zfs-term-l2arc," -"L2ARC], а также кэш для синхронной записи на основе диска под названием " +"уровень кэша для чтения на основе диска — crossref:zfs[zfs-term-l2arc,L2ARC]" +", а также кэш для синхронной записи на основе диска под названием " "crossref:zfs[zfs-term-zil,ZIL]." #. type: Plain text -#: documentation/content/en/books/handbook/zfs/_index.adoc:67 +#: documentation/content/en/books/handbook/zfs/_index.adoc:64 msgid "" "A complete list of features and terminology is in crossref:zfs[zfs-term, ZFS " "Features and Terminology]." msgstr "" -"Полный список возможностей и терминологии приведен в crossref:zfs[zfs-term, " +"Полный список возможностей и терминологии приведён в crossref:zfs[zfs-term, " "Особенности и терминология ZFS]." #. type: Title == -#: documentation/content/en/books/handbook/zfs/_index.adoc:69 +#: documentation/content/en/books/handbook/zfs/_index.adoc:66 #, no-wrap msgid "What Makes ZFS Different" msgstr "Что отличает ZFS от других" #. type: Plain text -#: documentation/content/en/books/handbook/zfs/_index.adoc:82 +#: documentation/content/en/books/handbook/zfs/_index.adoc:80 msgid "" "More than a file system, ZFS is fundamentally different from traditional " "file systems. Combining the traditionally separate roles of volume manager " "and file system provides ZFS with unique advantages. The file system is now " "aware of the underlying structure of the disks. Traditional file systems " -"could exist on a single disk alone at a time. If there were two disks then " +"could exist on a single disk at a time. If there were two disks then " "creating two separate file systems was necessary. A traditional hardware " "RAID configuration avoided this problem by presenting the operating system " "with a single logical disk made up of the space provided by physical disks " "on top of which the operating system placed a file system. Even with " "software RAID solutions like those provided by GEOM, the UFS file system " -"living on top of the RAID believes it's dealing with a single device. ZFS' " +"living on top of the RAID believes it is dealing with a single device. ZFS' " "combination of the volume manager and the file system solves this and allows " "the creation of file systems that all share a pool of available storage. " "One big advantage of ZFS' awareness of the physical disk layout is that " "existing file systems grow automatically when adding extra disks to the " "pool. This new space then becomes available to the file systems. ZFS can " -"also apply different properties to each file system. This makes it useful to " -"create separate file systems and datasets instead of a single monolithic " +"also apply different properties to each file system. This makes it useful " +"to create separate file systems and datasets instead of a single monolithic " "file system." msgstr "" "ZFS — это не просто файловая система, она принципиально отличается от " -"традиционных файловых систем. Объединение традиционно разделенных ролей " +"традиционных файловых систем. Объединение традиционно разделённых ролей " "менеджера томов и файловой системы даёт ZFS уникальные преимущества. Теперь " "файловая система осведомлена о структуре нижележащих дисков. Традиционные " "файловые системы могли существовать только на одном диске. Если было два " "диска, приходилось создавать две отдельные файловые системы. Традиционная " "конфигурация аппаратного RAID решала эту проблему, предоставляя операционной " "системе один логический диск, состоящий из пространства физических дисков, " "поверх которого операционная система размещала файловую систему. Даже в " "программных решениях RAID, таких как предоставляемые GEOM, файловая система " "UFS, находящаяся поверх RAID, считает, что работает с одним устройством. " "Комбинация менеджера томов и файловой системы в ZFS решает эту проблему и " "позволяет создавать файловые системы, которые совместно используют общий пул " "доступного хранилища. Одно из больших преимуществ осведомленности ZFS о " "физической структуре дисков заключается в том, что существующие файловые " "системы автоматически расширяются при добавлении дополнительных дисков в " "пул. Это новое пространство становится доступным для файловых систем. ZFS " "также может применять разные свойства к каждой файловой системе. Это делает " "полезным создание отдельных файловых систем и наборов данных вместо единой " "монолитной файловой системы." #. type: Title == -#: documentation/content/en/books/handbook/zfs/_index.adoc:84 +#: documentation/content/en/books/handbook/zfs/_index.adoc:82 #, no-wrap msgid "Quick Start Guide" msgstr "Краткое руководство по началу работы" #. type: Plain text -#: documentation/content/en/books/handbook/zfs/_index.adoc:88 +#: documentation/content/en/books/handbook/zfs/_index.adoc:86 +msgid "" +"The FreeBSD installer can install the system directly onto a ZFS pool, a " +"configuration known as Root-on-ZFS; see crossref:bsdinstall[bsdinstall-part-" +"zfs,Guided Root-on-ZFS]. This section shows how to create and manage " +"additional ZFS pools and datasets on a running system." +msgstr "" +"Установщик FreeBSD может установить систему непосредственно в пул ZFS, " +"конфигурация, известная как Root-on-ZFS; см. crossref:bsdinstall[bsdinstall-" +"part-zfs,Разметка диска с использованием Root-on-ZFS с помощью мастера]. В " +"этом разделе показано, как создавать и управлять дополнительными пулами ZFS " +"и наборами данных на работающей системе." + +#. type: Plain text +#: documentation/content/en/books/handbook/zfs/_index.adoc:89 msgid "" "FreeBSD can mount ZFS pools and datasets during system initialization. To " "enable it, run:" msgstr "" "FreeBSD может монтировать пулы и наборы данных ZFS во время инициализации " "системы. Чтобы включить эту функцию, запустите:" #. type: delimited block . 4 -#: documentation/content/en/books/handbook/zfs/_index.adoc:92 +#: documentation/content/en/books/handbook/zfs/_index.adoc:93 #, no-wrap -msgid "# service zfs enable\n" -msgstr "# service zfs enable\n" +msgid "# sysrc zfs_enable=\"YES\"\n" +msgstr "# sysrc zfs_enable=\"YES\"\n" #. type: Plain text -#: documentation/content/en/books/handbook/zfs/_index.adoc:95 -msgid "or add this line to [.filename]#/etc/rc.conf#:" -msgstr "или добавьте эту строку в [.filename]#/etc/rc.conf#:" - -#. type: delimited block . 4 -#: documentation/content/en/books/handbook/zfs/_index.adoc:99 -#, no-wrap -msgid "zfs_enable=\"YES\"\n" -msgstr "zfs_enable=\"YES\"\n" +#: documentation/content/en/books/handbook/zfs/_index.adoc:97 +msgid "" +"This adds `zfs_enable=\"YES\"` to [.filename]#/etc/rc.conf#. Running " +"`service zfs enable` makes the same change." +msgstr "" +"Это добавляет `zfs_enable=\"YES\"` в [.filename]#/etc/rc.conf#. Выполнение `" +"service zfs enable` вносит то же изменение." #. type: Plain text -#: documentation/content/en/books/handbook/zfs/_index.adoc:102 +#: documentation/content/en/books/handbook/zfs/_index.adoc:99 msgid "Then start the service:" msgstr "Затем запустите службу:" #. type: delimited block . 4 -#: documentation/content/en/books/handbook/zfs/_index.adoc:106 +#: documentation/content/en/books/handbook/zfs/_index.adoc:103 #, no-wrap msgid "# service zfs start\n" msgstr "# service zfs start\n" #. type: Plain text -#: documentation/content/en/books/handbook/zfs/_index.adoc:110 +#: documentation/content/en/books/handbook/zfs/_index.adoc:107 msgid "" -"The examples in this section assume three SCSI disks with the device names [." -"filename]#da0#, [.filename]#da1#, and [.filename]#da2#. Users of SATA " -"hardware should instead use [.filename]#ada# device names." +"The examples in this section assume three SATA disks with the device names [." +"filename]#ada0#, [.filename]#ada1#, and [.filename]#ada2#. Users of SCSI/" +"SAS hardware should instead use [.filename]#da# device names, and users of " +"NVMe storage [.filename]#nda# device names." msgstr "" -"Примеры в этом разделе предполагают использование трёх SCSI-дисков с именами " -"устройств [.filename]#da0#, [.filename]#da1# и [.filename]#da2#. " -"Пользователям оборудования SATA следует использовать имена устройств [." -"filename]#ada#." +"Примеры в этом разделе предполагают использование трёх SATA-дисков с именами " +"устройств [.filename]#ada0#, [.filename]#ada1# и [.filename]#ada2#. " +"Пользователям оборудования SCSI/SAS следует использовать имена устройств [." +"filename]#da#, пользователям оборудования NVMe — имена устройств [." +"filename]#nda#." #. type: Title === -#: documentation/content/en/books/handbook/zfs/_index.adoc:112 +#: documentation/content/en/books/handbook/zfs/_index.adoc:109 #, no-wrap msgid "Single Disk Pool" msgstr "Пул на одном диске" #. type: Plain text -#: documentation/content/en/books/handbook/zfs/_index.adoc:115 -msgid "To create a simple, non-redundant pool using a single disk device:" +#: documentation/content/en/books/handbook/zfs/_index.adoc:113 +msgid "" +"Create a GPT partition on an empty disk first. Then add a partition of type " +"`freebsd-zfs` from which a single, non-redundant pool is created:" msgstr "" -"Чтобы создать простой, не избыточный пул, используя одно дисковое устройство:" +"Сначала создайте раздел GPT на пустом диске. Затем добавьте раздел типа " +"`freebsd-zfs`, из которого создается один нерезервируемый пул:" #. type: delimited block . 4 #: documentation/content/en/books/handbook/zfs/_index.adoc:119 #, no-wrap -msgid "# zpool create example /dev/da0\n" -msgstr "# zpool create example /dev/da0\n" +msgid "" +"# gpart create -s gpt ada1\n" +"# gpart add -t freebsd-zfs ada1\n" +"# zpool create example /dev/ada1p1\n" +msgstr "" +"# gpart create -s gpt ada1\n" +"# gpart add -t freebsd-zfs ada1\n" +"# zpool create example /dev/ada1p1\n" #. type: Plain text #: documentation/content/en/books/handbook/zfs/_index.adoc:122 msgid "To view the new pool, review the output of `df`:" msgstr "Для просмотра нового пула ознакомьтесь с выводом команды `df`:" #. type: delimited block . 4 -#: documentation/content/en/books/handbook/zfs/_index.adoc:131 +#: documentation/content/en/books/handbook/zfs/_index.adoc:128 #, no-wrap msgid "" -"# df\n" -"Filesystem 1K-blocks Used Avail Capacity Mounted on\n" -"/dev/ad0s1a 2026030 235230 1628718 13% /\n" -"devfs 1 1 0 100% /dev\n" -"/dev/ad0s1d 54098308 1032846 48737598 2% /usr\n" -"example 17547136 0 17547136 0% /example\n" +"# df /example\n" +"Filesystem 1K-blocks Used Avail Capacity Mounted on\n" +"example 17547136 0 17547136 0% /example\n" msgstr "" -"# df\n" -"Filesystem 1K-blocks Used Avail Capacity Mounted on\n" -"/dev/ad0s1a 2026030 235230 1628718 13% /\n" -"devfs 1 1 0 100% /dev\n" -"/dev/ad0s1d 54098308 1032846 48737598 2% /usr\n" -"example 17547136 0 17547136 0% /example\n" +"# df /example\n" +"Filesystem 1K-blocks Used Avail Capacity Mounted on\n" +"example 17547136 0 17547136 0% /example\n" #. type: Plain text -#: documentation/content/en/books/handbook/zfs/_index.adoc:135 +#: documentation/content/en/books/handbook/zfs/_index.adoc:132 msgid "" -"This output shows creating and mounting of the `example` pool, and that is " -"now accessible as a file system. Create files for users to browse:" +"This output shows creating and mounting of the `example` pool, and that it " +"is now accessible as a file system. Create files for users to browse:" msgstr "" "Этот вывод показывает создание и монтирование пула `example`, который теперь " "доступен как файловая система. Создайте файлы для пользователей, чтобы " "посмотреть, что все работает:" #. type: delimited block . 4 -#: documentation/content/en/books/handbook/zfs/_index.adoc:146 +#: documentation/content/en/books/handbook/zfs/_index.adoc:143 #, no-wrap msgid "" "# cd /example\n" "# ls\n" "# touch testfile\n" "# ls -al\n" "total 4\n" "drwxr-xr-x 2 root wheel 3 Aug 29 23:15 .\n" "drwxr-xr-x 21 root wheel 512 Aug 29 23:12 ..\n" "-rw-r--r-- 1 root wheel 0 Aug 29 23:15 testfile\n" msgstr "" "# cd /example\n" "# ls\n" "# touch testfile\n" "# ls -al\n" "total 4\n" "drwxr-xr-x 2 root wheel 3 Aug 29 23:15 .\n" "drwxr-xr-x 21 root wheel 512 Aug 29 23:12 ..\n" "-rw-r--r-- 1 root wheel 0 Aug 29 23:15 testfile\n" #. type: Plain text -#: documentation/content/en/books/handbook/zfs/_index.adoc:150 +#: documentation/content/en/books/handbook/zfs/_index.adoc:147 msgid "" "This pool is not using any advanced ZFS features and properties yet. To " "create a dataset on this pool with compression enabled:" msgstr "" "Этот пул пока не использует расширенные функции и свойства ZFS. Чтобы " -"создать набор данных в этом пуле с включенным сжатием:" +"создать набор данных в этом пуле с включённым сжатием:" #. type: delimited block . 4 -#: documentation/content/en/books/handbook/zfs/_index.adoc:155 +#: documentation/content/en/books/handbook/zfs/_index.adoc:152 #, no-wrap msgid "" "# zfs create example/compressed\n" "# zfs set compression=gzip example/compressed\n" msgstr "" "# zfs create example/compressed\n" "# zfs set compression=gzip example/compressed\n" #. type: Plain text -#: documentation/content/en/books/handbook/zfs/_index.adoc:159 +#: documentation/content/en/books/handbook/zfs/_index.adoc:156 msgid "" "The `example/compressed` dataset is now a ZFS compressed file system. Try " "copying some large files to [.filename]#/example/compressed#." msgstr "" "Набор данных `example/compressed` теперь представляет собой сжатую файловую " "систему ZFS. Попробуйте скопировать несколько больших файлов в [.filename]#/" "example/compressed#." #. type: Plain text -#: documentation/content/en/books/handbook/zfs/_index.adoc:161 +#: documentation/content/en/books/handbook/zfs/_index.adoc:158 msgid "Disable compression with:" msgstr "Отключите сжатие с помощью:" #. type: delimited block . 4 -#: documentation/content/en/books/handbook/zfs/_index.adoc:165 +#: documentation/content/en/books/handbook/zfs/_index.adoc:162 #, no-wrap msgid "# zfs set compression=off example/compressed\n" msgstr "# zfs set compression=off example/compressed\n" #. type: Plain text -#: documentation/content/en/books/handbook/zfs/_index.adoc:168 +#: documentation/content/en/books/handbook/zfs/_index.adoc:165 msgid "To unmount a file system, use `zfs umount` and then verify with `df`:" msgstr "" "Чтобы отмонтировать файловую систему, используйте `zfs umount`, а затем " "проверьте с помощью `df`:" #. type: delimited block . 4 -#: documentation/content/en/books/handbook/zfs/_index.adoc:178 +#: documentation/content/en/books/handbook/zfs/_index.adoc:172 #, no-wrap msgid "" "# zfs umount example/compressed\n" "# df\n" -"Filesystem 1K-blocks Used Avail Capacity Mounted on\n" -"/dev/ad0s1a 2026030 235232 1628716 13% /\n" -"devfs 1 1 0 100% /dev\n" -"/dev/ad0s1d 54098308 1032864 48737580 2% /usr\n" -"example 17547008 0 17547008 0% /example\n" +"Filesystem 1K-blocks Used Avail Capacity Mounted on\n" +"example 17547008 0 17547008 0% /example\n" msgstr "" "# zfs umount example/compressed\n" "# df\n" -"Filesystem 1K-blocks Used Avail Capacity Mounted on\n" -"/dev/ad0s1a 2026030 235232 1628716 13% /\n" -"devfs 1 1 0 100% /dev\n" -"/dev/ad0s1d 54098308 1032864 48737580 2% /usr\n" -"example 17547008 0 17547008 0% /example\n" +"Filesystem 1K-blocks Used Avail Capacity Mounted on\n" +"example 17547008 0 17547008 0% /example\n" #. type: Plain text -#: documentation/content/en/books/handbook/zfs/_index.adoc:181 +#: documentation/content/en/books/handbook/zfs/_index.adoc:175 msgid "" "To re-mount the file system to make it accessible again, use `zfs mount` and " "verify with `df`:" msgstr "" "Для повторного монтирования файловой системы, чтобы сделать её снова " "доступной, используйте `zfs mount` и проверьте с помощью `df`:" #. type: delimited block . 4 -#: documentation/content/en/books/handbook/zfs/_index.adoc:192 +#: documentation/content/en/books/handbook/zfs/_index.adoc:183 #, no-wrap msgid "" "# zfs mount example/compressed\n" "# df\n" "Filesystem 1K-blocks Used Avail Capacity Mounted on\n" -"/dev/ad0s1a 2026030 235234 1628714 13% /\n" -"devfs 1 1 0 100% /dev\n" -"/dev/ad0s1d 54098308 1032864 48737580 2% /usr\n" "example 17547008 0 17547008 0% /example\n" "example/compressed 17547008 0 17547008 0% /example/compressed\n" msgstr "" "# zfs mount example/compressed\n" "# df\n" "Filesystem 1K-blocks Used Avail Capacity Mounted on\n" -"/dev/ad0s1a 2026030 235234 1628714 13% /\n" -"devfs 1 1 0 100% /dev\n" -"/dev/ad0s1d 54098308 1032864 48737580 2% /usr\n" "example 17547008 0 17547008 0% /example\n" "example/compressed 17547008 0 17547008 0% /example/compressed\n" #. type: Plain text -#: documentation/content/en/books/handbook/zfs/_index.adoc:195 +#: documentation/content/en/books/handbook/zfs/_index.adoc:186 msgid "Running `mount` shows the pool and file systems:" msgstr "Выполнение команды `mount` отображает пул и файловые системы:" #. type: delimited block . 4 -#: documentation/content/en/books/handbook/zfs/_index.adoc:204 +#: documentation/content/en/books/handbook/zfs/_index.adoc:195 #, no-wrap msgid "" "# mount\n" -"/dev/ad0s1a on / (ufs, local)\n" +"/dev/ada0p1 on / (ufs, local)\n" "devfs on /dev (devfs, local)\n" -"/dev/ad0s1d on /usr (ufs, local, soft-updates)\n" +"/dev/ada0p2 on /usr (ufs, local, soft-updates)\n" "example on /example (zfs, local)\n" "example/compressed on /example/compressed (zfs, local)\n" msgstr "" "# mount\n" -"/dev/ad0s1a on / (ufs, local)\n" +"/dev/ada0p1 on / (ufs, local)\n" "devfs on /dev (devfs, local)\n" -"/dev/ad0s1d on /usr (ufs, local, soft-updates)\n" +"/dev/ada0p2 on /usr (ufs, local, soft-updates)\n" "example on /example (zfs, local)\n" "example/compressed on /example/compressed (zfs, local)\n" #. type: Plain text -#: documentation/content/en/books/handbook/zfs/_index.adoc:210 +#: documentation/content/en/books/handbook/zfs/_index.adoc:201 msgid "" "Use ZFS datasets like any file system after creation. Set other available " "features on a per-dataset basis when needed. The example below creates a " "new file system called `data`. It assumes the file system contains " "important files and configures it to store two copies of each data block." msgstr "" "Используйте наборы данных ZFS как любую файловую систему после создания. " "Настраивайте другие доступные функции для каждого набора данных по мере " "необходимости. В примере ниже создаётся новая файловая система с именем " "`data`. Предполагается, что файловая система содержит важные файлы, и для " "неё настроено хранение двух копий каждого блока данных." #. type: delimited block . 4 -#: documentation/content/en/books/handbook/zfs/_index.adoc:215 +#: documentation/content/en/books/handbook/zfs/_index.adoc:206 #, no-wrap msgid "" "# zfs create example/data\n" "# zfs set copies=2 example/data\n" msgstr "" "# zfs create example/data\n" "# zfs set copies=2 example/data\n" #. type: Plain text -#: documentation/content/en/books/handbook/zfs/_index.adoc:218 +#: documentation/content/en/books/handbook/zfs/_index.adoc:209 msgid "Use `df` to see the data and space usage:" msgstr "Используйте `df` для просмотра данных и использования пространства:" #. type: delimited block . 4 -#: documentation/content/en/books/handbook/zfs/_index.adoc:229 +#: documentation/content/en/books/handbook/zfs/_index.adoc:220 #, no-wrap msgid "" "# df\n" -"Filesystem 1K-blocks Used Avail Capacity Mounted on\n" -"/dev/ad0s1a 2026030 235234 1628714 13% /\n" -"devfs 1 1 0 100% /dev\n" -"/dev/ad0s1d 54098308 1032864 48737580 2% /usr\n" -"example 17547008 0 17547008 0% /example\n" -"example/compressed 17547008 0 17547008 0% /example/compressed\n" -"example/data 17547008 0 17547008 0% /example/data\n" +"Filesystem 1K-blocks Used Avail Capacity Mounted on\n" +"/dev/ada0p1 2026030 235234 1628714 13% /\n" +"devfs 1 1 0 100% /dev\n" +"/dev/ada0p2 54098308 1032864 48737580 2% /usr\n" +"example 17547008 0 17547008 0% /example\n" +"example/compressed 17547008 0 17547008 0% /example/compressed\n" +"example/data 17547008 0 17547008 0% /example/data\n" msgstr "" "# df\n" -"Filesystem 1K-blocks Used Avail Capacity Mounted on\n" -"/dev/ad0s1a 2026030 235234 1628714 13% /\n" -"devfs 1 1 0 100% /dev\n" -"/dev/ad0s1d 54098308 1032864 48737580 2% /usr\n" -"example 17547008 0 17547008 0% /example\n" -"example/compressed 17547008 0 17547008 0% /example/compressed\n" -"example/data 17547008 0 17547008 0% /example/data\n" +"Filesystem 1K-blocks Used Avail Capacity Mounted on\n" +"/dev/ada0p1 2026030 235234 1628714 13% /\n" +"devfs 1 1 0 100% /dev\n" +"/dev/ada0p2 54098308 1032864 48737580 2% /usr\n" +"example 17547008 0 17547008 0% /example\n" +"example/compressed 17547008 0 17547008 0% /example/compressed\n" +"example/data 17547008 0 17547008 0% /example/data\n" #. type: Plain text -#: documentation/content/en/books/handbook/zfs/_index.adoc:234 +#: documentation/content/en/books/handbook/zfs/_index.adoc:225 msgid "" "Notice that all file systems in the pool have the same available space. " "Using `df` in these examples shows that the file systems use the space they " "need and all draw from the same pool. ZFS gets rid of concepts such as " "volumes and partitions, and allows several file systems to share the same " "pool." msgstr "" "Обратите внимание, что все файловые системы в пуле имеют одинаковое " "доступное пространство. Использование `df` в этих примерах показывает, что " "файловые системы занимают столько места, сколько им нужно, и все используют " "один и тот же пул. ZFS устраняет такие понятия, как тома и разделы, и " "позволяет нескольким файловым системам совместно использовать один пул." #. type: Plain text -#: documentation/content/en/books/handbook/zfs/_index.adoc:236 +#: documentation/content/en/books/handbook/zfs/_index.adoc:227 msgid "To destroy the file systems and then the pool that is no longer needed:" msgstr "" "Чтобы уничтожить файловые системы, а затем пул, который больше не нужен:" #. type: delimited block . 4 -#: documentation/content/en/books/handbook/zfs/_index.adoc:242 +#: documentation/content/en/books/handbook/zfs/_index.adoc:233 #, no-wrap msgid "" "# zfs destroy example/compressed\n" "# zfs destroy example/data\n" "# zpool destroy example\n" msgstr "" "# zfs destroy example/compressed\n" "# zfs destroy example/data\n" "# zpool destroy example\n" #. type: Title === -#: documentation/content/en/books/handbook/zfs/_index.adoc:245 +#: documentation/content/en/books/handbook/zfs/_index.adoc:236 #, no-wrap msgid "RAID-Z" msgstr "RAID-Z" #. type: Plain text -#: documentation/content/en/books/handbook/zfs/_index.adoc:251 +#: documentation/content/en/books/handbook/zfs/_index.adoc:242 msgid "" "Disks fail. One way to avoid data loss from disk failure is to use RAID. " "ZFS supports this feature in its pool design. RAID-Z pools require three or " "more disks but provide more usable space than mirrored pools." msgstr "" "Диски выходят из строя. Один из способов избежать потери данных при отказе " "диска — использование RAID. ZFS поддерживает эту возможность в своей " "конструкции пула. Пуллы RAID-Z требуют трёх или более дисков, но " "предоставляют больше полезного пространства, чем зеркальные пуллы." #. type: Plain text -#: documentation/content/en/books/handbook/zfs/_index.adoc:253 +#: documentation/content/en/books/handbook/zfs/_index.adoc:245 msgid "" -"This example creates a RAID-Z pool, specifying the disks to add to the pool:" +"This example creates a RAID-Z pool. First the GPT partitions are created on " +"each disk, then specify these GPT partitions to add to the pool using the " +"`raidz` keyword:" msgstr "" -"В этом примере создаётся пул RAID-Z с указанием дисков для добавления в пул:" +"Этот пример создает пул RAID-Z. Сначала на каждом диске создаются разделы " +"GPT, затем укажите эти разделы GPT для добавления в пул с помощью ключевого " +"слова `raidz`:" #. type: delimited block . 4 -#: documentation/content/en/books/handbook/zfs/_index.adoc:257 +#: documentation/content/en/books/handbook/zfs/_index.adoc:255 #, no-wrap -msgid "# zpool create storage raidz da0 da1 da2\n" -msgstr "# zpool create storage raidz da0 da1 da2\n" +msgid "" +"# gpart create -s gpt ada0\n" +"# gpart add -t freebsd-zfs ada0\n" +"# gpart create -s gpt ada1\n" +"# gpart add -t freebsd-zfs ada1\n" +"# gpart create -s gpt ada2\n" +"# gpart add -t freebsd-zfs ada2\n" +"# zpool create storage raidz ada0p1 ada1p1 ada2p1\n" +msgstr "" +"# gpart create -s gpt ada0\n" +"# gpart add -t freebsd-zfs ada0\n" +"# gpart create -s gpt ada1\n" +"# gpart add -t freebsd-zfs ada1\n" +"# gpart create -s gpt ada2\n" +"# gpart add -t freebsd-zfs ada2\n" +"# zpool create storage raidz ada0p1 ada1p1 ada2p1\n" #. type: delimited block = 4 -#: documentation/content/en/books/handbook/zfs/_index.adoc:265 +#: documentation/content/en/books/handbook/zfs/_index.adoc:263 msgid "" -"Sun(TM) recommends that the number of devices used in a RAID-Z configuration " -"be between three and nine. For environments requiring a single pool " +"Keeping the number of devices used in a RAID-Z configuration between three " +"and nine is recommended. For environments requiring a single pool " "consisting of 10 disks or more, consider breaking it up into smaller RAID-Z " "groups. If two disks are available, ZFS mirroring provides redundancy if " "required. Refer to man:zpool[8] for more details." msgstr "" -"Sun(TM) рекомендует использовать от трёх до девяти устройств в конфигурации " -"RAID-Z. Для сред, требующих единого пула из 10 или более дисков, " -"рекомендуется разбить его на меньшие группы RAID-Z. Если доступно два диска, " -"ZFS-зеркалирование обеспечит избыточность при необходимости. Подробнее см. в " +"Рекомендовано использовать от трёх до девяти устройств в конфигурации RAID-" +"Z. Для сред, требующих единого пула из 10 или более дисков, рекомендуется " +"разбить его на меньшие группы RAID-Z. Если доступно два диска, ZFS-" +"зеркалирование обеспечит избыточность при необходимости. Подробнее см. в " "man:zpool[8]." #. type: Plain text -#: documentation/content/en/books/handbook/zfs/_index.adoc:269 +#: documentation/content/en/books/handbook/zfs/_index.adoc:267 msgid "" "The previous example created the `storage` zpool. This example makes a new " "file system called `home` in that pool:" msgstr "" "Предыдущий пример создал пул `storage`. В этом примере в этом пуле создаётся " "новая файловая система с именем `home`:" #. type: delimited block . 4 -#: documentation/content/en/books/handbook/zfs/_index.adoc:273 +#: documentation/content/en/books/handbook/zfs/_index.adoc:271 #, no-wrap msgid "# zfs create storage/home\n" msgstr "# zfs create storage/home\n" #. type: Plain text -#: documentation/content/en/books/handbook/zfs/_index.adoc:276 +#: documentation/content/en/books/handbook/zfs/_index.adoc:274 msgid "Enable compression and store an extra copy of directories and files:" msgstr "Включить сжатие и сохранить дополнительную копию каталогов и файлов:" #. type: delimited block . 4 -#: documentation/content/en/books/handbook/zfs/_index.adoc:281 +#: documentation/content/en/books/handbook/zfs/_index.adoc:279 #, no-wrap msgid "" "# zfs set copies=2 storage/home\n" "# zfs set compression=gzip storage/home\n" msgstr "" "# zfs set copies=2 storage/home\n" "# zfs set compression=gzip storage/home\n" #. type: Plain text -#: documentation/content/en/books/handbook/zfs/_index.adoc:284 +#: documentation/content/en/books/handbook/zfs/_index.adoc:282 msgid "" "To make this the new home directory for users, copy the user data to this " "directory and create the appropriate symbolic links:" msgstr "" "Чтобы сделать это новым домашним каталогом для пользователей, скопируйте " "пользовательские данные в этот каталог и создайте соответствующие " "символические ссылки:" #. type: delimited block . 4 -#: documentation/content/en/books/handbook/zfs/_index.adoc:291 +#: documentation/content/en/books/handbook/zfs/_index.adoc:289 #, no-wrap msgid "" "# cp -rp /home/* /storage/home\n" "# rm -rf /home /usr/home\n" "# ln -s /storage/home /home\n" "# ln -s /storage/home /usr/home\n" msgstr "" "# cp -rp /home/* /storage/home\n" "# rm -rf /home /usr/home\n" "# ln -s /storage/home /home\n" "# ln -s /storage/home /usr/home\n" #. type: Plain text -#: documentation/content/en/books/handbook/zfs/_index.adoc:295 +#: documentation/content/en/books/handbook/zfs/_index.adoc:293 msgid "" -"Users data is now stored on the freshly-created [.filename]#/storage/home#. " +"User data is now stored on the freshly-created [.filename]#/storage/home#. " "Test by adding a new user and logging in as that user." msgstr "" -"Данные пользователей теперь хранятся в только что созданном [.filename]#/" +"Данные пользователя теперь хранятся в только что созданном [.filename]#/" "storage/home#. Проверьте это, добавив нового пользователя и войдя в систему " "под его учётной записью." #. type: Plain text -#: documentation/content/en/books/handbook/zfs/_index.adoc:297 +#: documentation/content/en/books/handbook/zfs/_index.adoc:295 msgid "Create a file system snapshot to roll back to later:" msgstr "Создайте снимок файловой системы для последующего отката:" #. type: delimited block . 4 -#: documentation/content/en/books/handbook/zfs/_index.adoc:301 +#: documentation/content/en/books/handbook/zfs/_index.adoc:299 #, no-wrap -msgid "# zfs snapshot storage/home@08-30-08\n" -msgstr "# zfs snapshot storage/home@08-30-08\n" +msgid "# zfs snapshot storage/home@2026-07-11\n" +msgstr "# zfs snapshot storage/home@2026-07-11\n" #. type: Plain text -#: documentation/content/en/books/handbook/zfs/_index.adoc:304 +#: documentation/content/en/books/handbook/zfs/_index.adoc:302 msgid "ZFS creates snapshots of a dataset, not a single directory or file." msgstr "ZFS создаёт снимки набора данных, а не отдельного каталога или файла." #. type: Plain text -#: documentation/content/en/books/handbook/zfs/_index.adoc:307 +#: documentation/content/en/books/handbook/zfs/_index.adoc:305 msgid "" -"The `@` character is a delimiter between the file system name or the volume " -"name. Before deleting an important directory, back up the file system, then " -"roll back to an earlier snapshot in which the directory still exists:" +"The `@` character is a delimiter between the file system or volume name and " +"the snapshot name. Before deleting an important directory, back up the file " +"system, then roll back to an earlier snapshot in which the directory still " +"exists:" msgstr "" -"Символ `@` является разделителем между именем файловой системы или именем " -"тома. Перед удалением важного каталога создайте резервную копию файловой " -"системы, а затем откатитесь к более раннему снимку, в котором каталог ещё " -"существует:" +"Символ `@` является разделителем между именем файловой системы или тома и " +"именем снимка. Перед удалением важного каталога создайте резервную копию " +"файловой системы, а затем откатитесь к более раннему снимку, в котором " +"каталог ещё существует:" #. type: delimited block . 4 -#: documentation/content/en/books/handbook/zfs/_index.adoc:311 +#: documentation/content/en/books/handbook/zfs/_index.adoc:309 #, no-wrap -msgid "# zfs rollback storage/home@08-30-08\n" -msgstr "# zfs rollback storage/home@08-30-08\n" +msgid "# zfs rollback storage/home@2026-07-11\n" +msgstr "# zfs rollback storage/home@2026-07-11\n" #. type: Plain text -#: documentation/content/en/books/handbook/zfs/_index.adoc:315 +#: documentation/content/en/books/handbook/zfs/_index.adoc:313 msgid "" "To list all available snapshots, run `ls` in the file system's [.filename]#." "zfs/snapshot# directory. For example, to see the snapshot taken:" msgstr "" "Чтобы перечислить все доступные снимки, выполните команду `ls` в каталоге [." "filename]#.zfs/snapshot# файловой системы. Например, чтобы увидеть сделанный " "снимок:" #. type: delimited block . 4 -#: documentation/content/en/books/handbook/zfs/_index.adoc:319 +#: documentation/content/en/books/handbook/zfs/_index.adoc:317 #, no-wrap msgid "# ls /storage/home/.zfs/snapshot\n" msgstr "# ls /storage/home/.zfs/snapshot\n" #. type: Plain text -#: documentation/content/en/books/handbook/zfs/_index.adoc:324 +#: documentation/content/en/books/handbook/zfs/_index.adoc:322 msgid "" "Write a script to take regular snapshots of user data. Over time, snapshots " "can use up a lot of disk space. Remove the previous snapshot using the " "command:" msgstr "" "Напишите скрипт для создания регулярных снимков пользовательских данных. Со " "временем снимки могут занимать много места на диске. Удалите предыдущий " "снимок с помощью команды:" #. type: delimited block . 4 -#: documentation/content/en/books/handbook/zfs/_index.adoc:328 +#: documentation/content/en/books/handbook/zfs/_index.adoc:326 #, no-wrap -msgid "# zfs destroy storage/home@08-30-08\n" -msgstr "# zfs destroy storage/home@08-30-08\n" +msgid "# zfs destroy storage/home@2026-07-11\n" +msgstr "# zfs destroy storage/home@2026-07-11\n" #. type: Plain text -#: documentation/content/en/books/handbook/zfs/_index.adoc:332 +#: documentation/content/en/books/handbook/zfs/_index.adoc:330 msgid "" "After testing, make [.filename]#/storage/home# the real [.filename]#/home# " "with this command:" msgstr "" "После тестирования сделайте [.filename]#/storage/home# настоящим [." "filename]#/home# с помощью следующей команды:" #. type: delimited block . 4 -#: documentation/content/en/books/handbook/zfs/_index.adoc:336 +#: documentation/content/en/books/handbook/zfs/_index.adoc:334 #, no-wrap msgid "# zfs set mountpoint=/home storage/home\n" msgstr "# zfs set mountpoint=/home storage/home\n" #. type: Plain text -#: documentation/content/en/books/handbook/zfs/_index.adoc:339 +#: documentation/content/en/books/handbook/zfs/_index.adoc:337 msgid "" "Run `df` and `mount` to confirm that the system now treats the file system " "as the real [.filename]#/home#:" msgstr "" "Выполните команды `df` и `mount`, чтобы убедиться, что система теперь " "распознает файловую систему как настоящий [.filename]#/home#:" #. type: delimited block . 4 -#: documentation/content/en/books/handbook/zfs/_index.adoc:355 +#: documentation/content/en/books/handbook/zfs/_index.adoc:353 #, no-wrap msgid "" "# mount\n" -"/dev/ad0s1a on / (ufs, local)\n" +"/dev/ada0p1 on / (ufs, local)\n" "devfs on /dev (devfs, local)\n" -"/dev/ad0s1d on /usr (ufs, local, soft-updates)\n" +"/dev/ada0p2 on /usr (ufs, local, soft-updates)\n" "storage on /storage (zfs, local)\n" "storage/home on /home (zfs, local)\n" "# df\n" "Filesystem 1K-blocks Used Avail Capacity Mounted on\n" -"/dev/ad0s1a 2026030 235240 1628708 13% /\n" +"/dev/ada0p1 2026030 235240 1628708 13% /\n" "devfs 1 1 0 100% /dev\n" -"/dev/ad0s1d 54098308 1032826 48737618 2% /usr\n" +"/dev/ada0p2 54098308 1032826 48737618 2% /usr\n" "storage 26320512 0 26320512 0% /storage\n" "storage/home 26320512 0 26320512 0% /home\n" msgstr "" "# mount\n" -"/dev/ad0s1a on / (ufs, local)\n" +"/dev/ada0p1 on / (ufs, local)\n" "devfs on /dev (devfs, local)\n" -"/dev/ad0s1d on /usr (ufs, local, soft-updates)\n" +"/dev/ada0p2 on /usr (ufs, local, soft-updates)\n" "storage on /storage (zfs, local)\n" "storage/home on /home (zfs, local)\n" "# df\n" "Filesystem 1K-blocks Used Avail Capacity Mounted on\n" -"/dev/ad0s1a 2026030 235240 1628708 13% /\n" +"/dev/ada0p1 2026030 235240 1628708 13% /\n" "devfs 1 1 0 100% /dev\n" -"/dev/ad0s1d 54098308 1032826 48737618 2% /usr\n" +"/dev/ada0p2 54098308 1032826 48737618 2% /usr\n" "storage 26320512 0 26320512 0% /storage\n" "storage/home 26320512 0 26320512 0% /home\n" #. type: Plain text -#: documentation/content/en/books/handbook/zfs/_index.adoc:359 +#: documentation/content/en/books/handbook/zfs/_index.adoc:357 msgid "" "This completes the RAID-Z configuration. Add daily status updates about the " "created file systems to the nightly man:periodic[8] runs by adding this line " "to [.filename]#/etc/periodic.conf#:" msgstr "" "Настройка RAID-Z завершена. Для добавления ежедневных отчётов о состоянии " "созданных файловых систем в ночные запуски man:periodic[8] добавьте " "следующую строку в [.filename]#/etc/periodic.conf#:" #. type: delimited block . 4 -#: documentation/content/en/books/handbook/zfs/_index.adoc:363 +#: documentation/content/en/books/handbook/zfs/_index.adoc:361 #, no-wrap msgid "daily_status_zfs_enable=\"YES\"\n" msgstr "daily_status_zfs_enable=\"YES\"\n" +#. type: Plain text +#: documentation/content/en/books/handbook/zfs/_index.adoc:364 +msgid "" +"man:periodic[8] can also run scheduled scrubs of the pool; see crossref:" +"zfs[zfs-zpool-scrub,Scrubbing a Pool]." +msgstr "" +"man:periodic[8] также может выполнять запланированные проверки пула; см. " +"crossref:zfs[zfs-zpool-scrub,Проверка пула]." + #. type: Title === #: documentation/content/en/books/handbook/zfs/_index.adoc:366 #, no-wrap msgid "Recovering RAID-Z" msgstr "Восстановление RAID-Z" #. type: Plain text #: documentation/content/en/books/handbook/zfs/_index.adoc:370 msgid "" "Every software RAID has a method of monitoring its `state`. View the status " "of RAID-Z devices using:" msgstr "" "Каждый программный RAID имеет метод контроля своего `состояния`. Просмотр " "состояния устройств RAID-Z осуществляется с помощью:" #. type: delimited block . 4 #: documentation/content/en/books/handbook/zfs/_index.adoc:374 #, no-wrap msgid "# zpool status -x\n" msgstr "# zpool status -x\n" #. type: Plain text #: documentation/content/en/books/handbook/zfs/_index.adoc:377 msgid "" "If all pools are crossref:zfs[zfs-term-online,Online] and everything is " "normal, the message shows:" msgstr "" "Если все пулы находятся в состоянии crossref:zfs[zfs-term-online,онлайн] и " "все работает нормально, сообщение будет следующим:" #. type: delimited block . 4 #: documentation/content/en/books/handbook/zfs/_index.adoc:381 #, no-wrap msgid "all pools are healthy\n" msgstr "all pools are healthy\n" #. type: Plain text #: documentation/content/en/books/handbook/zfs/_index.adoc:385 msgid "" "If there is a problem, perhaps a disk being in the crossref:zfs[zfs-term-" "offline,Offline] state, the pool state will look like this:" msgstr "" "Если возникла проблема, например, диск находится в состоянии crossref:" "zfs[zfs-term-offline,оффлайн], состояние пула будет выглядеть так:" #. type: delimited block . 4 #: documentation/content/en/books/handbook/zfs/_index.adoc:397 #, no-wrap msgid "" " pool: storage\n" " state: DEGRADED\n" "status: One or more devices has been taken offline by the administrator.\n" -"\tSufficient replicas exist for the pool to continue functioning in a\n" -"\tdegraded state.\n" +" Sufficient replicas exist for the pool to continue functioning in a\n" +" degraded state.\n" "action: Online the device using 'zpool online' or replace the device with\n" -"\t'zpool replace'.\n" -" scrub: none requested\n" +" 'zpool replace'.\n" +" scan: none requested\n" "config:\n" msgstr "" " pool: storage\n" " state: DEGRADED\n" "status: One or more devices has been taken offline by the administrator.\n" -"\tSufficient replicas exist for the pool to continue functioning in a\n" -"\tdegraded state.\n" +" Sufficient replicas exist for the pool to continue functioning in a\n" +" degraded state.\n" "action: Online the device using 'zpool online' or replace the device with\n" -"\t'zpool replace'.\n" -" scrub: none requested\n" +" 'zpool replace'.\n" +" scan: none requested\n" "config:\n" #. type: delimited block . 4 #: documentation/content/en/books/handbook/zfs/_index.adoc:404 #, no-wrap msgid "" -"\tNAME STATE READ WRITE CKSUM\n" -"\tstorage DEGRADED 0 0 0\n" -"\t raidz1 DEGRADED 0 0 0\n" -"\t da0 ONLINE 0 0 0\n" -"\t da1 OFFLINE 0 0 0\n" -"\t da2 ONLINE 0 0 0\n" +" NAME STATE READ WRITE CKSUM\n" +" storage DEGRADED 0 0 0\n" +" raidz1-0 DEGRADED 0 0 0\n" +" ada0p1 ONLINE 0 0 0\n" +" ada1p1 OFFLINE 0 0 0\n" +" ada2p1 ONLINE 0 0 0\n" msgstr "" -"\tNAME STATE READ WRITE CKSUM\n" -"\tstorage DEGRADED 0 0 0\n" -"\t raidz1 DEGRADED 0 0 0\n" -"\t da0 ONLINE 0 0 0\n" -"\t da1 OFFLINE 0 0 0\n" -"\t da2 ONLINE 0 0 0\n" +" NAME STATE READ WRITE CKSUM\n" +" storage DEGRADED 0 0 0\n" +" raidz1-0 DEGRADED 0 0 0\n" +" ada0p1 ONLINE 0 0 0\n" +" ada1p1 OFFLINE 0 0 0\n" +" ada2p1 ONLINE 0 0 0\n" #. type: delimited block . 4 #: documentation/content/en/books/handbook/zfs/_index.adoc:406 -#: documentation/content/en/books/handbook/zfs/_index.adoc:441 -#: documentation/content/en/books/handbook/zfs/_index.adoc:487 -#: documentation/content/en/books/handbook/zfs/_index.adoc:532 +#: documentation/content/en/books/handbook/zfs/_index.adoc:442 +#: documentation/content/en/books/handbook/zfs/_index.adoc:488 +#: documentation/content/en/books/handbook/zfs/_index.adoc:533 #: documentation/content/en/books/handbook/zfs/_index.adoc:555 -#: documentation/content/en/books/handbook/zfs/_index.adoc:587 -#: documentation/content/en/books/handbook/zfs/_index.adoc:666 -#: documentation/content/en/books/handbook/zfs/_index.adoc:720 -#: documentation/content/en/books/handbook/zfs/_index.adoc:757 -#: documentation/content/en/books/handbook/zfs/_index.adoc:786 -#: documentation/content/en/books/handbook/zfs/_index.adoc:866 -#: documentation/content/en/books/handbook/zfs/_index.adoc:942 -#: documentation/content/en/books/handbook/zfs/_index.adoc:974 -#: documentation/content/en/books/handbook/zfs/_index.adoc:1074 -#: documentation/content/en/books/handbook/zfs/_index.adoc:1118 -#: documentation/content/en/books/handbook/zfs/_index.adoc:1143 -#: documentation/content/en/books/handbook/zfs/_index.adoc:1164 +#: documentation/content/en/books/handbook/zfs/_index.adoc:586 +#: documentation/content/en/books/handbook/zfs/_index.adoc:703 +#: documentation/content/en/books/handbook/zfs/_index.adoc:759 +#: documentation/content/en/books/handbook/zfs/_index.adoc:796 +#: documentation/content/en/books/handbook/zfs/_index.adoc:833 +#: documentation/content/en/books/handbook/zfs/_index.adoc:882 +#: documentation/content/en/books/handbook/zfs/_index.adoc:931 +#: documentation/content/en/books/handbook/zfs/_index.adoc:1047 +#: documentation/content/en/books/handbook/zfs/_index.adoc:1137 +#: documentation/content/en/books/handbook/zfs/_index.adoc:1215 +#: documentation/content/en/books/handbook/zfs/_index.adoc:1241 +#: documentation/content/en/books/handbook/zfs/_index.adoc:1270 +#: documentation/content/en/books/handbook/zfs/_index.adoc:1343 +#: documentation/content/en/books/handbook/zfs/_index.adoc:1457 +#: documentation/content/en/books/handbook/zfs/_index.adoc:1501 +#: documentation/content/en/books/handbook/zfs/_index.adoc:1526 +#: documentation/content/en/books/handbook/zfs/_index.adoc:1547 +#: documentation/content/en/books/handbook/zfs/_index.adoc:1583 +#: documentation/content/en/books/handbook/zfs/_index.adoc:1793 #, no-wrap msgid "errors: No known data errors\n" msgstr "errors: No known data errors\n" #. type: Plain text #: documentation/content/en/books/handbook/zfs/_index.adoc:409 msgid "" -"\"OFFLINE\" shows the administrator took [.filename]#da1# offline using:" +"\"OFFLINE\" shows the administrator took [.filename]#ada1p1# offline using:" msgstr "" -"\"OFFLINE\" показывает, что администратор перевел [.filename]#da1# в " +"\"OFFLINE\" показывает, что администратор перевел [.filename]#ada1p1# в " "автономный режим с помощью:" #. type: delimited block . 4 #: documentation/content/en/books/handbook/zfs/_index.adoc:413 #, no-wrap -msgid "# zpool offline storage da1\n" -msgstr "# zpool offline storage da1\n" +msgid "# zpool offline storage ada1p1\n" +msgstr "# zpool offline storage ada1p1\n" #. type: Plain text -#: documentation/content/en/books/handbook/zfs/_index.adoc:417 +#: documentation/content/en/books/handbook/zfs/_index.adoc:418 msgid "" -"Power down the computer now and replace [.filename]#da1#. Power up the " -"computer and return [.filename]#da1# to the pool:" +"Power down the computer now and replace [.filename]#ada1p1#. Recreate the " +"GPT partition of type `freebsd-zfs` on the new disk. Power up the computer " +"and return [.filename]#ada1p1# to the pool:" msgstr "" -"Выключите компьютер и замените диск [.filename]#da1#. Включите компьютер и " -"верните [.filename]#da1# в пул:" +"Выключите компьютер и замените диск [.filename]#ada1p1#. Заново создайте GPT-" +"раздел типа `freebsd-zfs` на новом диске. Включите компьютер и верните [." +"filename]#ada1p1# в пул:" #. type: delimited block . 4 -#: documentation/content/en/books/handbook/zfs/_index.adoc:421 +#: documentation/content/en/books/handbook/zfs/_index.adoc:422 #, no-wrap -msgid "# zpool replace storage da1\n" -msgstr "# zpool replace storage da1\n" +msgid "# zpool replace storage ada1p1\n" +msgstr "# zpool replace storage ada1p1\n" #. type: Plain text -#: documentation/content/en/books/handbook/zfs/_index.adoc:424 +#: documentation/content/en/books/handbook/zfs/_index.adoc:425 msgid "" "Next, check the status again, this time without `-x` to display all pools:" msgstr "" "Далее снова проверьте статус, на этот раз без `-x`, чтобы отобразить все " "пулы:" #. type: delimited block . 4 -#: documentation/content/en/books/handbook/zfs/_index.adoc:432 +#: documentation/content/en/books/handbook/zfs/_index.adoc:433 #, no-wrap msgid "" "# zpool status storage\n" -" pool: storage\n" +" pool: storage\n" " state: ONLINE\n" -" scrub: resilver completed with 0 errors on Sat Aug 30 19:44:11 2008\n" +" scan: resilvered 3.21G in 00:04:36 with 0 errors on Sat Jul 11 10:32:19 2026\n" "config:\n" msgstr "" "# zpool status storage\n" -" pool: storage\n" +" pool: storage\n" " state: ONLINE\n" -" scrub: resilver completed with 0 errors on Sat Aug 30 19:44:11 2008\n" +" scan: resilvered 3.21G in 00:04:36 with 0 errors on Sat Jul 11 10:32:19 " +"2026\n" "config:\n" #. type: delimited block . 4 -#: documentation/content/en/books/handbook/zfs/_index.adoc:439 -#: documentation/content/en/books/handbook/zfs/_index.adoc:485 +#: documentation/content/en/books/handbook/zfs/_index.adoc:440 +#: documentation/content/en/books/handbook/zfs/_index.adoc:486 #, no-wrap msgid "" -"\tNAME STATE READ WRITE CKSUM\n" -"\tstorage ONLINE 0 0 0\n" -"\t raidz1 ONLINE 0 0 0\n" -"\t da0 ONLINE 0 0 0\n" -"\t da1 ONLINE 0 0 0\n" -"\t da2 ONLINE 0 0 0\n" +" NAME STATE READ WRITE CKSUM\n" +" storage ONLINE 0 0 0\n" +" raidz1-0 ONLINE 0 0 0\n" +" ada0p1 ONLINE 0 0 0\n" +" ada1p1 ONLINE 0 0 0\n" +" ada2p1 ONLINE 0 0 0\n" msgstr "" -"\tNAME STATE READ WRITE CKSUM\n" -"\tstorage ONLINE 0 0 0\n" -"\t raidz1 ONLINE 0 0 0\n" -"\t da0 ONLINE 0 0 0\n" -"\t da1 ONLINE 0 0 0\n" -"\t da2 ONLINE 0 0 0\n" +" NAME STATE READ WRITE CKSUM\n" +" storage ONLINE 0 0 0\n" +" raidz1-0 ONLINE 0 0 0\n" +" ada0p1 ONLINE 0 0 0\n" +" ada1p1 ONLINE 0 0 0\n" +" ada2p1 ONLINE 0 0 0\n" #. type: Plain text -#: documentation/content/en/books/handbook/zfs/_index.adoc:444 +#: documentation/content/en/books/handbook/zfs/_index.adoc:445 msgid "In this example, everything is normal." msgstr "В этом примере все в порядке." #. type: Title === -#: documentation/content/en/books/handbook/zfs/_index.adoc:446 +#: documentation/content/en/books/handbook/zfs/_index.adoc:447 #, no-wrap msgid "Data Verification" msgstr "Проверка данных" #. type: Plain text -#: documentation/content/en/books/handbook/zfs/_index.adoc:450 +#: documentation/content/en/books/handbook/zfs/_index.adoc:451 msgid "" "ZFS uses checksums to verify the integrity of stored data. Creating file " "systems automatically enables them." msgstr "" "ZFS использует контрольные суммы для проверки целостности хранимых данных. " "Создание файловых систем автоматически включает их." #. type: delimited block = 4 -#: documentation/content/en/books/handbook/zfs/_index.adoc:457 +#: documentation/content/en/books/handbook/zfs/_index.adoc:458 msgid "" "Disabling Checksums is possible but _not_ recommended! Checksums take little " "storage space and provide data integrity. Most ZFS features will not work " "properly with checksums disabled. Disabling these checksums will not " "increase performance noticeably." msgstr "" "Отключение контрольных сумм возможно, но _не_ рекомендуется! Контрольные " "суммы занимают мало места и обеспечивают целостность данных. Большинство " -"функций ZFS не будут работать корректно при отключенных контрольных суммах. " +"функций ZFS не будут работать корректно при отключённых контрольных суммах. " "Их отключение не приведет к заметному повышению производительности." #. type: Plain text -#: documentation/content/en/books/handbook/zfs/_index.adoc:460 +#: documentation/content/en/books/handbook/zfs/_index.adoc:461 msgid "" "Verifying the data checksums (called _scrubbing_) ensures integrity of the " "`storage` pool with:" msgstr "" "Проверка контрольных сумм данных (называемая _scrubbing_) обеспечивает " "целостность пула `storage` с помощью:" #. type: delimited block . 4 -#: documentation/content/en/books/handbook/zfs/_index.adoc:464 +#: documentation/content/en/books/handbook/zfs/_index.adoc:465 #, no-wrap msgid "# zpool scrub storage\n" msgstr "# zpool scrub storage\n" #. type: Plain text -#: documentation/content/en/books/handbook/zfs/_index.adoc:470 +#: documentation/content/en/books/handbook/zfs/_index.adoc:471 msgid "" "The duration of a scrub depends on the amount of data stored. Larger " "amounts of data will take proportionally longer to verify. Since scrubbing " -"is I/O intensive, ZFS allows a single scrub to run at a time. After " -"scrubbing completes, view the status with `zpool status`:" +"is I/O intensive, ZFS allows a single scrub to run on each pool at a time. " +"After scrubbing completes, view the status with `zpool status`:" msgstr "" "Продолжительность очистки зависит от объёма хранимых данных. Большие объёмы " "данных требуют пропорционально больше времени для проверки. Поскольку " "очистка интенсивно использует операции ввода-вывода, ZFS позволяет выполнять " -"только одну очистку одновременно. После завершения очистки просмотрите " -"статус с помощью `zpool status`:" +"только одну очистку на каждом пуле одновременно. После завершения очистки " +"просмотрите статус с помощью `zpool status`:" #. type: delimited block . 4 -#: documentation/content/en/books/handbook/zfs/_index.adoc:478 +#: documentation/content/en/books/handbook/zfs/_index.adoc:479 #, no-wrap msgid "" "# zpool status storage\n" -" pool: storage\n" +" pool: storage\n" " state: ONLINE\n" -" scrub: scrub completed with 0 errors on Sat Jan 26 19:57:37 2013\n" +" scan: scrub repaired 0B in 00:19:16 with 0 errors on Sat Jul 11 10:32:19 2026\n" "config:\n" msgstr "" "# zpool status storage\n" -" pool: storage\n" +" pool: storage\n" " state: ONLINE\n" -" scrub: scrub completed with 0 errors on Sat Jan 26 19:57:37 2013\n" +" scan: scrub repaired 0B in 00:19:16 with 0 errors on Sat Jul 11 10:32:19 " +"2026\n" "config:\n" #. type: Plain text -#: documentation/content/en/books/handbook/zfs/_index.adoc:491 +#: documentation/content/en/books/handbook/zfs/_index.adoc:492 msgid "" "Displaying the completion date of the last scrubbing helps decide when to " "start another. Routine scrubs help protect data from silent corruption and " "ensure the integrity of the pool." msgstr "" "Отображение даты завершения последней очистки помогает определить, когда " "начать следующую. Регулярная очистка защищает данные от тихих повреждений и " "гарантирует целостность пула." #. type: Plain text -#: documentation/content/en/books/handbook/zfs/_index.adoc:493 +#: documentation/content/en/books/handbook/zfs/_index.adoc:494 msgid "Refer to man:zfs[8] and man:zpool[8] for other ZFS options." msgstr "См. man:zfs[8] и man:zpool[8] для других опций ZFS." #. type: Title == -#: documentation/content/en/books/handbook/zfs/_index.adoc:495 +#: documentation/content/en/books/handbook/zfs/_index.adoc:496 #, no-wrap msgid "`zpool` Administration" msgstr "Администрирование `zpool`" #. type: Plain text -#: documentation/content/en/books/handbook/zfs/_index.adoc:502 +#: documentation/content/en/books/handbook/zfs/_index.adoc:503 msgid "" "ZFS administration uses two main utilities. The `zpool` utility controls " "the operation of the pool and allows adding, removing, replacing, and " "managing disks. The crossref:zfs[zfs-zfs,`zfs`] utility allows creating, " "destroying, and managing datasets, both crossref:zfs[zfs-term-filesystem," "file systems] and crossref:zfs[zfs-term-volume,volumes]." msgstr "" "Управление ZFS осуществляется с помощью двух основных утилит. Утилита " "`zpool` контролирует работу пула и позволяет добавлять, удалять, заменять и " "управлять дисками. Утилита crossref:zfs[zfs-zfs,`zfs`] позволяет создавать, " "уничтожать и управлять наборами данных, включая как crossref:zfs[zfs-term-" "filesystem,файловые системы], так и crossref:zfs[zfs-term-volume,тома]." #. type: Title === -#: documentation/content/en/books/handbook/zfs/_index.adoc:504 +#: documentation/content/en/books/handbook/zfs/_index.adoc:505 #, no-wrap msgid "Creating and Destroying Storage Pools" msgstr "Создание и удаление пулов хранения данных" -#. type: Plain text -#: documentation/content/en/books/handbook/zfs/_index.adoc:513 -msgid "" -"Creating a ZFS storage pool requires permanent decisions, as the pool " -"structure cannot change after creation. The most important decision is " -"which types of vdevs to group the physical disks into. See the list of " -"crossref:zfs[zfs-term-vdev,vdev types] for details about the possible " -"options. After creating the pool, most vdev types do not allow adding disks " -"to the vdev. The exceptions are mirrors, which allow adding new disks to " -"the vdev, and stripes, which upgrade to mirrors by attaching a new disk to " -"the vdev. Although adding new vdevs expands a pool, the pool layout cannot " -"change after pool creation. Instead, back up the data, destroy the pool, " -"and recreate it." -msgstr "" -"Создание пула хранения ZFS требует принятия окончательного решения о " -"нескольких параметрах, так как структура пула не может быть изменена после " -"создания. Наиболее важное решение — это выбор типов vdev, в которые будут " -"объединены физические диски. Подробнее о возможных вариантах см. в списке " -"crossref:zfs[zfs-term-vdev,типов vdev]. После создания пула большинство " -"типов vdev не позволяют добавлять диски в vdev. Исключения составляют " -"зеркала (mirror), которые позволяют добавлять новые диски в vdev, и страйпы " -"(stripe), которые могут быть преобразованы в зеркала путём добавления нового " -"диска к vdev. Хотя добавление новых vdev расширяет пул, компоновка пула не " -"может быть изменена после его создания. Вместо этого необходимо создать " -"резервную копию данных, удалить пул и воссоздать его." - #. type: Plain text #: documentation/content/en/books/handbook/zfs/_index.adoc:515 -msgid "Create a simple mirror pool:" -msgstr "Создание простого зеркального пула:" - -#. type: delimited block . 4 -#: documentation/content/en/books/handbook/zfs/_index.adoc:524 -#, no-wrap msgid "" -"# zpool create mypool mirror /dev/ada1 /dev/ada2\n" +"The most important decision when creating a ZFS storage pool is which types " +"of vdevs to group the physical disks into. See the list of crossref:zfs[zfs-" +"term-vdev,vdev types] for details about the possible options. The vdev " +"types determine the redundancy, capacity, and performance characteristics of " +"a pool. A pool's layout is not fixed forever at creation time. Mirrors " +"allow adding new disks to the vdev, and stripes upgrade to mirrors by " +"attaching a new disk to the vdev. RAID-Z vdevs grow one disk at a time with " +"crossref:zfs[zfs-zpool-raidz-expansion,RAID-Z expansion], which requires " +"OpenZFS 2.3 or later, first available in FreeBSD 15.0. Adding new vdevs " +"expands a pool at any time, and crossref:zfs[zfs-zpool-attach,removing top-" +"level vdevs] is possible within limits. Reshaping a live pool takes time " +"and I/O bandwidth, so choosing suitable vdev types up front remains " +"important." +msgstr "" +"Самое важное решение при создании пула хранения ZFS — это выбор типов vdev " +"для группировки физических дисков. См. список crossref:zfs[zfs-term-" +"vdev,типов vdev] для получения подробной информации о возможных вариантах. " +"Типы vdev определяют характеристики избыточности, ёмкости и " +"производительности пула. Раскладка пула не фиксируется навсегда при его " +"создании. Зеркала позволяют добавлять новые диски в vdev, а полосы (stripes) " +"обновляются до зеркал путём присоединения нового диска к vdev. Vdev RAID-Z " +"увеличиваются на один диск за раз с помощью crossref:zfs[zfs-zpool-raidz-" +"expansion,расширения RAID-Z], которое требует OpenZFS 2.3 или более поздней " +"версии, впервые доступной во FreeBSD 15.0. Добавление новых vdev расширяет " +"пул в любое время, а crossref:zfs[zfs-zpool-attach,удаление верхних уровней " +"vdev] возможно в определённых пределах. Изменение формы активного пула " +"занимает время и пропускную способность ввода-вывода, поэтому выбор " +"подходящих типов vdev заранее остаётся важным." + +#. type: Plain text +#: documentation/content/en/books/handbook/zfs/_index.adoc:517 +msgid "" +"Create a simple mirror pool on disks containing GPT partitions of type " +"`freebsd-zfs`:" +msgstr "" +"Создайте простой зеркальный пул на дисках, содержащих GPT-разделы типа " +"`freebsd-zfs`:" + +#. type: delimited block . 4 +#: documentation/content/en/books/handbook/zfs/_index.adoc:525 +#, no-wrap +msgid "" +"# zpool create mypool mirror /dev/ada1p1 /dev/ada2p1\n" "# zpool status\n" " pool: mypool\n" " state: ONLINE\n" -" scan: none requested\n" "config:\n" msgstr "" -"# zpool create mypool mirror /dev/ada1 /dev/ada2\n" +"# zpool create mypool mirror /dev/ada1p1 /dev/ada2p1\n" "# zpool status\n" " pool: mypool\n" " state: ONLINE\n" -" scan: none requested\n" "config:\n" #. type: delimited block . 4 -#: documentation/content/en/books/handbook/zfs/_index.adoc:530 +#: documentation/content/en/books/handbook/zfs/_index.adoc:531 #, no-wrap msgid "" " NAME STATE READ WRITE CKSUM\n" " mypool ONLINE 0 0 0\n" " mirror-0 ONLINE 0 0 0\n" -" ada1 ONLINE 0 0 0\n" -" ada2 ONLINE 0 0 0\n" +" ada1p1 ONLINE 0 0 0\n" +" ada2p1 ONLINE 0 0 0\n" msgstr "" " NAME STATE READ WRITE CKSUM\n" " mypool ONLINE 0 0 0\n" " mirror-0 ONLINE 0 0 0\n" -" ada1 ONLINE 0 0 0\n" -" ada2 ONLINE 0 0 0\n" +" ada1p1 ONLINE 0 0 0\n" +" ada2p1 ONLINE 0 0 0\n" #. type: Plain text -#: documentation/content/en/books/handbook/zfs/_index.adoc:535 +#: documentation/content/en/books/handbook/zfs/_index.adoc:536 msgid "" "To create more than one vdev with a single command, specify groups of disks " "separated by the vdev type keyword, `mirror` in this example:" msgstr "" "Чтобы создать более одного vdev одной командой, укажите группы дисков, " -"разделенные ключевым словом типа vdev, в данном примере `mirror`:" +"разделённые ключевым словом типа vdev, в данном примере `mirror`:" #. type: delimited block . 4 #: documentation/content/en/books/handbook/zfs/_index.adoc:544 #, no-wrap msgid "" -"# zpool create mypool mirror /dev/ada1 /dev/ada2 mirror /dev/ada3 /dev/ada4\n" +"# zpool create mypool mirror /dev/ada1p1 /dev/ada2p1 mirror /dev/ada3p1 /dev/ada4p1\n" "# zpool status\n" " pool: mypool\n" " state: ONLINE\n" -" scan: none requested\n" "config:\n" msgstr "" -"# zpool create mypool mirror /dev/ada1 /dev/ada2 mirror /dev/ada3 /dev/ada4\n" +"# zpool create mypool mirror /dev/ada1p1 /dev/ada2p1 mirror /dev/ada3p1 /dev/" +"ada4p1\n" "# zpool status\n" " pool: mypool\n" " state: ONLINE\n" -" scan: none requested\n" "config:\n" #. type: delimited block . 4 #: documentation/content/en/books/handbook/zfs/_index.adoc:553 #, no-wrap msgid "" " NAME STATE READ WRITE CKSUM\n" " mypool ONLINE 0 0 0\n" " mirror-0 ONLINE 0 0 0\n" -" ada1 ONLINE 0 0 0\n" -" ada2 ONLINE 0 0 0\n" +" ada1p1 ONLINE 0 0 0\n" +" ada2p1 ONLINE 0 0 0\n" " mirror-1 ONLINE 0 0 0\n" -" ada3 ONLINE 0 0 0\n" -" ada4 ONLINE 0 0 0\n" +" ada3p1 ONLINE 0 0 0\n" +" ada4p1 ONLINE 0 0 0\n" msgstr "" " NAME STATE READ WRITE CKSUM\n" " mypool ONLINE 0 0 0\n" " mirror-0 ONLINE 0 0 0\n" -" ada1 ONLINE 0 0 0\n" -" ada2 ONLINE 0 0 0\n" +" ada1p1 ONLINE 0 0 0\n" +" ada2p1 ONLINE 0 0 0\n" " mirror-1 ONLINE 0 0 0\n" -" ada3 ONLINE 0 0 0\n" -" ada4 ONLINE 0 0 0\n" +" ada3p1 ONLINE 0 0 0\n" +" ada4p1 ONLINE 0 0 0\n" #. type: Plain text #: documentation/content/en/books/handbook/zfs/_index.adoc:564 msgid "" "Pools can also use partitions rather than whole disks. Putting ZFS in a " "separate partition allows the same disk to have other partitions for other " "purposes. In particular, it allows adding partitions with bootcode and file " "systems needed for booting. This allows booting from disks that are also " "members of a pool. ZFS adds no performance penalty on FreeBSD when using a " "partition rather than a whole disk. Using partitions also allows the " "administrator to _under-provision_ the disks, using less than the full " "capacity. If a future replacement disk of the same nominal size as the " "original actually has a slightly smaller capacity, the smaller partition " "will still fit, using the replacement disk." msgstr "" "Пулы также могут использовать разделы вместо целых дисков. Размещение ZFS в " "отдельном разделе позволяет одному диску иметь другие разделы для иных " "целей. В частности, это позволяет добавлять разделы с загрузочным кодом и " "файловыми системами, необходимыми для загрузки. Это даёт возможность " "загружаться с дисков, которые также являются членами пула. ZFS не приводит к " "снижению производительности на FreeBSD при использовании раздела вместо " "целого диска. Использование разделов также позволяет администратору " "_недоиспользовать_ диски, задействуя не всю их емкость. Если будущий " "заменяемый диск того же номинального размера, что и оригинальный, на самом " "деле имеет немного меньшую емкость, меньший раздел все равно поместится на " "заменяемом диске." #. type: Plain text #: documentation/content/en/books/handbook/zfs/_index.adoc:566 msgid "" "Create a crossref:zfs[zfs-term-vdev-raidz,RAID-Z2] pool using partitions:" msgstr "" "Создание пула crossref:zfs[zfs-term-vdev-raidz,RAID-Z2] с использованием " "разделов:" #. type: delimited block . 4 -#: documentation/content/en/books/handbook/zfs/_index.adoc:575 +#: documentation/content/en/books/handbook/zfs/_index.adoc:574 #, no-wrap msgid "" -"# zpool create mypool raidz2 /dev/ada0p3 /dev/ada1p3 /dev/ada2p3 /dev/ada3p3 /dev/ada4p3 /dev/ada5p3\n" +"# zpool create mypool raidz2 /dev/ada0p1 /dev/ada1p1 /dev/ada2p1 /dev/ada3p1 /dev/ada4p1 /dev/ada5p1\n" "# zpool status\n" " pool: mypool\n" " state: ONLINE\n" -" scan: none requested\n" "config:\n" msgstr "" -"# zpool create mypool raidz2 /dev/ada0p3 /dev/ada1p3 /dev/ada2p3 /dev/ada3p3 /dev/ada4p3 /dev/ada5p3\n" +"# zpool create mypool raidz2 /dev/ada0p1 /dev/ada1p1 /dev/ada2p1 /dev/ada3p1 " +"/dev/ada4p1 /dev/ada5p1\n" "# zpool status\n" " pool: mypool\n" " state: ONLINE\n" -" scan: none requested\n" "config:\n" #. type: delimited block . 4 -#: documentation/content/en/books/handbook/zfs/_index.adoc:585 -#: documentation/content/en/books/handbook/zfs/_index.adoc:784 -#: documentation/content/en/books/handbook/zfs/_index.adoc:972 +#: documentation/content/en/books/handbook/zfs/_index.adoc:584 #, no-wrap msgid "" " NAME STATE READ WRITE CKSUM\n" " mypool ONLINE 0 0 0\n" " raidz2-0 ONLINE 0 0 0\n" -" ada0p3 ONLINE 0 0 0\n" -" ada1p3 ONLINE 0 0 0\n" -" ada2p3 ONLINE 0 0 0\n" -" ada3p3 ONLINE 0 0 0\n" -" ada4p3 ONLINE 0 0 0\n" -" ada5p3 ONLINE 0 0 0\n" +" ada0p1 ONLINE 0 0 0\n" +" ada1p1 ONLINE 0 0 0\n" +" ada2p1 ONLINE 0 0 0\n" +" ada3p1 ONLINE 0 0 0\n" +" ada4p1 ONLINE 0 0 0\n" +" ada5p1 ONLINE 0 0 0\n" msgstr "" " NAME STATE READ WRITE CKSUM\n" " mypool ONLINE 0 0 0\n" " raidz2-0 ONLINE 0 0 0\n" -" ada0p3 ONLINE 0 0 0\n" -" ada1p3 ONLINE 0 0 0\n" -" ada2p3 ONLINE 0 0 0\n" -" ada3p3 ONLINE 0 0 0\n" -" ada4p3 ONLINE 0 0 0\n" -" ada5p3 ONLINE 0 0 0\n" +" ada0p1 ONLINE 0 0 0\n" +" ada1p1 ONLINE 0 0 0\n" +" ada2p1 ONLINE 0 0 0\n" +" ada3p1 ONLINE 0 0 0\n" +" ada4p1 ONLINE 0 0 0\n" +" ada5p1 ONLINE 0 0 0\n" + +#. type: Plain text +#: documentation/content/en/books/handbook/zfs/_index.adoc:592 +msgid "" +"ZFS aligns and sizes its smallest writes to each vdev based on the vdev's " +"`ashift` value, the base 2 logarithm of the sector size. OpenZFS detects " +"the sector size the disks report when creating a vdev and chooses `ashift` " +"accordingly. Some drives report 512-byte sectors for compatibility while " +"using 4096-byte sectors internally. Create pools on such drives with an " +"explicit `-o ashift=12` to force 4096-byte alignment:" +msgstr "" +"ZFS выравнивает и подбирает размер своих минимальных записей для каждого " +"vdev на основе значения `ashift` этого vdev, которое является логарифмом " +"размера сектора по основанию 2. OpenZFS определяет размер сектора, " +"сообщаемый дисками при создании vdev, и выбирает `ashift` соответствующим " +"образом. Некоторые диски сообщают секторы в 512 байт для совместимости, но " +"внутренне используют секторы в 4096 байт. Создавайте пулы на таких дисках с " +"явным параметром `-o ashift=12`, чтобы принудительно установить выравнивание " +"по 4096 байт:" + +#. type: delimited block . 4 +#: documentation/content/en/books/handbook/zfs/_index.adoc:596 +#, no-wrap +msgid "# zpool create -o ashift=12 mypool mirror /dev/ada1p1 /dev/ada2p1\n" +msgstr "# zpool create -o ashift=12 mypool mirror /dev/ada1p1 /dev/ada2p1\n" + +#. type: Plain text +#: documentation/content/en/books/handbook/zfs/_index.adoc:601 +msgid "" +"Setting the man:sysctl[8] variable `vfs.zfs.vdev.min_auto_ashift` to `12` " +"gives the same result for pool creation and for later `zpool add` and `zpool " +"attach` operations. `ashift` is a property of each vdev, not of the pool as " +"a whole. It is fixed when creating the vdev and cannot change afterwards, " +"so verify it before committing data to a pool." +msgstr "" +"Установка переменной man:sysctl[8] `vfs.zfs.vdev.min_auto_ashift` в значение " +"`12` дает тот же результат для создания пула и для последующих операций `" +"zpool add` и `zpool attach`. `ashift` — это свойство каждого vdev, а не " +"пула в целом. Оно фиксируется при создании vdev и не может быть изменено " +"впоследствии, поэтому проверьте его перед записью данных в пул." #. type: Plain text -#: documentation/content/en/books/handbook/zfs/_index.adoc:594 +#: documentation/content/en/books/handbook/zfs/_index.adoc:607 msgid "" "Destroy a pool that is no longer needed to reuse the disks. Destroying a " "pool requires unmounting the file systems in that pool first. If any " "dataset is in use, the unmount operation fails without destroying the pool. " "Force the pool destruction with `-f`. This can cause undefined behavior in " "applications which had open files on those datasets." msgstr "" "Уничтожьте пул, который больше не нужен, чтобы повторно использовать диски. " "Перед уничтожением пула необходимо размонтировать файловые системы в этом " "пуле. Если какой-либо набор данных используется, операция размонтирования " "завершится неудачей без уничтожения пула. Принудительное уничтожение пула " "выполняется с помощью `-f`. Это может привести к неопределённому поведению " "приложений, у которых были открыты файлы в этих наборах данных." #. type: Title === -#: documentation/content/en/books/handbook/zfs/_index.adoc:596 +#: documentation/content/en/books/handbook/zfs/_index.adoc:609 +#, no-wrap +msgid "Pool Properties" +msgstr "Свойства пулов" + +#. type: Plain text +#: documentation/content/en/books/handbook/zfs/_index.adoc:613 +msgid "" +"Like datasets, pools have properties that report status and control " +"behavior. Display every property of a pool with `zpool get all _mypool_`, " +"or name specific properties:" +msgstr "" +"Подобно наборам данных, пулы имеют свойства, которые сообщают о состоянии и " +"управляют поведением. Отобразите каждое свойство пула с помощью `zpool get " +"all _mypool_` или укажите конкретные свойства:" + +#. type: delimited block . 4 +#: documentation/content/en/books/handbook/zfs/_index.adoc:620 +#, no-wrap +msgid "" +"# zpool get health,capacity mypool\n" +"NAME PROPERTY VALUE SOURCE\n" +"mypool health ONLINE -\n" +"mypool capacity 27% -\n" +msgstr "" +"# zpool get health,capacity mypool\n" +"NAME PROPERTY VALUE SOURCE\n" +"mypool health ONLINE -\n" +"mypool capacity 27% -\n" + +#. type: Plain text +#: documentation/content/en/books/handbook/zfs/_index.adoc:623 +msgid "Change a writable property with `zpool set`:" +msgstr "Измените изменяемое свойство с помощью `zpool set`:" + +#. type: delimited block . 4 +#: documentation/content/en/books/handbook/zfs/_index.adoc:630 +#, no-wrap +msgid "" +"# zpool set comment=\"Backup pool\" mypool\n" +"# zpool get comment mypool\n" +"NAME PROPERTY VALUE SOURCE\n" +"mypool comment Backup pool local\n" +msgstr "" +"# zpool set comment=\"Backup pool\" mypool\n" +"# zpool get comment mypool\n" +"NAME PROPERTY VALUE SOURCE\n" +"mypool comment Backup pool local\n" + +#. type: Plain text +#: documentation/content/en/books/handbook/zfs/_index.adoc:636 +msgid "" +"Properties like `size`, `capacity`, `fragmentation`, and `health` are read-" +"only status values. Others change how the pool behaves; this chapter uses " +"`autoexpand` to grow a pool automatically (crossref:zfs[zfs-zpool-online," +"Growing a Pool]), `autoreplace` with hot spares (crossref:zfs[zfs-zpool-" +"spares,Hot Spares and Automatic Replacement with zfsd]), `autotrim` on SSD " +"pools (crossref:zfs[zfs-zpool-trim,TRIM and Initialization]), and " +"`compatibility` for portable pools (crossref:zfs[zfs-zpool-upgrade,Upgrading " +"a Storage Pool]). Set properties at pool creation time by passing `-o` to " +"`zpool create`, as shown with `ashift` above. man:zpoolprops[7] describes " +"every pool property." +msgstr "" +"Такие свойства, как `size`, `capacity`, `fragmentation` и `health`, являются " +"статусными значениями только для чтения. Другие изменяют поведение пула; в " +"этой главе используется `autoexpand` для автоматического расширения пула " +"(crossref:zfs[zfs-zpool-online,Увеличение размера пула]), `autoreplace` с " +"горячими резервными дисками (crossref:zfs[zfs-zpool-spares,Горячие резервные " +"диски и автоматическая замена с помощью zfsd]), `autotrim` на пулах с SSD " +"(crossref:zfs[zfs-zpool-trim,TRIM and Initialization]) и `compatibility` для " +"переносимых пулов (crossref:zfs[zfs-zpool-upgrade,Обновление пула дисков]). " +"Устанавливайте свойства при создании пула, передавая `-o` команде `zpool " +"create`, как показано выше с `ashift`. man:zpoolprops[7] описывает все " +"свойства пула." + +#. type: Title === +#: documentation/content/en/books/handbook/zfs/_index.adoc:638 #, no-wrap msgid "Adding and Removing Devices" msgstr "Добавление и удаление устройств" #. type: Plain text -#: documentation/content/en/books/handbook/zfs/_index.adoc:600 +#: documentation/content/en/books/handbook/zfs/_index.adoc:643 msgid "" "Two ways exist for adding disks to a pool: attaching a disk to an existing " "vdev with `zpool attach`, or adding vdevs to the pool with `zpool add`. " "Some crossref:zfs[zfs-term-vdev,vdev types] allow adding disks to the vdev " -"after creation." +"after creation. RAID-Z vdevs accept new disks only through crossref:zfs[zfs-" +"zpool-raidz-expansion,RAID-Z expansion]." msgstr "" "Существует два способа добавления дисков в пул: подключение диска к " "существующему vdev с помощью `zpool attach` или добавление vdev в пул с " "помощью `zpool add`. Некоторые crossref:zfs[zfs-term-vdev,типы vdev] " -"позволяют добавлять диски в vdev после его создания." +"позволяют добавлять диски в vdev после его создания. Виртуальные устройства " +"(vdev) RAID-Z принимают новые диски исключительно посредством crossref:zfs" +"[zfs-zpool-raidz-expansion,расширения RAID-Z]." #. type: Plain text -#: documentation/content/en/books/handbook/zfs/_index.adoc:609 +#: documentation/content/en/books/handbook/zfs/_index.adoc:652 msgid "" "A pool created with a single disk lacks redundancy. It can detect " "corruption but can not repair it, because there is no other copy of the " "data. The crossref:zfs[zfs-term-copies,copies] property may be able to " "recover from a small failure such as a bad sector, but does not provide the " "same level of protection as mirroring or RAID-Z. Starting with a pool " "consisting of a single disk vdev, use `zpool attach` to add a new disk to " "the vdev, creating a mirror. Also use `zpool attach` to add new disks to a " "mirror group, increasing redundancy and read performance. When partitioning " "the disks used for the pool, replicate the layout of the first disk on to " "the second. Use `gpart backup` and `gpart restore` to make this process " "easier." msgstr "" "Пул, созданный с одним диском, не обладает избыточностью. Он может " "обнаружить повреждение данных, но не может его исправить, так как нет другой " "копии данных. Свойство crossref:zfs[zfs-term-copies,Копии (copies)] может " "восстановить данные после небольшого сбоя, например, повреждённого сектора, " "но не обеспечивает такой же уровень защиты, как зеркалирование или RAID-Z. " "Начиная с пула, состоящего из однодискового vdev, используйте `zpool attach` " "для добавления нового диска в vdev, создавая зеркало. Также используйте " "`zpool attach` для добавления новых дисков в зеркальную группу, увеличивая " "избыточность и производительность чтения. При разметке дисков, используемых " "для пула, повторите разметку первого диска на втором. Используйте `gpart " "backup` и `gpart restore` для упрощения этого процесса." #. type: Plain text -#: documentation/content/en/books/handbook/zfs/_index.adoc:611 +#: documentation/content/en/books/handbook/zfs/_index.adoc:654 msgid "" "Upgrade the single disk (stripe) vdev [.filename]#ada0p3# to a mirror by " "attaching [.filename]#ada1p3#:" msgstr "" "Обновите однодисковый vdev (stripe) [.filename]#ada0p3# до зеркала, " "присоединив [.filename]#ada1p3#:" #. type: delimited block . 4 -#: documentation/content/en/books/handbook/zfs/_index.adoc:619 -#: documentation/content/en/books/handbook/zfs/_index.adoc:816 +#: documentation/content/en/books/handbook/zfs/_index.adoc:661 +#: documentation/content/en/books/handbook/zfs/_index.adoc:1087 #, no-wrap msgid "" "# zpool status\n" " pool: mypool\n" " state: ONLINE\n" -" scan: none requested\n" "config:\n" msgstr "" "# zpool status\n" " pool: mypool\n" " state: ONLINE\n" -" scan: none requested\n" "config:\n" #. type: delimited block . 4 -#: documentation/content/en/books/handbook/zfs/_index.adoc:623 +#: documentation/content/en/books/handbook/zfs/_index.adoc:665 #, no-wrap msgid "" " NAME STATE READ WRITE CKSUM\n" " mypool ONLINE 0 0 0\n" " ada0p3 ONLINE 0 0 0\n" msgstr "" " NAME STATE READ WRITE CKSUM\n" " mypool ONLINE 0 0 0\n" " ada0p3 ONLINE 0 0 0\n" #. type: delimited block . 4 -#: documentation/content/en/books/handbook/zfs/_index.adoc:627 +#: documentation/content/en/books/handbook/zfs/_index.adoc:682 #, no-wrap msgid "" "errors: No known data errors\n" "# zpool attach mypool ada0p3 ada1p3\n" -"Make sure to wait until resilvering finishes before rebooting.\n" -msgstr "" -"errors: No known data errors\n" -"# zpool attach mypool ada0p3 ada1p3\n" -"Make sure to wait until resilvering finishes before rebooting.\n" - -#. type: delimited block . 4 -#: documentation/content/en/books/handbook/zfs/_index.adoc:629 -#, no-wrap -msgid "If you boot from pool 'mypool', you may need to update boot code on newly attached disk _ada1p3_.\n" -msgstr "If you boot from pool 'mypool', you may need to update boot code on newly attached disk _ada1p3_.\n" - -#. type: delimited block . 4 -#: documentation/content/en/books/handbook/zfs/_index.adoc:631 -#, no-wrap -msgid "Assuming you use GPT partitioning and _da0_ is your new boot disk you may use the following command:\n" -msgstr "Assuming you use GPT partitioning and _da0_ is your new boot disk you may use the following command:\n" - -#. type: delimited block . 4 -#: documentation/content/en/books/handbook/zfs/_index.adoc:645 -#, no-wrap -msgid "" -" gpart bootcode -b /boot/pmbr -p /boot/gptzfsboot -i 1 da0\n" +"Make sure to wait until resilver is done before rebooting.\n" "# gpart bootcode -b /boot/pmbr -p /boot/gptzfsboot -i 1 ada1\n" +"partcode written to ada1p1\n" "bootcode written to ada1\n" "# zpool status\n" " pool: mypool\n" " state: ONLINE\n" "status: One or more devices is currently being resilvered. The pool will\n" " continue to function, possibly in a degraded state.\n" "action: Wait for the resilver to complete.\n" -" scan: resilver in progress since Fri May 30 08:19:19 2014\n" -" 527M scanned out of 781M at 47.9M/s, 0h0m to go\n" -" 527M resilvered, 67.53% done\n" +" scan: resilver in progress since Sat Jul 11 11:15:25 2026\n" +" 738M scanned at 105M/s, 522M issued at 74.6M/s, 781M total\n" +" 522M resilvered, 66.84% done, 00:00:03 to go\n" "config:\n" msgstr "" -" gpart bootcode -b /boot/pmbr -p /boot/gptzfsboot -i 1 da0\n" +"errors: No known data errors\n" +"# zpool attach mypool ada0p3 ada1p3\n" +"Make sure to wait until resilver is done before rebooting.\n" "# gpart bootcode -b /boot/pmbr -p /boot/gptzfsboot -i 1 ada1\n" +"partcode written to ada1p1\n" "bootcode written to ada1\n" "# zpool status\n" " pool: mypool\n" " state: ONLINE\n" "status: One or more devices is currently being resilvered. The pool will\n" " continue to function, possibly in a degraded state.\n" "action: Wait for the resilver to complete.\n" -" scan: resilver in progress since Fri May 30 08:19:19 2014\n" -" 527M scanned out of 781M at 47.9M/s, 0h0m to go\n" -" 527M resilvered, 67.53% done\n" +" scan: resilver in progress since Sat Jul 11 11:15:25 2026\n" +" 738M scanned at 105M/s, 522M issued at 74.6M/s, 781M total\n" +" 522M resilvered, 66.84% done, 00:00:03 to go\n" "config:\n" #. type: delimited block . 4 -#: documentation/content/en/books/handbook/zfs/_index.adoc:651 +#: documentation/content/en/books/handbook/zfs/_index.adoc:688 #, no-wrap msgid "" " NAME STATE READ WRITE CKSUM\n" " mypool ONLINE 0 0 0\n" " mirror-0 ONLINE 0 0 0\n" " ada0p3 ONLINE 0 0 0\n" " ada1p3 ONLINE 0 0 0 (resilvering)\n" msgstr "" " NAME STATE READ WRITE CKSUM\n" " mypool ONLINE 0 0 0\n" " mirror-0 ONLINE 0 0 0\n" " ada0p3 ONLINE 0 0 0\n" " ada1p3 ONLINE 0 0 0 (resilvering)\n" #. type: delimited block . 4 -#: documentation/content/en/books/handbook/zfs/_index.adoc:658 +#: documentation/content/en/books/handbook/zfs/_index.adoc:695 #, no-wrap msgid "" "errors: No known data errors\n" "# zpool status\n" " pool: mypool\n" " state: ONLINE\n" -" scan: resilvered 781M in 0h0m with 0 errors on Fri May 30 08:15:58 2014\n" +" scan: resilvered 781M in 00:00:16 with 0 errors on Sat Jul 11 11:18:36 2026\n" "config:\n" msgstr "" "errors: No known data errors\n" "# zpool status\n" " pool: mypool\n" " state: ONLINE\n" -" scan: resilvered 781M in 0h0m with 0 errors on Fri May 30 08:15:58 2014\n" +" scan: resilvered 781M in 00:00:16 with 0 errors on Sat Jul 11 11:18:36 " +"2026\n" "config:\n" #. type: delimited block . 4 -#: documentation/content/en/books/handbook/zfs/_index.adoc:664 -#: documentation/content/en/books/handbook/zfs/_index.adoc:697 -#: documentation/content/en/books/handbook/zfs/_index.adoc:755 -#: documentation/content/en/books/handbook/zfs/_index.adoc:822 +#: documentation/content/en/books/handbook/zfs/_index.adoc:701 +#: documentation/content/en/books/handbook/zfs/_index.adoc:734 +#: documentation/content/en/books/handbook/zfs/_index.adoc:831 +#: documentation/content/en/books/handbook/zfs/_index.adoc:1093 #, no-wrap msgid "" " NAME STATE READ WRITE CKSUM\n" " mypool ONLINE 0 0 0\n" " mirror-0 ONLINE 0 0 0\n" " ada0p3 ONLINE 0 0 0\n" " ada1p3 ONLINE 0 0 0\n" msgstr "" " NAME STATE READ WRITE CKSUM\n" " mypool ONLINE 0 0 0\n" " mirror-0 ONLINE 0 0 0\n" " ada0p3 ONLINE 0 0 0\n" " ada1p3 ONLINE 0 0 0\n" #. type: Plain text -#: documentation/content/en/books/handbook/zfs/_index.adoc:674 +#: documentation/content/en/books/handbook/zfs/_index.adoc:711 msgid "" -"When adding disks to the existing vdev is not an option, as for RAID-Z, an " -"alternative method is to add another vdev to the pool. Adding vdevs " -"provides higher performance by distributing writes across the vdevs. Each " -"vdev provides its own redundancy. Mixing vdev types like `mirror` and `RAID-" -"Z` is possible but discouraged. Adding a non-redundant vdev to a pool " -"containing mirror or RAID-Z vdevs risks the data on the entire pool. " -"Distributing writes means a failure of the non-redundant disk will result in " -"the loss of a fraction of every block written to the pool." +"When adding disks to the existing vdev is not an option, an alternative " +"method is to add another vdev to the pool. Adding vdevs provides higher " +"performance by distributing writes across the vdevs. Each vdev provides its " +"own redundancy. Mixing vdev types like `mirror` and `RAID-Z` is possible " +"but discouraged. Adding a non-redundant vdev to a pool containing mirror or " +"RAID-Z vdevs risks the data on the entire pool. Distributing writes means a " +"failure of the non-redundant disk will result in the loss of a fraction of " +"every block written to the pool." msgstr "" -"Если добавление дисков к существующему vdev невозможно, как в случае с RAID-" -"Z, альтернативным методом является добавление другого vdev в пул. Добавление " -"vdev повышает производительность за счет распределения записей между vdev. " -"Каждый vdev обеспечивает свою собственную избыточность. Возможно смешивание " -"типов vdev, таких как `mirror` и `RAID-Z`, но это не рекомендуется. " -"Добавление не избыточного vdev к пулу, содержащему mirror или RAID-Z vdev, " -"подвергает риску данные во всем пуле. Распределение записей означает, что " -"отказ не избыточного диска приведет к потере части каждого блока, " -"записанного в пул." +"Если добавление дисков к существующему vdev невозможно, альтернативным " +"методом является добавление другого vdev в пул. Добавление vdev повышает " +"производительность за счет распределения записей между vdev. Каждый vdev " +"обеспечивает свою собственную избыточность. Возможно смешивание типов vdev, " +"таких как `mirror` и `RAID-Z`, но это не рекомендуется. Добавление не " +"избыточного vdev к пулу, содержащему mirror или RAID-Z vdev, подвергает " +"риску данные во всем пуле. Распределение записей означает, что отказ не " +"избыточного диска приведет к потере части каждого блока, записанного в пул." #. type: Plain text -#: documentation/content/en/books/handbook/zfs/_index.adoc:679 +#: documentation/content/en/books/handbook/zfs/_index.adoc:716 msgid "" "ZFS stripes data across each of the vdevs. For example, with two mirror " "vdevs, this is effectively a RAID 10 that stripes writes across two sets of " "mirrors. ZFS allocates space so that each vdev reaches 100% full at the " "same time. Having vdevs with different amounts of free space will lower " "performance, as more data writes go to the less full vdev." msgstr "" "ZFS распределяет данные по всем vdev. Например, при использовании двух " "зеркальных vdev это фактически эквивалентно RAID 10, где записи " "распределяются по двум наборам зеркал. ZFS выделяет пространство таким " "образом, что каждый vdev достигает 100% заполненности одновременно. Наличие " "vdev с разным количеством свободного места снижает производительность, так " "как больше данных записывается на менее заполненный vdev." #. type: Plain text -#: documentation/content/en/books/handbook/zfs/_index.adoc:681 +#: documentation/content/en/books/handbook/zfs/_index.adoc:718 msgid "" "When attaching new devices to a boot pool, remember to update the bootcode." msgstr "" "При подключении новых устройств к загрузочному пулу не забудьте обновить " "загрузочный код." #. type: Plain text -#: documentation/content/en/books/handbook/zfs/_index.adoc:683 +#: documentation/content/en/books/handbook/zfs/_index.adoc:720 msgid "" "Attach a second mirror group ([.filename]#ada2p3# and [.filename]#ada3p3#) " "to the existing mirror:" msgstr "" "Присоедините вторую группу зеркал ([.filename]#ada2p3# и [." "filename]#ada3p3#) к существующему зеркалу:" #. type: delimited block . 4 -#: documentation/content/en/books/handbook/zfs/_index.adoc:691 +#: documentation/content/en/books/handbook/zfs/_index.adoc:728 #, no-wrap msgid "" "# zpool status\n" " pool: mypool\n" " state: ONLINE\n" -" scan: resilvered 781M in 0h0m with 0 errors on Fri May 30 08:19:35 2014\n" +" scan: resilvered 781M in 00:00:16 with 0 errors on Sat Jul 11 12:11:56 2026\n" "config:\n" msgstr "" "# zpool status\n" " pool: mypool\n" " state: ONLINE\n" -" scan: resilvered 781M in 0h0m with 0 errors on Fri May 30 08:19:35 2014\n" +" scan: resilvered 781M in 00:00:16 with 0 errors on Sat Jul 11 12:11:56 " +"2026\n" "config:\n" #. type: delimited block . 4 -#: documentation/content/en/books/handbook/zfs/_index.adoc:709 +#: documentation/content/en/books/handbook/zfs/_index.adoc:748 #, no-wrap msgid "" "errors: No known data errors\n" "# zpool add mypool mirror ada2p3 ada3p3\n" "# gpart bootcode -b /boot/pmbr -p /boot/gptzfsboot -i 1 ada2\n" +"partcode written to ada2p1\n" "bootcode written to ada2\n" "# gpart bootcode -b /boot/pmbr -p /boot/gptzfsboot -i 1 ada3\n" +"partcode written to ada3p1\n" "bootcode written to ada3\n" "# zpool status\n" " pool: mypool\n" " state: ONLINE\n" -" scan: scrub repaired 0 in 0h0m with 0 errors on Fri May 30 08:29:51 2014\n" +" scan: resilvered 781M in 00:00:16 with 0 errors on Sat Jul 11 09:58:28 2026\n" "config:\n" msgstr "" "errors: No known data errors\n" "# zpool add mypool mirror ada2p3 ada3p3\n" "# gpart bootcode -b /boot/pmbr -p /boot/gptzfsboot -i 1 ada2\n" +"partcode written to ada2p1\n" "bootcode written to ada2\n" "# gpart bootcode -b /boot/pmbr -p /boot/gptzfsboot -i 1 ada3\n" +"partcode written to ada3p1\n" "bootcode written to ada3\n" "# zpool status\n" " pool: mypool\n" " state: ONLINE\n" -" scan: scrub repaired 0 in 0h0m with 0 errors on Fri May 30 08:29:51 2014\n" +" scan: resilvered 781M in 00:00:16 with 0 errors on Sat Jul 11 09:58:28 " +"2026\n" "config:\n" #. type: delimited block . 4 -#: documentation/content/en/books/handbook/zfs/_index.adoc:718 +#: documentation/content/en/books/handbook/zfs/_index.adoc:757 +#: documentation/content/en/books/handbook/zfs/_index.adoc:864 +#, no-wrap +msgid "" +" NAME STATE READ WRITE CKSUM\n" +" mypool ONLINE 0 0 0\n" +" mirror-0 ONLINE 0 0 0\n" +" ada0p3 ONLINE 0 0 0\n" +" ada1p3 ONLINE 0 0 0\n" +" mirror-1 ONLINE 0 0 0\n" +" ada2p3 ONLINE 0 0 0\n" +" ada3p3 ONLINE 0 0 0\n" +msgstr "" +" NAME STATE READ WRITE CKSUM\n" +" mypool ONLINE 0 0 0\n" +" mirror-0 ONLINE 0 0 0\n" +" ada0p3 ONLINE 0 0 0\n" +" ada1p3 ONLINE 0 0 0\n" +" mirror-1 ONLINE 0 0 0\n" +" ada2p3 ONLINE 0 0 0\n" +" ada3p3 ONLINE 0 0 0\n" + +#. type: Plain text +#: documentation/content/en/books/handbook/zfs/_index.adoc:767 +msgid "" +"`zpool add` also attaches dedicated log and cache devices to an existing " +"pool. A crossref:zfs[zfs-term-vdev-log,log] vdev stores the ZFS intent log " +"on separate low-latency storage, accelerating synchronous writes such as " +"those issued by databases and NFS. Mirror log devices, because losing an " +"unmirrored log device together with a system crash costs the pool the last " +"few seconds of synchronous writes; see crossref:zfs[zfs-advanced-zil-slog," +"\"Synchronous Writes, the ZIL, and SLOG\"] for sizing and tuning guidance. " +"A crossref:zfs[zfs-term-vdev-cache,cache] vdev extends the crossref:zfs[zfs-" +"term-arc,ARC] with a second level of read cache on fast storage. Cache " +"devices need no redundancy, as ZFS reads any block that fails to read from " +"the cache from the original pool disks instead. The contents of the cache, " +"the crossref:zfs[zfs-term-l2arc,L2ARC], survive reboots by default." +msgstr "" +"`zpool add` также присоединяет выделенные устройства журнала и кэша к " +"существующему пулу. crossref:zfs[zfs-term-vdev-log,Журнал] vdev хранит " +"журнал намерений ZFS на отдельном хранилище с низкой задержкой, ускоряя " +"синхронные записи, такие как те, что выполняются базами данных и NFS. " +"Зеркалируйте устройства журнала, потому что потеря незеркалированного " +"устройства журнала вместе с сбоем системы стоит пулу последних нескольких " +"секунд синхронных записей; см. раздел crossref:zfs[zfs-advanced-zil-slog," +"\"Синхронные записи, ZIL и SLOG\"] для рекомендаций по размеру и настройке. " +"crossref:zfs[zfs-term-vdev-cache,Кэш] vdev расширяет crossref:zfs[zfs-term-" +"arc,ARC] вторым уровнем кэша чтения на быстром хранилище. Устройства кэша не " +"требуют избыточности, так как ZFS вместо этого читает любой блок, который не " +"удалось прочитать из кэша, с исходных дисков пула. Содержимое кэша, " +"crossref:zfs[zfs-term-l2arc,L2ARC], по умолчанию сохраняется после " +"перезагрузки." + +#. type: Plain text +#: documentation/content/en/books/handbook/zfs/_index.adoc:769 +msgid "Add a mirrored log vdev and an NVMe cache device to an existing pool:" +msgstr "" +"Добавьте зеркальный журнальный vdev и NVMe-устройство кэша к существующему " +"пулу:" + +#. type: delimited block . 4 +#: documentation/content/en/books/handbook/zfs/_index.adoc:779 +#, no-wrap +msgid "" +"# zpool add mypool log mirror ada4p2 ada5p2\n" +"# zpool add mypool cache nda0p2\n" +"# zpool status mypool\n" +" pool: mypool\n" +" state: ONLINE\n" +" scan: resilvered 781M in 00:00:16 with 0 errors on Sat Jul 11 09:58:28 2026\n" +"config:\n" +msgstr "" +"# zpool add mypool log mirror ada4p2 ada5p2\n" +"# zpool add mypool cache nda0p2\n" +"# zpool status mypool\n" +" pool: mypool\n" +" state: ONLINE\n" +" scan: resilvered 781M in 00:00:16 with 0 errors on Sat Jul 11 09:58:28 " +"2026\n" +"config:\n" + +#. type: delimited block . 4 +#: documentation/content/en/books/handbook/zfs/_index.adoc:794 #, no-wrap msgid "" " NAME STATE READ WRITE CKSUM\n" " mypool ONLINE 0 0 0\n" " mirror-0 ONLINE 0 0 0\n" " ada0p3 ONLINE 0 0 0\n" " ada1p3 ONLINE 0 0 0\n" " mirror-1 ONLINE 0 0 0\n" " ada2p3 ONLINE 0 0 0\n" " ada3p3 ONLINE 0 0 0\n" +" logs\n" +" mirror-2 ONLINE 0 0 0\n" +" ada4p2 ONLINE 0 0 0\n" +" ada5p2 ONLINE 0 0 0\n" +" cache\n" +" nda0p2 ONLINE 0 0 0\n" msgstr "" " NAME STATE READ WRITE CKSUM\n" " mypool ONLINE 0 0 0\n" " mirror-0 ONLINE 0 0 0\n" " ada0p3 ONLINE 0 0 0\n" " ada1p3 ONLINE 0 0 0\n" " mirror-1 ONLINE 0 0 0\n" " ada2p3 ONLINE 0 0 0\n" " ada3p3 ONLINE 0 0 0\n" +" logs\n" +" mirror-2 ONLINE 0 0 0\n" +" ada4p2 ONLINE 0 0 0\n" +" ada5p2 ONLINE 0 0 0\n" +" cache\n" +" nda0p2 ONLINE 0 0 0\n" #. type: Plain text -#: documentation/content/en/books/handbook/zfs/_index.adoc:724 +#: documentation/content/en/books/handbook/zfs/_index.adoc:800 msgid "" -"Removing vdevs from a pool is impossible and removal of disks from a mirror " -"is exclusive if there is enough remaining redundancy. If a single disk " -"remains in a mirror group, that group ceases to be a mirror and becomes a " -"stripe, risking the entire pool if that remaining disk fails." +"`zpool detach` removes single disks from a mirror vdev when enough " +"redundancy remains. If a single disk remains in a mirror group, that group " +"ceases to be a mirror and becomes a stripe, risking the entire pool if that " +"remaining disk fails." msgstr "" -"Удаление устройств vdev из пула невозможно, а удаление дисков из зеркала " -"возможно только при сохранении достаточной избыточности. Если в группе " -"зеркала остаётся единственный диск, эта группа перестает быть зеркалом и " -"становится страйпом, что подвергает весь пул риску в случае выхода из строя " -"оставшегося диска." +"Команда `zpool detach` удаляет отдельные диски из зеркального виртуального " +"устройства (vdev) при условии сохранения достаточной избыточности. Если в " +"группе зеркала остаётся единственный диск, эта группа перестает быть " +"зеркалом и становится страйпом, что подвергает весь пул риску в случае " +"выхода из строя оставшегося диска." #. type: Plain text -#: documentation/content/en/books/handbook/zfs/_index.adoc:726 +#: documentation/content/en/books/handbook/zfs/_index.adoc:802 msgid "Remove a disk from a three-way mirror group:" msgstr "Удалить диск из трёхдисковой зеркальной группы:" #. type: delimited block . 4 -#: documentation/content/en/books/handbook/zfs/_index.adoc:734 +#: documentation/content/en/books/handbook/zfs/_index.adoc:810 #, no-wrap msgid "" "# zpool status\n" " pool: mypool\n" " state: ONLINE\n" -" scan: scrub repaired 0 in 0h0m with 0 errors on Fri May 30 08:29:51 2014\n" +" scan: scrub repaired 0B in 00:01:11 with 0 errors on Sat Jul 11 03:14:02 2026\n" "config:\n" msgstr "" "# zpool status\n" " pool: mypool\n" " state: ONLINE\n" -" scan: scrub repaired 0 in 0h0m with 0 errors on Fri May 30 08:29:51 2014\n" +" scan: scrub repaired 0B in 00:01:11 with 0 errors on Sat Jul 11 03:14:02 " +"2026\n" "config:\n" #. type: delimited block . 4 -#: documentation/content/en/books/handbook/zfs/_index.adoc:741 +#: documentation/content/en/books/handbook/zfs/_index.adoc:817 #, no-wrap msgid "" " NAME STATE READ WRITE CKSUM\n" " mypool ONLINE 0 0 0\n" " mirror-0 ONLINE 0 0 0\n" " ada0p3 ONLINE 0 0 0\n" " ada1p3 ONLINE 0 0 0\n" " ada2p3 ONLINE 0 0 0\n" msgstr "" " NAME STATE READ WRITE CKSUM\n" " mypool ONLINE 0 0 0\n" " mirror-0 ONLINE 0 0 0\n" " ada0p3 ONLINE 0 0 0\n" " ada1p3 ONLINE 0 0 0\n" " ada2p3 ONLINE 0 0 0\n" #. type: delimited block . 4 -#: documentation/content/en/books/handbook/zfs/_index.adoc:749 +#: documentation/content/en/books/handbook/zfs/_index.adoc:825 #, no-wrap msgid "" "errors: No known data errors\n" "# zpool detach mypool ada2p3\n" "# zpool status\n" " pool: mypool\n" " state: ONLINE\n" -" scan: scrub repaired 0 in 0h0m with 0 errors on Fri May 30 08:29:51 2014\n" +" scan: scrub repaired 0B in 00:01:11 with 0 errors on Sat Jul 11 03:14:02 2026\n" "config:\n" msgstr "" "errors: No known data errors\n" "# zpool detach mypool ada2p3\n" "# zpool status\n" " pool: mypool\n" " state: ONLINE\n" -" scan: scrub repaired 0 in 0h0m with 0 errors on Fri May 30 08:29:51 2014\n" +" scan: scrub repaired 0B in 00:01:11 with 0 errors on Sat Jul 11 03:14:02 " +"2026\n" "config:\n" -#. type: Title === -#: documentation/content/en/books/handbook/zfs/_index.adoc:760 -#, no-wrap -msgid "Checking the Status of a Pool" -msgstr "Проверка состояния пула" +#. type: Plain text +#: documentation/content/en/books/handbook/zfs/_index.adoc:842 +msgid "" +"`zpool remove` removes entire top-level vdevs from a pool. ZFS evacuates " +"the vdev by copying all of its allocated data to the other vdevs in the " +"pool, then detaches the disks. Removal works for hot spares, cache, log, " +"special, and dedup devices, and for data vdevs that are single disks or " +"mirrors. Data vdevs are not removable from pools that contain a top-level " +"RAID-Z vdev, and all top-level vdevs in the pool must use the same " +"`ashift`. The evacuation runs in the background and the pool stays online " +"throughout; monitor progress with `zpool status`. After the removal " +"completes, ZFS keeps an in-memory table mapping the blocks of the removed " +"vdev to their new locations. The table is small but permanent; `zpool " +"remove -n` estimates its memory use before starting a removal." +msgstr "" +"`zpool remove` удаляет целые vdev верхнего уровня из пула. ZFS эвакуирует " +"vdev, копируя все выделенные ему данные на другие vdev в пуле, а затем " +"отсоединяет диски. Удаление работает для горячих резервов, кэша, журналов, " +"специальных и дедупликационных устройств, а также для data vdev, которые " +"являются одиночными дисками или зеркалами. Data vdev не могут быть удалены " +"из пулов, содержащих vdev RAID-Z верхнего уровня, и все vdev верхнего уровня " +"в пуле должны использовать одинаковый `ashift`. Эвакуация выполняется в " +"фоновом режиме, и пул остается онлайн на протяжении всего процесса; следите " +"за прогрессом с помощью `zpool status`. После завершения удаления ZFS " +"сохраняет таблицу в памяти, сопоставляющую блоки удаленного vdev с их новыми " +"местоположениями. Таблица небольшая, но постоянная; `zpool remove -n` " +"оценивает использование памяти перед началом удаления." #. type: Plain text -#: documentation/content/en/books/handbook/zfs/_index.adoc:766 +#: documentation/content/en/books/handbook/zfs/_index.adoc:844 +msgid "Remove one of the two mirror vdevs from a pool:" +msgstr "Удалите один из двух зеркальных vdev из пула:" + +#. type: delimited block . 4 +#: documentation/content/en/books/handbook/zfs/_index.adoc:855 +#, no-wrap msgid "" -"Pool status is important. If a drive goes offline or ZFS detects a read, " -"write, or checksum error, the corresponding error count increases. The " -"`status` output shows the configuration and status of each device in the " -"pool and the status of the entire pool. Actions to take and details about " -"the last crossref:zfs[zfs-zpool-scrub,`scrub`] are also shown." +"# zpool remove mypool mirror-1\n" +"# zpool status mypool\n" +" pool: mypool\n" +" state: ONLINE\n" +" scan: scrub repaired 0B in 00:01:11 with 0 errors on Sat Jul 11 03:14:02 2026\n" +"remove: Evacuation of mirror in progress since Sat Jul 11 10:15:31 2026\n" +" 1.71G copied out of 2.32G at 111M/s, 73.71% done, 0h0m to go\n" +"config:\n" msgstr "" -"Статус пула важен. Если диск отключается или ZFS обнаруживает ошибку чтения, " -"записи или контрольной суммы, соответствующий счетчик ошибок увеличивается. " -"Вывод команды `status` показывает конфигурацию и состояние каждого " -"устройства в пуле, а также состояние всего пула. Также отображаются " -"действия, которые следует предпринять, и детали последнего crossref:zfs[zfs-" -"zpool-scrub,`scrub`]." +"# zpool remove mypool mirror-1\n" +"# zpool status mypool\n" +" pool: mypool\n" +" state: ONLINE\n" +" scan: scrub repaired 0B in 00:01:11 with 0 errors on Sat Jul 11 03:14:02 " +"2026\n" +"remove: Evacuation of mirror in progress since Sat Jul 11 10:15:31 2026\n" +" 1.71G copied out of 2.32G at 111M/s, 73.71% done, 0h0m to go\n" +"config:\n" #. type: delimited block . 4 -#: documentation/content/en/books/handbook/zfs/_index.adoc:774 +#: documentation/content/en/books/handbook/zfs/_index.adoc:873 #, no-wrap msgid "" -"# zpool status\n" +"errors: No known data errors\n" +"# zpool status mypool\n" " pool: mypool\n" " state: ONLINE\n" -" scan: scrub repaired 0 in 2h25m with 0 errors on Sat Sep 14 04:25:50 2013\n" +" scan: scrub repaired 0B in 00:01:11 with 0 errors on Sat Jul 11 03:14:02 2026\n" +"remove: Removal of vdev 1 copied 2.32G in 0h0m, completed on Sat Jul 11 10:15:53 2026\n" +" 10.9K memory used for removed device mappings\n" "config:\n" msgstr "" -"# zpool status\n" +"errors: No known data errors\n" +"# zpool status mypool\n" " pool: mypool\n" " state: ONLINE\n" -" scan: scrub repaired 0 in 2h25m with 0 errors on Sat Sep 14 04:25:50 2013\n" +" scan: scrub repaired 0B in 00:01:11 with 0 errors on Sat Jul 11 03:14:02 " +"2026\n" +"remove: Removal of vdev 1 copied 2.32G in 0h0m, completed on Sat Jul 11 " +"10:15:53 2026\n" +" 10.9K memory used for removed device mappings\n" "config:\n" -#. type: Title === -#: documentation/content/en/books/handbook/zfs/_index.adoc:789 +#. type: delimited block . 4 +#: documentation/content/en/books/handbook/zfs/_index.adoc:880 #, no-wrap -msgid "Clearing Errors" -msgstr "Сброс состояния ошибки" +msgid "" +" NAME STATE READ WRITE CKSUM\n" +" mypool ONLINE 0 0 0\n" +" mirror-0 ONLINE 0 0 0\n" +" ada0p3 ONLINE 0 0 0\n" +" ada1p3 ONLINE 0 0 0\n" +" indirect-1 ONLINE 0 0 0\n" +msgstr "" +" NAME STATE READ WRITE CKSUM\n" +" mypool ONLINE 0 0 0\n" +" mirror-0 ONLINE 0 0 0\n" +" ada0p3 ONLINE 0 0 0\n" +" ada1p3 ONLINE 0 0 0\n" +" indirect-1 ONLINE 0 0 0\n" #. type: Plain text -#: documentation/content/en/books/handbook/zfs/_index.adoc:795 +#: documentation/content/en/books/handbook/zfs/_index.adoc:886 msgid "" -"When detecting an error, ZFS increases the read, write, or checksum error " -"counts. Clear the error message and reset the counts with `zpool clear " -"_mypool_`. Clearing the error state can be important for automated scripts " -"that alert the administrator when the pool encounters an error. Without " -"clearing old errors, the scripts may fail to report further errors." +"The `indirect-1` entry is a placeholder for the removed vdev's remapped " +"blocks and contains no disks. Cancel an in-progress removal with `zpool " +"remove -s`." msgstr "" -"При обнаружении ошибки ZFS увеличивает счетчики ошибок чтения, записи или " -"контрольных сумм. Чтобы очистить сообщение об ошибке и сбросить счетчики, " -"используйте команду `zpool clear _mypool_`. Сброс состояния ошибки может " -"быть важен для автоматизированных скриптов, которые уведомляют " -"администратора при возникновении ошибки в пуле. Без очистки старых ошибок " -"скрипты могут не сообщать о новых ошибках." +"Запись `indirect-1` является заполнителем для переотображённых блоков " +"удалённого vdev и не содержит дисков. Отмените выполняющееся удаление с " +"помощью `zpool remove -s`." #. type: Title === -#: documentation/content/en/books/handbook/zfs/_index.adoc:797 +#: documentation/content/en/books/handbook/zfs/_index.adoc:888 #, no-wrap -msgid "Replacing a Functioning Device" -msgstr "Замена рабочего устройства" +msgid "RAID-Z Expansion" +msgstr "Расширение RAID-Z" #. type: Plain text -#: documentation/content/en/books/handbook/zfs/_index.adoc:806 +#: documentation/content/en/books/handbook/zfs/_index.adoc:891 msgid "" -"It may be desirable to replace one disk with a different disk. When " -"replacing a working disk, the process keeps the old disk online during the " -"replacement. The pool never enters a crossref:zfs[zfs-term-degraded," -"degraded] state, reducing the risk of data loss. Running `zpool replace` " -"copies the data from the old disk to the new one. After the operation " -"completes, ZFS disconnects the old disk from the vdev. If the new disk is " -"larger than the old disk, it may be possible to grow the zpool, using the " -"new space. See crossref:zfs[zfs-zpool-online,Growing a Pool]." +"RAID-Z expansion grows an existing RAID-Z vdev by one disk at a time, " +"without changing its parity level." msgstr "" -"Может потребоваться заменить один диск на другой. При замене рабочего диска " -"процесс сохраняет старый диск в режиме онлайн во время замены. Пул никогда " -"не переходит в состояние crossref:zfs[zfs-term-degraded,деградировавшего], " -"что снижает риск потери данных. Выполнение команды `zpool replace` копирует " -"данные со старого диска на новый. После завершения операции ZFS отключает " -"старый диск от vdev. Если новый диск больше старого, можно расширить zpool, " -"используя новое пространство. См. crossref:zfs[zfs-zpool-online,Расширение " -"пула]." - -#. type: Plain text -#: documentation/content/en/books/handbook/zfs/_index.adoc:808 -msgid "Replace a functioning device in the pool:" -msgstr "Заменить работающее устройство в пуле:" +"Расширение RAID-Z увеличивает существующий vdev RAID-Z на один диск за раз, " +"не изменяя его уровень чётности." -#. type: delimited block . 4 -#: documentation/content/en/books/handbook/zfs/_index.adoc:826 -#, no-wrap +#. type: delimited block = 4 +#: documentation/content/en/books/handbook/zfs/_index.adoc:896 msgid "" -"errors: No known data errors\n" -"# zpool replace mypool ada1p3 ada2p3\n" -"Make sure to wait until resilvering finishes before rebooting.\n" +"RAID-Z expansion requires OpenZFS 2.3 or later, first available in FreeBSD " +"15.0. Pools created on earlier releases need the `raidz_expansion` feature " +"enabled with `zpool upgrade` before expanding." msgstr "" -"errors: No known data errors\n" -"# zpool replace mypool ada1p3 ada2p3\n" -"Make sure to wait until resilvering finishes before rebooting.\n" - -#. type: delimited block . 4 -#: documentation/content/en/books/handbook/zfs/_index.adoc:828 -#, no-wrap -msgid "When booting from the pool 'zroot', update the boot code on the newly attached disk 'ada2p3'.\n" -msgstr "When booting from the pool 'zroot', update the boot code on the newly attached disk 'ada2p3'.\n" - -#. type: delimited block . 4 -#: documentation/content/en/books/handbook/zfs/_index.adoc:830 -#, no-wrap -msgid "Assuming GPT partitioning is used and [.filename]#da0# is the new boot disk, use the following command:\n" -msgstr "Assuming GPT partitioning is used and [.filename]#da0# is the new boot disk, use the following command:\n" +"Расширение RAID-Z требует OpenZFS 2.3 или более поздней версии, впервые " +"доступной в FreeBSD 15.0. Пулы, созданные в более ранних версиях, требуют " +"включения функции `raidz_expansion` с помощью `zpool upgrade` перед " +"расширением." -#. type: delimited block . 4 -#: documentation/content/en/books/handbook/zfs/_index.adoc:843 -#, no-wrap +#. type: Plain text +#: documentation/content/en/books/handbook/zfs/_index.adoc:899 msgid "" -" gpart bootcode -b /boot/pmbr -p /boot/gptzfsboot -i 1 da0\n" -"# gpart bootcode -b /boot/pmbr -p /boot/gptzfsboot -i 1 ada2\n" -"# zpool status\n" -" pool: mypool\n" -" state: ONLINE\n" -"status: One or more devices is currently being resilvered. The pool will\n" -" continue to function, possibly in a degraded state.\n" -"action: Wait for the resilver to complete.\n" -" scan: resilver in progress since Mon Jun 2 14:21:35 2014\n" -" 604M scanned out of 781M at 46.5M/s, 0h0m to go\n" -" 604M resilvered, 77.39% done\n" -"config:\n" +"To expand a RAID-Z vdev, run `zpool attach` with the name of the RAID-Z vdev " +"as shown by `zpool status` and the new disk:" msgstr "" -" gpart bootcode -b /boot/pmbr -p /boot/gptzfsboot -i 1 da0\n" -"# gpart bootcode -b /boot/pmbr -p /boot/gptzfsboot -i 1 ada2\n" -"# zpool status\n" -" pool: mypool\n" -" state: ONLINE\n" -"status: One or more devices is currently being resilvered. The pool will\n" -" continue to function, possibly in a degraded state.\n" -"action: Wait for the resilver to complete.\n" -" scan: resilver in progress since Mon Jun 2 14:21:35 2014\n" -" 604M scanned out of 781M at 46.5M/s, 0h0m to go\n" -" 604M resilvered, 77.39% done\n" -"config:\n" +"Чтобы расширить vdev RAID-Z, выполните `zpool attach`, указав имя vdev RAID-" +"Z, как показано в `zpool status`, и новый диск:" #. type: delimited block . 4 -#: documentation/content/en/books/handbook/zfs/_index.adoc:851 +#: documentation/content/en/books/handbook/zfs/_index.adoc:903 #, no-wrap +msgid "# zpool attach mypool raidz2-0 ada6p3\n" +msgstr "# zpool attach mypool raidz2-0 ada6p3\n" + +#. type: Plain text +#: documentation/content/en/books/handbook/zfs/_index.adoc:908 msgid "" -" NAME STATE READ WRITE CKSUM\n" -" mypool ONLINE 0 0 0\n" -" mirror-0 ONLINE 0 0 0\n" -" ada0p3 ONLINE 0 0 0\n" -" replacing-1 ONLINE 0 0 0\n" -" ada1p3 ONLINE 0 0 0\n" -" ada2p3 ONLINE 0 0 0 (resilvering)\n" +"The expansion reflows the existing data across the enlarged set of disks in " +"the background while the pool remains online and in use. Add `-w` to make " +"`zpool attach` wait until the expansion completes. `zpool status` reports " +"progress on the `expand:` line:" msgstr "" -" NAME STATE READ WRITE CKSUM\n" -" mypool ONLINE 0 0 0\n" -" mirror-0 ONLINE 0 0 0\n" -" ada0p3 ONLINE 0 0 0\n" -" replacing-1 ONLINE 0 0 0\n" -" ada1p3 ONLINE 0 0 0\n" -" ada2p3 ONLINE 0 0 0 (resilvering)\n" +"Расширение перераспределяет существующие данные по увеличенному набору " +"дисков в фоновом режиме, при этом пул остается online и используется. " +"Добавьте `-w`, чтобы заставить `zpool attach` ожидать завершения расширения. " +"`zpool status` сообщает о ходе выполнения в строке `expand:`:" #. type: delimited block . 4 -#: documentation/content/en/books/handbook/zfs/_index.adoc:858 +#: documentation/content/en/books/handbook/zfs/_index.adoc:918 #, no-wrap msgid "" -"errors: No known data errors\n" -"# zpool status\n" +"# zpool status mypool\n" " pool: mypool\n" " state: ONLINE\n" -" scan: resilvered 781M in 0h0m with 0 errors on Mon Jun 2 14:21:52 2014\n" +" scan: scrub repaired 0B in 06:14:36 with 0 errors on Sat Jul 11 04:31:19 2026\n" +"expand: expansion of raidz2-0 in progress since Sat Jul 11 09:42:12 2026\n" +" 1.83T / 5.36T copied at 186M/s, 34.14% done, 05:31:43 to go\n" "config:\n" msgstr "" -"errors: No known data errors\n" -"# zpool status\n" +"# zpool status mypool\n" " pool: mypool\n" " state: ONLINE\n" -" scan: resilvered 781M in 0h0m with 0 errors on Mon Jun 2 14:21:52 2014\n" +" scan: scrub repaired 0B in 06:14:36 with 0 errors on Sat Jul 11 04:31:19 " +"2026\n" +"expand: expansion of raidz2-0 in progress since Sat Jul 11 09:42:12 2026\n" +" 1.83T / 5.36T copied at 186M/s, 34.14% done, 05:31:43 to go\n" "config:\n" #. type: delimited block . 4 -#: documentation/content/en/books/handbook/zfs/_index.adoc:864 -#: documentation/content/en/books/handbook/zfs/_index.adoc:940 +#: documentation/content/en/books/handbook/zfs/_index.adoc:929 #, no-wrap msgid "" " NAME STATE READ WRITE CKSUM\n" " mypool ONLINE 0 0 0\n" -" mirror-0 ONLINE 0 0 0\n" +" raidz2-0 ONLINE 0 0 0\n" " ada0p3 ONLINE 0 0 0\n" +" ada1p3 ONLINE 0 0 0\n" " ada2p3 ONLINE 0 0 0\n" +" ada3p3 ONLINE 0 0 0\n" +" ada4p3 ONLINE 0 0 0\n" +" ada5p3 ONLINE 0 0 0\n" +" ada6p3 ONLINE 0 0 0\n" msgstr "" " NAME STATE READ WRITE CKSUM\n" " mypool ONLINE 0 0 0\n" -" mirror-0 ONLINE 0 0 0\n" +" raidz2-0 ONLINE 0 0 0\n" " ada0p3 ONLINE 0 0 0\n" +" ada1p3 ONLINE 0 0 0\n" " ada2p3 ONLINE 0 0 0\n" - -#. type: Title === -#: documentation/content/en/books/handbook/zfs/_index.adoc:869 -#, no-wrap -msgid "Dealing with Failed Devices" -msgstr "Обработка неисправных устройств" +" ada3p3 ONLINE 0 0 0\n" +" ada4p3 ONLINE 0 0 0\n" +" ada5p3 ONLINE 0 0 0\n" +" ada6p3 ONLINE 0 0 0\n" #. type: Plain text -#: documentation/content/en/books/handbook/zfs/_index.adoc:878 +#: documentation/content/en/books/handbook/zfs/_index.adoc:934 msgid "" -"When a disk in a pool fails, the vdev to which the disk belongs enters the " -"crossref:zfs[zfs-term-degraded,degraded] state. The data is still " -"available, but with reduced performance because ZFS computes missing data " -"from the available redundancy. To restore the vdev to a fully functional " -"state, replace the failed physical device. ZFS is then instructed to begin " -"the crossref:zfs[zfs-term-resilver,resilver] operation. ZFS recomputes data " -"on the failed device from available redundancy and writes it to the " -"replacement device. After completion, the vdev returns to crossref:zfs[zfs-" -"term-online,online] status." +"When the expansion finishes, the capacity of the new disk becomes available:" msgstr "" -"Когда диск в пуле выходит из строя, устройство vdev, к которому принадлежит " -"этот диск, переходит в crossref:zfs[zfs-term-degraded,деградировавшее] " -"состояние. Данные остаются доступными, но с пониженной производительностью, " -"поскольку ZFS вычисляет недостающие данные из доступной избыточности. Чтобы " -"восстановить устройство vdev в полностью работоспособное состояние, замените " -"вышедший из строя физический диск. Затем ZFS получает указание начать " -"операцию crossref:zfs[zfs-term-resilver,восстановления]. ZFS пересчитывает " -"данные с вышедшего из строя устройства из доступной избыточности и " -"записывает их на заменённый диск. После завершения процесса устройство vdev " -"возвращается в состояние crossref:zfs[zfs-term-online,онлайн]." +"Когда расширение завершается, ёмкость нового диска становится доступной:" + +#. type: delimited block . 4 +#: documentation/content/en/books/handbook/zfs/_index.adoc:939 +#, no-wrap +msgid "" +"# zpool status mypool | grep expand:\n" +"expand: expanded raidz2-0 copied 5.36T in 08:23:35, on Sat Jul 11 18:05:47 2026\n" +msgstr "" +"# zpool status mypool | grep expand:\n" +"expand: expanded raidz2-0 copied 5.36T in 08:23:35, on Sat Jul 11 18:05:47 " +"2026\n" #. type: Plain text -#: documentation/content/en/books/handbook/zfs/_index.adoc:883 +#: documentation/content/en/books/handbook/zfs/_index.adoc:944 msgid "" -"If the vdev does not have any redundancy, or if devices have failed and " -"there is not enough redundancy to compensate, the pool enters the crossref:" -"zfs[zfs-term-faulted,faulted] state. Unless enough devices can reconnect " -"the pool becomes inoperative requiring a data restore from backups." +"Blocks written before the expansion keep their old data-to-parity ratio and " +"continue to occupy space accordingly. The full capacity gain from the new " +"disk therefore applies to data written after the expansion, while old data " +"benefits only when rewritten, for example with crossref:zfs[zfs-zfs-rewrite," +"`zfs rewrite`]. Repeat the procedure to grow a vdev by several disks, " +"attaching one at a time." msgstr "" -"Если vdev не имеет избыточности или если устройства вышли из строя и " -"недостаточно избыточности для компенсации, пул переходит в состояние " -"crossref:zfs[zfs-term-faulted,faulted]. Если недостаточно устройств для " -"восстановления связи, пул становится неработоспособным, что требует " -"восстановления данных из резервных копий." +"Блоки, записанные до расширения, сохраняют прежнее соотношение данных и " +"чётности и продолжают занимать место соответствующим образом. Таким образом, " +"полный прирост ёмкости от нового диска применяется к данным, записанным " +"после расширения, тогда как старые данные выигрывают только при перезаписи, " +"например, с помощью crossref:zfs[zfs-zfs-rewrite,`zfs rewrite`]. Повторите " +"процедуру для увеличения vdev на несколько дисков, подключая их по одному." + +#. type: Title === +#: documentation/content/en/books/handbook/zfs/_index.adoc:946 +#, no-wrap +msgid "dRAID Pools" +msgstr "Пулы dRAID" #. type: Plain text -#: documentation/content/en/books/handbook/zfs/_index.adoc:886 +#: documentation/content/en/books/handbook/zfs/_index.adoc:953 msgid "" -"When replacing a failed disk, the name of the failed disk changes to the " -"GUID of the new disk. A new device name parameter for `zpool replace` is " -"not required if the replacement device has the same device name." +"dRAID is a variant of RAID-Z that distributes hot spare capacity across all " +"disks in the vdev. A crossref:zfs[zfs-term-vdev-draid,dRAID] vdev is built " +"from internal RAID-Z groups plus optional _distributed spares_, all spread " +"evenly over every disk. When a disk fails, ZFS rebuilds into the " +"distributed spare by reading from and writing to all remaining disks in " +"parallel, completing in a fraction of the time a resilver onto a single " +"spare disk takes. Replacing the failed disk then rebuilds it from the " +"distributed spare, restoring full protection. dRAID targets pools with many " +"disks, where RAID-Z rebuild times grow dangerously long." msgstr "" -"При замене вышедшего из строя диска имя отказавшего диска изменяется на GUID " -"нового диска. Новый параметр имени устройства для `zpool replace` не " -"требуется, если заменяющее устройство имеет то же имя устройства." +"dRAID — это вариант RAID-Z, который распределяет резервную емкость горячего " +"резерва по всем дискам в vdev. crossref:zfs[zfs-term-vdev-draid,dRAID] vdev " +"состоит из внутренних групп RAID-Z плюс опциональных _распределенных " +"резервов_, равномерно распределенных по каждому диску. Когда диск выходит из " +"строя, ZFS выполняет перестроение в распределенный резерв, читая и записывая " +"на все оставшиеся диски параллельно, завершая процесс за долю времени, " +"которое требуется для ресилверинга на один резервный диск. Замена вышедшего " +"из строя диска затем перестраивает его из распределенного резерва, " +"восстанавливая полную защиту. dRAID ориентирован на пулы с множеством " +"дисков, где время перестроения RAID-Z становится опасно большим." #. type: Plain text -#: documentation/content/en/books/handbook/zfs/_index.adoc:888 -msgid "Replace a failed disk using `zpool replace`:" -msgstr "Заменить вышедший из строя диск с помощью `zpool replace`:" +#: documentation/content/en/books/handbook/zfs/_index.adoc:955 +msgid "The vdev type spells out the complete layout, per man:zpoolconcepts[7]:" +msgstr "Тип vdev описывает полную компоновку, согласно man:zpoolconcepts[7]:" #. type: delimited block . 4 -#: documentation/content/en/books/handbook/zfs/_index.adoc:900 +#: documentation/content/en/books/handbook/zfs/_index.adoc:959 #, no-wrap +msgid "draid[parity][:datad][:childrenc][:sparess]\n" +msgstr "draid[parity][:datad][:childrenc][:sparess]\n" + +#. type: Plain text +#: documentation/content/en/books/handbook/zfs/_index.adoc:965 msgid "" -"# zpool status\n" -" pool: mypool\n" -" state: DEGRADED\n" -"status: One or more devices could not be opened. Sufficient replicas exist for\n" -" the pool to continue functioning in a degraded state.\n" -"action: Attach the missing device and online it using 'zpool online'.\n" -" see: http://illumos.org/msg/ZFS-8000-2Q\n" -" scan: none requested\n" -"config:\n" +"_parity_ is the parity level of the internal groups, 1 to 3, defaulting to " +"1. _data_ is the number of data devices per redundancy group, defaulting to " +"8. _children_ is the total number of disks, serving as a cross-check when " +"listing many devices. _spares_ is the number of distributed hot spares, " +"defaulting to 0." msgstr "" -"# zpool status\n" -" pool: mypool\n" -" state: DEGRADED\n" -"status: One or more devices could not be opened. Sufficient replicas exist for\n" -" the pool to continue functioning in a degraded state.\n" -"action: Attach the missing device and online it using 'zpool online'.\n" -" see: http://illumos.org/msg/ZFS-8000-2Q\n" -" scan: none requested\n" -"config:\n" +"_parity_ — это уровень чётности внутренних групп, от 1 до 3, по умолчанию 1. " +"_data_ — это количество устройств данных на группу резервирования, по " +"умолчанию 8. _children_ — это общее количество дисков, служащее перекрестной " +"проверкой при перечислении многих устройств. _spares_ — это количество " +"распределенных горячих резервов, по умолчанию 0." -#. type: delimited block . 4 -#: documentation/content/en/books/handbook/zfs/_index.adoc:906 -#, no-wrap +#. type: Plain text +#: documentation/content/en/books/handbook/zfs/_index.adoc:967 msgid "" -" NAME STATE READ WRITE CKSUM\n" -" mypool DEGRADED 0 0 0\n" -" mirror-0 DEGRADED 0 0 0\n" -" ada0p3 ONLINE 0 0 0\n" -" 316502962686821739 UNAVAIL 0 0 0 was /dev/ada1p3\n" +"Create a pool from a 24-disk dRAID vdev with double parity, 8 data disks per " +"redundancy group, and 2 distributed spares:" msgstr "" -" NAME STATE READ WRITE CKSUM\n" -" mypool DEGRADED 0 0 0\n" -" mirror-0 DEGRADED 0 0 0\n" -" ada0p3 ONLINE 0 0 0\n" -" 316502962686821739 UNAVAIL 0 0 0 was /dev/ada1p3\n" +"Создайте пул из 24-дискового vdev dRAID с двойной четностью, 8 дисками " +"данных на группу избыточности и 2 распределенными резервными дисками:" #. type: delimited block . 4 -#: documentation/content/en/books/handbook/zfs/_index.adoc:919 +#: documentation/content/en/books/handbook/zfs/_index.adoc:971 #, no-wrap +msgid "# zpool create mypool draid2:8d:24c:2s ada0 ada1 ada2 ada3 ada4 ada5 ada6 ada7 ada8 ada9 ada10 ada11 ada12 ada13 ada14 ada15 ada16 ada17 ada18 ada19 ada20 ada21 ada22 ada23\n" +msgstr "" +"# zpool create mypool draid2:8d:24c:2s ada0 ada1 ada2 ada3 ada4 ada5 ada6 " +"ada7 ada8 ada9 ada10 ada11 ada12 ada13 ada14 ada15 ada16 ada17 ada18 ada19 " +"ada20 ada21 ada22 ada23\n" + +#. type: Plain text +#: documentation/content/en/books/handbook/zfs/_index.adoc:974 msgid "" -"errors: No known data errors\n" -"# zpool replace mypool 316502962686821739 ada2p3\n" -"# zpool status\n" -" pool: mypool\n" -" state: DEGRADED\n" -"status: One or more devices is currently being resilvered. The pool will\n" -" continue to function, possibly in a degraded state.\n" -"action: Wait for the resilver to complete.\n" -" scan: resilver in progress since Mon Jun 2 14:52:21 2014\n" -" 641M scanned out of 781M at 49.3M/s, 0h0m to go\n" -" 640M resilvered, 82.04% done\n" -"config:\n" +"The distributed spares appear under `spares` in `zpool status`, with names " +"like `draid2-0-0` for the first spare of the first vdev." +msgstr "" +"Распределенные запасные диски отображаются в разделе `spares` в `zpool " +"status`, с именами вроде `draid2-0-0` для первого запасного диска первого " +"vdev." + +#. type: Plain text +#: documentation/content/en/books/handbook/zfs/_index.adoc:981 +msgid "" +"dRAID trades space efficiency for rebuild speed. Unlike RAID-Z, dRAID uses " +"a fixed stripe width, padding smaller writes with zeros. With the default " +"of 8 data disks and 4 KB sectors, the minimum allocation is 32 KB, which " +"reduces usable capacity and compression effectiveness for datasets dominated " +"by small blocks. The capacity of the distributed spares is also committed " +"up front, whether or not a disk ever fails. Pairing a dRAID pool with a " +"crossref:zfs[zfs-zpool-special,special vdev] keeps metadata and small blocks " +"off the wide stripes and recovers much of the lost efficiency. For pools " +"with a handful of disks, RAID-Z remains the better choice." +msgstr "" +"dRAID обменивает эффективность использования пространства на скорость " +"перестроения. В отличие от RAID-Z, dRAID использует фиксированную ширину " +"полосы, дополняя мелкие записи нулями. При стандартных 8 дисках данных и " +"секторах 4 КБ минимальное выделение составляет 32 КБ, что снижает полезную " +"ёмкость и эффективность сжатия для наборов данных, где преобладают мелкие " +"блоки. Ёмкость распределённых запасных дисков также резервируется заранее, " +"независимо от того, произойдёт ли сбой диска когда-либо. Объединение пула " +"dRAID со crossref:zfs[zfs-zpool-special,специальным vdev] удерживает " +"метаданные и мелкие блоки вне широких полос и возвращает большую часть " +"потерянной эффективности. Для пулов с несколькими дисками RAID-Z остаётся " +"лучшим выбором." + +#. type: Title === +#: documentation/content/en/books/handbook/zfs/_index.adoc:983 +#, no-wrap +msgid "Special Allocation Classes" +msgstr "Специальные классы выделения" + +#. type: Plain text +#: documentation/content/en/books/handbook/zfs/_index.adoc:989 +msgid "" +"Special allocation classes dedicate vdevs to specific types of pool data. A " +"crossref:zfs[zfs-term-vdev-special,special] vdev stores pool metadata such " +"as indirect blocks and dnodes, and optionally the data blocks of small " +"files. A `dedup` vdev stores the crossref:zfs[zfs-term-deduplication," +"deduplication] tables. Placing this metadata on fast devices such as NVMe " +"mirrors speeds up metadata-heavy operations like directory traversal, `zfs " +"list`, and deduplication lookups on pools of otherwise slower disks." msgstr "" -"errors: No known data errors\n" -"# zpool replace mypool 316502962686821739 ada2p3\n" -"# zpool status\n" -" pool: mypool\n" -" state: DEGRADED\n" -"status: One or more devices is currently being resilvered. The pool will\n" -" continue to function, possibly in a degraded state.\n" -"action: Wait for the resilver to complete.\n" -" scan: resilver in progress since Mon Jun 2 14:52:21 2014\n" -" 641M scanned out of 781M at 49.3M/s, 0h0m to go\n" -" 640M resilvered, 82.04% done\n" -"config:\n" +"Специальные классы выделения привязывают vdev-устройства к конкретным типам " +"данных пула. Vdev crossref:zfs[zfs-term-vdev-special,special] хранит " +"метаданные пула, такие как непрямые блоки и dnode, а также, опционально, " +"блоки данных небольших файлов. Vdev `dedup` хранит таблицы crossref:zfs[zfs-" +"term-deduplication,дедупликации]. Размещение этих метаданных на быстрых " +"устройствах, таких как зеркала NVMe, ускоряет операции, требовательные к " +"метаданным, например обход каталогов, `zfs list` и поиск при дедупликации в " +"пулах, состоящих в остальном из более медленных дисков." + +#. type: Plain text +#: documentation/content/en/books/handbook/zfs/_index.adoc:991 +msgid "Add a mirrored special vdev to an existing pool:" +msgstr "Добавьте зеркальный специальный vdev к существующему пулу:" #. type: delimited block . 4 -#: documentation/content/en/books/handbook/zfs/_index.adoc:927 +#: documentation/content/en/books/handbook/zfs/_index.adoc:995 #, no-wrap +msgid "# zpool add mypool special mirror nda0 nda1\n" +msgstr "# zpool add mypool special mirror nda0 nda1\n" + +#. type: Plain text +#: documentation/content/en/books/handbook/zfs/_index.adoc:998 msgid "" -" NAME STATE READ WRITE CKSUM\n" -" mypool DEGRADED 0 0 0\n" -" mirror-0 DEGRADED 0 0 0\n" -" ada0p3 ONLINE 0 0 0\n" -" replacing-1 UNAVAIL 0 0 0\n" -" 15732067398082357289 UNAVAIL 0 0 0 was /dev/ada1p3/old\n" -" ada2p3 ONLINE 0 0 0 (resilvering)\n" +"New metadata allocations then go to the special vdev; existing metadata " +"stays where it is until rewritten." msgstr "" -" NAME STATE READ WRITE CKSUM\n" -" mypool DEGRADED 0 0 0\n" -" mirror-0 DEGRADED 0 0 0\n" -" ada0p3 ONLINE 0 0 0\n" -" replacing-1 UNAVAIL 0 0 0\n" -" 15732067398082357289 UNAVAIL 0 0 0 was /dev/ada1p3/old\n" -" ada2p3 ONLINE 0 0 0 (resilvering)\n" +"Новые выделения метаданных затем направляются в специальный vdev; " +"существующие метаданные остаются на месте, пока не будут перезаписаны." + +#. type: Plain text +#: documentation/content/en/books/handbook/zfs/_index.adoc:1000 +msgid "" +"Setting the `special_small_blocks` dataset property makes the special vdev " +"store data blocks up to the given size as well:" +msgstr "" +"Установка свойства `special_small_blocks` набора данных позволяет " +"специальному vdev хранить блоки данных размером до указанного значения:" #. type: delimited block . 4 -#: documentation/content/en/books/handbook/zfs/_index.adoc:934 +#: documentation/content/en/books/handbook/zfs/_index.adoc:1004 #, no-wrap +msgid "# zfs set special_small_blocks=16K mypool/projects\n" +msgstr "# zfs set special_small_blocks=16K mypool/projects\n" + +#. type: Plain text +#: documentation/content/en/books/handbook/zfs/_index.adoc:1009 msgid "" -"errors: No known data errors\n" -"# zpool status\n" -" pool: mypool\n" -" state: ONLINE\n" -" scan: resilvered 781M in 0h0m with 0 errors on Mon Jun 2 14:52:38 2014\n" -"config:\n" +"Valid values are zero, which disables storing data blocks in the special " +"class, or a power of two from 512 bytes up to 1 MB on FreeBSD 14.x; FreeBSD " +"15.0 accepts values up to the maximum block size of 16 MB. Setting the " +"property to the dataset's `recordsize` sends all data blocks of that dataset " +"to the special class. When a special vdev fills up, new allocations spill " +"back to the normal class instead of failing." msgstr "" -"errors: No known data errors\n" -"# zpool status\n" -" pool: mypool\n" -" state: ONLINE\n" -" scan: resilvered 781M in 0h0m with 0 errors on Mon Jun 2 14:52:38 2014\n" -"config:\n" +"Допустимые значения — ноль, который отключает хранение блоков данных в " +"специальном классе, или степень двойки от 512 байт до 1 МБ в FreeBSD 14.x; " +"FreeBSD 15.0 принимает значения вплоть до максимального размера блока в 16 " +"МБ. Установка этого свойства на `recordsize` набора данных отправляет все " +"блоки данных этого набора данных в специальный класс. Когда специальный vdev " +"заполняется, новые выделения перетекают обратно в обычный класс вместо сбоя." + +#. type: delimited block = 4 +#: documentation/content/en/books/handbook/zfs/_index.adoc:1015 +msgid "" +"A special vdev is not a cache. It holds the only copy of the pool metadata " +"allocated to it, and losing it destroys the pool. Match the redundancy of " +"special and dedup vdevs to the redundancy of the data vdevs, for example by " +"using a mirror." +msgstr "" +"Специальный vdev — это не кэш. Он хранит единственную копию метаданных пула, " +"выделенных ему, и его потеря уничтожает пул. Согласуйте избыточность special " +"и dedup vdev с избыточностью data vdev, например, используя зеркало." + +#. type: Plain text +#: documentation/content/en/books/handbook/zfs/_index.adoc:1019 +msgid "" +"Removing a special or dedup vdev with `zpool remove` is possible, subject to " +"the restrictions described in crossref:zfs[zfs-zpool-attach,Adding and " +"Removing Devices]. In practice, the matching `ashift` requirement often " +"prevents removal when the special vdev uses devices with a different sector " +"size than the data vdevs." +msgstr "" +"Удаление специального или дедупликационного vdev с помощью `zpool remove` " +"возможно с учётом ограничений, описанных в crossref:zfs[zfs-zpool-" +"attach,Добавление и удаление устройств]. На практике требование соответствия " +"`ashift` часто препятствует удалению, когда специальный vdev использует " +"устройства с иным размером сектора, чем data vdev." #. type: Title === -#: documentation/content/en/books/handbook/zfs/_index.adoc:945 +#: documentation/content/en/books/handbook/zfs/_index.adoc:1021 #, no-wrap -msgid "Scrubbing a Pool" -msgstr "Чистка пула" +msgid "Checking the Status of a Pool" +msgstr "Проверка состояния пула" #. type: Plain text -#: documentation/content/en/books/handbook/zfs/_index.adoc:951 +#: documentation/content/en/books/handbook/zfs/_index.adoc:1027 msgid "" -"Routinely crossref:zfs[zfs-term-scrub,scrub] pools, ideally at least once " -"every month. The `scrub` operation is disk-intensive and will reduce " -"performance while running. Avoid high-demand periods when scheduling " -"`scrub` or use crossref:zfs[zfs-advanced-tuning-scrub_delay,`vfs.zfs." -"scrub_delay`] to adjust the relative priority of the `scrub` to keep it from " -"slowing down other workloads." +"Pool status is important. If a drive goes offline or ZFS detects a read, " +"write, or checksum error, the corresponding error count increases. The " +"`status` output shows the configuration and status of each device in the " +"pool and the status of the entire pool. Actions to take and details about " +"the last crossref:zfs[zfs-zpool-scrub,`scrub`] are also shown." msgstr "" -"Регулярно выполняйте crossref:zfs[zfs-term-scrub,scrub] для пулов, " -"желательно не реже одного раза в месяц. Операция `scrub` интенсивно " -"использует диски и может снизить производительность во время выполнения. " -"Избегайте периодов высокой нагрузки при планировании `scrub` или используйте " -"crossref:zfs[zfs-advanced-tuning-scrub_delay,`vfs.zfs.scrub_delay`] для " -"настройки относительного приоритета `scrub`, чтобы предотвратить замедление " -"других задач." +"Статус пула важен. Если диск отключается или ZFS обнаруживает ошибку чтения, " +"записи или контрольной суммы, соответствующий счетчик ошибок увеличивается. " +"Вывод команды `status` показывает конфигурацию и состояние каждого " +"устройства в пуле, а также состояние всего пула. Также отображаются " +"действия, которые следует предпринять, и детали последнего crossref:zfs[zfs-" +"zpool-scrub,`scrub`]." #. type: delimited block . 4 -#: documentation/content/en/books/handbook/zfs/_index.adoc:962 +#: documentation/content/en/books/handbook/zfs/_index.adoc:1035 #, no-wrap msgid "" -"# zpool scrub mypool\n" "# zpool status\n" " pool: mypool\n" " state: ONLINE\n" -" scan: scrub in progress since Wed Feb 19 20:52:54 2014\n" -" 116G scanned out of 8.60T at 649M/s, 3h48m to go\n" -" 0 repaired, 1.32% done\n" +" scan: scrub repaired 0B in 02:25:36 with 0 errors on Sat Jul 11 06:51:26 2026\n" "config:\n" msgstr "" -"# zpool scrub mypool\n" "# zpool status\n" " pool: mypool\n" " state: ONLINE\n" -" scan: scrub in progress since Wed Feb 19 20:52:54 2014\n" -" 116G scanned out of 8.60T at 649M/s, 3h48m to go\n" -" 0 repaired, 1.32% done\n" +" scan: scrub repaired 0B in 02:25:36 with 0 errors on Sat Jul 11 06:51:26 " +"2026\n" "config:\n" -#. type: Plain text -#: documentation/content/en/books/handbook/zfs/_index.adoc:977 -msgid "To cancel a scrub operation if needed, run `zpool scrub -s _mypool_`." -msgstr "" -"Если возникла необходимость отменить операцию scrub, выполните `zpool scrub -" -"s _mypool_`." - -#. type: Title === -#: documentation/content/en/books/handbook/zfs/_index.adoc:979 +#. type: delimited block . 4 +#: documentation/content/en/books/handbook/zfs/_index.adoc:1045 +#: documentation/content/en/books/handbook/zfs/_index.adoc:1341 #, no-wrap -msgid "Self-Healing" -msgstr "Самолечение" - -#. type: Plain text -#: documentation/content/en/books/handbook/zfs/_index.adoc:990 msgid "" -"The checksums stored with data blocks enable the file system to _self-" -"heal_. This feature will automatically repair data whose checksum does not " -"match the one recorded on another device that is part of the storage pool. " -"For example, a mirror configuration with two disks where one drive is " -"starting to malfunction and cannot properly store the data any more. This " -"is worse when the data was not accessed for a long time, as with long term " -"archive storage. Traditional file systems need to run commands that check " -"and repair the data like man:fsck[8]. These commands take time, and in " -"severe cases, an administrator has to decide which repair operation to " -"perform. When ZFS detects a data block with a mismatched checksum, it tries " -"to read the data from the mirror disk. If that disk can provide the correct " -"data, ZFS will give that to the application and correct the data on the disk " -"with the wrong checksum. This happens without any interaction from a system " -"administrator during normal pool operation." +" NAME STATE READ WRITE CKSUM\n" +" mypool ONLINE 0 0 0\n" +" raidz2-0 ONLINE 0 0 0\n" +" ada0p3 ONLINE 0 0 0\n" +" ada1p3 ONLINE 0 0 0\n" +" ada2p3 ONLINE 0 0 0\n" +" ada3p3 ONLINE 0 0 0\n" +" ada4p3 ONLINE 0 0 0\n" +" ada5p3 ONLINE 0 0 0\n" msgstr "" -"Контрольные суммы, хранимые с блоками данных, позволяют файловой системе " -"_самовосстанавливаться_. Эта функция автоматически исправляет данные, " -"контрольная сумма которых не совпадает с записанной на другом устройстве, " -"входящем в состав пула хранения. Например, в конфигурации зеркала с двумя " -"дисками, где один из дисков начинает работать со сбоями и больше не может " -"корректно хранить данные. Это становится ещё хуже, если данные долгое время " -"не были доступны, как в случае долгосрочного архивного хранения. " -"Традиционные файловые системы требуют выполнения команд для проверки и " -"исправления данных, таких как man:fsck[8]. Эти команды занимают время, а в " -"сложных случаях администратору приходится выбирать, какую операцию " -"восстановления выполнить. Когда ZFS обнаруживает блок данных с несовпадающей " -"контрольной суммой, он пытается прочитать данные с зеркального диска. Если " -"этот диск может предоставить корректные данные, ZFS передаст их приложению и " -"исправит данные на диске с ошибочной контрольной суммой. Это происходит без " -"какого-либо вмешательства администратора в ходе обычной работы пула." +" NAME STATE READ WRITE CKSUM\n" +" mypool ONLINE 0 0 0\n" +" raidz2-0 ONLINE 0 0 0\n" +" ada0p3 ONLINE 0 0 0\n" +" ada1p3 ONLINE 0 0 0\n" +" ada2p3 ONLINE 0 0 0\n" +" ada3p3 ONLINE 0 0 0\n" +" ada4p3 ONLINE 0 0 0\n" +" ada5p3 ONLINE 0 0 0\n" #. type: Plain text -#: documentation/content/en/books/handbook/zfs/_index.adoc:992 -msgid "" -"The next example shows this self-healing behavior by creating a mirrored " -"pool of disks [.filename]#/dev/ada0# and [.filename]#/dev/ada1#." -msgstr "" -"Следующий пример демонстрирует самовосстановление при создании зеркального " -"пула из дисков [.filename]#/dev/ada0# и [.filename]#/dev/ada1#." +#: documentation/content/en/books/handbook/zfs/_index.adoc:1050 +msgid "Options adjust the output to the task at hand:" +msgstr "Опции подстраивают вывод под конкретную задачу:" -#. type: delimited block . 4 -#: documentation/content/en/books/handbook/zfs/_index.adoc:1001 -#, no-wrap +#. type: Plain text +#: documentation/content/en/books/handbook/zfs/_index.adoc:1052 msgid "" -"# zpool create healer mirror /dev/ada0 /dev/ada1\n" -"# zpool status healer\n" -" pool: healer\n" -" state: ONLINE\n" -" scan: none requested\n" -"config:\n" +"`-v` displays verbose data error information, printing a complete list of " +"the errors found since the last complete pool scrub, including the names of " +"affected files." msgstr "" -"# zpool create healer mirror /dev/ada0 /dev/ada1\n" -"# zpool status healer\n" -" pool: healer\n" -" state: ONLINE\n" -" scan: none requested\n" -"config:\n" +"`-v` выводит подробную информацию об ошибках данных, печатая полный список " +"ошибок, обнаруженных с момента последней полной очистки пула, включая имена " +"затронутых файлов." -#. type: delimited block . 4 -#: documentation/content/en/books/handbook/zfs/_index.adoc:1007 -#: documentation/content/en/books/handbook/zfs/_index.adoc:1162 -#, no-wrap +#. type: Plain text +#: documentation/content/en/books/handbook/zfs/_index.adoc:1053 msgid "" -" NAME STATE READ WRITE CKSUM\n" -" healer ONLINE 0 0 0\n" -" mirror-0 ONLINE 0 0 0\n" -" ada0 ONLINE 0 0 0\n" -" ada1 ONLINE 0 0 0\n" +"`-x` displays the status of pools with errors or pools that are otherwise " +"unavailable, hiding healthy pools." msgstr "" -" NAME STATE READ WRITE CKSUM\n" -" healer ONLINE 0 0 0\n" -" mirror-0 ONLINE 0 0 0\n" -" ada0 ONLINE 0 0 0\n" -" ada1 ONLINE 0 0 0\n" +"`-x` отображает состояние пулов с ошибками или пулов, которые в противном " +"случае недоступны, скрывая исправные пулы." -#. type: delimited block . 4 -#: documentation/content/en/books/handbook/zfs/_index.adoc:1012 -#, no-wrap +#. type: Plain text +#: documentation/content/en/books/handbook/zfs/_index.adoc:1054 msgid "" -"errors: No known data errors\n" -"# zpool list\n" -"NAME SIZE ALLOC FREE CKPOINT EXPANDSZ FRAG CAP DEDUP HEALTH ALTROOT\n" -"healer 960M 92.5K 960M - - 0% 0% 1.00x ONLINE -\n" +"`-s` displays the number of slow I/O operations on each leaf vdev, meaning " +"operations that did not complete within 30 seconds." msgstr "" -"errors: No known data errors\n" -"# zpool list\n" -"NAME SIZE ALLOC FREE CKPOINT EXPANDSZ FRAG CAP DEDUP HEALTH ALTROOT\n" -"healer 960M 92.5K 960M - - 0% 0% 1.00x ONLINE -\n" +"`-s` отображает количество медленных операций ввода-вывода на каждом " +"конечном vdev, то есть операций, которые не завершились в течение 30 секунд." #. type: Plain text -#: documentation/content/en/books/handbook/zfs/_index.adoc:1015 +#: documentation/content/en/books/handbook/zfs/_index.adoc:1055 msgid "" -"Copy some important data to the pool to protect from data errors using the " -"self-healing feature and create a checksum of the pool for later comparison." +"`-e` displays unhealthy vdevs only, keeping the output short for pools with " +"many devices; this flag requires FreeBSD 14.1 or later." msgstr "" -"Скопируйте какие-нибудь важные данные в пул для защиты от ошибок данных с " -"использованием функции самовосстановления и создайте контрольную сумму пула " -"для последующего сравнения." +"`-e` отображает только неисправные vdev, сокращая вывод для пулов с большим " +"количеством устройств; этот флаг требует FreeBSD 14.1 или более поздней " +"версии." -#. type: delimited block . 4 -#: documentation/content/en/books/handbook/zfs/_index.adoc:1025 -#, no-wrap +#. type: Plain text +#: documentation/content/en/books/handbook/zfs/_index.adoc:1056 msgid "" -"# cp /some/important/data /healer\n" -"# zfs list\n" -"NAME SIZE ALLOC FREE CAP DEDUP HEALTH ALTROOT\n" -"healer 960M 67.7M 892M 7% 1.00x ONLINE -\n" -"# sha1 /healer > checksum.txt\n" -"# cat checksum.txt\n" -"SHA1 (/healer) = 2753eff56d77d9a536ece6694bf0a82740344d1f\n" +"`-p` displays numbers as exact, parseable values instead of rounded human-" +"readable ones." msgstr "" -"# cp /some/important/data /healer\n" -"# zfs list\n" -"NAME SIZE ALLOC FREE CAP DEDUP HEALTH ALTROOT\n" -"healer 960M 67.7M 892M 7% 1.00x ONLINE -\n" -"# sha1 /healer > checksum.txt\n" -"# cat checksum.txt\n" -"SHA1 (/healer) = 2753eff56d77d9a536ece6694bf0a82740344d1f\n" +"`-p` отображает числа как точные, разбираемые значения вместо округлённых, " +"удобочитаемых." #. type: Plain text -#: documentation/content/en/books/handbook/zfs/_index.adoc:1029 +#: documentation/content/en/books/handbook/zfs/_index.adoc:1057 msgid "" -"Simulate data corruption by writing random data to the beginning of one of " -"the disks in the mirror. To keep ZFS from healing the data when detected, " -"export the pool before the corruption and import it again afterwards." +"`-t` displays the crossref:zfs[zfs-zpool-trim,TRIM] status of each vdev." msgstr "" -"Симулируйте повреждение данных, записав случайные данные в начало одного из " -"дисков в зеркале. Чтобы предотвратить восстановление данных ZFS при " -"обнаружении, экспортируйте пул перед повреждением и снова импортируйте его " -"после." +"`-t` отображает статус crossref:zfs[zfs-zpool-trim,TRIM] для каждого vdev." -#. type: delimited block = 4 -#: documentation/content/en/books/handbook/zfs/_index.adoc:1037 -msgid "" -"This is a dangerous operation that can destroy vital data, shown here for " -"demonstration alone. *Do not try* it during normal operation of a storage " -"pool. Nor should this intentional corruption example run on any disk with a " -"file system not using ZFS on another partition in it. Do not use any other " -"disk device names other than the ones that are part of the pool. Ensure " -"proper backups of the pool exist and test them before running the command!" -msgstr "" -"Это опасная операция, которая может уничтожить важные данные, и приведена " -"здесь только для демонстрации. *Не пытайтесь* выполнить её во время " -"нормальной работы хранилища данных. Также этот пример преднамеренного " -"повреждения не должен выполняться на диске, содержащем файловую систему, не " -"использующую ZFS на другом разделе. Не используйте имена дисковых устройств, " -"кроме тех, что входят в пул. Убедитесь, что существуют резервные копии пула, " -"и проверьте их перед выполнением команды!" +#. type: Plain text +#: documentation/content/en/books/handbook/zfs/_index.adoc:1059 +msgid "Refer to man:zpool-status[8] for the complete list of options." +msgstr "См. man:zpool-status[8] для полного списка опций." -#. type: delimited block . 4 -#: documentation/content/en/books/handbook/zfs/_index.adoc:1047 +#. type: Title === +#: documentation/content/en/books/handbook/zfs/_index.adoc:1061 #, no-wrap -msgid "" -"# zpool export healer\n" -"# dd if=/dev/random of=/dev/ada1 bs=1m count=200\n" -"200+0 records in\n" -"200+0 records out\n" -"209715200 bytes transferred in 62.992162 secs (3329227 bytes/sec)\n" -"# zpool import healer\n" -msgstr "" -"# zpool export healer\n" -"# dd if=/dev/random of=/dev/ada1 bs=1m count=200\n" -"200+0 records in\n" -"200+0 records out\n" -"209715200 bytes transferred in 62.992162 secs (3329227 bytes/sec)\n" -"# zpool import healer\n" +msgid "Clearing Errors" +msgstr "Сброс состояния ошибки" #. type: Plain text -#: documentation/content/en/books/handbook/zfs/_index.adoc:1053 +#: documentation/content/en/books/handbook/zfs/_index.adoc:1067 msgid "" -"The pool status shows that one device has experienced an error. Note that " -"applications reading data from the pool did not receive any incorrect data. " -"ZFS provided data from the [.filename]#ada0# device with the correct " -"checksums. To find the device with the wrong checksum, look for one whose " -"`CKSUM` column contains a nonzero value." +"When detecting an error, ZFS increases the read, write, or checksum error " +"counts. Clear the error message and reset the counts with `zpool clear " +"_mypool_`. Clearing the error state can be important for automated scripts " +"that alert the administrator when the pool encounters an error. Without " +"clearing old errors, the scripts may fail to report further errors." msgstr "" -"Статус пула показывает, что на одном устройстве произошла ошибка. Обратите " -"внимание, что приложения, читающие данные из пула, не получили некорректных " -"данных. ZFS предоставил данные с устройства [.filename]#ada0# с правильными " -"контрольными суммами. Чтобы найти устройство с неверной контрольной суммой, " -"ищите то, у которого в столбце `CKSUM` указано ненулевое значение." +"При обнаружении ошибки ZFS увеличивает счетчики ошибок чтения, записи или " +"контрольных сумм. Чтобы очистить сообщение об ошибке и сбросить счетчики, " +"используйте команду `zpool clear _mypool_`. Сброс состояния ошибки может " +"быть важен для автоматизированных скриптов, которые уведомляют " +"администратора при возникновении ошибки в пуле. Без очистки старых ошибок " +"скрипты могут не сообщать о новых ошибках." -#. type: delimited block . 4 -#: documentation/content/en/books/handbook/zfs/_index.adoc:1066 +#. type: Title === +#: documentation/content/en/books/handbook/zfs/_index.adoc:1069 #, no-wrap -msgid "" -"# zpool status healer\n" -" pool: healer\n" -" state: ONLINE\n" -" status: One or more devices has experienced an unrecoverable error. An\n" -" attempt was made to correct the error. Applications are unaffected.\n" -" action: Determine if the device needs to be replaced, and clear the errors\n" -" using 'zpool clear' or replace the device with 'zpool replace'.\n" -" see: http://illumos.org/msg/ZFS-8000-4J\n" -" scan: none requested\n" -" config:\n" -msgstr "" -"# zpool status healer\n" -" pool: healer\n" -" state: ONLINE\n" -" status: One or more devices has experienced an unrecoverable error. An\n" -" attempt was made to correct the error. Applications are unaffected.\n" -" action: Determine if the device needs to be replaced, and clear the errors\n" -" using 'zpool clear' or replace the device with 'zpool replace'.\n" -" see: http://illumos.org/msg/ZFS-8000-4J\n" -" scan: none requested\n" -" config:\n" +msgid "Replacing a Functioning Device" +msgstr "Замена рабочего устройства" -#. type: delimited block . 4 -#: documentation/content/en/books/handbook/zfs/_index.adoc:1072 -#, no-wrap +#. type: Plain text +#: documentation/content/en/books/handbook/zfs/_index.adoc:1078 msgid "" -" NAME STATE READ WRITE CKSUM\n" -" healer ONLINE 0 0 0\n" -" mirror-0 ONLINE 0 0 0\n" -" ada0 ONLINE 0 0 0\n" -" ada1 ONLINE 0 0 1\n" +"It may be desirable to replace one disk with a different disk. When " +"replacing a working disk, the process keeps the old disk online during the " +"replacement. The pool never enters a crossref:zfs[zfs-term-degraded," +"degraded] state, reducing the risk of data loss. Running `zpool replace` " +"copies the data from the old disk to the new one. After the operation " +"completes, ZFS disconnects the old disk from the vdev. If the new disk is " +"larger than the old disk, it may be possible to grow the zpool, using the " +"new space. See crossref:zfs[zfs-zpool-online,Growing a Pool]." msgstr "" -" NAME STATE READ WRITE CKSUM\n" -" healer ONLINE 0 0 0\n" -" mirror-0 ONLINE 0 0 0\n" -" ada0 ONLINE 0 0 0\n" -" ada1 ONLINE 0 0 1\n" +"Может потребоваться заменить один диск на другой. При замене рабочего диска " +"процесс сохраняет старый диск в режиме онлайн во время замены. Пул никогда " +"не переходит в состояние crossref:zfs[zfs-term-degraded,деградировавшего], " +"что снижает риск потери данных. Выполнение команды `zpool replace` копирует " +"данные со старого диска на новый. После завершения операции ZFS отключает " +"старый диск от vdev. Если новый диск больше старого, можно расширить zpool, " +"используя новое пространство. См. crossref:zfs[zfs-zpool-online,Расширение " +"пула]." #. type: Plain text -#: documentation/content/en/books/handbook/zfs/_index.adoc:1078 +#: documentation/content/en/books/handbook/zfs/_index.adoc:1080 +msgid "Replace a functioning device in the pool:" +msgstr "Заменить работающее устройство в пуле:" + +#. type: delimited block . 4 +#: documentation/content/en/books/handbook/zfs/_index.adoc:1097 +#, no-wrap msgid "" -"ZFS detected the error and handled it by using the redundancy present in the " -"unaffected [.filename]#ada0# mirror disk. A checksum comparison with the " -"original one will reveal whether the pool is consistent again." +"errors: No known data errors\n" +"# zpool replace mypool ada1p3 ada2p3\n" +"Make sure to wait until resilvering finishes before rebooting.\n" msgstr "" -"ZFS обнаружил ошибку и обработал её, используя избыточность на " -"неповреждённом зеркальном диске [.filename]#ada0#. Сравнение контрольных " -"сумм с исходными покажет, восстановлена ли согласованность пула." +"errors: No known data errors\n" +"# zpool replace mypool ada1p3 ada2p3\n" +"Make sure to wait until resilvering finishes before rebooting.\n" #. type: delimited block . 4 -#: documentation/content/en/books/handbook/zfs/_index.adoc:1085 +#: documentation/content/en/books/handbook/zfs/_index.adoc:1099 #, no-wrap -msgid "" -"# sha1 /healer >> checksum.txt\n" -"# cat checksum.txt\n" -"SHA1 (/healer) = 2753eff56d77d9a536ece6694bf0a82740344d1f\n" -"SHA1 (/healer) = 2753eff56d77d9a536ece6694bf0a82740344d1f\n" +msgid "When booting from the pool 'mypool', update the boot code on the newly attached disk 'ada2p3'.\n" msgstr "" -"# sha1 /healer >> checksum.txt\n" -"# cat checksum.txt\n" -"SHA1 (/healer) = 2753eff56d77d9a536ece6694bf0a82740344d1f\n" -"SHA1 (/healer) = 2753eff56d77d9a536ece6694bf0a82740344d1f\n" +"When booting from the pool 'mypool', update the boot code on the newly " +"attached disk 'ada2p3'.\n" -#. type: Plain text -#: documentation/content/en/books/handbook/zfs/_index.adoc:1094 -msgid "" -"Generate checksums before and after the intentional tampering while the pool " -"data still matches. This shows how ZFS is capable of detecting and " -"correcting any errors automatically when the checksums differ. Note this is " -"possible with enough redundancy present in the pool. A pool consisting of a " -"single device has no self-healing capabilities. That is also the reason why " -"checksums are so important in ZFS; do not disable them for any reason. ZFS " -"requires no man:fsck[8] or similar file system consistency check program to " -"detect and correct this, and keeps the pool available while there is a " -"problem. A scrub operation is now required to overwrite the corrupted data " -"on [.filename]#ada1#." +#. type: delimited block . 4 +#: documentation/content/en/books/handbook/zfs/_index.adoc:1101 +#, no-wrap +msgid "Assuming GPT partitioning is used and ada0 is the new boot disk, use the following command:\n" msgstr "" -"Генерируйте контрольные суммы до и после намеренного изменения данных, пока " -"данные в пуле ещё совпадают. Это демонстрирует, как ZFS способен " -"автоматически обнаруживать и исправлять любые ошибки, когда контрольные " -"суммы различаются. Обратите внимание, что это возможно только при наличии " -"достаточной избыточности в пуле. Пул, состоящий из одного устройства, не " -"обладает возможностями самовосстановления. Именно поэтому контрольные суммы " -"так важны в ZFS — не отключайте их ни по какой причине. ZFS не требует " -"использования man:fsck[8] или аналогичной программы проверки целостности " -"файловой системы для обнаружения и исправления ошибок, а также поддерживает " -"доступность пула даже при наличии проблемы. Теперь требуется операция scrub " -"для перезаписи поврежденных данных на [.filename]#ada1#." +"Assuming GPT partitioning is used and ada0 is the new boot disk, use the " +"following command:\n" #. type: delimited block . 4 -#: documentation/content/en/books/handbook/zfs/_index.adoc:1110 +#: documentation/content/en/books/handbook/zfs/_index.adoc:1114 #, no-wrap msgid "" -"# zpool scrub healer\n" -"# zpool status healer\n" -" pool: healer\n" +" gpart bootcode -b /boot/pmbr -p /boot/gptzfsboot -i 1 ada0\n" +"# gpart bootcode -b /boot/pmbr -p /boot/gptzfsboot -i 1 ada2\n" +"# zpool status\n" +" pool: mypool\n" " state: ONLINE\n" -"status: One or more devices has experienced an unrecoverable error. An\n" -" attempt was made to correct the error. Applications are unaffected.\n" -"action: Determine if the device needs to be replaced, and clear the errors\n" -" using 'zpool clear' or replace the device with 'zpool replace'.\n" -" see: http://illumos.org/msg/ZFS-8000-4J\n" -" scan: scrub in progress since Mon Dec 10 12:23:30 2012\n" -" 10.4M scanned out of 67.0M at 267K/s, 0h3m to go\n" -" 9.63M repaired, 15.56% done\n" +"status: One or more devices is currently being resilvered. The pool will\n" +" continue to function, possibly in a degraded state.\n" +"action: Wait for the resilver to complete.\n" +" scan: resilver in progress since Sat Jul 11 14:21:35 2026\n" +" 781M / 781M scanned, 604M / 781M issued at 101M/s\n" +" 604M resilvered, 77.39% done, 00:00:01 to go\n" "config:\n" msgstr "" -"# zpool scrub healer\n" -"# zpool status healer\n" -" pool: healer\n" +" gpart bootcode -b /boot/pmbr -p /boot/gptzfsboot -i 1 ada0\n" +"# gpart bootcode -b /boot/pmbr -p /boot/gptzfsboot -i 1 ada2\n" +"# zpool status\n" +" pool: mypool\n" " state: ONLINE\n" -"status: One or more devices has experienced an unrecoverable error. An\n" -" attempt was made to correct the error. Applications are unaffected.\n" -"action: Determine if the device needs to be replaced, and clear the errors\n" -" using 'zpool clear' or replace the device with 'zpool replace'.\n" -" see: http://illumos.org/msg/ZFS-8000-4J\n" -" scan: scrub in progress since Mon Dec 10 12:23:30 2012\n" -" 10.4M scanned out of 67.0M at 267K/s, 0h3m to go\n" -" 9.63M repaired, 15.56% done\n" -"config:\n" +"status: One or more devices is currently being resilvered. The pool will\n" +" continue to function, possibly in a degraded state.\n" +"action: Wait for the resilver to complete.\n" +" scan: resilver in progress since Sat Jul 11 14:21:35 2026\n" +" 781M / 781M scanned, 604M / 781M issued at 101M/s\n" +" 604M resilvered, 77.39% done, 00:00:01 to go\n" +"config:\n" #. type: delimited block . 4 -#: documentation/content/en/books/handbook/zfs/_index.adoc:1116 -#, no-wrap -msgid "" -" NAME STATE READ WRITE CKSUM\n" -" healer ONLINE 0 0 0\n" -" mirror-0 ONLINE 0 0 0\n" -" ada0 ONLINE 0 0 0\n" -" ada1 ONLINE 0 0 627 (repairing)\n" -msgstr "" -" NAME STATE READ WRITE CKSUM\n" -" healer ONLINE 0 0 0\n" -" mirror-0 ONLINE 0 0 0\n" -" ada0 ONLINE 0 0 0\n" -" ada1 ONLINE 0 0 627 (repairing)\n" - -#. type: Plain text #: documentation/content/en/books/handbook/zfs/_index.adoc:1122 +#, no-wrap msgid "" -"The scrub operation reads data from [.filename]#ada0# and rewrites any data " -"with a wrong checksum on [.filename]#ada1#, shown by the `(repairing)` " -"output from `zpool status`. After the operation is complete, the pool " -"status changes to:" +" NAME STATE READ WRITE CKSUM\n" +" mypool ONLINE 0 0 0\n" +" mirror-0 ONLINE 0 0 0\n" +" ada0p3 ONLINE 0 0 0\n" +" replacing-1 ONLINE 0 0 0\n" +" ada1p3 ONLINE 0 0 0\n" +" ada2p3 ONLINE 0 0 0 (resilvering)\n" msgstr "" -"Операция scrub читает данные с [.filename]#ada0# и перезаписывает любые " -"данные с некорректной контрольной суммой на [.filename]#ada1#, что " -"отображается как `(repairing)` в выводе `zpool status`. После завершения " -"операции состояние пула изменяется на:" +" NAME STATE READ WRITE CKSUM\n" +" mypool ONLINE 0 0 0\n" +" mirror-0 ONLINE 0 0 0\n" +" ada0p3 ONLINE 0 0 0\n" +" replacing-1 ONLINE 0 0 0\n" +" ada1p3 ONLINE 0 0 0\n" +" ada2p3 ONLINE 0 0 0 (resilvering)\n" #. type: delimited block . 4 -#: documentation/content/en/books/handbook/zfs/_index.adoc:1135 +#: documentation/content/en/books/handbook/zfs/_index.adoc:1129 #, no-wrap msgid "" -"# zpool status healer\n" -" pool: healer\n" +"errors: No known data errors\n" +"# zpool status\n" +" pool: mypool\n" " state: ONLINE\n" -"status: One or more devices has experienced an unrecoverable error. An\n" -" attempt was made to correct the error. Applications are unaffected.\n" -"action: Determine if the device needs to be replaced, and clear the errors\n" -" using 'zpool clear' or replace the device with 'zpool replace'.\n" -" see: http://illumos.org/msg/ZFS-8000-4J\n" -" scan: scrub repaired 66.5M in 0h2m with 0 errors on Mon Dec 10 12:26:25 2012\n" +" scan: resilvered 781M in 00:00:17 with 0 errors on Sat Jul 11 14:21:52 2026\n" "config:\n" msgstr "" -"# zpool status healer\n" -" pool: healer\n" +"errors: No known data errors\n" +"# zpool status\n" +" pool: mypool\n" " state: ONLINE\n" -"status: One or more devices has experienced an unrecoverable error. An\n" -" attempt was made to correct the error. Applications are unaffected.\n" -"action: Determine if the device needs to be replaced, and clear the errors\n" -" using 'zpool clear' or replace the device with 'zpool replace'.\n" -" see: http://illumos.org/msg/ZFS-8000-4J\n" -" scan: scrub repaired 66.5M in 0h2m with 0 errors on Mon Dec 10 12:26:25 2012\n" +" scan: resilvered 781M in 00:00:17 with 0 errors on Sat Jul 11 14:21:52 " +"2026\n" "config:\n" #. type: delimited block . 4 -#: documentation/content/en/books/handbook/zfs/_index.adoc:1141 -#, no-wrap -msgid "" -" NAME STATE READ WRITE CKSUM\n" -" healer ONLINE 0 0 0\n" -" mirror-0 ONLINE 0 0 0\n" -" ada0 ONLINE 0 0 0\n" -" ada1 ONLINE 0 0 2.72K\n" -msgstr "" -" NAME STATE READ WRITE CKSUM\n" -" healer ONLINE 0 0 0\n" -" mirror-0 ONLINE 0 0 0\n" -" ada0 ONLINE 0 0 0\n" -" ada1 ONLINE 0 0 2.72K\n" - -#. type: Plain text -#: documentation/content/en/books/handbook/zfs/_index.adoc:1147 -msgid "" -"After the scrubbing operation completes with all the data synchronized from " -"[.filename]#ada0# to [.filename]#ada1#, crossref:zfs[zfs-zpool-clear,clear] " -"the error messages from the pool status by running `zpool clear`." -msgstr "" -"После завершения операции очистки, когда все данные синхронизированы с [." -"filename]#ada0# на [.filename]#ada1#, сбросьте сообщения об ошибках из " -"состояния пула, выполнив команду `zpool clear`, как описано в разделе " -"crossref:zfs[zfs-zpool-clear, Сброс состояния ошибки]." - -#. type: delimited block . 4 -#: documentation/content/en/books/handbook/zfs/_index.adoc:1156 +#: documentation/content/en/books/handbook/zfs/_index.adoc:1135 +#: documentation/content/en/books/handbook/zfs/_index.adoc:1213 #, no-wrap msgid "" -"# zpool clear healer\n" -"# zpool status healer\n" -" pool: healer\n" -" state: ONLINE\n" -" scan: scrub repaired 66.5M in 0h2m with 0 errors on Mon Dec 10 12:26:25 2012\n" -"config:\n" +" NAME STATE READ WRITE CKSUM\n" +" mypool ONLINE 0 0 0\n" +" mirror-0 ONLINE 0 0 0\n" +" ada0p3 ONLINE 0 0 0\n" +" ada2p3 ONLINE 0 0 0\n" msgstr "" -"# zpool clear healer\n" -"# zpool status healer\n" -" pool: healer\n" -" state: ONLINE\n" -" scan: scrub repaired 66.5M in 0h2m with 0 errors on Mon Dec 10 12:26:25 2012\n" -"config:\n" +" NAME STATE READ WRITE CKSUM\n" +" mypool ONLINE 0 0 0\n" +" mirror-0 ONLINE 0 0 0\n" +" ada0p3 ONLINE 0 0 0\n" +" ada2p3 ONLINE 0 0 0\n" #. type: Plain text -#: documentation/content/en/books/handbook/zfs/_index.adoc:1167 -msgid "" -"The pool is now back to a fully working state, with all error counts now " -"zero." -msgstr "" -"Пулу возвращено полностью рабочее состояние, все счётчики ошибок теперь " -"обнулены." +#: documentation/content/en/books/handbook/zfs/_index.adoc:1144 +msgid "" +"On mirrored vdevs, adding `-s` to `zpool replace` or `zpool attach` performs " +"a _sequential resilver_ instead of a healing resilver. A sequential " +"resilver copies the data in disk order without verifying each block " +"checksum, restoring redundancy much sooner. Since the copy skips checksum " +"verification, ZFS starts a crossref:zfs[zfs-zpool-scrub,scrub] of the pool " +"automatically after the sequential resilver completes. Sequential " +"resilvering works on mirror and crossref:zfs[zfs-zpool-draid,dRAID] vdevs, " +"not on RAID-Z. Restart an in-progress resilver from the beginning with " +"`zpool resilver _mypool_`." +msgstr "" +"На зеркальных vdev-устройствах добавление `-s` к `zpool replace` или `zpool " +"attach` выполняет _последовательное восстановление_ вместо " +"восстанавливающего ресильверинга. Последовательное восстановление копирует " +"данные в порядке расположения на диске без проверки контрольных сумм каждого " +"блока, восстанавливая избыточность гораздо быстрее. Поскольку копирование " +"пропускает проверку контрольных сумм, ZFS автоматически запускает " +"crossref:zfs[zfs-zpool-scrub,scrub] пула после завершения последовательного " +"восстановления. Последовательное восстановление работает на зеркальных и " +"crossref:zfs[zfs-zpool-draid,dRAID] vdev-устройствах, но не на RAID-Z. " +"Перезапустите текущий resilver с начала с помощью `zpool resilver _mypool_`." #. type: Title === -#: documentation/content/en/books/handbook/zfs/_index.adoc:1169 +#: documentation/content/en/books/handbook/zfs/_index.adoc:1146 #, no-wrap -msgid "Growing a Pool" -msgstr "Увеличение размера пула" +msgid "Dealing with Failed Devices" +msgstr "Обработка неисправных устройств" #. type: Plain text -#: documentation/content/en/books/handbook/zfs/_index.adoc:1179 +#: documentation/content/en/books/handbook/zfs/_index.adoc:1154 msgid "" -"The smallest device in each vdev limits the usable size of a redundant " -"pool. Replace the smallest device with a larger device. After completing a " -"crossref:zfs[zfs-zpool-replace,replace] or crossref:zfs[zfs-term-resilver," -"resilver] operation, the pool can grow to use the capacity of the new " -"device. For example, consider a mirror of a 1 TB drive and a 2 TB drive. " -"The usable space is 1 TB. When replacing the 1 TB drive with another 2 TB " -"drive, the resilvering process copies the existing data onto the new drive. " -"As both of the devices now have 2 TB capacity, the mirror's available space " -"grows to 2 TB." +"When a disk in a pool fails, the vdev to which the disk belongs enters the " +"crossref:zfs[zfs-term-degraded,degraded] state. The data is still " +"available, but with reduced performance because ZFS computes missing data " +"from the available redundancy. To restore the vdev to a fully functional " +"state, replace the failed physical device. ZFS is then instructed to begin " +"the crossref:zfs[zfs-term-resilver,resilver] operation. ZFS recomputes data " +"on the failed device from available redundancy and writes it to the " +"replacement device. After completion, the vdev returns to crossref:zfs[zfs-" +"term-online,online] status." msgstr "" -"Наименьшее устройство в каждом vdev ограничивает полезный размер избыточного " -"пула. Замените наименьшее устройство на устройство большего размера. После " -"завершения операции crossref:zfs[zfs-zpool-replace,замены] или crossref:" -"zfs[zfs-term-resilver,пересинхронизации] пул может расшириться для " -"использования ёмкости нового устройства. Например, рассмотрим зеркало из " -"диска на 1 ТБ и диска на 2 ТБ. Полезное пространство составляет 1 ТБ. При " -"замене диска на 1 ТБ другим диском на 2 ТБ процесс пересинхронизации " -"копирует существующие данные на новый диск. Поскольку оба устройства теперь " -"имеют ёмкость 2 ТБ, доступное пространство зеркала увеличивается до 2 ТБ." +"Когда диск в пуле выходит из строя, устройство vdev, к которому принадлежит " +"этот диск, переходит в crossref:zfs[zfs-term-degraded,деградировавшее] " +"состояние. Данные остаются доступными, но с пониженной производительностью, " +"поскольку ZFS вычисляет недостающие данные из доступной избыточности. Чтобы " +"восстановить устройство vdev в полностью работоспособное состояние, замените " +"вышедший из строя физический диск. Затем ZFS получает указание начать " +"операцию crossref:zfs[zfs-term-resilver,восстановления]. ZFS пересчитывает " +"данные с вышедшего из строя устройства из доступной избыточности и " +"записывает их на заменённый диск. После завершения процесса устройство vdev " +"возвращается в состояние crossref:zfs[zfs-term-online,онлайн]." #. type: Plain text -#: documentation/content/en/books/handbook/zfs/_index.adoc:1182 +#: documentation/content/en/books/handbook/zfs/_index.adoc:1157 msgid "" -"Start expansion by using `zpool online -e` on each device. After expanding " -"all devices, the extra space becomes available to the pool." +"If the vdev does not have any redundancy, or if devices have failed and " +"there is not enough redundancy to compensate, the pool enters the crossref:" +"zfs[zfs-term-faulted,faulted] state. Unless enough devices can reconnect, " +"the pool becomes inoperative, requiring a data restore from backups." msgstr "" -"Начните расширение, используя `zpool online -e` для каждого устройства. " -"После расширения всех устройств дополнительное пространство становится " -"доступным для пула." - -#. type: Title === -#: documentation/content/en/books/handbook/zfs/_index.adoc:1184 -#, no-wrap -msgid "Importing and Exporting Pools" -msgstr "Импорт и экспорт пулов" +"Если vdev не имеет избыточности или если устройства вышли из строя и " +"недостаточно избыточности для компенсации, пул переходит в состояние " +"crossref:zfs[zfs-term-faulted,faulted]. Если недостаточно устройств для " +"восстановления связи, пул становится неработоспособным, что требует " +"восстановления данных из резервных копий." #. type: Plain text -#: documentation/content/en/books/handbook/zfs/_index.adoc:1192 +#: documentation/content/en/books/handbook/zfs/_index.adoc:1160 msgid "" -"_Export_ pools before moving them to another system. ZFS unmounts all " -"datasets, marking each device as exported but still locked to prevent use by " -"other disks. This allows pools to be _imported_ on other machines, other " -"operating systems that support ZFS, and even different hardware " -"architectures (with some caveats, see man:zpool[8]). When a dataset has " -"open files, use `zpool export -f` to force exporting the pool. Use this " -"with caution. The datasets are forcibly unmounted, potentially resulting in " -"unexpected behavior by the applications which had open files on those " -"datasets." +"When replacing a failed disk, the name of the failed disk changes to the " +"GUID of the new disk. A new device name parameter for `zpool replace` is " +"not required if the replacement device has the same device name." msgstr "" -"_Экспортируйте_ пулы перед перемещением на другую систему. ZFS отмонтирует " -"все наборы данных, помечая каждое устройство как экспортированное, но все " -"ещё заблокированное, чтобы предотвратить использование другими дисками. Это " -"позволяет импортировать пулы на других машинах, операционных системах с " -"поддержкой ZFS и даже на аппаратных архитектурах другого типа (с некоторыми " -"оговорками, см. man:zpool[8]). Если в наборе данных есть открытые файлы, " -"используйте `zpool export -f` для принудительного экспорта пула. Используйте " -"эту команду с осторожностью. Наборы данных будут принудительно " -"отмонтированы, что может привести к неожиданному поведению приложений, " -"работавших с открытыми файлами в этих наборах данных." +"При замене вышедшего из строя диска имя отказавшего диска изменяется на GUID " +"нового диска. Новый параметр имени устройства для `zpool replace` не " +"требуется, если заменяющее устройство имеет то же имя устройства." #. type: Plain text -#: documentation/content/en/books/handbook/zfs/_index.adoc:1194 -msgid "Export a pool that is not in use:" -msgstr "Экспортируйте пул, который не используется:" +#: documentation/content/en/books/handbook/zfs/_index.adoc:1162 +msgid "Replace a failed disk using `zpool replace`:" +msgstr "Заменить вышедший из строя диск с помощью `zpool replace`:" #. type: delimited block . 4 -#: documentation/content/en/books/handbook/zfs/_index.adoc:1198 +#: documentation/content/en/books/handbook/zfs/_index.adoc:1173 #, no-wrap -msgid "# zpool export mypool\n" -msgstr "# zpool export mypool\n" - -#. type: Plain text -#: documentation/content/en/books/handbook/zfs/_index.adoc:1206 msgid "" -"Importing a pool automatically mounts the datasets. If this is undesired " -"behavior, use `zpool import -N` to prevent it. `zpool import -o` sets " -"temporary properties for this specific import. `zpool import altroot=` " -"allows importing a pool with a base mount point instead of the root of the " -"file system. If the pool was last used on a different system and was not " -"properly exported, force the import using `zpool import -f`. `zpool import -" -"a` imports all pools that do not appear to be in use by another system." +"# zpool status\n" +" pool: mypool\n" +" state: DEGRADED\n" +"status: One or more devices could not be opened. Sufficient replicas exist for\n" +" the pool to continue functioning in a degraded state.\n" +"action: Attach the missing device and online it using 'zpool online'.\n" +" see: https://openzfs.github.io/openzfs-docs/msg/ZFS-8000-2Q\n" +"config:\n" msgstr "" -"Импорт пула автоматически монтирует наборы данных. Если такое поведение " -"нежелательно, используйте `zpool import -N`, чтобы предотвратить это. `zpool " -"import -o` устанавливает временные свойства для данного конкретного импорта. " -"`zpool import altroot=` позволяет импортировать пул с базовой точкой " -"монтирования вместо корня файловой системы. Если пул последний раз " -"использовался в другой системе и не был корректно экспортирован, " -"принудительно импортируйте его с помощью `zpool import -f`. `zpool import -" -"a` импортирует все пулы, которые, по-видимому, не используются другой " -"системой." - -#. type: Plain text -#: documentation/content/en/books/handbook/zfs/_index.adoc:1208 -msgid "List all available pools for import:" -msgstr "Выведите список всех доступных пулов для импорта:" +"# zpool status\n" +" pool: mypool\n" +" state: DEGRADED\n" +"status: One or more devices could not be opened. Sufficient replicas exist " +"for\n" +" the pool to continue functioning in a degraded state.\n" +"action: Attach the missing device and online it using 'zpool online'.\n" +" see: https://openzfs.github.io/openzfs-docs/msg/ZFS-8000-2Q\n" +"config:\n" #. type: delimited block . 4 -#: documentation/content/en/books/handbook/zfs/_index.adoc:1217 +#: documentation/content/en/books/handbook/zfs/_index.adoc:1179 #, no-wrap msgid "" -"# zpool import\n" -" pool: mypool\n" -" id: 9930174748043525076\n" -" state: ONLINE\n" -" action: The pool can be imported using its name or numeric identifier.\n" -" config:\n" +" NAME STATE READ WRITE CKSUM\n" +" mypool DEGRADED 0 0 0\n" +" mirror-0 DEGRADED 0 0 0\n" +" ada0p3 ONLINE 0 0 0\n" +" 316502962686821739 UNAVAIL 0 0 0 was /dev/ada1p3\n" msgstr "" -"# zpool import\n" -" pool: mypool\n" -" id: 9930174748043525076\n" -" state: ONLINE\n" -" action: The pool can be imported using its name or numeric identifier.\n" -" config:\n" +" NAME STATE READ WRITE CKSUM\n" +" mypool DEGRADED 0 0 0\n" +" mirror-0 DEGRADED 0 0 0\n" +" ada0p3 ONLINE 0 0 0\n" +" 316502962686821739 UNAVAIL 0 0 0 was /dev/ada1p3\n" #. type: delimited block . 4 -#: documentation/content/en/books/handbook/zfs/_index.adoc:1220 +#: documentation/content/en/books/handbook/zfs/_index.adoc:1192 #, no-wrap msgid "" -" mypool ONLINE\n" -" ada2p3 ONLINE\n" +"errors: No known data errors\n" +"# zpool replace mypool 316502962686821739 ada2p3\n" +"# zpool status\n" +" pool: mypool\n" +" state: DEGRADED\n" +"status: One or more devices is currently being resilvered. The pool will\n" +" continue to function, possibly in a degraded state.\n" +"action: Wait for the resilver to complete.\n" +" scan: resilver in progress since Sat Jul 11 14:52:21 2026\n" +" 781M / 781M scanned, 641M / 781M issued at 128M/s\n" +" 640M resilvered, 82.04% done, 00:00:01 to go\n" +"config:\n" msgstr "" -" mypool ONLINE\n" -" ada2p3 ONLINE\n" +"errors: No known data errors\n" +"# zpool replace mypool 316502962686821739 ada2p3\n" +"# zpool status\n" +" pool: mypool\n" +" state: DEGRADED\n" +"status: One or more devices is currently being resilvered. The pool will\n" +" continue to function, possibly in a degraded state.\n" +"action: Wait for the resilver to complete.\n" +" scan: resilver in progress since Sat Jul 11 14:52:21 2026\n" +" 781M / 781M scanned, 641M / 781M issued at 128M/s\n" +" 640M resilvered, 82.04% done, 00:00:01 to go\n" +"config:\n" -#. type: Plain text -#: documentation/content/en/books/handbook/zfs/_index.adoc:1223 -msgid "Import the pool with an alternative root directory:" -msgstr "Импортируйте пул с альтернативным корневым каталогом:" +#. type: delimited block . 4 +#: documentation/content/en/books/handbook/zfs/_index.adoc:1200 +#, no-wrap +msgid "" +" NAME STATE READ WRITE CKSUM\n" +" mypool DEGRADED 0 0 0\n" +" mirror-0 DEGRADED 0 0 0\n" +" ada0p3 ONLINE 0 0 0\n" +" replacing-1 UNAVAIL 0 0 0\n" +" 15732067398082357289 UNAVAIL 0 0 0 was /dev/ada1p3/old\n" +" ada2p3 ONLINE 0 0 0 (resilvering)\n" +msgstr "" +" NAME STATE READ WRITE CKSUM\n" +" mypool DEGRADED 0 0 0\n" +" mirror-0 DEGRADED 0 0 0\n" +" ada0p3 ONLINE 0 0 0\n" +" replacing-1 UNAVAIL 0 0 0\n" +" 15732067398082357289 UNAVAIL 0 0 0 was /dev/ada1p3/old\n" +" ada2p3 ONLINE 0 0 0 (resilvering)\n" #. type: delimited block . 4 -#: documentation/content/en/books/handbook/zfs/_index.adoc:1231 +#: documentation/content/en/books/handbook/zfs/_index.adoc:1207 #, no-wrap msgid "" -"# zpool import -o altroot=/mnt mypool\n" -"# zfs list\n" -"zfs list\n" -"NAME USED AVAIL REFER MOUNTPOINT\n" -"mypool 110K 47.0G 31K /mnt/mypool\n" +"errors: No known data errors\n" +"# zpool status\n" +" pool: mypool\n" +" state: ONLINE\n" +" scan: resilvered 781M in 00:00:17 with 0 errors on Sat Jul 11 14:52:38 2026\n" +"config:\n" msgstr "" -"# zpool import -o altroot=/mnt mypool\n" -"# zfs list\n" -"zfs list\n" -"NAME USED AVAIL REFER MOUNTPOINT\n" -"mypool 110K 47.0G 31K /mnt/mypool\n" +"errors: No known data errors\n" +"# zpool status\n" +" pool: mypool\n" +" state: ONLINE\n" +" scan: resilvered 781M in 00:00:17 with 0 errors on Sat Jul 11 14:52:38 " +"2026\n" +"config:\n" #. type: Title === -#: documentation/content/en/books/handbook/zfs/_index.adoc:1234 +#: documentation/content/en/books/handbook/zfs/_index.adoc:1218 #, no-wrap -msgid "Upgrading a Storage Pool" -msgstr "Обновление пула дисков" +msgid "Hot Spares and Automatic Replacement with zfsd" +msgstr "Горячие резервные диски и автоматическая замена с помощью zfsd" #. type: Plain text -#: documentation/content/en/books/handbook/zfs/_index.adoc:1240 +#: documentation/content/en/books/handbook/zfs/_index.adoc:1223 msgid "" -"After upgrading FreeBSD, or if importing a pool from a system using an older " -"version, manually upgrade the pool to the latest ZFS version to support " -"newer features. Consider whether the pool may ever need importing on an " -"older system before upgrading. Upgrading is a one-way process. Upgrade " -"older pools is possible, but downgrading pools with newer features is not." +"Pools with redundant vdevs can register crossref:zfs[zfs-term-vdev-spare,hot " +"spare] disks that stand by to replace a failed device. A spare must be at " +"least as large as the device it replaces. Specify spares at pool creation " +"time by listing them after the `spare` keyword, as in `zpool create _mypool_ " +"mirror _ada0p3_ _ada1p3_ spare _ada3p3_`, or add them to an existing pool " +"with `zpool add`:" msgstr "" -"После обновления FreeBSD или при импорте пула с системы, использующей более " -"старую версию, вручную обновите пул до последней версии ZFS для поддержки " -"новых функций. Перед обновлением учтите, может ли пул потребоваться для " -"импорта на более старой системе. Обновление является необратимым процессом. " -"Обновление старых пулов возможно, но понижение версии пулов с новыми " -"функциями — нет." - -#. type: Plain text -#: documentation/content/en/books/handbook/zfs/_index.adoc:1242 -msgid "Upgrade a v28 pool to support `Feature Flags`:" -msgstr "Обновление пула v28 для поддержки `Feature Flags`:" +"Пулы с избыточными vdev могут регистрировать crossref:zfs[zfs-term-vdev-" +"spare,горячие резервные] диски, которые находятся в режиме ожидания для " +"замены вышедшего из строя устройства. Резервный диск должен быть не меньше " +"устройства, которое он заменяет. Укажите резервные диски при создании пула, " +"перечислив их после ключевого слова `spare`, как в `zpool create _mypool_ " +"mirror _ada0p3_ _ada1p3_ spare _ada3p3_`, или добавьте их в существующий пул " +"с помощью `zpool add`:" #. type: delimited block . 4 -#: documentation/content/en/books/handbook/zfs/_index.adoc:1255 +#: documentation/content/en/books/handbook/zfs/_index.adoc:1231 #, no-wrap msgid "" +"# zpool add mypool spare ada3p3\n" "# zpool status\n" " pool: mypool\n" " state: ONLINE\n" -"status: The pool is formatted using a legacy on-disk format. The pool can\n" -" still be used, but some features are unavailable.\n" -"action: Upgrade the pool using 'zpool upgrade'. Once this is done, the\n" -" pool will no longer be accessible on software that does not support feat\n" -" flags.\n" -" scan: none requested\n" "config:\n" msgstr "" +"# zpool add mypool spare ada3p3\n" "# zpool status\n" " pool: mypool\n" " state: ONLINE\n" -"status: The pool is formatted using a legacy on-disk format. The pool can\n" -" still be used, but some features are unavailable.\n" -"action: Upgrade the pool using 'zpool upgrade'. Once this is done, the\n" -" pool will no longer be accessible on software that does not support feat\n" -" flags.\n" -" scan: none requested\n" "config:\n" #. type: delimited block . 4 -#: documentation/content/en/books/handbook/zfs/_index.adoc:1261 -#: documentation/content/en/books/handbook/zfs/_index.adoc:1309 +#: documentation/content/en/books/handbook/zfs/_index.adoc:1239 #, no-wrap msgid "" " NAME STATE READ WRITE CKSUM\n" " mypool ONLINE 0 0 0\n" " mirror-0 ONLINE 0 0 0\n" -"\t ada0 ONLINE 0 0 0\n" -"\t ada1 ONLINE 0 0 0\n" +" ada0p3 ONLINE 0 0 0\n" +" ada1p3 ONLINE 0 0 0\n" +" spares\n" +" ada3p3 AVAIL\n" msgstr "" " NAME STATE READ WRITE CKSUM\n" " mypool ONLINE 0 0 0\n" " mirror-0 ONLINE 0 0 0\n" -"\t ada0 ONLINE 0 0 0\n" -"\t ada1 ONLINE 0 0 0\n" +" ada0p3 ONLINE 0 0 0\n" +" ada1p3 ONLINE 0 0 0\n" +" spares\n" +" ada3p3 AVAIL\n" -#. type: delimited block . 4 -#: documentation/content/en/books/handbook/zfs/_index.adoc:1265 -#: documentation/content/en/books/handbook/zfs/_index.adoc:1313 -#, no-wrap +#. type: Plain text +#: documentation/content/en/books/handbook/zfs/_index.adoc:1245 msgid "" -"errors: No known data errors\n" -"# zpool upgrade\n" -"This system supports ZFS pool feature flags.\n" +"A spare stays idle, shown as `AVAIL`, until a device fails. Activate a " +"spare by hand with `zpool replace`, naming the failed device and the spare:" msgstr "" -"errors: No known data errors\n" -"# zpool upgrade\n" -"This system supports ZFS pool feature flags.\n" +"Запасной диск остается неиспользуемым, отображаясь как `AVAIL`, пока " +"устройство не выйдет из строя. Активируйте запасной диск вручную с помощью `" +"zpool replace`, указав отказавшее устройство и запасной диск:" #. type: delimited block . 4 -#: documentation/content/en/books/handbook/zfs/_index.adoc:1268 +#: documentation/content/en/books/handbook/zfs/_index.adoc:1258 #, no-wrap msgid "" -"The following pools are formatted with legacy version numbers and are upgraded to use feature flags.\n" -"After being upgraded, these pools will no longer be accessible by software that does not support feature flags.\n" +"# zpool replace mypool ada1p3 ada3p3\n" +"# zpool status\n" +" pool: mypool\n" +" state: DEGRADED\n" +"status: One or more devices could not be opened. Sufficient replicas exist for\n" +" the pool to continue functioning in a degraded state.\n" +"action: Attach the missing device and online it using 'zpool online'.\n" +" see: https://openzfs.github.io/openzfs-docs/msg/ZFS-8000-2Q\n" +" scan: resilvered 781M in 00:00:21 with 0 errors on Sat Jul 11 09:14:33 2026\n" +"config:\n" msgstr "" -"The following pools are formatted with legacy version numbers and are upgraded to use feature flags.\n" -"After being upgraded, these pools will no longer be accessible by software that does not support feature flags.\n" +"# zpool replace mypool ada1p3 ada3p3\n" +"# zpool status\n" +" pool: mypool\n" +" state: DEGRADED\n" +"status: One or more devices could not be opened. Sufficient replicas exist " +"for\n" +" the pool to continue functioning in a degraded state.\n" +"action: Attach the missing device and online it using 'zpool online'.\n" +" see: https://openzfs.github.io/openzfs-docs/msg/ZFS-8000-2Q\n" +" scan: resilvered 781M in 00:00:21 with 0 errors on Sat Jul 11 09:14:33 " +"2026\n" +"config:\n" #. type: delimited block . 4 -#: documentation/content/en/books/handbook/zfs/_index.adoc:1272 +#: documentation/content/en/books/handbook/zfs/_index.adoc:1268 #, no-wrap msgid "" -"VER POOL\n" -"--- ------------\n" -"28 mypool\n" +" NAME STATE READ WRITE CKSUM\n" +" mypool DEGRADED 0 0 0\n" +" mirror-0 DEGRADED 0 0 0\n" +" ada0p3 ONLINE 0 0 0\n" +" spare-1 DEGRADED 0 0 0\n" +" ada1p3 UNAVAIL 0 0 0 cannot open\n" +" ada3p3 ONLINE 0 0 0\n" +" spares\n" +" ada3p3 INUSE currently in use\n" +msgstr "" +" NAME STATE READ WRITE CKSUM\n" +" mypool DEGRADED 0 0 0\n" +" mirror-0 DEGRADED 0 0 0\n" +" ada0p3 ONLINE 0 0 0\n" +" spare-1 DEGRADED 0 0 0\n" +" ada1p3 UNAVAIL 0 0 0 cannot open\n" +" ada3p3 ONLINE 0 0 0\n" +" spares\n" +" ada3p3 INUSE currently in use\n" + +#. type: Plain text +#: documentation/content/en/books/handbook/zfs/_index.adoc:1275 +msgid "" +"The spare replacement is temporary by design, and the pool stays in this " +"state until an administrator resolves it. After physically replacing the " +"failed disk and resilvering the new device with crossref:zfs[zfs-zpool-" +"replace,`zpool replace`], return the spare to standby with `zpool detach " +"_mypool_ _ada3p3_`. To promote the spare to a permanent member of the vdev " +"instead, detach the failed device with `zpool detach _mypool_ _ada1p3_`." +msgstr "" +"Запасной диск является временной мерой, и пул остается в этом состоянии, " +"пока администратор не разрешит ситуацию. После физической замены вышедшего " +"из строя диска и повторного зеркалирования нового устройства с помощью " +"crossref:zfs[zfs-zpool-replace,`zpool replace`], верните запасной диск в " +"режим ожидания с помощью `zpool detach _mypool_ _ada3p3_`. Чтобы вместо " +"этого повысить запасной диск до постоянного члена vdev, отсоедините вышедшее " +"из строя устройство с помощью `zpool detach _mypool_ _ada1p3_`." + +#. type: Plain text +#: documentation/content/en/books/handbook/zfs/_index.adoc:1278 +msgid "" +"The `autoreplace` pool property, off by default, controls what happens when " +"a new disk appears at the same physical location as a device that previously " +"belonged to the pool. With `autoreplace` set to `on`, ZFS replaces the old " +"device with the new disk automatically, without requiring a `zpool replace` " +"command:" msgstr "" -"VER POOL\n" -"--- ------------\n" -"28 mypool\n" +"Свойство пула `autoreplace`, по умолчанию выключенное, управляет тем, что " +"происходит, когда новый диск появляется в том же физическом месте, что и " +"устройство, ранее принадлежавшее пулу. При установке `autoreplace` в " +"значение `on`, ZFS автоматически заменяет старое устройство новым диском, не " +"требуя команды `zpool replace`:" #. type: delimited block . 4 -#: documentation/content/en/books/handbook/zfs/_index.adoc:1277 +#: documentation/content/en/books/handbook/zfs/_index.adoc:1282 #, no-wrap +msgid "# zpool set autoreplace=on mypool\n" +msgstr "# zpool set autoreplace=on mypool\n" + +#. type: Plain text +#: documentation/content/en/books/handbook/zfs/_index.adoc:1287 msgid "" -"Use 'zpool upgrade -v' for a list of available legacy versions.\n" -"Every feature flags pool has all supported features enabled.\n" -"# zpool upgrade mypool\n" -"This system supports ZFS pool feature flags.\n" +"On FreeBSD, automatic reactions to failures, including honoring " +"`autoreplace`, are performed by man:zfsd[8], the ZFS fault management daemon " +"in the base system. The daemon is not enabled by default. Enable and start " +"it with:" msgstr "" -"Use 'zpool upgrade -v' for a list of available legacy versions.\n" -"Every feature flags pool has all supported features enabled.\n" -"# zpool upgrade mypool\n" -"This system supports ZFS pool feature flags.\n" +"На FreeBSD автоматические реакции на сбои, включая выполнение `autoreplace`, " +"выполняются man:zfsd[8], демоном управления отказами ZFS в базовой системе. " +"Демон не включён по умолчанию. Включите и запустите его с помощью команды:" #. type: delimited block . 4 -#: documentation/content/en/books/handbook/zfs/_index.adoc:1284 +#: documentation/content/en/books/handbook/zfs/_index.adoc:1292 #, no-wrap msgid "" -"Successfully upgraded 'mypool' from version 28 to feature flags.\n" -"Enabled the following features on 'mypool':\n" -" async_destroy\n" -" empty_bpobj\n" -" lz4_compress\n" -" multi_vdev_crash_dump\n" +"# sysrc zfsd_enable=\"YES\"\n" +"# service zfsd start\n" msgstr "" -"Successfully upgraded 'mypool' from version 28 to feature flags.\n" -"Enabled the following features on 'mypool':\n" -" async_destroy\n" -" empty_bpobj\n" -" lz4_compress\n" -" multi_vdev_crash_dump\n" +"# sysrc zfsd_enable=\"YES\"\n" +"# service zfsd start\n" #. type: Plain text -#: documentation/content/en/books/handbook/zfs/_index.adoc:1288 -msgid "" -"The newer features of ZFS will not be available until `zpool upgrade` has " -"completed. Use `zpool upgrade -v` to see what new features the upgrade " -"provides, as well as which features are already supported." -msgstr "" -"Новые возможности ZFS станут доступны только после выполнения команды `zpool " -"upgrade`. Используйте `zpool upgrade -v`, чтобы увидеть, какие новые " -"возможности предоставляет обновление, а также какие функции уже " -"поддерживаются." +#: documentation/content/en/books/handbook/zfs/_index.adoc:1295 +msgid "man:zfsd[8] listens for pool events and:" +msgstr "man:zfsd[8] прослушивает события пула и:" #. type: Plain text -#: documentation/content/en/books/handbook/zfs/_index.adoc:1290 -msgid "Upgrade a pool to support new feature flags:" -msgstr "Обновление пула для поддержки новых флагов функций:" - -#. type: delimited block . 4 -#: documentation/content/en/books/handbook/zfs/_index.adoc:1303 -#, no-wrap +#: documentation/content/en/books/handbook/zfs/_index.adoc:1297 msgid "" -"# zpool status\n" -" pool: mypool\n" -" state: ONLINE\n" -"status: Some supported features are not enabled on the pool. The pool can\n" -" still be used, but some features are unavailable.\n" -"action: Enable all features using 'zpool upgrade'. Once this is done,\n" -" the pool may no longer be accessible by software that does not support\n" -" the features. See zpool-features(7) for details.\n" -" scan: none requested\n" -"config:\n" +"Activates a hot spare when a device disappears from a redundant vdev or when " +"a vdev becomes degraded or faulted." msgstr "" -"# zpool status\n" -" pool: mypool\n" -" state: ONLINE\n" -"status: Some supported features are not enabled on the pool. The pool can\n" -" still be used, but some features are unavailable.\n" -"action: Enable all features using 'zpool upgrade'. Once this is done,\n" -" the pool may no longer be accessible by software that does not support\n" -" the features. See zpool-features(7) for details.\n" -" scan: none requested\n" -"config:\n" - -#. type: delimited block . 4 -#: documentation/content/en/books/handbook/zfs/_index.adoc:1315 -#, no-wrap -msgid "All pools are formatted using feature flags.\n" -msgstr "All pools are formatted using feature flags.\n" +"Активирует горячий резерв, когда устройство исчезает из избыточного vdev или " +"когда vdev становится деградировавшим или неисправным." -#. type: delimited block . 4 -#: documentation/content/en/books/handbook/zfs/_index.adoc:1319 -#, no-wrap +#. type: Plain text +#: documentation/content/en/books/handbook/zfs/_index.adoc:1298 msgid "" -"Some supported features are not enabled on the following pools. Once a\n" -"feature is enabled the pool may become incompatible with software\n" -"that does not support the feature. See zpool-features(7) for details.\n" +"Marks a vdev as faulted when it produces more than 50 I/O errors or more " +"than 8 delayed I/O operations in a 60 second period, then activates a hot " +"spare." msgstr "" -"Some supported features are not enabled on the following pools. Once a\n" -"feature is enabled the pool may become incompatible with software\n" -"that does not support the feature. See zpool-features(7) for details.\n" +"Отмечает vdev как отказавший, когда он создает более 50 ошибок ввода-вывода " +"или более 8 отложенных операций ввода-вывода за период в 60 секунд, затем " +"активирует горячий резерв." -#. type: delimited block . 4 -#: documentation/content/en/books/handbook/zfs/_index.adoc:1332 -#, no-wrap +#. type: Plain text +#: documentation/content/en/books/handbook/zfs/_index.adoc:1299 msgid "" -"POOL FEATURE\n" -"---------------\n" -"zstore\n" -" multi_vdev_crash_dump\n" -" spacemap_histogram\n" -" enabled_txg\n" -" hole_birth\n" -" extensible_dataset\n" -" bookmarks\n" -" filesystem_limits\n" -"# zpool upgrade mypool\n" -"This system supports ZFS pool feature flags.\n" +"Marks a vdev as degraded when it produces more than 50 checksum errors in a " +"60 second period, then activates a hot spare." msgstr "" -"POOL FEATURE\n" -"---------------\n" -"zstore\n" -" multi_vdev_crash_dump\n" -" spacemap_histogram\n" -" enabled_txg\n" -" hole_birth\n" -" extensible_dataset\n" -" bookmarks\n" -" filesystem_limits\n" -"# zpool upgrade mypool\n" -"This system supports ZFS pool feature flags.\n" +"Помечает vdev как деградировавший, когда он генерирует более 50 ошибок " +"контрольной суммы за 60-секундный период, затем активирует горячий резерв." -#. type: delimited block . 4 -#: documentation/content/en/books/handbook/zfs/_index.adoc:1340 -#, no-wrap +#. type: Plain text +#: documentation/content/en/books/handbook/zfs/_index.adoc:1300 msgid "" -"Enabled the following features on 'mypool':\n" -" spacemap_histogram\n" -" enabled_txg\n" -" hole_birth\n" -" extensible_dataset\n" -" bookmarks\n" -" filesystem_limits\n" +"Brings a device back online when it reappears, triggering a resilver of the " +"data written while it was missing." msgstr "" -"Enabled the following features on 'mypool':\n" -" spacemap_histogram\n" -" enabled_txg\n" -" hole_birth\n" -" extensible_dataset\n" -" bookmarks\n" -" filesystem_limits\n" +"Возвращает устройство в онлайн-режим, когда оно снова появляется, запуская " +"ресильверинг данных, записанных, пока оно отсутствовало." -#. type: delimited block = 4 -#: documentation/content/en/books/handbook/zfs/_index.adoc:1347 +#. type: Plain text +#: documentation/content/en/books/handbook/zfs/_index.adoc:1301 msgid "" -"Update the boot code on systems that boot from a pool to support the new " -"pool version. Use `gpart bootcode` on the partition that contains the boot " -"code. Two types of bootcode are available, depending on way the system " -"boots: GPT (the most common option) and EFI (for more modern systems)." -msgstr "" -"Обновите загрузочный код на системах, которые загружаются с пула, чтобы " -"поддержать новую версию пула. Используйте `gpart bootcode` для раздела, " -"содержащего загрузочный код. Доступны два типа загрузочного кода в " -"зависимости от способа загрузки системы: GPT (наиболее распространённый " -"вариант) и EFI (для более современных систем)." - -#. type: delimited block = 4 -#: documentation/content/en/books/handbook/zfs/_index.adoc:1349 -msgid "For legacy boot using GPT, use the following command:" +"Replaces a missing device with a new disk that appears at the same physical " +"location when the pool has `autoreplace` set to `on`." msgstr "" -"Для загрузки в устаревшем режиме с использованием GPT используйте следующую " -"команду:" - -#. type: delimited block . 4 -#: documentation/content/en/books/handbook/zfs/_index.adoc:1353 -#, no-wrap -msgid "# gpart bootcode -b /boot/pmbr -p /boot/gptzfsboot -i 1 ada1\n" -msgstr "# gpart bootcode -b /boot/pmbr -p /boot/gptzfsboot -i 1 ada1\n" +"Заменяет отсутствующее устройство новым диском, который появляется в том же " +"физическом местоположении, когда в пуле установлено значение `autoreplace` в " +"`on`." #. type: Plain text -#: documentation/content/en/books/handbook/zfs/_index.adoc:1356 -msgid "For systems using EFI to boot, execute the following command:" -msgstr "" -"Для систем, использующих EFI для загрузки, выполните следующую команду:" - -#. type: delimited block . 4 -#: documentation/content/en/books/handbook/zfs/_index.adoc:1362 -#, no-wrap +#: documentation/content/en/books/handbook/zfs/_index.adoc:1302 msgid "" -"# mount -t msdosfs /dev/ada1p1 /boot/efi\n" -"# cp /boot/loader.efi /boot/efi/efi/boot/BOOTX64.efi\n" -"# cp /boot/loader.efi /boot/efi/efi/freebsd/loader.efi\n" +"Returns hot spares to standby once the resilver of a permanent replacement " +"completes." msgstr "" -"# mount -t msdosfs /dev/ada1p1 /boot/efi\n" -"# cp /boot/loader.efi /boot/efi/efi/boot/BOOTX64.efi\n" -"# cp /boot/loader.efi /boot/efi/efi/freebsd/loader.efi\n" +"Возвращает горячие резервы в режим ожидания после завершения ресильвера " +"постоянной замены." -#. type: Plain text -#: documentation/content/en/books/handbook/zfs/_index.adoc:1367 +#. type: delimited block = 4 +#: documentation/content/en/books/handbook/zfs/_index.adoc:1307 msgid "" -"These instructions apply to amd64 systems. Depending on the architecture, " -"the file has a different name. Refer to man:uefi[8] to find the names of " -"the architecture-specific files." +"FreeBSD uses man:zfsd[8] for fault management. The ZFS Event Daemon (ZED) " +"found on Linux OpenZFS platforms is not part of FreeBSD." msgstr "" -"Данные инструкции применимы к системам amd64. В зависимости от архитектуры " -"файл имеет другое имя. Обратитесь к man:uefi[8], чтобы узнать имена файлов, " -"специфичных для конкретной архитектуры." +"FreeBSD использует man:zfsd[8] для управления отказами. Демон событий ZFS " +"(ZED), присутствующий на платформах Linux OpenZFS, не является частью " +"FreeBSD." #. type: Plain text -#: documentation/content/en/books/handbook/zfs/_index.adoc:1370 +#: documentation/content/en/books/handbook/zfs/_index.adoc:1313 msgid "" -"Apply the bootcode to all bootable disks in the pool. See man:gpart[8] for " -"more information." -msgstr "" -"Примените загрузочный код ко всем загрузочным дискам в пуле. Подробнее см. в " -"man:gpart[8]." +"Inspect the event stream that drives these decisions with `zpool events`. " +"Adding `-v` shows the full payload of each event, and `-f` keeps the command " +"running, printing new events as they arrive. ZFS also delivers these events " +"to man:devd[8]. The rules in [.filename]#/etc/devd/zfs.conf# log them to " +"the system log and serve as a template for custom actions, such as sending " +"mail when a pool becomes degraded." +msgstr "" +"Изучите поток событий, который управляет этими решениями, с помощью `zpool " +"events`. Добавление `-v` показывает полную полезную нагрузку каждого " +"события, а `-f` оставляет команду работающей, выводя новые события по мере " +"их поступления. ZFS также доставляет эти события в man:devd[8]. Правила в [." +"filename]#/etc/devd/zfs.conf# записывают их в системный журнал и служат " +"шаблоном для пользовательских действий, таких как отправка почты при " +"деградации пула." #. type: Title === -#: documentation/content/en/books/handbook/zfs/_index.adoc:1373 +#: documentation/content/en/books/handbook/zfs/_index.adoc:1315 #, no-wrap -msgid "Displaying Recorded Pool History" -msgstr "Отображение записанной истории пулов" +msgid "Scrubbing a Pool" +msgstr "Чистка пула" -#. type: delimited block = 4 -#: documentation/content/en/books/handbook/zfs/_index.adoc:1379 +#. type: Plain text +#: documentation/content/en/books/handbook/zfs/_index.adoc:1320 msgid "" -"ZFS records commands that change the pool, including creating datasets, " -"changing properties, or replacing a disk. Reviewing history about a pool's " -"creation is useful, as is checking which user performed a specific action " -"and when. History is not kept in a log file, but is part of the pool " -"itself. The command to review this history is aptly named `zpool history`:" +"Routinely crossref:zfs[zfs-term-scrub,scrub] pools, ideally at least once " +"every month. The `scrub` operation is disk-intensive and will reduce " +"performance while running. Avoid high-demand periods when scheduling " +"`scrub`, or lower its impact with the I/O scheduler tunables described in " +"crossref:zfs[zfs-advanced-tuning,Tuning]." msgstr "" -"ZFS записывает команды, которые изменяют пул, включая создание наборов " -"данных, изменение свойств или замену диска. Просмотр истории создания пула " -"полезен, так же как и проверка того, какой пользователь выполнил конкретное " -"действие и когда. История не хранится в файле журнала, а является частью " -"самого пула. Команда для просмотра этой истории называется `zpool history`:" +"Регулярно выполняйте crossref:zfs[zfs-term-scrub,scrub] для пулов, " +"желательно не реже одного раза в месяц. Операция `scrub` интенсивно " +"использует диски и может снизить производительность во время выполнения. " +"Избегайте периодов высокой нагрузки при планировании `scrub` или снизьте его " +"влияние с помощью настраиваемых параметров планировщика ввода-вывода, " +"описанных в crossref:zfs[zfs-advanced-tuning,разделе «Настройка»]." #. type: delimited block . 4 -#: documentation/content/en/books/handbook/zfs/_index.adoc:1388 +#: documentation/content/en/books/handbook/zfs/_index.adoc:1331 #, no-wrap msgid "" -"# zpool history\n" -"History for 'tank':\n" -"2013-02-26.23:02:35 zpool create tank mirror /dev/ada0 /dev/ada1\n" -"2013-02-27.18:50:58 zfs set atime=off tank\n" -"2013-02-27.18:51:09 zfs set checksum=fletcher4 tank\n" -"2013-02-27.18:51:18 zfs create tank/backup\n" +"# zpool scrub mypool\n" +"# zpool status\n" +" pool: mypool\n" +" state: ONLINE\n" +" scan: scrub in progress since Sat Jul 11 20:52:54 2026\n" +" 130G / 8.60T scanned at 649M/s, 116G / 8.60T issued at 580M/s\n" +" 0B repaired, 1.32% done, 04:15:41 to go\n" +"config:\n" msgstr "" -"# zpool history\n" -"History for 'tank':\n" -"2013-02-26.23:02:35 zpool create tank mirror /dev/ada0 /dev/ada1\n" -"2013-02-27.18:50:58 zfs set atime=off tank\n" -"2013-02-27.18:51:09 zfs set checksum=fletcher4 tank\n" -"2013-02-27.18:51:18 zfs create tank/backup\n" +"# zpool scrub mypool\n" +"# zpool status\n" +" pool: mypool\n" +" state: ONLINE\n" +" scan: scrub in progress since Sat Jul 11 20:52:54 2026\n" +" 130G / 8.60T scanned at 649M/s, 116G / 8.60T issued at 580M/s\n" +" 0B repaired, 1.32% done, 04:15:41 to go\n" +"config:\n" #. type: Plain text -#: documentation/content/en/books/handbook/zfs/_index.adoc:1393 +#: documentation/content/en/books/handbook/zfs/_index.adoc:1350 msgid "" -"The output shows `zpool` and `zfs` commands altering the pool in some way " -"along with a timestamp. Commands like `zfs list` are not included. When " -"specifying no pool name, ZFS displays history of all pools." +"Pause a running scrub with `zpool scrub -p _mypool_` when it interferes with " +"other work; running `zpool scrub _mypool_` again resumes it from where it " +"stopped. To cancel a scrub operation instead, run `zpool scrub -s " +"_mypool_`. `zpool scrub -w _mypool_` waits until the scrub completes before " +"returning, which is useful in scripts. After a scrub reports errors, `zpool " +"scrub -e _mypool_` performs an _error scrub_ that re-verifies only the " +"blocks with known errors, finishing much faster than a full scrub. The " +"error scrub requires OpenZFS 2.2, first shipped in FreeBSD 14.0." msgstr "" -"Вывод показывает команды `zpool` и `zfs`, изменяющие пул каким-либо образом, " -"вместе с временной меткой. Команды вроде `zfs list` не включаются. Если имя " -"пула не указано, ZFS отображает историю всех пулов." +"Приостановите выполняющуюся проверку с помощью `zpool scrub -p _mypool_`, " +"если она мешает другой работе; повторный запуск `zpool scrub _mypool_` " +"возобновит её с того места, где она остановилась. Чтобы вместо этого " +"отменить операцию проверки, выполните `zpool scrub -s _mypool_`. Команда `" +"zpool scrub -w _mypool_` ожидает завершения проверки перед возвратом, что " +"полезно в скриптах. Если после проверки сообщается об ошибках, `zpool scrub -" +"e _mypool_` выполняет _проверку ошибок_, которая повторно проверяет только " +"блоки с известными ошибками, завершаясь гораздо быстрее, чем полная " +"проверка. Проверка ошибок требует OpenZFS 2.2, впервые включённого в FreeBSD " +"14.0." #. type: Plain text -#: documentation/content/en/books/handbook/zfs/_index.adoc:1396 +#: documentation/content/en/books/handbook/zfs/_index.adoc:1353 msgid "" -"`zpool history` can show even more information when providing the options `-" -"i` or `-l`. `-i` displays user-initiated events as well as internally " -"logged ZFS events." +"man:periodic[8] can run scrubs automatically. To scrub every pool whose " +"last scrub is more than 35 days old, add this line to [.filename]#/etc/" +"periodic.conf#:" msgstr "" -"`zpool history` может отображать ещё больше информации при использовании " -"опций `-i` или `-l`. Опция `-i` показывает события, инициированные " -"пользователем, а также внутренние события ZFS, зарегистрированные в журнале." +"man:periodic[8] может автоматически запускать проверки. Чтобы проверить " +"каждый пул, последняя проверка которого была более 35 дней назад, добавьте " +"эту строку в [.filename]#/etc/periodic.conf#:" #. type: delimited block . 4 -#: documentation/content/en/books/handbook/zfs/_index.adoc:1408 +#: documentation/content/en/books/handbook/zfs/_index.adoc:1357 #, no-wrap -msgid "" -"# zpool history -i\n" -"History for 'tank':\n" -"2013-02-26.23:02:35 [internal pool create txg:5] pool spa 28; zfs spa 28; zpl 5;uts 9.1-RELEASE 901000 amd64\n" -"2013-02-27.18:50:53 [internal property set txg:50] atime=0 dataset = 21\n" -"2013-02-27.18:50:58 zfs set atime=off tank\n" -"2013-02-27.18:51:04 [internal property set txg:53] checksum=7 dataset = 21\n" -"2013-02-27.18:51:09 zfs set checksum=fletcher4 tank\n" -"2013-02-27.18:51:13 [internal create txg:55] dataset = 39\n" -"2013-02-27.18:51:18 zfs create tank/backup\n" -msgstr "" -"# zpool history -i\n" -"History for 'tank':\n" -"2013-02-26.23:02:35 [internal pool create txg:5] pool spa 28; zfs spa 28; zpl 5;uts 9.1-RELEASE 901000 amd64\n" -"2013-02-27.18:50:53 [internal property set txg:50] atime=0 dataset = 21\n" -"2013-02-27.18:50:58 zfs set atime=off tank\n" -"2013-02-27.18:51:04 [internal property set txg:53] checksum=7 dataset = 21\n" -"2013-02-27.18:51:09 zfs set checksum=fletcher4 tank\n" -"2013-02-27.18:51:13 [internal create txg:55] dataset = 39\n" -"2013-02-27.18:51:18 zfs create tank/backup\n" +msgid "daily_scrub_zfs_enable=\"YES\"\n" +msgstr "daily_scrub_zfs_enable=\"YES\"\n" #. type: Plain text -#: documentation/content/en/books/handbook/zfs/_index.adoc:1412 +#: documentation/content/en/books/handbook/zfs/_index.adoc:1362 msgid "" -"Show more details by adding `-l`. Showing history records in a long format, " -"including information like the name of the user who issued the command and " -"the hostname on which the change happened." +"Set `daily_scrub_zfs_default_threshold=\"_days_\"` to change the number of " +"days between scrubs. man:periodic.conf[5] also describes per-pool " +"thresholds. Setting `daily_status_zfs_enable=\"YES\"` adds a pool health " +"check to the daily man:periodic[8] report." msgstr "" -"Показать более подробную информацию, добавив `-l`. Отображение записей " -"истории в длинном формате, включая такие сведения, как имя пользователя, " -"выполнившего команду, и имя хоста, на котором произошло изменение." +"Установите `daily_scrub_zfs_default_threshold=\"_дней_\"`, чтобы изменить " +"количество дней между проверками. man:periodic.conf[5] также описывает " +"пороговые значения для отдельных пулов. Установка `daily_status_zfs_enable=" +"\"YES\"` добавляет проверку состояния пула в ежедневный отчёт " +"man:periodic[8]." -#. type: delimited block . 4 -#: documentation/content/en/books/handbook/zfs/_index.adoc:1421 +#. type: Title === +#: documentation/content/en/books/handbook/zfs/_index.adoc:1364 #, no-wrap +msgid "Self-Healing" +msgstr "Самолечение" + +#. type: Plain text +#: documentation/content/en/books/handbook/zfs/_index.adoc:1375 msgid "" -"# zpool history -l\n" -"History for 'tank':\n" -"2013-02-26.23:02:35 zpool create tank mirror /dev/ada0 /dev/ada1 [user 0 (root) on :global]\n" -"2013-02-27.18:50:58 zfs set atime=off tank [user 0 (root) on myzfsbox:global]\n" -"2013-02-27.18:51:09 zfs set checksum=fletcher4 tank [user 0 (root) on myzfsbox:global]\n" -"2013-02-27.18:51:18 zfs create tank/backup [user 0 (root) on myzfsbox:global]\n" +"The checksums stored with data blocks enable the file system to _self-" +"heal_. This feature will automatically repair data whose checksum does not " +"match the one recorded on another device that is part of the storage pool. " +"For example, a mirror configuration with two disks where one drive is " +"starting to malfunction and cannot properly store the data any more. This " +"is worse when the data was not accessed for a long time, as with long term " +"archive storage. Traditional file systems need to run commands that check " +"and repair the data like man:fsck[8]. These commands take time, and in " +"severe cases, an administrator has to decide which repair operation to " +"perform. When ZFS detects a data block with a mismatched checksum, it tries " +"to read the data from the mirror disk. If that disk can provide the correct " +"data, ZFS will give that to the application and correct the data on the disk " +"with the wrong checksum. This happens without any interaction from a system " +"administrator during normal pool operation." msgstr "" -"# zpool history -l\n" -"History for 'tank':\n" -"2013-02-26.23:02:35 zpool create tank mirror /dev/ada0 /dev/ada1 [user 0 (root) on :global]\n" -"2013-02-27.18:50:58 zfs set atime=off tank [user 0 (root) on myzfsbox:global]\n" -"2013-02-27.18:51:09 zfs set checksum=fletcher4 tank [user 0 (root) on myzfsbox:global]\n" -"2013-02-27.18:51:18 zfs create tank/backup [user 0 (root) on myzfsbox:global]\n" +"Контрольные суммы, хранимые с блоками данных, позволяют файловой системе " +"_самовосстанавливаться_. Эта функция автоматически исправляет данные, " +"контрольная сумма которых не совпадает с записанной на другом устройстве, " +"входящем в состав пула хранения. Например, в конфигурации зеркала с двумя " +"дисками, где один из дисков начинает работать со сбоями и больше не может " +"корректно хранить данные. Это становится ещё хуже, если данные долгое время " +"не были доступны, как в случае долгосрочного архивного хранения. " +"Традиционные файловые системы требуют выполнения команд для проверки и " +"исправления данных, таких как man:fsck[8]. Эти команды занимают время, а в " +"сложных случаях администратору приходится выбирать, какую операцию " +"восстановления выполнить. Когда ZFS обнаруживает блок данных с несовпадающей " +"контрольной суммой, он пытается прочитать данные с зеркального диска. Если " +"этот диск может предоставить корректные данные, ZFS передаст их приложению и " +"исправит данные на диске с ошибочной контрольной суммой. Это происходит без " +"какого-либо вмешательства администратора в ходе обычной работы пула." #. type: Plain text -#: documentation/content/en/books/handbook/zfs/_index.adoc:1427 +#: documentation/content/en/books/handbook/zfs/_index.adoc:1377 msgid "" -"The output shows that the `root` user created the mirrored pool with disks [." -"filename]#/dev/ada0# and [.filename]#/dev/ada1#. The hostname `myzfsbox` is " -"also shown in the commands after the pool's creation. The hostname display " -"becomes important when exporting the pool from one system and importing on " -"another. It's possible to distinguish the commands issued on the other " -"system by the hostname recorded for each command." +"The next example shows this self-healing behavior by creating a mirrored " +"pool of partitions [.filename]#/dev/ada0p1# and [.filename]#/dev/ada1p1#." msgstr "" -"Вывод показывает, что пользователь `root` создал зеркальный пул с дисками [." -"filename]#/dev/ada0# и [.filename]#/dev/ada1#. Также в командах после " -"создания пула отображается имя хоста `myzfsbox`. Отображение имени хоста " -"становится важным при экспорте пула с одной системы и импорте на другую. " -"Можно различить команды, выполненные на другой системе, по имени хоста, " -"записанному для каждой команды." +"Следующий пример демонстрирует самовосстановление при создании зеркального " +"пула из разделов [.filename]#/dev/ada0p1# и [.filename]#/dev/ada1p1#." -#. type: Plain text -#: documentation/content/en/books/handbook/zfs/_index.adoc:1430 +#. type: delimited block . 4 +#: documentation/content/en/books/handbook/zfs/_index.adoc:1385 +#, no-wrap msgid "" -"Combine both options to `zpool history` to give the most detailed " -"information possible for any given pool. Pool history provides valuable " -"information when tracking down the actions performed or when needing more " -"detailed output for debugging." +"# zpool create healer mirror /dev/ada0p1 /dev/ada1p1\n" +"# zpool status healer\n" +" pool: healer\n" +" state: ONLINE\n" +"config:\n" msgstr "" -"Объедините оба варианта с `zpool history`, чтобы получить максимально " -"детальную информацию для любого заданного пула. История пула предоставляет " -"ценную информацию при отслеживании выполненных действий или необходимости " -"более детального вывода для отладки." +"# zpool create healer mirror /dev/ada0p1 /dev/ada1p1\n" +"# zpool status healer\n" +" pool: healer\n" +" state: ONLINE\n" +"config:\n" -#. type: Title === -#: documentation/content/en/books/handbook/zfs/_index.adoc:1432 +#. type: delimited block . 4 +#: documentation/content/en/books/handbook/zfs/_index.adoc:1391 +#: documentation/content/en/books/handbook/zfs/_index.adoc:1545 #, no-wrap -msgid "Performance Monitoring" -msgstr "Мониторинг производительности" +msgid "" +" NAME STATE READ WRITE CKSUM\n" +" healer ONLINE 0 0 0\n" +" mirror-0 ONLINE 0 0 0\n" +" ada0p1 ONLINE 0 0 0\n" +" ada1p1 ONLINE 0 0 0\n" +msgstr "" +" NAME STATE READ WRITE CKSUM\n" +" healer ONLINE 0 0 0\n" +" mirror-0 ONLINE 0 0 0\n" +" ada0p1 ONLINE 0 0 0\n" +" ada1p1 ONLINE 0 0 0\n" + +#. type: delimited block . 4 +#: documentation/content/en/books/handbook/zfs/_index.adoc:1396 +#, no-wrap +msgid "" +"errors: No known data errors\n" +"# zpool list\n" +"NAME SIZE ALLOC FREE CKPOINT EXPANDSZ FRAG CAP DEDUP HEALTH ALTROOT\n" +"healer 960M 111K 960M - - 0% 0% 1.00x ONLINE -\n" +msgstr "" +"errors: No known data errors\n" +"# zpool list\n" +"NAME SIZE ALLOC FREE CKPOINT EXPANDSZ FRAG CAP DEDUP " +"HEALTH ALTROOT\n" +"healer 960M 111K 960M - - 0% 0% 1.00x " +"ONLINE -\n" #. type: Plain text -#: documentation/content/en/books/handbook/zfs/_index.adoc:1439 +#: documentation/content/en/books/handbook/zfs/_index.adoc:1399 msgid "" -"A built-in monitoring system can display pool I/O statistics in real time. " -"It shows the amount of free and used space on the pool, read and write " -"operations performed per second, and I/O bandwidth used. By default, ZFS " -"monitors and displays all pools in the system. Provide a pool name to limit " -"monitoring to that pool. A basic example:" +"Copy some important data to the pool to protect from data errors using the " +"self-healing feature and create a checksum of the pool for later comparison." msgstr "" -"Встроенная система мониторинга может отображать статистику операций ввода-" -"вывода пула в реальном времени. Она показывает объём свободного и занятого " -"пространства в пуле, количество операций чтения и записи в секунду, а также " -"используемую пропускную способность ввода-вывода. По умолчанию ZFS " -"отслеживает и отображает все пулы в системе. Укажите имя пула, чтобы " -"ограничить мониторинг только этим пулом. Простой пример:" +"Скопируйте какие-нибудь важные данные в пул для защиты от ошибок данных с " +"использованием функции самовосстановления и создайте контрольную сумму пула " +"для последующего сравнения." #. type: delimited block . 4 -#: documentation/content/en/books/handbook/zfs/_index.adoc:1447 +#: documentation/content/en/books/handbook/zfs/_index.adoc:1409 #, no-wrap msgid "" -"# zpool iostat\n" -" capacity operations bandwidth\n" -"pool alloc free read write read write\n" -"---------- ----- ----- ----- ----- ----- -----\n" -"data 288G 1.53T 2 11 11.3K 57.1K\n" +"# cp /some/important/data /healer\n" +"# zpool list\n" +"NAME SIZE ALLOC FREE CKPOINT EXPANDSZ FRAG CAP DEDUP HEALTH ALTROOT\n" +"healer 960M 67.7M 892M - - 0% 7% 1.00x ONLINE -\n" +"# sha1 /healer > checksum.txt\n" +"# cat checksum.txt\n" +"SHA1 (/healer) = 2753eff56d77d9a536ece6694bf0a82740344d1f\n" msgstr "" -"# zpool iostat\n" -" capacity operations bandwidth\n" -"pool alloc free read write read write\n" -"---------- ----- ----- ----- ----- ----- -----\n" -"data 288G 1.53T 2 11 11.3K 57.1K\n" +"# cp /some/important/data /healer\n" +"# zpool list\n" +"NAME SIZE ALLOC FREE CKPOINT EXPANDSZ FRAG CAP DEDUP " +"HEALTH ALTROOT\n" +"healer 960M 67.7M 892M - - 0% 7% 1.00x " +"ONLINE -\n" +"# sha1 /healer > checksum.txt\n" +"# cat checksum.txt\n" +"SHA1 (/healer) = 2753eff56d77d9a536ece6694bf0a82740344d1f\n" #. type: Plain text -#: documentation/content/en/books/handbook/zfs/_index.adoc:1453 +#: documentation/content/en/books/handbook/zfs/_index.adoc:1413 msgid "" -"To continuously see I/O activity, specify a number as the last parameter, " -"indicating an interval in seconds to wait between updates. The next " -"statistic line prints after each interval. Press kbd:[Ctrl+C] to stop this " -"continuous monitoring. Give a second number on the command line after the " -"interval to specify the total number of statistics to display." +"Simulate data corruption by writing random data to the beginning of one of " +"the disks in the mirror. To keep ZFS from healing the data when detected, " +"export the pool before the corruption and import it again afterwards." msgstr "" -"Чтобы непрерывно отслеживать активность ввода-вывода, укажите число в " -"качестве последнего параметра, задающее интервал в секундах между " -"обновлениями. Следующая строка статистики выводится после каждого интервала. " -"Нажмите kbd:[Ctrl+C], чтобы остановить непрерывный мониторинг. Укажите " -"второе число в командной строке после интервала, чтобы задать общее " -"количество отображаемой статистики." +"Симулируйте повреждение данных, записав случайные данные в начало одного из " +"дисков в зеркале. Чтобы предотвратить восстановление данных ZFS при " +"обнаружении, экспортируйте пул перед повреждением и снова импортируйте его " +"после." -#. type: Plain text -#: documentation/content/en/books/handbook/zfs/_index.adoc:1458 +#. type: delimited block = 4 +#: documentation/content/en/books/handbook/zfs/_index.adoc:1421 msgid "" -"Display even more detailed I/O statistics with `-v`. Each device in the " -"pool appears with a statistics line. This is useful for seeing read and " -"write operations performed on each device, and can help determine if any " -"individual device is slowing down the pool. This example shows a mirrored " -"pool with two devices:" +"This is a dangerous operation that can destroy vital data, shown here for " +"demonstration alone. *Do not try* it during normal operation of a storage " +"pool. Nor should this intentional corruption example run on any disk with a " +"file system not using ZFS on another partition in it. Do not use any other " +"disk device names other than the ones that are part of the pool. Ensure " +"proper backups of the pool exist and test them before running the command!" msgstr "" -"Отображать более детальную статистику ввода-вывода с помощью `-v`. Каждое " -"устройство в пуле отображается с отдельной строкой статистики. Это полезно " -"для просмотра операций чтения и записи, выполняемых на каждом устройстве, и " -"может помочь определить, замедляет ли какое-либо отдельное устройство работу " -"пула. В этом примере показан зеркальный пул с двумя устройствами:" +"Это опасная операция, которая может уничтожить важные данные, и приведена " +"здесь только для демонстрации. *Не пытайтесь* выполнить её во время " +"нормальной работы хранилища данных. Также этот пример преднамеренного " +"повреждения не должен выполняться на диске, содержащем файловую систему, не " +"использующую ZFS на другом разделе. Не используйте имена дисковых устройств, " +"кроме тех, что входят в пул. Убедитесь, что существуют резервные копии пула, " +"и проверьте их перед выполнением команды!" #. type: delimited block . 4 -#: documentation/content/en/books/handbook/zfs/_index.adoc:1470 +#: documentation/content/en/books/handbook/zfs/_index.adoc:1431 #, no-wrap msgid "" -"# zpool iostat -v\n" -" capacity operations bandwidth\n" -"pool alloc free read write read write\n" -"----------------------- ----- ----- ----- ----- ----- -----\n" -"data 288G 1.53T 2 12 9.23K 61.5K\n" -" mirror 288G 1.53T 2 12 9.23K 61.5K\n" -" ada1 - - 0 4 5.61K 61.7K\n" -" ada2 - - 1 4 5.04K 61.7K\n" -"----------------------- ----- ----- ----- ----- ----- -----\n" +"# zpool export healer\n" +"# dd if=/dev/random of=/dev/ada1p1 bs=1m count=200\n" +"200+0 records in\n" +"200+0 records out\n" +"209715200 bytes transferred in 62.992162 secs (3329227 bytes/sec)\n" +"# zpool import healer\n" msgstr "" -"# zpool iostat -v\n" -" capacity operations bandwidth\n" -"pool alloc free read write read write\n" -"----------------------- ----- ----- ----- ----- ----- -----\n" -"data 288G 1.53T 2 12 9.23K 61.5K\n" -" mirror 288G 1.53T 2 12 9.23K 61.5K\n" -" ada1 - - 0 4 5.61K 61.7K\n" -" ada2 - - 1 4 5.04K 61.7K\n" -"----------------------- ----- ----- ----- ----- ----- -----\n" - -#. type: Title === -#: documentation/content/en/books/handbook/zfs/_index.adoc:1473 -#, no-wrap -msgid "Splitting a Storage Pool" -msgstr "Разделение пула хранения данных" +"# zpool export healer\n" +"# dd if=/dev/random of=/dev/ada1p1 bs=1m count=200\n" +"200+0 records in\n" +"200+0 records out\n" +"209715200 bytes transferred in 62.992162 secs (3329227 bytes/sec)\n" +"# zpool import healer\n" #. type: Plain text -#: documentation/content/en/books/handbook/zfs/_index.adoc:1480 +#: documentation/content/en/books/handbook/zfs/_index.adoc:1437 msgid "" -"ZFS can split a pool consisting of one or more mirror vdevs into two pools. " -"Unless otherwise specified, ZFS detaches the last member of each mirror and " -"creates a new pool containing the same data. Be sure to make a dry run of " -"the operation with `-n` first. This displays the details of the requested " -"operation without actually performing it. This helps confirm that the " -"operation will do what the user intends." +"The pool status shows that one device has experienced an error. Note that " +"applications reading data from the pool did not receive any incorrect data. " +"ZFS provided data from the [.filename]#ada0p1# device with the correct " +"checksums. To find the device with the wrong checksum, look for one whose " +"`CKSUM` column contains a nonzero value." msgstr "" -"ZFS может разделить пул, состоящий из одного или нескольких зеркальных vdev, " -"на два пула. Если не указано иное, ZFS отсоединяет последний элемент каждого " -"зеркала и создаёт новый пул с теми же данными. Обязательно выполните пробный " -"запуск операции с параметром `-n` сначала. Это отобразит детали запрошенной " -"операции без её фактического выполнения. Это помогает убедиться, что " -"операция выполнит то, что задумал пользователь." +"Статус пула показывает, что на одном устройстве произошла ошибка. Обратите " +"внимание, что приложения, читающие данные из пула, не получили некорректных " +"данных. ZFS предоставил данные с устройства [.filename]#ada0p1# с " +"правильными контрольными суммами. Чтобы найти устройство с неверной " +"контрольной суммой, ищите то, у которого в столбце `CKSUM` указано ненулевое " +"значение." -#. type: Title == -#: documentation/content/en/books/handbook/zfs/_index.adoc:1482 +#. type: delimited block . 4 +#: documentation/content/en/books/handbook/zfs/_index.adoc:1449 #, no-wrap -msgid "`zfs` Administration" -msgstr "Управление с помощью утилиты`zfs`" - -#. type: Plain text -#: documentation/content/en/books/handbook/zfs/_index.adoc:1486 msgid "" -"The `zfs` utility can create, destroy, and manage all existing ZFS datasets " -"within a pool. To manage the pool itself, use crossref:zfs[zfs-zpool," -"`zpool`]." +"# zpool status healer\n" +" pool: healer\n" +" state: ONLINE\n" +"status: One or more devices has experienced an unrecoverable error. An\n" +" attempt was made to correct the error. Applications are unaffected.\n" +"action: Determine if the device needs to be replaced, and clear the errors\n" +" using 'zpool clear' or replace the device with 'zpool replace'.\n" +" see: https://openzfs.github.io/openzfs-docs/msg/ZFS-8000-9P\n" +"config:\n" msgstr "" -"Утилита `zfs` позволяет создавать, удалять и управлять всеми существующими " -"наборами данных ZFS в пределах пула. Для управления самим пулом используйте " -"crossref:zfs[zfs-zpool,`zpool`]." +"# zpool status healer\n" +" pool: healer\n" +" state: ONLINE\n" +"status: One or more devices has experienced an unrecoverable error. An\n" +" attempt was made to correct the error. Applications are unaffected." +"\n" +"action: Determine if the device needs to be replaced, and clear the errors\n" +" using 'zpool clear' or replace the device with 'zpool replace'.\n" +" see: https://openzfs.github.io/openzfs-docs/msg/ZFS-8000-9P\n" +"config:\n" -#. type: Title === -#: documentation/content/en/books/handbook/zfs/_index.adoc:1488 +#. type: delimited block . 4 +#: documentation/content/en/books/handbook/zfs/_index.adoc:1455 #, no-wrap -msgid "Creating and Destroying Datasets" -msgstr "Создание и удаление наборов данных" +msgid "" +" NAME STATE READ WRITE CKSUM\n" +" healer ONLINE 0 0 0\n" +" mirror-0 ONLINE 0 0 0\n" +" ada0p1 ONLINE 0 0 0\n" +" ada1p1 ONLINE 0 0 1\n" +msgstr "" +" NAME STATE READ WRITE CKSUM\n" +" healer ONLINE 0 0 0\n" +" mirror-0 ONLINE 0 0 0\n" +" ada0p1 ONLINE 0 0 0\n" +" ada1p1 ONLINE 0 0 1\n" #. type: Plain text -#: documentation/content/en/books/handbook/zfs/_index.adoc:1499 +#: documentation/content/en/books/handbook/zfs/_index.adoc:1461 msgid "" -"Unlike traditional disks and volume managers, space in ZFS is _not_ " -"preallocated. With traditional file systems, after partitioning and " -"assigning the space, there is no way to add a new file system without adding " -"a new disk. With ZFS, creating new file systems is possible at any time. " -"Each crossref:zfs[zfs-term-dataset,_dataset_] has properties including " -"features like compression, deduplication, caching, and quotas, as well as " -"other useful properties like readonly, case sensitivity, network file " -"sharing, and a mount point. Nesting datasets within each other is possible " -"and child datasets will inherit properties from their ancestors. crossref:" -"zfs[zfs-zfs-allow,Delegate], crossref:zfs[zfs-zfs-send,replicate], crossref:" -"zfs[zfs-zfs-snapshot,snapshot], crossref:zfs[zfs-zfs-jail,jail] allows " -"administering and destroying each dataset as a unit. Creating a separate " -"dataset for each different type or set of files has advantages. The " +"ZFS detected the error and handled it by using the redundancy present in the " +"unaffected [.filename]#ada0p1# mirror device. A checksum comparison with " +"the original one will reveal whether the pool is consistent again." +msgstr "" +"ZFS обнаружил ошибку и обработал её, используя избыточность на " +"неповреждённом зеркальном диске [.filename]#ada0p1#. Сравнение контрольных " +"сумм с исходными покажет, восстановлена ли согласованность пула." + +#. type: delimited block . 4 +#: documentation/content/en/books/handbook/zfs/_index.adoc:1468 +#, no-wrap +msgid "" +"# sha1 /healer >> checksum.txt\n" +"# cat checksum.txt\n" +"SHA1 (/healer) = 2753eff56d77d9a536ece6694bf0a82740344d1f\n" +"SHA1 (/healer) = 2753eff56d77d9a536ece6694bf0a82740344d1f\n" +msgstr "" +"# sha1 /healer >> checksum.txt\n" +"# cat checksum.txt\n" +"SHA1 (/healer) = 2753eff56d77d9a536ece6694bf0a82740344d1f\n" +"SHA1 (/healer) = 2753eff56d77d9a536ece6694bf0a82740344d1f\n" + +#. type: Plain text +#: documentation/content/en/books/handbook/zfs/_index.adoc:1477 +msgid "" +"Generate checksums before and after the intentional tampering while the pool " +"data still matches. This shows how ZFS is capable of detecting and " +"correcting any errors automatically when the checksums differ. Note this is " +"possible with enough redundancy present in the pool. A pool consisting of a " +"single device has no self-healing capabilities. That is also the reason why " +"checksums are so important in ZFS; do not disable them for any reason. ZFS " +"requires no man:fsck[8] or similar file system consistency check program to " +"detect and correct this, and keeps the pool available while there is a " +"problem. A scrub operation is now required to overwrite the corrupted data " +"on [.filename]#ada1p1#." +msgstr "" +"Генерируйте контрольные суммы до и после намеренного изменения данных, пока " +"данные в пуле ещё совпадают. Это демонстрирует, как ZFS способен " +"автоматически обнаруживать и исправлять любые ошибки, когда контрольные " +"суммы различаются. Обратите внимание, что это возможно только при наличии " +"достаточной избыточности в пуле. Пул, состоящий из одного устройства, не " +"обладает возможностями самовосстановления. Именно поэтому контрольные суммы " +"так важны в ZFS — не отключайте их ни по какой причине. ZFS не требует " +"использования man:fsck[8] или аналогичной программы проверки целостности " +"файловой системы для обнаружения и исправления ошибок, а также поддерживает " +"доступность пула даже при наличии проблемы. Теперь требуется операция scrub " +"для перезаписи поврежденных данных на [.filename]#ada1p1#." + +#. type: delimited block . 4 +#: documentation/content/en/books/handbook/zfs/_index.adoc:1493 +#, no-wrap +msgid "" +"# zpool scrub healer\n" +"# zpool status healer\n" +" pool: healer\n" +" state: ONLINE\n" +"status: One or more devices has experienced an unrecoverable error. An\n" +" attempt was made to correct the error. Applications are unaffected.\n" +"action: Determine if the device needs to be replaced, and clear the errors\n" +" using 'zpool clear' or replace the device with 'zpool replace'.\n" +" see: https://openzfs.github.io/openzfs-docs/msg/ZFS-8000-9P\n" +" scan: scrub in progress since Sat Jul 11 10:34:02 2026\n" +" 40.8M scanned at 20.4M/s, 24.9M issued at 12.4M/s, 67.0M total\n" +" 9.63M repaired, 37.16% done, 00:00:03 to go\n" +"config:\n" +msgstr "" +"# zpool scrub healer\n" +"# zpool status healer\n" +" pool: healer\n" +" state: ONLINE\n" +"status: One or more devices has experienced an unrecoverable error. An\n" +" attempt was made to correct the error. Applications are unaffected." +"\n" +"action: Determine if the device needs to be replaced, and clear the errors\n" +" using 'zpool clear' or replace the device with 'zpool replace'.\n" +" see: https://openzfs.github.io/openzfs-docs/msg/ZFS-8000-9P\n" +" scan: scrub in progress since Sat Jul 11 10:34:02 2026\n" +" 40.8M scanned at 20.4M/s, 24.9M issued at 12.4M/s, 67.0M total\n" +" 9.63M repaired, 37.16% done, 00:00:03 to go\n" +"config:\n" + +#. type: delimited block . 4 +#: documentation/content/en/books/handbook/zfs/_index.adoc:1499 +#, no-wrap +msgid "" +" NAME STATE READ WRITE CKSUM\n" +" healer ONLINE 0 0 0\n" +" mirror-0 ONLINE 0 0 0\n" +" ada0p1 ONLINE 0 0 0\n" +" ada1p1 ONLINE 0 0 627 (repairing)\n" +msgstr "" +" NAME STATE READ WRITE CKSUM\n" +" healer ONLINE 0 0 0\n" +" mirror-0 ONLINE 0 0 0\n" +" ada0p1 ONLINE 0 0 0\n" +" ada1p1 ONLINE 0 0 627 (repairing)\n" + +#. type: Plain text +#: documentation/content/en/books/handbook/zfs/_index.adoc:1505 +msgid "" +"The scrub operation reads data from [.filename]#ada0p1# and rewrites any " +"data with a wrong checksum on [.filename]#ada1p1#, shown by the " +"`(repairing)` output from `zpool status`. After the operation is complete, " +"the pool status changes to:" +msgstr "" +"Операция scrub читает данные с [.filename]#ada0p1# и перезаписывает любые " +"данные с некорректной контрольной суммой на [.filename]#ada1p1#, что " +"отображается как `(repairing)` в выводе `zpool status`. После завершения " +"операции состояние пула изменяется на:" + +#. type: delimited block . 4 +#: documentation/content/en/books/handbook/zfs/_index.adoc:1518 +#, no-wrap +msgid "" +"# zpool status healer\n" +" pool: healer\n" +" state: ONLINE\n" +"status: One or more devices has experienced an unrecoverable error. An\n" +" attempt was made to correct the error. Applications are unaffected.\n" +"action: Determine if the device needs to be replaced, and clear the errors\n" +" using 'zpool clear' or replace the device with 'zpool replace'.\n" +" see: https://openzfs.github.io/openzfs-docs/msg/ZFS-8000-9P\n" +" scan: scrub repaired 66.5M in 00:00:06 with 0 errors on Sat Jul 11 10:34:08 2026\n" +"config:\n" +msgstr "" +"# zpool status healer\n" +" pool: healer\n" +" state: ONLINE\n" +"status: One or more devices has experienced an unrecoverable error. An\n" +" attempt was made to correct the error. Applications are unaffected." +"\n" +"action: Determine if the device needs to be replaced, and clear the errors\n" +" using 'zpool clear' or replace the device with 'zpool replace'.\n" +" see: https://openzfs.github.io/openzfs-docs/msg/ZFS-8000-9P\n" +" scan: scrub repaired 66.5M in 00:00:06 with 0 errors on Sat Jul 11 10:34:" +"08 2026\n" +"config:\n" + +#. type: delimited block . 4 +#: documentation/content/en/books/handbook/zfs/_index.adoc:1524 +#, no-wrap +msgid "" +" NAME STATE READ WRITE CKSUM\n" +" healer ONLINE 0 0 0\n" +" mirror-0 ONLINE 0 0 0\n" +" ada0p1 ONLINE 0 0 0\n" +" ada1p1 ONLINE 0 0 2.72K\n" +msgstr "" +" NAME STATE READ WRITE CKSUM\n" +" healer ONLINE 0 0 0\n" +" mirror-0 ONLINE 0 0 0\n" +" ada0p1 ONLINE 0 0 0\n" +" ada1p1 ONLINE 0 0 2.72K\n" + +#. type: Plain text +#: documentation/content/en/books/handbook/zfs/_index.adoc:1530 +msgid "" +"After the scrubbing operation completes with all the data synchronized from " +"[.filename]#ada0p1# to [.filename]#ada1p1#, crossref:zfs[zfs-zpool-clear," +"clear] the error messages from the pool status by running `zpool clear`." +msgstr "" +"После завершения операции очистки, когда все данные синхронизированы с [." +"filename]#ada0p1# на [.filename]#ada1p1#, сбросьте сообщения об ошибках из " +"состояния пула, выполнив команду `zpool clear`, как описано в разделе " +"crossref:zfs[zfs-zpool-clear, Сброс состояния ошибки]." + +#. type: delimited block . 4 +#: documentation/content/en/books/handbook/zfs/_index.adoc:1539 +#, no-wrap +msgid "" +"# zpool clear healer\n" +"# zpool status healer\n" +" pool: healer\n" +" state: ONLINE\n" +" scan: scrub repaired 66.5M in 00:00:06 with 0 errors on Sat Jul 11 10:34:08 2026\n" +"config:\n" +msgstr "" +"# zpool clear healer\n" +"# zpool status healer\n" +" pool: healer\n" +" state: ONLINE\n" +" scan: scrub repaired 66.5M in 00:00:06 with 0 errors on Sat Jul 11 10:34:" +"08 2026\n" +"config:\n" + +#. type: Plain text +#: documentation/content/en/books/handbook/zfs/_index.adoc:1550 +msgid "" +"The pool is now back to a fully working state, with all error counts now " +"zero." +msgstr "" +"Пулу возвращено полностью рабочее состояние, все счётчики ошибок теперь " +"обнулены." + +#. type: Title === +#: documentation/content/en/books/handbook/zfs/_index.adoc:1552 +#, no-wrap +msgid "TRIM and Initialization" +msgstr "TRIM и инициализация" + +#. type: Plain text +#: documentation/content/en/books/handbook/zfs/_index.adoc:1556 +msgid "" +"Solid state drives and thinly provisioned storage perform best when ZFS " +"tells them which blocks are no longer in use. `zpool trim` passes that " +"information to every device in the pool that supports the TRIM or UNMAP " +"commands:" +msgstr "" +"Твердотельные накопители и тонко выделяемое хранилище работают лучше всего, " +"когда ZFS сообщает им, какие блоки больше не используются. `zpool trim` " +"передаёт эту информацию каждому устройству в пуле, которое поддерживает " +"команды TRIM или UNMAP:" + +#. type: delimited block . 4 +#: documentation/content/en/books/handbook/zfs/_index.adoc:1560 +#, no-wrap +msgid "# zpool trim mypool\n" +msgstr "# zpool trim mypool\n" + +#. type: Plain text +#: documentation/content/en/books/handbook/zfs/_index.adoc:1565 +msgid "" +"Trim a single device by naming it after the pool, as in `zpool trim mypool " +"nda0p3`. `zpool trim -w` waits until trimming completes, `-c` cancels a " +"running trim, and `-s` suspends it; running `zpool trim` again resumes a " +"suspended trim. On devices that support it, `zpool trim --secure` requests " +"a secure TRIM, where the device guarantees erasing the data stored on the " +"trimmed blocks." +msgstr "" +"Выполните усечение одного устройства, указав его имя после пула, как в `" +"zpool trim mypool nda0p3`. `zpool trim -w` ожидает завершения усечения, `-c` " +"отменяет выполняющееся усечение, а `-s` приостанавливает его; повторный " +"запуск `zpool trim` возобновляет приостановленное усечение. На устройствах, " +"поддерживающих эту возможность, `zpool trim --secure` запрашивает безопасное " +"усечение, при котором устройство гарантирует стирание данных, хранящихся на " +"усечённых блоках." + +#. type: Plain text +#: documentation/content/en/books/handbook/zfs/_index.adoc:1567 +msgid "`zpool status -t` shows the trim progress for each device:" +msgstr "`zpool status -t` показывает прогресс trim для каждого устройства:" + +#. type: delimited block . 4 +#: documentation/content/en/books/handbook/zfs/_index.adoc:1575 +#, no-wrap +msgid "" +"# zpool status -t mypool\n" +" pool: mypool\n" +" state: ONLINE\n" +" scan: scrub repaired 0B in 00:12:33 with 0 errors on Sat Jul 11 03:31:11 2026\n" +"config:\n" +msgstr "" +"# zpool status -t mypool\n" +" pool: mypool\n" +" state: ONLINE\n" +" scan: scrub repaired 0B in 00:12:33 with 0 errors on Sat Jul 11 03:31:11 " +"2026\n" +"config:\n" + +#. type: delimited block . 4 +#: documentation/content/en/books/handbook/zfs/_index.adoc:1581 +#, no-wrap +msgid "" +" NAME STATE READ WRITE CKSUM\n" +" mypool ONLINE 0 0 0\n" +" mirror-0 ONLINE 0 0 0\n" +" nda0p3 ONLINE 0 0 0 (23% trimmed, started at Sat Jul 11 09:15:04 2026)\n" +" nda1p3 ONLINE 0 0 0 (22% trimmed, started at Sat Jul 11 09:15:04 2026)\n" +msgstr "" +" NAME STATE READ WRITE CKSUM\n" +" mypool ONLINE 0 0 0\n" +" mirror-0 ONLINE 0 0 0\n" +" nda0p3 ONLINE 0 0 0 (23% trimmed, started at Sat Jul " +"11 09:15:04 2026)\n" +" nda1p3 ONLINE 0 0 0 (22% trimmed, started at Sat Jul " +"11 09:15:04 2026)\n" + +#. type: Plain text +#: documentation/content/en/books/handbook/zfs/_index.adoc:1586 +msgid "" +"Setting the `autotrim` pool property to `on` makes ZFS issue small TRIM " +"commands continuously as the pool frees space:" +msgstr "" +"Установка свойства пула `autotrim` в значение `on` заставляет ZFS непрерывно " +"отправлять небольшие команды TRIM по мере освобождения пространства пулом:" + +#. type: delimited block . 4 +#: documentation/content/en/books/handbook/zfs/_index.adoc:1590 +#, no-wrap +msgid "# zpool set autotrim=on mypool\n" +msgstr "# zpool set autotrim=on mypool\n" + +#. type: Plain text +#: documentation/content/en/books/handbook/zfs/_index.adoc:1595 +msgid "" +"Automatic trimming skips small freed regions and puts a constant extra load " +"on the devices. For most systems, leaving `autotrim` off and running a full " +"`zpool trim` on a schedule gives better results. On FreeBSD 14.1 and later, " +"man:periodic[8] runs such a trim daily when [.filename]#/etc/periodic.conf# " +"contains `daily_trim_zfs_enable=\"YES\"`." +msgstr "" +"Автоматическая утилизация пропускает небольшие освобожденные области и " +"создает постоянную дополнительную нагрузку на устройства. Для большинства " +"систем отключение `autotrim` и выполнение полной команды `zpool trim` по " +"расписанию дает лучшие результаты. Начиная с FreeBSD 14.1 и более поздних " +"версий, man:periodic[8] выполняет такую утилизацию ежедневно, если в [." +"filename]#/etc/periodic.conf# содержится `daily_trim_zfs_enable=\"YES\"`." + +#. type: Plain text +#: documentation/content/en/books/handbook/zfs/_index.adoc:1598 +msgid "" +"`zpool initialize` is the counterpart of trimming: it writes a pattern to " +"all unallocated space on the specified devices, or on every eligible device " +"in the pool when given no device names. This forces the backing storage to " +"allocate the space up front, avoiding first-write latency on thinly " +"provisioned virtual disks, and exercises new devices before trusting them " +"with data." +msgstr "" +"`zpool initialize` является аналогом процедуры усечения: она записывает " +"шаблон во всё нераспределённое пространство на указанных устройствах или на " +"каждое подходящее устройство в пуле, если имена устройств не заданы. Это " +"заставляет нижележащее хранилище выделить пространство заранее, избегая " +"задержек при первой записи на тонко подготовленные виртуальные диски, а " +"также проверяет новые устройства перед тем, как доверить им данные." + +#. type: delimited block . 4 +#: documentation/content/en/books/handbook/zfs/_index.adoc:1602 +#, no-wrap +msgid "# zpool initialize mypool\n" +msgstr "# zpool initialize mypool\n" + +#. type: Plain text +#: documentation/content/en/books/handbook/zfs/_index.adoc:1606 +msgid "" +"As with trimming, `-c` cancels an initialization, `-s` suspends it, and `-w` " +"waits for it to finish; `-u` removes the initialization state from the " +"devices. See man:zpool-trim[8] and man:zpool-initialize[8] for details." +msgstr "" +"Как и в случае с усечением, `-c` отменяет инициализацию, `-s` " +"приостанавливает её, а `-w` ожидает её завершения; `-u` удаляет состояние " +"инициализации с устройств. Подробнее см. man:zpool-trim[8] и man:zpool-" +"initialize[8]." + +#. type: Title === +#: documentation/content/en/books/handbook/zfs/_index.adoc:1608 +#, no-wrap +msgid "Pool Checkpoints" +msgstr "Контрольные точки пула" + +#. type: Plain text +#: documentation/content/en/books/handbook/zfs/_index.adoc:1612 +msgid "" +"`zpool checkpoint` saves the state of the entire pool, including every " +"dataset and the pool configuration, so that a later rewind returns the pool " +"to the exact state it had when creating the checkpoint. Create a checkpoint " +"before risky administrative operations such as upgrading the operating " +"system, enabling new pool features, or reorganizing datasets:" +msgstr "" +"`zpool checkpoint` сохраняет состояние всего пула, включая каждый набор " +"данных и конфигурацию пула, так что последующий откат возвращает пул к " +"точному состоянию, которое он имел при создании контрольной точки. " +"Создавайте контрольную точку перед рискованными административными " +"операциями, такими как обновление операционной системы, включение новых " +"функций пула или реорганизация наборов данных:" + +#. type: delimited block . 4 +#: documentation/content/en/books/handbook/zfs/_index.adoc:1616 +#, no-wrap +msgid "# zpool checkpoint mypool\n" +msgstr "# zpool checkpoint mypool\n" + +#. type: Plain text +#: documentation/content/en/books/handbook/zfs/_index.adoc:1620 +msgid "" +"A pool holds at most one checkpoint at a time. The `CKPOINT` column of " +"`zpool list` shows how much space the checkpoint consumes as the pool " +"diverges from the saved state:" +msgstr "" +"Пул может хранить не более одной контрольной точки одновременно. Столбец " +"`CKPOINT` команды `zpool list` показывает, сколько места занимает " +"контрольная точка по мере расхождения пула с сохранённым состоянием:" + +#. type: delimited block . 4 +#: documentation/content/en/books/handbook/zfs/_index.adoc:1626 +#, no-wrap +msgid "" +"# zpool list mypool\n" +"NAME SIZE ALLOC FREE CKPOINT EXPANDSZ FRAG CAP DEDUP HEALTH ALTROOT\n" +"mypool 4.50T 1.42T 3.08T 221M - 4% 31% 1.00x ONLINE -\n" +msgstr "" +"# zpool list mypool\n" +"NAME SIZE ALLOC FREE CKPOINT EXPANDSZ FRAG CAP DEDUP " +"HEALTH ALTROOT\n" +"mypool 4.50T 1.42T 3.08T 221M - 4% 31% 1.00x " +"ONLINE -\n" + +#. type: Plain text +#: documentation/content/en/books/handbook/zfs/_index.adoc:1629 +msgid "" +"To rewind, export the pool and import it again with `--rewind-to-checkpoint`:" +msgstr "" +"Чтобы откатить изменения, экспортируйте пул и импортируйте его снова с " +"помощью `--rewind-to-checkpoint`:" + +#. type: delimited block . 4 +#: documentation/content/en/books/handbook/zfs/_index.adoc:1634 +#, no-wrap +msgid "" +"# zpool export mypool\n" +"# zpool import --rewind-to-checkpoint mypool\n" +msgstr "" +"# zpool export mypool\n" +"# zpool import --rewind-to-checkpoint mypool\n" + +#. type: Plain text +#: documentation/content/en/books/handbook/zfs/_index.adoc:1638 +msgid "" +"Rewinding discards every change made to the pool after creating the " +"checkpoint, including newer snapshots and property changes. Discard a " +"checkpoint that is no longer needed to release the space it holds; `-w` " +"waits until the discard completes:" +msgstr "" +"Перемотка (rewinding) отбрасывает все изменения, внесенные в пул после " +"создания контрольной точки, включая более новые снимки и изменения свойств. " +"Удалите контрольную точку, которая больше не нужна, чтобы освободить " +"занимаемое ею пространство; `-w` ожидает завершения удаления:" + +#. type: delimited block . 4 +#: documentation/content/en/books/handbook/zfs/_index.adoc:1642 +#, no-wrap +msgid "# zpool checkpoint -d -w mypool\n" +msgstr "# zpool checkpoint -d -w mypool\n" + +#. type: Plain text +#: documentation/content/en/books/handbook/zfs/_index.adoc:1646 +msgid "" +"While a checkpoint exists, ZFS refuses operations that change the pool " +"structure: `zpool remove`, `zpool attach`, `zpool detach`, `zpool split`, " +"and `zpool reguid`. Space freed after creating the checkpoint is not " +"reclaimed until the checkpoint is discarded, so a long-lived checkpoint on a " +"busy pool can fill it up." +msgstr "" +"Пока существует контрольная точка, ZFS отказывает в операциях, изменяющих " +"структуру пула: `zpool remove`, `zpool attach`, `zpool detach`, `zpool split`" +" и `zpool reguid`. Пространство, освобожденное после создания контрольной " +"точки, не возвращается, пока контрольная точка не будет удалена, поэтому " +"долгоживущая контрольная точка на активном пуле может заполнить его." + +#. type: delimited block = 4 +#: documentation/content/en/books/handbook/zfs/_index.adoc:1651 +msgid "" +"A checkpoint is not a replacement for crossref:zfs[zfs-zfs-snapshot," +"snapshots] or backups. It protects against administrative mistakes for a " +"short period, lives on the same disks as the pool, and rewinding discards " +"everything written after its creation." +msgstr "" +"Контрольная точка не является заменой приведенных в crossref:zfs[zfs-zfs-" +"snapshot,снимков] или резервных копий. Она защищает от административных " +"ошибок в течение короткого периода, располагается на тех же дисках, что и " +"пул, а откат отбрасывает все, записанное после ее создания." + +#. type: Plain text +#: documentation/content/en/books/handbook/zfs/_index.adoc:1654 +msgid "See man:zpool-checkpoint[8] for details." +msgstr "См. man:zpool-checkpoint[8] для подробностей." + +#. type: Title === +#: documentation/content/en/books/handbook/zfs/_index.adoc:1656 +#, no-wrap +msgid "Growing a Pool" +msgstr "Увеличение размера пула" + +#. type: Plain text +#: documentation/content/en/books/handbook/zfs/_index.adoc:1666 +msgid "" +"The smallest device in each vdev limits the usable size of a redundant " +"pool. Replace the smallest device with a larger device. After completing a " +"crossref:zfs[zfs-zpool-replace,replace] or crossref:zfs[zfs-term-resilver," +"resilver] operation, the pool can grow to use the capacity of the new " +"device. For example, consider a mirror of a 1 TB drive and a 2 TB drive. " +"The usable space is 1 TB. When replacing the 1 TB drive with another 2 TB " +"drive, the resilvering process copies the existing data onto the new drive. " +"As both of the devices now have 2 TB capacity, the mirror's available space " +"grows to 2 TB." +msgstr "" +"Наименьшее устройство в каждом vdev ограничивает полезный размер избыточного " +"пула. Замените наименьшее устройство на устройство большего размера. После " +"завершения операции crossref:zfs[zfs-zpool-replace,замены] или crossref:" +"zfs[zfs-term-resilver,пересинхронизации] пул может расшириться для " +"использования ёмкости нового устройства. Например, рассмотрим зеркало из " +"диска на 1 ТБ и диска на 2 ТБ. Полезное пространство составляет 1 ТБ. При " +"замене диска на 1 ТБ другим диском на 2 ТБ процесс пересинхронизации " +"копирует существующие данные на новый диск. Поскольку оба устройства теперь " +"имеют ёмкость 2 ТБ, доступное пространство зеркала увеличивается до 2 ТБ." + +#. type: Plain text +#: documentation/content/en/books/handbook/zfs/_index.adoc:1669 +msgid "" +"The pool does not use the new capacity automatically by default. Set the " +"`autoexpand` pool property to `on` before replacing the devices and the pool " +"grows as soon as the last smaller device leaves the vdev:" +msgstr "" +"Пул не использует новую ёмкость автоматически по умолчанию. Установите " +"свойство пула `autoexpand` в значение `on` перед заменой устройств, и пул " +"увеличится, как только последнее устройство меньшего размера покинет vdev:" + +#. type: delimited block . 4 +#: documentation/content/en/books/handbook/zfs/_index.adoc:1673 +#, no-wrap +msgid "# zpool set autoexpand=on mypool\n" +msgstr "# zpool set autoexpand=on mypool\n" + +#. type: Plain text +#: documentation/content/en/books/handbook/zfs/_index.adoc:1677 +msgid "" +"Otherwise, start expansion by using `zpool online -e` on each device. After " +"expanding all devices, the extra space becomes available to the pool." +msgstr "" +"Иначе, начните расширение, используя `zpool online -e` для каждого " +"устройства. После расширения всех устройств дополнительное пространство " +"становится доступным для пула." + +#. type: Plain text +#: documentation/content/en/books/handbook/zfs/_index.adoc:1679 +msgid "" +"To grow a RAID-Z vdev by adding a disk instead of replacing the existing " +"ones, see crossref:zfs[zfs-zpool-raidz-expansion,RAID-Z Expansion]." +msgstr "" +"Чтобы увеличить размер vdev RAID-Z, добавив диск вместо замены существующих, " +"см. crossref:zfs[zfs-zpool-raidz-expansion,Расширение RAID-Z]." + +#. type: Title === +#: documentation/content/en/books/handbook/zfs/_index.adoc:1681 +#, no-wrap +msgid "Importing and Exporting Pools" +msgstr "Импорт и экспорт пулов" + +#. type: Plain text +#: documentation/content/en/books/handbook/zfs/_index.adoc:1689 +msgid "" +"_Export_ pools before moving them to another system. ZFS unmounts all " +"datasets, marking each device as exported but still locked to prevent use by " +"other disks. This allows pools to be _imported_ on other machines, other " +"operating systems that support ZFS, and even different hardware " +"architectures (with some caveats, see man:zpool[8]). When a dataset has " +"open files, use `zpool export -f` to force exporting the pool. Use this " +"with caution. The datasets are forcibly unmounted, potentially resulting in " +"unexpected behavior by the applications which had open files on those " +"datasets." +msgstr "" +"_Экспортируйте_ пулы перед перемещением на другую систему. ZFS отмонтирует " +"все наборы данных, помечая каждое устройство как экспортированное, но все " +"ещё заблокированное, чтобы предотвратить использование другими дисками. Это " +"позволяет импортировать пулы на других машинах, операционных системах с " +"поддержкой ZFS и даже на аппаратных архитектурах другого типа (с некоторыми " +"оговорками, см. man:zpool[8]). Если в наборе данных есть открытые файлы, " +"используйте `zpool export -f` для принудительного экспорта пула. Используйте " +"эту команду с осторожностью. Наборы данных будут принудительно " +"отмонтированы, что может привести к неожиданному поведению приложений, " +"работавших с открытыми файлами в этих наборах данных." + +#. type: Plain text +#: documentation/content/en/books/handbook/zfs/_index.adoc:1691 +msgid "Export a pool that is not in use:" +msgstr "Экспортируйте пул, который не используется:" + +#. type: delimited block . 4 +#: documentation/content/en/books/handbook/zfs/_index.adoc:1695 +#, no-wrap +msgid "# zpool export mypool\n" +msgstr "# zpool export mypool\n" + +#. type: Plain text +#: documentation/content/en/books/handbook/zfs/_index.adoc:1703 +msgid "" +"Importing a pool automatically mounts the datasets. If this is undesired " +"behavior, use `zpool import -N` to prevent it. `zpool import -o` sets " +"temporary properties for this specific import. `zpool import -o altroot=` " +"allows importing a pool with a base mount point instead of the root of the " +"file system. If the pool was last used on a different system and was not " +"properly exported, force the import using `zpool import -f`. `zpool import -" +"a` imports all pools that do not appear to be in use by another system." +msgstr "" +"Импорт пула автоматически монтирует наборы данных. Если такое поведение " +"нежелательно, используйте `zpool import -N`, чтобы предотвратить это. `zpool " +"import -o` устанавливает временные свойства для данного конкретного импорта. " +"`zpool import -o altroot=` позволяет импортировать пул с базовой точкой " +"монтирования вместо корня файловой системы. Если пул последний раз " +"использовался в другой системе и не был корректно экспортирован, " +"принудительно импортируйте его с помощью `zpool import -f`. `zpool import -a`" +" импортирует все пулы, которые, по-видимому, не используются другой системой." + +#. type: Plain text +#: documentation/content/en/books/handbook/zfs/_index.adoc:1709 +msgid "" +"man:zpool-import[8] also provides options for recovering damaged pools. " +"`zpool import -F` attempts to rewind the pool to an earlier transaction " +"group when the most recent ones are damaged, discarding the last few seconds " +"of writes. `zpool import -m` allows importing a pool whose dedicated log " +"device is missing. `zpool import -o readonly=on` imports the pool read-" +"only, preventing all writes, which is useful for forensics or when rescuing " +"data from a failing pool. `zpool import -R /mnt` combines `altroot=/mnt` " +"with `cachefile=none`, keeping a rescue import from disturbing the mount " +"paths and the pool cache of the running system." +msgstr "" +"man:zpool-import[8] также предоставляет опции для восстановления " +"поврежденных пулов. `zpool import -F` пытается откатить пул к более ранней " +"группе транзакций, когда последние повреждены, отбрасывая последние " +"несколько секунд записей. `zpool import -m` позволяет импортировать пул, у " +"которого отсутствует выделенное устройство журнала. `zpool import -o " +"readonly=on` импортирует пул в режиме только для чтения, предотвращая все " +"записи, что полезно для анализа последствий или при спасении данных из " +"отказывающего пула. `zpool import -R /mnt` объединяет `altroot=/mnt` с " +"`cachefile=none`, сохраняя спасательный импорт от нарушения путей " +"монтирования и кэша пулов работающей системы." + +#. type: Plain text +#: documentation/content/en/books/handbook/zfs/_index.adoc:1711 +msgid "List all available pools for import:" +msgstr "Выведите список всех доступных пулов для импорта:" + +#. type: delimited block . 4 +#: documentation/content/en/books/handbook/zfs/_index.adoc:1720 +#, no-wrap +msgid "" +"# zpool import\n" +" pool: mypool\n" +" id: 9930174748043525076\n" +" state: ONLINE\n" +" action: The pool can be imported using its name or numeric identifier.\n" +" config:\n" +msgstr "" +"# zpool import\n" +" pool: mypool\n" +" id: 9930174748043525076\n" +" state: ONLINE\n" +" action: The pool can be imported using its name or numeric identifier.\n" +" config:\n" + +#. type: delimited block . 4 +#: documentation/content/en/books/handbook/zfs/_index.adoc:1723 +#, no-wrap +msgid "" +" mypool ONLINE\n" +" ada0p1 ONLINE\n" +msgstr "" +" mypool ONLINE\n" +" ada0p1 ONLINE\n" + +#. type: Plain text +#: documentation/content/en/books/handbook/zfs/_index.adoc:1726 +msgid "Import the pool with an alternative root directory:" +msgstr "Импортируйте пул с альтернативным корневым каталогом:" + +#. type: delimited block . 4 +#: documentation/content/en/books/handbook/zfs/_index.adoc:1733 +#, no-wrap +msgid "" +"# zpool import -o altroot=/mnt mypool\n" +"# zfs list\n" +"NAME USED AVAIL REFER MOUNTPOINT\n" +"mypool 110K 47.0G 31K /mnt/mypool\n" +msgstr "" +"# zpool import -o altroot=/mnt mypool\n" +"# zfs list\n" +"NAME USED AVAIL REFER MOUNTPOINT\n" +"mypool 110K 47.0G 31K /mnt/mypool\n" + +#. type: Plain text +#: documentation/content/en/books/handbook/zfs/_index.adoc:1738 +msgid "" +"At boot, the ZFS startup scripts enabled by `zfs_enable=\"YES\"` in [." +"filename]#/etc/rc.conf# import every pool recorded in [.filename]#/etc/zfs/" +"zpool.cache#. Importing a pool adds it to that cache file automatically; " +"the `cachefile` pool property controls this behavior. Pools imported with " +"`cachefile=none` do not come back automatically after a reboot." +msgstr "" +"При загрузке сценарии запуска ZFS, включённые через `zfs_enable=\"YES\"` в [." +"filename]#/etc/rc.conf#, импортируют каждый пул, записанный в [.filename]#/" +"etc/zfs/zpool.cache#. Импорт пула автоматически добавляет его в этот файл " +"кэша; свойство пула `cachefile` управляет этим поведением. Пулы, " +"импортированные с `cachefile=none`, не восстанавливаются автоматически после " +"перезагрузки." + +#. type: Title ==== +#: documentation/content/en/books/handbook/zfs/_index.adoc:1740 +#, no-wrap +msgid "Importing a GELI-Encrypted Pool" +msgstr "Импорт пула, зашифрованного GELI" + +#. type: Plain text +#: documentation/content/en/books/handbook/zfs/_index.adoc:1744 +msgid "" +"The `Encrypt Disks` option of the FreeBSD installer encrypts the pool's " +"partitions with man:geli[8], described in crossref:disks[disks-encrypting-" +"geli,\"Encrypting Disk Partitions\"], rather than with crossref:zfs[zfs-" +"native-encryption,ZFS native encryption]. On the installed system the " +"loader prompts for the passphrase and attaches the providers before mounting " +"the root pool, but ZFS itself knows nothing about the encryption: when " +"booting from rescue media or moving the disks to another host, `zpool " +"import` does not find the pool until the GELI providers are attached." +msgstr "" +"Опция `Encrypt Disks` инсталлятора FreeBSD шифрует разделы пула с помощью " +"man:geli[8], описанного в crossref:disks[disks-encrypting-geli,\"Шифрование " +"разделов диска\"], а не с помощью crossref:zfs[zfs-native-" +"encryption,собственного шифрования ZFS]. На установленной системе загрузчик " +"запрашивает парольную фразу и подключает провайдеров перед монтированием " +"корневого пула, но сама ZFS ничего не знает о шифровании: при загрузке с " +"аварийного носителя или переносе дисков на другой хост `zpool import` не " +"находит пул, пока провайдеры GELI не будут подключены." + +#. type: Plain text +#: documentation/content/en/books/handbook/zfs/_index.adoc:1746 +msgid "" +"Attach the encrypted [.filename]#freebsd-zfs# partition of every disk in the " +"pool, supplying the passphrase, then import the pool:" +msgstr "" +"Присоедините зашифрованный [.filename]#freebsd-zfs# раздел каждого диска в " +"пуле, указав парольную фразу, затем импортируйте пул:" + +#. type: delimited block . 4 +#: documentation/content/en/books/handbook/zfs/_index.adoc:1752 +#, no-wrap +msgid "" +"# geli attach ada0p4\n" +"Enter passphrase:\n" +"# zpool import -f -R /mnt zroot\n" +msgstr "" +"# geli attach ada0p4\n" +"Enter passphrase:\n" +"# zpool import -f -R /mnt zroot\n" + +#. type: Plain text +#: documentation/content/en/books/handbook/zfs/_index.adoc:1756 +msgid "" +"Use `gpart show` to identify the [.filename]#freebsd-zfs# partitions; with " +"the default installer layout the encrypted partition is [.filename]#p4#. " +"Systems installed with the legacy layout, which keeps a separate unencrypted " +"boot pool, additionally store a key file in [.filename]#/boot/encryption." +"key# on that pool; attach those providers with `geli attach -k /path/to/" +"encryption.key`." +msgstr "" +"Используйте `gpart show`, чтобы определить разделы [.filename]#freebsd-zfs#; " +"при стандартной раскладке установщика зашифрованный раздел — это [." +"filename]#p4#. Системы, установленные с устаревшей раскладкой, которая " +"хранит отдельный незашифрованный загрузочный пул, дополнительно содержат " +"файл ключа в [.filename]#/boot/encryption.key# в этом пуле; подключите эти " +"провайдеры с помощью `geli attach -k /path/to/encryption.key`." + +#. type: Title === +#: documentation/content/en/books/handbook/zfs/_index.adoc:1758 +#, no-wrap +msgid "Upgrading a Storage Pool" +msgstr "Обновление пула дисков" + +#. type: Plain text +#: documentation/content/en/books/handbook/zfs/_index.adoc:1764 +msgid "" +"After upgrading FreeBSD, or if importing a pool from a system using an older " +"version, manually upgrade the pool to make new on-disk features available. " +"Consider whether the pool may ever need importing on an older system before " +"upgrading. Upgrading is a one-way process. Upgrading older pools is " +"possible, but downgrading pools with newer features is not." +msgstr "" +"После обновления FreeBSD или при импорте пула с системы, использующей более " +"старую версию, вручную обновите пул, чтобы активировать поддержку новых " +"функций. Перед обновлением учтите, может ли пул потребоваться для импорта на " +"более старой системе. Обновление является необратимым процессом. Обновление " +"старых пулов возможно, но понижение версии пулов с новыми функциями — нет." + +#. type: Plain text +#: documentation/content/en/books/handbook/zfs/_index.adoc:1770 +msgid "" +"Pools do not carry a single version number anymore. Instead, each on-disk " +"format change is an individual _feature flag_, described in man:zpool-" +"features[7]. A feature is _enabled_ when the pool allows its use and " +"becomes _active_ once the pool stores data that depends on it. An enabled " +"but inactive feature does not affect compatibility. Once a feature is " +"active, software without support for it can no longer import the pool, " +"although pools whose active features are all \"read-only compatible\" still " +"allow read-only imports." +msgstr "" +"Пулы больше не имеют единого номера версии. Вместо этого каждое изменение " +"формата на диске представляет собой отдельный _признак_ (feature flag), " +"описанный в man:zpool-features[7]. Признак _включается_ (enabled), когда пул " +"разрешает его использование, и становится _активным_ (active), как только " +"пул сохраняет данные, зависящие от него. Включённый, но неактивный признак " +"не влияет на совместимость. Как только признак становится активным, " +"программное обеспечение без его поддержки больше не может импортировать пул, " +"хотя пулы, все активные признаки которых являются «совместимыми только для " +"чтения», всё ещё допускают импорт в режиме только для чтения." + +#. type: Plain text +#: documentation/content/en/books/handbook/zfs/_index.adoc:1772 +msgid "" +"`zpool status` reports when supported features are not enabled on a pool:" +msgstr "" +"`zpool status` сообщает, когда поддерживаемые возможности не включены в пуле:" + +#. type: delimited block . 4 +#: documentation/content/en/books/handbook/zfs/_index.adoc:1785 +#, no-wrap +msgid "" +"# zpool status mypool\n" +" pool: mypool\n" +" state: ONLINE\n" +"status: Some supported and requested features are not enabled on the pool.\n" +" The pool can still be used, but some features are unavailable.\n" +"action: Enable all features using 'zpool upgrade'. Once this is done,\n" +" the pool may no longer be accessible by software that does not support\n" +" the features. See zpool-features(7) for details.\n" +" scan: scrub repaired 0B in 00:11:03 with 0 errors on Sat Jul 11 03:15:41 2026\n" +"config:\n" +msgstr "" +"# zpool status mypool\n" +" pool: mypool\n" +" state: ONLINE\n" +"status: Some supported and requested features are not enabled on the pool.\n" +" The pool can still be used, but some features are unavailable.\n" +"action: Enable all features using 'zpool upgrade'. Once this is done,\n" +" the pool may no longer be accessible by software that does not " +"support\n" +" the features. See zpool-features(7) for details.\n" +" scan: scrub repaired 0B in 00:11:03 with 0 errors on Sat Jul 11 03:15:41 " +"2026\n" +"config:\n" + +#. type: delimited block . 4 +#: documentation/content/en/books/handbook/zfs/_index.adoc:1791 +#, no-wrap +msgid "" +" NAME STATE READ WRITE CKSUM\n" +" mypool ONLINE 0 0 0\n" +" mirror-0 ONLINE 0 0 0\n" +" ada0p1 ONLINE 0 0 0\n" +" ada1p1 ONLINE 0 0 0\n" +msgstr "" +" NAME STATE READ WRITE CKSUM\n" +" mypool ONLINE 0 0 0\n" +" mirror-0 ONLINE 0 0 0\n" +" ada0p1 ONLINE 0 0 0\n" +" ada1p1 ONLINE 0 0 0\n" + +#. type: Plain text +#: documentation/content/en/books/handbook/zfs/_index.adoc:1796 +msgid "" +"Running `zpool upgrade` without arguments lists every pool with disabled " +"features:" +msgstr "" +"Выполнение `zpool upgrade` без аргументов выводит список всех пулов с " +"отключёнными возможностями:" + +#. type: delimited block . 4 +#: documentation/content/en/books/handbook/zfs/_index.adoc:1801 +#, no-wrap +msgid "" +"# zpool upgrade\n" +"This system supports ZFS pool feature flags.\n" +msgstr "" +"# zpool upgrade\n" +"This system supports ZFS pool feature flags.\n" + +#. type: delimited block . 4 +#: documentation/content/en/books/handbook/zfs/_index.adoc:1805 +#, no-wrap +msgid "" +"Some supported features are not enabled on the following pools. Once a\n" +"feature is enabled the pool may become incompatible with software\n" +"that does not support the feature. See zpool-features(7) for details.\n" +msgstr "" +"Some supported features are not enabled on the following pools. Once a\n" +"feature is enabled the pool may become incompatible with software\n" +"that does not support the feature. See zpool-features(7) for details.\n" + +#. type: delimited block . 4 +#: documentation/content/en/books/handbook/zfs/_index.adoc:1808 +#, no-wrap +msgid "" +"Note that the pool 'compatibility' feature can be used to inhibit\n" +"feature upgrades.\n" +msgstr "" +"Обратите внимание, что функция «совместимость» (compatibility) пула может " +"использоваться для предотвращения\n" +"обновлений функциональных возможностей.\n" + +#. type: delimited block . 4 +#: documentation/content/en/books/handbook/zfs/_index.adoc:1817 +#, no-wrap +msgid "" +"POOL FEATURE\n" +"---------------\n" +"mypool\n" +" zilsaxattr\n" +" head_errlog\n" +" blake3\n" +" block_cloning\n" +" vdev_zaps_v2\n" +msgstr "" +"POOL FEATURE\n" +"---------------\n" +"mypool\n" +" zilsaxattr\n" +" head_errlog\n" +" blake3\n" +" block_cloning\n" +" vdev_zaps_v2\n" + +#. type: Plain text +#: documentation/content/en/books/handbook/zfs/_index.adoc:1821 +msgid "" +"Use `zpool upgrade -v` to list every feature the running system supports, " +"together with the legacy version numbers. Enable all supported features on " +"a pool:" +msgstr "" +"Используйте `zpool upgrade -v`, чтобы вывести список всех функций, " +"поддерживаемых работающей системой, вместе с устаревшими номерами версий. " +"Включите все поддерживаемые функции в пуле:" + +#. type: delimited block . 4 +#: documentation/content/en/books/handbook/zfs/_index.adoc:1826 +#, no-wrap +msgid "" +"# zpool upgrade mypool\n" +"This system supports ZFS pool feature flags.\n" +msgstr "" +"# zpool upgrade mypool\n" +"This system supports ZFS pool feature flags.\n" + +#. type: delimited block . 4 +#: documentation/content/en/books/handbook/zfs/_index.adoc:1833 +#, no-wrap +msgid "" +"Enabled the following features on 'mypool':\n" +" zilsaxattr\n" +" head_errlog\n" +" blake3\n" +" block_cloning\n" +" vdev_zaps_v2\n" +msgstr "" +"Enabled the following features on 'mypool':\n" +" zilsaxattr\n" +" head_errlog\n" +" blake3\n" +" block_cloning\n" +" vdev_zaps_v2\n" + +#. type: Plain text +#: documentation/content/en/books/handbook/zfs/_index.adoc:1836 +msgid "" +"Pools that must stay importable on systems running older ZFS software can " +"restrict which features `zpool create` and `zpool upgrade` enable through " +"the `compatibility` pool property:" +msgstr "" +"Пулы, которые должны оставаться импортируемыми на системах, работающих с " +"более старым программным обеспечением ZFS, могут ограничивать, какие " +"возможности `zpool create` и `zpool upgrade` включают, через свойство пула " +"`compatibility`:" + +#. type: delimited block . 4 +#: documentation/content/en/books/handbook/zfs/_index.adoc:1840 +#, no-wrap +msgid "# zpool create -o compatibility=openzfs-2.1-freebsd mypool mirror /dev/ada0p1 /dev/ada1p1\n" +msgstr "" +"# zpool create -o compatibility=openzfs-2.1-freebsd mypool mirror /dev/" +"ada0p1 /dev/ada1p1\n" + +#. type: Plain text +#: documentation/content/en/books/handbook/zfs/_index.adoc:1845 +msgid "" +"Setting the property on an existing pool with `zpool set` works as well. " +"Each named feature set corresponds to a file in [.filename]#/usr/share/zfs/" +"compatibility.d#, and the default value `off` allows every feature. Setting " +"the property does not disable features that are already enabled." +msgstr "" +"Установка свойства на существующем пуле с помощью `zpool set` также " +"работает. Каждый именованный набор функций соответствует файлу в [." +"filename]#/usr/share/zfs/compatibility.d#, и значение по умолчанию `off` " +"позволяет использовать все функции. Установка свойства не отключает уже " +"включённые функции." + +#. type: delimited block = 4 +#: documentation/content/en/books/handbook/zfs/_index.adoc:1851 +msgid "" +"Update the boot code on systems that boot from a pool to support the new " +"pool features. Use `gpart bootcode` on the partition that contains the boot " +"code. Two types of bootcode are available, depending on the way the system " +"boots: GPT (the most common option) and EFI (for more modern systems)." +msgstr "" +"Обновите загрузочный код на системах, которые загружаются с пула, чтобы " +"поддержать новые свойства пула. Используйте `gpart bootcode` для раздела, " +"содержащего загрузочный код. Доступны два типа загрузочного кода в " +"зависимости от способа загрузки системы: GPT (наиболее распространённый " +"вариант) и EFI (для более современных систем)." + +#. type: delimited block = 4 +#: documentation/content/en/books/handbook/zfs/_index.adoc:1853 +msgid "For legacy boot using GPT, use the following command:" +msgstr "" +"Для загрузки в устаревшем режиме с использованием GPT используйте следующую " +"команду:" + +#. type: delimited block . 4 +#: documentation/content/en/books/handbook/zfs/_index.adoc:1857 +#, no-wrap +msgid "# gpart bootcode -b /boot/pmbr -p /boot/gptzfsboot -i 1 ada1\n" +msgstr "# gpart bootcode -b /boot/pmbr -p /boot/gptzfsboot -i 1 ada1\n" + +#. type: Plain text +#: documentation/content/en/books/handbook/zfs/_index.adoc:1860 +msgid "For systems using EFI to boot, execute the following command:" +msgstr "" +"Для систем, использующих EFI для загрузки, выполните следующую команду:" + +#. type: delimited block . 4 +#: documentation/content/en/books/handbook/zfs/_index.adoc:1866 +#, no-wrap +msgid "" +"# mount -t msdosfs /dev/ada1p1 /boot/efi\n" +"# cp /boot/loader.efi /boot/efi/efi/boot/BOOTX64.efi\n" +"# cp /boot/loader.efi /boot/efi/efi/freebsd/loader.efi\n" +msgstr "" +"# mount -t msdosfs /dev/ada1p1 /boot/efi\n" +"# cp /boot/loader.efi /boot/efi/efi/boot/BOOTX64.efi\n" +"# cp /boot/loader.efi /boot/efi/efi/freebsd/loader.efi\n" + +#. type: Plain text +#: documentation/content/en/books/handbook/zfs/_index.adoc:1871 +msgid "" +"These instructions apply to amd64 systems. Depending on the architecture, " +"the file has a different name. Refer to man:uefi[8] to find the names of " +"the architecture-specific files." +msgstr "" +"Данные инструкции применимы к системам amd64. В зависимости от архитектуры " +"файл имеет другое имя. Обратитесь к man:uefi[8], чтобы узнать имена файлов, " +"специфичных для конкретной архитектуры." + +#. type: Plain text +#: documentation/content/en/books/handbook/zfs/_index.adoc:1874 +msgid "" +"Apply the bootcode to all bootable disks in the pool. See man:gpart[8] for " +"more information." +msgstr "" +"Примените загрузочный код ко всем загрузочным дискам в пуле. Подробнее см. в " +"man:gpart[8]." + +#. type: Title === +#: documentation/content/en/books/handbook/zfs/_index.adoc:1877 +#, no-wrap +msgid "Displaying Recorded Pool History" +msgstr "Отображение записанной истории пулов" + +#. type: delimited block = 4 +#: documentation/content/en/books/handbook/zfs/_index.adoc:1883 +msgid "" +"ZFS records commands that change the pool, including creating datasets, " +"changing properties, or replacing a disk. Reviewing history about a pool's " +"creation is useful, as is checking which user performed a specific action " +"and when. History is not kept in a log file, but is part of the pool " +"itself. The command to review this history is aptly named `zpool history`:" +msgstr "" +"ZFS записывает команды, которые изменяют пул, включая создание наборов " +"данных, изменение свойств или замену диска. Просмотр истории создания пула " +"полезен, так же как и проверка того, какой пользователь выполнил конкретное " +"действие и когда. История не хранится в файле журнала, а является частью " +"самого пула. Команда для просмотра этой истории называется `zpool history`:" + +#. type: delimited block . 4 +#: documentation/content/en/books/handbook/zfs/_index.adoc:1892 +#, no-wrap +msgid "" +"# zpool history\n" +"History for 'tank':\n" +"2026-07-11.10:24:05 zpool create tank mirror /dev/ada0p1 /dev/ada1p1\n" +"2026-07-11.18:50:58 zfs set atime=off tank\n" +"2026-07-11.18:51:09 zfs set checksum=fletcher4 tank\n" +"2026-07-11.18:51:18 zfs create tank/backup\n" +msgstr "" +"# zpool history\n" +"History for 'tank':\n" +"2026-07-11.10:24:05 zpool create tank mirror /dev/ada0p1 /dev/ada1p1\n" +"2026-07-11.18:50:58 zfs set atime=off tank\n" +"2026-07-11.18:51:09 zfs set checksum=fletcher4 tank\n" +"2026-07-11.18:51:18 zfs create tank/backup\n" + +#. type: Plain text +#: documentation/content/en/books/handbook/zfs/_index.adoc:1897 +msgid "" +"The output shows `zpool` and `zfs` commands altering the pool in some way " +"along with a timestamp. Commands like `zfs list` are not included. When " +"specifying no pool name, ZFS displays history of all pools." +msgstr "" +"Вывод показывает команды `zpool` и `zfs`, изменяющие пул каким-либо образом, " +"вместе с временной меткой. Команды вроде `zfs list` не включаются. Если имя " +"пула не указано, ZFS отображает историю всех пулов." + +#. type: Plain text +#: documentation/content/en/books/handbook/zfs/_index.adoc:1900 +msgid "" +"`zpool history` can show even more information when providing the options `-" +"i` or `-l`. `-i` displays user-initiated events as well as internally " +"logged ZFS events." +msgstr "" +"`zpool history` может отображать ещё больше информации при использовании " +"опций `-i` или `-l`. Опция `-i` показывает события, инициированные " +"пользователем, а также внутренние события ZFS, зарегистрированные в журнале." + +#. type: delimited block . 4 +#: documentation/content/en/books/handbook/zfs/_index.adoc:1912 +#, no-wrap +msgid "" +"# zpool history -i\n" +"History for 'tank':\n" +"2026-07-11.10:24:05 [txg:5] create pool version 5000; software version zfs-2.2.7-FreeBSD_gd75f9ee8b; uts myzfsbox 14.3-RELEASE 1403000 amd64\n" +"2026-07-11.18:50:53 [txg:50] set tank (21) atime=0\n" +"2026-07-11.18:50:58 zfs set atime=off tank\n" +"2026-07-11.18:51:04 [txg:53] set tank (21) checksum=7\n" +"2026-07-11.18:51:09 zfs set checksum=fletcher4 tank\n" +"2026-07-11.18:51:13 [txg:55] create tank/backup (39)\n" +"2026-07-11.18:51:18 zfs create tank/backup\n" +msgstr "" +"# zpool history -i\n" +"History for 'tank':\n" +"2026-07-11.10:24:05 [txg:5] create pool version 5000; software version zfs-2." +"2.7-FreeBSD_gd75f9ee8b; uts myzfsbox 14.3-RELEASE 1403000 amd64\n" +"2026-07-11.18:50:53 [txg:50] set tank (21) atime=0\n" +"2026-07-11.18:50:58 zfs set atime=off tank\n" +"2026-07-11.18:51:04 [txg:53] set tank (21) checksum=7\n" +"2026-07-11.18:51:09 zfs set checksum=fletcher4 tank\n" +"2026-07-11.18:51:13 [txg:55] create tank/backup (39)\n" +"2026-07-11.18:51:18 zfs create tank/backup\n" + +#. type: Plain text +#: documentation/content/en/books/handbook/zfs/_index.adoc:1916 +msgid "" +"Show more details by adding `-l`. Showing history records in a long format, " +"including information like the name of the user who issued the command and " +"the hostname on which the change happened." +msgstr "" +"Показать более подробную информацию, добавив `-l`. Отображение записей " +"истории в длинном формате, включая такие сведения, как имя пользователя, " +"выполнившего команду, и имя хоста, на котором произошло изменение." + +#. type: delimited block . 4 +#: documentation/content/en/books/handbook/zfs/_index.adoc:1925 +#, no-wrap +msgid "" +"# zpool history -l\n" +"History for 'tank':\n" +"2026-07-11.10:24:05 zpool create tank mirror /dev/ada0p1 /dev/ada1p1 [user 0 (root) on myzfsbox:global]\n" +"2026-07-11.18:50:58 zfs set atime=off tank [user 0 (root) on myzfsbox:global]\n" +"2026-07-11.18:51:09 zfs set checksum=fletcher4 tank [user 0 (root) on myzfsbox:global]\n" +"2026-07-11.18:51:18 zfs create tank/backup [user 0 (root) on myzfsbox:global]\n" +msgstr "" +"# zpool history -l\n" +"History for 'tank':\n" +"2026-07-11.10:24:05 zpool create tank mirror /dev/ada0p1 /dev/ada1p1 [user 0 " +"(root) on myzfsbox:global]\n" +"2026-07-11.18:50:58 zfs set atime=off tank [user 0 (root) on myzfsbox:global]" +"\n" +"2026-07-11.18:51:09 zfs set checksum=fletcher4 tank [user 0 (root) on " +"myzfsbox:global]\n" +"2026-07-11.18:51:18 zfs create tank/backup [user 0 (root) on myzfsbox:global]" +"\n" + +#. type: Plain text +#: documentation/content/en/books/handbook/zfs/_index.adoc:1931 +msgid "" +"The output shows that the `root` user created the mirrored pool with disks [." +"filename]#/dev/ada0p1# and [.filename]#/dev/ada1p1#. The hostname " +"`myzfsbox` is also shown with each command. The hostname display becomes " +"important when exporting the pool from one system and importing on another. " +"It's possible to distinguish the commands issued on the other system by the " +"hostname recorded for each command." +msgstr "" +"Вывод показывает, что пользователь `root` создал зеркальный пул с дисками [." +"filename]#/dev/ada0p1# и [.filename]#/dev/ada1p1#. Также в каждой команде " +"отображается имя хоста `myzfsbox`. Отображение имени хоста становится важным " +"при экспорте пула с одной системы и импорте на другую. Можно различить " +"команды, выполненные на другой системе, по имени хоста, записанному для " +"каждой команды." + +#. type: Plain text +#: documentation/content/en/books/handbook/zfs/_index.adoc:1934 +msgid "" +"Combine both options to `zpool history` to give the most detailed " +"information possible for any given pool. Pool history provides valuable " +"information when tracking down the actions performed or when needing more " +"detailed output for debugging." +msgstr "" +"Объедините оба варианта с `zpool history`, чтобы получить максимально " +"детальную информацию для любого заданного пула. История пула предоставляет " +"ценную информацию при отслеживании выполненных действий или необходимости " +"более детального вывода для отладки." + +#. type: Title === +#: documentation/content/en/books/handbook/zfs/_index.adoc:1936 +#, no-wrap +msgid "Performance Monitoring" +msgstr "Мониторинг производительности" + +#. type: Plain text +#: documentation/content/en/books/handbook/zfs/_index.adoc:1943 +msgid "" +"A built-in monitoring system can display pool I/O statistics in real time. " +"It shows the amount of free and used space on the pool, read and write " +"operations performed per second, and I/O bandwidth used. By default, ZFS " +"monitors and displays all pools in the system. Provide a pool name to limit " +"monitoring to that pool. A basic example:" +msgstr "" +"Встроенная система мониторинга может отображать статистику операций ввода-" +"вывода пула в реальном времени. Она показывает объём свободного и занятого " +"пространства в пуле, количество операций чтения и записи в секунду, а также " +"используемую пропускную способность ввода-вывода. По умолчанию ZFS " +"отслеживает и отображает все пулы в системе. Укажите имя пула, чтобы " +"ограничить мониторинг только этим пулом. Простой пример:" + +#. type: delimited block . 4 +#: documentation/content/en/books/handbook/zfs/_index.adoc:1951 +#, no-wrap +msgid "" +"# zpool iostat\n" +" capacity operations bandwidth\n" +"pool alloc free read write read write\n" +"---------- ----- ----- ----- ----- ----- -----\n" +"data 288G 1.53T 2 11 11.3K 57.1K\n" +msgstr "" +"# zpool iostat\n" +" capacity operations bandwidth\n" +"pool alloc free read write read write\n" +"---------- ----- ----- ----- ----- ----- -----\n" +"data 288G 1.53T 2 11 11.3K 57.1K\n" + +#. type: Plain text +#: documentation/content/en/books/handbook/zfs/_index.adoc:1957 +msgid "" +"To continuously see I/O activity, specify a number as the last parameter, " +"indicating an interval in seconds to wait between updates. The next " +"statistic line prints after each interval. Press kbd:[Ctrl+C] to stop this " +"continuous monitoring. Give a second number on the command line after the " +"interval to specify the total number of statistics to display." +msgstr "" +"Чтобы непрерывно отслеживать активность ввода-вывода, укажите число в " +"качестве последнего параметра, задающее интервал в секундах между " +"обновлениями. Следующая строка статистики выводится после каждого интервала. " +"Нажмите kbd:[Ctrl+C], чтобы остановить непрерывный мониторинг. Укажите " +"второе число в командной строке после интервала, чтобы задать общее " +"количество отображаемой статистики." + +#. type: Plain text +#: documentation/content/en/books/handbook/zfs/_index.adoc:1962 +msgid "" +"Display even more detailed I/O statistics with `-v`. Each device in the " +"pool appears with a statistics line. This is useful for seeing read and " +"write operations performed on each device, and can help determine if any " +"individual device is slowing down the pool. This example shows a mirrored " +"pool with two devices:" +msgstr "" +"Отображать более детальную статистику ввода-вывода с помощью `-v`. Каждое " +"устройство в пуле отображается с отдельной строкой статистики. Это полезно " +"для просмотра операций чтения и записи, выполняемых на каждом устройстве, и " +"может помочь определить, замедляет ли какое-либо отдельное устройство работу " +"пула. В этом примере показан зеркальный пул с двумя устройствами:" + +#. type: delimited block . 4 +#: documentation/content/en/books/handbook/zfs/_index.adoc:1974 +#, no-wrap +msgid "" +"# zpool iostat -v\n" +" capacity operations bandwidth\n" +"pool alloc free read write read write\n" +"----------------------- ----- ----- ----- ----- ----- -----\n" +"data 288G 1.53T 2 12 9.23K 61.5K\n" +" mirror 288G 1.53T 2 12 9.23K 61.5K\n" +" ada1p1 - - 0 4 5.61K 61.7K\n" +" ada2p1 - - 1 4 5.04K 61.7K\n" +"----------------------- ----- ----- ----- ----- ----- -----\n" +msgstr "" +"# zpool iostat -v\n" +" capacity operations bandwidth\n" +"pool alloc free read write read write\n" +"----------------------- ----- ----- ----- ----- ----- -----\n" +"data 288G 1.53T 2 12 9.23K 61.5K\n" +" mirror 288G 1.53T 2 12 9.23K 61.5K\n" +" ada1p1 - - 0 4 5.61K 61.7K\n" +" ada2p1 - - 1 4 5.04K 61.7K\n" +"----------------------- ----- ----- ----- ----- ----- -----\n" + +#. type: Plain text +#: documentation/content/en/books/handbook/zfs/_index.adoc:1980 +msgid "" +"`zpool iostat` offers several deeper views of the I/O pipeline. `-l` adds " +"average latency columns, splitting the total wait time into disk time and " +"time spent in the various I/O queues. `-q` shows the number of pending and " +"active operations in each per-vdev queue. `-w` prints full latency " +"histograms, and `-r` prints request size histograms for each leaf vdev." +msgstr "" +"`zpool iostat` предоставляет несколько более детальных представлений о " +"конвейере ввода-вывода. `-l` (latency) добавляет столбцы со средней " +"задержкой, разделяя общее время ожидания на время на диске и время, " +"проведенное в различных очередях ввода-вывода. `-q` (queue) показывает " +"количество ожидающих и активных операций в каждой очереди на vdev. `-w` " +"выводит полные гистограммы задержек, а `-r` (request size) выводит " +"гистограммы размеров запросов для каждого листового vdev." + +#. type: Plain text +#: documentation/content/en/books/handbook/zfs/_index.adoc:1982 +msgid "" +"The latency columns of `-l` make it easy to spot a single slow disk dragging " +"down a whole vdev:" +msgstr "" +"Столбцы задержки в `-l` позволяют легко заметить один медленный диск, " +"который замедляет работу всего vdev:" + +#. type: delimited block . 4 +#: documentation/content/en/books/handbook/zfs/_index.adoc:1994 +#, no-wrap +msgid "" +"# zpool iostat -lv data\n" +" capacity operations bandwidth total_wait disk_wait syncq_wait asyncq_wait scrub trim rebuild\n" +"pool alloc free read write read write read write read write read write read write wait wait wait\n" +"---------- ----- ----- ----- ----- ----- ----- ----- ----- ----- ----- ----- ----- ----- ----- ----- ----- -------\n" +"data 288G 1.53T 156 212 19.4M 26.6M 14ms 186ms 5ms 184ms 1us 2us 8ms 2ms - - -\n" +" mirror-0 288G 1.53T 156 212 19.4M 26.6M 14ms 186ms 5ms 184ms 1us 2us 8ms 2ms - - -\n" +" ada1p1 - - 79 106 9.7M 13.3M 3ms 5ms 3ms 4ms 1us 2us 1ms 1ms - - -\n" +" ada2p1 - - 77 106 9.7M 13.3M 212ms 187ms 208ms 183ms 1us 2us 15ms 3ms - - -\n" +"---------- ----- ----- ----- ----- ----- ----- ----- ----- ----- ----- ----- ----- ----- ----- ----- ----- -------\n" +msgstr "" +"# zpool iostat -lv data\n" +" capacity operations bandwidth total_wait " +"disk_wait syncq_wait asyncq_wait scrub trim rebuild\n" +"pool alloc free read write read write read write read " +"write read write read write wait wait wait\n" +"---------- ----- ----- ----- ----- ----- ----- ----- ----- ----- " +"----- ----- ----- ----- ----- ----- ----- -------\n" +"data 288G 1.53T 156 212 19.4M 26.6M 14ms 186ms 5ms " +"184ms 1us 2us 8ms 2ms - - -\n" +" mirror-0 288G 1.53T 156 212 19.4M 26.6M 14ms 186ms 5ms " +"184ms 1us 2us 8ms 2ms - - -\n" +" ada1p1 - - 79 106 9.7M 13.3M 3ms 5ms 3ms " +"4ms 1us 2us 1ms 1ms - - -\n" +" ada2p1 - - 77 106 9.7M 13.3M 212ms 187ms 208ms " +"183ms 1us 2us 15ms 3ms - - -\n" +"---------- ----- ----- ----- ----- ----- ----- ----- ----- ----- " +"----- ----- ----- ----- ----- ----- ----- -------\n" + +#. type: Plain text +#: documentation/content/en/books/handbook/zfs/_index.adoc:1999 +msgid "" +"In this example, [.filename]#ada2p1# needs hundreds of milliseconds of disk " +"time for I/O that its mirror partner [.filename]#ada1p1# completes in single-" +"digit milliseconds, while both handle a similar number of operations. A " +"write to the mirror only completes when the slowest member finishes, so the " +"write latency of the whole vdev tracks [.filename]#ada2p1#. High latency at " +"normal operation counts, without read, write, or checksum errors in `zpool " +"status`, often indicates a disk that retries internally and is a candidate " +"for replacement." +msgstr "" +"В этом примере [.filename]#ada2p1# требует сотни миллисекунд дискового " +"времени для операций ввода-вывода, которые его зеркальный партнёр [." +"filename]#ada1p1# выполняет за однозначные миллисекунды, при этом оба " +"обрабатывают схожее количество операций. Запись в зеркало завершается только " +"после того, как завершится самый медленный участник, поэтому задержка записи " +"всего vdev отслеживает [.filename]#ada2p1#. Высокая задержка при нормальной " +"работе, без ошибок чтения, записи или контрольных сумм в `zpool status`, " +"часто указывает на диск, который выполняет внутренние повторы, и является " +"кандидатом на замену." + +#. type: Plain text +#: documentation/content/en/books/handbook/zfs/_index.adoc:2001 +msgid "" +"Scripts that must wait for background pool activity to finish can block on " +"`zpool wait`:" +msgstr "" +"Скрипты, которым необходимо дождаться завершения фоновой активности пула, " +"могут блокироваться на `zpool wait`:" + +#. type: delimited block . 4 +#: documentation/content/en/books/handbook/zfs/_index.adoc:2005 +#, no-wrap +msgid "# zpool wait -t scrub,resilver mypool\n" +msgstr "# zpool wait -t scrub,resilver mypool\n" + +#. type: Plain text +#: documentation/content/en/books/handbook/zfs/_index.adoc:2009 +msgid "" +"The command returns once none of the named activities, such as `scrub`, " +"`resilver`, `trim`, or `remove`, are in progress. See man:zpool-wait[8] for " +"the full list of activities." +msgstr "" +"Команда возвращает управление, как только ни одно из указанных действий, " +"таких как `scrub`, `resilver`, `trim` или `remove`, не выполняется. Полный " +"список действий приведён в man:zpool-wait[8]." + +#. type: delimited block = 4 +#: documentation/content/en/books/handbook/zfs/_index.adoc:2014 +msgid "" +"`zpool status`, `zpool list`, `zpool get`, and `zfs list` accept `-j` to " +"produce JSON output, which is more robust for scripts to parse than the " +"human-readable tables. JSON output requires OpenZFS 2.3 or later, first " +"available in FreeBSD 15.0." +msgstr "" +"`zpool status`, `zpool list`, `zpool get` и `zfs list` принимают `-j` для " +"вывода JSON, который более устойчив для разбора скриптами, чем таблицы, " +"читаемые человеком. Вывод JSON требует OpenZFS 2.3 или новее, впервые " +"доступный во FreeBSD 15.0." + +#. type: Title === +#: documentation/content/en/books/handbook/zfs/_index.adoc:2017 +#, no-wrap +msgid "Splitting a Storage Pool" +msgstr "Разделение пула хранения данных" + +#. type: Plain text +#: documentation/content/en/books/handbook/zfs/_index.adoc:2024 +msgid "" +"ZFS can split a pool consisting of one or more mirror vdevs into two pools. " +"Unless otherwise specified, ZFS detaches the last member of each mirror and " +"creates a new pool containing the same data. Be sure to make a dry run of " +"the operation with `-n` first. This displays the details of the requested " +"operation without actually performing it. This helps confirm that the " +"operation will do what the user intends." +msgstr "" +"ZFS может разделить пул, состоящий из одного или нескольких зеркальных vdev, " +"на два пула. Если не указано иное, ZFS отсоединяет последний элемент каждого " +"зеркала и создаёт новый пул с теми же данными. Обязательно выполните пробный " +"запуск операции с параметром `-n` сначала. Это отобразит детали запрошенной " +"операции без её фактического выполнения. Это помогает убедиться, что " +"операция выполнит то, что задумал пользователь." + +#. type: Title == +#: documentation/content/en/books/handbook/zfs/_index.adoc:2026 +#, no-wrap +msgid "`zfs` Administration" +msgstr "Управление с помощью утилиты`zfs`" + +#. type: Plain text +#: documentation/content/en/books/handbook/zfs/_index.adoc:2030 +msgid "" +"The `zfs` utility can create, destroy, and manage all existing ZFS datasets " +"within a pool. To manage the pool itself, use crossref:zfs[zfs-zpool," +"`zpool`]." +msgstr "" +"Утилита `zfs` позволяет создавать, удалять и управлять всеми существующими " +"наборами данных ZFS в пределах пула. Для управления самим пулом используйте " +"crossref:zfs[zfs-zpool,`zpool`]." + +#. type: Title === +#: documentation/content/en/books/handbook/zfs/_index.adoc:2032 +#, no-wrap +msgid "Creating and Destroying Datasets" +msgstr "Создание и удаление наборов данных" + +#. type: Plain text +#: documentation/content/en/books/handbook/zfs/_index.adoc:2043 +msgid "" +"Unlike traditional disks and volume managers, space in ZFS is _not_ " +"preallocated. With traditional file systems, after partitioning and " +"assigning the space, there is no way to add a new file system without adding " +"a new disk. With ZFS, creating new file systems is possible at any time. " +"Each crossref:zfs[zfs-term-dataset,_dataset_] has properties including " +"features like compression, deduplication, caching, and quotas, as well as " +"other useful properties like readonly, case sensitivity, network file " +"sharing, and a mount point. Nesting datasets within each other is possible " +"and child datasets will inherit properties from their ancestors. crossref:" +"zfs[zfs-zfs-allow,Delegate], crossref:zfs[zfs-zfs-send,replicate], crossref:" +"zfs[zfs-zfs-snapshot,snapshot], crossref:zfs[zfs-zfs-jail,jail] allows " +"administering and destroying each dataset as a unit. Creating a separate " +"dataset for each different type or set of files has advantages. The " "drawbacks to having a large number of datasets are that some commands like " "`zfs list` will be slower, and that mounting of hundreds or even thousands " "of datasets will slow the FreeBSD boot process." msgstr "" -"В отличие от традиционных дисков и менеджеров томов, пространство в ZFS _не_ " -"выделяется заранее. В традиционных файловых системах после разметки и " -"выделения пространства невозможно добавить новую файловую систему без " -"добавления нового диска. В ZFS создание новых файловых систем возможно в " -"любое время. Каждый crossref:zfs[zfs-term-dataset,_набор данных_] обладает " -"свойствами, включая такие функции, как сжатие, дедупликация, кэширование и " -"квоты, а также другие полезные свойства, такие как режим только для чтения, " -"чувствительность к регистру, сетевое общее использование файлов и точка " -"монтирования. Возможно вложение наборов данных друг в друга, при этом " -"дочерние наборы данных наследуют свойства от своих родительских. crossref:" -"zfs[zfs-zfs-allow,Делегирование], crossref:zfs[zfs-zfs-send,репликация], " -"crossref:zfs[zfs-zfs-snapshot,снимки], crossref:zfs[zfs-zfs-jail,клетки] " -"позволяют администрировать и уничтожать каждый набор данных как единое " -"целое. Создание отдельного набора данных для каждого типа или группы файлов " -"имеет свои преимущества. Недостатком наличия большого количества наборов " -"данных является то, что некоторые команды, такие как `zfs list`, будут " -"выполняться медленнее, а монтирование сотен или даже тысяч наборов данных " -"замедлит процесс загрузки FreeBSD." +"В отличие от традиционных дисков и менеджеров томов, пространство в ZFS _не_ " +"выделяется заранее. В традиционных файловых системах после разметки и " +"выделения пространства невозможно добавить новую файловую систему без " +"добавления нового диска. В ZFS создание новых файловых систем возможно в " +"любое время. Каждый crossref:zfs[zfs-term-dataset,_набор данных_] обладает " +"свойствами, включая такие функции, как сжатие, дедупликация, кэширование и " +"квоты, а также другие полезные свойства, такие как режим только для чтения, " +"чувствительность к регистру, сетевое общее использование файлов и точка " +"монтирования. Возможно вложение наборов данных друг в друга, при этом " +"дочерние наборы данных наследуют свойства от своих родительских. crossref:" +"zfs[zfs-zfs-allow,Делегирование], crossref:zfs[zfs-zfs-send,репликация], " +"crossref:zfs[zfs-zfs-snapshot,снимки], crossref:zfs[zfs-zfs-jail,клетки] " +"позволяют администрировать и уничтожать каждый набор данных как единое " +"целое. Создание отдельного набора данных для каждого типа или группы файлов " +"имеет свои преимущества. Недостатком наличия большого количества наборов " +"данных является то, что некоторые команды, такие как `zfs list`, будут " +"выполняться медленнее, а монтирование сотен или даже тысяч наборов данных " +"замедлит процесс загрузки FreeBSD." + +#. type: Plain text +#: documentation/content/en/books/handbook/zfs/_index.adoc:2045 +msgid "" +"Create a new dataset and enable crossref:zfs[zfs-term-compression-lz4,LZ4 " +"compression] on it:" +msgstr "" +"Создайте новый набор данных и включите для него crossref:zfs[zfs-term-" +"compression-lz4,сжатие LZ4]:" + +#. type: delimited block . 4 +#: documentation/content/en/books/handbook/zfs/_index.adoc:2080 +#, no-wrap +msgid "" +"# zfs list\n" +"NAME USED AVAIL REFER MOUNTPOINT\n" +"mypool 781M 93.2G 144K none\n" +"mypool/ROOT 777M 93.2G 144K none\n" +"mypool/ROOT/default 777M 93.2G 777M /\n" +"mypool/tmp 176K 93.2G 176K /tmp\n" +"mypool/usr 616K 93.2G 144K /usr\n" +"mypool/usr/home 184K 93.2G 184K /usr/home\n" +"mypool/usr/ports 144K 93.2G 144K /usr/ports\n" +"mypool/usr/src 144K 93.2G 144K /usr/src\n" +"mypool/var 1.20M 93.2G 608K /var\n" +"mypool/var/crash 148K 93.2G 148K /var/crash\n" +"mypool/var/log 178K 93.2G 178K /var/log\n" +"mypool/var/mail 144K 93.2G 144K /var/mail\n" +"mypool/var/tmp 152K 93.2G 152K /var/tmp\n" +"# zfs create -o compress=lz4 mypool/usr/mydataset\n" +"# zfs list\n" +"NAME USED AVAIL REFER MOUNTPOINT\n" +"mypool 781M 93.2G 144K none\n" +"mypool/ROOT 777M 93.2G 144K none\n" +"mypool/ROOT/default 777M 93.2G 777M /\n" +"mypool/tmp 176K 93.2G 176K /tmp\n" +"mypool/usr 704K 93.2G 144K /usr\n" +"mypool/usr/home 184K 93.2G 184K /usr/home\n" +"mypool/usr/mydataset 87.5K 93.2G 87.5K /usr/mydataset\n" +"mypool/usr/ports 144K 93.2G 144K /usr/ports\n" +"mypool/usr/src 144K 93.2G 144K /usr/src\n" +"mypool/var 1.20M 93.2G 610K /var\n" +"mypool/var/crash 148K 93.2G 148K /var/crash\n" +"mypool/var/log 178K 93.2G 178K /var/log\n" +"mypool/var/mail 144K 93.2G 144K /var/mail\n" +"mypool/var/tmp 152K 93.2G 152K /var/tmp\n" +msgstr "" +"# zfs list\n" +"NAME USED AVAIL REFER MOUNTPOINT\n" +"mypool 781M 93.2G 144K none\n" +"mypool/ROOT 777M 93.2G 144K none\n" +"mypool/ROOT/default 777M 93.2G 777M /\n" +"mypool/tmp 176K 93.2G 176K /tmp\n" +"mypool/usr 616K 93.2G 144K /usr\n" +"mypool/usr/home 184K 93.2G 184K /usr/home\n" +"mypool/usr/ports 144K 93.2G 144K /usr/ports\n" +"mypool/usr/src 144K 93.2G 144K /usr/src\n" +"mypool/var 1.20M 93.2G 608K /var\n" +"mypool/var/crash 148K 93.2G 148K /var/crash\n" +"mypool/var/log 178K 93.2G 178K /var/log\n" +"mypool/var/mail 144K 93.2G 144K /var/mail\n" +"mypool/var/tmp 152K 93.2G 152K /var/tmp\n" +"# zfs create -o compress=lz4 mypool/usr/mydataset\n" +"# zfs list\n" +"NAME USED AVAIL REFER MOUNTPOINT\n" +"mypool 781M 93.2G 144K none\n" +"mypool/ROOT 777M 93.2G 144K none\n" +"mypool/ROOT/default 777M 93.2G 777M /\n" +"mypool/tmp 176K 93.2G 176K /tmp\n" +"mypool/usr 704K 93.2G 144K /usr\n" +"mypool/usr/home 184K 93.2G 184K /usr/home\n" +"mypool/usr/mydataset 87.5K 93.2G 87.5K /usr/mydataset\n" +"mypool/usr/ports 144K 93.2G 144K /usr/ports\n" +"mypool/usr/src 144K 93.2G 144K /usr/src\n" +"mypool/var 1.20M 93.2G 610K /var\n" +"mypool/var/crash 148K 93.2G 148K /var/crash\n" +"mypool/var/log 178K 93.2G 178K /var/log\n" +"mypool/var/mail 144K 93.2G 144K /var/mail\n" +"mypool/var/tmp 152K 93.2G 152K /var/tmp\n" + +#. type: Plain text +#: documentation/content/en/books/handbook/zfs/_index.adoc:2083 +msgid "" +"Destroying a dataset is much quicker than deleting the files on the dataset, " +"as it does not involve scanning the files and updating the corresponding " +"metadata." +msgstr "" +"Уничтожение набора данных выполняется гораздо быстрее, чем удаление файлов в " +"наборе данных, так как не требует сканирования файлов и обновления " +"соответствующих метаданных." + +#. type: Plain text +#: documentation/content/en/books/handbook/zfs/_index.adoc:2085 +msgid "Destroy the created dataset:" +msgstr "Уничтожьте созданный набор данных:" + +#. type: delimited block . 4 +#: documentation/content/en/books/handbook/zfs/_index.adoc:2120 +#, no-wrap +msgid "" +"# zfs list\n" +"NAME USED AVAIL REFER MOUNTPOINT\n" +"mypool 880M 93.1G 144K none\n" +"mypool/ROOT 777M 93.1G 144K none\n" +"mypool/ROOT/default 777M 93.1G 777M /\n" +"mypool/tmp 176K 93.1G 176K /tmp\n" +"mypool/usr 101M 93.1G 144K /usr\n" +"mypool/usr/home 184K 93.1G 184K /usr/home\n" +"mypool/usr/mydataset 100M 93.1G 100M /usr/mydataset\n" +"mypool/usr/ports 144K 93.1G 144K /usr/ports\n" +"mypool/usr/src 144K 93.1G 144K /usr/src\n" +"mypool/var 1.20M 93.1G 610K /var\n" +"mypool/var/crash 148K 93.1G 148K /var/crash\n" +"mypool/var/log 178K 93.1G 178K /var/log\n" +"mypool/var/mail 144K 93.1G 144K /var/mail\n" +"mypool/var/tmp 152K 93.1G 152K /var/tmp\n" +"# zfs destroy mypool/usr/mydataset\n" +"# zfs list\n" +"NAME USED AVAIL REFER MOUNTPOINT\n" +"mypool 781M 93.2G 144K none\n" +"mypool/ROOT 777M 93.2G 144K none\n" +"mypool/ROOT/default 777M 93.2G 777M /\n" +"mypool/tmp 176K 93.2G 176K /tmp\n" +"mypool/usr 616K 93.2G 144K /usr\n" +"mypool/usr/home 184K 93.2G 184K /usr/home\n" +"mypool/usr/ports 144K 93.2G 144K /usr/ports\n" +"mypool/usr/src 144K 93.2G 144K /usr/src\n" +"mypool/var 1.21M 93.2G 612K /var\n" +"mypool/var/crash 148K 93.2G 148K /var/crash\n" +"mypool/var/log 178K 93.2G 178K /var/log\n" +"mypool/var/mail 144K 93.2G 144K /var/mail\n" +"mypool/var/tmp 152K 93.2G 152K /var/tmp\n" +msgstr "" +"# zfs list\n" +"NAME USED AVAIL REFER MOUNTPOINT\n" +"mypool 880M 93.1G 144K none\n" +"mypool/ROOT 777M 93.1G 144K none\n" +"mypool/ROOT/default 777M 93.1G 777M /\n" +"mypool/tmp 176K 93.1G 176K /tmp\n" +"mypool/usr 101M 93.1G 144K /usr\n" +"mypool/usr/home 184K 93.1G 184K /usr/home\n" +"mypool/usr/mydataset 100M 93.1G 100M /usr/mydataset\n" +"mypool/usr/ports 144K 93.1G 144K /usr/ports\n" +"mypool/usr/src 144K 93.1G 144K /usr/src\n" +"mypool/var 1.20M 93.1G 610K /var\n" +"mypool/var/crash 148K 93.1G 148K /var/crash\n" +"mypool/var/log 178K 93.1G 178K /var/log\n" +"mypool/var/mail 144K 93.1G 144K /var/mail\n" +"mypool/var/tmp 152K 93.1G 152K /var/tmp\n" +"# zfs destroy mypool/usr/mydataset\n" +"# zfs list\n" +"NAME USED AVAIL REFER MOUNTPOINT\n" +"mypool 781M 93.2G 144K none\n" +"mypool/ROOT 777M 93.2G 144K none\n" +"mypool/ROOT/default 777M 93.2G 777M /\n" +"mypool/tmp 176K 93.2G 176K /tmp\n" +"mypool/usr 616K 93.2G 144K /usr\n" +"mypool/usr/home 184K 93.2G 184K /usr/home\n" +"mypool/usr/ports 144K 93.2G 144K /usr/ports\n" +"mypool/usr/src 144K 93.2G 144K /usr/src\n" +"mypool/var 1.21M 93.2G 612K /var\n" +"mypool/var/crash 148K 93.2G 148K /var/crash\n" +"mypool/var/log 178K 93.2G 178K /var/log\n" +"mypool/var/mail 144K 93.2G 144K /var/mail\n" +"mypool/var/tmp 152K 93.2G 152K /var/tmp\n" + +#. type: Plain text +#: documentation/content/en/books/handbook/zfs/_index.adoc:2129 +msgid "" +"In modern versions of ZFS, `zfs destroy` is asynchronous, and the free space " +"might take minutes to appear in the pool. Use `zpool get freeing " +"_poolname_` to see the `freeing` property, which shows how much space " +"remains to reclaim in the background. Use `zpool wait -t free _poolname_` " +"to wait until the background freeing completes. If there are child " +"datasets, like crossref:zfs[zfs-term-snapshot,snapshots] or other datasets, " +"destroying the parent is impossible. To destroy a dataset and its children, " +"use `-r` to recursively destroy the dataset and its children. Use `-n -v` " +"to list datasets and snapshots destroyed by this operation, without actually " +"destroying anything. Space reclaimed by destroying snapshots is also shown." +msgstr "" +"В современных версиях ZFS команда `zfs destroy` выполняется асинхронно, и " +"освобождённое пространство может появиться в пуле только через несколько " +"минут. Используйте команду `zpool get freeing _poolname_` для просмотра " +"свойства `freeing`, которое показывает, сколько места ещё остаётся " +"освободить в фоновом режиме. Используйте команду `zpool wait -t free " +"_poolname_`, чтобы дождаться завершения фонового освобождения. Если " +"существуют дочерние наборы данных, например crossref:zfs[zfs-term-" +"snapshot,снимки] или другие наборы данных, уничтожение родительского набора " +"невозможно. Для удаления набора данных и его дочерних элементов используйте " +"`-r`, чтобы рекурсивно удалить набор данных и его потомков. Опция `-n -v` " +"позволяет вывести список наборов данных и снимков, которые будут удалены " +"данной операцией, без фактического выполнения удаления. Также отображается " +"пространство, которое будет освобождено после удаления снимков." + +#. type: Title === +#: documentation/content/en/books/handbook/zfs/_index.adoc:2131 +#, no-wrap +msgid "Creating and Destroying Volumes" +msgstr "Создание и удаление томов" + +#. type: Plain text +#: documentation/content/en/books/handbook/zfs/_index.adoc:2136 +msgid "" +"A volume is a special dataset type. Rather than mounting as a file system, " +"expose it as a block device under [.filename]#/dev/zvol/poolname/dataset#. " +"This allows using the volume for other file systems, to back the disks of a " +"virtual machine, or to make it available to other network hosts using " +"protocols like iSCSI or HAST." +msgstr "" +"Том — это особый тип набора данных. Вместо монтирования в качестве файловой " +"системы он представляется как блочное устройство в [.filename]#/dev/zvol/" +"имя_пула/набор_данных#. Это позволяет использовать том для других файловых " +"систем, в качестве дисков для виртуальной машины или сделать его доступным " +"для других сетевых узлов с использованием таких протоколов, как iSCSI или " +"HAST." + +#. type: Plain text +#: documentation/content/en/books/handbook/zfs/_index.adoc:2141 +msgid "" +"Format a volume with any file system or without a file system to store raw " +"data. To the user, a volume appears to be a regular disk. Putting ordinary " +"file systems on these _zvols_ provides features that ordinary disks or file " +"systems do not have. For example, using the compression property on a 250 " +"MB volume allows creation of a compressed FAT file system." +msgstr "" +"Отформатируйте том с любой файловой системой или без файловой системы для " +"хранения сырых данных. Для пользователя том выглядит как обычный диск. " +"Размещение обычных файловых систем на этих _zvols_ предоставляет " +"возможности, которых нет у обычных дисков или файловых систем. Например, " +"использование свойства сжатия на томе объёмом 250 МБ позволяет создать " +"сжатую файловую систему FAT." + +#. type: delimited block . 4 +#: documentation/content/en/books/handbook/zfs/_index.adoc:2155 +#, no-wrap +msgid "" +"# zfs create -V 250m -o compression=on tank/fat32\n" +"# zfs list tank\n" +"NAME USED AVAIL REFER MOUNTPOINT\n" +"tank 258M 670M 31K /tank\n" +"# newfs_msdos -F32 /dev/zvol/tank/fat32\n" +"# mount -t msdosfs /dev/zvol/tank/fat32 /mnt\n" +"# df -h /mnt | grep fat32\n" +"Filesystem Size Used Avail Capacity Mounted on\n" +"/dev/zvol/tank/fat32 249M 24k 249M 0% /mnt\n" +"# mount | grep fat32\n" +"/dev/zvol/tank/fat32 on /mnt (msdosfs, local)\n" +msgstr "" +"# zfs create -V 250m -o compression=on tank/fat32\n" +"# zfs list tank\n" +"NAME USED AVAIL REFER MOUNTPOINT\n" +"tank 258M 670M 31K /tank\n" +"# newfs_msdos -F32 /dev/zvol/tank/fat32\n" +"# mount -t msdosfs /dev/zvol/tank/fat32 /mnt\n" +"# df -h /mnt | grep fat32\n" +"Filesystem Size Used Avail Capacity Mounted on\n" +"/dev/zvol/tank/fat32 249M 24k 249M 0% /mnt\n" +"# mount | grep fat32\n" +"/dev/zvol/tank/fat32 on /mnt (msdosfs, local)\n" + +#. type: Plain text +#: documentation/content/en/books/handbook/zfs/_index.adoc:2159 +msgid "" +"Creating a volume reserves enough space in the pool to hold the full volume " +"size. To skip that reservation, create a _sparse volume_, also known as a " +"thin provisioned volume, with `-s`:" +msgstr "" +"Создание тома резервирует в пуле достаточно места для хранения полного " +"размера тома. Чтобы пропустить это резервирование, создайте _разреженный " +"том_ (sparse volume), также известный как тонко выделенный том, с помощью " +"`-s`:" + +#. type: delimited block . 4 +#: documentation/content/en/books/handbook/zfs/_index.adoc:2163 +#, no-wrap +msgid "# zfs create -s -V 250g tank/bigdisk\n" +msgstr "# zfs create -s -V 250g tank/bigdisk\n" + +#. type: Plain text +#: documentation/content/en/books/handbook/zfs/_index.adoc:2167 +msgid "" +"Sparse volumes allow committing more space than the pool actually has. " +"Writes to a sparse volume can fail with `ENOSPC` when the pool runs low on " +"space, so use sparse volumes only where the consumer of the volume tolerates " +"write errors." +msgstr "" +"Разреженные тома позволяют выделять больше пространства, чем фактически " +"имеется в пуле. Записи в разреженный том могут завершиться ошибкой `ENOSPC`, " +"когда в пуле заканчивается место, поэтому используйте разреженные тома " +"только там, где потребитель тома допускает ошибки записи." + +#. type: Plain text +#: documentation/content/en/books/handbook/zfs/_index.adoc:2173 +msgid "" +"The `volmode` property controls how ZFS exposes a volume to the operating " +"system. Setting it to `full` exposes the volume as a GEOM provider with " +"maximal functionality, and `geom` is an alias for `full`. Setting it to " +"`dev` exposes the volume as a plain device node, hiding any partitions it " +"contains. Volumes with `volmode` set to `none` are not exposed outside ZFS " +"at all, but still support snapshots, clones, and replication, making them " +"useful as replication targets. The property defaults to `default`, which " +"defers to the system-wide `zvol_volmode` tunable described in man:zfs[4]." +msgstr "" +"Свойство `volmode` управляет тем, как ZFS предоставляет том операционной " +"системе. Установка значения `full` предоставляет том как провайдер GEOM с " +"максимальной функциональностью, а `geom` является псевдонимом для `full`. " +"Установка значения `dev` предоставляет том как обычный узел устройства, " +"скрывая любые разделы, которые он содержит. Тома с `volmode`, установленным " +"в `none`, не предоставляются за пределами ZFS вообще, но по-прежнему " +"поддерживают снимки, клоны и репликацию, что делает их полезными в качестве " +"целей репликации. Свойство по умолчанию имеет значение `default`, которое " +"откладывается на системную настройку `zvol_volmode`, описанную в man:zfs[4]." + +#. type: Plain text +#: documentation/content/en/books/handbook/zfs/_index.adoc:2175 +msgid "" +"Volumes work well as virtual disks for man:bhyve[8] virtual machines and as " +"backing storage for iSCSI extents: declare the volume device as a LUN in man:" +"ctl.conf[5] and serve it with man:ctld[8]." +msgstr "" +"Тома хорошо работают в качестве виртуальных дисков для виртуальных машин " +"man:bhyve[8] и как хранилище для экстентов iSCSI: объявите устройство тома " +"как LUN в man:ctl.conf[5] и обслуживайте его с помощью man:ctld[8]." + +#. type: delimited block = 4 +#: documentation/content/en/books/handbook/zfs/_index.adoc:2182 +msgid "" +"Do not place swap space on ZFS volumes. When the system is low on memory, " +"ZFS itself needs memory to complete the write that would release memory, and " +"the system can deadlock. See the upstream OpenZFS issue link:https://github." +"com/openzfs/zfs/issues/7734[openzfs/zfs#7734] for details. Use a dedicated " +"swap partition instead." +msgstr "" +"Не размещайте пространство подкачки на томах ZFS. Когда в системе " +"недостаточно памяти, сам ZFS нуждается в памяти для завершения записи, " +"которая освободила бы память, и система может зависнуть. Подробности см. в " +"upstream-проблеме OpenZFS link:https://github.com/openzfs/zfs/issues/7734[" +"openzfs/zfs#7734]. Вместо этого используйте выделенный раздел подкачки." + +#. type: Plain text +#: documentation/content/en/books/handbook/zfs/_index.adoc:2186 +msgid "" +"Destroying a volume is much the same as destroying a regular file system " +"dataset. The operation is nearly instantaneous, but it may take minutes to " +"reclaim the free space in the background." +msgstr "" +"Уничтожение тома во многом аналогично уничтожению обычного набора данных " +"файловой системы. Операция выполняется почти мгновенно, но освобождение " +"места может занять несколько минут и происходит в фоновом режиме." + +#. type: Title === +#: documentation/content/en/books/handbook/zfs/_index.adoc:2188 +#, no-wrap +msgid "Renaming a Dataset" +msgstr "Переименование набора данных" + +#. type: Plain text +#: documentation/content/en/books/handbook/zfs/_index.adoc:2195 +msgid "" +"To change the name of a dataset, use `zfs rename`. To change the parent of " +"a dataset, use this command as well. Renaming a dataset to have a different " +"parent dataset will change the value of those properties inherited from the " +"parent dataset. Renaming a dataset unmounts then remounts it in the new " +"location (inherited from the new parent dataset). To prevent this behavior, " +"use `-u`." +msgstr "" +"Для изменения имени набора данных используйте `zfs rename`. Эту же команду " +"можно использовать для изменения родительского набора данных. Переименование " +"набора данных с изменением родительского набора приведёт к изменению " +"значений свойств, унаследованных от родительского набора данных. " +"Переименование набора данных размонтирует, а затем снова смонтирует его в " +"новом месте (с учётом наследования от нового родительского набора данных). " +"Чтобы предотвратить это поведение, используйте опцию `-u`." + +#. type: Plain text +#: documentation/content/en/books/handbook/zfs/_index.adoc:2197 +msgid "Rename a dataset and move it to be under a different parent dataset:" +msgstr "" +"Переименовать набор данных и переместить его под другой родительский набор " +"данных:" + +#. type: delimited block . 4 +#: documentation/content/en/books/handbook/zfs/_index.adoc:2233 +#, no-wrap +msgid "" +"# zfs list\n" +"NAME USED AVAIL REFER MOUNTPOINT\n" +"mypool 780M 93.2G 144K none\n" +"mypool/ROOT 777M 93.2G 144K none\n" +"mypool/ROOT/default 777M 93.2G 777M /\n" +"mypool/tmp 176K 93.2G 176K /tmp\n" +"mypool/usr 704K 93.2G 144K /usr\n" +"mypool/usr/home 184K 93.2G 184K /usr/home\n" +"mypool/usr/mydataset 87.5K 93.2G 87.5K /usr/mydataset\n" +"mypool/usr/ports 144K 93.2G 144K /usr/ports\n" +"mypool/usr/src 144K 93.2G 144K /usr/src\n" +"mypool/var 1.21M 93.2G 614K /var\n" +"mypool/var/crash 148K 93.2G 148K /var/crash\n" +"mypool/var/log 178K 93.2G 178K /var/log\n" +"mypool/var/mail 144K 93.2G 144K /var/mail\n" +"mypool/var/tmp 152K 93.2G 152K /var/tmp\n" +"# zfs rename mypool/usr/mydataset mypool/var/newname\n" +"# zfs list\n" +"NAME USED AVAIL REFER MOUNTPOINT\n" +"mypool 780M 93.2G 144K none\n" +"mypool/ROOT 777M 93.2G 144K none\n" +"mypool/ROOT/default 777M 93.2G 777M /\n" +"mypool/tmp 176K 93.2G 176K /tmp\n" +"mypool/usr 616K 93.2G 144K /usr\n" +"mypool/usr/home 184K 93.2G 184K /usr/home\n" +"mypool/usr/ports 144K 93.2G 144K /usr/ports\n" +"mypool/usr/src 144K 93.2G 144K /usr/src\n" +"mypool/var 1.29M 93.2G 614K /var\n" +"mypool/var/crash 148K 93.2G 148K /var/crash\n" +"mypool/var/log 178K 93.2G 178K /var/log\n" +"mypool/var/mail 144K 93.2G 144K /var/mail\n" +"mypool/var/newname 87.5K 93.2G 87.5K /var/newname\n" +"mypool/var/tmp 152K 93.2G 152K /var/tmp\n" +msgstr "" +"# zfs list\n" +"NAME USED AVAIL REFER MOUNTPOINT\n" +"mypool 780M 93.2G 144K none\n" +"mypool/ROOT 777M 93.2G 144K none\n" +"mypool/ROOT/default 777M 93.2G 777M /\n" +"mypool/tmp 176K 93.2G 176K /tmp\n" +"mypool/usr 704K 93.2G 144K /usr\n" +"mypool/usr/home 184K 93.2G 184K /usr/home\n" +"mypool/usr/mydataset 87.5K 93.2G 87.5K /usr/mydataset\n" +"mypool/usr/ports 144K 93.2G 144K /usr/ports\n" +"mypool/usr/src 144K 93.2G 144K /usr/src\n" +"mypool/var 1.21M 93.2G 614K /var\n" +"mypool/var/crash 148K 93.2G 148K /var/crash\n" +"mypool/var/log 178K 93.2G 178K /var/log\n" +"mypool/var/mail 144K 93.2G 144K /var/mail\n" +"mypool/var/tmp 152K 93.2G 152K /var/tmp\n" +"# zfs rename mypool/usr/mydataset mypool/var/newname\n" +"# zfs list\n" +"NAME USED AVAIL REFER MOUNTPOINT\n" +"mypool 780M 93.2G 144K none\n" +"mypool/ROOT 777M 93.2G 144K none\n" +"mypool/ROOT/default 777M 93.2G 777M /\n" +"mypool/tmp 176K 93.2G 176K /tmp\n" +"mypool/usr 616K 93.2G 144K /usr\n" +"mypool/usr/home 184K 93.2G 184K /usr/home\n" +"mypool/usr/ports 144K 93.2G 144K /usr/ports\n" +"mypool/usr/src 144K 93.2G 144K /usr/src\n" +"mypool/var 1.29M 93.2G 614K /var\n" +"mypool/var/crash 148K 93.2G 148K /var/crash\n" +"mypool/var/log 178K 93.2G 178K /var/log\n" +"mypool/var/mail 144K 93.2G 144K /var/mail\n" +"mypool/var/newname 87.5K 93.2G 87.5K /var/newname\n" +"mypool/var/tmp 152K 93.2G 152K /var/tmp\n" + +#. type: Plain text +#: documentation/content/en/books/handbook/zfs/_index.adoc:2238 +msgid "" +"Renaming snapshots uses the same command. Due to the nature of snapshots, " +"rename cannot change their parent dataset. To rename a recursive snapshot, " +"specify `-r`; this will also rename all snapshots with the same name in " +"child datasets." +msgstr "" +"Переименование снимков выполняется той же командой. Из-за особенностей " +"снимков, их переименование не может изменить родительский набор данных. Для " +"рекурсивного переименования снимка укажите `-r`; это также переименует все " +"снимки с таким же именем в дочерних наборах данных." + +#. type: delimited block . 4 +#: documentation/content/en/books/handbook/zfs/_index.adoc:2248 +#, no-wrap +msgid "" +"# zfs list -t snapshot\n" +"NAME USED AVAIL REFER MOUNTPOINT\n" +"mypool/var/newname@first_snapshot 0 - 87.5K -\n" +"# zfs rename mypool/var/newname@first_snapshot new_snapshot_name\n" +"# zfs list -t snapshot\n" +"NAME USED AVAIL REFER MOUNTPOINT\n" +"mypool/var/newname@new_snapshot_name 0 - 87.5K -\n" +msgstr "" +"# zfs list -t snapshot\n" +"NAME USED AVAIL REFER MOUNTPOINT\n" +"mypool/var/newname@first_snapshot 0 - 87.5K -\n" +"# zfs rename mypool/var/newname@first_snapshot new_snapshot_name\n" +"# zfs list -t snapshot\n" +"NAME USED AVAIL REFER MOUNTPOINT\n" +"mypool/var/newname@new_snapshot_name 0 - 87.5K -\n" + +#. type: Title === +#: documentation/content/en/books/handbook/zfs/_index.adoc:2251 +#, no-wrap +msgid "Setting Dataset Properties" +msgstr "Установка свойств наборов данных" + +#. type: Plain text +#: documentation/content/en/books/handbook/zfs/_index.adoc:2261 +msgid "" +"Each ZFS dataset has properties that control its behavior. Most properties " +"are automatically inherited from the parent dataset, but can be overridden " +"locally. Set a property on a dataset with `zfs set _property=value " +"dataset_`. Most properties have a limited set of valid values, `zfs get` " +"will display each possible property and valid values. Using `zfs inherit` " +"reverts most properties to their inherited values. User-defined properties " +"are also possible. They become part of the dataset configuration and " +"provide further information about the dataset or its contents. To " +"distinguish these custom properties from the ones supplied as part of ZFS, " +"use a colon (`:`) to create a custom namespace for the property." +msgstr "" +"Каждый набор данных ZFS имеет свойства, которые определяют его поведение. " +"Большинство свойств автоматически наследуются от родительского набора " +"данных, но могут быть переопределены локально. Установите свойство для " +"набора данных с помощью `zfs set _свойство=значение набор_данных_`. " +"Большинство свойств имеют ограниченный набор допустимых значений, `zfs get` " +"отобразит каждое возможное свойство и допустимые значения. Использование " +"`zfs inherit` возвращает большинство свойств к их унаследованным значениям. " +"Также возможны пользовательские свойства. Они становятся частью конфигурации " +"набора данных и предоставляют дополнительную информацию о наборе данных или " +"его содержимом. Чтобы отличить эти пользовательские свойства от встроенных в " +"ZFS, используйте двоеточие (`:`), чтобы создать пользовательское " +"пространство имён для свойства." + +#. type: delimited block . 4 +#: documentation/content/en/books/handbook/zfs/_index.adoc:2268 +#, no-wrap +msgid "" +"# zfs set custom:costcenter=1234 tank\n" +"# zfs get custom:costcenter tank\n" +"NAME PROPERTY VALUE SOURCE\n" +"tank custom:costcenter 1234 local\n" +msgstr "" +"# zfs set custom:costcenter=1234 tank\n" +"# zfs get custom:costcenter tank\n" +"NAME PROPERTY VALUE SOURCE\n" +"tank custom:costcenter 1234 local\n" + +#. type: Plain text +#: documentation/content/en/books/handbook/zfs/_index.adoc:2272 +msgid "" +"To remove a custom property, use `zfs inherit` with `-r`. If the custom " +"property is not defined in any of the parent datasets, this option removes " +"it (but the pool's history still records the change)." +msgstr "" +"Чтобы удалить пользовательское свойство, используйте `zfs inherit` с " +"параметром `-r`. Если пользовательское свойство не определено ни в одном из " +"родительских наборов данных, эта опция удаляет его (но история пула всё " +"равно сохраняет запись об изменении)." + +#. type: delimited block . 4 +#: documentation/content/en/books/handbook/zfs/_index.adoc:2281 +#, no-wrap +msgid "" +"# zfs inherit -r custom:costcenter tank\n" +"# zfs get custom:costcenter tank\n" +"NAME PROPERTY VALUE SOURCE\n" +"tank custom:costcenter - -\n" +"# zfs get all tank | grep custom:costcenter\n" +"#\n" +msgstr "" +"# zfs inherit -r custom:costcenter tank\n" +"# zfs get custom:costcenter tank\n" +"NAME PROPERTY VALUE SOURCE\n" +"tank custom:costcenter - -\n" +"# zfs get all tank | grep custom:costcenter\n" +"#\n" + +#. type: Title ==== +#: documentation/content/en/books/handbook/zfs/_index.adoc:2284 +#, no-wrap +msgid "Getting and Setting Share Properties" +msgstr "Получение и установка свойств общего доступа" + +#. type: Plain text +#: documentation/content/en/books/handbook/zfs/_index.adoc:2291 +msgid "" +"Two commonly used and useful dataset properties are the NFS and SMB share " +"options. Setting these defines if and how ZFS shares datasets on the " +"network. On FreeBSD, ZFS integrates with the NFS server in the base system: " +"setting the `sharenfs` property exports the dataset through man:mountd[8]. " +"ZFS writes the export entry to [.filename]#/etc/zfs/exports#, which man:" +"mountd[8] reads in addition to [.filename]#/etc/exports#. Sharing datasets " +"requires the NFS server enabled in [.filename]#/etc/rc.conf#:" +msgstr "" +"Два часто используемых и полезных свойства наборов данных — это параметры " +"общего доступа NFS и SMB. Их установка определяет, экспортируются ли наборы " +"данных ZFS в сеть и каким образом. Во FreeBSD ZFS интегрируется с NFS-" +"сервером в базовой системе: установка свойства `sharenfs` экспортирует набор " +"данных через man:mountd[8]. ZFS записывает запись экспорта в [.filename]#/" +"etc/zfs/exports#, которую man:mountd[8] читает в дополнение к [.filename]#/" +"etc/exports#. Для общего доступа к наборам данных требуется включенный NFS-" +"сервер в [.filename]#/etc/rc.conf#:" + +#. type: delimited block . 4 +#: documentation/content/en/books/handbook/zfs/_index.adoc:2296 +#, no-wrap +msgid "" +"zfs_enable=\"YES\"\n" +"nfs_server_enable=\"YES\"\n" +msgstr "" +"zfs_enable=\"YES\"\n" +"nfs_server_enable=\"YES\"\n" + +#. type: Plain text +#: documentation/content/en/books/handbook/zfs/_index.adoc:2299 +msgid "" +"The value of `sharenfs` is either `on`, `off`, or a list of man:exports[5] " +"options to apply to the export." +msgstr "" +"Значение `sharenfs` может быть `on`, `off` или списком параметров " +"man:exports[5], применяемых к экспорту." + +#. type: Plain text +#: documentation/content/en/books/handbook/zfs/_index.adoc:2301 +msgid "To get the current status of a share, enter:" +msgstr "Чтобы получить текущее состояние общего каталога, введите:" + +#. type: delimited block . 4 +#: documentation/content/en/books/handbook/zfs/_index.adoc:2307 +#, no-wrap +msgid "" +"# zfs get sharenfs mypool/usr/home\n" +"NAME PROPERTY VALUE SOURCE\n" +"mypool/usr/home sharenfs on local\n" +msgstr "" +"# zfs get sharenfs mypool/usr/home\n" +"NAME PROPERTY VALUE SOURCE\n" +"mypool/usr/home sharenfs on local\n" + +#. type: Plain text +#: documentation/content/en/books/handbook/zfs/_index.adoc:2310 +msgid "To enable sharing of a dataset, enter:" +msgstr "Чтобы включить общий доступ к набору данных, введите:" + +#. type: delimited block . 4 +#: documentation/content/en/books/handbook/zfs/_index.adoc:2314 +#, no-wrap +msgid "# zfs set sharenfs=on mypool/usr/home\n" +msgstr "# zfs set sharenfs=on mypool/usr/home\n" + +#. type: Plain text +#: documentation/content/en/books/handbook/zfs/_index.adoc:2318 +msgid "" +"Set other options for sharing datasets through NFS, such as `-alldirs`, `-" +"maproot` and `-network`. To set options on a dataset shared through NFS, " +"enter:" +msgstr "" +"Установите другие параметры для общего доступа к наборам данных через NFS, " +"такие как `-alldirs`, `-maproot` и `-network`. Чтобы задать параметры для " +"набора данных, доступного через NFS, введите:" + +#. type: delimited block . 4 +#: documentation/content/en/books/handbook/zfs/_index.adoc:2322 +#, no-wrap +msgid "# zfs set sharenfs=\"-alldirs,-maproot=root,-network=192.168.1.0/24\" mypool/usr/home\n" +msgstr "# zfs set sharenfs=\"-alldirs,-maproot=root,-network=192.168.1.0/24\" mypool/usr/home\n" + +#. type: Plain text +#: documentation/content/en/books/handbook/zfs/_index.adoc:2326 +msgid "" +"The `sharesmb` property is not functional on FreeBSD, as the sharing library " +"implements NFS only. To serve a dataset over SMB, install a package such as " +"package:net/samba422[] and export the path of the mounted dataset in its " +"configuration." +msgstr "" +"Свойство `sharesmb` не работает во FreeBSD, так как библиотека совместного " +"доступа реализует только NFS. Чтобы предоставить набор данных по SMB, " +"установите пакет, например package:net/samba422[], и укажите путь " +"смонтированного набора данных в его конфигурации." + +#. type: Title === +#: documentation/content/en/books/handbook/zfs/_index.adoc:2328 +#, no-wrap +msgid "NFSv4 ACLs" +msgstr "NFSv4 ACL" + +#. type: Plain text +#: documentation/content/en/books/handbook/zfs/_index.adoc:2333 +msgid "" +"ZFS on FreeBSD stores NFSv4-style ACLs natively; the `acltype` dataset " +"property defaults to `nfsv4`. Every file and directory can carry an access " +"control list alongside the traditional permission bits, giving finer-grained " +"control than the owner/group/other model. Display and edit these lists with " +"man:getfacl[1] and man:setfacl[1]." +msgstr "" +"ZFS во FreeBSD хранит ACL в стиле NFSv4 нативно; свойство набора данных " +"`acltype` по умолчанию имеет значение `nfsv4`. Каждый файл и каталог может " +"нести список управления доступом наряду с традиционными битами разрешений, " +"обеспечивая более тонкий контроль, чем модель владелец/группа/остальные. " +"Отображайте и редактируйте эти списки с помощью man:getfacl[1] и " +"man:setfacl[1]." + +#. type: Plain text +#: documentation/content/en/books/handbook/zfs/_index.adoc:2335 +msgid "Display the ACL of a file:" +msgstr "Отобразить ACL файла:" + +#. type: delimited block . 4 +#: documentation/content/en/books/handbook/zfs/_index.adoc:2345 +#, no-wrap +msgid "" +"% getfacl /usr/home/alice/notes.txt\n" +"# file: /usr/home/alice/notes.txt\n" +"# owner: alice\n" +"# group: alice\n" +" owner@:rw-p--aARWcCos:-------:allow\n" +" group@:r-----a-R-c--s:-------:allow\n" +" everyone@:r-----a-R-c--s:-------:allow\n" +msgstr "" +"% getfacl /usr/home/alice/notes.txt\n" +"# file: /usr/home/alice/notes.txt\n" +"# owner: alice\n" +"# group: alice\n" +" owner@:rw-p--aARWcCos:-------:allow\n" +" group@:r-----a-R-c--s:-------:allow\n" +" everyone@:r-----a-R-c--s:-------:allow\n" + +#. type: Plain text +#: documentation/content/en/books/handbook/zfs/_index.adoc:2348 +msgid "Grant an additional user write access by adding an `allow` entry:" +msgstr "" +"Предоставьте дополнительному пользователю доступ на запись, добавив запись " +"`allow`:" + +#. type: delimited block . 4 +#: documentation/content/en/books/handbook/zfs/_index.adoc:2352 +#, no-wrap +msgid "% setfacl -m u:bob:rwp::allow /usr/home/alice/notes.txt\n" +msgstr "% setfacl -m u:bob:rwp::allow /usr/home/alice/notes.txt\n" + +#. type: Plain text +#: documentation/content/en/books/handbook/zfs/_index.adoc:2359 +msgid "" +"Two dataset properties control how ACLs interact with traditional permission " +"handling. The `aclmode` property (`discard`, `groupmask`, `passthrough`, or " +"`restricted`) governs what happens to the ACL when man:chmod[1] changes the " +"permission bits of a file. With the default, `discard`, chmod removes all " +"ACL entries that do not represent the new file mode. The `aclinherit` " +"property (`discard`, `noallow`, `restricted`, `passthrough`, or `passthrough-" +"x`) governs which ACL entries new files and directories inherit from their " +"parent directory. With the default, `restricted`, inherited entries lose " +"the `write_acl` and `write_owner` permissions." +msgstr "" +"Два свойства наборов данных управляют тем, как ACL взаимодействуют с " +"традиционной обработкой разрешений. Свойство `aclmode` (`discard`, " +"`groupmask`, `passthrough` или `restricted`) определяет, что происходит с " +"ACL, когда man:chmod[1] изменяет биты разрешений файла. При значении по " +"умолчанию, `discard`, chmod удаляет все записи ACL, которые не представляют " +"новый режим файла. Свойство `aclinherit` (`discard`, `noallow`, `restricted`" +", `passthrough` или `passthrough-x`) определяет, какие записи ACL новые " +"файлы и каталоги наследуют от родительского каталога. При значении по " +"умолчанию, `restricted`, унаследованные записи теряют разрешения `write_acl` " +"и `write_owner`." + +#. type: Plain text +#: documentation/content/en/books/handbook/zfs/_index.adoc:2361 +msgid "" +"See man:setfacl[1] and man:zfsprops[7] for the full entry syntax and " +"property descriptions." +msgstr "" +"Смотрите man:setfacl[1] и man:zfsprops[7] для полного синтаксиса записей и " +"описаний свойств." + +#. type: Title === +#: documentation/content/en/books/handbook/zfs/_index.adoc:2363 +#, no-wrap +msgid "Managing Snapshots" +msgstr "Управление снимками" + +#. type: Plain text +#: documentation/content/en/books/handbook/zfs/_index.adoc:2377 +msgid "" +"crossref:zfs[zfs-term-snapshot,Snapshots] are one of the most powerful " +"features of ZFS. A snapshot provides a read-only, point-in-time copy of the " +"dataset. With Copy-On-Write (COW), ZFS creates snapshots fast by preserving " +"older versions of the data on disk. If no snapshots exist, ZFS reclaims " +"space for future use when data is rewritten or deleted. Snapshots preserve " +"disk space by recording just the differences between the current dataset and " +"a previous version. Allowing snapshots on whole datasets, not on individual " +"files or directories. A snapshot from a dataset duplicates everything " +"contained in it. This includes the file system properties, files, " +"directories, permissions, and so on. Snapshots use no extra space when " +"first created, but consume space as the blocks they reference change. " +"Recursive snapshots taken with `-r` create snapshots with the same name on " +"the dataset and its children, providing a consistent moment-in-time snapshot " +"of the file systems. This can be important when an application has files on " +"related datasets or that depend upon each other. Without snapshots, a " +"backup would have copies of the files from different points in time." +msgstr "" +"crossref:zfs[zfs-term-snapshot,Снимки] — одна из самых мощных функций ZFS. " +"Снимок предоставляет доступную только для чтения копию набора данных на " +"определённый момент времени. Благодаря механизму Copy-On-Write (COW), ZFS " +"быстро создаёт снимки, сохраняя старые версии данных на диске. Если снимков " +"не существует, ZFS освобождает место для последующего использования при " +"перезаписи или удалении данных. Снимки экономят дисковое пространство, " +"записывая только различия между текущим набором данных и предыдущей версией. " +"Создание снимков возможно для целых наборов данных, но не для отдельных " +"файлов или каталогов. Снимок набора данных дублирует всё его содержимое. Это " +"включает свойства файловой системы, файлы, каталоги, права доступа и так " +"далее. Снимки не занимают дополнительного места при создании, но начинают " +"потреблять пространство по мере изменения блоков, на которые они ссылаются. " +"Рекурсивные снимки, созданные с помощью `-r`, формируют снимки с одинаковыми " +"именами для набора данных и его дочерних элементов, обеспечивая " +"согласованный снимок файловых систем на определённый момент времени. Это " +"может быть важно, когда приложение использует файлы в связанных наборах " +"данных или зависящие друг от друга. Без снимков резервная копия содержала бы " +"файлы из разных моментов времени." + +#. type: Plain text +#: documentation/content/en/books/handbook/zfs/_index.adoc:2386 +msgid "" +"Snapshots in ZFS provide a variety of features that even other file systems " +"with snapshot functionality lack. A typical example of snapshot use is as a " +"quick way of backing up the current state of the file system when performing " +"a risky action like a software installation or a system upgrade. If the " +"action fails, rolling back to the snapshot returns the system to the same " +"state when creating the snapshot. If the upgrade was successful, delete the " +"snapshot to free up space. Without snapshots, a failed upgrade often " +"requires restoring backups, which is tedious, time consuming, and may " +"require downtime during which the system is unusable. Rolling back to " +"snapshots is fast, even while the system is running in normal operation, " +"with little or no downtime. The time savings are enormous with multi-" +"terabyte storage systems considering the time required to copy the data from " +"backup. Snapshots are not a replacement for a complete backup of a pool, " +"but offer a quick and easy way to store a dataset copy at a specific time." +msgstr "" +"Снимки в ZFS предоставляют множество функций, которых нет даже в других " +"файловых системах с поддержкой снимков. Типичный пример использования " +"снимков — быстрое резервное копирование текущего состояния файловой системы " +"перед выполнением рискованных действий, таких как установка программного " +"обеспечения или обновление системы. Если действие завершится неудачей, откат " +"к снимку вернёт систему в состояние на момент его создания. Если обновление " +"прошло успешно, снимок можно удалить для освобождения места. Без снимков " +"неудачное обновление часто требует восстановления из резервных копий, что " +"утомительно, отнимает много времени и может привести к простою системы, в " +"течение которого она будет недоступна. Откат к снимкам выполняется быстро, " +"даже во время обычной работы системы, с минимальным или нулевым временем " +"простоя. Экономия времени огромна, особенно для многотерабайтных систем " +"хранения, учитывая время, необходимое для копирования данных из резервной " +"копии. Снимки не заменяют полное резервное копирование пула, но предлагают " +"быстрый и простой способ сохранить копию набора данных на определённый " +"момент времени." + +#. type: Title ==== +#: documentation/content/en/books/handbook/zfs/_index.adoc:2388 +#, no-wrap +msgid "Creating Snapshots" +msgstr "Создание снимков" + +#. type: Plain text +#: documentation/content/en/books/handbook/zfs/_index.adoc:2392 +msgid "" +"To create snapshots, use `zfs snapshot _dataset_@_snapshotname_`. Adding `-" +"r` creates a snapshot recursively, with the same name on all child datasets." +msgstr "" +"Для создания снимков используйте `zfs snapshot _наборданных_@_имяснимка_`. " +"Добавление опции `-r` создаёт снимок рекурсивно с тем же именем для всех " +"дочерних наборов данных." + +#. type: Plain text +#: documentation/content/en/books/handbook/zfs/_index.adoc:2394 +msgid "Create a recursive snapshot of the entire pool:" +msgstr "Создать рекурсивный снимок всего пула:" + +#. type: delimited block . 4 +#: documentation/content/en/books/handbook/zfs/_index.adoc:2432 +#, no-wrap +msgid "" +"# zfs list -t all\n" +"NAME USED AVAIL REFER MOUNTPOINT\n" +"mypool 780M 93.2G 144K none\n" +"mypool/ROOT 777M 93.2G 144K none\n" +"mypool/ROOT/default 777M 93.2G 777M /\n" +"mypool/tmp 176K 93.2G 176K /tmp\n" +"mypool/usr 616K 93.2G 144K /usr\n" +"mypool/usr/home 184K 93.2G 184K /usr/home\n" +"mypool/usr/ports 144K 93.2G 144K /usr/ports\n" +"mypool/usr/src 144K 93.2G 144K /usr/src\n" +"mypool/var 1.29M 93.2G 616K /var\n" +"mypool/var/crash 148K 93.2G 148K /var/crash\n" +"mypool/var/log 178K 93.2G 178K /var/log\n" +"mypool/var/mail 144K 93.2G 144K /var/mail\n" +"mypool/var/newname 87.5K 93.2G 87.5K /var/newname\n" +"mypool/var/newname@new_snapshot_name 0 - 87.5K -\n" +"mypool/var/tmp 152K 93.2G 152K /var/tmp\n" +"# zfs snapshot -r mypool@my_recursive_snapshot\n" +"# zfs list -t snapshot\n" +"NAME USED AVAIL REFER MOUNTPOINT\n" +"mypool@my_recursive_snapshot 0 - 144K -\n" +"mypool/ROOT@my_recursive_snapshot 0 - 144K -\n" +"mypool/ROOT/default@my_recursive_snapshot 0 - 777M -\n" +"mypool/tmp@my_recursive_snapshot 0 - 176K -\n" +"mypool/usr@my_recursive_snapshot 0 - 144K -\n" +"mypool/usr/home@my_recursive_snapshot 0 - 184K -\n" +"mypool/usr/ports@my_recursive_snapshot 0 - 144K -\n" +"mypool/usr/src@my_recursive_snapshot 0 - 144K -\n" +"mypool/var@my_recursive_snapshot 0 - 616K -\n" +"mypool/var/crash@my_recursive_snapshot 0 - 148K -\n" +"mypool/var/log@my_recursive_snapshot 0 - 178K -\n" +"mypool/var/mail@my_recursive_snapshot 0 - 144K -\n" +"mypool/var/newname@new_snapshot_name 0 - 87.5K -\n" +"mypool/var/newname@my_recursive_snapshot 0 - 87.5K -\n" +"mypool/var/tmp@my_recursive_snapshot 0 - 152K -\n" +msgstr "" +"# zfs list -t all\n" +"NAME USED AVAIL REFER MOUNTPOINT\n" +"mypool 780M 93.2G 144K none\n" +"mypool/ROOT 777M 93.2G 144K none\n" +"mypool/ROOT/default 777M 93.2G 777M /\n" +"mypool/tmp 176K 93.2G 176K /tmp\n" +"mypool/usr 616K 93.2G 144K /usr\n" +"mypool/usr/home 184K 93.2G 184K /usr/home\n" +"mypool/usr/ports 144K 93.2G 144K /usr/ports\n" +"mypool/usr/src 144K 93.2G 144K /usr/src\n" +"mypool/var 1.29M 93.2G 616K /var\n" +"mypool/var/crash 148K 93.2G 148K /var/crash\n" +"mypool/var/log 178K 93.2G 178K /var/log\n" +"mypool/var/mail 144K 93.2G 144K /var/mail\n" +"mypool/var/newname 87.5K 93.2G 87.5K /var/newname\n" +"mypool/var/newname@new_snapshot_name 0 - 87.5K -\n" +"mypool/var/tmp 152K 93.2G 152K /var/tmp\n" +"# zfs snapshot -r mypool@my_recursive_snapshot\n" +"# zfs list -t snapshot\n" +"NAME USED AVAIL REFER MOUNTPOINT\n" +"mypool@my_recursive_snapshot 0 - 144K -\n" +"mypool/ROOT@my_recursive_snapshot 0 - 144K -\n" +"mypool/ROOT/default@my_recursive_snapshot 0 - 777M -\n" +"mypool/tmp@my_recursive_snapshot 0 - 176K -\n" +"mypool/usr@my_recursive_snapshot 0 - 144K -\n" +"mypool/usr/home@my_recursive_snapshot 0 - 184K -\n" +"mypool/usr/ports@my_recursive_snapshot 0 - 144K -\n" +"mypool/usr/src@my_recursive_snapshot 0 - 144K -\n" +"mypool/var@my_recursive_snapshot 0 - 616K -\n" +"mypool/var/crash@my_recursive_snapshot 0 - 148K -\n" +"mypool/var/log@my_recursive_snapshot 0 - 178K -\n" +"mypool/var/mail@my_recursive_snapshot 0 - 144K -\n" +"mypool/var/newname@new_snapshot_name 0 - 87.5K -\n" +"mypool/var/newname@my_recursive_snapshot 0 - 87.5K -\n" +"mypool/var/tmp@my_recursive_snapshot 0 - 152K -\n" + +#. type: Plain text +#: documentation/content/en/books/handbook/zfs/_index.adoc:2437 +msgid "" +"Snapshots are not shown by a normal `zfs list` operation. To list " +"snapshots, append `-t snapshot` to `zfs list`. `-t all` displays both file " +"systems and snapshots." +msgstr "" +"Снимки не отображаются при обычной операции `zfs list`. Для вывода списка " +"снимков добавьте `-t snapshot` к команде `zfs list`. Опция `-t all` " +"показывает как файловые системы, так и снимки." + +#. type: Plain text +#: documentation/content/en/books/handbook/zfs/_index.adoc:2441 +msgid "" +"Snapshots are not mounted directly, showing no path in the `MOUNTPOINT` " +"column. ZFS does not mention available disk space in the `AVAIL` column, as " +"snapshots are read-only after their creation. Compare the snapshot to the " +"original dataset:" +msgstr "" +"Снимки не монтируются напрямую, поэтому в столбце `MOUNTPOINT` не " +"отображается путь. ZFS не указывает доступное дисковое пространство в " +"столбце `AVAIL`, так как снимки доступны только для чтения после их " +"создания. Сравните снимок с исходным набором данных:" + +#. type: delimited block . 4 +#: documentation/content/en/books/handbook/zfs/_index.adoc:2448 +#, no-wrap +msgid "" +"# zfs list -rt all mypool/usr/home\n" +"NAME USED AVAIL REFER MOUNTPOINT\n" +"mypool/usr/home 184K 93.2G 184K /usr/home\n" +"mypool/usr/home@my_recursive_snapshot 0 - 184K -\n" +msgstr "" +"# zfs list -rt all mypool/usr/home\n" +"NAME USED AVAIL REFER MOUNTPOINT\n" +"mypool/usr/home 184K 93.2G 184K /usr/home\n" +"mypool/usr/home@my_recursive_snapshot 0 - 184K -\n" + +#. type: Plain text +#: documentation/content/en/books/handbook/zfs/_index.adoc:2454 +msgid "" +"Displaying both the dataset and the snapshot together reveals how snapshots " +"work in crossref:zfs[zfs-term-cow,COW] fashion. They save the changes " +"(_delta_) made and not the complete file system contents all over again. " +"This means that snapshots take little space when making changes. Observe " +"space usage even more by copying a file to the dataset, then creating a " +"second snapshot:" +msgstr "" +"Отображение набора данных и снимка вместе показывает, как снимки работают в " +"стиле crossref:zfs[zfs-term-cow,COW]. Они сохраняют внесённые изменения " +"(_дельту_), а не полное содержимое файловой системы заново. Это означает, " +"что снимки занимают мало места при внесении изменений. Наблюдайте за " +"использованием пространства ещё внимательнее, скопировав файл в набор " +"данных, а затем создав второй снимок:" + +#. type: delimited block . 4 +#: documentation/content/en/books/handbook/zfs/_index.adoc:2464 +#, no-wrap +msgid "" +"# cp /etc/passwd /var/tmp\n" +"# zfs snapshot mypool/var/tmp@after_cp\n" +"# zfs list -rt all mypool/var/tmp\n" +"NAME USED AVAIL REFER MOUNTPOINT\n" +"mypool/var/tmp 206K 93.2G 118K /var/tmp\n" +"mypool/var/tmp@my_recursive_snapshot 88K - 152K -\n" +"mypool/var/tmp@after_cp 0 - 118K -\n" +msgstr "" +"# cp /etc/passwd /var/tmp\n" +"# zfs snapshot mypool/var/tmp@after_cp\n" +"# zfs list -rt all mypool/var/tmp\n" +"NAME USED AVAIL REFER MOUNTPOINT\n" +"mypool/var/tmp 206K 93.2G 118K /var/tmp\n" +"mypool/var/tmp@my_recursive_snapshot 88K - 152K -\n" +"mypool/var/tmp@after_cp 0 - 118K -\n" + +#. type: Plain text +#: documentation/content/en/books/handbook/zfs/_index.adoc:2469 +msgid "" +"The second snapshot contains the changes to the dataset after the copy " +"operation. This yields enormous space savings. Notice that the size of the " +"snapshot `_mypool/var/tmp@my_recursive_snapshot_` also changed in the `USED` " +"column to show the changes between itself and the snapshot taken afterwards." +msgstr "" +"Второй снимок содержит изменения в наборе данных после операции копирования. " +"Это обеспечивает значительную экономию пространства. Обратите внимание, что " +"размер снимка `_mypool/var/tmp@my_recursive_snapshot_` также изменился в " +"столбце `USED`, показывая разницу между ним и последующим снимком." + +#. type: Title ==== +#: documentation/content/en/books/handbook/zfs/_index.adoc:2471 +#, no-wrap +msgid "Comparing Snapshots" +msgstr "Сравнение снимков" + +#. type: Plain text +#: documentation/content/en/books/handbook/zfs/_index.adoc:2477 +msgid "" +"ZFS provides a built-in command to compare the differences in content " +"between two snapshots. This is helpful with a lot of snapshots taken over " +"time when the user wants to see how the file system has changed over time. " +"For example, `zfs diff` lets a user find the latest snapshot that still " +"contains a file deleted by accident. Doing this for the two snapshots " +"created in the previous section yields this output:" +msgstr "" +"ZFS предоставляет встроенную команду для сравнения различий в содержимом " +"между двумя снимками. Это полезно при наличии множества снимков, сделанных " +"за определённый период, когда пользователь хочет увидеть, как файловая " +"система изменялась со временем. Например, `zfs diff` позволяет пользователю " +"найти последний снимок, который ещё содержит случайно удалённый файл. " +"Применение этой команды к двум снимкам, созданным в предыдущем разделе, даёт " +"следующий вывод:" + +#. type: delimited block . 4 +#: documentation/content/en/books/handbook/zfs/_index.adoc:2488 +#, no-wrap +msgid "" +"# zfs list -rt all mypool/var/tmp\n" +"NAME USED AVAIL REFER MOUNTPOINT\n" +"mypool/var/tmp 206K 93.2G 118K /var/tmp\n" +"mypool/var/tmp@my_recursive_snapshot 88K - 152K -\n" +"mypool/var/tmp@after_cp 0 - 118K -\n" +"# zfs diff mypool/var/tmp@my_recursive_snapshot\n" +"M /var/tmp/\n" +"+ /var/tmp/passwd\n" +msgstr "" +"# zfs list -rt all mypool/var/tmp\n" +"NAME USED AVAIL REFER MOUNTPOINT\n" +"mypool/var/tmp 206K 93.2G 118K /var/tmp\n" +"mypool/var/tmp@my_recursive_snapshot 88K - 152K -\n" +"mypool/var/tmp@after_cp 0 - 118K -\n" +"# zfs diff mypool/var/tmp@my_recursive_snapshot\n" +"M /var/tmp/\n" +"+ /var/tmp/passwd\n" + +#. type: Plain text +#: documentation/content/en/books/handbook/zfs/_index.adoc:2492 +msgid "" +"The command lists the changes between the specified snapshot (in this case " +"`_mypool/var/tmp@my_recursive_snapshot_`) and the live file system. The " +"first column shows the change type:" +msgstr "" +"Команда выводит список изменений между указанным снимком (в данном случае " +"`_mypool/var/tmp@my_recursive_snapshot_`) и активной файловой системой. " +"Первый столбец показывает тип изменения:" + +#. type: Table +#: documentation/content/en/books/handbook/zfs/_index.adoc:2498 +#, no-wrap +msgid "+" +msgstr "+" + +#. type: Table +#: documentation/content/en/books/handbook/zfs/_index.adoc:2500 +#, no-wrap +msgid "Adding the path or file." +msgstr "Добавление пути или файла." + +#. type: Table +#: documentation/content/en/books/handbook/zfs/_index.adoc:2501 +#, no-wrap +msgid "-" +msgstr "-" + +#. type: Table +#: documentation/content/en/books/handbook/zfs/_index.adoc:2503 +#, no-wrap +msgid "Deleting the path or file." +msgstr "Удаление пути или файла." + +#. type: Table +#: documentation/content/en/books/handbook/zfs/_index.adoc:2504 +#, no-wrap +msgid "M" +msgstr "M" + +#. type: Table +#: documentation/content/en/books/handbook/zfs/_index.adoc:2506 +#, no-wrap +msgid "Modifying the path or file." +msgstr "Изменение пути или файла." + +#. type: Table +#: documentation/content/en/books/handbook/zfs/_index.adoc:2507 +#, no-wrap +msgid "R" +msgstr "R" + +#. type: Table +#: documentation/content/en/books/handbook/zfs/_index.adoc:2508 +#, no-wrap +msgid "Renaming the path or file." +msgstr "Переименование пути или файла." + +#. type: Plain text +#: documentation/content/en/books/handbook/zfs/_index.adoc:2512 +msgid "" +"Comparing the output with the table, it becomes clear that ZFS added [." +"filename]#passwd# after creating the snapshot `_mypool/var/" +"tmp@my_recursive_snapshot_`. This also resulted in a modification to the " +"parent directory mounted at `_/var/tmp_`." +msgstr "" +"Сравнивая вывод с таблицей, становится ясно, что ZFS добавил [." +"filename]#passwd# после создания снимка `_mypool/var/" +"tmp@my_recursive_snapshot_`. Это также привело к изменению родительского " +"каталога, смонтированного в `_/var/tmp_`." + +#. type: Plain text +#: documentation/content/en/books/handbook/zfs/_index.adoc:2514 +msgid "" +"Comparing two snapshots is helpful when using the ZFS replication feature to " +"transfer a dataset to a different host for backup purposes." +msgstr "" +"Сравнение двух снимков полезно при использовании функции репликации ZFS для " +"передачи набора данных на другой хост в целях резервного копирования." + +#. type: Plain text +#: documentation/content/en/books/handbook/zfs/_index.adoc:2516 +msgid "" +"Compare two snapshots by providing the full dataset name and snapshot name " +"of both datasets:" +msgstr "" +"Сравните два снимка, указав полное имя набора данных и имя снимка для обоих " +"наборов:" + +#. type: delimited block . 4 +#: documentation/content/en/books/handbook/zfs/_index.adoc:2528 +#, no-wrap +msgid "" +"# cp /var/tmp/passwd /var/tmp/passwd.copy\n" +"# zfs snapshot mypool/var/tmp@diff_snapshot\n" +"# zfs diff mypool/var/tmp@my_recursive_snapshot mypool/var/tmp@diff_snapshot\n" +"M /var/tmp/\n" +"+ /var/tmp/passwd\n" +"+ /var/tmp/passwd.copy\n" +"# zfs diff mypool/var/tmp@my_recursive_snapshot mypool/var/tmp@after_cp\n" +"M /var/tmp/\n" +"+ /var/tmp/passwd\n" +msgstr "" +"# cp /var/tmp/passwd /var/tmp/passwd.copy\n" +"# zfs snapshot mypool/var/tmp@diff_snapshot\n" +"# zfs diff mypool/var/tmp@my_recursive_snapshot mypool/var/tmp@diff_snapshot\n" +"M /var/tmp/\n" +"+ /var/tmp/passwd\n" +"+ /var/tmp/passwd.copy\n" +"# zfs diff mypool/var/tmp@my_recursive_snapshot mypool/var/tmp@after_cp\n" +"M /var/tmp/\n" +"+ /var/tmp/passwd\n" + +#. type: Plain text +#: documentation/content/en/books/handbook/zfs/_index.adoc:2532 +msgid "" +"A backup administrator can compare two snapshots received from the sending " +"host and determine the actual changes in the dataset. See the crossref:" +"zfs[zfs-zfs-send,Replication] section for more information." +msgstr "" +"Администратор резервного копирования может сравнить два снимка, полученных " +"от отправляющего хоста, и определить фактические изменения в наборе данных. " +"Дополнительную информацию см. в разделе crossref:zfs[zfs-zfs-send," +"Репликация]." + +#. type: Title ==== +#: documentation/content/en/books/handbook/zfs/_index.adoc:2534 +#, no-wrap +msgid "Snapshot Rollback" +msgstr "Откат снимка состояния (Snapshot Rollback)" + +#. type: Plain text +#: documentation/content/en/books/handbook/zfs/_index.adoc:2547 +msgid "" +"When at least one snapshot is available, roll back to it at any time. Most " +"often this is the case when the current state of the dataset is no longer " +"valid or an older version is preferred. Scenarios such as local development " +"tests gone wrong, botched system updates hampering the system functionality, " +"or the need to restore deleted files or directories are all too common " +"occurrences. To roll back a snapshot, use `zfs rollback _snapshotname_`. " +"If a lot of changes are present, the operation will take a long time. " +"During that time, the dataset always remains in a consistent state, much " +"like a database that conforms to ACID principles is performing a rollback. " +"This is happening while the dataset is live and accessible without requiring " +"a downtime. Once the snapshot rolled back, the dataset has the same state " +"as it had when the snapshot was originally taken. Rolling back to a " +"snapshot discards all other data in that dataset not part of the snapshot. " +"Taking a snapshot of the current state of the dataset before rolling back to " +"a previous one is a good idea when requiring some data later. This way, the " +"user can roll back and forth between snapshots without losing data that is " +"still valuable." +msgstr "" +"Когда доступен хотя бы один снимок, можно в любой момент к нему вернуться. " +"Чаще всего это необходимо, когда текущее состояние набора данных больше не " +"является корректным или требуется более старая версия. Такие ситуации, как " +"неудачные локальные тесты разработки, неудачные обновления системы, " +"нарушающие её функциональность, или необходимость восстановления удалённых " +"файлов или каталогов, встречаются довольно часто. Для возврата к снимку " +"используйте команду `zfs rollback _имя_снимка_`. Если изменений много, " +"операция займёт значительное время. В течение этого времени набор данных " +"всегда остаётся в согласованном состоянии, подобно тому, как база данных, " +"соответствующая принципам ACID, выполняет откат. Это происходит, пока набор " +"данных находится в рабочем состоянии и доступен без необходимости простоя. " +"После отката к снимку набор данных возвращается в то же состояние, в котором " +"он находился на момент создания снимка. Откат к снимку удаляет все другие " +"данные в наборе, не входящие в снимок. Создание снимка текущего состояния " +"набора данных перед откатом к предыдущему — хорошая практика, если некоторые " +"данные могут потребоваться позже. Таким образом, пользователь может " +"переключаться между снимками, не теряя ценные данные." + +#. type: Plain text +#: documentation/content/en/books/handbook/zfs/_index.adoc:2549 +msgid "" +"In the first example, roll back a snapshot because a careless `rm` operation " +"removed more data than intended." +msgstr "" +"В первом примере выполняется откат к снимку, потому что неосторожная " +"операция `rm` удалила больше данных, чем планировалось." + +#. type: delimited block . 4 +#: documentation/content/en/books/handbook/zfs/_index.adoc:2563 +#, no-wrap +msgid "" +"# zfs list -rt all mypool/var/tmp\n" +"NAME USED AVAIL REFER MOUNTPOINT\n" +"mypool/var/tmp 262K 93.2G 120K /var/tmp\n" +"mypool/var/tmp@my_recursive_snapshot 88K - 152K -\n" +"mypool/var/tmp@after_cp 53.5K - 118K -\n" +"mypool/var/tmp@diff_snapshot 0 - 120K -\n" +"# ls /var/tmp\n" +"passwd passwd.copy vi.recover\n" +"# rm /var/tmp/passwd*\n" +"# ls /var/tmp\n" +"vi.recover\n" +msgstr "" +"# zfs list -rt all mypool/var/tmp\n" +"NAME USED AVAIL REFER MOUNTPOINT\n" +"mypool/var/tmp 262K 93.2G 120K /var/tmp\n" +"mypool/var/tmp@my_recursive_snapshot 88K - 152K -\n" +"mypool/var/tmp@after_cp 53.5K - 118K -\n" +"mypool/var/tmp@diff_snapshot 0 - 120K -\n" +"# ls /var/tmp\n" +"passwd passwd.copy vi.recover\n" +"# rm /var/tmp/passwd*\n" +"# ls /var/tmp\n" +"vi.recover\n" + +#. type: Plain text +#: documentation/content/en/books/handbook/zfs/_index.adoc:2568 +msgid "" +"At this point, the user notices the removal of extra files and wants them " +"back. ZFS provides an easy way to get them back using rollbacks, when " +"performing snapshots of important data on a regular basis. To get the files " +"back and start over from the last snapshot, issue the command:" +msgstr "" +"На этом этапе пользователь замечает удаление лишних файлов и хочет вернуть " +"их обратно. ZFS предоставляет простой способ восстановления с использованием " +"отката, если регулярно создаются снимки важных данных. Чтобы вернуть файлы и " +"начать заново с последнего снимка, выполните команду:" + +#. type: delimited block . 4 +#: documentation/content/en/books/handbook/zfs/_index.adoc:2574 +#, no-wrap +msgid "" +"# zfs rollback mypool/var/tmp@diff_snapshot\n" +"# ls /var/tmp\n" +"passwd passwd.copy vi.recover\n" +msgstr "" +"# zfs rollback mypool/var/tmp@diff_snapshot\n" +"# ls /var/tmp\n" +"passwd passwd.copy vi.recover\n" + +#. type: Plain text +#: documentation/content/en/books/handbook/zfs/_index.adoc:2579 +msgid "" +"The rollback operation restored the dataset to the state of the last " +"snapshot. Rolling back to a snapshot taken much earlier with other " +"snapshots taken afterwards is also possible. When trying to do this, ZFS " +"will issue this warning:" +msgstr "" +"Операция отката восстановила набор данных до состояния последнего снимка. " +"Также возможен откат к более раннему снимку, если после него были созданы " +"другие снимки. При попытке выполнить это действие ZFS выдаст следующее " +"предупреждение:" + +#. type: delimited block . 4 +#: documentation/content/en/books/handbook/zfs/_index.adoc:2592 +#, no-wrap +msgid "" +"# zfs list -rt snapshot mypool/var/tmp\n" +"NAME USED AVAIL REFER MOUNTPOINT\n" +"mypool/var/tmp@my_recursive_snapshot 88K - 152K -\n" +"mypool/var/tmp@after_cp 53.5K - 118K -\n" +"mypool/var/tmp@diff_snapshot 0 - 120K -\n" +"# zfs rollback mypool/var/tmp@my_recursive_snapshot\n" +"cannot rollback to 'mypool/var/tmp@my_recursive_snapshot': more recent snapshots exist\n" +"use '-r' to force deletion of the following snapshots:\n" +"mypool/var/tmp@after_cp\n" +"mypool/var/tmp@diff_snapshot\n" +msgstr "" +"# zfs list -rt snapshot mypool/var/tmp\n" +"NAME USED AVAIL REFER MOUNTPOINT\n" +"mypool/var/tmp@my_recursive_snapshot 88K - 152K -\n" +"mypool/var/tmp@after_cp 53.5K - 118K -\n" +"mypool/var/tmp@diff_snapshot 0 - 120K -\n" +"# zfs rollback mypool/var/tmp@my_recursive_snapshot\n" +"cannot rollback to 'mypool/var/tmp@my_recursive_snapshot': more recent " +"snapshots exist\n" +"use '-r' to force deletion of the following snapshots:\n" +"mypool/var/tmp@after_cp\n" +"mypool/var/tmp@diff_snapshot\n" + +#. type: Plain text +#: documentation/content/en/books/handbook/zfs/_index.adoc:2599 +msgid "" +"This warning means that snapshots exist between the current state of the " +"dataset and the snapshot to which the user wants to roll back. To complete " +"the rollback delete these snapshots. ZFS cannot track all the changes " +"between different states of the dataset, because snapshots are read-only. " +"ZFS will not delete the affected snapshots unless the user specifies `-r` to " +"confirm that this is the desired action. If that is the intention, and " +"understanding the consequences of losing all intermediate snapshots, issue " +"the command:" +msgstr "" +"Это предупреждение означает, что между текущим состоянием набора данных и " +"снимком, к которому пользователь хочет выполнить откат, существуют другие " +"снимки. Для завершения отката удалите эти снимки. ZFS не может отслеживать " +"все изменения между различными состояниями набора данных, поскольку снимки " +"доступны только для чтения. ZFS не удалит затронутые снимки, если " +"пользователь явно не укажет параметр `-r`, подтверждая, что это желаемое " +"действие. Если это действительно требуется, и вы осознаёте последствия " +"потери всех промежуточных снимков, выполните команду:" + +#. type: delimited block . 4 +#: documentation/content/en/books/handbook/zfs/_index.adoc:2608 +#, no-wrap +msgid "" +"# zfs rollback -r mypool/var/tmp@my_recursive_snapshot\n" +"# zfs list -rt snapshot mypool/var/tmp\n" +"NAME USED AVAIL REFER MOUNTPOINT\n" +"mypool/var/tmp@my_recursive_snapshot 8K - 152K -\n" +"# ls /var/tmp\n" +"vi.recover\n" +msgstr "" +"# zfs rollback -r mypool/var/tmp@my_recursive_snapshot\n" +"# zfs list -rt snapshot mypool/var/tmp\n" +"NAME USED AVAIL REFER MOUNTPOINT\n" +"mypool/var/tmp@my_recursive_snapshot 8K - 152K -\n" +"# ls /var/tmp\n" +"vi.recover\n" + +#. type: Plain text +#: documentation/content/en/books/handbook/zfs/_index.adoc:2611 +msgid "" +"The output from `zfs list -t snapshot` confirms the removal of the " +"intermediate snapshots as a result of `zfs rollback -r`." +msgstr "" +"Вывод команды `zfs list -t snapshot` подтверждает удаление промежуточных " +"снимков в результате выполнения `zfs rollback -r`." + +#. type: Title ==== +#: documentation/content/en/books/handbook/zfs/_index.adoc:2613 +#, no-wrap +msgid "Restoring Individual Files from Snapshots" +msgstr "Восстановление отдельных файлов из снимков" + +#. type: Plain text +#: documentation/content/en/books/handbook/zfs/_index.adoc:2620 +msgid "" +"Snapshots live in a hidden directory under the parent dataset: [.filename]#." +"zfs/snapshot/snapshotname#. By default, these directories will not show " +"even when executing a standard `ls -a` . Although the directory doesn't " +"show, access it like any normal directory. The property named `snapdir` " +"controls whether these hidden directories show up in a directory listing. " +"Setting the property to `visible` allows them to appear in the output of " +"`ls` and other commands that deal with directory contents." +msgstr "" +"Снимки хранятся в скрытом каталоге родительского набора данных: [.filename]#." +"zfs/snapshot/имя_снимка#. По умолчанию эти каталоги не отображаются даже при " +"выполнении стандартной команды `ls -a`. Несмотря на то, что каталог не " +"виден, доступ к нему осуществляется как к обычному каталогу. Свойство " +"`snapdir` определяет, будут ли эти скрытые каталоги отображаться в списке " +"содержимого каталога. Установка свойства в значение `visible` позволяет им " +"появляться в выводе команды `ls` и других команд, работающих с содержимым " +"каталогов." + +#. type: delimited block . 4 +#: documentation/content/en/books/handbook/zfs/_index.adoc:2631 +#, no-wrap +msgid "" +"# zfs get snapdir mypool/var/tmp\n" +"NAME PROPERTY VALUE SOURCE\n" +"mypool/var/tmp snapdir hidden default\n" +"# ls -a /var/tmp\n" +". .. passwd vi.recover\n" +"# zfs set snapdir=visible mypool/var/tmp\n" +"# ls -a /var/tmp\n" +". .. .zfs passwd vi.recover\n" +msgstr "" +"# zfs get snapdir mypool/var/tmp\n" +"NAME PROPERTY VALUE SOURCE\n" +"mypool/var/tmp snapdir hidden default\n" +"# ls -a /var/tmp\n" +". .. passwd vi.recover\n" +"# zfs set snapdir=visible mypool/var/tmp\n" +"# ls -a /var/tmp\n" +". .. .zfs passwd vi.recover\n" + +#. type: Plain text +#: documentation/content/en/books/handbook/zfs/_index.adoc:2636 +msgid "" +"Restore individual files to a previous state by copying them from the " +"snapshot back to the parent dataset. The directory structure below [." +"filename]#.zfs/snapshot# has a directory named like the snapshots taken " +"earlier to make it easier to identify them. The next example shows how to " +"restore a file from the hidden [.filename]#.zfs# directory by copying it " +"from the snapshot containing the latest version of the file:" +msgstr "" +"Восстановите отдельные файлы в предыдущее состояние, скопировав их из снимка " +"обратно в родительский набор данных. Структура каталогов в [.filename]#.zfs/" +"snapshot# содержит каталоги с именами, соответствующими ранее созданным " +"снимкам, что упрощает их идентификацию. В следующем примере показано, как " +"восстановить файл из скрытого каталога [.filename]#.zfs#, скопировав его из " +"снимка, содержащего последнюю версию файла:" + +#. type: delimited block . 4 +#: documentation/content/en/books/handbook/zfs/_index.adoc:2647 +#, no-wrap +msgid "" +"# rm /var/tmp/passwd\n" +"# ls -a /var/tmp\n" +". .. .zfs vi.recover\n" +"# ls /var/tmp/.zfs/snapshot\n" +"after_cp my_recursive_snapshot\n" +"# ls /var/tmp/.zfs/snapshot/after_cp\n" +"passwd vi.recover\n" +"# cp /var/tmp/.zfs/snapshot/after_cp/passwd /var/tmp\n" +msgstr "" +"# rm /var/tmp/passwd\n" +"# ls -a /var/tmp\n" +". .. .zfs vi.recover\n" +"# ls /var/tmp/.zfs/snapshot\n" +"after_cp my_recursive_snapshot\n" +"# ls /var/tmp/.zfs/snapshot/after_cp\n" +"passwd vi.recover\n" +"# cp /var/tmp/.zfs/snapshot/after_cp/passwd /var/tmp\n" + +#. type: Plain text +#: documentation/content/en/books/handbook/zfs/_index.adoc:2654 +msgid "" +"Even if the `snapdir` property is set to hidden, running `ls .zfs/snapshot` " +"will still list the contents of that directory. The administrator decides " +"whether to display these directories. This is a per-dataset setting. " +"Copying files or directories from this hidden [.filename]#.zfs/snapshot# is " +"simple enough. Trying it the other way around results in this error:" +msgstr "" +"Даже если свойство `snapdir` установлено в hidden, выполнение команды `ls ." +"zfs/snapshot` всё равно покажет содержимое этого каталога. Администратор " +"решает, отображать ли эти каталоги. Это настройка для каждого набора данных. " +"Копирование файлов или каталогов из скрытого [.filename]#.zfs/snapshot# " +"достаточно просто. Попытка сделать наоборот приведёт к такой ошибке:" + +#. type: delimited block . 4 +#: documentation/content/en/books/handbook/zfs/_index.adoc:2659 +#, no-wrap +msgid "" +"# cp /etc/rc.conf /var/tmp/.zfs/snapshot/after_cp/\n" +"cp: /var/tmp/.zfs/snapshot/after_cp/rc.conf: Read-only file system\n" +msgstr "" +"# cp /etc/rc.conf /var/tmp/.zfs/snapshot/after_cp/\n" +"cp: /var/tmp/.zfs/snapshot/after_cp/rc.conf: Read-only file system\n" + +#. type: Plain text +#: documentation/content/en/books/handbook/zfs/_index.adoc:2663 +msgid "" +"The error reminds the user that snapshots are read-only and cannot change " +"after creation. Copying files into and removing them from snapshot " +"directories are both disallowed because that would change the state of the " +"dataset they represent." +msgstr "" +"Ошибка напоминает пользователю, что снимки доступны только для чтения и не " +"могут изменяться после создания. Копирование файлов в каталоги снимков и их " +"удаление оттуда запрещены, так как это изменило бы состояние набора данных, " +"который они представляют." + +#. type: Plain text +#: documentation/content/en/books/handbook/zfs/_index.adoc:2666 +msgid "" +"Snapshots consume space based on how much the parent file system has changed " +"since the time of the snapshot. The `used` property of a snapshot tracks " +"the space the snapshot uses; its `written` property shows how much data was " +"written between the previous snapshot and this one." +msgstr "" +"Снимки занимают место в зависимости от того, насколько родительская файловая " +"система изменилась с момента создания снимка. Свойство `used` снимка " +"отслеживает используемое им пространство. Его свойство `written` показывает, " +"какой объём данных был записан на диск между предыдущим и текущим снимком." + +#. type: Plain text +#: documentation/content/en/books/handbook/zfs/_index.adoc:2670 +msgid "" +"To destroy snapshots and reclaim the space, use `zfs destroy " +"_dataset_@_snapshot_`. Adding `-r` recursively removes all snapshots with " +"the same name under the parent dataset. Adding `-n -v` to the command " +"displays a list of the snapshots to be deleted and an estimate of the space " +"it would reclaim without performing the actual destroy operation." +msgstr "" +"Для удаления снимков и освобождения пространства используйте `zfs destroy " +"_набор_данных_@_снимок_`. Добавление `-r` рекурсивно удаляет все снимки с " +"таким же именем в родительском наборе данных. Добавление `-n -v` к команде " +"выводит список снимков, которые будут удалены, и оценку освобождаемого " +"пространства без фактического выполнения операции удаления." + +#. type: Title ==== +#: documentation/content/en/books/handbook/zfs/_index.adoc:2672 +#, no-wrap +msgid "Snapshot Holds" +msgstr "Удержания снимков" + +#. type: Plain text +#: documentation/content/en/books/handbook/zfs/_index.adoc:2679 +msgid "" +"A crossref:zfs[zfs-term-hold,hold] places a user-defined tag on a snapshot " +"and prevents its destruction. Attempts to destroy a held snapshot with `zfs " +"destroy` fail with `EBUSY`. A snapshot can carry any number of holds, each " +"identified by a unique tag name. Holds protect snapshots that other " +"processes still depend on, such as the most recent snapshot shared by both " +"sides of a replication chain (see crossref:zfs[zfs-zfs-send,Replication]). " +"Destroying that common snapshot by accident forces the next replication to " +"start over with a full stream." +msgstr "" +"Удержание (hold, crossref:zfs[zfs-term-hold,hold]) помечает снимок " +"пользовательским тегом и предотвращает его уничтожение. Попытки уничтожить " +"удерживаемый снимок с помощью `zfs destroy` завершаются ошибкой `EBUSY`. " +"Снимок может иметь любое количество удержаний, каждое из которых " +"идентифицируется уникальным именем тега. Удержания защищают снимки, которые " +"всё ещё используются другими процессами, например, самый последний снимок, " +"общий для обеих сторон цепочки репликации (см. crossref:zfs[zfs-zfs-" +"send,Репликация]). Случайное уничтожение этого общего снимка приводит к " +"тому, что следующая репликация должна будет начинаться с полного потока (" +"full stream)." + +#. type: Plain text +#: documentation/content/en/books/handbook/zfs/_index.adoc:2682 +msgid "" +"Place a hold with `zfs hold _tag_ _snapshot_`. Adding `-r` also holds the " +"snapshots with the same name on all child datasets." +msgstr "" +"Установите удержание с помощью `zfs hold _tag_ _snapshot_`. Добавление `-r` " +"также устанавливает удержания на снимки с тем же именем во всех дочерних " +"наборах данных." + +#. type: delimited block . 4 +#: documentation/content/en/books/handbook/zfs/_index.adoc:2688 +#, no-wrap +msgid "" +"# zfs hold keepme mypool/var/tmp@my_recursive_snapshot\n" +"# zfs destroy mypool/var/tmp@my_recursive_snapshot\n" +"cannot destroy snapshot mypool/var/tmp@my_recursive_snapshot: dataset is busy\n" +msgstr "" +"# zfs hold keepme mypool/var/tmp@my_recursive_snapshot\n" +"# zfs destroy mypool/var/tmp@my_recursive_snapshot\n" +"cannot destroy snapshot mypool/var/tmp@my_recursive_snapshot: dataset is " +"busy\n" + +#. type: Plain text +#: documentation/content/en/books/handbook/zfs/_index.adoc:2691 +msgid "" +"`zfs holds` lists the holds on a snapshot, showing the tag name and the time " +"of placing each hold:" +msgstr "" +"`zfs holds` выводит список удержаний на снимке, показывая имя тега и время " +"установки каждого удержания:" + +#. type: delimited block . 4 +#: documentation/content/en/books/handbook/zfs/_index.adoc:2697 +#, no-wrap +msgid "" +"# zfs holds mypool/var/tmp@my_recursive_snapshot\n" +"NAME TAG TIMESTAMP\n" +"mypool/var/tmp@my_recursive_snapshot keepme Sat Jul 11 09:41 2026\n" +msgstr "" +"# zfs holds mypool/var/tmp@my_recursive_snapshot\n" +"NAME TAG TIMESTAMP\n" +"mypool/var/tmp@my_recursive_snapshot keepme Sat Jul 11 09:41 2026\n" + +#. type: Plain text +#: documentation/content/en/books/handbook/zfs/_index.adoc:2701 +msgid "" +"Remove a hold with `zfs release`. Destroying the snapshot becomes possible " +"again once the last hold on it is released:" +msgstr "" +"Снимите удержание с помощью `zfs release`. Уничтожение снимка снова " +"становится возможным, как только снимается последнее удержание на нём:" + +#. type: delimited block . 4 +#: documentation/content/en/books/handbook/zfs/_index.adoc:2706 +#, no-wrap +msgid "" +"# zfs release keepme mypool/var/tmp@my_recursive_snapshot\n" +"# zfs destroy mypool/var/tmp@my_recursive_snapshot\n" +msgstr "" +"# zfs release keepme mypool/var/tmp@my_recursive_snapshot\n" +"# zfs destroy mypool/var/tmp@my_recursive_snapshot\n" + +#. type: Plain text +#: documentation/content/en/books/handbook/zfs/_index.adoc:2709 +msgid "See man:zfs-hold[8] for more information." +msgstr "См. man:zfs-hold[8] для получения дополнительной информации." + +#. type: Title === +#: documentation/content/en/books/handbook/zfs/_index.adoc:2711 +#, no-wrap +msgid "Bookmarks" +msgstr "Закладки" + +#. type: Plain text +#: documentation/content/en/books/handbook/zfs/_index.adoc:2719 +msgid "" +"A crossref:zfs[zfs-term-bookmark,bookmark] records the point in time at " +"which a snapshot was created, without keeping any of the snapshot data. " +"Bookmarks consume almost no space, no matter how much the dataset changes " +"afterwards. Like a snapshot, a bookmark can serve as the source of an " +"incremental `zfs send`. Unlike a snapshot, it does not prevent ZFS from " +"freeing the old data. This combination makes bookmarks useful for " +"incremental replication: after sending a snapshot to another pool, bookmark " +"it and destroy it on the sending side, reclaiming the space while the " +"receiving side keeps its copy of the snapshot. See crossref:zfs[zfs-send-" +"incremental,Incremental Backups] for the replication workflow itself." +msgstr "" +"Перекрестная ссылка: zfs[zfs-term-bookmark,закладка] фиксирует момент " +"времени, в который был создан снимок, без сохранения каких-либо данных " +"снимка. Закладки почти не занимают места на диске, независимо от того, " +"насколько изменится набор данных впоследствии. Как и снимок, закладка может " +"служить источником инкрементальных данных для `zfs send`. В отличие от " +"снимка, она не препятствует ZFS освобождать старые данные. Такое сочетание " +"делает закладки полезными для инкрементальной репликации: после отправки " +"снимка на другой пул создайте закладку на нем и уничтожьте его на " +"отправляющей стороне, освобождая место, в то время как принимающая сторона " +"сохраняет свою копию снимка. Смотрите раздел crossref:zfs[zfs-send-" +"incremental,Инкрементальные резервные копии] для описания самого процесса " +"репликации." + +#. type: Plain text +#: documentation/content/en/books/handbook/zfs/_index.adoc:2722 +msgid "" +"Create a bookmark from a snapshot with `zfs bookmark`. Bookmark names use " +"`#` as the separator between the dataset name and the bookmark name, in the " +"same way snapshot names use `@`." +msgstr "" +"Создайте закладку из снимка с помощью `zfs bookmark`. В именах закладок в " +"качестве разделителя между именем набора данных и именем закладки " +"используется `#`, так же как в именах снимков используется `@`." + +#. type: delimited block . 4 +#: documentation/content/en/books/handbook/zfs/_index.adoc:2729 +#, no-wrap +msgid "" +"# zfs snapshot mypool/data@snap1\n" +"# zfs send mypool/data@snap1 | zfs receive backup/data\n" +"# zfs bookmark mypool/data@snap1 mypool/data#snap1bm\n" +"# zfs destroy mypool/data@snap1\n" +msgstr "" +"# zfs snapshot mypool/data@snap1\n" +"# zfs send mypool/data@snap1 | zfs receive backup/data\n" +"# zfs bookmark mypool/data@snap1 mypool/data#snap1bm\n" +"# zfs destroy mypool/data@snap1\n" + +#. type: Plain text +#: documentation/content/en/books/handbook/zfs/_index.adoc:2732 +msgid "List bookmarks with `zfs list -t bookmark`:" +msgstr "Перечислите закладки с помощью `zfs list -t bookmark`:" + +#. type: delimited block . 4 +#: documentation/content/en/books/handbook/zfs/_index.adoc:2738 +#, no-wrap +msgid "" +"# zfs list -t bookmark mypool/data\n" +"NAME USED AVAIL REFER MOUNTPOINT\n" +"mypool/data#snap1bm - - 184K -\n" +msgstr "" +"# zfs list -t bookmark mypool/data\n" +"NAME USED AVAIL REFER MOUNTPOINT\n" +"mypool/data#snap1bm - - 184K -\n" + +#. type: Plain text +#: documentation/content/en/books/handbook/zfs/_index.adoc:2741 +msgid "" +"When the time comes for the next incremental backup, take a new snapshot and " +"use the bookmark as the incremental source:" +msgstr "" +"Когда наступает время для следующего инкрементального резервного " +"копирования, создайте новый снимок и используйте закладку в качестве " +"инкрементального источника:" + +#. type: delimited block . 4 +#: documentation/content/en/books/handbook/zfs/_index.adoc:2746 +#, no-wrap +msgid "" +"# zfs snapshot mypool/data@snap2\n" +"# zfs send -i mypool/data#snap1bm mypool/data@snap2 | zfs receive backup/data\n" +msgstr "" +"# zfs snapshot mypool/data@snap2\n" +"# zfs send -i mypool/data#snap1bm mypool/data@snap2 | zfs receive backup/" +"data\n" + +#. type: Plain text +#: documentation/content/en/books/handbook/zfs/_index.adoc:2752 +msgid "" +"This works because the receiving pool still has the snapshot _backup/" +"data@snap1_ matching the bookmark. Bookmarks serve as incremental sources " +"only. Mounting a bookmark, rolling back to it, or restoring files from it " +"is impossible, as it contains no data. See man:zfs-bookmark[8] for more " +"information." +msgstr "" +"Это работает, поскольку принимающий пул всё ещё имеет снапшот _backup/data@" +"snap1_, соответствующий закладке. Закладки служат только в качестве " +"источников для инкрементального резервирования. Смонтировать закладку, " +"выполнить откат к ней или восстановить файлы из неё невозможно, так как она " +"не содержит данных. Дополнительную информацию см. в man:zfs-bookmark[8]." + +#. type: Title === +#: documentation/content/en/books/handbook/zfs/_index.adoc:2754 +#, no-wrap +msgid "Managing Clones" +msgstr "Управление клонами" + +#. type: Plain text +#: documentation/content/en/books/handbook/zfs/_index.adoc:2763 +msgid "" +"A clone is a copy of a snapshot treated more like a regular dataset. Unlike " +"a snapshot, a clone is writeable and mountable, and has its own properties. " +"After creating a clone using `zfs clone`, destroying the originating " +"snapshot is impossible. To reverse the child/parent relationship between " +"the clone and the snapshot use `zfs promote`. Promoting a clone makes the " +"snapshot become a child of the clone, rather than of the original parent " +"dataset. This will change how ZFS accounts for the space, but not actually " +"change the amount of space consumed. Mounting the clone anywhere within the " +"ZFS file system hierarchy is possible, not only below the original location " +"of the snapshot." +msgstr "" +"Клон — это копия снимка, которая рассматривается как обычный набор данных. В " +"отличие от снимка, клон доступен для записи, может быть смонтирован и имеет " +"свои собственные свойства. После создания клона с помощью команды `zfs " +"clone` уничтожение исходного снимка становится невозможным. Чтобы изменить " +"отношение «родитель-потомок» между клоном и снимком, используйте команду " +"`zfs promote`. Продвижение клона делает снимок потомком клона, а не " +"исходного родительского набора данных. Это изменит способ учёта пространства " +"в ZFS, но не повлияет на фактически используемый объём. Клон можно " +"смонтировать в любом месте иерархии файловой системы ZFS, а не только ниже " +"исходного расположения снимка." + +#. type: Plain text +#: documentation/content/en/books/handbook/zfs/_index.adoc:2765 +msgid "To show the clone feature use this example dataset:" +msgstr "" +"Чтобы продемонстрировать функцию клонирования, используйте следующий набора " +"данных в качестве примера:" + +#. type: delimited block . 4 +#: documentation/content/en/books/handbook/zfs/_index.adoc:2773 +#, no-wrap +msgid "" +"# zfs list -rt all camino/home/joe\n" +"NAME USED AVAIL REFER MOUNTPOINT\n" +"camino/home/joe 108K 1.3G 87K /usr/home/joe\n" +"camino/home/joe@plans 21K - 85.5K -\n" +"camino/home/joe@backup 0K - 87K -\n" +msgstr "" +"# zfs list -rt all camino/home/joe\n" +"NAME USED AVAIL REFER MOUNTPOINT\n" +"camino/home/joe 108K 1.3G 87K /usr/home/joe\n" +"camino/home/joe@plans 21K - 85.5K -\n" +"camino/home/joe@backup 0K - 87K -\n" + +#. type: Plain text +#: documentation/content/en/books/handbook/zfs/_index.adoc:2779 +msgid "" +"A typical use for clones is to experiment with a specific dataset while " +"keeping the snapshot around to fall back to in case something goes wrong. " +"Since snapshots cannot change, create a read/write clone of a snapshot. " +"After achieving the desired result in the clone, promote the clone to a " +"dataset and remove the old file system. Removing the parent dataset is not " +"strictly necessary, as the clone and dataset can coexist without problems." +msgstr "" +"Типичное применение клонов — эксперименты с определённым набором данных, при " +"этом снимок остаётся в качестве резервной копии на случай возникновения " +"проблем. Поскольку снимки нельзя изменить, создаётся доступный для чтения и " +"записи клон снимка. После достижения нужного результата в клоне, клон " +"повышается до набора данных, а старая файловая система удаляется. Удаление " +"родительского набора данных не является обязательным, так как клон и набор " +"данных могут без проблем сосуществовать." + +#. type: delimited block . 4 +#: documentation/content/en/books/handbook/zfs/_index.adoc:2786 +#, no-wrap +msgid "" +"# zfs clone camino/home/joe@backup camino/home/joenew\n" +"# ls /usr/home/joe*\n" +"/usr/home/joe:\n" +"backup.txz plans.txt\n" +msgstr "" +"# zfs clone camino/home/joe@backup camino/home/joenew\n" +"# ls /usr/home/joe*\n" +"/usr/home/joe:\n" +"backup.txz plans.txt\n" + +#. type: delimited block . 4 +#: documentation/content/en/books/handbook/zfs/_index.adoc:2793 +#, no-wrap +msgid "" +"/usr/home/joenew:\n" +"backup.txz plans.txt\n" +"# df -h /usr/home\n" +"Filesystem Size Used Avail Capacity Mounted on\n" +"usr/home/joe 1.3G 31k 1.3G 0% /usr/home/joe\n" +"usr/home/joenew 1.3G 31k 1.3G 0% /usr/home/joenew\n" +msgstr "" +"/usr/home/joenew:\n" +"backup.txz plans.txt\n" +"# df -h /usr/home\n" +"Filesystem Size Used Avail Capacity Mounted on\n" +"usr/home/joe 1.3G 31k 1.3G 0% /usr/home/joe\n" +"usr/home/joenew 1.3G 31k 1.3G 0% /usr/home/joenew\n" + +#. type: Plain text +#: documentation/content/en/books/handbook/zfs/_index.adoc:2802 +msgid "" +"Creating a clone makes it an exact copy of the state the dataset was in when " +"taking the snapshot. Changing the clone independently from its originating " +"dataset is possible now. The connection between the two is the snapshot. " +"ZFS records this connection in the property `origin`. Promoting the clone " +"with `zfs promote` makes the clone an independent dataset. This removes the " +"value of the `origin` property and disconnects the newly independent dataset " +"from the snapshot. This example shows it:" +msgstr "" +"Создание клона делает его точной копией состояния набора данных на момент " +"создания снимка. Теперь можно изменять клон независимо от исходного набора " +"данных. Связь между ними осуществляется через снимок. ZFS записывает эту " +"связь в свойстве `origin`. Повышение клона с помощью `zfs promote` делает " +"клон независимым набором данных. Это удаляет значение свойства `origin` и " +"отключает новый независимый набор данных от снимка. Вот пример:" + +#. type: delimited block . 4 +#: documentation/content/en/books/handbook/zfs/_index.adoc:2812 +#, no-wrap +msgid "" +"# zfs get origin camino/home/joenew\n" +"NAME PROPERTY VALUE SOURCE\n" +"camino/home/joenew origin camino/home/joe@backup -\n" +"# zfs promote camino/home/joenew\n" +"# zfs get origin camino/home/joenew\n" +"NAME PROPERTY VALUE SOURCE\n" +"camino/home/joenew origin - -\n" +msgstr "" +"# zfs get origin camino/home/joenew\n" +"NAME PROPERTY VALUE SOURCE\n" +"camino/home/joenew origin camino/home/joe@backup -\n" +"# zfs promote camino/home/joenew\n" +"# zfs get origin camino/home/joenew\n" +"NAME PROPERTY VALUE SOURCE\n" +"camino/home/joenew origin - -\n" + +#. type: Plain text +#: documentation/content/en/books/handbook/zfs/_index.adoc:2817 +msgid "" +"After making some changes like copying [.filename]#loader.conf# to the " +"promoted clone, for example, the old directory becomes obsolete in this " +"case. Instead, the promoted clone can replace it. To do this, `zfs " +"destroy` the old dataset first and then `zfs rename` the clone to the old " +"dataset name (or to an entirely different name)." +msgstr "" +"После внесения изменений, таких как копирование [.filename]#loader.conf# в " +"продвинутую клон-копию, например, старый каталог в этом случае становится " +"устаревшим. Вместо него продвинутая клон-копия может его заменить. Для этого " +"сначала выполните `zfs destroy` для старого набора данных, а затем `zfs " +"rename` для клона, указав имя старого набора данных (или совершенно другое " +"имя)." + +#. type: delimited block . 4 +#: documentation/content/en/books/handbook/zfs/_index.adoc:2828 +#, no-wrap +msgid "" +"# cp /boot/defaults/loader.conf /usr/home/joenew\n" +"# zfs destroy -f camino/home/joe\n" +"# zfs rename camino/home/joenew camino/home/joe\n" +"# ls /usr/home/joe\n" +"backup.txz loader.conf plans.txt\n" +"# df -h /usr/home\n" +"Filesystem Size Used Avail Capacity Mounted on\n" +"usr/home/joe 1.3G 128k 1.3G 0% /usr/home/joe\n" +msgstr "" +"# cp /boot/defaults/loader.conf /usr/home/joenew\n" +"# zfs destroy -f camino/home/joe\n" +"# zfs rename camino/home/joenew camino/home/joe\n" +"# ls /usr/home/joe\n" +"backup.txz loader.conf plans.txt\n" +"# df -h /usr/home\n" +"Filesystem Size Used Avail Capacity Mounted on\n" +"usr/home/joe 1.3G 128k 1.3G 0% /usr/home/joe\n" #. type: Plain text -#: documentation/content/en/books/handbook/zfs/_index.adoc:1501 +#: documentation/content/en/books/handbook/zfs/_index.adoc:2837 msgid "" -"Create a new dataset and enable crossref:zfs[zfs-term-compression-lz4,LZ4 " -"compression] on it:" +"The cloned snapshot is now an ordinary dataset. It contains all the data " +"from the original snapshot plus the files added to it like [." +"filename]#loader.conf#. Clones provide useful features to ZFS users in " +"different scenarios. For example, provide jails as snapshots containing " +"different sets of installed applications. Users can clone these snapshots " +"and add their own applications as they see fit. Once satisfied with the " +"changes, promote the clones to full datasets and provide them to end users " +"to work with like they would with a real dataset. This saves time and " +"administrative overhead when providing these jails." msgstr "" -"Создайте новый набор данных и включите для него crossref:zfs[zfs-term-" -"compression-lz4,сжатие LZ4]:" +"Клонированный снимок теперь является обычным набором данных. Он содержит все " +"данные из исходного снимка, а также добавленные файлы, такие как [." +"filename]#loader.conf#. Клоны предоставляют полезные возможности " +"пользователям ZFS в различных сценариях. Например, можно предоставлять " +"клетки в виде снимков с различными наборами установленных приложений. " +"Пользователи могут клонировать эти снимки и добавлять свои собственные " +"приложения по своему усмотрению. После внесения необходимых изменений клоны " +"можно повысить до полноценных наборов данных и предоставить их конечным " +"пользователям для работы, как с обычными наборами данных. Это экономит время " +"и снижает административные затраты при предоставлении таких клеток." + +#. type: Title === +#: documentation/content/en/books/handbook/zfs/_index.adoc:2839 +#, no-wrap +msgid "Block Cloning" +msgstr "Блочное клонирование" + +#. type: Plain text +#: documentation/content/en/books/handbook/zfs/_index.adoc:2845 +msgid "" +"crossref:zfs[zfs-term-block-cloning,Block cloning] brings copy-on-write to " +"individual file copies. When enabled, copying a file with man:cp[1] does " +"not duplicate the file data. Instead, the new file refers to the same " +"blocks as the original, and ZFS writes new blocks only when either file " +"changes afterwards. man:cp[1] performs copies with man:copy_file_range[2], " +"which ZFS turns into block clone operations, making copies within a pool " +"almost instantaneous and consuming no additional space at first." +msgstr "" +"crossref:zfs[zfs-term-block-cloning,Блочное клонирование] обеспечивает " +"копирование при записи для отдельных копий файлов. При его включении " +"копирование файла с помощью man:cp[1] не дублирует данные файла. Вместо " +"этого новый файл ссылается на те же блоки, что и оригинал, и ZFS записывает " +"новые блоки только тогда, когда впоследствии изменяется один из файлов. " +"man:cp[1] выполняет копирование с помощью man:copy_file_range[2], которое " +"ZFS превращает в операции блочного клонирования, делая копии внутри пула " +"практически мгновенными и изначально не потребляющими дополнительное " +"пространство." + +#. type: Plain text +#: documentation/content/en/books/handbook/zfs/_index.adoc:2849 +msgid "" +"Unlike crossref:zfs[zfs-zfs-deduplication,deduplication], block cloning " +"keeps no memory-hungry table of checksums. Sharing happens at the moment of " +"the copy only, and writing identical data in separate operations still " +"stores it twice. Unlike crossref:zfs[zfs-zfs-clones,clones], block cloning " +"requires no snapshot, works on individual files rather than whole datasets, " +"and leaves no `origin` relationship behind." +msgstr "" +"В отличие от crossref:zfs[zfs-zfs-deduplication,дедупликация], блочное " +"клонирование не поддерживает требующую много памяти таблицу контрольных " +"сумм. Совместное использование происходит только в момент копирования, и " +"запись одинаковых данных отдельными операциями по-прежнему сохраняет их " +"дважды. В отличие от crossref:zfs[zfs-zfs-clones,клонов], блочное " +"клонирование не требует снимка, работает с отдельными файлами, а не с целыми " +"наборами данных, и не оставляет отношения `origin` после себя." + +#. type: Plain text +#: documentation/content/en/books/handbook/zfs/_index.adoc:2855 +msgid "" +"Block cloning requires the `block_cloning` pool feature from OpenZFS 2.2, " +"first shipped in FreeBSD 14.0 (see man:zpool-features[7]). The man:" +"sysctl[8] `vfs.zfs.bclone_enabled` controls whether ZFS actually creates " +"block clones. It defaults to 0 on FreeBSD 14.x and to 1 on FreeBSD 15.0. " +"While the sysctl is 0, `copy_file_range()` falls back to an ordinary copy. " +"To enable block cloning on FreeBSD 14.x:" +msgstr "" +"Блочное клонирование требует возможности пула `block_cloning` из OpenZFS " +"2.2, впервые выпущенной в FreeBSD 14.0 (см. man:zpool-features[7]). " +"Управляющая системная переменная man:sysctl[8] `vfs.zfs.bclone_enabled` " +"определяет, создаёт ли ZFS блочные клоны на самом деле. По умолчанию она " +"равна 0 в FreeBSD 14.x и 1 в FreeBSD 15.0. Пока sysctl равен 0, " +"`copy_file_range()` возвращается к обычному копированию. Чтобы включить " +"блочное клонирование в FreeBSD 14.x:" #. type: delimited block . 4 -#: documentation/content/en/books/handbook/zfs/_index.adoc:1536 +#: documentation/content/en/books/handbook/zfs/_index.adoc:2860 #, no-wrap msgid "" -"# zfs list\n" -"NAME USED AVAIL REFER MOUNTPOINT\n" -"mypool 781M 93.2G 144K none\n" -"mypool/ROOT 777M 93.2G 144K none\n" -"mypool/ROOT/default 777M 93.2G 777M /\n" -"mypool/tmp 176K 93.2G 176K /tmp\n" -"mypool/usr 616K 93.2G 144K /usr\n" -"mypool/usr/home 184K 93.2G 184K /usr/home\n" -"mypool/usr/ports 144K 93.2G 144K /usr/ports\n" -"mypool/usr/src 144K 93.2G 144K /usr/src\n" -"mypool/var 1.20M 93.2G 608K /var\n" -"mypool/var/crash 148K 93.2G 148K /var/crash\n" -"mypool/var/log 178K 93.2G 178K /var/log\n" -"mypool/var/mail 144K 93.2G 144K /var/mail\n" -"mypool/var/tmp 152K 93.2G 152K /var/tmp\n" -"# zfs create -o compress=lz4 mypool/usr/mydataset\n" -"# zfs list\n" -"NAME USED AVAIL REFER MOUNTPOINT\n" -"mypool 781M 93.2G 144K none\n" -"mypool/ROOT 777M 93.2G 144K none\n" -"mypool/ROOT/default 777M 93.2G 777M /\n" -"mypool/tmp 176K 93.2G 176K /tmp\n" -"mypool/usr 704K 93.2G 144K /usr\n" -"mypool/usr/home 184K 93.2G 184K /usr/home\n" -"mypool/usr/mydataset 87.5K 93.2G 87.5K /usr/mydataset\n" -"mypool/usr/ports 144K 93.2G 144K /usr/ports\n" -"mypool/usr/src 144K 93.2G 144K /usr/src\n" -"mypool/var 1.20M 93.2G 610K /var\n" -"mypool/var/crash 148K 93.2G 148K /var/crash\n" -"mypool/var/log 178K 93.2G 178K /var/log\n" -"mypool/var/mail 144K 93.2G 144K /var/mail\n" -"mypool/var/tmp 152K 93.2G 152K /var/tmp\n" +"# sysctl vfs.zfs.bclone_enabled=1\n" +"vfs.zfs.bclone_enabled: 0 -> 1\n" msgstr "" -"# zfs list\n" -"NAME USED AVAIL REFER MOUNTPOINT\n" -"mypool 781M 93.2G 144K none\n" -"mypool/ROOT 777M 93.2G 144K none\n" -"mypool/ROOT/default 777M 93.2G 777M /\n" -"mypool/tmp 176K 93.2G 176K /tmp\n" -"mypool/usr 616K 93.2G 144K /usr\n" -"mypool/usr/home 184K 93.2G 184K /usr/home\n" -"mypool/usr/ports 144K 93.2G 144K /usr/ports\n" -"mypool/usr/src 144K 93.2G 144K /usr/src\n" -"mypool/var 1.20M 93.2G 608K /var\n" -"mypool/var/crash 148K 93.2G 148K /var/crash\n" -"mypool/var/log 178K 93.2G 178K /var/log\n" -"mypool/var/mail 144K 93.2G 144K /var/mail\n" -"mypool/var/tmp 152K 93.2G 152K /var/tmp\n" -"# zfs create -o compress=lz4 mypool/usr/mydataset\n" -"# zfs list\n" -"NAME USED AVAIL REFER MOUNTPOINT\n" -"mypool 781M 93.2G 144K none\n" -"mypool/ROOT 777M 93.2G 144K none\n" -"mypool/ROOT/default 777M 93.2G 777M /\n" -"mypool/tmp 176K 93.2G 176K /tmp\n" -"mypool/usr 704K 93.2G 144K /usr\n" -"mypool/usr/home 184K 93.2G 184K /usr/home\n" -"mypool/usr/mydataset 87.5K 93.2G 87.5K /usr/mydataset\n" -"mypool/usr/ports 144K 93.2G 144K /usr/ports\n" -"mypool/usr/src 144K 93.2G 144K /usr/src\n" -"mypool/var 1.20M 93.2G 610K /var\n" -"mypool/var/crash 148K 93.2G 148K /var/crash\n" -"mypool/var/log 178K 93.2G 178K /var/log\n" -"mypool/var/mail 144K 93.2G 144K /var/mail\n" -"mypool/var/tmp 152K 93.2G 152K /var/tmp\n" +"# sysctl vfs.zfs.bclone_enabled=1\n" +"vfs.zfs.bclone_enabled: 0 -> 1\n" + +#. type: Plain text +#: documentation/content/en/books/handbook/zfs/_index.adoc:2863 +msgid "" +"To keep the setting across reboots, add this line to [.filename]#/etc/sysctl." +"conf#:" +msgstr "" +"Чтобы сохранить эту настройку после перезагрузок, добавьте следующую строку " +"в [.filename]#/etc/sysctl.conf#:" + +#. type: delimited block . 4 +#: documentation/content/en/books/handbook/zfs/_index.adoc:2867 +#, no-wrap +msgid "vfs.zfs.bclone_enabled=1\n" +msgstr "vfs.zfs.bclone_enabled=1\n" + +#. type: Plain text +#: documentation/content/en/books/handbook/zfs/_index.adoc:2870 +msgid "" +"The pool properties `bcloneused`, `bclonesaved`, and `bcloneratio` show the " +"space used by cloned blocks, the space saved by cloning, and the resulting " +"savings ratio:" +msgstr "" +"Свойства пула `bcloneused`, `bclonesaved` и `bcloneratio` показывают " +"пространство, используемое клонированными блоками, пространство, " +"сэкономленное за счёт клонирования, и результирующий коэффициент экономии:" + +#. type: delimited block . 4 +#: documentation/content/en/books/handbook/zfs/_index.adoc:2877 +#, no-wrap +msgid "" +"# cp /var/tmp/database.dump /var/tmp/database.copy\n" +"# zpool list -o name,bcloneused,bclonesaved,bcloneratio mypool\n" +"NAME BCLONE_USED BCLONE_SAVED BCLONE_RATIO\n" +"mypool 1.7G 1.7G 2.00x\n" +msgstr "" +"# cp /var/tmp/database.dump /var/tmp/database.copy\n" +"# zpool list -o name,bcloneused,bclonesaved,bcloneratio mypool\n" +"NAME BCLONE_USED BCLONE_SAVED BCLONE_RATIO\n" +"mypool 1.7G 1.7G 2.00x\n" + +#. type: Title === +#: documentation/content/en/books/handbook/zfs/_index.adoc:2880 +#, no-wrap +msgid "Replication" +msgstr "Репликация" + +#. type: Plain text +#: documentation/content/en/books/handbook/zfs/_index.adoc:2889 +msgid "" +"Keeping data on a single pool in one location exposes it to risks like theft " +"and natural or human disasters. Making regular backups of the entire pool " +"is vital. ZFS provides a built-in serialization feature that can send a " +"stream representation of the data to standard output. Using this feature, " +"storing this data on another pool connected to the local system is possible, " +"as is sending it over a network to another system. Snapshots are the basis " +"for this replication (see the section on crossref:zfs[zfs-zfs-snapshot,ZFS " +"snapshots]). The commands used for replicating data are `zfs send` and `zfs " +"receive`." +msgstr "" +"Хранение данных в единственном пуле в одном месте подвергает их рискам, " +"таким как кража, стихийные бедствия или действия людей. Регулярное резервное " +"копирование всего пула крайне важно. ZFS предоставляет встроенную функцию " +"сериализации, которая может отправлять потоковое представление данных на " +"стандартный вывод. Используя эту функцию, можно сохранять эти данные в " +"другом пуле, подключённом к локальной системе, или отправлять их по сети на " +"другую систему. Снимки являются основой для этой репликации (см. раздел о " +"crossref:zfs[zfs-zfs-snapshot,снимках ZFS]). Команды, используемые для " +"репликации данных, — это `zfs send` и `zfs receive`." + +#. type: Plain text +#: documentation/content/en/books/handbook/zfs/_index.adoc:2891 +msgid "These examples show ZFS replication with these two pools:" +msgstr "" +"Эти примеры демонстрируют репликацию ZFS с использованием следующих двух " +"пулов:" + +#. type: delimited block . 4 +#: documentation/content/en/books/handbook/zfs/_index.adoc:2898 +#, no-wrap +msgid "" +"# zpool list\n" +"NAME SIZE ALLOC FREE CKPOINT EXPANDSZ FRAG CAP DEDUP HEALTH ALTROOT\n" +"backup 960M 77K 896M - - 0% 0% 1.00x ONLINE -\n" +"mypool 984M 43.7M 940M - - 0% 4% 1.00x ONLINE -\n" +msgstr "" +"# zpool list\n" +"NAME SIZE ALLOC FREE CKPOINT EXPANDSZ FRAG CAP DEDUP HEALTH ALTROOT\n" +"backup 960M 77K 896M - - 0% 0% 1.00x ONLINE -\n" +"mypool 984M 43.7M 940M - - 0% 4% 1.00x ONLINE -\n" + +#. type: Plain text +#: documentation/content/en/books/handbook/zfs/_index.adoc:2906 +msgid "" +"The pool named _mypool_ is the primary pool where writing and reading data " +"happens on a regular basis. Using a second standby pool _backup_ in case " +"the primary pool becomes unavailable. Note that this fail-over is not done " +"automatically by ZFS, but must be manually done by a system administrator " +"when needed. Use a snapshot to provide a consistent file system version to " +"replicate. After creating a snapshot of _mypool_, copy it to the _backup_ " +"pool by replicating snapshots. This does not include changes made since the " +"most recent snapshot." +msgstr "" +"Имя пула _mypool_ — это основной пул, в который данные регулярно " +"записываются и откуда они читаются. Используйте второй резервный пул " +"_backup_ на случай, если основной пул станет недоступен. Обратите внимание, " +"что этот переход на резервный пул не выполняется автоматически в ZFS, а " +"должен быть осуществлён вручную системным администратором при необходимости. " +"Используйте снимок (snapshot), чтобы обеспечить согласованную версию " +"файловой системы для репликации. После создания снимка _mypool_ скопируйте " +"его в пул _backup_ путём репликации снимков. Это не включает изменения, " +"сделанные после последнего снимка." + +#. type: delimited block . 4 +#: documentation/content/en/books/handbook/zfs/_index.adoc:2913 +#, no-wrap +msgid "" +"# zfs snapshot mypool@backup1\n" +"# zfs list -t snapshot\n" +"NAME USED AVAIL REFER MOUNTPOINT\n" +"mypool@backup1 0 - 43.6M -\n" +msgstr "" +"# zfs snapshot mypool@backup1\n" +"# zfs list -t snapshot\n" +"NAME USED AVAIL REFER MOUNTPOINT\n" +"mypool@backup1 0 - 43.6M -\n" #. type: Plain text -#: documentation/content/en/books/handbook/zfs/_index.adoc:1539 +#: documentation/content/en/books/handbook/zfs/_index.adoc:2918 msgid "" -"Destroying a dataset is much quicker than deleting the files on the dataset, " -"as it does not involve scanning the files and updating the corresponding " -"metadata." +"Now that a snapshot exists, use `zfs send` to create a stream representing " +"the contents of the snapshot. Store this stream as a file or receive it on " +"another pool. Write the stream to standard output, but redirect to a file " +"or pipe or an error appears:" msgstr "" -"Уничтожение набора данных выполняется гораздо быстрее, чем удаление файлов в " -"наборе данных, так как не требует сканирования файлов и обновления " -"соответствующих метаданных." +"Теперь, когда снимок существует, используйте `zfs send` для создания потока, " +"представляющего содержимое снимка. Сохраните этот поток в файл или примите " +"его в другом пуле. Поток записывается в стандартный вывод, но перенаправьте " +"его в файл или канал, иначе появится ошибка:" + +#. type: delimited block . 4 +#: documentation/content/en/books/handbook/zfs/_index.adoc:2924 +#, no-wrap +msgid "" +"# zfs send mypool@backup1\n" +"Error: Stream can not be written to a terminal.\n" +"You must redirect standard output.\n" +msgstr "" +"# zfs send mypool@backup1\n" +"Error: Stream can not be written to a terminal.\n" +"You must redirect standard output.\n" #. type: Plain text -#: documentation/content/en/books/handbook/zfs/_index.adoc:1541 -msgid "Destroy the created dataset:" -msgstr "Уничтожьте созданный набор данных:" +#: documentation/content/en/books/handbook/zfs/_index.adoc:2928 +msgid "" +"To back up a dataset with `zfs send`, redirect to a file located on the " +"mounted backup pool. Ensure that the pool has enough free space to " +"accommodate the size of the sent snapshot, which means the data contained in " +"the snapshot, not the changes from the previous snapshot." +msgstr "" +"Для резервного копирования набора данных с помощью `zfs send` перенаправьте " +"вывод в файл, расположенный в подключённом пуле резервных копий. Убедитесь, " +"что в пуле достаточно свободного места для размещения отправленного снимка, " +"то есть для данных, содержащихся в снимке, а не для изменений по сравнению с " +"предыдущим снимком." #. type: delimited block . 4 -#: documentation/content/en/books/handbook/zfs/_index.adoc:1576 +#: documentation/content/en/books/handbook/zfs/_index.adoc:2936 #, no-wrap msgid "" -"# zfs list\n" -"NAME USED AVAIL REFER MOUNTPOINT\n" -"mypool 880M 93.1G 144K none\n" -"mypool/ROOT 777M 93.1G 144K none\n" -"mypool/ROOT/default 777M 93.1G 777M /\n" -"mypool/tmp 176K 93.1G 176K /tmp\n" -"mypool/usr 101M 93.1G 144K /usr\n" -"mypool/usr/home 184K 93.1G 184K /usr/home\n" -"mypool/usr/mydataset 100M 93.1G 100M /usr/mydataset\n" -"mypool/usr/ports 144K 93.1G 144K /usr/ports\n" -"mypool/usr/src 144K 93.1G 144K /usr/src\n" -"mypool/var 1.20M 93.1G 610K /var\n" -"mypool/var/crash 148K 93.1G 148K /var/crash\n" -"mypool/var/log 178K 93.1G 178K /var/log\n" -"mypool/var/mail 144K 93.1G 144K /var/mail\n" -"mypool/var/tmp 152K 93.1G 152K /var/tmp\n" -"# zfs destroy mypool/usr/mydataset\n" -"# zfs list\n" -"NAME USED AVAIL REFER MOUNTPOINT\n" -"mypool 781M 93.2G 144K none\n" -"mypool/ROOT 777M 93.2G 144K none\n" -"mypool/ROOT/default 777M 93.2G 777M /\n" -"mypool/tmp 176K 93.2G 176K /tmp\n" -"mypool/usr 616K 93.2G 144K /usr\n" -"mypool/usr/home 184K 93.2G 184K /usr/home\n" -"mypool/usr/ports 144K 93.2G 144K /usr/ports\n" -"mypool/usr/src 144K 93.2G 144K /usr/src\n" -"mypool/var 1.21M 93.2G 612K /var\n" -"mypool/var/crash 148K 93.2G 148K /var/crash\n" -"mypool/var/log 178K 93.2G 178K /var/log\n" -"mypool/var/mail 144K 93.2G 144K /var/mail\n" -"mypool/var/tmp 152K 93.2G 152K /var/tmp\n" +"# zfs send mypool@backup1 > /backup/backup1\n" +"# zpool list\n" +"NAME SIZE ALLOC FREE CKPOINT EXPANDSZ FRAG CAP DEDUP HEALTH ALTROOT\n" +"backup 960M 63.7M 896M - - 0% 6% 1.00x ONLINE -\n" +"mypool 984M 43.7M 940M - - 0% 4% 1.00x ONLINE -\n" msgstr "" -"# zfs list\n" -"NAME USED AVAIL REFER MOUNTPOINT\n" -"mypool 880M 93.1G 144K none\n" -"mypool/ROOT 777M 93.1G 144K none\n" -"mypool/ROOT/default 777M 93.1G 777M /\n" -"mypool/tmp 176K 93.1G 176K /tmp\n" -"mypool/usr 101M 93.1G 144K /usr\n" -"mypool/usr/home 184K 93.1G 184K /usr/home\n" -"mypool/usr/mydataset 100M 93.1G 100M /usr/mydataset\n" -"mypool/usr/ports 144K 93.1G 144K /usr/ports\n" -"mypool/usr/src 144K 93.1G 144K /usr/src\n" -"mypool/var 1.20M 93.1G 610K /var\n" -"mypool/var/crash 148K 93.1G 148K /var/crash\n" -"mypool/var/log 178K 93.1G 178K /var/log\n" -"mypool/var/mail 144K 93.1G 144K /var/mail\n" -"mypool/var/tmp 152K 93.1G 152K /var/tmp\n" -"# zfs destroy mypool/usr/mydataset\n" -"# zfs list\n" -"NAME USED AVAIL REFER MOUNTPOINT\n" -"mypool 781M 93.2G 144K none\n" -"mypool/ROOT 777M 93.2G 144K none\n" -"mypool/ROOT/default 777M 93.2G 777M /\n" -"mypool/tmp 176K 93.2G 176K /tmp\n" -"mypool/usr 616K 93.2G 144K /usr\n" -"mypool/usr/home 184K 93.2G 184K /usr/home\n" -"mypool/usr/ports 144K 93.2G 144K /usr/ports\n" -"mypool/usr/src 144K 93.2G 144K /usr/src\n" -"mypool/var 1.21M 93.2G 612K /var\n" -"mypool/var/crash 148K 93.2G 148K /var/crash\n" -"mypool/var/log 178K 93.2G 178K /var/log\n" -"mypool/var/mail 144K 93.2G 144K /var/mail\n" -"mypool/var/tmp 152K 93.2G 152K /var/tmp\n" +"# zfs send mypool@backup1 > /backup/backup1\n" +"# zpool list\n" +"NAME SIZE ALLOC FREE CKPOINT EXPANDSZ FRAG CAP DEDUP HEALTH ALTROOT\n" +"backup 960M 63.7M 896M - - 0% 6% 1.00x ONLINE -\n" +"mypool 984M 43.7M 940M - - 0% 4% 1.00x ONLINE -\n" #. type: Plain text -#: documentation/content/en/books/handbook/zfs/_index.adoc:1584 +#: documentation/content/en/books/handbook/zfs/_index.adoc:2940 msgid "" -"In modern versions of ZFS, `zfs destroy` is asynchronous, and the free space " -"might take minutes to appear in the pool. Use `zpool get freeing " -"_poolname_` to see the `freeing` property, that shows which datasets are " -"having their blocks freed in the background. If there are child datasets, " -"like crossref:zfs[zfs-term-snapshot,snapshots] or other datasets, destroying " -"the parent is impossible. To destroy a dataset and its children, use `-r` " -"to recursively destroy the dataset and its children. Use `-n -v` to list " -"datasets and snapshots destroyed by this operation, without actually destroy " -"anything. Space reclaimed by destroying snapshots is also shown." +"The `zfs send` transferred all the data in the snapshot called _backup1_ to " +"the pool named _backup_. To create and send these snapshots automatically, " +"use a man:cron[8] job." msgstr "" -"В современных версиях ZFS команда `zfs destroy` выполняется асинхронно, и " -"освобождённое пространство может появиться в пуле только через несколько " -"минут. Используйте `zpool get freeing _имяпула_` для просмотра свойства " -"`freeing`, которое показывает, какие наборы данных освобождают свои блоки в " -"фоновом режиме. Если существуют дочерние наборы данных, например crossref:" -"zfs[zfs-term-snapshot,снимки] или другие наборы данных, уничтожение " -"родительского набора невозможно. Для удаления набора данных и его дочерних " -"элементов используйте `-r`, чтобы рекурсивно удалить набор данных и его " -"потомков. Опция `-n -v` позволяет вывести список наборов данных и снимков, " -"которые будут удалены данной операцией, без фактического выполнения " -"удаления. Также отображается пространство, которое будет освобождено после " -"удаления снимков." +"Команда `zfs send` передала все данные из снимка _backup1_ в пул _backup_. " +"Для автоматического создания и отправки таких снимков используйте задание " +"man:cron[8]." -#. type: Title === -#: documentation/content/en/books/handbook/zfs/_index.adoc:1586 +#. type: Plain text +#: documentation/content/en/books/handbook/zfs/_index.adoc:2946 +msgid "" +"Instead of storing the backups as archive files, ZFS can receive them as a " +"live file system, allowing direct access to the backed up data. To get to " +"the actual data contained in those streams, use `zfs receive` to transform " +"the streams back into files and directories. The example below combines " +"`zfs send` and `zfs receive` using a pipe to copy the data from one pool to " +"another. Use the data directly on the receiving pool after the transfer is " +"complete. It is only possible to replicate a dataset to an empty dataset." +msgstr "" +"Вместо хранения резервных копий в виде архивных файлов ZFS может получать их " +"как активную файловую систему, обеспечивая прямой доступ к резервным данным. " +"Для доступа к фактическим данным, содержащимся в этих потоках, используйте " +"`zfs receive`, чтобы преобразовать потоки обратно в файлы и каталоги. В " +"приведённом ниже примере объединяются `zfs send` и `zfs receive` с " +"использованием конвейера для копирования данных из одного пула в другой. " +"После завершения передачи данные можно использовать напрямую в целевом пуле. " +"Реплицировать набор данных можно только в пустой набор данных." + +#. type: delimited block . 4 +#: documentation/content/en/books/handbook/zfs/_index.adoc:2956 #, no-wrap -msgid "Creating and Destroying Volumes" -msgstr "Создание и удаление томов" +msgid "" +"# zfs snapshot mypool@replica1\n" +"# zfs send -v mypool@replica1 | zfs receive backup/mypool\n" +"full send of mypool@replica1 estimated size is 50.1M\n" +"total estimated size is 50.1M\n" +"TIME SENT SNAPSHOT mypool@replica1\n" +"10:22:01 9.75M mypool@replica1\n" +"10:22:02 25.4M mypool@replica1\n" +msgstr "" +"# zfs snapshot mypool@replica1\n" +"# zfs send -v mypool@replica1 | zfs receive backup/mypool\n" +"full send of mypool@replica1 estimated size is 50.1M\n" +"total estimated size is 50.1M\n" +"TIME SENT SNAPSHOT mypool@replica1\n" +"10:22:01 9.75M mypool@replica1\n" +"10:22:02 25.4M mypool@replica1\n" -#. type: Plain text -#: documentation/content/en/books/handbook/zfs/_index.adoc:1591 +#. type: delimited block . 4 +#: documentation/content/en/books/handbook/zfs/_index.adoc:2961 +#, no-wrap msgid "" -"A volume is a special dataset type. Rather than mounting as a file system, " -"expose it as a block device under [.filename]#/dev/zvol/poolname/dataset#. " -"This allows using the volume for other file systems, to back the disks of a " -"virtual machine, or to make it available to other network hosts using " -"protocols like iSCSI or HAST." +"# zpool list\n" +"NAME SIZE ALLOC FREE CKPOINT EXPANDSZ FRAG CAP DEDUP HEALTH ALTROOT\n" +"backup 960M 63.7M 896M - - 0% 6% 1.00x ONLINE -\n" +"mypool 984M 43.7M 940M - - 0% 4% 1.00x ONLINE -\n" msgstr "" -"Том — это особый тип набора данных. Вместо монтирования в качестве файловой " -"системы он представляется как блочное устройство в [.filename]#/dev/zvol/" -"имя_пула/набор_данных#. Это позволяет использовать том для других файловых " -"систем, в качестве дисков для виртуальной машины или сделать его доступным " -"для других сетевых узлов с использованием таких протоколов, как iSCSI или " -"HAST." +"# zpool list\n" +"NAME SIZE ALLOC FREE CKPOINT EXPANDSZ FRAG CAP DEDUP HEALTH ALTROOT\n" +"backup 960M 63.7M 896M - - 0% 6% 1.00x ONLINE -\n" +"mypool 984M 43.7M 940M - - 0% 4% 1.00x ONLINE -\n" + +#. type: Title ==== +#: documentation/content/en/books/handbook/zfs/_index.adoc:2964 +#, no-wrap +msgid "Incremental Backups" +msgstr "Инкрементные резервные копии" #. type: Plain text -#: documentation/content/en/books/handbook/zfs/_index.adoc:1596 +#: documentation/content/en/books/handbook/zfs/_index.adoc:2969 msgid "" -"Format a volume with any file system or without a file system to store raw " -"data. To the user, a volume appears to be a regular disk. Putting ordinary " -"file systems on these _zvols_ provides features that ordinary disks or file " -"systems do not have. For example, using the compression property on a 250 " -"MB volume allows creation of a compressed FAT file system." +"`zfs send` can also determine the difference between two snapshots and send " +"individual differences between the two. This saves disk space and transfer " +"time. For example:" msgstr "" -"Отформатируйте том с любой файловой системой или без файловой системы для " -"хранения сырых данных. Для пользователя том выглядит как обычный диск. " -"Размещение обычных файловых систем на этих _zvols_ предоставляет " -"возможности, которых нет у обычных дисков или файловых систем. Например, " -"использование свойства сжатия на томе объёмом 250 МБ позволяет создать " -"сжатую файловую систему FAT." +"`zfs send` также может определить разницу между двумя снимками и отправить " +"отдельные различия между ними. Это экономит место на диске и время передачи. " +"Например:" #. type: delimited block . 4 -#: documentation/content/en/books/handbook/zfs/_index.adoc:1610 +#: documentation/content/en/books/handbook/zfs/_index.adoc:2981 #, no-wrap msgid "" -"# zfs create -V 250m -o compression=on tank/fat32\n" -"# zfs list tank\n" -"NAME USED AVAIL REFER MOUNTPOINT\n" -"tank 258M 670M 31K /tank\n" -"# newfs_msdos -F32 /dev/zvol/tank/fat32\n" -"# mount -t msdosfs /dev/zvol/tank/fat32 /mnt\n" -"# df -h /mnt | grep fat32\n" -"Filesystem Size Used Avail Capacity Mounted on\n" -"/dev/zvol/tank/fat32 249M 24k 249M 0% /mnt\n" -"# mount | grep fat32\n" -"/dev/zvol/tank/fat32 on /mnt (msdosfs, local)\n" +"# zfs snapshot mypool@replica2\n" +"# zfs list -t snapshot\n" +"NAME USED AVAIL REFER MOUNTPOINT\n" +"mypool@replica1 5.72M - 43.6M -\n" +"mypool@replica2 0 - 44.1M -\n" +"# zpool list\n" +"NAME SIZE ALLOC FREE CKPOINT EXPANDSZ FRAG CAP DEDUP HEALTH ALTROOT\n" +"backup 960M 61.7M 898M - - 0% 6% 1.00x ONLINE -\n" +"mypool 960M 50.2M 910M - - 0% 5% 1.00x ONLINE -\n" msgstr "" -"# zfs create -V 250m -o compression=on tank/fat32\n" -"# zfs list tank\n" -"NAME USED AVAIL REFER MOUNTPOINT\n" -"tank 258M 670M 31K /tank\n" -"# newfs_msdos -F32 /dev/zvol/tank/fat32\n" -"# mount -t msdosfs /dev/zvol/tank/fat32 /mnt\n" -"# df -h /mnt | grep fat32\n" -"Filesystem Size Used Avail Capacity Mounted on\n" -"/dev/zvol/tank/fat32 249M 24k 249M 0% /mnt\n" -"# mount | grep fat32\n" -"/dev/zvol/tank/fat32 on /mnt (msdosfs, local)\n" +"# zfs snapshot mypool@replica2\n" +"# zfs list -t snapshot\n" +"NAME USED AVAIL REFER MOUNTPOINT\n" +"mypool@replica1 5.72M - 43.6M -\n" +"mypool@replica2 0 - 44.1M -\n" +"# zpool list\n" +"NAME SIZE ALLOC FREE CKPOINT EXPANDSZ FRAG CAP DEDUP HEALTH ALTROOT\n" +"backup 960M 61.7M 898M - - 0% 6% 1.00x ONLINE -\n" +"mypool 960M 50.2M 910M - - 0% 5% 1.00x ONLINE -\n" #. type: Plain text -#: documentation/content/en/books/handbook/zfs/_index.adoc:1614 +#: documentation/content/en/books/handbook/zfs/_index.adoc:2987 msgid "" -"Destroying a volume is much the same as destroying a regular file system " -"dataset. The operation is nearly instantaneous, but it may take minutes to " -"reclaim the free space in the background." +"Create a second snapshot called _replica2_. This second snapshot contains " +"changes made to the file system between now and the previous snapshot, " +"_replica1_. Using `zfs send -i` and indicating the pair of snapshots " +"generates an incremental replica stream containing the changed data. This " +"succeeds if the initial snapshot already exists on the receiving side." msgstr "" -"Уничтожение тома во многом аналогично уничтожению обычного набора данных " -"файловой системы. Операция выполняется почти мгновенно, но освобождение " -"места может занять несколько минут и происходит в фоновом режиме." +"Создайте второй снимок с именем _replica2_. Этот второй снимок содержит " +"изменения, внесённые в файловую систему в период между текущим моментом и " +"предыдущим снимком _replica1_. Использование `zfs send -i` с указанием пары " +"снимков создаёт инкрементальный поток репликации, содержащий изменённые " +"данные. Это выполняется успешно, если исходный снимок уже существует на " +"принимающей стороне." -#. type: Title === -#: documentation/content/en/books/handbook/zfs/_index.adoc:1616 +#. type: delimited block . 4 +#: documentation/content/en/books/handbook/zfs/_index.adoc:2994 #, no-wrap -msgid "Renaming a Dataset" -msgstr "Переименование набора данных" - -#. type: Plain text -#: documentation/content/en/books/handbook/zfs/_index.adoc:1623 msgid "" -"To change the name of a dataset, use `zfs rename`. To change the parent of " -"a dataset, use this command as well. Renaming a dataset to have a different " -"parent dataset will change the value of those properties inherited from the " -"parent dataset. Renaming a dataset unmounts then remounts it in the new " -"location (inherited from the new parent dataset). To prevent this behavior, " -"use `-u`." +"# zfs send -v -i mypool@replica1 mypool@replica2 | zfs receive backup/mypool\n" +"send from @replica1 to mypool@replica2 estimated size is 5.02M\n" +"total estimated size is 5.02M\n" +"TIME SENT SNAPSHOT mypool@replica2\n" msgstr "" -"Для изменения имени набора данных используйте `zfs rename`. Эту же команду " -"можно использовать для изменения родительского набора данных. Переименование " -"набора данных с изменением родительского набора приведёт к изменению " -"значений свойств, унаследованных от родительского набора данных. " -"Переименование набора данных размонтирует, а затем снова смонтирует его в " -"новом месте (с учётом наследования от нового родительского набора данных). " -"Чтобы предотвратить это поведение, используйте опцию `-u`." +"# zfs send -v -i mypool@replica1 mypool@replica2 | zfs receive backup/" +"mypool\n" +"send from @replica1 to mypool@replica2 estimated size is 5.02M\n" +"total estimated size is 5.02M\n" +"TIME SENT SNAPSHOT mypool@replica2\n" -#. type: Plain text -#: documentation/content/en/books/handbook/zfs/_index.adoc:1625 -msgid "Rename a dataset and move it to be under a different parent dataset:" +#. type: delimited block . 4 +#: documentation/content/en/books/handbook/zfs/_index.adoc:2999 +#, no-wrap +msgid "" +"# zpool list\n" +"NAME SIZE ALLOC FREE CKPOINT EXPANDSZ FRAG CAP DEDUP HEALTH ALTROOT\n" +"backup 960M 80.8M 879M - - 0% 8% 1.00x ONLINE -\n" +"mypool 960M 50.2M 910M - - 0% 5% 1.00x ONLINE -\n" msgstr "" -"Переименовать набор данных и переместить его под другой родительский набор " -"данных:" +"# zpool list\n" +"NAME SIZE ALLOC FREE CKPOINT EXPANDSZ FRAG CAP DEDUP HEALTH ALTROOT\n" +"backup 960M 80.8M 879M - - 0% 8% 1.00x ONLINE -\n" +"mypool 960M 50.2M 910M - - 0% 5% 1.00x ONLINE -\n" #. type: delimited block . 4 -#: documentation/content/en/books/handbook/zfs/_index.adoc:1661 +#: documentation/content/en/books/handbook/zfs/_index.adoc:3005 #, no-wrap msgid "" "# zfs list\n" -"NAME USED AVAIL REFER MOUNTPOINT\n" -"mypool 780M 93.2G 144K none\n" -"mypool/ROOT 777M 93.2G 144K none\n" -"mypool/ROOT/default 777M 93.2G 777M /\n" -"mypool/tmp 176K 93.2G 176K /tmp\n" -"mypool/usr 704K 93.2G 144K /usr\n" -"mypool/usr/home 184K 93.2G 184K /usr/home\n" -"mypool/usr/mydataset 87.5K 93.2G 87.5K /usr/mydataset\n" -"mypool/usr/ports 144K 93.2G 144K /usr/ports\n" -"mypool/usr/src 144K 93.2G 144K /usr/src\n" -"mypool/var 1.21M 93.2G 614K /var\n" -"mypool/var/crash 148K 93.2G 148K /var/crash\n" -"mypool/var/log 178K 93.2G 178K /var/log\n" -"mypool/var/mail 144K 93.2G 144K /var/mail\n" -"mypool/var/tmp 152K 93.2G 152K /var/tmp\n" -"# zfs rename mypool/usr/mydataset mypool/var/newname\n" -"# zfs list\n" -"NAME USED AVAIL REFER MOUNTPOINT\n" -"mypool 780M 93.2G 144K none\n" -"mypool/ROOT 777M 93.2G 144K none\n" -"mypool/ROOT/default 777M 93.2G 777M /\n" -"mypool/tmp 176K 93.2G 176K /tmp\n" -"mypool/usr 616K 93.2G 144K /usr\n" -"mypool/usr/home 184K 93.2G 184K /usr/home\n" -"mypool/usr/ports 144K 93.2G 144K /usr/ports\n" -"mypool/usr/src 144K 93.2G 144K /usr/src\n" -"mypool/var 1.29M 93.2G 614K /var\n" -"mypool/var/crash 148K 93.2G 148K /var/crash\n" -"mypool/var/log 178K 93.2G 178K /var/log\n" -"mypool/var/mail 144K 93.2G 144K /var/mail\n" -"mypool/var/newname 87.5K 93.2G 87.5K /var/newname\n" -"mypool/var/tmp 152K 93.2G 152K /var/tmp\n" +"NAME USED AVAIL REFER MOUNTPOINT\n" +"backup 55.4M 240G 152K /backup\n" +"backup/mypool 55.3M 240G 55.2M /backup/mypool\n" +"mypool 55.6M 11.6G 55.0M /mypool\n" msgstr "" "# zfs list\n" -"NAME USED AVAIL REFER MOUNTPOINT\n" -"mypool 780M 93.2G 144K none\n" -"mypool/ROOT 777M 93.2G 144K none\n" -"mypool/ROOT/default 777M 93.2G 777M /\n" -"mypool/tmp 176K 93.2G 176K /tmp\n" -"mypool/usr 704K 93.2G 144K /usr\n" -"mypool/usr/home 184K 93.2G 184K /usr/home\n" -"mypool/usr/mydataset 87.5K 93.2G 87.5K /usr/mydataset\n" -"mypool/usr/ports 144K 93.2G 144K /usr/ports\n" -"mypool/usr/src 144K 93.2G 144K /usr/src\n" -"mypool/var 1.21M 93.2G 614K /var\n" -"mypool/var/crash 148K 93.2G 148K /var/crash\n" -"mypool/var/log 178K 93.2G 178K /var/log\n" -"mypool/var/mail 144K 93.2G 144K /var/mail\n" -"mypool/var/tmp 152K 93.2G 152K /var/tmp\n" -"# zfs rename mypool/usr/mydataset mypool/var/newname\n" -"# zfs list\n" -"NAME USED AVAIL REFER MOUNTPOINT\n" -"mypool 780M 93.2G 144K none\n" -"mypool/ROOT 777M 93.2G 144K none\n" -"mypool/ROOT/default 777M 93.2G 777M /\n" -"mypool/tmp 176K 93.2G 176K /tmp\n" -"mypool/usr 616K 93.2G 144K /usr\n" -"mypool/usr/home 184K 93.2G 184K /usr/home\n" -"mypool/usr/ports 144K 93.2G 144K /usr/ports\n" -"mypool/usr/src 144K 93.2G 144K /usr/src\n" -"mypool/var 1.29M 93.2G 614K /var\n" -"mypool/var/crash 148K 93.2G 148K /var/crash\n" -"mypool/var/log 178K 93.2G 178K /var/log\n" -"mypool/var/mail 144K 93.2G 144K /var/mail\n" -"mypool/var/newname 87.5K 93.2G 87.5K /var/newname\n" -"mypool/var/tmp 152K 93.2G 152K /var/tmp\n" - -#. type: Plain text -#: documentation/content/en/books/handbook/zfs/_index.adoc:1666 -msgid "" -"Renaming snapshots uses the same command. Due to the nature of snapshots, " -"rename cannot change their parent dataset. To rename a recursive snapshot, " -"specify `-r`; this will also rename all snapshots with the same name in " -"child datasets." -msgstr "" -"Переименование снимков выполняется той же командой. Из-за особенностей " -"снимков, их переименование не может изменить родительский набор данных. Для " -"рекурсивного переименования снимка укажите `-r`; это также переименует все " -"снимки с таким же именем в дочерних наборах данных." +"NAME USED AVAIL REFER MOUNTPOINT\n" +"backup 55.4M 240G 152K /backup\n" +"backup/mypool 55.3M 240G 55.2M /backup/mypool\n" +"mypool 55.6M 11.6G 55.0M /mypool\n" #. type: delimited block . 4 -#: documentation/content/en/books/handbook/zfs/_index.adoc:1676 +#: documentation/content/en/books/handbook/zfs/_index.adoc:3012 #, no-wrap msgid "" "# zfs list -t snapshot\n" -"NAME USED AVAIL REFER MOUNTPOINT\n" -"mypool/var/newname@first_snapshot 0 - 87.5K -\n" -"# zfs rename mypool/var/newname@first_snapshot new_snapshot_name\n" -"# zfs list -t snapshot\n" -"NAME USED AVAIL REFER MOUNTPOINT\n" -"mypool/var/newname@new_snapshot_name 0 - 87.5K -\n" +"NAME USED AVAIL REFER MOUNTPOINT\n" +"backup/mypool@replica1 104K - 50.2M -\n" +"backup/mypool@replica2 0 - 55.2M -\n" +"mypool@replica1 29.9K - 50.0M -\n" +"mypool@replica2 0 - 55.0M -\n" msgstr "" "# zfs list -t snapshot\n" -"NAME USED AVAIL REFER MOUNTPOINT\n" -"mypool/var/newname@first_snapshot 0 - 87.5K -\n" -"# zfs rename mypool/var/newname@first_snapshot new_snapshot_name\n" -"# zfs list -t snapshot\n" -"NAME USED AVAIL REFER MOUNTPOINT\n" -"mypool/var/newname@new_snapshot_name 0 - 87.5K -\n" +"NAME USED AVAIL REFER MOUNTPOINT\n" +"backup/mypool@replica1 104K - 50.2M -\n" +"backup/mypool@replica2 0 - 55.2M -\n" +"mypool@replica1 29.9K - 50.0M -\n" +"mypool@replica2 0 - 55.0M -\n" -#. type: Title === -#: documentation/content/en/books/handbook/zfs/_index.adoc:1679 -#, no-wrap -msgid "Setting Dataset Properties" -msgstr "Установка свойств наборов данных" +#. type: Plain text +#: documentation/content/en/books/handbook/zfs/_index.adoc:3017 +msgid "" +"The incremental stream replicated the changed data rather than the entirety " +"of _replica1_. Sending the differences alone took much less time to " +"transfer and saved disk space by not copying the whole pool each time. This " +"is useful when replicating over a slow network or one charging per " +"transferred byte." +msgstr "" +"Инкрементный поток реплицировал изменённые данные вместо полной копии " +"_replica1_. Передача только различий заняла гораздо меньше времени и " +"сэкономила место на диске, избегая копирования всего пула каждый раз. Это " +"особенно полезно при репликации по медленной сети или при тарификации за " +"каждый переданный байт." #. type: Plain text -#: documentation/content/en/books/handbook/zfs/_index.adoc:1689 +#: documentation/content/en/books/handbook/zfs/_index.adoc:3023 msgid "" -"Each ZFS dataset has properties that control its behavior. Most properties " -"are automatically inherited from the parent dataset, but can be overridden " -"locally. Set a property on a dataset with `zfs set _property=value " -"dataset_`. Most properties have a limited set of valid values, `zfs get` " -"will display each possible property and valid values. Using `zfs inherit` " -"reverts most properties to their inherited values. User-defined properties " -"are also possible. They become part of the dataset configuration and " -"provide further information about the dataset or its contents. To " -"distinguish these custom properties from the ones supplied as part of ZFS, " -"use a colon (`:`) to create a custom namespace for the property." +"A new file system, _backup/mypool_, is available with the files and data " +"from the pool _mypool_. Specifying `-p` copies the dataset properties " +"including compression settings, quotas, and mount points. Specifying `-R` " +"copies all child datasets of the dataset along with their properties. " +"Automate sending and receiving to create regular backups on the second " +"pool. The crossref:zfs[zfs-send-options,Send Stream Options] section " +"describes these and other useful options in more detail." msgstr "" -"Каждый набор данных ZFS имеет свойства, которые определяют его поведение. " -"Большинство свойств автоматически наследуются от родительского набора " -"данных, но могут быть переопределены локально. Установите свойство для " -"набора данных с помощью `zfs set _свойство=значение набор_данных_`. " -"Большинство свойств имеют ограниченный набор допустимых значений, `zfs get` " -"отобразит каждое возможное свойство и допустимые значения. Использование " -"`zfs inherit` возвращает большинство свойств к их унаследованным значениям. " -"Также возможны пользовательские свойства. Они становятся частью конфигурации " -"набора данных и предоставляют дополнительную информацию о наборе данных или " -"его содержимом. Чтобы отличить эти пользовательские свойства от встроенных в " -"ZFS, используйте двоеточие (`:`), чтобы создать пользовательское " -"пространство имён для свойства." +"Доступна новая файловая система _backup/mypool_ с файлами и данными из пула " +"_mypool_. Указание `-p` копирует свойства наборов данных, включая настройки " +"сжатия, квоты и точки монтирования. Указание `-R` копирует все дочерние " +"наборы данных вместе с их свойствами. Автоматизируйте отправку и получение " +"для создания регулярных резервных копий во втором пуле. Раздел crossref:zfs" +"[zfs-send-options,«Параметры потока отправки»] более подробно описывает эти " +"и другие полезные параметры." -#. type: delimited block . 4 -#: documentation/content/en/books/handbook/zfs/_index.adoc:1696 +#. type: Title ==== +#: documentation/content/en/books/handbook/zfs/_index.adoc:3025 #, no-wrap +msgid "Send Stream Options" +msgstr "Параметры отправки потока" + +#. type: Plain text +#: documentation/content/en/books/handbook/zfs/_index.adoc:3032 msgid "" -"# zfs set custom:costcenter=1234 tank\n" -"# zfs get custom:costcenter tank\n" -"NAME PROPERTY VALUE SOURCE\n" -"tank custom:costcenter 1234 local\n" +"`zfs send` provides options that control what a stream includes and how " +"compact it is. Specifying `-p` includes the dataset properties, such as " +"compression settings, quotas, and mount points, in the stream. Specifying `-" +"R` generates a replication stream package, which includes the dataset, all " +"child datasets, snapshots, clones, and properties up to the named snapshot, " +"and implies `-p`. The example in crossref:zfs[zfs-send-ssh,Sending " +"Encrypted Backups over SSH] uses `-R` to replicate a complete dataset tree. " +"Specifying `-v` prints information about the generated stream, including a " +"per-second progress report." msgstr "" -"# zfs set custom:costcenter=1234 tank\n" -"# zfs get custom:costcenter tank\n" -"NAME PROPERTY VALUE SOURCE\n" -"tank custom:costcenter 1234 local\n" +"`zfs send` предоставляет параметры, которые управляют тем, что включает " +"поток и насколько он компактен. Указание `-p` включает свойства набора " +"данных, такие как настройки сжатия, квоты и точки монтирования, в поток. " +"Указание `-R` генерирует пакет репликационного потока, который включает " +"набор данных, все дочерние наборы данных, снимки, клоны и свойства вплоть до " +"именованного снимка, и подразумевает `-p`. Пример в crossref:zfs[zfs-send-" +"ssh,Отправка зашифрованных бекапов через SSH] использует `-R` для репликации " +"полного дерева набора данных. Указание `-v` выводит информацию о " +"сгенерированном потоке, включая отчет о ходе выполнения за секунду." + +#. type: Plain text +#: documentation/content/en/books/handbook/zfs/_index.adoc:3034 +msgid "Other options change the format of the data blocks in the stream:" +msgstr "Другие параметры изменяют формат блоков данных в потоке:" #. type: Plain text -#: documentation/content/en/books/handbook/zfs/_index.adoc:1700 +#: documentation/content/en/books/handbook/zfs/_index.adoc:3036 msgid "" -"To remove a custom property, use `zfs inherit` with `-r`. If the custom " -"property is not defined in any of the parent datasets, this option removes " -"it (but the pool's history still records the change)." +"`-L` permits blocks larger than 128 KB in the stream, preserving the on-disk " +"block size of datasets with a `recordsize` above 128 KB instead of splitting " +"those blocks." msgstr "" -"Чтобы удалить пользовательское свойство, используйте `zfs inherit` с " -"параметром `-r`. Если пользовательское свойство не определено ни в одном из " -"родительских наборов данных, эта опция удаляет его (но история пула всё " -"равно сохраняет запись об изменении)." +"`-L` разрешает блоки размером более 128 КБ в потоке, сохраняя размер блоков " +"на диске для наборов данных с `recordsize` выше 128 КБ вместо разделения " +"таких блоков." -#. type: delimited block . 4 -#: documentation/content/en/books/handbook/zfs/_index.adoc:1709 -#, no-wrap +#. type: Plain text +#: documentation/content/en/books/handbook/zfs/_index.adoc:3037 msgid "" -"# zfs inherit -r custom:costcenter tank\n" -"# zfs get custom:costcenter tank\n" -"NAME PROPERTY VALUE SOURCE\n" -"tank custom:costcenter - -\n" -"# zfs get all tank | grep custom:costcenter\n" -"#\n" +"`-e` generates a more compact stream by using `WRITE_EMBEDDED` records for " +"tiny blocks that the `embedded_data` pool feature stores directly in the " +"block pointer." msgstr "" -"# zfs inherit -r custom:costcenter tank\n" -"# zfs get custom:costcenter tank\n" -"NAME PROPERTY VALUE SOURCE\n" -"tank custom:costcenter - -\n" -"# zfs get all tank | grep custom:costcenter\n" -"#\n" +"`-e` создаёт более компактный поток, используя записи `WRITE_EMBEDDED` для " +"крошечных блоков, которые функция пула `embedded_data` хранит " +"непосредственно в указателе блока." + +#. type: Plain text +#: documentation/content/en/books/handbook/zfs/_index.adoc:3038 +msgid "" +"`-c` sends blocks that are compressed on disk in their compressed form " +"rather than decompressing them first, saving CPU time on both systems and " +"reducing the amount of data transferred for compressed datasets." +msgstr "" +"`-c` отправляет блоки, сжатые на диске, в их сжатом виде, а не распаковывает " +"их сначала, экономя время процессора на обеих системах и сокращая объем " +"передаваемых данных для сжатых наборов данных." + +#. type: Plain text +#: documentation/content/en/books/handbook/zfs/_index.adoc:3039 +msgid "" +"`-w` sends an encrypted dataset in raw form, exactly as stored on disk and " +"without loading its encryption key, as described in crossref:zfs[zfs-" +"encrypted-send,Sending Encrypted Datasets]. For unencrypted datasets, `-w` " +"is equivalent to `-Lec`." +msgstr "" +"`-w` отправляет зашифрованный набор данных в необработанном виде, точно так, " +"как он хранится на диске, и без загрузки его ключа шифрования, как описано в " +"разделе crossref:zfs[zfs-encrypted-send,Отправка зашифрованных наборов " +"данных]. Для незашифрованных наборов данных `-w` эквивалентно `-Lec`." + +#. type: Plain text +#: documentation/content/en/books/handbook/zfs/_index.adoc:3043 +msgid "" +"Combining these options as `zfs send -Lec` is a good default on modern " +"pools. The receiving pool must support every feature the stream uses, and " +"`zfs receive` rejects a stream that requires a feature the pool lacks. See " +"man:zfs-send[8] and man:zpool-features[7] for the full list of options and " +"the pool features they depend on." +msgstr "" +"Объединение этих параметров как `zfs send -Lec` является хорошим выбором по " +"умолчанию для современных пулов. Принимающий пул должен поддерживать все " +"возможности, которые использует поток, и `zfs receive` отклоняет поток, " +"требующий возможности, отсутствующей в пуле. Смотрите man:zfs-send[8] и man" +":zpool-features[7] для полного списка параметров и возможностей пула, от " +"которых они зависят." #. type: Title ==== -#: documentation/content/en/books/handbook/zfs/_index.adoc:1712 +#: documentation/content/en/books/handbook/zfs/_index.adoc:3045 #, no-wrap -msgid "Getting and Setting Share Properties" -msgstr "Получение и установка свойств общего доступа" +msgid "Resumable Transfers" +msgstr "Возобновляемые передачи" #. type: Plain text -#: documentation/content/en/books/handbook/zfs/_index.adoc:1718 +#: documentation/content/en/books/handbook/zfs/_index.adoc:3049 msgid "" -"Two commonly used and useful dataset properties are the NFS and SMB share " -"options. Setting these defines if and how ZFS shares datasets on the " -"network. At present, FreeBSD supports setting NFS sharing alone. To get " -"the current status of a share, enter:" +"A dropped network connection or a reboot during a large transfer normally " +"means starting over from the beginning. Using `zfs receive -s` keeps the " +"partially received state on the receiving dataset instead of deleting it " +"when the stream ends prematurely." msgstr "" -"Два часто используемых и полезных свойства наборов данных — это параметры " -"общих ресурсов NFS и SMB. Установка этих параметров определяет, будет ли ZFS " -"предоставлять наборы данных в сети и как именно. В настоящее время FreeBSD " -"поддерживает настройку только общего доступа NFS. Чтобы проверить текущее " -"состояние общего ресурса, введите:" +"Разорванное сетевое соединение или перезагрузка во время большой передачи " +"обычно означает, что нужно начинать заново. Использование `zfs receive -s` " +"сохраняет частично принятое состояние на принимающем наборе данных вместо " +"его удаления, когда поток завершается преждевременно." #. type: delimited block . 4 -#: documentation/content/en/books/handbook/zfs/_index.adoc:1727 +#: documentation/content/en/books/handbook/zfs/_index.adoc:3058 #, no-wrap msgid "" -"# zfs get sharenfs mypool/usr/home\n" -"NAME PROPERTY VALUE SOURCE\n" -"mypool/usr/home sharenfs on local\n" -"# zfs get sharesmb mypool/usr/home\n" -"NAME PROPERTY VALUE SOURCE\n" -"mypool/usr/home sharesmb off local\n" +"# zfs send -v mypool@replica1 | zfs receive -s backup/mypool\n" +"full send of mypool@replica1 estimated size is 50.1M\n" +"total estimated size is 50.1M\n" +"TIME SENT SNAPSHOT mypool@replica1\n" +"10:31:01 9.75M mypool@replica1\n" +"^C\n" msgstr "" -"# zfs get sharenfs mypool/usr/home\n" -"NAME PROPERTY VALUE SOURCE\n" -"mypool/usr/home sharenfs on local\n" -"# zfs get sharesmb mypool/usr/home\n" -"NAME PROPERTY VALUE SOURCE\n" -"mypool/usr/home sharesmb off local\n" +"# zfs send -v mypool@replica1 | zfs receive -s backup/mypool\n" +"full send of mypool@replica1 estimated size is 50.1M\n" +"total estimated size is 50.1M\n" +"TIME SENT SNAPSHOT mypool@replica1\n" +"10:31:01 9.75M mypool@replica1\n" +"^C\n" #. type: Plain text -#: documentation/content/en/books/handbook/zfs/_index.adoc:1730 -msgid "To enable sharing of a dataset, enter:" -msgstr "Чтобы включить общий доступ к набору данных, введите:" +#: documentation/content/en/books/handbook/zfs/_index.adoc:3063 +msgid "" +"After the interruption, the receiving dataset stores an opaque resume token " +"in its `receive_resume_token` property. The token records which snapshot " +"the interrupted stream contained and how much of it arrived. Passing the " +"token to `zfs send -t` generates a new stream that continues where the " +"transfer stopped:" +msgstr "" +"После прерывания принимающий набор данных сохраняет непрозрачный токен " +"возобновления в своём свойстве `receive_resume_token`. Токен записывает, " +"какой снимок содержал прерванный поток и какая его часть была получена. " +"Передача токена команде `zfs send -t` создаёт новый поток, который " +"продолжает с того места, где передача остановилась:" #. type: delimited block . 4 -#: documentation/content/en/books/handbook/zfs/_index.adoc:1734 +#: documentation/content/en/books/handbook/zfs/_index.adoc:3069 #, no-wrap -msgid "# zfs set sharenfs=on mypool/usr/home\n" -msgstr "# zfs set sharenfs=on mypool/usr/home\n" +msgid "" +"# zfs get -H -o value receive_resume_token backup/mypool\n" +"1-1211c4f4a-f8-789c636064000310a501c49c50360710a715e5e7a69766a63040c1eabb735735ce8f8d5420c0e5c9e8d4d3d28a5388e4d3d200\n" +"# zfs send -t $(zfs get -H -o value receive_resume_token backup/mypool) | zfs receive -s backup/mypool\n" +msgstr "" +"# zfs get -H -o value receive_resume_token backup/mypool\n" +"1-1211c4f4a-f8-789c636064000310a501c49c50360710a715e5e7a69766a63040c1eabb7357" +"35ce8f8d5420c0e5c9e8d4d3d28a5388e4d3d200\n" +"# zfs send -t $(zfs get -H -o value receive_resume_token backup/mypool) | " +"zfs receive -s backup/mypool\n" #. type: Plain text -#: documentation/content/en/books/handbook/zfs/_index.adoc:1738 +#: documentation/content/en/books/handbook/zfs/_index.adoc:3074 msgid "" -"Set other options for sharing datasets through NFS, such as `-alldirs`, `-" -"maproot` and `-network`. To set options on a dataset shared through NFS, " -"enter:" +"The resumed transfer completes normally and removes the saved partial " +"state. Until resumed or aborted, the partial state consumes space on the " +"receiving pool and blocks other receives into the same dataset. To abandon " +"an interrupted transfer instead of resuming it, use `zfs receive -A` to " +"delete the saved partial state:" msgstr "" -"Установите другие параметры для общего доступа к наборам данных через NFS, " -"такие как `-alldirs`, `-maproot` и `-network`. Чтобы задать параметры для " -"набора данных, доступного через NFS, введите:" +"Возобновлённая передача завершается нормально и удаляет сохранённое " +"частичное состояние. Пока передача не возобновлена или не прервана, " +"частичное состояние занимает место в принимающем пуле и блокирует другие " +"приёмы в тот же набор данных. Чтобы отказаться от прерванной передачи вместо " +"её возобновления, используйте `zfs receive -A` для удаления сохранённого " +"частичного состояния:" #. type: delimited block . 4 -#: documentation/content/en/books/handbook/zfs/_index.adoc:1742 +#: documentation/content/en/books/handbook/zfs/_index.adoc:3078 #, no-wrap -msgid "# zfs set sharenfs=\"-alldirs,-maproot=root,-network=192.168.1.0/24\" mypool/usr/home\n" -msgstr "# zfs set sharenfs=\"-alldirs,-maproot=root,-network=192.168.1.0/24\" mypool/usr/home\n" +msgid "# zfs receive -A backup/mypool\n" +msgstr "# zfs receive -A backup/mypool\n" -#. type: Title === -#: documentation/content/en/books/handbook/zfs/_index.adoc:1745 +#. type: Title ==== +#: documentation/content/en/books/handbook/zfs/_index.adoc:3081 #, no-wrap -msgid "Managing Snapshots" -msgstr "Управление снимками" +msgid "Sending Encrypted Backups over SSH" +msgstr "Отправка зашифрованных резервных копий через SSH" #. type: Plain text -#: documentation/content/en/books/handbook/zfs/_index.adoc:1759 +#: documentation/content/en/books/handbook/zfs/_index.adoc:3089 msgid "" -"crossref:zfs[zfs-term-snapshot,Snapshots] are one of the most powerful " -"features of ZFS. A snapshot provides a read-only, point-in-time copy of the " -"dataset. With Copy-On-Write (COW), ZFS creates snapshots fast by preserving " -"older versions of the data on disk. If no snapshots exist, ZFS reclaims " -"space for future use when data is rewritten or deleted. Snapshots preserve " -"disk space by recording just the differences between the current dataset and " -"a previous version. Allowing snapshots on whole datasets, not on individual " -"files or directories. A snapshot from a dataset duplicates everything " -"contained in it. This includes the file system properties, files, " -"directories, permissions, and so on. Snapshots use no extra space when " -"first created, but consume space as the blocks they reference change. " -"Recursive snapshots taken with `-r` create snapshots with the same name on " -"the dataset and its children, providing a consistent moment-in-time snapshot " -"of the file systems. This can be important when an application has files on " -"related datasets or that depend upon each other. Without snapshots, a " -"backup would have copies of the files from different points in time." +"Sending streams over the network is a good way to keep a remote backup, but " +"it does come with a drawback. Data sent over the network link is not " +"encrypted, allowing anyone to intercept and transform the streams back into " +"data without the knowledge of the sending user. This is undesirable when " +"sending the streams over the internet to a remote host. Use SSH to securely " +"encrypt data sent over a network connection. Since ZFS requires redirecting " +"the stream from standard output, piping it through SSH is easy. To keep the " +"contents of the file system encrypted on the remote system as well, use " +"crossref:zfs[zfs-native-encryption,native encryption] and send the dataset " +"as a raw stream, as described in crossref:zfs[zfs-encrypted-send,Sending " +"Encrypted Datasets]." msgstr "" -"crossref:zfs[zfs-term-snapshot,Снимки] — одна из самых мощных функций ZFS. " -"Снимок предоставляет доступную только для чтения копию набора данных на " -"определённый момент времени. Благодаря механизму Copy-On-Write (COW), ZFS " -"быстро создаёт снимки, сохраняя старые версии данных на диске. Если снимков " -"не существует, ZFS освобождает место для последующего использования при " -"перезаписи или удалении данных. Снимки экономят дисковое пространство, " -"записывая только различия между текущим набором данных и предыдущей версией. " -"Создание снимков возможно для целых наборов данных, но не для отдельных " -"файлов или каталогов. Снимок набора данных дублирует всё его содержимое. Это " -"включает свойства файловой системы, файлы, каталоги, права доступа и так " -"далее. Снимки не занимают дополнительного места при создании, но начинают " -"потреблять пространство по мере изменения блоков, на которые они ссылаются. " -"Рекурсивные снимки, созданные с помощью `-r`, формируют снимки с одинаковыми " -"именами для набора данных и его дочерних элементов, обеспечивая " -"согласованный снимок файловых систем на определённый момент времени. Это " -"может быть важно, когда приложение использует файлы в связанных наборах " -"данных или зависящие друг от друга. Без снимков резервная копия содержала бы " -"файлы из разных моментов времени." +"Отправка потоков данных по сети — это хороший способ создания удалённой " +"резервной копии, но у этого метода есть недостаток. Данные, передаваемые по " +"сетевому соединению, не шифруются, что позволяет любому перехватить их и " +"преобразовать обратно в данные без ведома отправителя. Это нежелательно при " +"отправке потоков через интернет на удалённый хост. Используйте SSH для " +"безопасного шифрования данных, передаваемых по сетевому соединению. " +"Поскольку ZFS требует перенаправления потока из стандартного вывода, его " +"легко передать через SSH с помощью конвейера. Чтобы содержимое файловой " +"системы оставалось зашифрованным и на удалённой системе, используйте " +"crossref:zfs[zfs-native-encryption,встроенное шифрование] и отправляйте " +"набор данных в виде необработанного (raw) потока, как описано в crossref:zfs" +"[zfs-encrypted-send,«Отправка зашифрованных наборов данных»]." #. type: Plain text -#: documentation/content/en/books/handbook/zfs/_index.adoc:1768 +#: documentation/content/en/books/handbook/zfs/_index.adoc:3092 msgid "" -"Snapshots in ZFS provide a variety of features that even other file systems " -"with snapshot functionality lack. A typical example of snapshot use is as a " -"quick way of backing up the current state of the file system when performing " -"a risky action like a software installation or a system upgrade. If the " -"action fails, rolling back to the snapshot returns the system to the same " -"state when creating the snapshot. If the upgrade was successful, delete the " -"snapshot to free up space. Without snapshots, a failed upgrade often " -"requires restoring backups, which is tedious, time consuming, and may " -"require downtime during which the system is unusable. Rolling back to " -"snapshots is fast, even while the system is running in normal operation, " -"with little or no downtime. The time savings are enormous with multi-" -"terabyte storage systems considering the time required to copy the data from " -"backup. Snapshots are not a replacement for a complete backup of a pool, " -"but offer a quick and easy way to store a dataset copy at a specific time." +"Change some settings and take security precautions first. This describes " +"the necessary steps required for the `zfs send` operation; for more " +"information on SSH, see crossref:security[openssh,\"OpenSSH\"]." msgstr "" -"Снимки в ZFS предоставляют множество функций, которых нет даже в других " -"файловых системах с поддержкой снимков. Типичный пример использования " -"снимков — быстрое резервное копирование текущего состояния файловой системы " -"перед выполнением рискованных действий, таких как установка программного " -"обеспечения или обновление системы. Если действие завершится неудачей, откат " -"к снимку вернёт систему в состояние на момент его создания. Если обновление " -"прошло успешно, снимок можно удалить для освобождения места. Без снимков " -"неудачное обновление часто требует восстановления из резервных копий, что " -"утомительно, отнимает много времени и может привести к простою системы, в " -"течение которого она будет недоступна. Откат к снимкам выполняется быстро, " -"даже во время обычной работы системы, с минимальным или нулевым временем " -"простоя. Экономия времени огромна, особенно для многотерабайтных систем " -"хранения, учитывая время, необходимое для копирования данных из резервной " -"копии. Снимки не заменяют полное резервное копирование пула, но предлагают " -"быстрый и простой способ сохранить копию набора данных на определённый " -"момент времени." +"Измените некоторые настройки и сначала примите меры безопасности. Здесь " +"описаны необходимые шаги для операции `zfs send`; дополнительную информацию " +"о SSH см. в crossref:security[openssh,\"OpenSSH\"]." -#. type: Title ==== -#: documentation/content/en/books/handbook/zfs/_index.adoc:1770 -#, no-wrap -msgid "Creating Snapshots" -msgstr "Создание снимков" +#. type: Plain text +#: documentation/content/en/books/handbook/zfs/_index.adoc:3094 +msgid "Change the configuration as follows:" +msgstr "Измените конфигурацию следующим образом:" #. type: Plain text -#: documentation/content/en/books/handbook/zfs/_index.adoc:1774 +#: documentation/content/en/books/handbook/zfs/_index.adoc:3096 msgid "" -"To create snapshots, use `zfs snapshot _dataset_@_snapshotname_`. Adding `-" -"r` creates a snapshot recursively, with the same name on all child datasets." +"Passwordless SSH access between sending and receiving host using SSH keys" msgstr "" -"Для создания снимков используйте `zfs snapshot _наборданных_@_имяснимка_`. " -"Добавление опции `-r` создаёт снимок рекурсивно с тем же именем для всех " -"дочерних наборов данных." +"Беспарольный доступ SSH между отправляющим и принимающим хостами с " +"использованием SSH-ключей" #. type: Plain text -#: documentation/content/en/books/handbook/zfs/_index.adoc:1776 -msgid "Create a recursive snapshot of the entire pool:" -msgstr "Создать рекурсивный снимок всего пула:" - -#. type: delimited block . 4 -#: documentation/content/en/books/handbook/zfs/_index.adoc:1814 -#, no-wrap +#: documentation/content/en/books/handbook/zfs/_index.adoc:3097 msgid "" -"# zfs list -t all\n" -"NAME USED AVAIL REFER MOUNTPOINT\n" -"mypool 780M 93.2G 144K none\n" -"mypool/ROOT 777M 93.2G 144K none\n" -"mypool/ROOT/default 777M 93.2G 777M /\n" -"mypool/tmp 176K 93.2G 176K /tmp\n" -"mypool/usr 616K 93.2G 144K /usr\n" -"mypool/usr/home 184K 93.2G 184K /usr/home\n" -"mypool/usr/ports 144K 93.2G 144K /usr/ports\n" -"mypool/usr/src 144K 93.2G 144K /usr/src\n" -"mypool/var 1.29M 93.2G 616K /var\n" -"mypool/var/crash 148K 93.2G 148K /var/crash\n" -"mypool/var/log 178K 93.2G 178K /var/log\n" -"mypool/var/mail 144K 93.2G 144K /var/mail\n" -"mypool/var/newname 87.5K 93.2G 87.5K /var/newname\n" -"mypool/var/newname@new_snapshot_name 0 - 87.5K -\n" -"mypool/var/tmp 152K 93.2G 152K /var/tmp\n" -"# zfs snapshot -r mypool@my_recursive_snapshot\n" -"# zfs list -t snapshot\n" -"NAME USED AVAIL REFER MOUNTPOINT\n" -"mypool@my_recursive_snapshot 0 - 144K -\n" -"mypool/ROOT@my_recursive_snapshot 0 - 144K -\n" -"mypool/ROOT/default@my_recursive_snapshot 0 - 777M -\n" -"mypool/tmp@my_recursive_snapshot 0 - 176K -\n" -"mypool/usr@my_recursive_snapshot 0 - 144K -\n" -"mypool/usr/home@my_recursive_snapshot 0 - 184K -\n" -"mypool/usr/ports@my_recursive_snapshot 0 - 144K -\n" -"mypool/usr/src@my_recursive_snapshot 0 - 144K -\n" -"mypool/var@my_recursive_snapshot 0 - 616K -\n" -"mypool/var/crash@my_recursive_snapshot 0 - 148K -\n" -"mypool/var/log@my_recursive_snapshot 0 - 178K -\n" -"mypool/var/mail@my_recursive_snapshot 0 - 144K -\n" -"mypool/var/newname@new_snapshot_name 0 - 87.5K -\n" -"mypool/var/newname@my_recursive_snapshot 0 - 87.5K -\n" -"mypool/var/tmp@my_recursive_snapshot 0 - 152K -\n" +"ZFS requires the privileges of the `root` user to send and receive streams. " +"This requires logging in to the receiving system as `root`." msgstr "" -"# zfs list -t all\n" -"NAME USED AVAIL REFER MOUNTPOINT\n" -"mypool 780M 93.2G 144K none\n" -"mypool/ROOT 777M 93.2G 144K none\n" -"mypool/ROOT/default 777M 93.2G 777M /\n" -"mypool/tmp 176K 93.2G 176K /tmp\n" -"mypool/usr 616K 93.2G 144K /usr\n" -"mypool/usr/home 184K 93.2G 184K /usr/home\n" -"mypool/usr/ports 144K 93.2G 144K /usr/ports\n" -"mypool/usr/src 144K 93.2G 144K /usr/src\n" -"mypool/var 1.29M 93.2G 616K /var\n" -"mypool/var/crash 148K 93.2G 148K /var/crash\n" -"mypool/var/log 178K 93.2G 178K /var/log\n" -"mypool/var/mail 144K 93.2G 144K /var/mail\n" -"mypool/var/newname 87.5K 93.2G 87.5K /var/newname\n" -"mypool/var/newname@new_snapshot_name 0 - 87.5K -\n" -"mypool/var/tmp 152K 93.2G 152K /var/tmp\n" -"# zfs snapshot -r mypool@my_recursive_snapshot\n" -"# zfs list -t snapshot\n" -"NAME USED AVAIL REFER MOUNTPOINT\n" -"mypool@my_recursive_snapshot 0 - 144K -\n" -"mypool/ROOT@my_recursive_snapshot 0 - 144K -\n" -"mypool/ROOT/default@my_recursive_snapshot 0 - 777M -\n" -"mypool/tmp@my_recursive_snapshot 0 - 176K -\n" -"mypool/usr@my_recursive_snapshot 0 - 144K -\n" -"mypool/usr/home@my_recursive_snapshot 0 - 184K -\n" -"mypool/usr/ports@my_recursive_snapshot 0 - 144K -\n" -"mypool/usr/src@my_recursive_snapshot 0 - 144K -\n" -"mypool/var@my_recursive_snapshot 0 - 616K -\n" -"mypool/var/crash@my_recursive_snapshot 0 - 148K -\n" -"mypool/var/log@my_recursive_snapshot 0 - 178K -\n" -"mypool/var/mail@my_recursive_snapshot 0 - 144K -\n" -"mypool/var/newname@new_snapshot_name 0 - 87.5K -\n" -"mypool/var/newname@my_recursive_snapshot 0 - 87.5K -\n" -"mypool/var/tmp@my_recursive_snapshot 0 - 152K -\n" +"Для отправки и получения потоков ZFS требуются привилегии пользователя " +"`root`. Это подразумевает вход в принимающую систему под учётной записью " +"`root`." #. type: Plain text -#: documentation/content/en/books/handbook/zfs/_index.adoc:1819 -msgid "" -"Snapshots are not shown by a normal `zfs list` operation. To list " -"snapshots, append `-t snapshot` to `zfs list`. `-t all` displays both file " -"systems and snapshots." +#: documentation/content/en/books/handbook/zfs/_index.adoc:3098 +msgid "Security reasons prevent `root` from logging in by default." msgstr "" -"Снимки не отображаются при обычной операции `zfs list`. Для вывода списка " -"снимков добавьте `-t snapshot` к команде `zfs list`. Опция `-t all` " -"показывает как файловые системы, так и снимки." +"По соображениям безопасности вход пользователя `root` по умолчанию запрещён." #. type: Plain text -#: documentation/content/en/books/handbook/zfs/_index.adoc:1823 +#: documentation/content/en/books/handbook/zfs/_index.adoc:3100 msgid "" -"Snapshots are not mounted directly, showing no path in the `MOUNTPOINT` " -"column. ZFS does not mention available disk space in the `AVAIL` column, as " -"snapshots are read-only after their creation. Compare the snapshot to the " -"original dataset:" +"Use the crossref:zfs[zfs-zfs-allow,ZFS Delegation] system to allow a non-" +"`root` user on each system to perform the respective send and receive " +"operations. On the sending system:" msgstr "" -"Снимки не монтируются напрямую, поэтому в столбце `MOUNTPOINT` не " -"отображается путь. ZFS не указывает доступное дисковое пространство в " -"столбце `AVAIL`, так как снимки доступны только для чтения после их " -"создания. Сравните снимок с исходным набором данных:" +"Используйте систему crossref:zfs[zfs-zfs-allow,Делегирование ZFS], чтобы " +"разрешить пользователю без прав `root` на каждой системе выполнять " +"соответствующие операции отправки и получения. На передающей системе:" #. type: delimited block . 4 -#: documentation/content/en/books/handbook/zfs/_index.adoc:1830 +#: documentation/content/en/books/handbook/zfs/_index.adoc:3104 #, no-wrap +msgid "# zfs allow -u someuser send,snapshot mypool\n" +msgstr "# zfs allow -u someuser send,snapshot mypool\n" + +#. type: Plain text +#: documentation/content/en/books/handbook/zfs/_index.adoc:3107 msgid "" -"# zfs list -rt all mypool/usr/home\n" -"NAME USED AVAIL REFER MOUNTPOINT\n" -"mypool/usr/home 184K 93.2G 184K /usr/home\n" -"mypool/usr/home@my_recursive_snapshot 0 - 184K -\n" +"To mount the pool, the unprivileged user must own the directory, and regular " +"users need permission to mount file systems." +msgstr "" +"Чтобы подключить пул, непривилегированный пользователь должен быть " +"владельцем каталога, а обычные пользователи должны иметь разрешение на " +"подключение файловых систем." + +#. type: Plain text +#: documentation/content/en/books/handbook/zfs/_index.adoc:3109 +msgid "On the receiving system:" +msgstr "На принимающей системе:" + +#. type: delimited block . 4 +#: documentation/content/en/books/handbook/zfs/_index.adoc:3118 +#, no-wrap +msgid "" +"# sysctl vfs.usermount=1\n" +"vfs.usermount: 0 -> 1\n" +"# echo vfs.usermount=1 >> /etc/sysctl.conf\n" +"# zfs create recvpool/backup\n" +"# zfs allow -u someuser create,mount,receive recvpool/backup\n" +"# chown someuser /recvpool/backup\n" msgstr "" -"# zfs list -rt all mypool/usr/home\n" -"NAME USED AVAIL REFER MOUNTPOINT\n" -"mypool/usr/home 184K 93.2G 184K /usr/home\n" -"mypool/usr/home@my_recursive_snapshot 0 - 184K -\n" +"# sysctl vfs.usermount=1\n" +"vfs.usermount: 0 -> 1\n" +"# echo vfs.usermount=1 >> /etc/sysctl.conf\n" +"# zfs create recvpool/backup\n" +"# zfs allow -u someuser create,mount,receive recvpool/backup\n" +"# chown someuser /recvpool/backup\n" #. type: Plain text -#: documentation/content/en/books/handbook/zfs/_index.adoc:1837 +#: documentation/content/en/books/handbook/zfs/_index.adoc:3121 msgid "" -"Displaying both the dataset and the snapshot together reveals how snapshots " -"work in crossref:zfs[zfs-term-cow,COW] fashion. They save the changes " -"(_delta_) made and not the complete file system contents all over again. " -"This means that snapshots take little space when making changes. Observe " -"space usage even more by copying a file to the dataset, then creating a " -"second snapshot:" +"The unprivileged user can receive and mount datasets now, and replicates the " +"_home_ dataset to the remote system:" msgstr "" -"Отображение набора данных и снимка вместе показывает, как снимки работают в " -"стиле crossref:zfs[zfs-term-cow,COW]. Они сохраняют внесённые изменения " -"(_дельту_), а не полное содержимое файловой системы заново. Это означает, " -"что снимки занимают мало места при внесении изменений. Наблюдайте за " -"использованием пространства ещё внимательнее, скопировав файл в набор " -"данных, а затем создав второй снимок:" +"Непривилегированный пользователь теперь может получать и монтировать наборы " +"данных, а также реплицирует набор данных _home_ на удалённую систему:" #. type: delimited block . 4 -#: documentation/content/en/books/handbook/zfs/_index.adoc:1847 +#: documentation/content/en/books/handbook/zfs/_index.adoc:3126 #, no-wrap msgid "" -"# cp /etc/passwd /var/tmp\n" -"# zfs snapshot mypool/var/tmp@after_cp\n" -"# zfs list -rt all mypool/var/tmp\n" -"NAME USED AVAIL REFER MOUNTPOINT\n" -"mypool/var/tmp 206K 93.2G 118K /var/tmp\n" -"mypool/var/tmp@my_recursive_snapshot 88K - 152K -\n" -"mypool/var/tmp@after_cp 0 - 118K -\n" +"% zfs snapshot -r mypool/home@monday\n" +"% zfs send -R mypool/home@monday | ssh someuser@backuphost zfs recv -dvu recvpool/backup\n" msgstr "" -"# cp /etc/passwd /var/tmp\n" -"# zfs snapshot mypool/var/tmp@after_cp\n" -"# zfs list -rt all mypool/var/tmp\n" -"NAME USED AVAIL REFER MOUNTPOINT\n" -"mypool/var/tmp 206K 93.2G 118K /var/tmp\n" -"mypool/var/tmp@my_recursive_snapshot 88K - 152K -\n" -"mypool/var/tmp@after_cp 0 - 118K -\n" +"% zfs snapshot -r mypool/home@monday\n" +"% zfs send -R mypool/home@monday | ssh someuser@backuphost zfs recv -dvu recvpool/backup\n" #. type: Plain text -#: documentation/content/en/books/handbook/zfs/_index.adoc:1852 +#: documentation/content/en/books/handbook/zfs/_index.adoc:3136 msgid "" -"The second snapshot contains the changes to the dataset after the copy " -"operation. This yields enormous space savings. Notice that the size of the " -"snapshot `_mypool/var/tmp@my_recursive_snapshot_` also changed in the `USED` " -"column to show the changes between itself and the snapshot taken afterwards." +"Create a recursive snapshot called _monday_ of the file system dataset " +"_home_ on the pool _mypool_. Then `zfs send -R` includes the dataset, all " +"child datasets, snapshots, clones, and settings in the stream. Pipe the " +"output through SSH to the waiting `zfs receive` on the remote host " +"_backuphost_. Using an IP address or fully qualified domain name is good " +"practice. The receiving machine writes the data to the _backup_ dataset on " +"the _recvpool_ pool. Adding `-d` to `zfs recv` discards the first element " +"of the sent snapshot's path, usually the pool name, and grafts the remaining " +"path onto the receiving dataset, creating any required intermediate file " +"systems. `-u` causes the file systems to not mount on the receiving side. " +"Using `-v` shows more details about the transfer, including the elapsed time " +"and the amount of data transferred." msgstr "" -"Второй снимок содержит изменения в наборе данных после операции копирования. " -"Это обеспечивает значительную экономию пространства. Обратите внимание, что " -"размер снимка `_mypool/var/tmp@my_recursive_snapshot_` также изменился в " -"столбце `USED`, показывая разницу между ним и последующим снимком." +"Создайте рекурсивный снимок с именем _monday_ для набора данных файловой " +"системы _home_ в пуле _mypool_. Затем `zfs send -R` включает в поток набор " +"данных, все дочерние наборы данных, снимки, клоны и настройки. Передайте " +"вывод через SSH на ожидающий `zfs receive` на удалённом хосте _backuphost_. " +"Рекомендуется использовать IP-адрес или полное доменное имя. Принимающая " +"машина записывает данные в набор данных _backup_ в пуле _recvpool_. " +"Добавление опции `-d` к команде `zfs recv` отбрасывает первый элемент пути " +"отправленного снимка (обычно это имя пула) и присоединяет оставшуюся часть " +"пути к принимаемому набору данных, создавая при необходимости все " +"промежуточные файловые системы. `-u` отключает монтирование файловых систем " +"на принимающей стороне. Использование `-v` показывает подробности о " +"передаче, включая затраченное время и объём переданных данных." #. type: Title ==== -#: documentation/content/en/books/handbook/zfs/_index.adoc:1854 +#: documentation/content/en/books/handbook/zfs/_index.adoc:3138 #, no-wrap -msgid "Comparing Snapshots" -msgstr "Сравнение снимков" +msgid "Corrective Receive" +msgstr "Корректирующий приём" #. type: Plain text -#: documentation/content/en/books/handbook/zfs/_index.adoc:1860 +#: documentation/content/en/books/handbook/zfs/_index.adoc:3143 msgid "" -"ZFS provides a built-in command to compare the differences in content " -"between two snapshots. This is helpful with a lot of snapshots taken over " -"time when the user wants to see how the file system has changed over time. " -"For example, `zfs diff` lets a user find the latest snapshot that still " -"contains a file deleted by accident. Doing this for the two snapshots " -"created in the previous section yields this output:" +"A scrub detects corrupted data, but on a pool without enough redundancy it " +"cannot repair the damage and reports permanent errors instead. When an " +"intact copy of the affected snapshot exists on another pool, a corrective " +"receive with `zfs receive -c` heals the damaged blocks in place, using the " +"send stream as a source of healthy data. The dataset stays where it is, " +"without any rollback or rename." msgstr "" -"ZFS предоставляет встроенную команду для сравнения различий в содержимом " -"между двумя снимками. Это полезно при наличии множества снимков, сделанных " -"за определённый период, когда пользователь хочет увидеть, как файловая " -"система изменялась со временем. Например, `zfs diff` позволяет пользователю " -"найти последний снимок, который ещё содержит случайно удалённый файл. " -"Применение этой команды к двум снимкам, созданным в предыдущем разделе, даёт " -"следующий вывод:" +"Процедура проверки (scrub) обнаруживает поврежденные данные, но в пуле без " +"достаточной избыточности она не может исправить повреждения и вместо этого " +"сообщает о постоянных ошибках. Если на другом пуле существует неповрежденная " +"копия затронутого снимка, корректирующий прием с помощью `zfs receive -c` " +"восстанавливает поврежденные блоки на месте, используя поток отправки как " +"источник здоровых данных. Набор данных остается на своем месте, без каких-" +"либо откатов или переименований." -#. type: delimited block . 4 -#: documentation/content/en/books/handbook/zfs/_index.adoc:1871 -#, no-wrap -msgid "" -"# zfs list -rt all mypool/var/tmp\n" -"NAME USED AVAIL REFER MOUNTPOINT\n" -"mypool/var/tmp 206K 93.2G 118K /var/tmp\n" -"mypool/var/tmp@my_recursive_snapshot 88K - 152K -\n" -"mypool/var/tmp@after_cp 0 - 118K -\n" -"# zfs diff mypool/var/tmp@my_recursive_snapshot\n" -"M /var/tmp/\n" -"+ /var/tmp/passwd\n" +#. type: delimited block = 4 +#: documentation/content/en/books/handbook/zfs/_index.adoc:3147 +msgid "Corrective receive requires OpenZFS 2.2, first shipped in FreeBSD 14.0." msgstr "" -"# zfs list -rt all mypool/var/tmp\n" -"NAME USED AVAIL REFER MOUNTPOINT\n" -"mypool/var/tmp 206K 93.2G 118K /var/tmp\n" -"mypool/var/tmp@my_recursive_snapshot 88K - 152K -\n" -"mypool/var/tmp@after_cp 0 - 118K -\n" -"# zfs diff mypool/var/tmp@my_recursive_snapshot\n" -"M /var/tmp/\n" -"+ /var/tmp/passwd\n" +"Корректирующий приём требует OpenZFS 2.2, впервые поставленный во FreeBSD 14." +"0." #. type: Plain text -#: documentation/content/en/books/handbook/zfs/_index.adoc:1875 +#: documentation/content/en/books/handbook/zfs/_index.adoc:3150 msgid "" -"The command lists the changes between the specified snapshot (in this case " -"`_mypool/var/tmp@my_recursive_snapshot_`) and the live file system. The " -"first column shows the change type:" +"In this example, a scrub of the single-disk pool _mypool_ found " +"unrecoverable damage:" msgstr "" -"Команда выводит список изменений между указанным снимком (в данном случае " -"`_mypool/var/tmp@my_recursive_snapshot_`) и активной файловой системой. " -"Первый столбец показывает тип изменения:" +"В этом примере проверка пула _mypool_ на одном диске обнаружила неустранимые " +"повреждения:" -#. type: Table -#: documentation/content/en/books/handbook/zfs/_index.adoc:1881 +#. type: delimited block . 4 +#: documentation/content/en/books/handbook/zfs/_index.adoc:3163 #, no-wrap -msgid "+" -msgstr "+" +msgid "" +"# zpool status -v mypool\n" +" pool: mypool\n" +" state: ONLINE\n" +"status: One or more devices has experienced an error resulting in data\n" +" corruption. Applications may be affected.\n" +"action: Restore the file in question if possible. Otherwise restore the\n" +" entire pool from backup.\n" +" see: https://openzfs.github.io/openzfs-docs/msg/ZFS-8000-8A\n" +" scan: scrub repaired 0B in 00:01:22 with 1 errors on Sat Jul 11 09:14:37 2026\n" +"config:\n" +msgstr "" +"# zpool status -v mypool\n" +" pool: mypool\n" +" state: ONLINE\n" +"status: One or more devices has experienced an error resulting in data\n" +" corruption. Applications may be affected.\n" +"action: Restore the file in question if possible. Otherwise restore the\n" +" entire pool from backup.\n" +" see: https://openzfs.github.io/openzfs-docs/msg/ZFS-8000-8A\n" +" scan: scrub repaired 0B in 00:01:22 with 1 errors on Sat Jul 11 09:14:37 " +"2026\n" +"config:\n" -#. type: Table -#: documentation/content/en/books/handbook/zfs/_index.adoc:1883 +#. type: delimited block . 4 +#: documentation/content/en/books/handbook/zfs/_index.adoc:3167 #, no-wrap -msgid "Adding the path or file." -msgstr "Добавление пути или файла." +msgid "" +" NAME STATE READ WRITE CKSUM\n" +" mypool ONLINE 0 0 0\n" +" ada0 ONLINE 0 0 2\n" +msgstr "" +" NAME STATE READ WRITE CKSUM\n" +" mypool ONLINE 0 0 0\n" +" ada0 ONLINE 0 0 2\n" -#. type: Table -#: documentation/content/en/books/handbook/zfs/_index.adoc:1884 +#. type: delimited block . 4 +#: documentation/content/en/books/handbook/zfs/_index.adoc:3169 #, no-wrap -msgid "-" -msgstr "-" +msgid "errors: Permanent errors have been detected in the following files:\n" +msgstr "errors: Permanent errors have been detected in the following files:\n" -#. type: Table -#: documentation/content/en/books/handbook/zfs/_index.adoc:1886 +#. type: delimited block . 4 +#: documentation/content/en/books/handbook/zfs/_index.adoc:3171 #, no-wrap -msgid "Deleting the path or file." -msgstr "Удаление пути или файла." +msgid " /mypool/reports/summary-2026.db\n" +msgstr " /mypool/reports/summary-2026.db\n" -#. type: Table -#: documentation/content/en/books/handbook/zfs/_index.adoc:1887 -#, no-wrap -msgid "M" -msgstr "M" +#. type: Plain text +#: documentation/content/en/books/handbook/zfs/_index.adoc:3175 +msgid "" +"The snapshot _replica2_ still references the damaged blocks, and the " +"_backup_ pool holds an intact copy of that snapshot. Send the snapshot from " +"the backup pool and receive it correctively into the matching snapshot on " +"the damaged pool, then scrub to confirm the repair:" +msgstr "" +"Снимок _replica2_ по-прежнему ссылается на повреждённые блоки, а пул " +"_backup_ содержит неповреждённую копию этого снимка. Отправьте снимок из " +"пула backup и получите его корректирующе в соответствующий снимок на " +"повреждённом пуле, затем выполните проверку (scrub), чтобы подтвердить " +"восстановление:" -#. type: Table -#: documentation/content/en/books/handbook/zfs/_index.adoc:1889 +#. type: delimited block . 4 +#: documentation/content/en/books/handbook/zfs/_index.adoc:3182 #, no-wrap -msgid "Modifying the path or file." -msgstr "Изменение пути или файла." +msgid "" +"# zfs send backup/mypool@replica2 | zfs receive -c mypool@replica2\n" +"# zpool scrub -w mypool\n" +"# zpool status mypool | grep errors:\n" +"errors: No known data errors\n" +msgstr "" +"# zfs send backup/mypool@replica2 | zfs receive -c mypool@replica2\n" +"# zpool scrub -w mypool\n" +"# zpool status mypool | grep errors:\n" +"errors: No known data errors\n" -#. type: Table -#: documentation/content/en/books/handbook/zfs/_index.adoc:1890 -#, no-wrap -msgid "R" -msgstr "R" +#. type: Plain text +#: documentation/content/en/books/handbook/zfs/_index.adoc:3187 +msgid "" +"The stream must contain the same snapshot that exists on the damaged " +"dataset. Corrective receive heals only the data blocks present in the " +"stream; it cannot repair metadata or data written after the snapshot was " +"taken. Always run a crossref:zfs[zfs-zpool-scrub,scrub] afterwards to " +"verify that the pool no longer contains damaged data." +msgstr "" +"Поток должен содержать тот же снапшот, который существует на повреждённом " +"наборе данных. Корректирующий приём восстанавливает только те блоки данных, " +"которые присутствуют в потоке; он не может исправить метаданные или данные, " +"записанные после создания снапшота. После этого всегда выполняйте " +"crossref:zfs[zfs-zpool-scrub,scrub], чтобы убедиться, что пул больше не " +"содержит повреждённых данных." -#. type: Table -#: documentation/content/en/books/handbook/zfs/_index.adoc:1891 +#. type: Title === +#: documentation/content/en/books/handbook/zfs/_index.adoc:3189 #, no-wrap -msgid "Renaming the path or file." -msgstr "Переименование пути или файла." +msgid "Dataset, User, and Group Quotas" +msgstr "Квоты наборов данных, пользователей и групп" #. type: Plain text -#: documentation/content/en/books/handbook/zfs/_index.adoc:1896 +#: documentation/content/en/books/handbook/zfs/_index.adoc:3195 msgid "" -"Comparing the output with the table, it becomes clear that ZFS added [." -"filename]#passwd# after creating the snapshot `_mypool/var/" -"tmp@my_recursive_snapshot_`. This also resulted in a modification to the " -"parent directory mounted at `_/var/tmp_`." +"Use crossref:zfs[zfs-term-quota,Dataset quotas] to restrict the amount of " +"space consumed by a particular dataset. crossref:zfs[zfs-term-refquota," +"Reference Quotas] work in much the same way, but count the space used by the " +"dataset itself, excluding snapshots and child datasets. Similarly, use " +"crossref:zfs[zfs-term-userquota,user] and crossref:zfs[zfs-term-groupquota," +"group] quotas to prevent users or groups from using up all the space in the " +"pool or dataset. Project quotas, described below, restrict the space " +"consumed by an arbitrary directory tree instead." msgstr "" -"Сравнивая вывод с таблицей, становится ясно, что ZFS добавил [." -"filename]#passwd# после создания снимка `_mypool/var/" -"tmp@my_recursive_snapshot_`. Это также привело к изменению родительского " -"каталога, смонтированного в `_/var/tmp_`." +"Используйте crossref:zfs[zfs-term-quota,Квоты наборов данных], чтобы " +"ограничить объём пространства, используемого определённым набором данных. " +"crossref:zfs[zfs-term-refquota,Референтные квоты] работают схожим образом, " +"но учитывают пространство, используемое самим набором данных, исключая " +"снимки и дочерние наборы данных. Аналогично, используйте crossref:zfs[zfs-" +"term-userquota,пользовательские] и crossref:zfs[zfs-term-" +"groupquota,групповые] квоты, чтобы предотвратить исчерпание всего " +"пространства в пуле или наборе данных пользователями или группами. Квоты " +"проектов, описанные ниже, ограничивают занимаемое пространство для " +"произвольного дерева каталогов." #. type: Plain text -#: documentation/content/en/books/handbook/zfs/_index.adoc:1898 +#: documentation/content/en/books/handbook/zfs/_index.adoc:3200 msgid "" -"Comparing two snapshots is helpful when using the ZFS replication feature to " -"transfer a dataset to a different host for backup purposes." +"The following examples assume that the users already exist in the system. " +"Before adding a user to the system, make sure to create their home dataset " +"first and set the `mountpoint` to `/home/_bob_`. Then, create the user and " +"make the home directory point to the dataset's `mountpoint` location. This " +"will properly set owner and group permissions without shadowing any pre-" +"existing home directory paths that might exist." msgstr "" -"Сравнение двух снимков полезно при использовании функции репликации ZFS для " -"передачи набора данных на другой хост в целях резервного копирования." +"Следующие примеры предполагают, что пользователи уже существуют в системе. " +"Перед добавлением пользователя в систему убедитесь, что вы сначала создали " +"его домашний набор данных и установили `mountpoint` в `/home/_bob_`. Затем " +"создайте пользователя и укажите домашний каталог на расположение " +"`mountpoint` набора данных. Это правильно установит права владельца и группы " +"без перекрытия уже существующих путей домашних каталогов." #. type: Plain text -#: documentation/content/en/books/handbook/zfs/_index.adoc:1900 -msgid "" -"Compare two snapshots by providing the full dataset name and snapshot name " -"of both datasets:" +#: documentation/content/en/books/handbook/zfs/_index.adoc:3202 +msgid "To enforce a dataset quota of 10 GB for [.filename]#storage/home/bob#:" msgstr "" -"Сравните два снимка, указав полное имя набора данных и имя снимка для обоих " -"наборов:" +"Чтобы установить квоту набора данных в 10 ГБ для [.filename]#storage/home/" +"bob#:" #. type: delimited block . 4 -#: documentation/content/en/books/handbook/zfs/_index.adoc:1912 +#: documentation/content/en/books/handbook/zfs/_index.adoc:3206 #, no-wrap +msgid "# zfs set quota=10G storage/home/bob\n" +msgstr "# zfs set quota=10G storage/home/bob\n" + +#. type: Plain text +#: documentation/content/en/books/handbook/zfs/_index.adoc:3209 msgid "" -"# cp /var/tmp/passwd /var/tmp/passwd.copy\n" -"# zfs snapshot mypool/var/tmp@diff_snapshot\n" -"# zfs diff mypool/var/tmp@my_recursive_snapshot mypool/var/tmp@diff_snapshot\n" -"M /var/tmp/\n" -"+ /var/tmp/passwd\n" -"+ /var/tmp/passwd.copy\n" -"# zfs diff mypool/var/tmp@my_recursive_snapshot mypool/var/tmp@after_cp\n" -"M /var/tmp/\n" -"+ /var/tmp/passwd\n" +"To enforce a reference quota of 10 GB for [.filename]#storage/home/bob#:" msgstr "" -"# cp /var/tmp/passwd /var/tmp/passwd.copy\n" -"# zfs snapshot mypool/var/tmp@diff_snapshot\n" -"# zfs diff mypool/var/tmp@my_recursive_snapshot mypool/var/tmp@diff_snapshot\n" -"M /var/tmp/\n" -"+ /var/tmp/passwd\n" -"+ /var/tmp/passwd.copy\n" -"# zfs diff mypool/var/tmp@my_recursive_snapshot mypool/var/tmp@after_cp\n" -"M /var/tmp/\n" -"+ /var/tmp/passwd\n" +"Чтобы установить контрольную квоту в 10 ГБ для [.filename]#storage/home/bob#:" + +#. type: delimited block . 4 +#: documentation/content/en/books/handbook/zfs/_index.adoc:3213 +#, no-wrap +msgid "# zfs set refquota=10G storage/home/bob\n" +msgstr "# zfs set refquota=10G storage/home/bob\n" + +#. type: Plain text +#: documentation/content/en/books/handbook/zfs/_index.adoc:3216 +msgid "To remove a quota of 10 GB for [.filename]#storage/home/bob#:" +msgstr "Удалить квоту в 10 ГБ для [.filename]#storage/home/bob#:" + +#. type: delimited block . 4 +#: documentation/content/en/books/handbook/zfs/_index.adoc:3220 +#, no-wrap +msgid "# zfs set quota=none storage/home/bob\n" +msgstr "# zfs set quota=none storage/home/bob\n" #. type: Plain text -#: documentation/content/en/books/handbook/zfs/_index.adoc:1916 +#: documentation/content/en/books/handbook/zfs/_index.adoc:3223 msgid "" -"A backup administrator can compare two snapshots received from the sending " -"host and determine the actual changes in the dataset. See the crossref:" -"zfs[zfs-zfs-send,Replication] section for more information." +"The general format is `userquota@_user_=_size_`, and the user's name must be " +"in one of these formats:" msgstr "" -"Администратор резервного копирования может сравнить два снимка, полученных " -"от отправляющего хоста, и определить фактические изменения в наборе данных. " -"Дополнительную информацию см. в разделе crossref:zfs[zfs-zfs-send," -"Репликация]." +"Общий формат `userquota@_пользователь_=_размер_`, и имя пользователя должно " +"быть в одном из следующих форматов:" -#. type: Title ==== -#: documentation/content/en/books/handbook/zfs/_index.adoc:1918 -#, no-wrap -msgid "Snapshot Rollback" -msgstr "Откат снимка состояния (Snapshot Rollback)" +#. type: Plain text +#: documentation/content/en/books/handbook/zfs/_index.adoc:3225 +msgid "POSIX compatible name such as _joe_." +msgstr "POSIX-совместимое имя, например _joe_." #. type: Plain text -#: documentation/content/en/books/handbook/zfs/_index.adoc:1931 -msgid "" -"When at least one snapshot is available, roll back to it at any time. Most " -"often this is the case when the current state of the dataset is no longer " -"valid or an older version is preferred. Scenarios such as local development " -"tests gone wrong, botched system updates hampering the system functionality, " -"or the need to restore deleted files or directories are all too common " -"occurrences. To roll back a snapshot, use `zfs rollback _snapshotname_`. " -"If a lot of changes are present, the operation will take a long time. " -"During that time, the dataset always remains in a consistent state, much " -"like a database that conforms to ACID principles is performing a rollback. " -"This is happening while the dataset is live and accessible without requiring " -"a downtime. Once the snapshot rolled back, the dataset has the same state " -"as it had when the snapshot was originally taken. Rolling back to a " -"snapshot discards all other data in that dataset not part of the snapshot. " -"Taking a snapshot of the current state of the dataset before rolling back to " -"a previous one is a good idea when requiring some data later. This way, the " -"user can roll back and forth between snapshots without losing data that is " -"still valuable." -msgstr "" -"Когда доступен хотя бы один снимок, можно в любой момент к нему вернуться. " -"Чаще всего это необходимо, когда текущее состояние набора данных больше не " -"является корректным или требуется более старая версия. Такие ситуации, как " -"неудачные локальные тесты разработки, неудачные обновления системы, " -"нарушающие её функциональность, или необходимость восстановления удалённых " -"файлов или каталогов, встречаются довольно часто. Для возврата к снимку " -"используйте команду `zfs rollback _имя_снимка_`. Если изменений много, " -"операция займёт значительное время. В течение этого времени набор данных " -"всегда остаётся в согласованном состоянии, подобно тому, как база данных, " -"соответствующая принципам ACID, выполняет откат. Это происходит, пока набор " -"данных находится в рабочем состоянии и доступен без необходимости простоя. " -"После отката к снимку набор данных возвращается в то же состояние, в котором " -"он находился на момент создания снимка. Откат к снимку удаляет все другие " -"данные в наборе, не входящие в снимок. Создание снимка текущего состояния " -"набора данных перед откатом к предыдущему — хорошая практика, если некоторые " -"данные могут потребоваться позже. Таким образом, пользователь может " -"переключаться между снимками, не теряя ценные данные." +#: documentation/content/en/books/handbook/zfs/_index.adoc:3226 +msgid "POSIX numeric ID such as _789_." +msgstr "Числовой идентификатор POSIX, например, _789_." #. type: Plain text -#: documentation/content/en/books/handbook/zfs/_index.adoc:1933 -msgid "" -"In the first example, roll back a snapshot because a careless `rm` operation " -"removed more data than intended." +#: documentation/content/en/books/handbook/zfs/_index.adoc:3227 +msgid "SID name such as _joe.bloggs@example.com_." +msgstr "Имя SID, например, _joe.bloggs@example.com_." + +#. type: Plain text +#: documentation/content/en/books/handbook/zfs/_index.adoc:3228 +msgid "SID numeric ID such as _S-1-123-456-789_." +msgstr "Числовой идентификатор SID, например, _S-1-123-456-789_." + +#. type: Plain text +#: documentation/content/en/books/handbook/zfs/_index.adoc:3230 +msgid "For example, to enforce a user quota of 50 GB for the user named _joe_:" msgstr "" -"В первом примере выполняется откат к снимку, потому что неосторожная " -"операция `rm` удалила больше данных, чем планировалось." +"Например, чтобы установить пользовательскую квоту в 50 ГБ для пользователя с " +"именем _joe_:" #. type: delimited block . 4 -#: documentation/content/en/books/handbook/zfs/_index.adoc:1947 +#: documentation/content/en/books/handbook/zfs/_index.adoc:3234 #, no-wrap -msgid "" -"# zfs list -rt all mypool/var/tmp\n" -"NAME USED AVAIL REFER MOUNTPOINT\n" -"mypool/var/tmp 262K 93.2G 120K /var/tmp\n" -"mypool/var/tmp@my_recursive_snapshot 88K - 152K -\n" -"mypool/var/tmp@after_cp 53.5K - 118K -\n" -"mypool/var/tmp@diff_snapshot 0 - 120K -\n" -"# ls /var/tmp\n" -"passwd passwd.copy vi.recover\n" -"# rm /var/tmp/passwd*\n" -"# ls /var/tmp\n" -"vi.recover\n" -msgstr "" -"# zfs list -rt all mypool/var/tmp\n" -"NAME USED AVAIL REFER MOUNTPOINT\n" -"mypool/var/tmp 262K 93.2G 120K /var/tmp\n" -"mypool/var/tmp@my_recursive_snapshot 88K - 152K -\n" -"mypool/var/tmp@after_cp 53.5K - 118K -\n" -"mypool/var/tmp@diff_snapshot 0 - 120K -\n" -"# ls /var/tmp\n" -"passwd passwd.copy vi.recover\n" -"# rm /var/tmp/passwd*\n" -"# ls /var/tmp\n" -"vi.recover\n" +msgid "# zfs set userquota@joe=50G storage/home/joe\n" +msgstr "# zfs set userquota@joe=50G storage/home/joe\n" #. type: Plain text -#: documentation/content/en/books/handbook/zfs/_index.adoc:1952 -msgid "" -"At this point, the user notices the removal of extra files and wants them " -"back. ZFS provides an easy way to get them back using rollbacks, when " -"performing snapshots of important data on a regular basis. To get the files " -"back and start over from the last snapshot, issue the command:" -msgstr "" -"На этом этапе пользователь замечает удаление лишних файлов и хочет вернуть " -"их обратно. ZFS предоставляет простой способ восстановления с использованием " -"отката, если регулярно создаются снимки важных данных. Чтобы вернуть файлы и " -"начать заново с последнего снимка, выполните команду:" +#: documentation/content/en/books/handbook/zfs/_index.adoc:3237 +msgid "To remove any quota:" +msgstr "Чтобы удалить любую квоту:" #. type: delimited block . 4 -#: documentation/content/en/books/handbook/zfs/_index.adoc:1958 +#: documentation/content/en/books/handbook/zfs/_index.adoc:3241 #, no-wrap +msgid "# zfs set userquota@joe=none storage/home/joe\n" +msgstr "# zfs set userquota@joe=none storage/home/joe\n" + +#. type: delimited block = 4 +#: documentation/content/en/books/handbook/zfs/_index.adoc:3248 msgid "" -"# zfs rollback mypool/var/tmp@diff_snapshot\n" -"# ls /var/tmp\n" -"passwd passwd.copy vi.recover\n" +"User quota properties are not displayed by `zfs get all`. Non-`root` users " +"can't see other's quotas unless granted the `userquota` privilege. Users " +"with this privilege are able to view and set everyone's quota." msgstr "" -"# zfs rollback mypool/var/tmp@diff_snapshot\n" -"# ls /var/tmp\n" -"passwd passwd.copy vi.recover\n" +"Свойства квот пользователей не отображаются командой `zfs get all`. " +"Пользователи без прав `root` не могут видеть квоты других, если им не " +"предоставлена привилегия `userquota`. Пользователи с этой привилегией могут " +"просматривать и устанавливать квоты для всех." #. type: Plain text -#: documentation/content/en/books/handbook/zfs/_index.adoc:1963 +#: documentation/content/en/books/handbook/zfs/_index.adoc:3251 msgid "" -"The rollback operation restored the dataset to the state of the last " -"snapshot. Rolling back to a snapshot taken much earlier with other " -"snapshots taken afterwards is also possible. When trying to do this, ZFS " -"will issue this warning:" +"The general format for setting a group quota is: `groupquota@_group_=_size_`." msgstr "" -"Операция отката восстановила набор данных до состояния последнего снимка. " -"Также возможен откат к более раннему снимку, если после него были созданы " -"другие снимки. При попытке выполнить это действие ZFS выдаст следующее " -"предупреждение:" +"Общий формат для установки квоты группы: `groupquota@_группа_=_размер_`." + +#. type: Plain text +#: documentation/content/en/books/handbook/zfs/_index.adoc:3253 +msgid "To set the quota for the group _firstgroup_ to 50 GB, use:" +msgstr "Чтобы установить квоту для группы _firstgroup_ в 50 ГБ, используйте:" #. type: delimited block . 4 -#: documentation/content/en/books/handbook/zfs/_index.adoc:1976 +#: documentation/content/en/books/handbook/zfs/_index.adoc:3257 #, no-wrap -msgid "" -"# zfs list -rt snapshot mypool/var/tmp\n" -"AME USED AVAIL REFER MOUNTPOINT\n" -"mypool/var/tmp@my_recursive_snapshot 88K - 152K -\n" -"mypool/var/tmp@after_cp 53.5K - 118K -\n" -"mypool/var/tmp@diff_snapshot 0 - 120K -\n" -"# zfs rollback mypool/var/tmp@my_recursive_snapshot\n" -"cannot rollback to 'mypool/var/tmp@my_recursive_snapshot': more recent snapshots exist\n" -"use '-r' to force deletion of the following snapshots:\n" -"mypool/var/tmp@after_cp\n" -"mypool/var/tmp@diff_snapshot\n" -msgstr "" -"# zfs list -rt snapshot mypool/var/tmp\n" -"AME USED AVAIL REFER MOUNTPOINT\n" -"mypool/var/tmp@my_recursive_snapshot 88K - 152K -\n" -"mypool/var/tmp@after_cp 53.5K - 118K -\n" -"mypool/var/tmp@diff_snapshot 0 - 120K -\n" -"# zfs rollback mypool/var/tmp@my_recursive_snapshot\n" -"cannot rollback to 'mypool/var/tmp@my_recursive_snapshot': more recent snapshots exist\n" -"use '-r' to force deletion of the following snapshots:\n" -"mypool/var/tmp@after_cp\n" -"mypool/var/tmp@diff_snapshot\n" +msgid "# zfs set groupquota@firstgroup=50G storage/home\n" +msgstr "# zfs set groupquota@firstgroup=50G storage/home\n" #. type: Plain text -#: documentation/content/en/books/handbook/zfs/_index.adoc:1983 +#: documentation/content/en/books/handbook/zfs/_index.adoc:3260 msgid "" -"This warning means that snapshots exist between the current state of the " -"dataset and the snapshot to which the user wants to roll back. To complete " -"the rollback delete these snapshots. ZFS cannot track all the changes " -"between different states of the dataset, because snapshots are read-only. " -"ZFS will not delete the affected snapshots unless the user specifies `-r` to " -"confirm that this is the desired action. If that is the intention, and " -"understanding the consequences of losing all intermediate snapshots, issue " -"the command:" +"To remove the quota for the group _firstgroup_, or to make sure that one is " +"not set, instead use:" msgstr "" -"Это предупреждение означает, что между текущим состоянием набора данных и " -"снимком, к которому пользователь хочет выполнить откат, существуют другие " -"снимки. Для завершения отката удалите эти снимки. ZFS не может отслеживать " -"все изменения между различными состояниями набора данных, поскольку снимки " -"доступны только для чтения. ZFS не удалит затронутые снимки, если " -"пользователь явно не укажет параметр `-r`, подтверждая, что это желаемое " -"действие. Если это действительно требуется, и вы осознаёте последствия " -"потери всех промежуточных снимков, выполните команду:" +"Чтобы удалить квоту для группы _firstgroup_ или убедиться, что она не " +"установлена, используйте вместо этого:" #. type: delimited block . 4 -#: documentation/content/en/books/handbook/zfs/_index.adoc:1992 +#: documentation/content/en/books/handbook/zfs/_index.adoc:3264 #, no-wrap +msgid "# zfs set groupquota@firstgroup=none storage/home\n" +msgstr "# zfs set groupquota@firstgroup=none storage/home\n" + +#. type: Plain text +#: documentation/content/en/books/handbook/zfs/_index.adoc:3268 msgid "" -"# zfs rollback -r mypool/var/tmp@my_recursive_snapshot\n" -"# zfs list -rt snapshot mypool/var/tmp\n" -"NAME USED AVAIL REFER MOUNTPOINT\n" -"mypool/var/tmp@my_recursive_snapshot 8K - 152K -\n" -"# ls /var/tmp\n" -"vi.recover\n" +"As with the user quota property, non-`root` users can see the quotas " +"associated with the groups to which they belong. A user with the " +"`groupquota` privilege or `root` can view and set all quotas for all groups." msgstr "" -"# zfs rollback -r mypool/var/tmp@my_recursive_snapshot\n" -"# zfs list -rt snapshot mypool/var/tmp\n" -"NAME USED AVAIL REFER MOUNTPOINT\n" -"mypool/var/tmp@my_recursive_snapshot 8K - 152K -\n" -"# ls /var/tmp\n" -"vi.recover\n" +"Как и в случае с пользовательскими квотами, пользователи без прав `root` " +"могут видеть квоты, связанные с группами, к которым они принадлежат. " +"Пользователь с привилегией `groupquota` или `root` может просматривать и " +"устанавливать квоты для всех групп." #. type: Plain text -#: documentation/content/en/books/handbook/zfs/_index.adoc:1995 +#: documentation/content/en/books/handbook/zfs/_index.adoc:3272 msgid "" -"The output from `zfs list -t snapshot` confirms the removal of the " -"intermediate snapshots as a result of `zfs rollback -r`." +"To display the amount of space used by each user on a file system or " +"snapshot along with any quotas, use `zfs userspace`. For group information, " +"use `zfs groupspace`. For more information about supported options or how " +"to display specific options alone, refer to man:zfs-userspace[8]." msgstr "" -"Вывод команды `zfs list -t snapshot` подтверждает удаление промежуточных " -"снимков в результате выполнения `zfs rollback -r`." - -#. type: Title ==== -#: documentation/content/en/books/handbook/zfs/_index.adoc:1997 -#, no-wrap -msgid "Restoring Individual Files from Snapshots" -msgstr "Восстановление отдельных файлов из снимков" +"Для отображения объёма пространства, используемого каждым пользователем в " +"файловой системе или снимке, вместе с квотами, используйте `zfs userspace`. " +"Для информации о группах используйте `zfs groupspace`. Подробнее о " +"поддерживаемых опциях или о том, как отобразить только определённые опции, " +"см. в man:zfs-userspace[8]." #. type: Plain text -#: documentation/content/en/books/handbook/zfs/_index.adoc:2004 +#: documentation/content/en/books/handbook/zfs/_index.adoc:3274 msgid "" -"Snapshots live in a hidden directory under the parent dataset: [.filename]#." -"zfs/snapshots/snapshotname#. By default, these directories will not show " -"even when executing a standard `ls -a` . Although the directory doesn't " -"show, access it like any normal directory. The property named `snapdir` " -"controls whether these hidden directories show up in a directory listing. " -"Setting the property to `visible` allows them to appear in the output of " -"`ls` and other commands that deal with directory contents." +"Privileged users and `root` can list the quota for [.filename]#storage/home/" +"bob# using:" msgstr "" -"Снимки хранятся в скрытом каталоге родительского набора данных: [.filename]#." -"zfs/snapshots/имя_снимка#. По умолчанию эти каталоги не отображаются даже " -"при выполнении стандартной команды `ls -a`. Несмотря на то, что каталог не " -"виден, доступ к нему осуществляется как к обычному каталогу. Свойство " -"`snapdir` определяет, будут ли эти скрытые каталоги отображаться в списке " -"содержимого каталога. Установка свойства в значение `visible` позволяет им " -"появляться в выводе команды `ls` и других команд, работающих с содержимым " -"каталогов." +"Привилегированные пользователи и `root` могут просмотреть квоту для [." +"filename]#storage/home/bob#, используя:" #. type: delimited block . 4 -#: documentation/content/en/books/handbook/zfs/_index.adoc:2015 +#: documentation/content/en/books/handbook/zfs/_index.adoc:3278 #, no-wrap -msgid "" -"# zfs get snapdir mypool/var/tmp\n" -"NAME PROPERTY VALUE SOURCE\n" -"mypool/var/tmp snapdir hidden default\n" -"# ls -a /var/tmp\n" -". .. passwd vi.recover\n" -"# zfs set snapdir=visible mypool/var/tmp\n" -"# ls -a /var/tmp\n" -". .. .zfs passwd vi.recover\n" -msgstr "" -"# zfs get snapdir mypool/var/tmp\n" -"NAME PROPERTY VALUE SOURCE\n" -"mypool/var/tmp snapdir hidden default\n" -"# ls -a /var/tmp\n" -". .. passwd vi.recover\n" -"# zfs set snapdir=visible mypool/var/tmp\n" -"# ls -a /var/tmp\n" -". .. .zfs passwd vi.recover\n" +msgid "# zfs get quota storage/home/bob\n" +msgstr "# zfs get quota storage/home/bob\n" + +#. type: Title ==== +#: documentation/content/en/books/handbook/zfs/_index.adoc:3281 +#, no-wrap +msgid "Project Quotas" +msgstr "Проектные квоты" #. type: Plain text -#: documentation/content/en/books/handbook/zfs/_index.adoc:2020 +#: documentation/content/en/books/handbook/zfs/_index.adoc:3286 msgid "" -"Restore individual files to a previous state by copying them from the " -"snapshot back to the parent dataset. The directory structure below [." -"filename]#.zfs/snapshot# has a directory named like the snapshots taken " -"earlier to make it easier to identify them. The next example shows how to " -"restore a file from the hidden [.filename]#.zfs# directory by copying it " -"from the snapshot containing the latest version of the file:" +"Dataset and user quotas do not fit every layout. When several directory " +"trees belonging to different projects share a single dataset, project quotas " +"restrict the space consumed by each tree instead. A project is an arbitrary " +"numeric identifier tagged onto files and directories." msgstr "" -"Восстановите отдельные файлы в предыдущее состояние, скопировав их из снимка " -"обратно в родительский набор данных. Структура каталогов в [.filename]#.zfs/" -"snapshot# содержит каталоги с именами, соответствующими ранее созданным " -"снимкам, что упрощает их идентификацию. В следующем примере показано, как " -"восстановить файл из скрытого каталога [.filename]#.zfs#, скопировав его из " -"снимка, содержащего последнюю версию файла:" +"Квоты наборов данных и пользователей подходят не для любой структуры. Когда " +"несколько деревьев каталогов, принадлежащих разным проектам, используют один " +"набор данных, квоты проектов ограничивают пространство, потребляемое каждым " +"деревом, вместо этого. Проект — это произвольный числовой идентификатор, " +"присваиваемый файлам и каталогам." + +#. type: Plain text +#: documentation/content/en/books/handbook/zfs/_index.adoc:3290 +msgid "" +"`zfs project` manages the project ID of files and directories. Setting the " +"project inherit flag on a directory makes new files and subdirectories " +"created inside it inherit its project ID. To assign project ID _42_ to an " +"existing tree, set the flag and the ID recursively:" +msgstr "" +"`zfs project` управляет идентификатором проекта файлов и каталогов. " +"Установка флага наследования проекта на каталог приводит к тому, что новые " +"файлы и подкаталоги, созданные внутри него, наследуют его идентификатор " +"проекта. Чтобы назначить идентификатор проекта _42_ существующему дереву, " +"рекурсивно установите флаг и идентификатор:" #. type: delimited block . 4 -#: documentation/content/en/books/handbook/zfs/_index.adoc:2031 +#: documentation/content/en/books/handbook/zfs/_index.adoc:3294 #, no-wrap +msgid "# zfs project -s -p 42 -r /storage/proj\n" +msgstr "# zfs project -s -p 42 -r /storage/proj\n" + +#. type: Plain text +#: documentation/content/en/books/handbook/zfs/_index.adoc:3297 msgid "" -"# rm /var/tmp/passwd\n" -"# ls -a /var/tmp\n" -". .. .zfs vi.recover\n" -"# ls /var/tmp/.zfs/snapshot\n" -"after_cp my_recursive_snapshot\n" -"# ls /var/tmp/.zfs/snapshot/after_cp\n" -"passwd vi.recover\n" -"# cp /var/tmp/.zfs/snapshot/after_cp/passwd /var/tmp\n" +"Enforce a limit of 100 GB on all files belonging to project _42_ with the " +"`projectquota` property:" msgstr "" -"# rm /var/tmp/passwd\n" -"# ls -a /var/tmp\n" -". .. .zfs vi.recover\n" -"# ls /var/tmp/.zfs/snapshot\n" -"after_cp my_recursive_snapshot\n" -"# ls /var/tmp/.zfs/snapshot/after_cp\n" -"passwd vi.recover\n" -"# cp /var/tmp/.zfs/snapshot/after_cp/passwd /var/tmp\n" +"Наложить ограничение в 100 ГБ на все файлы, принадлежащие проекту _42_, с " +"помощью свойства `projectquota`:" + +#. type: delimited block . 4 +#: documentation/content/en/books/handbook/zfs/_index.adoc:3301 +#, no-wrap +msgid "# zfs set projectquota@42=100G storage\n" +msgstr "# zfs set projectquota@42=100G storage\n" #. type: Plain text -#: documentation/content/en/books/handbook/zfs/_index.adoc:2038 +#: documentation/content/en/books/handbook/zfs/_index.adoc:3304 msgid "" -"Even if the `snapdir` property is set to hidden, running `ls .zfs/snapshot` " -"will still list the contents of that directory. The administrator decides " -"whether to display these directories. This is a per-dataset setting. " -"Copying files or directories from this hidden [.filename]#.zfs/snapshot# is " -"simple enough. Trying it the other way around results in this error:" +"`zfs projectspace` displays the space consumed by each project on a dataset " +"along with any quotas:" msgstr "" -"Даже если свойство `snapdir` установлено в hidden, выполнение команды `ls ." -"zfs/snapshot` всё равно покажет содержимое этого каталога. Администратор " -"решает, отображать ли эти каталоги. Это настройка для каждого набора данных. " -"Копирование файлов или каталогов из скрытого [.filename]#.zfs/snapshot# " -"достаточно просто. Попытка сделать наоборот приведёт к такой ошибке:" +"`zfs projectspace` отображает пространство, потребляемое каждым проектом на " +"наборе данных, а также любые квоты:" #. type: delimited block . 4 -#: documentation/content/en/books/handbook/zfs/_index.adoc:2043 +#: documentation/content/en/books/handbook/zfs/_index.adoc:3310 #, no-wrap msgid "" -"# cp /etc/rc.conf /var/tmp/.zfs/snapshot/after_cp/\n" -"cp: /var/tmp/.zfs/snapshot/after_cp/rc.conf: Read-only file system\n" +"# zfs projectspace -o name,used,quota storage\n" +"NAME USED QUOTA\n" +"42 1.95G 100G\n" msgstr "" -"# cp /etc/rc.conf /var/tmp/.zfs/snapshot/after_cp/\n" -"cp: /var/tmp/.zfs/snapshot/after_cp/rc.conf: Read-only file system\n" +"# zfs projectspace -o name,used,quota storage\n" +"NAME USED QUOTA\n" +"42 1.95G 100G\n" #. type: Plain text -#: documentation/content/en/books/handbook/zfs/_index.adoc:2047 +#: documentation/content/en/books/handbook/zfs/_index.adoc:3315 msgid "" -"The error reminds the user that snapshots are read-only and cannot change " -"after creation. Copying files into and removing them from snapshot " -"directories are both disallowed because that would change the state of the " -"dataset they represent." +"The `projectobjquota` property limits the number of objects a project may " +"own in the same way. Display or clear the project ID of a directory with " +"`zfs project -d` and `zfs project -C`. Refer to man:zfs-project[8] and man:" +"zfsprops[7] for details." msgstr "" -"Ошибка напоминает пользователю, что снимки доступны только для чтения и не " -"могут изменяться после создания. Копирование файлов в каталоги снимков и их " -"удаление оттуда запрещены, так как это изменило бы состояние набора данных, " -"который они представляют." +"Свойство `projectobjquota` ограничивает количество объектов, которыми может " +"владеть проект, аналогичным образом. Отобразите или очистите идентификатор " +"проекта для каталога с помощью `zfs project -d` и `zfs project -C`. " +"Подробности см. в man:zfs-project[8] и man:zfsprops[7]." + +#. type: Title === +#: documentation/content/en/books/handbook/zfs/_index.adoc:3317 +#, no-wrap +msgid "Reservations" +msgstr "Резервирования" #. type: Plain text -#: documentation/content/en/books/handbook/zfs/_index.adoc:2050 +#: documentation/content/en/books/handbook/zfs/_index.adoc:3322 msgid "" -"Snapshots consume space based on how much the parent file system has changed " -"since the time of the snapshot. The `written` property of a snapshot tracks " -"the space the snapshot uses." +"crossref:zfs[zfs-term-reservation,Reservations] guarantee an always-" +"available amount of space on a dataset. The reserved space will not be " +"available to any other dataset. This useful feature ensures that free space " +"is available for an important dataset or log files." msgstr "" -"Снимки занимают место в зависимости от того, насколько родительская файловая " -"система изменилась с момента создания снимка. Свойство `written` снимка " -"отслеживает используемое им пространство." +"crossref:zfs[zfs-term-reservation,Резервирования] гарантируют всегда " +"доступный объём пространства в наборе данных. Зарезервированное пространство " +"не будет доступно для других наборов данных. Эта полезная функция " +"обеспечивает наличие свободного места для важных наборов данных или файлов " +"журналов." #. type: Plain text -#: documentation/content/en/books/handbook/zfs/_index.adoc:2054 +#: documentation/content/en/books/handbook/zfs/_index.adoc:3324 msgid "" -"To destroy snapshots and reclaim the space, use `zfs destroy " -"_dataset_@_snapshot_`. Adding `-r` recursively removes all snapshots with " -"the same name under the parent dataset. Adding `-n -v` to the command " -"displays a list of the snapshots to be deleted and an estimate of the space " -"it would reclaim without performing the actual destroy operation." +"The general format of the `reservation` property is `reservation=_size_`, so " +"to set a reservation of 10 GB on [.filename]#storage/home/bob#, use:" msgstr "" -"Для удаления снимков и освобождения пространства используйте `zfs destroy " -"_набор_данных_@_снимок_`. Добавление `-r` рекурсивно удаляет все снимки с " -"таким же именем в родительском наборе данных. Добавление `-n -v` к команде " -"выводит список снимков, которые будут удалены, и оценку освобождаемого " -"пространства без фактического выполнения операции удаления." +"Общий формат свойства `reservation` — `reservation=_размер_`, поэтому, чтобы " +"установить резервирование в 10 ГБ для [.filename]#storage/home/bob#, " +"используйте:" -#. type: Title === -#: documentation/content/en/books/handbook/zfs/_index.adoc:2056 +#. type: delimited block . 4 +#: documentation/content/en/books/handbook/zfs/_index.adoc:3328 #, no-wrap -msgid "Managing Clones" -msgstr "Управление клонами" +msgid "# zfs set reservation=10G storage/home/bob\n" +msgstr "# zfs set reservation=10G storage/home/bob\n" + +#. type: Plain text +#: documentation/content/en/books/handbook/zfs/_index.adoc:3331 +msgid "To clear any reservation:" +msgstr "Чтобы очистить любое резервирование:" + +#. type: delimited block . 4 +#: documentation/content/en/books/handbook/zfs/_index.adoc:3335 +#, no-wrap +msgid "# zfs set reservation=none storage/home/bob\n" +msgstr "# zfs set reservation=none storage/home/bob\n" #. type: Plain text -#: documentation/content/en/books/handbook/zfs/_index.adoc:2065 +#: documentation/content/en/books/handbook/zfs/_index.adoc:3338 msgid "" -"A clone is a copy of a snapshot treated more like a regular dataset. Unlike " -"a snapshot, a clone is writeable and mountable, and has its own properties. " -"After creating a clone using `zfs clone`, destroying the originating " -"snapshot is impossible. To reverse the child/parent relationship between " -"the clone and the snapshot use `zfs promote`. Promoting a clone makes the " -"snapshot become a child of the clone, rather than of the original parent " -"dataset. This will change how ZFS accounts for the space, but not actually " -"change the amount of space consumed. Mounting the clone anywhere within the " -"ZFS file system hierarchy is possible, not only below the original location " -"of the snapshot." +"The same principle applies to the `refreservation` property for setting a " +"crossref:zfs[zfs-term-refreservation,Reference Reservation], with the " +"general format `refreservation=_size_`." msgstr "" -"Клон — это копия снимка, которая рассматривается как обычный набор данных. В " -"отличие от снимка, клон доступен для записи, может быть смонтирован и имеет " -"свои собственные свойства. После создания клона с помощью команды `zfs " -"clone` уничтожение исходного снимка становится невозможным. Чтобы изменить " -"отношение «родитель-потомок» между клоном и снимком, используйте команду " -"`zfs promote`. Продвижение клона делает снимок потомком клона, а не " -"исходного родительского набора данных. Это изменит способ учёта пространства " -"в ZFS, но не повлияет на фактически используемый объём. Клон можно " -"смонтировать в любом месте иерархии файловой системы ZFS, а не только ниже " -"исходного расположения снимка." +"Тот же принцип применяется к свойству `refreservation` для установки " +"crossref:zfs[zfs-term-refreservation,Референсного резервирования], с общим " +"форматом `refreservation=_размер_`." #. type: Plain text -#: documentation/content/en/books/handbook/zfs/_index.adoc:2067 -msgid "To show the clone feature use this example dataset:" +#: documentation/content/en/books/handbook/zfs/_index.adoc:3340 +msgid "" +"This command shows any reservations or refreservations that exist on [." +"filename]#storage/home/bob#:" msgstr "" -"Чтобы продемонстрировать функцию клонирования, используйте следующий набора " -"данных в качестве примера:" +"Эта команда показывает все и резервирования (`reservation`), и референсные " +"резервирования (`refreservation`), существующие в [.filename]#storage/home/" +"bob#:" #. type: delimited block . 4 -#: documentation/content/en/books/handbook/zfs/_index.adoc:2075 +#: documentation/content/en/books/handbook/zfs/_index.adoc:3345 #, no-wrap msgid "" -"# zfs list -rt all camino/home/joe\n" -"NAME USED AVAIL REFER MOUNTPOINT\n" -"camino/home/joe 108K 1.3G 87K /usr/home/joe\n" -"camino/home/joe@plans 21K - 85.5K -\n" -"camino/home/joe@backup 0K - 87K -\n" +"# zfs get reservation storage/home/bob\n" +"# zfs get refreservation storage/home/bob\n" msgstr "" -"# zfs list -rt all camino/home/joe\n" -"NAME USED AVAIL REFER MOUNTPOINT\n" -"camino/home/joe 108K 1.3G 87K /usr/home/joe\n" -"camino/home/joe@plans 21K - 85.5K -\n" -"camino/home/joe@backup 0K - 87K -\n" +"# zfs get reservation storage/home/bob\n" +"# zfs get refreservation storage/home/bob\n" + +#. type: Title === +#: documentation/content/en/books/handbook/zfs/_index.adoc:3348 +#, no-wrap +msgid "Compression" +msgstr "Сжатие" #. type: Plain text -#: documentation/content/en/books/handbook/zfs/_index.adoc:2081 +#: documentation/content/en/books/handbook/zfs/_index.adoc:3354 msgid "" -"A typical use for clones is to experiment with a specific dataset while " -"keeping the snapshot around to fall back to in case something goes wrong. " -"Since snapshots cannot change, create a read/write clone of a snapshot. " -"After achieving the desired result in the clone, promote the clone to a " -"dataset and remove the old file system. Removing the parent dataset is not " -"strictly necessary, as the clone and dataset can coexist without problems." +"ZFS provides transparent compression. Compressing data written at the block " +"level saves space and also increases disk throughput. If data compresses by " +"25% the compressed data writes to the disk at the same rate as the " +"uncompressed version, resulting in an effective write speed of 125%. " +"Compression can also be a great alternative to crossref:zfs[zfs-zfs-" +"deduplication,Deduplication] because it does not require extra memory." msgstr "" -"Типичное применение клонов — эксперименты с определённым набором данных, при " -"этом снимок остаётся в качестве резервной копии на случай возникновения " -"проблем. Поскольку снимки нельзя изменить, создаётся доступный для чтения и " -"записи клон снимка. После достижения нужного результата в клоне, клон " -"повышается до набора данных, а старая файловая система удаляется. Удаление " -"родительского набора данных не является обязательным, так как клон и набор " -"данных могут без проблем сосуществовать." +"ZFS предоставляет прозрачное сжатие. Сжатие данных на уровне блоков экономит " +"место и увеличивает пропускную способность диска. Если данные сжимаются на " +"25%, то сжатые данные записываются на диск с той же скоростью, что и " +"несжатые, что приводит к эффективной скорости записи в 125%. Сжатие также " +"может быть отличной альтернативой crossref:zfs[zfs-zfs-deduplication," +"Дедупликации], так как не требует дополнительной памяти." + +#. type: Plain text +#: documentation/content/en/books/handbook/zfs/_index.adoc:3362 +msgid "" +"ZFS offers different compression algorithms, each with different trade-" +"offs. On OpenZFS 2.2 and later, newly created pools and datasets default to " +"`compression=on`, which selects LZ4. LZ4 compresses the entire pool without " +"the large performance trade-off of other algorithms. The biggest advantage " +"to LZ4 is the _early abort_ feature. If LZ4 does not achieve at least 12.5% " +"compression in the header part of the data, ZFS writes the block " +"uncompressed to avoid wasting CPU cycles trying to compress data that is " +"either already compressed or uncompressible. Changing the `compression` " +"property affects new writes only; existing data keeps its old encoding until " +"rewritten (see crossref:zfs[zfs-zfs-rewrite,Rewriting Existing Data]). For " +"details about the different compression algorithms available in ZFS, see the " +"crossref:zfs[zfs-term-compression,Compression] entry in the terminology " +"section." +msgstr "" +"ZFS предлагает различные алгоритмы сжатия, каждый со своими компромиссами. В " +"OpenZFS 2.2 и новее для вновь создаваемых пулов и наборов данных по " +"умолчанию установлено значение `compression=on`, которое выбирает алгоритм " +"LZ4. Сжатие LZ4 позволяет сжимать весь пул без значительного снижения " +"производительности, характерного для других алгоритмов. Главное преимущество " +"LZ4 — функция _раннего прерывания_. Если LZ4 не достигает как минимум 12,5% " +"сжатия в заголовочной части данных, ZFS записывает блок без сжатия, чтобы " +"избежать потерь процессорного времени на попытки сжать уже сжатые или " +"несжимаемые данные. Изменение свойства `compression` влияет только на новые " +"записи; существующие данные сохраняют свою старую кодировку до тех пор, пока " +"не будут перезаписаны (см. crossref:zfs[zfs-zfs-rewrite,«Перезапись " +"существующих данных»]). Подробнее о различных алгоритмах сжатия, доступных в " +"ZFS, см. в разделе crossref:zfs[zfs-term-compression,Сжатие] терминологии." + +#. type: Plain text +#: documentation/content/en/books/handbook/zfs/_index.adoc:3364 +msgid "" +"The administrator can see the effectiveness of compression using dataset " +"properties." +msgstr "" +"Администратор может оценить эффективность сжатия, используя свойства набора " +"данных." #. type: delimited block . 4 -#: documentation/content/en/books/handbook/zfs/_index.adoc:2088 +#: documentation/content/en/books/handbook/zfs/_index.adoc:3373 #, no-wrap msgid "" -"# zfs clone camino/home/joe@backup camino/home/joenew\n" -"# ls /usr/home/joe*\n" -"/usr/home/joe:\n" -"backup.txz plans.txt\n" +"# zfs get used,compressratio,compression,logicalused mypool/compressed_dataset\n" +"NAME PROPERTY VALUE SOURCE\n" +"mypool/compressed_dataset used 449G -\n" +"mypool/compressed_dataset compressratio 1.11x -\n" +"mypool/compressed_dataset compression lz4 local\n" +"mypool/compressed_dataset logicalused 496G -\n" msgstr "" -"# zfs clone camino/home/joe@backup camino/home/joenew\n" -"# ls /usr/home/joe*\n" -"/usr/home/joe:\n" -"backup.txz plans.txt\n" +"# zfs get used,compressratio,compression,logicalused mypool/" +"compressed_dataset\n" +"NAME PROPERTY VALUE SOURCE\n" +"mypool/compressed_dataset used 449G -\n" +"mypool/compressed_dataset compressratio 1.11x -\n" +"mypool/compressed_dataset compression lz4 local\n" +"mypool/compressed_dataset logicalused 496G -\n" + +#. type: Plain text +#: documentation/content/en/books/handbook/zfs/_index.adoc:3378 +msgid "" +"The dataset is using 449 GB of space (the used property). Without " +"compression, it would have taken 496 GB of space (the `logicalused` " +"property). This results in a 1.11:1 compression ratio." +msgstr "" +"Набор данных использует 449 ГБ пространства (свойство `used`). Без сжатия он " +"занял бы 496 ГБ пространства (свойство `logicalused`). Это даёт коэффициент " +"сжатия 1.11:1." + +#. type: Plain text +#: documentation/content/en/books/handbook/zfs/_index.adoc:3384 +msgid "" +"Compression can have an unexpected side effect when combined with crossref:" +"zfs[zfs-term-userquota,User Quotas]. User quotas restrict how much actual " +"space a user consumes on a dataset _after compression_. If a user has a " +"quota of 10 GB, and writes 10 GB of compressible data, they will still be " +"able to store more data. If they later update a file, say a database, with " +"more or less compressible data, the amount of space available to them will " +"change. This can result in the odd situation where a user did not increase " +"the actual amount of data (the `logicalused` property), but the change in " +"compression caused them to reach their quota limit." +msgstr "" +"Сжатие может иметь неожиданный побочный эффект при использовании вместе с " +"crossref:zfs[zfs-term-userquota,Квотами пользователей]. Квоты пользователей " +"ограничивают фактическое пространство, которое пользователь занимает на " +"наборе данных _после сжатия_. Если у пользователя есть квота в 10 ГБ, и он " +"записывает 10 ГБ сжимаемых данных, он всё равно сможет сохранить больше " +"данных. Если позже пользователь обновит файл, например базу данных, более " +"или менее сжимаемыми данными, количество доступного ему пространства " +"изменится. Это может привести к необычной ситуации, когда пользователь не " +"увеличил фактический объём данных (свойство `logicalused`), но изменение " +"степени сжатия привело к достижению предела его квоты." + +#. type: Plain text +#: documentation/content/en/books/handbook/zfs/_index.adoc:3388 +msgid "" +"Compression can have a similar unexpected interaction with backups. Quotas " +"are often used to limit data storage to ensure there is enough backup space " +"available. Since quotas do not consider compression ZFS may write more data " +"than would fit with uncompressed backups." +msgstr "" +"Сжатие может иметь схожий непредвиденный эффект при взаимодействии с " +"резервными копиями. Квоты часто используются для ограничения хранимых " +"данных, чтобы гарантировать наличие достаточного места для резервного " +"копирования. Поскольку квоты не учитывают сжатие, ZFS может записать больше " +"данных, чем поместилось бы при резервном копировании без сжатия." -#. type: delimited block . 4 -#: documentation/content/en/books/handbook/zfs/_index.adoc:2095 +#. type: Title === +#: documentation/content/en/books/handbook/zfs/_index.adoc:3390 #, no-wrap -msgid "" -"/usr/home/joenew:\n" -"backup.txz plans.txt\n" -"# df -h /usr/home\n" -"Filesystem Size Used Avail Capacity Mounted on\n" -"usr/home/joe 1.3G 31k 1.3G 0% /usr/home/joe\n" -"usr/home/joenew 1.3G 31k 1.3G 0% /usr/home/joenew\n" -msgstr "" -"/usr/home/joenew:\n" -"backup.txz plans.txt\n" -"# df -h /usr/home\n" -"Filesystem Size Used Avail Capacity Mounted on\n" -"usr/home/joe 1.3G 31k 1.3G 0% /usr/home/joe\n" -"usr/home/joenew 1.3G 31k 1.3G 0% /usr/home/joenew\n" +msgid "Zstandard Compression" +msgstr "Сжатие алгоритмом Zstandard" #. type: Plain text -#: documentation/content/en/books/handbook/zfs/_index.adoc:2104 +#: documentation/content/en/books/handbook/zfs/_index.adoc:3394 msgid "" -"Creating a clone makes it an exact copy of the state the dataset was in when " -"taking the snapshot. Changing the clone independently from its originating " -"dataset is possible now. The connection between the two is the snapshot. " -"ZFS records this connection in the property `origin`. Promoting the clone " -"with `zfs promote` makes the clone an independent dataset. This removes the " -"value of the `origin` property and disconnects the newly independent dataset " -"from the snapshot. This example shows it:" +"OpenZFS 2.0 added the Zstandard (Zstd) compression algorithm. Zstd offers " +"higher compression ratios than the default LZ4 while offering much greater " +"speeds than the alternative, gzip." msgstr "" -"Создание клона делает его точной копией состояния набора данных на момент " -"создания снимка. Теперь можно изменять клон независимо от исходного набора " -"данных. Связь между ними осуществляется через снимок. ZFS записывает эту " -"связь в свойстве `origin`. Повышение клона с помощью `zfs promote` делает " -"клон независимым набором данных. Это удаляет значение свойства `origin` и " -"отключает новый независимый набор данных от снимка. Вот пример:" +"В OpenZFS 2.0 был добавлен алгоритм сжатия Zstandard (Zstd). Zstd " +"обеспечивает более высокие коэффициенты сжатия по сравнению с используемым " +"по умолчанию LZ4, при этом работая значительно быстрее альтернативного gzip." -#. type: delimited block . 4 -#: documentation/content/en/books/handbook/zfs/_index.adoc:2114 -#, no-wrap +#. type: Plain text +#: documentation/content/en/books/handbook/zfs/_index.adoc:3398 msgid "" -"# zfs get origin camino/home/joenew\n" -"NAME PROPERTY VALUE SOURCE\n" -"camino/home/joenew origin camino/home/joe@backup -\n" -"# zfs promote camino/home/joenew\n" -"# zfs get origin camino/home/joenew\n" -"NAME PROPERTY VALUE SOURCE\n" -"camino/home/joenew origin - -\n" +"Zstd provides a large selection of compression levels, providing fine-" +"grained control over performance versus compression ratio. One of the main " +"advantages of Zstd is that the decompression speed is independent of the " +"compression level. For data written once but read often, Zstd allows the " +"use of the highest compression levels without a read performance penalty." msgstr "" -"# zfs get origin camino/home/joenew\n" -"NAME PROPERTY VALUE SOURCE\n" -"camino/home/joenew origin camino/home/joe@backup -\n" -"# zfs promote camino/home/joenew\n" -"# zfs get origin camino/home/joenew\n" -"NAME PROPERTY VALUE SOURCE\n" -"camino/home/joenew origin - -\n" +"Zstd предоставляет широкий выбор уровней сжатия, обеспечивая детальный " +"контроль над производительностью и степенью сжатия. Одним из основных " +"преимуществ Zstd является то, что скорость распаковки не зависит от уровня " +"сжатия. Для данных, которые записываются один раз, но часто читаются, Zstd " +"позволяет использовать максимальные уровни сжатия без потери " +"производительности при чтении." #. type: Plain text -#: documentation/content/en/books/handbook/zfs/_index.adoc:2119 +#: documentation/content/en/books/handbook/zfs/_index.adoc:3403 msgid "" -"After making some changes like copying [.filename]#loader.conf# to the " -"promoted clone, for example, the old directory becomes obsolete in this " -"case. Instead, the promoted clone can replace it. To do this, `zfs " -"destroy` the old dataset first and then `zfs rename` the clone to the old " -"dataset name (or to an entirely different name)." +"Even with frequent data updates, enabling compression often provides higher " +"performance. One of the biggest advantages comes from the compressed ARC " +"feature. ZFS's Adaptive Replacement Cache (ARC) caches the compressed " +"version of the data in RAM, decompressing it each time. This allows the " +"same amount of RAM to store more data and metadata, increasing the cache hit " +"ratio." msgstr "" -"После внесения изменений, таких как копирование [.filename]#loader.conf# в " -"продвинутую клон-копию, например, старый каталог в этом случае становится " -"устаревшим. Вместо него продвинутая клон-копия может его заменить. Для этого " -"сначала выполните `zfs destroy` для старого набора данных, а затем `zfs " -"rename` для клона, указав имя старого набора данных (или совершенно другое " -"имя)." +"Даже при частом обновлении данных включение сжатия часто обеспечивает более " +"высокую производительность. Одно из главных преимуществ связано с функцией " +"сжатого ARC. Адаптивный кэш замещения (ARC Adaptive Replacement Cache) в ZFS " +"хранит сжатую версию данных в оперативной памяти, распаковывая их при каждом " +"обращении. Это позволяет хранить больше данных и метаданных в том же объёме " +"памяти, повышая коэффициент попадания в кэш." -#. type: delimited block . 4 -#: documentation/content/en/books/handbook/zfs/_index.adoc:2130 -#, no-wrap +#. type: Plain text +#: documentation/content/en/books/handbook/zfs/_index.adoc:3409 msgid "" -"# cp /boot/defaults/loader.conf /usr/home/joenew\n" -"# zfs destroy -f camino/home/joe\n" -"# zfs rename camino/home/joenew camino/home/joe\n" -"# ls /usr/home/joe\n" -"backup.txz loader.conf plans.txt\n" -"# df -h /usr/home\n" -"Filesystem Size Used Avail Capacity Mounted on\n" -"usr/home/joe 1.3G 128k 1.3G 0% /usr/home/joe\n" +"ZFS offers 19 levels of Zstd compression, each offering incrementally more " +"space savings in exchange for slower compression. The default level is " +"`zstd-3` and offers greater compression than LZ4 without being much slower. " +"Levels above 10 require large amounts of memory to compress each block and " +"systems with less than 16 GB of RAM should not use them. ZFS uses a " +"selection of the Zstd _fast_ levels also, which get correspondingly faster " +"but support lower compression ratios. ZFS supports `zstd-fast-1` through " +"`zstd-fast-10`, `zstd-fast-20` through `zstd-fast-100` in increments of 10, " +"and `zstd-fast-500` and `zstd-fast-1000` which provide minimal compression, " +"but offer high performance." msgstr "" -"# cp /boot/defaults/loader.conf /usr/home/joenew\n" -"# zfs destroy -f camino/home/joe\n" -"# zfs rename camino/home/joenew camino/home/joe\n" -"# ls /usr/home/joe\n" -"backup.txz loader.conf plans.txt\n" -"# df -h /usr/home\n" -"Filesystem Size Used Avail Capacity Mounted on\n" -"usr/home/joe 1.3G 128k 1.3G 0% /usr/home/joe\n" +"ZFS предлагает 19 уровней сжатия Zstd, каждый из которых обеспечивает " +"постепенное увеличение экономии места в обмен на более медленное сжатие. " +"Уровень по умолчанию — `zstd-3`, который обеспечивает лучшее сжатие, чем " +"LZ4, без значительного снижения скорости. Уровни выше 10 требуют большого " +"объёма памяти для сжатия каждого блока, и системы с менее чем 16 ГБ ОЗУ не " +"должны их использовать. ZFS также использует подмножество уровней Zstd " +"_fast_, которые работают быстрее, но обеспечивают меньшую степень сжатия. " +"ZFS поддерживает уровни от `zstd-fast-1` до `zstd-fast-10`, от `zstd-fast-20`" +" до `zstd-fast-100` с шагом 10, а также `zstd-fast-500` и `zstd-fast-1000`, " +"которые обеспечивают минимальное сжатие, но обладают высокой " +"производительностью." #. type: Plain text -#: documentation/content/en/books/handbook/zfs/_index.adoc:2139 +#: documentation/content/en/books/handbook/zfs/_index.adoc:3413 msgid "" -"The cloned snapshot is now an ordinary dataset. It contains all the data " -"from the original snapshot plus the files added to it like [." -"filename]#loader.conf#. Clones provide useful features to ZFS users in " -"different scenarios. For example, provide jails as snapshots containing " -"different sets of installed applications. Users can clone these snapshots " -"and add their own applications as they see fit. Once satisfied with the " -"changes, promote the clones to full datasets and provide them to end users " -"to work with like they would with a real dataset. This saves time and " -"administrative overhead when providing these jails." +"If ZFS is not able to get the required memory to compress a block with Zstd, " +"it will fall back to storing the block uncompressed. This is unlikely to " +"happen except at the highest levels of Zstd on memory constrained systems. " +"ZFS counts how often this has occurred since loading the ZFS module with " +"`kstat.zfs.misc.zstd.compress_alloc_fail`." msgstr "" -"Клонированный снимок теперь является обычным набором данных. Он содержит все " -"данные из исходного снимка, а также добавленные файлы, такие как [." -"filename]#loader.conf#. Клоны предоставляют полезные возможности " -"пользователям ZFS в различных сценариях. Например, можно предоставлять " -"клетки в виде снимков с различными наборами установленных приложений. " -"Пользователи могут клонировать эти снимки и добавлять свои собственные " -"приложения по своему усмотрению. После внесения необходимых изменений клоны " -"можно повысить до полноценных наборов данных и предоставить их конечным " -"пользователям для работы, как с обычными наборами данных. Это экономит время " -"и снижает административные затраты при предоставлении таких клеток." +"Если ZFS не может получить необходимую память для сжатия блока с помощью " +"Zstd, он переходит к сохранению блока в несжатом виде. Это маловероятно, за " +"исключением случаев использования максимальных уровней Zstd на системах с " +"ограниченной памятью. ZFS подсчитывает, сколько раз это произошло с момента " +"загрузки модуля ZFS, с помощью `kstat.zfs.misc.zstd.compress_alloc_fail`." #. type: Title === -#: documentation/content/en/books/handbook/zfs/_index.adoc:2141 +#: documentation/content/en/books/handbook/zfs/_index.adoc:3415 #, no-wrap -msgid "Replication" -msgstr "Репликация" +msgid "Rewriting Existing Data" +msgstr "Перезапись существующих данных" + +#. type: delimited block = 4 +#: documentation/content/en/books/handbook/zfs/_index.adoc:3420 +msgid "`zfs rewrite` requires OpenZFS 2.4, first shipped in FreeBSD 15.0." +msgstr "`zfs rewrite` требует OpenZFS 2.4, впервые выпущенный во FreeBSD 15.0." #. type: Plain text -#: documentation/content/en/books/handbook/zfs/_index.adoc:2150 +#: documentation/content/en/books/handbook/zfs/_index.adoc:3425 msgid "" -"Keeping data on a single pool in one location exposes it to risks like theft " -"and natural or human disasters. Making regular backups of the entire pool " -"is vital. ZFS provides a built-in serialization feature that can send a " -"stream representation of the data to standard output. Using this feature, " -"storing this data on another pool connected to the local system is possible, " -"as is sending it over a network to another system. Snapshots are the basis " -"for this replication (see the section on crossref:zfs[zfs-zfs-snapshot,ZFS " -"snapshots]). The commands used for replicating data are `zfs send` and `zfs " -"receive`." +"Properties like `compression`, `checksum`, `dedup`, and `copies` affect " +"newly written data only. Changing them leaves existing blocks stored as " +"they were, and applying the new values traditionally required a send/receive " +"cycle or copying every file back and forth. `zfs rewrite` instead rewrites " +"the blocks of existing files in place, as if they were atomically read and " +"written back, so the current property values take effect without those " +"workarounds." msgstr "" -"Хранение данных в единственном пуле в одном месте подвергает их рискам, " -"таким как кража, стихийные бедствия или действия людей. Регулярное резервное " -"копирование всего пула крайне важно. ZFS предоставляет встроенную функцию " -"сериализации, которая может отправлять потоковое представление данных на " -"стандартный вывод. Используя эту функцию, можно сохранять эти данные в " -"другом пуле, подключенном к локальной системе, или отправлять их по сети на " -"другую систему. Снимки являются основой для этой репликации (см. раздел о " -"crossref:zfs[zfs-zfs-snapshot,снимках ZFS]). Команды, используемые для " -"репликации данных, — это `zfs send` и `zfs receive`." +"Свойства, такие как `compression`, `checksum`, `dedup` и `copies`, влияют " +"только на вновь записываемые данные. Их изменение оставляет существующие " +"блоки сохранёнными как есть, и применение новых значений традиционно " +"требовало цикла отправки/получения или копирования каждого файла туда и " +"обратно. `zfs rewrite` вместо этого перезаписывает блоки существующих файлов " +"на месте, как если бы они были атомарно прочитаны и записаны обратно, " +"поэтому текущие значения свойств вступают в силу без этих обходных путей." #. type: Plain text -#: documentation/content/en/books/handbook/zfs/_index.adoc:2152 -msgid "These examples show ZFS replication with these two pools:" +#: documentation/content/en/books/handbook/zfs/_index.adoc:3428 +msgid "" +"The command operates on files and directories rather than dataset names. To " +"apply a newly chosen compression algorithm to a whole dataset, recurse from " +"its mount point:" msgstr "" -"Эти примеры демонстрируют репликацию ZFS с использованием следующих двух " -"пулов:" +"Команда работает с файлами и каталогами, а не с именами наборов данных. " +"Чтобы применить вновь выбранный алгоритм сжатия ко всему набору данных, " +"выполните рекурсивный обход от его точки монтирования:" #. type: delimited block . 4 -#: documentation/content/en/books/handbook/zfs/_index.adoc:2159 +#: documentation/content/en/books/handbook/zfs/_index.adoc:3433 #, no-wrap msgid "" -"# zpool list\n" -"NAME SIZE ALLOC FREE CKPOINT EXPANDSZ FRAG CAP DEDUP HEALTH ALTROOT\n" -"backup 960M 77K 896M - - 0% 0% 1.00x ONLINE -\n" -"mypool 984M 43.7M 940M - - 0% 4% 1.00x ONLINE -\n" +"# zfs set compression=zstd mypool/archive\n" +"# zfs rewrite -r /mypool/archive\n" msgstr "" -"# zpool list\n" -"NAME SIZE ALLOC FREE CKPOINT EXPANDSZ FRAG CAP DEDUP HEALTH ALTROOT\n" -"backup 960M 77K 896M - - 0% 0% 1.00x ONLINE -\n" -"mypool 984M 43.7M 940M - - 0% 4% 1.00x ONLINE -\n" +"# zfs set compression=zstd mypool/archive\n" +"# zfs rewrite -r /mypool/archive\n" #. type: Plain text -#: documentation/content/en/books/handbook/zfs/_index.adoc:2167 -msgid "" -"The pool named _mypool_ is the primary pool where writing and reading data " -"happens on a regular basis. Using a second standby pool _backup_ in case " -"the primary pool becomes unavailable. Note that this fail-over is not done " -"automatically by ZFS, but must be manually done by a system administrator " -"when needed. Use a snapshot to provide a consistent file system version to " -"replicate. After creating a snapshot of _mypool_, copy it to the _backup_ " -"pool by replicating snapshots. This does not include changes made since the " -"most recent snapshot." -msgstr "" -"Имя пула _mypool_ — это основной пул, в который данные регулярно " -"записываются и откуда они читаются. Используйте второй резервный пул " -"_backup_ на случай, если основной пул станет недоступен. Обратите внимание, " -"что этот переход на резервный пул не выполняется автоматически в ZFS, а " -"должен быть осуществлён вручную системным администратором при необходимости. " -"Используйте снимок (snapshot), чтобы обеспечить согласованную версию " -"файловой системы для репликации. После создания снимка _mypool_ скопируйте " -"его в пул _backup_ путём репликации снимков. Это не включает изменения, " -"сделанные после последнего снимка." - -#. type: delimited block . 4 -#: documentation/content/en/books/handbook/zfs/_index.adoc:2174 -#, no-wrap +#: documentation/content/en/books/handbook/zfs/_index.adoc:3438 msgid "" -"# zfs snapshot mypool@backup1\n" -"# zfs list -t snapshot\n" -"NAME USED AVAIL REFER MOUNTPOINT\n" -"mypool@backup1 0 - 43.6M -\n" +"Adding `-v` prints the name of every rewritten file. `-x` keeps the " +"recursion from crossing mount points into child datasets, and `-o` and `-l` " +"restrict the rewrite to a byte range within a file. Property changes that " +"would alter the logical block size, such as `recordsize`, have no effect on " +"rewritten files." msgstr "" -"# zfs snapshot mypool@backup1\n" -"# zfs list -t snapshot\n" -"NAME USED AVAIL REFER MOUNTPOINT\n" -"mypool@backup1 0 - 43.6M -\n" +"Добавление `-v` выводит имя каждого перезаписанного файла. `-x` " +"предотвращает переход рекурсии через точки монтирования в дочерние наборы " +"данных, а `-o` и `-l` ограничивают перезапись диапазоном байт внутри файла. " +"Изменения свойств, которые могли бы изменить логический размер блока, такие " +"как `recordsize`, не влияют на перезаписанные файлы." #. type: Plain text -#: documentation/content/en/books/handbook/zfs/_index.adoc:2179 +#: documentation/content/en/books/handbook/zfs/_index.adoc:3442 msgid "" -"Now that a snapshot exists, use `zfs send` to create a stream representing " -"the contents of the snapshot. Store this stream as a file or receive it on " -"another pool. Write the stream to standard output, but redirect to a file " -"or pipe or an error appears:" +"Rewritten blocks are new blocks: snapshots taken before the rewrite keep " +"referencing the old copies, so space usage can grow until those snapshots " +"are destroyed. `zfs rewrite` does not work through snapshots for the same " +"reason. Refer to man:zfs-rewrite[8] for details." msgstr "" -"Теперь, когда снимок существует, используйте `zfs send` для создания потока, " -"представляющего содержимое снимка. Сохраните этот поток в файл или примите " -"его в другом пуле. Поток записывается в стандартный вывод, но перенаправьте " -"его в файл или канал, иначе появится ошибка:" +"Переписанные блоки — это новые блоки: снимки, сделанные до перезаписи, " +"продолжают ссылаться на старые копии, поэтому использование дискового " +"пространства может расти, пока эти снимки не будут уничтожены. `zfs rewrite` " +"не работает через снимки по той же причине. Подробности см. в man:zfs-" +"rewrite[8]." -#. type: delimited block . 4 -#: documentation/content/en/books/handbook/zfs/_index.adoc:2185 +#. type: Title === +#: documentation/content/en/books/handbook/zfs/_index.adoc:3444 #, no-wrap -msgid "" -"# zfs send mypool@backup1\n" -"Error: Stream can not be written to a terminal.\n" -"You must redirect standard output.\n" -msgstr "" -"# zfs send mypool@backup1\n" -"Error: Stream can not be written to a terminal.\n" -"You must redirect standard output.\n" +msgid "Deduplication" +msgstr "Дедупликация" #. type: Plain text -#: documentation/content/en/books/handbook/zfs/_index.adoc:2189 +#: documentation/content/en/books/handbook/zfs/_index.adoc:3450 msgid "" -"To back up a dataset with `zfs send`, redirect to a file located on the " -"mounted backup pool. Ensure that the pool has enough free space to " -"accommodate the size of the sent snapshot, which means the data contained in " -"the snapshot, not the changes from the previous snapshot." +"When enabled, crossref:zfs[zfs-term-deduplication,deduplication] uses the " +"checksum of each block to detect duplicate blocks. When a new block is a " +"duplicate of an existing block, ZFS writes a new reference to the existing " +"data instead of the whole duplicate block. Tremendous space savings are " +"possible if the data contains a lot of duplicated files or repeated " +"information. Warning: deduplication requires a large amount of memory, and " +"enabling compression instead provides most of the space savings without the " +"extra cost." +msgstr "" +"Когда включена перекрёстная crossref:zfs[zfs-term-deduplication," +"дедупликация], она использует контрольную сумму каждого блока для " +"обнаружения дублирующихся блоков. Когда новый блок является дубликатом " +"существующего блока, ZFS записывает новую ссылку на существующие данные " +"вместо всего дублирующегося блока. Возможна значительная экономия места, " +"если данные содержат много дублирующихся файлов или повторяющейся " +"информации. Предупреждение: дедупликация требует большого объёма памяти, а " +"включение сжатия обеспечивает большую часть экономии места без " +"дополнительных затрат." + +#. type: Plain text +#: documentation/content/en/books/handbook/zfs/_index.adoc:3453 +msgid "" +"`dedup` is a dataset property, not a pool property. To activate " +"deduplication, set it on a dataset:" msgstr "" -"Для резервного копирования набора данных с помощью `zfs send` перенаправьте " -"вывод в файл, расположенный в подключенном пуле резервных копий. Убедитесь, " -"что в пуле достаточно свободного места для размещения отправленного снимка, " -"то есть для данных, содержащихся в снимке, а не для изменений по сравнению с " -"предыдущим снимком." +"`dedup` является свойством набора данных, а не свойством пула. Чтобы " +"активировать дедупликацию, установите это свойство на наборе данных:" #. type: delimited block . 4 -#: documentation/content/en/books/handbook/zfs/_index.adoc:2197 +#: documentation/content/en/books/handbook/zfs/_index.adoc:3457 #, no-wrap -msgid "" -"# zfs send mypool@backup1 > /backup/backup1\n" -"# zpool list\n" -"NAME SIZE ALLOC FREE CKPOINT EXPANDSZ FRAG CAP DEDUP HEALTH ALTROOT\n" -"backup 960M 63.7M 896M - - 0% 6% 1.00x ONLINE -\n" -"mypool 984M 43.7M 940M - - 0% 4% 1.00x ONLINE -\n" -msgstr "" -"# zfs send mypool@backup1 > /backup/backup1\n" -"# zpool list\n" -"NAME SIZE ALLOC FREE CKPOINT EXPANDSZ FRAG CAP DEDUP HEALTH ALTROOT\n" -"backup 960M 63.7M 896M - - 0% 6% 1.00x ONLINE -\n" -"mypool 984M 43.7M 940M - - 0% 4% 1.00x ONLINE -\n" +msgid "# zfs set dedup=on pool\n" +msgstr "# zfs set dedup=on pool\n" #. type: Plain text -#: documentation/content/en/books/handbook/zfs/_index.adoc:2201 +#: documentation/content/en/books/handbook/zfs/_index.adoc:3461 msgid "" -"The `zfs send` transferred all the data in the snapshot called _backup1_ to " -"the pool named _backup_. To create and send these snapshots automatically, " -"use a man:cron[8] job." +"This example sets the property on the root dataset of the pool _pool_, so " +"every dataset in the pool inherits it. Limiting deduplication to the " +"datasets that actually store duplicate-heavy data keeps the deduplication " +"table smaller." msgstr "" -"Команда `zfs send` передала все данные из снимка _backup1_ в пул _backup_. " -"Для автоматического создания и отправки таких снимков используйте задание " -"man:cron[8]." +"Этот пример устанавливает свойство на корневом наборе данных пула _pool_, " +"поэтому каждый набор данных в пуле наследует его. Ограничение дедупликации " +"только наборами данных, которые действительно хранят данные с большим " +"количеством дубликатов, позволяет поддерживать таблицу дедупликации меньшего " +"размера." #. type: Plain text -#: documentation/content/en/books/handbook/zfs/_index.adoc:2207 +#: documentation/content/en/books/handbook/zfs/_index.adoc:3466 msgid "" -"Instead of storing the backups as archive files, ZFS can receive them as a " -"live file system, allowing direct access to the backed up data. To get to " -"the actual data contained in those streams, use `zfs receive` to transform " -"the streams back into files and directories. The example below combines " -"`zfs send` and `zfs receive` using a pipe to copy the data from one pool to " -"another. Use the data directly on the receiving pool after the transfer is " -"complete. It is only possible to replicate a dataset to an empty dataset." +"Deduplicating only affects new data written to the dataset. Merely " +"activating this option will not deduplicate data already written. On " +"FreeBSD 15.0, crossref:zfs[zfs-zfs-rewrite,`zfs rewrite`] can rewrite " +"existing data so that it passes through deduplication. A pool with a " +"freshly activated deduplication property will look like this example:" msgstr "" -"Вместо хранения резервных копий в виде архивных файлов ZFS может получать их " -"как активную файловую систему, обеспечивая прямой доступ к резервным данным. " -"Для доступа к фактическим данным, содержащимся в этих потоках, используйте " -"`zfs receive`, чтобы преобразовать потоки обратно в файлы и каталоги. В " -"приведённом ниже примере объединяются `zfs send` и `zfs receive` с " -"использованием конвейера для копирования данных из одного пула в другой. " -"После завершения передачи данные можно использовать напрямую в целевом пуле. " -"Реплицировать набор данных можно только в пустой набор данных." +"Дедупликация затрагивает только новые данные, записываемые в набор данных. " +"Простое включение этой опции не приведёт к дедупликации уже записанных " +"данных. В FreeBSD 15.0 crossref:zfs[zfs-zfs-rewrite,`zfs rewrite`] позволяет " +"перезаписать существующие данные так, чтобы они прошли через дедупликацию. " +"Пул с только что активированным свойством дедупликации будет выглядеть " +"следующим образом:" #. type: delimited block . 4 -#: documentation/content/en/books/handbook/zfs/_index.adoc:2215 +#: documentation/content/en/books/handbook/zfs/_index.adoc:3472 #, no-wrap msgid "" -"# zfs snapshot mypool@replica1\n" -"# zfs send -v mypool@replica1 | zfs receive backup/mypool\n" -"send from @ to mypool@replica1 estimated size is 50.1M\n" -"total estimated size is 50.1M\n" -"TIME SENT SNAPSHOT\n" +"# zpool list\n" +"NAME SIZE ALLOC FREE CKPOINT EXPANDSZ FRAG CAP DEDUP HEALTH ALTROOT\n" +"pool 2.84G 2.19M 2.83G - - 0% 0% 1.00x ONLINE -\n" msgstr "" -"# zfs snapshot mypool@replica1\n" -"# zfs send -v mypool@replica1 | zfs receive backup/mypool\n" -"send from @ to mypool@replica1 estimated size is 50.1M\n" -"total estimated size is 50.1M\n" -"TIME SENT SNAPSHOT\n" +"# zpool list\n" +"NAME SIZE ALLOC FREE CKPOINT EXPANDSZ FRAG CAP DEDUP HEALTH ALTROOT\n" +"pool 2.84G 2.19M 2.83G - - 0% 0% 1.00x ONLINE -\n" -#. type: delimited block . 4 -#: documentation/content/en/books/handbook/zfs/_index.adoc:2220 -#, no-wrap +#. type: Plain text +#: documentation/content/en/books/handbook/zfs/_index.adoc:3477 msgid "" -"# zpool list\n" -"NAME SIZE ALLOC FREE CKPOINT EXPANDSZ FRAG CAP DEDUP HEALTH ALTROOT\n" -"backup 960M 63.7M 896M - - 0% 6% 1.00x ONLINE -\n" -"mypool 984M 43.7M 940M - - 0% 4% 1.00x ONLINE -\n" +"The `DEDUP` column shows the actual rate of deduplication for the pool. A " +"value of `1.00x` shows that data has not deduplicated yet. The next example " +"copies some system binaries three times into different directories on the " +"deduplicated pool created above." msgstr "" -"# zpool list\n" -"NAME SIZE ALLOC FREE CKPOINT EXPANDSZ FRAG CAP DEDUP HEALTH ALTROOT\n" -"backup 960M 63.7M 896M - - 0% 6% 1.00x ONLINE -\n" -"mypool 984M 43.7M 940M - - 0% 4% 1.00x ONLINE -\n" +"Столбец `DEDUP` показывает фактический уровень дедупликации для пула. " +"Значение `1.00x` означает, что данные пока не дедуплицированы. В следующем " +"примере некоторые системные двоичные файлы копируются три раза в разные " +"каталоги в пуле с дедупликацией, созданном выше." -#. type: Title ==== -#: documentation/content/en/books/handbook/zfs/_index.adoc:2223 +#. type: delimited block . 4 +#: documentation/content/en/books/handbook/zfs/_index.adoc:3483 #, no-wrap -msgid "Incremental Backups" -msgstr "Инкрементные резервные копии" - -#. type: Plain text -#: documentation/content/en/books/handbook/zfs/_index.adoc:2228 msgid "" -"`zfs send` can also determine the difference between two snapshots and send " -"individual differences between the two. This saves disk space and transfer " -"time. For example:" +"# for d in dir1 dir2 dir3; do\n" +"> mkdir $d && cp -R /usr/bin $d &\n" +"> done\n" msgstr "" -"`zfs send` также может определить разницу между двумя снимками и отправить " -"отдельные различия между ними. Это экономит место на диске и время передачи. " -"Например:" +"# for d in dir1 dir2 dir3; do\n" +"> mkdir $d && cp -R /usr/bin $d &\n" +"> done\n" + +#. type: Plain text +#: documentation/content/en/books/handbook/zfs/_index.adoc:3486 +msgid "To observe deduplicating of redundant data, use:" +msgstr "Для наблюдения за дедупликацией избыточных данных используйте:" #. type: delimited block . 4 -#: documentation/content/en/books/handbook/zfs/_index.adoc:2240 +#: documentation/content/en/books/handbook/zfs/_index.adoc:3492 #, no-wrap msgid "" -"# zfs snapshot mypool@replica2\n" -"# zfs list -t snapshot\n" -"NAME USED AVAIL REFER MOUNTPOINT\n" -"mypool@replica1 5.72M - 43.6M -\n" -"mypool@replica2 0 - 44.1M -\n" "# zpool list\n" -"NAME SIZE ALLOC FREE CKPOINT EXPANDSZ FRAG CAP DEDUP HEALTH ALTROOT\n" -"backup 960M 61.7M 898M - - 0% 6% 1.00x ONLINE -\n" -"mypool 960M 50.2M 910M - - 0% 5% 1.00x ONLINE -\n" +"NAME SIZE ALLOC FREE CKPOINT EXPANDSZ FRAG CAP DEDUP HEALTH ALTROOT\n" +"pool 2.84G 20.9M 2.82G - - 0% 0% 3.00x ONLINE -\n" msgstr "" -"# zfs snapshot mypool@replica2\n" -"# zfs list -t snapshot\n" -"NAME USED AVAIL REFER MOUNTPOINT\n" -"mypool@replica1 5.72M - 43.6M -\n" -"mypool@replica2 0 - 44.1M -\n" "# zpool list\n" -"NAME SIZE ALLOC FREE CKPOINT EXPANDSZ FRAG CAP DEDUP HEALTH ALTROOT\n" -"backup 960M 61.7M 898M - - 0% 6% 1.00x ONLINE -\n" -"mypool 960M 50.2M 910M - - 0% 5% 1.00x ONLINE -\n" +"NAME SIZE ALLOC FREE CKPOINT EXPANDSZ FRAG CAP DEDUP HEALTH ALTROOT\n" +"pool 2.84G 20.9M 2.82G - - 0% 0% 3.00x ONLINE -\n" #. type: Plain text -#: documentation/content/en/books/handbook/zfs/_index.adoc:2246 +#: documentation/content/en/books/handbook/zfs/_index.adoc:3500 msgid "" -"Create a second snapshot called _replica2_. This second snapshot contains " -"changes made to the file system between now and the previous snapshot, " -"_replica1_. Using `zfs send -i` and indicating the pair of snapshots " -"generates an incremental replica stream containing the changed data. This " -"succeeds if the initial snapshot already exists on the receiving side." +"The `DEDUP` column shows a factor of `3.00x`. Detecting and deduplicating " +"copies of the data uses a third of the space. The potential for space " +"savings can be enormous, but comes at the cost of having enough memory to " +"keep track of the deduplicated blocks. ZFS stores an entry for every " +"deduplicated block in the deduplication table (crossref:zfs[zfs-term-" +"deduplication,DDT]). A general rule of thumb is 5-6 GB of RAM per 1 TB of " +"deduplicated data. When the table no longer fits in memory, every write " +"forces reads of table entries from disk, and performance degrades " +"drastically." msgstr "" -"Создайте второй снимок с именем _replica2_. Этот второй снимок содержит " -"изменения, внесенные в файловую систему в период между текущим моментом и " -"предыдущим снимком _replica1_. Использование `zfs send -i` с указанием пары " -"снимков создаёт инкрементальный поток репликации, содержащий измененные " -"данные. Это выполняется успешно, если исходный снимок уже существует на " -"принимающей стороне." +"Столбец `DEDUP` показывает коэффициент `3.00x`. Обнаружение и дедупликация " +"копий данных используют треть пространства. Потенциальная экономия " +"пространства может быть огромной, но достигается за счет наличия " +"достаточного объёма памяти для отслеживания дедуплицированных блоков. ZFS " +"хранит запись для каждого дедуплицированного блока в таблице дедупликации " +"(crossref:zfs[zfs-term-deduplication,DDT]). Эмпирическое правило гласит, что " +"требуется 5–6 ГБ оперативной памяти на 1 ТБ дедуплицированных данных. Когда " +"таблица перестаёт помещаться в памяти, каждая запись вынуждает считывать " +"элементы таблицы с диска, и производительность резко падает." -#. type: delimited block . 4 -#: documentation/content/en/books/handbook/zfs/_index.adoc:2253 -#, no-wrap +#. type: Plain text +#: documentation/content/en/books/handbook/zfs/_index.adoc:3503 msgid "" -"# zfs send -v -i mypool@replica1 mypool@replica2 | zfs receive /backup/mypool\n" -"send from @replica1 to mypool@replica2 estimated size is 5.02M\n" -"total estimated size is 5.02M\n" -"TIME SENT SNAPSHOT\n" +"Deduplication is not always beneficial when the data in a pool is not " +"redundant. ZFS can show potential space savings by simulating deduplication " +"on an existing pool:" msgstr "" -"# zfs send -v -i mypool@replica1 mypool@replica2 | zfs receive /backup/mypool\n" -"send from @replica1 to mypool@replica2 estimated size is 5.02M\n" -"total estimated size is 5.02M\n" -"TIME SENT SNAPSHOT\n" +"Дедупликация не всегда полезна, если данные в пуле не содержат избыточности. " +"ZFS может показать потенциальную экономию пространства, имитируя " +"дедупликацию на существующем пуле:" #. type: delimited block . 4 -#: documentation/content/en/books/handbook/zfs/_index.adoc:2258 +#: documentation/content/en/books/handbook/zfs/_index.adoc:3508 #, no-wrap msgid "" -"# zpool list\n" -"NAME SIZE ALLOC FREE CKPOINT EXPANDSZ FRAG CAP DEDUP HEALTH ALTROOT\n" -"backup 960M 80.8M 879M - - 0% 8% 1.00x ONLINE -\n" -"mypool 960M 50.2M 910M - - 0% 5% 1.00x ONLINE -\n" +"# zdb -S pool\n" +"Simulated DDT histogram:\n" msgstr "" -"# zpool list\n" -"NAME SIZE ALLOC FREE CKPOINT EXPANDSZ FRAG CAP DEDUP HEALTH ALTROOT\n" -"backup 960M 80.8M 879M - - 0% 8% 1.00x ONLINE -\n" -"mypool 960M 50.2M 910M - - 0% 5% 1.00x ONLINE -\n" +"# zdb -S pool\n" +"Simulated DDT histogram:\n" #. type: delimited block . 4 -#: documentation/content/en/books/handbook/zfs/_index.adoc:2264 +#: documentation/content/en/books/handbook/zfs/_index.adoc:3524 #, no-wrap msgid "" -"# zfs list\n" -"NAME USED AVAIL REFER MOUNTPOINT\n" -"backup 55.4M 240G 152K /backup\n" -"backup/mypool 55.3M 240G 55.2M /backup/mypool\n" -"mypool 55.6M 11.6G 55.0M /mypool\n" +"bucket allocated referenced\n" +"______ ______________________________ ______________________________\n" +"refcnt blocks LSIZE PSIZE DSIZE blocks LSIZE PSIZE DSIZE\n" +"------ ------ ----- ----- ----- ------ ----- ----- -----\n" +" 1 2.58M 289G 264G 264G 2.58M 289G 264G 264G\n" +" 2 206K 12.6G 10.4G 10.4G 430K 26.4G 21.6G 21.6G\n" +" 4 37.6K 692M 276M 276M 170K 3.04G 1.26G 1.26G\n" +" 8 2.18K 45.2M 19.4M 19.4M 20.0K 425M 176M 176M\n" +" 16 174 2.83M 1.20M 1.20M 3.33K 48.4M 20.4M 20.4M\n" +" 32 40 2.17M 222K 222K 1.70K 97.2M 9.91M 9.91M\n" +" 64 9 56K 10.5K 10.5K 865 4.96M 948K 948K\n" +" 128 2 9.50K 2K 2K 419 2.11M 438K 438K\n" +" 256 5 61.5K 12K 12K 1.90K 23.0M 4.47M 4.47M\n" +" 1K 2 1K 1K 1K 2.98K 1.49M 1.49M 1.49M\n" +" Total 2.82M 303G 275G 275G 3.20M 319G 287G 287G\n" msgstr "" -"# zfs list\n" -"NAME USED AVAIL REFER MOUNTPOINT\n" -"backup 55.4M 240G 152K /backup\n" -"backup/mypool 55.3M 240G 55.2M /backup/mypool\n" -"mypool 55.6M 11.6G 55.0M /mypool\n" +"bucket allocated referenced\n" +"______ ______________________________ ______________________________\n" +"refcnt blocks LSIZE PSIZE DSIZE blocks LSIZE PSIZE DSIZE\n" +"------ ------ ----- ----- ----- ------ ----- ----- -----\n" +" 1 2.58M 289G 264G 264G 2.58M 289G 264G 264G\n" +" 2 206K 12.6G 10.4G 10.4G 430K 26.4G 21.6G 21.6G\n" +" 4 37.6K 692M 276M 276M 170K 3.04G 1.26G 1.26G\n" +" 8 2.18K 45.2M 19.4M 19.4M 20.0K 425M 176M 176M\n" +" 16 174 2.83M 1.20M 1.20M 3.33K 48.4M 20.4M 20.4M\n" +" 32 40 2.17M 222K 222K 1.70K 97.2M 9.91M 9.91M\n" +" 64 9 56K 10.5K 10.5K 865 4.96M 948K 948K\n" +" 128 2 9.50K 2K 2K 419 2.11M 438K 438K\n" +" 256 5 61.5K 12K 12K 1.90K 23.0M 4.47M 4.47M\n" +" 1K 2 1K 1K 1K 2.98K 1.49M 1.49M 1.49M\n" +" Total 2.82M 303G 275G 275G 3.20M 319G 287G 287G\n" #. type: delimited block . 4 -#: documentation/content/en/books/handbook/zfs/_index.adoc:2271 +#: documentation/content/en/books/handbook/zfs/_index.adoc:3526 #, no-wrap +msgid "dedup = 1.05, compress = 1.11, copies = 1.00, dedup * compress / copies = 1.16\n" +msgstr "dedup = 1.05, compress = 1.11, copies = 1.00, dedup * compress / copies = 1.16\n" + +#. type: Plain text +#: documentation/content/en/books/handbook/zfs/_index.adoc:3533 msgid "" -"# zfs list -t snapshot\n" -"NAME USED AVAIL REFER MOUNTPOINT\n" -"backup/mypool@replica1 104K - 50.2M -\n" -"backup/mypool@replica2 0 - 55.2M -\n" -"mypool@replica1 29.9K - 50.0M -\n" -"mypool@replica2 0 - 55.0M -\n" +"After `zdb -S` finishes analyzing the pool, it shows the space reduction " +"ratio that activating deduplication would achieve. In this case, `1.16` is " +"a poor space saving ratio mainly provided by compression. Activating " +"deduplication on this pool would not save any amount of space, and is not " +"worth the amount of memory required to enable deduplication. Using the " +"formula _ratio = dedup * compress / copies_, system administrators can plan " +"the storage allocation, deciding whether the workload will contain enough " +"duplicate blocks to justify the memory requirements. If the data is " +"reasonably compressible, the space savings may be good." msgstr "" -"# zfs list -t snapshot\n" -"NAME USED AVAIL REFER MOUNTPOINT\n" -"backup/mypool@replica1 104K - 50.2M -\n" -"backup/mypool@replica2 0 - 55.2M -\n" -"mypool@replica1 29.9K - 50.0M -\n" -"mypool@replica2 0 - 55.0M -\n" +"После завершения анализа пула командой `zdb -S` отображается коэффициент " +"сокращения пространства, который был бы достигнут при активации " +"дедупликации. В данном случае значение `1.16` указывает на низкий уровень " +"экономии пространства, в основном обеспечиваемый сжатием. Активация " +"дедупликации для этого пула не сэкономит значительного объёма пространства и " +"не оправдает объём памяти, необходимый для её включения. Используя формулу " +"_ratio = dedup * compress / copies_, системные администраторы могут " +"планировать распределение хранилища, определяя, будет ли рабочая нагрузка " +"содержать достаточное количество дублирующихся блоков, чтобы оправдать " +"требования к памяти. Если данные достаточно хорошо сжимаемы, экономия " +"пространства может быть значительной." + +#. type: Plain text +#: documentation/content/en/books/handbook/zfs/_index.adoc:3541 +msgid "" +"Fast dedup, a reworked implementation that lowers these costs, requires " +"OpenZFS 2.3 or later, first available in FreeBSD 15.0. Fast dedup batches " +"deduplication table updates in an on-disk log and flushes them to the table " +"in the background, reducing the random I/O that made classic deduplication " +"slow. The `dedup_table_quota` pool property sets a limit on the on-disk " +"size of the table; ZFS stops adding new entries once the pool reaches the " +"limit, and with the default value of `auto` the size of a dedicated dedup " +"vdev serves as the quota. The read-only `dedup_table_size` pool property " +"reports the current size of the table. `zpool ddtprune -p 30 pool` removes " +"the oldest 30% of the table entries that provide no savings because only a " +"single block references them; `-d _days_` instead prunes single-reference " +"entries older than the given number of days. `zpool status -DD pool` " +"displays deduplication table statistics, including a histogram of blocks by " +"reference count. Storing the table on a dedicated crossref:zfs[zfs-zpool-" +"special,dedup vdev] made of fast devices keeps lookups quick even when the " +"table outgrows RAM." +msgstr "" +"Быстрое дедуплицирование, переработанная реализация, снижающая эти затраты, " +"требует OpenZFS 2.3 или более поздней версии, впервые доступной в FreeBSD " +"15.0. Быстрое дедуплицирование группирует обновления таблицы дедупликации в " +"журнале на диске и сбрасывает их в таблицу в фоновом режиме, снижая " +"случайный ввод-вывод, из-за которого классическая дедупликация была " +"медленной. Свойство пула `dedup_table_quota` задаёт ограничение на размер " +"таблицы на диске; ZFS прекращает добавлять новые записи, когда пул достигает " +"лимита, а при значении по умолчанию `auto` размер выделенного vdev для " +"дедупликации служит квотой. Свойство пула `dedup_table_size`, доступное " +"только для чтения, сообщает текущий размер таблицы. `zpool ddtprune -p 30 " +"pool` удаляет самые старые 30% записей таблицы, которые не дают экономии, " +"поскольку на них ссылается только один блок; `-d _days_` вместо этого " +"удаляет записи с одной ссылкой, старше указанного количества дней. `zpool " +"status -DD pool` отображает статистику таблицы дедупликации, включая " +"гистограмму блоков по количеству ссылок. Хранение таблицы на выделенном " +"crossref:zfs[zfs-zpool-special,для дедупликации vdev], состоящем из быстрых " +"устройств, обеспечивает быстрый поиск даже когда таблица превышает объём " +"оперативной памяти." + +#. type: Plain text +#: documentation/content/en/books/handbook/zfs/_index.adoc:3544 +msgid "" +"Good practice is to enable compression first as compression also provides " +"greatly increased performance. Enable deduplication in cases where savings " +"are considerable and with enough available memory for the crossref:zfs[zfs-" +"term-deduplication,DDT]." +msgstr "" +"Хорошей практикой является сначала включить сжатие, так как сжатие также " +"обеспечивает значительно повышенную производительность. Включайте " +"дедупликацию в случаях, когда экономия значительна и имеется достаточно " +"доступной памяти для crossref:zfs[zfs-term-deduplication,DDT]." + +#. type: Title === +#: documentation/content/en/books/handbook/zfs/_index.adoc:3546 +#, no-wrap +msgid "ZFS and Jails" +msgstr "ZFS и клетки" #. type: Plain text -#: documentation/content/en/books/handbook/zfs/_index.adoc:2276 +#: documentation/content/en/books/handbook/zfs/_index.adoc:3552 msgid "" -"The incremental stream replicated the changed data rather than the entirety " -"of _replica1_. Sending the differences alone took much less time to " -"transfer and saved disk space by not copying the whole pool each time. This " -"is useful when replicating over a slow network or one charging per " -"transferred byte." +"Use `zfs jail` and the corresponding `jailed` property to delegate a ZFS " +"dataset to a crossref:jails[jails,Jail]. `zfs jail _jailid_` attaches a " +"dataset to the specified jail, and `zfs unjail` detaches it. To control the " +"dataset from within a jail, set the `jailed` property. ZFS forbids mounting " +"a jailed dataset on the host because it may have mount points that would " +"compromise the security of the host." msgstr "" -"Инкрементный поток реплицировал измененные данные вместо полной копии " -"_replica1_. Передача только различий заняла гораздо меньше времени и " -"сэкономила место на диске, избегая копирования всего пула каждый раз. Это " -"особенно полезно при репликации по медленной сети или при тарификации за " -"каждый переданный байт." +"Используйте `zfs jail` и соответствующее свойство `jailed`, чтобы " +"делегировать набор данных ZFS в crossref:jails[jails,Клетку]. `zfs jail " +"_идентификатор_клетки_` присоединяет набор данных к указанной клетке, а `zfs " +"unjail` отсоединяет его. Для управления набором данных изнутри клетки " +"установите свойство `jail`. ZFS запрещает монтирование на хосте набора " +"данных со свойством jail, так как его точки монтирования могут нарушить " +"безопасность хоста." #. type: Plain text -#: documentation/content/en/books/handbook/zfs/_index.adoc:2281 +#: documentation/content/en/books/handbook/zfs/_index.adoc:3556 msgid "" -"A new file system, _backup/mypool_, is available with the files and data " -"from the pool _mypool_. Specifying `-p` copies the dataset properties " -"including compression settings, quotas, and mount points. Specifying `-R` " -"copies all child datasets of the dataset along with their properties. " -"Automate sending and receiving to create regular backups on the second pool." +"A delegated dataset hands control of a whole subtree to the jail " +"administrator, who can mount it, create child datasets, take snapshots, and " +"change properties, all confined to that subtree. For this to work, the jail " +"needs the `allow.mount` and `allow.mount.zfs` parameters enabled and the " +"`enforce_statfs` parameter set to a value lower than 2. Refer to man:" +"jail[8] for details on these parameters." msgstr "" -"Доступна новая файловая система _backup/mypool_ с файлами и данными из пула " -"_mypool_. Указание `-p` копирует свойства наборов данных, включая настройки " -"сжатия, квоты и точки монтирования. Указание `-R` копирует все дочерние " -"наборы данных вместе с их свойствами. Автоматизируйте отправку и получение " -"для создания регулярных резервных копий во втором пуле." - -#. type: Title ==== -#: documentation/content/en/books/handbook/zfs/_index.adoc:2283 -#, no-wrap -msgid "Sending Encrypted Backups over SSH" -msgstr "Отправка зашифрованных резервных копий через SSH" +"Делегированный набор данных передает управление всем поддеревом " +"администратору клетки, который может монтировать его, создавать дочерние " +"наборы данных, делать снимки и изменять свойства, все это ограничено этим " +"поддеревом. Для этого клетке необходимо включить параметры `allow.mount` и " +"`allow.mount.zfs`, а параметр `enforce_statfs` установить на значение ниже " +"2. Обратитесь к man:jail[8] за подробностями об этих параметрах." #. type: Plain text -#: documentation/content/en/books/handbook/zfs/_index.adoc:2291 +#: documentation/content/en/books/handbook/zfs/_index.adoc:3558 msgid "" -"Sending streams over the network is a good way to keep a remote backup, but " -"it does come with a drawback. Data sent over the network link is not " -"encrypted, allowing anyone to intercept and transform the streams back into " -"data without the knowledge of the sending user. This is undesirable when " -"sending the streams over the internet to a remote host. Use SSH to securely " -"encrypt data sent over a network connection. Since ZFS requires redirecting " -"the stream from standard output, piping it through SSH is easy. To keep the " -"contents of the file system encrypted in transit and on the remote system, " -"consider using https://wiki.freebsd.org/PEFS[PEFS]." +"This example creates a dataset, marks it as jailed, and attaches it to the " +"running jail _myjail_:" msgstr "" -"Отправка потоков данных по сети — это хороший способ создания удалённой " -"резервной копии, но у этого метода есть недостаток. Данные, передаваемые по " -"сетевому соединению, не шифруются, что позволяет любому перехватить их и " -"преобразовать обратно в данные без ведома отправителя. Это нежелательно при " -"отправке потоков через интернет на удалённый хост. Используйте SSH для " -"безопасного шифрования данных, передаваемых по сетевому соединению. " -"Поскольку ZFS требует перенаправления потока из стандартного вывода, его " -"легко передать через SSH с помощью конвейера. Чтобы содержимое файловой " -"системы оставалось зашифрованным при передаче и на удалённой системе, " -"рассмотрите возможность использования https://wiki.freebsd.org/PEFS[PEFS]." +"Этот пример создаёт набор данных, помечает его как находящийся в клетке и " +"прикрепляет его к запущенной клетке _myjail_:" -#. type: Plain text -#: documentation/content/en/books/handbook/zfs/_index.adoc:2294 +#. type: delimited block . 4 +#: documentation/content/en/books/handbook/zfs/_index.adoc:3564 +#, no-wrap msgid "" -"Change some settings and take security precautions first. This describes " -"the necessary steps required for the `zfs send` operation; for more " -"information on SSH, see crossref:security[openssh,\"OpenSSH\"]." +"# zfs create mypool/jaildata\n" +"# zfs set jailed=on mypool/jaildata\n" +"# zfs jail myjail mypool/jaildata\n" msgstr "" -"Измените некоторые настройки и сначала примите меры безопасности. Здесь " -"описаны необходимые шаги для операции `zfs send`; дополнительную информацию " -"о SSH см. в crossref:security[openssh,\"OpenSSH\"]." - -#. type: Plain text -#: documentation/content/en/books/handbook/zfs/_index.adoc:2296 -msgid "Change the configuration as follows:" -msgstr "Измените конфигурацию следующим образом:" +"# zfs create mypool/jaildata\n" +"# zfs set jailed=on mypool/jaildata\n" +"# zfs jail myjail mypool/jaildata\n" #. type: Plain text -#: documentation/content/en/books/handbook/zfs/_index.adoc:2298 +#: documentation/content/en/books/handbook/zfs/_index.adoc:3569 msgid "" -"Passwordless SSH access between sending and receiving host using SSH keys" +"The dataset then appears in `zfs list` inside the jail and is manageable " +"there. `zfs unjail myjail mypool/jaildata` returns control to the host. " +"See man:zfs-jail[8] for more information." msgstr "" -"Беспарольный доступ SSH между отправляющим и принимающим хостами с " -"использованием SSH-ключей" +"Затем набор данных появляется в `zfs list` внутри клетки и доступен для " +"управления там. `zfs unjail myjail mypool/jaildata` возвращает управление " +"хосту. Дополнительную информацию см. в man:zfs-jail[8]." #. type: Plain text -#: documentation/content/en/books/handbook/zfs/_index.adoc:2299 +#: documentation/content/en/books/handbook/zfs/_index.adoc:3574 msgid "" -"ZFS requires the privileges of the `root` user to send and receive streams. " -"This requires logging in to the receiving system as `root`." +"Starting with FreeBSD 15.0, man:jail[8] automates the attachment. List the " +"datasets to delegate in the `zfs.dataset` jail parameter, and man:jail[8] " +"attaches them when the jail starts. The datasets must already have " +"`jailed=on` set, and the parameter requires `allow.mount.zfs`. An [." +"filename]#/etc/jail.conf# entry using it looks like this:" msgstr "" -"Для отправки и получения потоков ZFS требуются привилегии пользователя " -"`root`. Это подразумевает вход в принимающую систему под учётной записью " -"`root`." +"Начиная с FreeBSD 15.0, man:jail[8] автоматизирует подключение. Укажите " +"наборы данных для делегирования в параметре клетки `zfs.dataset`, и " +"man:jail[8] подключает их при запуске клетки. Наборы данных уже должны иметь " +"установленный параметр `jailed=on`, а параметр требует `allow.mount.zfs`. " +"Запись в [.filename]#/etc/jail.conf# с его использованием выглядит так:" -#. type: Plain text -#: documentation/content/en/books/handbook/zfs/_index.adoc:2300 -msgid "Security reasons prevent `root` from logging in by default." +#. type: delimited block . 4 +#: documentation/content/en/books/handbook/zfs/_index.adoc:3587 +#, no-wrap +msgid "" +"myjail {\n" +" path = \"/usr/local/jails/myjail\";\n" +" host.hostname = \"myjail.example.org\";\n" +" exec.start = \"/bin/sh /etc/rc\";\n" +" exec.stop = \"/bin/sh /etc/rc.shutdown\";\n" +" allow.mount;\n" +" allow.mount.zfs;\n" +" enforce_statfs = 1;\n" +" zfs.dataset = \"mypool/jaildata\";\n" +"}\n" msgstr "" -"По соображениям безопасности вход пользователя `root` по умолчанию запрещён." +"myjail {\n" +" path = \"/usr/local/jails/myjail\";\n" +" host.hostname = \"myjail.example.org\";\n" +" exec.start = \"/bin/sh /etc/rc\";\n" +" exec.stop = \"/bin/sh /etc/rc.shutdown\";\n" +" allow.mount;\n" +" allow.mount.zfs;\n" +" enforce_statfs = 1;\n" +" zfs.dataset = \"mypool/jaildata\";\n" +"}\n" #. type: Plain text -#: documentation/content/en/books/handbook/zfs/_index.adoc:2302 +#: documentation/content/en/books/handbook/zfs/_index.adoc:3590 msgid "" -"Use the crossref:zfs[zfs-zfs-allow,ZFS Delegation] system to allow a non-" -"`root` user on each system to perform the respective send and receive " -"operations. On the sending system:" +"Setting the `zfs.mount_snapshot` jail parameter to 1 additionally lets users " +"inside the jail access the contents of ZFS snapshots under the [.filename]#." +"zfs# directory of the delegated file systems." msgstr "" -"Используйте систему crossref:zfs[zfs-zfs-allow,Делегирование ZFS], чтобы " -"разрешить пользователю без прав `root` на каждой системе выполнять " -"соответствующие операции отправки и получения. На передающей системе:" +"Установка параметра клетки `zfs.mount_snapshot` в значение 1 дополнительно " +"позволяет пользователям внутри клетки получать доступ к содержимому снимков " +"ZFS в каталоге [.filename]#.zfs# делегированных файловых систем." -#. type: delimited block . 4 -#: documentation/content/en/books/handbook/zfs/_index.adoc:2306 +#. type: Title == +#: documentation/content/en/books/handbook/zfs/_index.adoc:3592 #, no-wrap -msgid "# zfs allow -u someuser send,snapshot mypool\n" -msgstr "# zfs allow -u someuser send,snapshot mypool\n" +msgid "Delegated Administration" +msgstr "Делегированное администрирование" #. type: Plain text -#: documentation/content/en/books/handbook/zfs/_index.adoc:2309 +#: documentation/content/en/books/handbook/zfs/_index.adoc:3600 msgid "" -"To mount the pool, the unprivileged user must own the directory, and regular " -"users need permission to mount file systems." +"A comprehensive permission delegation system allows unprivileged users to " +"perform ZFS administration functions. For example, if each user's home " +"directory is a dataset, users need permission to create and destroy " +"snapshots of their home directories. A user performing backups can get " +"permission to use replication features. ZFS allows a usage statistics " +"script to run with access to only the space usage data for all users. " +"Delegating the ability to delegate permissions is also possible. Permission " +"delegation is possible for each subcommand and most properties." msgstr "" -"Чтобы подключить пул, непривилегированный пользователь должен быть " -"владельцем каталога, а обычные пользователи должны иметь разрешение на " -"подключение файловых систем." +"Комплексная система делегирования прав позволяет непривилегированным " +"пользователям выполнять функции администрирования ZFS. Например, если " +"домашний каталог каждого пользователя является набором данных, пользователям " +"нужно разрешение на создание и удаление снимков своих домашних каталогов. " +"Пользователь, выполняющий резервное копирование, может получить разрешение " +"на использование функций репликации. ZFS позволяет скрипту статистики " +"использования работать с доступом только к данным о занятом пространстве для " +"всех пользователей. Также возможно делегирование права на делегирование " +"разрешений. Делегирование прав доступно для каждой подкоманды и большинства " +"свойств." + +#. type: Title === +#: documentation/content/en/books/handbook/zfs/_index.adoc:3602 +#, no-wrap +msgid "Delegating Dataset Creation" +msgstr "Делегирование создания наборов данных" #. type: Plain text -#: documentation/content/en/books/handbook/zfs/_index.adoc:2311 -msgid "On the receiving system:" -msgstr "На принимающей системе:" +#: documentation/content/en/books/handbook/zfs/_index.adoc:3608 +msgid "" +"`zfs allow _someuser_ create _mydataset_` gives the specified user " +"permission to create child datasets under the selected parent dataset. A " +"caveat: creating a new dataset involves mounting it. That requires setting " +"the FreeBSD `vfs.usermount` man:sysctl[8] to `1` to allow non-root users to " +"mount a file system. Another restriction aimed at preventing abuse: non-" +"`root` users must own the mountpoint where the file system is to be mounted." +msgstr "" +"`zfs allow _someuser_ create _mydataset_` предоставляет указанному " +"пользователю разрешение на создание дочерних наборов данных в выбранном " +"родительском наборе данных. Важное замечание: создание нового набора данных " +"включает его монтирование. Для этого необходимо установить параметр `vfs." +"usermount` в man:sysctl[8] FreeBSD в значение `1`, чтобы разрешить " +"непривилегированным пользователям монтировать файловую систему. Ещё одно " +"ограничение, направленное на предотвращение злоупотреблений: " +"непривилегированные пользователи должны быть владельцами точки монтирования, " +"куда монтируется файловая система." -#. type: delimited block . 4 -#: documentation/content/en/books/handbook/zfs/_index.adoc:2320 +#. type: Title === +#: documentation/content/en/books/handbook/zfs/_index.adoc:3610 #, no-wrap +msgid "Delegating Permission Delegation" +msgstr "Делегирование права делегировать разрешения" + +#. type: Plain text +#: documentation/content/en/books/handbook/zfs/_index.adoc:3614 msgid "" -"# sysctl vfs.usermount=1\n" -"vfs.usermount: 0 -> 1\n" -"# echo vfs.usermount=1 >> /etc/sysctl.conf\n" -"# zfs create recvpool/backup\n" -"# zfs allow -u someuser create,mount,receive recvpool/backup\n" -"# chown someuser /recvpool/backup\n" +"`zfs allow _someuser_ allow _mydataset_` gives the specified user the " +"ability to assign any permission they have on the target dataset, or its " +"children, to other users. If a user has the `snapshot` permission and the " +"`allow` permission, that user can then grant the `snapshot` permission to " +"other users." msgstr "" -"# sysctl vfs.usermount=1\n" -"vfs.usermount: 0 -> 1\n" -"# echo vfs.usermount=1 >> /etc/sysctl.conf\n" -"# zfs create recvpool/backup\n" -"# zfs allow -u someuser create,mount,receive recvpool/backup\n" -"# chown someuser /recvpool/backup\n" +"`zfs allow _someuser_ allow _mydataset_` предоставляет указанному " +"пользователю возможность назначать любые разрешения, которые у него есть для " +"целевого набора данных или его дочерних элементов, другим пользователям. " +"Если пользователь имеет разрешение `snapshot` и разрешение `allow`, он может " +"предоставить разрешение `snapshot` другим пользователям." + +#. type: Title == +#: documentation/content/en/books/handbook/zfs/_index.adoc:3616 +#, no-wrap +msgid "ZFS Native Encryption" +msgstr "Встроенное шифрование ZFS" #. type: Plain text -#: documentation/content/en/books/handbook/zfs/_index.adoc:2323 +#: documentation/content/en/books/handbook/zfs/_index.adoc:3622 msgid "" -"The unprivileged user can receive and mount datasets now, and replicates the " -"_home_ dataset to the remote system:" +"ZFS supports native encryption of datasets and the data stored within them. " +"This was not always the case, as previous solutions relied on FreeBSD's GELI-" +"based encryption. While this approach is secure, it was not as easily " +"portable to non-FreeBSD systems that lacked GELI support. With ZFS native " +"encryption, encrypted datasets can be used on other systems that support " +"this pool feature without relying on third-party components or operating " +"system-native encryption." msgstr "" -"Непривилегированный пользователь теперь может получать и монтировать наборы " -"данных, а также реплицирует набор данных _home_ на удалённую систему:" +"ZFS поддерживает встроенное шифрование наборов данных и данных, хранящихся в " +"них. Так было не всегда: предыдущие решения полагались на шифрование на " +"основе GELI во FreeBSD. Хотя этот подход безопасен, он не был так легко " +"переносим на системы, отличные от FreeBSD, в которых отсутствовала поддержка " +"GELI. Благодаря встроенному шифрованию ZFS зашифрованные наборы данных можно " +"использовать на других системах, поддерживающих эту функцию пула, без " +"зависимости от сторонних компонентов или встроенного шифрования операционной " +"системы." -#. type: delimited block . 4 -#: documentation/content/en/books/handbook/zfs/_index.adoc:2328 -#, no-wrap +#. type: Plain text +#: documentation/content/en/books/handbook/zfs/_index.adoc:3625 msgid "" -"% zfs snapshot -r mypool/home@monday\n" -"% zfs send -R mypool/home@monday | ssh someuser@backuphost zfs recv -dvu recvpool/backup\n" +"Another benefit of ZFS native encryption is that datasets do not need to be " +"decrypted for administrative tasks such as snapshots, replication, or scrub " +"operations. ZFS data integrity checks work just as well with natively " +"encrypted datasets, and compression also works on encrypted datasets." msgstr "" -"% zfs snapshot -r mypool/home@monday\n" -"% zfs send -R mypool/home@monday | ssh someuser@backuphost zfs recv -dvu recvpool/backup\n" +"Ещё одним преимуществом встроенного шифрования ZFS является то, что наборы " +"данных не нужно расшифровывать для административных задач, таких как " +"создание снимков, репликация или операции проверки целостности. Проверки " +"целостности данных ZFS работают одинаково хорошо с нативно зашифрованными " +"наборами данных, а сжатие также работает с зашифрованными наборами данных." #. type: Plain text -#: documentation/content/en/books/handbook/zfs/_index.adoc:2338 +#: documentation/content/en/books/handbook/zfs/_index.adoc:3632 msgid "" -"Create a recursive snapshot called _monday_ of the file system dataset " -"_home_ on the pool _mypool_. Then `zfs send -R` includes the dataset, all " -"child datasets, snapshots, clones, and settings in the stream. Pipe the " -"output through SSH to the waiting `zfs receive` on the remote host " -"_backuphost_. Using an IP address or fully qualified domain name is good " -"practice. The receiving machine writes the data to the _backup_ dataset on " -"the _recvpool_ pool. Adding `-d` to `zfs recv` overwrites the name of the " -"pool on the receiving side with the name of the snapshot. `-u` causes the " -"file systems to not mount on the receiving side. Using `-v` shows more " -"details about the transfer, including the elapsed time and the amount of " -"data transferred." +"Different datasets on the same pool can use separate keys independently. " +"Consider a central file server where different users store their data in " +"encrypted home datasets. User A has a different key than User B. Both " +"users can work side by side and choose to unencrypt their datasets as needed " +"without knowing each other's decryption keys. The decryption method can " +"also differ completely between users without affecting one another. This " +"allows sensitive data from different users to be stored on the same pool " +"while remaining protected by separate keys." msgstr "" -"Создайте рекурсивный снимок с именем _monday_ для набора данных файловой " -"системы _home_ в пуле _mypool_. Затем `zfs send -R` включает в поток набор " -"данных, все дочерние наборы данных, снимки, клоны и настройки. Передайте " -"вывод через SSH на ожидающий `zfs receive` на удалённом хосте _backuphost_. " -"Рекомендуется использовать IP-адрес или полное доменное имя. Принимающая " -"машина записывает данные в набор данных _backup_ в пуле _recvpool_. " -"Добавление `-d` к `zfs recv` перезаписывает имя пула на принимающей стороне " -"именем снимка. `-u` отключает монтирование файловых систем на принимающей " -"стороне. Использование `-v` показывает подробности о передаче, включая " -"затраченное время и объём переданных данных." +"Разные наборы данных в одном пуле могут использовать отдельные ключи " +"независимо. Рассмотрим центральный файловый сервер, где разные пользователи " +"хранят свои данные в зашифрованных домашних наборах данных. У пользователя A " +"ключ отличается от ключа пользователя B. Оба пользователя могут работать " +"параллельно и расшифровывать свои наборы данных по мере необходимости, не " +"зная ключей расшифровки друг друга. Метод расшифровки также может полностью " +"различаться между пользователями, не влияя друг на друга. Это позволяет " +"хранить конфиденциальные данные разных пользователей в одном пуле, оставаясь " +"защищёнными отдельными ключами." -#. type: Title === -#: documentation/content/en/books/handbook/zfs/_index.adoc:2340 -#, no-wrap -msgid "Dataset, User, and Group Quotas" -msgstr "Квоты наборов данных, пользователей и групп" +#. type: Plain text +#: documentation/content/en/books/handbook/zfs/_index.adoc:3634 +msgid "Before using ZFS native encryption, be aware of the following:" +msgstr "Перед использованием встроенного шифрования ZFS, учтите следующее:" + +#. type: Plain text +#: documentation/content/en/books/handbook/zfs/_index.adoc:3636 +msgid "Encryption is applied at the dataset level, not the pool level." +msgstr "Шифрование применяется на уровне набора данных, а не на уровне пула." #. type: Plain text -#: documentation/content/en/books/handbook/zfs/_index.adoc:2346 +#: documentation/content/en/books/handbook/zfs/_index.adoc:3637 msgid "" -"Use crossref:zfs[zfs-term-quota,Dataset quotas] to restrict the amount of " -"space consumed by a particular dataset. crossref:zfs[zfs-term-refquota," -"Reference Quotas] work in much the same way, but count the space used by the " -"dataset itself, excluding snapshots and child datasets. Similarly, use " -"crossref:zfs[zfs-term-userquota,user] and crossref:zfs[zfs-term-groupquota," -"group] quotas to prevent users or groups from using up all the space in the " -"pool or dataset." +"Booting from encrypted ZFS datasets is not yet supported in FreeBSD's loader." msgstr "" -"Используйте crossref:zfs[zfs-term-quota,Квоты наборов данных], чтобы " -"ограничить объём пространства, используемого определённым набором данных. " -"crossref:zfs[zfs-term-refquota,Референтные квоты] работают схожим образом, " -"но учитывают пространство, используемое самим набором данных, исключая " -"снимки и дочерние наборы данных. Аналогично, используйте crossref:zfs[zfs-" -"term-userquota,пользовательские] и crossref:zfs[zfs-term-groupquota," -"групповые] квоты, чтобы предотвратить исчерпание всего пространства в пуле " -"или наборе данных пользователями или группами." +"Загрузка с зашифрованных наборов данных ZFS пока не поддерживается в " +"загрузчике FreeBSD." #. type: Plain text -#: documentation/content/en/books/handbook/zfs/_index.adoc:2351 +#: documentation/content/en/books/handbook/zfs/_index.adoc:3638 msgid "" -"The following examples assume that the users already exist in the system. " -"Before adding a user to the system, make sure to create their home dataset " -"first and set the `mountpoint` to `/home/_bob_`. Then, create the user and " -"make the home directory point to the dataset's `mountpoint` location. This " -"will properly set owner and group permissions without shadowing any pre-" -"existing home directory paths that might exist." +"Encryption can only be enabled when a dataset is created, not afterward." msgstr "" -"Следующие примеры предполагают, что пользователи уже существуют в системе. " -"Перед добавлением пользователя в систему убедитесь, что вы сначала создали " -"его домашний набор данных и установили `mountpoint` в `/home/_bob_`. Затем " -"создайте пользователя и укажите домашний каталог на расположение " -"`mountpoint` набора данных. Это правильно установит права владельца и группы " -"без перекрытия уже существующих путей домашних каталогов." +"Шифрование может быть включено только при создании набора данных, а не после." #. type: Plain text -#: documentation/content/en/books/handbook/zfs/_index.adoc:2353 -msgid "To enforce a dataset quota of 10 GB for [.filename]#storage/home/bob#:" +#: documentation/content/en/books/handbook/zfs/_index.adoc:3639 +msgid "" +"The block cipher, key length, and encryption mode cannot be changed after " +"they have been set." msgstr "" -"Чтобы установить квоту набора данных в 10 ГБ для [.filename]#storage/home/" -"bob#:" +"Блочный шифр, длина ключа и режим шифрования не могут быть изменены после " +"того, как они были установлены." -#. type: delimited block . 4 -#: documentation/content/en/books/handbook/zfs/_index.adoc:2357 -#, no-wrap -msgid "# zfs set quota=10G storage/home/bob\n" -msgstr "# zfs set quota=10G storage/home/bob\n" +#. type: Plain text +#: documentation/content/en/books/handbook/zfs/_index.adoc:3640 +msgid "ZFS does not encrypt metadata." +msgstr "ZFS не шифрует метаданные." #. type: Plain text -#: documentation/content/en/books/handbook/zfs/_index.adoc:2360 +#: documentation/content/en/books/handbook/zfs/_index.adoc:3644 msgid "" -"To enforce a reference quota of 10 GB for [.filename]#storage/home/bob#:" +"The last point may seem like a drawback compared to full-disk encryption. " +"However, it provides greater flexibility by allowing different keys to " +"protect datasets within the same pool instead of requiring a single key or " +"passphrase to unlock the entire pool. Specifically, ZFS encrypts the " +"following:" msgstr "" -"Чтобы установить контрольную квоту в 10 ГБ для [.filename]#storage/home/bob#:" +"Последний пункт может показаться недостатком по сравнению с полнодисковым " +"шифрованием. Однако он обеспечивает большую гибкость, позволяя разным " +"ключам защищать наборы данных (datasets) в рамках одного пула, вместо того " +"чтобы требовать один ключ или парольную фразу для разблокировки всего пула. " +"В частности, ZFS шифрует следующее:" -#. type: delimited block . 4 -#: documentation/content/en/books/handbook/zfs/_index.adoc:2364 -#, no-wrap -msgid "# zfs set refquota=10G storage/home/bob\n" -msgstr "# zfs set refquota=10G storage/home/bob\n" +#. type: Plain text +#: documentation/content/en/books/handbook/zfs/_index.adoc:3646 +msgid "file and zvol data," +msgstr "данные файла и zvol," #. type: Plain text -#: documentation/content/en/books/handbook/zfs/_index.adoc:2367 -msgid "To remove a quota of 10 GB for [.filename]#storage/home/bob#:" -msgstr "Удалить квоту в 10 ГБ для [.filename]#storage/home/bob#:" +#: documentation/content/en/books/handbook/zfs/_index.adoc:3647 +msgid "file attributes," +msgstr "атрибуты файлов," -#. type: delimited block . 4 -#: documentation/content/en/books/handbook/zfs/_index.adoc:2371 -#, no-wrap -msgid "# zfs set quota=none storage/home/bob\n" -msgstr "# zfs set quota=none storage/home/bob\n" +#. type: Plain text +#: documentation/content/en/books/handbook/zfs/_index.adoc:3648 +msgid "ACLs," +msgstr "ACL," + +#. type: Plain text +#: documentation/content/en/books/handbook/zfs/_index.adoc:3649 +msgid "permission bits," +msgstr "биты разрешений," + +#. type: Plain text +#: documentation/content/en/books/handbook/zfs/_index.adoc:3650 +msgid "directory listings," +msgstr "листинги каталогов," + +#. type: Plain text +#: documentation/content/en/books/handbook/zfs/_index.adoc:3651 +msgid "FUID mappings," +msgstr "Соответствия FUID," + +#. type: Plain text +#: documentation/content/en/books/handbook/zfs/_index.adoc:3652 +msgid "userused/groupused data, and" +msgstr "используемые пользователем/групповые используемые данные, и" + +#. type: Plain text +#: documentation/content/en/books/handbook/zfs/_index.adoc:3653 +msgid "deduplicated data" +msgstr "Дедуплицированные данные" #. type: Plain text -#: documentation/content/en/books/handbook/zfs/_index.adoc:2374 +#: documentation/content/en/books/handbook/zfs/_index.adoc:3655 msgid "" -"The general format is `userquota@_user_=_size_`, and the user's name must be " -"in one of these formats:" +"Some ZFS metadata and information remains unencrypted, including the " +"following:" msgstr "" -"Общий формат `userquota@_пользователь_=_размер_`, и имя пользователя должно " -"быть в одном из следующих форматов:" +"Некоторые метаданные и информация ZFS остаются незашифрованными, включая " +"следующее:" #. type: Plain text -#: documentation/content/en/books/handbook/zfs/_index.adoc:2376 -msgid "POSIX compatible name such as _joe_." -msgstr "POSIX-совместимое имя, например _joe_." +#: documentation/content/en/books/handbook/zfs/_index.adoc:3657 +msgid "pool structure and name," +msgstr "структура и имя пула," + +#. type: Plain text +#: documentation/content/en/books/handbook/zfs/_index.adoc:3658 +msgid "dataset and snapshot names," +msgstr "имена наборов данных и снимков," + +#. type: Plain text +#: documentation/content/en/books/handbook/zfs/_index.adoc:3659 +msgid "dataset hierarchy," +msgstr "иерархия наборов данных," + +#. type: Plain text +#: documentation/content/en/books/handbook/zfs/_index.adoc:3660 +msgid "properties," +msgstr "свойства," + +#. type: Plain text +#: documentation/content/en/books/handbook/zfs/_index.adoc:3661 +msgid "file size," +msgstr "размер файла" + +#. type: Plain text +#: documentation/content/en/books/handbook/zfs/_index.adoc:3662 +msgid "file holes, and" +msgstr "пропуски в файлах, и" + +#. type: Plain text +#: documentation/content/en/books/handbook/zfs/_index.adoc:3663 +msgid "deduplication tables" +msgstr "Таблицы дедупликации" + +#. type: Plain text +#: documentation/content/en/books/handbook/zfs/_index.adoc:3666 +msgid "" +"This unencrypted metadata allows ZFS to perform routine maintenance " +"operations, such as `zpool scrub`, without first decrypting the data. As a " +"result, ZFS can detect and repair corrupted encrypted data without accessing " +"the unencrypted file contents." +msgstr "" +"Этот набор незашифрованных метаданных позволяет ZFS выполнять рутинные " +"операции обслуживания, такие как `zpool scrub`, без предварительной " +"расшифровки данных. В результате ZFS может обнаруживать и исправлять " +"повреждённые зашифрованные данные, не обращаясь к незашифрованному " +"содержимому файлов." #. type: Plain text -#: documentation/content/en/books/handbook/zfs/_index.adoc:2377 -msgid "POSIX numeric ID such as _789_." -msgstr "Числовой идентификатор POSIX, например, _789_." +#: documentation/content/en/books/handbook/zfs/_index.adoc:3673 +msgid "" +"To encrypt existing unencrypted data, copy it to a dataset with encryption " +"enabled. This allows data to be migrated to a secure location within the " +"pool, provided the passphrase is supplied to authorize access. Typically, " +"this is done by loading the encryption key into memory after confirming " +"knowledge of a secret such as a passphrase. Once the key has been loaded, " +"the dataset contents become accessible for reading and writing. To re-" +"secure the dataset, unload the key from memory. ZFS then makes the dataset " +"inaccessible until the key is loaded again." +msgstr "" +"Чтобы зашифровать существующие незашифрованные данные, скопируйте их в набор " +"данных с включенным шифрованием. Это позволяет перенести данные в защищенное " +"место в пуле, при условии предоставления парольной фразы для авторизации " +"доступа. Обычно это делается путем загрузки ключа шифрования в память после " +"подтверждения знания секрета, такого как парольная фраза. После загрузки " +"ключа содержимое набора данных становится доступным для чтения и записи. " +"Чтобы снова защитить набор данных, выгрузите ключ из памяти. Тогда ZFS " +"сделает набор данных недоступным до тех пор, пока ключ не будет загружен " +"снова." #. type: Plain text -#: documentation/content/en/books/handbook/zfs/_index.adoc:2378 -msgid "SID name such as _joe.bloggs@example.com_." -msgstr "Имя SID, например, _joe.bloggs@example.com_." +#: documentation/content/en/books/handbook/zfs/_index.adoc:3678 +msgid "" +"When encryption is enabled, some ZFS operations behave differently. ZFS " +"applies compression before encryption to preserve compression ratios. While " +"ZFS normally uses 256-bit checksums, encryption replaces them with a 128-bit " +"checksum and a 128-bit Message Authentication Code (MAC) provided by the " +"encryption suite. This provides additional protection against malicious " +"data modification." +msgstr "" +"Когда шифрование включено, некоторые операции ZFS ведут себя иначе. ZFS " +"применяет сжатие перед шифрованием, чтобы сохранить коэффициенты сжатия. " +"Хотя ZFS обычно использует 256-битные контрольные суммы, шифрование заменяет " +"их на 128-битную контрольную сумму и 128-битный код аутентификации сообщения " +"(MAC), предоставляемый набором шифрования. Это обеспечивает дополнительную " +"защиту от злонамеренного изменения данных." #. type: Plain text -#: documentation/content/en/books/handbook/zfs/_index.adoc:2379 -msgid "SID numeric ID such as _S-1-123-456-789_." -msgstr "Числовой идентификатор SID, например, _S-1-123-456-789_." +#: documentation/content/en/books/handbook/zfs/_index.adoc:3683 +msgid "" +"When deduplication is used together with encryption, ZFS performs " +"deduplication only within the encrypted dataset, its snapshots, and its " +"clones. This prevents information from leaking between encrypted datasets. " +"The tradeoff is lower deduplication efficiency because ZFS cannot compare " +"checksums across the entire pool. Even so, deduplication combined with " +"encryption still reveals which blocks are identical and incurs additional " +"CPU overhead for each block written." +msgstr "" +"Когда дедупликация используется вместе с шифрованием, ZFS выполняет " +"дедупликацию только в пределах зашифрованного набора данных, его снимков и " +"его клонов. Это предотвращает утечку информации между зашифрованными " +"наборами данных. Обратной стороной является более низкая эффективность " +"дедупликации, поскольку ZFS не может сравнивать контрольные суммы по всему " +"пулу. Тем не менее, дедупликация в сочетании с шифрованием всё равно " +"раскрывает, какие блоки идентичны, и добавляет дополнительные накладные " +"расходы на ЦП для каждого записываемого блока." #. type: Plain text -#: documentation/content/en/books/handbook/zfs/_index.adoc:2381 -msgid "For example, to enforce a user quota of 50 GB for the user named _joe_:" +#: documentation/content/en/books/handbook/zfs/_index.adoc:3687 +msgid "" +"Other limitations apply when using ZFS encryption. The `embedded_data` " +"feature cannot be used with encryption. Datasets with encryption enabled " +"also cannot have the `copies` property set to 3, because the implementation " +"stores encrypted metadata in the location where the third copy would " +"normally reside." msgstr "" -"Например, чтобы установить пользовательскую квоту в 50 ГБ для пользователя с " -"именем _joe_:" +"У шифрования ZFS также есть и другие ограничения. Возможность `embedded_data`" +" не может использоваться с шифрованием. Наборы данных с включенным " +"шифрованием также не могут иметь свойство `copies`, установленное в 3, " +"поскольку реализация хранит зашифрованные метаданные в том месте, где обычно " +"размещалась бы третья копия." -#. type: delimited block . 4 -#: documentation/content/en/books/handbook/zfs/_index.adoc:2385 +#. type: Title === +#: documentation/content/en/books/handbook/zfs/_index.adoc:3689 #, no-wrap -msgid "# zfs set userquota@joe=50G\n" -msgstr "# zfs set userquota@joe=50G\n" +msgid "Creating an Encrypted Dataset" +msgstr "Создание зашифрованного набора данных" #. type: Plain text -#: documentation/content/en/books/handbook/zfs/_index.adoc:2388 -msgid "To remove any quota:" -msgstr "Чтобы удалить любую квоту:" +#: documentation/content/en/books/handbook/zfs/_index.adoc:3694 +msgid "" +"ZFS encryption is enabled by setting the `encryption=on` property when " +"creating a dataset. Setting this property outside of a `zfs create` command " +"does not enable encryption retroactively, as it only takes effect during " +"dataset creation. In the following example, a passphrase is used when " +"mounting the encrypted dataset after it has been created." +msgstr "" +"Шифрование ZFS включается путем установки свойства `encryption=on` при " +"создании набора данных. Установка этого свойства вне команды `zfs create` не " +"включает шифрование задним числом, поскольку оно действует только во время " +"создания набора данных. В следующем примере для монтирования зашифрованного " +"набора данных после его создания используется парольная фраза." #. type: delimited block . 4 -#: documentation/content/en/books/handbook/zfs/_index.adoc:2392 +#: documentation/content/en/books/handbook/zfs/_index.adoc:3700 #, no-wrap -msgid "# zfs set userquota@joe=none\n" -msgstr "# zfs set userquota@joe=none\n" - -#. type: delimited block = 4 -#: documentation/content/en/books/handbook/zfs/_index.adoc:2399 msgid "" -"User quota properties are not displayed by `zfs get all`. Non-`root` users " -"can't see other's quotas unless granted the `userquota` privilege. Users " -"with this privilege are able to view and set everyone's quota." +"# zfs create -o encryption=on -o keyformat=passphrase -o keylocation=prompt zroot/secretdata\n" +"Enter passphrase:\n" +"Re-enter passphrase:\n" msgstr "" -"Свойства квот пользователей не отображаются командой `zfs get all`. " -"Пользователи без прав `root` не могут видеть квоты других, если им не " -"предоставлена привилегия `userquota`. Пользователи с этой привилегией могут " -"просматривать и устанавливать квоты для всех." +"# zfs create -o encryption=on -o keyformat=passphrase -o keylocation=prompt " +"zroot/secretdata\n" +"Enter passphrase:\n" +"Re-enter passphrase:\n" #. type: Plain text -#: documentation/content/en/books/handbook/zfs/_index.adoc:2402 +#: documentation/content/en/books/handbook/zfs/_index.adoc:3704 msgid "" -"The general format for setting a group quota is: `groupquota@_group_=_size_`." +"If the passphrase is shorter than eight characters, ZFS rejects it and does " +"not create the dataset. After the passphrase has been entered correctly " +"twice, ZFS creates and mounts the dataset in the pool." msgstr "" -"Общий формат для установки квоты группы: `groupquota@_группа_=_размер_`." +"Если парольная фраза короче восьми символов, ZFS отклоняет её и не создаёт " +"набор данных. После того как парольная фраза была введена правильно дважды, " +"ZFS создаёт и монтирует набор данных в пуле." #. type: Plain text -#: documentation/content/en/books/handbook/zfs/_index.adoc:2404 -msgid "To set the quota for the group _firstgroup_ to 50 GB, use:" -msgstr "Чтобы установить квоту для группы _firstgroup_ в 50 ГБ, используйте:" +#: documentation/content/en/books/handbook/zfs/_index.adoc:3708 +msgid "" +"Any data stored in the encrypted dataset remains encrypted while it resides " +"there. Copying data from an encrypted dataset to an unencrypted location " +"decrypts the data during the copy operation. The newly created dataset can " +"then be mounted at a different location if necessary." +msgstr "" +"Любые данные, хранящиеся в зашифрованном наборе данных, остаются " +"зашифрованными, пока они там находятся. Копирование данных из зашифрованного " +"набора данных в незашифрованное место расшифровывает данные во время " +"операции копирования. Затем вновь созданный набор данных можно при " +"необходимости смонтировать в другом месте." #. type: delimited block . 4 -#: documentation/content/en/books/handbook/zfs/_index.adoc:2408 +#: documentation/content/en/books/handbook/zfs/_index.adoc:3715 #, no-wrap -msgid "# zfs set groupquota@firstgroup=50G\n" -msgstr "# zfs set groupquota@firstgroup=50G\n" +msgid "" +"# zfs set mountpoint=/secretdata zroot/secretdata\n" +"# echo \"Hello FreeBSD!\" > /secretdata/message\n" +"# cat /secretdata/message\n" +"Hello FreeBSD!\n" +msgstr "" +"# zfs set mountpoint=/secretdata zroot/secretdata\n" +"# echo \"Hello FreeBSD!\" > /secretdata/message\n" +"# cat /secretdata/message\n" +"Hello FreeBSD!\n" #. type: Plain text -#: documentation/content/en/books/handbook/zfs/_index.adoc:2411 +#: documentation/content/en/books/handbook/zfs/_index.adoc:3718 msgid "" -"To remove the quota for the group _firstgroup_, or to make sure that one is " -"not set, instead use:" +"As expected, the data is currently available for reading and writing by " +"anyone who has access to the dataset." msgstr "" -"Чтобы удалить квоту для группы _firstgroup_ или убедиться, что она не " -"установлена, используйте вместо этого:" +"Как и ожидалось, данные в настоящее время доступны для чтения и записи " +"любому, у кого есть доступ к набору данных." -#. type: delimited block . 4 -#: documentation/content/en/books/handbook/zfs/_index.adoc:2415 +#. type: Title === +#: documentation/content/en/books/handbook/zfs/_index.adoc:3720 #, no-wrap -msgid "# zfs set groupquota@firstgroup=none\n" -msgstr "# zfs set groupquota@firstgroup=none\n" +msgid "Properties of Encrypted Datasets" +msgstr "Свойства зашифрованных наборов данных" #. type: Plain text -#: documentation/content/en/books/handbook/zfs/_index.adoc:2419 +#: documentation/content/en/books/handbook/zfs/_index.adoc:3723 msgid "" -"As with the user quota property, non-`root` users can see the quotas " -"associated with the groups to which they belong. A user with the " -"`groupquota` privilege or `root` can view and set all quotas for all groups." +"Listing the ZFS native encryption properties for a dataset is done with the " +"following command:" msgstr "" -"Как и в случае с пользовательскими квотами, пользователи без прав `root` " -"могут видеть квоты, связанные с группами, к которым они принадлежат. " -"Пользователь с привилегией `groupquota` или `root` может просматривать и " -"устанавливать квоты для всех групп." +"Перечисление свойств собственного шифрования ZFS для набора данных " +"выполняется с помощью следующей команды:" -#. type: Plain text -#: documentation/content/en/books/handbook/zfs/_index.adoc:2423 +#. type: delimited block . 4 +#: documentation/content/en/books/handbook/zfs/_index.adoc:3731 +#, no-wrap msgid "" -"To display the amount of space used by each user on a file system or " -"snapshot along with any quotas, use `zfs userspace`. For group information, " -"use `zfs groupspace`. For more information about supported options or how " -"to display specific options alone, refer to man:zfs[1]." +"# zfs get encryption,keylocation,keyformat zroot/secretdata\n" +"NAME PROPERTY VALUE SOURCE\n" +"zroot/secretdata encryption aes-256-gcm -\n" +"zroot/secretdata keylocation prompt local\n" +"zroot/secretdata keyformat passphrase -\n" msgstr "" -"Для отображения объёма пространства, используемого каждым пользователем в " -"файловой системе или снимке, вместе с квотами, используйте `zfs userspace`. " -"Для информации о группах используйте `zfs groupspace`. Подробнее о " -"поддерживаемых опциях или о том, как отобразить только определённые опции, " -"см. в man:zfs[1]." +"# zfs get encryption,keylocation,keyformat zroot/secretdata\n" +"NAME PROPERTY VALUE SOURCE\n" +"zroot/secretdata encryption aes-256-gcm -\n" +"zroot/secretdata keylocation prompt local\n" +"zroot/secretdata keyformat passphrase -\n" #. type: Plain text -#: documentation/content/en/books/handbook/zfs/_index.adoc:2425 +#: documentation/content/en/books/handbook/zfs/_index.adoc:3737 msgid "" -"Privileged users and `root` can list the quota for [.filename]#storage/home/" -"bob# using:" +"The `encryption` property shows `aes-256-gcm`, which is currently the " +"default encryption method used by ZFS. As indicated by the `SOURCE` column, " +"neither this property nor the `keyformat` property can be changed using `zfs " +"set` after the dataset has been created. See the crossref:zfs[zfs-change-" +"encryption-key,changing the encryption key] section for information on how " +"to modify some of these properties. The following table lists the " +"encryption-related properties used by ZFS:" msgstr "" -"Привилегированные пользователи и `root` могут просмотреть квоту для [." -"filename]#storage/home/bob#, используя:" +"Свойство `encryption` показывает `aes-256-gcm`, который в настоящее время " +"является методом шифрования, используемым ZFS по умолчанию. Как указано в " +"столбце `SOURCE`, ни это свойство, ни свойство `keyformat` нельзя изменить с " +"помощью `zfs set` после создания набора данных. Смотрите раздел crossref:zfs" +"[zfs-change-encryption-key,изменение ключа шифрования] для получения " +"информации о том, как изменить некоторые из этих свойств. В следующей " +"таблице перечислены свойства, связанные с шифрованием, используемые ZFS:" -#. type: delimited block . 4 -#: documentation/content/en/books/handbook/zfs/_index.adoc:2429 +#. type: Table +#: documentation/content/en/books/handbook/zfs/_index.adoc:3743 #, no-wrap -msgid "# zfs get quota storage/home/bob\n" -msgstr "# zfs get quota storage/home/bob\n" +msgid "[[zfs-term-encryptionroot]]encryptionroot" +msgstr "[[zfs-term-encryptionroot]]encryptionroot" -#. type: Title === -#: documentation/content/en/books/handbook/zfs/_index.adoc:2432 +#. type: Table +#: documentation/content/en/books/handbook/zfs/_index.adoc:3746 #, no-wrap -msgid "Reservations" -msgstr "Резервирования" +msgid "" +"The dataset from which the current dataset inherits its encryption key.\n" +"Dataset clones share the encryption key of their originating dataset." +msgstr "" +"Набор данных, из которого текущий набор данных наследует свой ключ " +"шифрования.\n" +"Клоны наборов данных разделяют ключ шифрования своего исходного набора " +"данных." -#. type: Plain text -#: documentation/content/en/books/handbook/zfs/_index.adoc:2437 +#. type: Table +#: documentation/content/en/books/handbook/zfs/_index.adoc:3747 +#, no-wrap +msgid "[[zfs-term-keyformat]]keyformat" +msgstr "[[zfs-term-keyformat]]keyformat" + +#. type: Table +#: documentation/content/en/books/handbook/zfs/_index.adoc:3748 +#, no-wrap +msgid "The format of the encryption key. Possible values are: `raw`, `hex`, and `passphrase`. Both `raw` and `hex` keys must be 32 bytes long and contain random values." +msgstr "" +"Формат ключа шифрования. Возможные значения: `raw`, `hex` и `passphrase`. " +"Как `raw`, так и `hex` ключи должны иметь длину 32 байта и содержать " +"случайные значения." + +#. type: Table +#: documentation/content/en/books/handbook/zfs/_index.adoc:3749 +#, no-wrap +msgid "[[zfs-term-encryption]]encryption" +msgstr "[[zfs-term-encryption]]encryption" + +#. type: Table +#: documentation/content/en/books/handbook/zfs/_index.adoc:3762 +#, no-wrap msgid "" -"crossref:zfs[zfs-term-reservation,Reservations] guarantee an always-" -"available amount of space on a dataset. The reserved space will not be " -"available to any other dataset. This useful feature ensures that free space " -"is available for an important dataset or log files." +"The cipher used for encryption, consisting of the block cipher, key length, and encryption mode. Both the `encryption` and `keyformat` properties must be specified when the dataset is created. Possible values for the `encryption` property are:\n" +"\n" +" * `off` (default),\n" +" * `on`,\n" +" * `aes-128-ccm`,\n" +" * `aes-192-ccm`,\n" +" * `aes-256-ccm`,\n" +" * `aes-128-gcm`,\n" +" * `aes-192-gcm`, and\n" +" * `aes-256-gcm` (current standard when `on` is set).\n" +"\n" +"This property cannot be changed once it has been set." msgstr "" -"crossref:zfs[zfs-term-reservation,Резервирования] гарантируют всегда " -"доступный объём пространства в наборе данных. Зарезервированное пространство " -"не будет доступно для других наборов данных. Эта полезная функция " -"обеспечивает наличие свободного места для важных наборов данных или файлов " -"журналов." +"Шифр, используемый для шифрования, состоящий из блочного шифра, длины ключа " +"и режима шифрования. Свойства `encryption` и `keyformat` должны быть указаны " +"при создании набора данных. Возможные значения свойства `encryption`:\n" +"\n" +" * `off` (по умолчанию),\n" +" * `on`,\n" +" * `aes-128-ccm`,\n" +" * `aes-192-ccm`,\n" +" * `aes-256-ccm`,\n" +" * `aes-128-gcm`,\n" +" * `aes-192-gcm` и\n" +" * `aes-256-gcm` (текущий стандарт при установке `on`).\n" +"\n" +"Это свойство нельзя изменить после того, как оно было установлено." -#. type: Plain text -#: documentation/content/en/books/handbook/zfs/_index.adoc:2439 +#. type: Table +#: documentation/content/en/books/handbook/zfs/_index.adoc:3763 +#, no-wrap +msgid "[[zfs-term-keystatus]]keystatus" +msgstr "[[zfs-term-keystatus]]keystatus" + +#. type: Table +#: documentation/content/en/books/handbook/zfs/_index.adoc:3765 +#, no-wrap +msgid "Indicates whether an encryption key has been successfully loaded. Possible values are `none`, `available`, and `unavailable`." +msgstr "" +"Указывает, был ли успешно загружен ключ шифрования. Возможные значения: " +"`none`, `available` и `unavailable`." + +#. type: Table +#: documentation/content/en/books/handbook/zfs/_index.adoc:3766 +#, no-wrap +msgid "[[zfs-term-keylocation]]keylocation" +msgstr "[[zfs-term-keylocation]]keylocation" + +#. type: Table +#: documentation/content/en/books/handbook/zfs/_index.adoc:3773 +#, no-wrap msgid "" -"The general format of the `reservation` property is `reservation=_size_`, so " -"to set a reservation of 10 GB on [.filename]#storage/home/bob#, use:" +"Specifies the location from which to load the encryption key. Possible values are:\n" +"\n" +"* `prompt`,\n" +"* `file://path/to/file`,\n" +"* `http://some.address`, and\n" +"* `https://other.address`" msgstr "" -"Общий формат свойства `reservation` — `reservation=_размер_`, поэтому, чтобы " -"установить резервирование в 10 ГБ для [.filename]#storage/home/bob#, " -"используйте:" +"Указывает местоположение, из которого следует загрузить ключ шифрования. " +"Возможные значения:\n" +"\n" +"* `prompt`,\n" +"* `file://path/to/file`,\n" +"* `http://some.address` и\n" +"* `https://other.address`" -#. type: delimited block . 4 -#: documentation/content/en/books/handbook/zfs/_index.adoc:2443 +#. type: Table +#: documentation/content/en/books/handbook/zfs/_index.adoc:3774 #, no-wrap -msgid "# zfs set reservation=10G storage/home/bob\n" -msgstr "# zfs set reservation=10G storage/home/bob\n" +msgid "[[zfs-term-pbkdf2iters]]pbkdf2iters" +msgstr "[[zfs-term-pbkdf2iters]]pbkdf2iters" + +#. type: Table +#: documentation/content/en/books/handbook/zfs/_index.adoc:3775 +#, no-wrap +msgid "The number of iterations used when deriving an encryption key from a passphrase. This forces an attacker to perform a large number of computationally expensive hash operations. As computing power increases, this value should also be increased from its current default of 350000." +msgstr "" +"Количество итераций, используемых при получении ключа шифрования из " +"парольной фразы. Это вынуждает злоумышленника выполнять большое количество " +"вычислительно затратных операций хеширования. По мере роста вычислительной " +"мощности это значение также следует увеличивать с текущего значения по " +"умолчанию, равного 350000." + +#. type: Title === +#: documentation/content/en/books/handbook/zfs/_index.adoc:3778 +#, no-wrap +msgid "Unloading the Encryption Key" +msgstr "Выгрузка ключа шифрования" #. type: Plain text -#: documentation/content/en/books/handbook/zfs/_index.adoc:2446 -msgid "To clear any reservation:" -msgstr "Чтобы очистить любое резервирование:" +#: documentation/content/en/books/handbook/zfs/_index.adoc:3786 +msgid "" +"Protecting the data stored in an encrypted dataset requires two steps: first " +"unmount the dataset, then unload the encryption key from memory. This " +"distinction is important. An unmounted dataset is not protected if its " +"encryption key remains loaded in memory. Always run `zfs unload-key` to " +"protect the data. To access the dataset again, load the key and provide the " +"passphrase as described in the crossref:zfs[zfs-load-encryption-key,loading " +"the encryption key] section. ZFS prevents `zfs unload-key` from running " +"while the dataset is still mounted." +msgstr "" +"Защита данных, хранящихся в зашифрованном наборе данных, требует двух шагов: " +"сначала размонтировать набор данных, затем выгрузить ключ шифрования из " +"памяти. Это различие важно. Размонтированный набор данных не защищён, если " +"его ключ шифрования остаётся загруженным в памяти. Всегда выполняйте `zfs " +"unload-key`, чтобы защитить данные. Чтобы снова получить доступ к набору " +"данных, загрузите ключ и укажите парольную фразу, как описано в разделе " +"crossref:zfs[zfs-load-encryption-key,загрузка ключа шифрования]. ZFS " +"предотвращает выполнение `zfs unload-key`, пока набор данных всё ещё " +"смонтирован." #. type: delimited block . 4 -#: documentation/content/en/books/handbook/zfs/_index.adoc:2450 +#: documentation/content/en/books/handbook/zfs/_index.adoc:3791 #, no-wrap -msgid "# zfs set reservation=none storage/home/bob\n" -msgstr "# zfs set reservation=none storage/home/bob\n" +msgid "" +"# zfs unmount zroot/secretdata\n" +"# zfs unload-key zroot/secretdata\n" +msgstr "" +"# zfs unmount zroot/secretdata\n" +"# zfs unload-key zroot/secretdata\n" #. type: Plain text -#: documentation/content/en/books/handbook/zfs/_index.adoc:2454 +#: documentation/content/en/books/handbook/zfs/_index.adoc:3794 msgid "" -"The same principle applies to the `refreservation` property for setting a " -"crossref:zfs[zfs-term-refreservation,Reference Reservation], with the " -"general format `refreservation=_size_`." +"Running `zfs unload-key` multiple times results in an error indicating that " +"the key has already been unloaded." msgstr "" -"Тот же принцип применяется к свойству `refreservation` для установки " -"crossref:zfs[zfs-term-refreservation,Референсного резервирования], с общим " -"форматом `refreservation=_размер_`." +"Выполнение `zfs unload-key` несколько раз приводит к ошибке, указывающей на " +"то, что ключ уже был выгружен." + +#. type: Title === +#: documentation/content/en/books/handbook/zfs/_index.adoc:3796 +#, no-wrap +msgid "Loading the Encryption Key" +msgstr "Загрузка ключа шифрования" #. type: Plain text -#: documentation/content/en/books/handbook/zfs/_index.adoc:2456 +#: documentation/content/en/books/handbook/zfs/_index.adoc:3800 msgid "" -"This command shows any reservations or refreservations that exist on [." -"filename]#storage/home/bob#:" +"Before an encrypted dataset can be used like any other dataset, its " +"encryption key must be loaded and the passphrase provided. At this point, " +"the `keystatus` property is still set to `unavailable`, and mounting the " +"dataset fails because the key has not yet been loaded:" msgstr "" -"Эта команда показывает все и резервирования (`reservation`), и референсные " -"резервирования (`refreservation`), существующие в [.filename]#storage/home/" -"bob#:" +"Прежде чем зашифрованный набор данных можно будет использовать, как и любой " +"другой набор данных, необходимо загрузить его ключ шифрования и указать " +"парольную фразу. На этом этапе свойство `keystatus` по-прежнему имеет " +"значение `unavailable`, и монтирование набора данных завершается ошибкой, " +"поскольку ключ ещё не был загружен:" #. type: delimited block . 4 -#: documentation/content/en/books/handbook/zfs/_index.adoc:2461 +#: documentation/content/en/books/handbook/zfs/_index.adoc:3808 #, no-wrap msgid "" -"# zfs get reservation storage/home/bob\n" -"# zfs get refreservation storage/home/bob\n" +"# zfs get keystatus zroot/secretdata\n" +"NAME PROPERTY VALUE SOURCE\n" +"zroot/secretdata keystatus unavailable -\n" +"# zfs mount zroot/secretdata\n" +"cannot mount 'zroot/secretdata': encryption key not loaded\n" msgstr "" -"# zfs get reservation storage/home/bob\n" -"# zfs get refreservation storage/home/bob\n" +"# zfs get keystatus zroot/secretdata\n" +"NAME PROPERTY VALUE SOURCE\n" +"zroot/secretdata keystatus unavailable -\n" +"# zfs mount zroot/secretdata\n" +"cannot mount 'zroot/secretdata': encryption key not loaded\n" -#. type: Title === -#: documentation/content/en/books/handbook/zfs/_index.adoc:2464 +#. type: Plain text +#: documentation/content/en/books/handbook/zfs/_index.adoc:3812 +msgid "" +"This indicates that the dataset is encrypted and requires an encryption " +"key. To mount the dataset, run `zfs load-key` and provide the passphrase " +"when prompted:" +msgstr "" +"Это указывает на то, что набор данных зашифрован и требует ключ шифрования. " +"Чтобы смонтировать набор данных, выполните `zfs load-key` и введите " +"парольную фразу при появлении запроса:" + +#. type: delimited block . 4 +#: documentation/content/en/books/handbook/zfs/_index.adoc:3820 #, no-wrap -msgid "Compression" -msgstr "Сжатие" +msgid "" +"# zfs load-key zroot/secretdata\n" +"Enter passphrase for 'zroot/secretdata':\n" +"# zfs get keystatus zroot/secretdata\n" +"NAME PROPERTY VALUE SOURCE\n" +"zroot/secretdata keystatus available -\n" +msgstr "" +"# zfs load-key zroot/secretdata\n" +"Enter passphrase for 'zroot/secretdata':\n" +"# zfs get keystatus zroot/secretdata\n" +"NAME PROPERTY VALUE SOURCE\n" +"zroot/secretdata keystatus available -\n" #. type: Plain text -#: documentation/content/en/books/handbook/zfs/_index.adoc:2471 +#: documentation/content/en/books/handbook/zfs/_index.adoc:3823 msgid "" -"ZFS provides transparent compression. Compressing data written at the block " -"level saves space and also increases disk throughput. If data compresses by " -"25% the compressed data writes to the disk at the same rate as the " -"uncompressed version, resulting in an effective write speed of 125%. " -"Compression can also be a great alternative to crossref:zfs[zfs-zfs-" -"deduplication,Deduplication] because it does not require extra memory." +"Next, mount the dataset to make it accessible through the filesystem " +"hierarchy:" msgstr "" -"ZFS предоставляет прозрачное сжатие. Сжатие данных на уровне блоков экономит " -"место и увеличивает пропускную способность диска. Если данные сжимаются на " -"25%, то сжатые данные записываются на диск с той же скоростью, что и " -"несжатые, что приводит к эффективной скорости записи в 125%. Сжатие также " -"может быть отличной альтернативой crossref:zfs[zfs-zfs-deduplication," -"Дедупликации], так как не требует дополнительной памяти." +"Затем смонтируйте набор данных, чтобы сделать его доступным через иерархию " +"файловой системы:" -#. type: Plain text -#: documentation/content/en/books/handbook/zfs/_index.adoc:2478 +#. type: delimited block . 4 +#: documentation/content/en/books/handbook/zfs/_index.adoc:3829 +#, no-wrap msgid "" -"ZFS offers different compression algorithms, each with different trade-" -"offs. The introduction of LZ4 compression in ZFS v5000 enables compressing " -"the entire pool without the large performance trade-off of other " -"algorithms. The biggest advantage to LZ4 is the _early abort_ feature. If " -"LZ4 does not achieve at least 12.5% compression in the header part of the " -"data, ZFS writes the block uncompressed to avoid wasting CPU cycles trying " -"to compress data that is either already compressed or uncompressible. For " -"details about the different compression algorithms available in ZFS, see the " -"crossref:zfs[zfs-term-compression,Compression] entry in the terminology " -"section." +"# zfs mount zroot/secretdata\n" +"# mount|grep secretdata\n" +"zroot/secretdata on /secretdata (zfs, local, noatime, nfsv4acls)\n" msgstr "" -"ZFS предлагает различные алгоритмы сжатия, каждый со своими компромиссами. " -"Введение сжатия LZ4 в ZFS v5000 позволяет сжимать весь пул без значительного " -"снижения производительности, характерного для других алгоритмов. Главное " -"преимущество LZ4 — функция _раннего прерывания_. Если LZ4 не достигает как " -"минимум 12,5% сжатия в заголовочной части данных, ZFS записывает блок без " -"сжатия, чтобы избежать потерь процессорного времени на попытки сжать уже " -"сжатые или несжимаемые данные. Подробнее о различных алгоритмах сжатия, " -"доступных в ZFS, см. в разделе crossref:zfs[zfs-term-compression,Сжатие] " -"терминологии." +"# zfs mount zroot/secretdata\n" +"# mount|grep secretdata\n" +"zroot/secretdata on /secretdata (zfs, local, noatime, nfsv4acls)\n" #. type: Plain text -#: documentation/content/en/books/handbook/zfs/_index.adoc:2480 +#: documentation/content/en/books/handbook/zfs/_index.adoc:3833 msgid "" -"The administrator can see the effectiveness of compression using dataset " -"properties." +"To load multiple encryption keys recursively, specify the `-r` option with " +"`zfs load-key`. If a key has already been loaded, ZFS reports this with an " +"error message." msgstr "" -"Администратор может оценить эффективность сжатия, используя свойства набора " -"данных." +"Чтобы рекурсивно загрузить несколько ключей шифрования, укажите параметр `-r`" +" с командой `zfs load-key`. Если ключ уже был загружен, ZFS сообщает об этом " +"сообщением об ошибке." #. type: delimited block . 4 -#: documentation/content/en/books/handbook/zfs/_index.adoc:2489 +#: documentation/content/en/books/handbook/zfs/_index.adoc:3838 #, no-wrap msgid "" -"# zfs get used,compressratio,compression,logicalused mypool/compressed_dataset\n" -"NAME PROPERTY VALUE SOURCE\n" -"mypool/compressed_dataset used 449G -\n" -"mypool/compressed_dataset compressratio 1.11x -\n" -"mypool/compressed_dataset compression lz4 local\n" -"mypool/compressed_dataset logicalused 496G -\n" +"# zfs load-key zroot/secretdata\n" +"Key load error: Key already loaded for 'zroot/secretdata'.\n" msgstr "" -"# zfs get used,compressratio,compression,logicalused mypool/compressed_dataset\n" -"NAME PROPERTY VALUE SOURCE\n" -"mypool/compressed_dataset used 449G -\n" -"mypool/compressed_dataset compressratio 1.11x -\n" -"mypool/compressed_dataset compression lz4 local\n" -"mypool/compressed_dataset logicalused 496G -\n" +"# zfs load-key zroot/secretdata\n" +"Key load error: Key already loaded for 'zroot/secretdata'.\n" #. type: Plain text -#: documentation/content/en/books/handbook/zfs/_index.adoc:2494 +#: documentation/content/en/books/handbook/zfs/_index.adoc:3842 msgid "" -"The dataset is using 449 GB of space (the used property). Without " -"compression, it would have taken 496 GB of space (the `logicalused` " -"property). This results in a 1.11:1 compression ratio." +"The `keystatus` property also confirms that the key has been loaded by " +"reporting the value `available`. To verify whether a passphrase is correct " +"without loading the key, use the `-n` option to perform a dry run." msgstr "" -"Набор данных использует 449 ГБ пространства (свойство `used`). Без сжатия он " -"занял бы 496 ГБ пространства (свойство `logicalused`). Это даёт коэффициент " -"сжатия 1.11:1." +"Свойство `keystatus` также подтверждает, что ключ был загружен, сообщая " +"значение `available`. Чтобы проверить, корректен ли пароль, не загружая " +"ключ, используйте параметр `-n` для выполнения пробного запуска." + +#. type: Title === +#: documentation/content/en/books/handbook/zfs/_index.adoc:3844 +#, no-wrap +msgid "Changing the Encryption Key" +msgstr "Изменение ключа шифрования" #. type: Plain text -#: documentation/content/en/books/handbook/zfs/_index.adoc:2501 +#: documentation/content/en/books/handbook/zfs/_index.adoc:3849 msgid "" -"Compression can have an unexpected side effect when combined with crossref:" -"zfs[zfs-term-userquota,User Quotas]. User quotas restrict how much actual " -"space a user consumes on a dataset _after compression_. If a user has a " -"quota of 10 GB, and writes 10 GB of compressible data, they will still be " -"able to store more data. If they later update a file, say a database, with " -"more or less compressible data, the amount of space available to them will " -"change. This can result in the odd situation where a user did not increase " -"the actual amount of data (the `logicalused` property), but the change in " -"compression caused them to reach their quota limit." +"ZFS also supports changing encryption keys, such as replacing a passphrase. " +"This operation does not require re-encrypting the dataset. Run the " +"following command to change the encryption passphrase:" msgstr "" -"Сжатие может иметь неожиданный побочный эффект при использовании вместе с " -"crossref:zfs[zfs-term-userquota,Квотами пользователей]. Квоты пользователей " -"ограничивают фактическое пространство, которое пользователь занимает на " -"наборе данных _после сжатия_. Если у пользователя есть квота в 10 ГБ, и он " -"записывает 10 ГБ сжимаемых данных, он всё равно сможет сохранить больше " -"данных. Если позже пользователь обновит файл, например базу данных, более " -"или менее сжимаемыми данными, количество доступного ему пространства " -"изменится. Это может привести к необычной ситуации, когда пользователь не " -"увеличил фактический объём данных (свойство `logicalused`), но изменение " -"степени сжатия привело к достижению предела его квоты." +"ZFS также поддерживает смену ключей шифрования, например, замену парольной " +"фразы. Эта операция не требует повторного шифрования набора данных. " +"Выполните следующую команду, чтобы изменить парольную фразу шифрования:" + +#. type: delimited block . 4 +#: documentation/content/en/books/handbook/zfs/_index.adoc:3855 +#, no-wrap +msgid "" +"# zfs change-key zroot/secretdata\n" +"Enter new passphrase for 'zroot/secretdata':\n" +"Re-enter new passphrase for 'zroot/secretdata':\n" +msgstr "" +"# zfs change-key zroot/secretdata\n" +"Enter new passphrase for 'zroot/secretdata':\n" +"Re-enter new passphrase for 'zroot/secretdata':\n" #. type: Plain text -#: documentation/content/en/books/handbook/zfs/_index.adoc:2505 +#: documentation/content/en/books/handbook/zfs/_index.adoc:3859 msgid "" -"Compression can have a similar unexpected interaction with backups. Quotas " -"are often used to limit data storage to ensure there is enough backup space " -"available. Since quotas do not consider compression ZFS may write more data " -"than would fit with uncompressed backups." +"Running `zfs change-key` requires the current key to be loaded. If it is " +"not, ZFS still prompts for the new key but then displays a warning that the " +"current key has not been loaded." msgstr "" -"Сжатие может иметь схожий непредвиденный эффект при взаимодействии с " -"резервными копиями. Квоты часто используются для ограничения хранимых " -"данных, чтобы гарантировать наличие достаточного места для резервного " -"копирования. Поскольку квоты не учитывают сжатие, ZFS может записать больше " -"данных, чем поместилось бы при резервном копировании без сжатия." +"Выполнение `zfs change-key` требует, чтобы текущий ключ был загружен. Если " +"он не загружен, ZFS всё равно запросит новый ключ, но затем выведет " +"предупреждение о том, что текущий ключ не был загружен." -#. type: Title === -#: documentation/content/en/books/handbook/zfs/_index.adoc:2507 -#, no-wrap -msgid "Zstandard Compression" -msgstr "Сжатие алгоритмом Zstandard" +#. type: Plain text +#: documentation/content/en/books/handbook/zfs/_index.adoc:3863 +msgid "" +"The `zfs change-key` command can also modify the `keylocation`, `keyformat`, " +"and `pbkdf2iters` properties by specifying them with the `-o` option. " +"Running `zfs change-key` on an encrypted child dataset makes it an " +"encryption root if it is not one already. To prevent this behavior and " +"continue inheriting the parent's key, specify the `-i` option." +msgstr "" +"Команда `zfs change-key` также может изменять свойства `keylocation`, " +"`keyformat` и `pbkdf2iters`, указывая их с помощью опции `-o`. Выполнение `" +"zfs change-key` над зашифрованным дочерним набором данных делает его корнем " +"шифрования, если он еще не является таковым. Чтобы предотвратить такое " +"поведение и продолжить наследование ключа родительского набора, укажите " +"опцию `-i`." #. type: Plain text -#: documentation/content/en/books/handbook/zfs/_index.adoc:2511 +#: documentation/content/en/books/handbook/zfs/_index.adoc:3868 msgid "" -"OpenZFS 2.0 added a new compression algorithm. Zstandard (Zstd) offers " -"higher compression ratios than the default LZ4 while offering much greater " -"speeds than the alternative, gzip. OpenZFS 2.0 is available starting with " -"FreeBSD 12.1-RELEASE via package:sysutils/openzfs[] and has been the default " -"since FreeBSD 13.0-RELEASE." +"Be aware that changing the encryption key of a parent dataset also changes " +"the key for child datasets that inherit it. Consequently, those child " +"datasets continue to use the parent's encryption key. If a child dataset " +"should use a different key, either specify a different `keyformat` when " +"creating it or run `zfs change-key` on the child dataset. Doing so creates " +"a new encryption root for the child and breaks its encryption inheritance " +"from the parent." msgstr "" -"В OpenZFS 2.0 был добавлен новый алгоритм сжатия. Zstandard (Zstd) " -"обеспечивает более высокие коэффициенты сжатия по сравнению с используемым " -"по умолчанию LZ4, при этом работая значительно быстрее альтернативного gzip. " -"OpenZFS 2.0 доступен начиная с FreeBSD 12.1-RELEASE в пакете package:" -"sysutils/openzfs[] и является стандартным начиная с FreeBSD 13.0-RELEASE." +"Имейте в виду, что смена ключа шифрования родительского набора данных также " +"меняет ключ для дочерних наборов данных, которые его наследуют. " +"Следовательно, эти дочерние наборы данных продолжают использовать ключ " +"шифрования родителя. Если дочерний набор данных должен использовать другой " +"ключ, либо укажите другой `keyformat` при его создании, либо выполните `zfs " +"change-key` для дочернего набора данных. Это создаст новый корень шифрования " +"для дочернего элемента и разорвёт его наследование шифрования от родителя." #. type: Plain text -#: documentation/content/en/books/handbook/zfs/_index.adoc:2515 +#: documentation/content/en/books/handbook/zfs/_index.adoc:3873 msgid "" -"Zstd provides a large selection of compression levels, providing fine-" -"grained control over performance versus compression ratio. One of the main " -"advantages of Zstd is that the decompression speed is independent of the " -"compression level. For data written once but read often, Zstd allows the " -"use of the highest compression levels without a read performance penalty." +"ZFS clones of an encrypted dataset always use the encryption key of their " +"origin dataset. As a result, the `keystatus`, `keyformat`, `keylocation`, " +"and `pbkdf2iters` properties are not inherited like other dataset " +"properties. Instead, they use the values defined by the encryption root. " +"To determine the encryption root, use the read-only `encryptionroot` " +"property." msgstr "" -"Zstd предоставляет широкий выбор уровней сжатия, обеспечивая детальный " -"контроль над производительностью и степенью сжатия. Одним из основных " -"преимуществ Zstd является то, что скорость распаковки не зависит от уровня " -"сжатия. Для данных, которые записываются один раз, но часто читаются, Zstd " -"позволяет использовать максимальные уровни сжатия без потери " -"производительности при чтении." +"Клоны ZFS зашифрованного набора данных всегда используют ключ шифрования " +"своего исходного набора данных. В результате свойства `keystatus`, " +"`keyformat`, `keylocation` и `pbkdf2iters` не наследуются, как другие " +"свойства набора данных. Вместо этого они используют значения, определённые " +"корнем шифрования. Чтобы определить корень шифрования, используйте свойство " +"`encryptionroot` только для чтения." #. type: Plain text -#: documentation/content/en/books/handbook/zfs/_index.adoc:2520 +#: documentation/content/en/books/handbook/zfs/_index.adoc:3878 msgid "" -"Even with frequent data updates, enabling compression often provides higher " -"performance. One of the biggest advantages comes from the compressed ARC " -"feature. ZFS's Adaptive Replacement Cache (ARC) caches the compressed " -"version of the data in RAM, decompressing it each time. This allows the " -"same amount of RAM to store more data and metadata, increasing the cache hit " -"ratio." +"If an attacker compromises an encryption key, changing the passphrase with " +"`zfs change-key` does not necessarily protect existing or newly written " +"data. New data continues to be encrypted with the same master key as the " +"existing data. If an attacker obtains both a user key and its corresponding " +"wrapped master key, running `zfs change-key` does not overwrite the previous " +"master key on disk. As a result, the old master key may remain available " +"for forensic analysis for an indeterminate period." msgstr "" -"Даже при частом обновлении данных включение сжатия часто обеспечивает более " -"высокую производительность. Одно из главных преимуществ связано с функцией " -"сжатого ARC. Адаптивный кэш замещения (ARC Adaptive Replacement Cache) в ZFS " -"хранит сжатую версию данных в оперативной памяти, распаковывая их при каждом " -"обращении. Это позволяет хранить больше данных и метаданных в том же объёме " -"памяти, повышая коэффициент попадания в кэш." +"Если злоумышленник скомпрометировал ключ шифрования, смена парольной фразы с " +"помощью `zfs change-key` не обязательно защитит существующие или вновь " +"записанные данные. Новые данные продолжают шифроваться тем же мастер-ключом, " +"что и существующие. Если злоумышленник получит как пользовательский ключ, " +"так и соответствующий обёрнутый мастер-ключ, выполнение `zfs change-key` не " +"перезапишет предыдущий мастер-ключ на диске. В результате старый мастер-ключ " +"может оставаться доступным для анализа данных в течение неопределённого " +"периода времени." #. type: Plain text -#: documentation/content/en/books/handbook/zfs/_index.adoc:2526 +#: documentation/content/en/books/handbook/zfs/_index.adoc:3883 msgid "" -"ZFS offers 19 levels of Zstd compression, each offering incrementally more " -"space savings in exchange for slower compression. The default level is " -"`zstd-3` and offers greater compression than LZ4 without being much slower. " -"Levels above 10 require large amounts of memory to compress each block and " -"systems with less than 16 GB of RAM should not use them. ZFS uses a " -"selection of the Zstd_fast_ levels also, which get correspondingly faster " -"but supports lower compression ratios. ZFS supports `zstd-fast-1` through " -"`zstd-fast-10`, `zstd-fast-20` through `zstd-fast-100` in increments of 10, " -"and `zstd-fast-500` and `zstd-fast-1000` which provide minimal compression, " -"but offer high performance." -msgstr "" -"ZFS предлагает 19 уровней сжатия Zstd, каждый из которых обеспечивает " -"постепенное увеличение экономии места в обмен на более медленное сжатие. " -"Уровень по умолчанию — `zstd-3`, который обеспечивает лучшее сжатие, чем " -"LZ4, без значительного снижения скорости. Уровни выше 10 требуют большого " -"объёма памяти для сжатия каждого блока, и системы с менее чем 16 ГБ ОЗУ не " -"должны их использовать. ZFS также использует подмножество уровней " -"Zstd_fast_, которые работают быстрее, но обеспечивают меньшую степень " -"сжатия. ZFS поддерживает уровни от `zstd-fast-1` до `zstd-fast-10`, от `zstd-" -"fast-20` до `zstd-fast-100` с шагом 10, а также `zstd-fast-500` и `zstd-" -"fast-1000`, которые обеспечивают минимальное сжатие, но обладают высокой " -"производительностью." +"If a master key has been compromised, the preferred solution is to securely " +"erase the underlying storage devices and create a new pool. Afterwards, " +"restore the data from a backup to the new pool. Alternatively, create a new " +"encrypted dataset, migrate the data using `zfs send` and `zfs receive`, and " +"then run `zpool trim --secure` to erase the freed space. If the underlying " +"hardware does not support secure TRIM, use `zpool initialize` instead." +msgstr "" +"Если мастер-ключ был скомпрометирован, предпочтительным решением является " +"безопасное стирание нижележащих устройств хранения и создание нового пула. " +"После этого восстановите данные из резервной копии в новый пул. Или создайте " +"новый зашифрованный набор данных, перенесите данные с помощью `zfs send` и `" +"zfs receive`, а затем выполните `zpool trim --secure`, чтобы стереть " +"освободившееся пространство. Если нижележащее оборудование не поддерживает " +"безопасный TRIM, вместо этого используйте `zpool initialize`." + +#. type: Title === +#: documentation/content/en/books/handbook/zfs/_index.adoc:3885 +#, no-wrap +msgid "Sending Encrypted Datasets" +msgstr "Отправка зашифрованных наборов данных" #. type: Plain text -#: documentation/content/en/books/handbook/zfs/_index.adoc:2530 +#: documentation/content/en/books/handbook/zfs/_index.adoc:3889 msgid "" -"If ZFS is not able to get the required memory to compress a block with Zstd, " -"it will fall back to storing the block uncompressed. This is unlikely to " -"happen except at the highest levels of Zstd on memory constrained systems. " -"ZFS counts how often this has occurred since loading the ZFS module with " -"`kstat.zfs.misc.zstd.compress_alloc_fail`." +"ZFS replication is based on sending dataset snapshots, which can also be " +"created from encrypted datasets. The resulting snapshots remain encrypted." msgstr "" -"Если ZFS не может получить необходимую память для сжатия блока с помощью " -"Zstd, он переходит к сохранению блока в несжатом виде. Это маловероятно, за " -"исключением случаев использования максимальных уровней Zstd на системах с " -"ограниченной памятью. ZFS подсчитывает, сколько раз это произошло с момента " -"загрузки модуля ZFS, с помощью `kstat.zfs.misc.zstd.compress_alloc_fail`." +"Репликация ZFS основана на отправке снимков наборов данных, которые также " +"могут быть созданы из зашифрованных наборов данных. Полученные снимки " +"остаются зашифрованными." -#. type: Title === -#: documentation/content/en/books/handbook/zfs/_index.adoc:2532 +#. type: delimited block . 4 +#: documentation/content/en/books/handbook/zfs/_index.adoc:3893 #, no-wrap -msgid "Deduplication" -msgstr "Дедупликация" +msgid "# zfs snapshot zroot/secretdata@snap1\n" +msgstr "# zfs snapshot zroot/secretdata@snap1\n" #. type: Plain text -#: documentation/content/en/books/handbook/zfs/_index.adoc:2538 +#: documentation/content/en/books/handbook/zfs/_index.adoc:3897 msgid "" -"When enabled, crossref:zfs[zfs-term-deduplication,deduplication] uses the " -"checksum of each block to detect duplicate blocks. When a new block is a " -"duplicate of an existing block, ZFS writes a new reference to the existing " -"data instead of the whole duplicate block. Tremendous space savings are " -"possible if the data contains a lot of duplicated files or repeated " -"information. Warning: deduplication requires a large amount of memory, and " -"enabling compression instead provides most of the space savings without the " -"extra cost." +"In addition to crossref:zfs[zfs-send-ssh,sending encrypted backups over " +"SSH], using the `-w` (raw) option with `zfs send` transfers the encrypted " +"data blocks to the target pool. A raw send provides several advantages:" msgstr "" -"Когда включена перекрёстная crossref:zfs[zfs-term-deduplication," -"дедупликация], она использует контрольную сумму каждого блока для " -"обнаружения дублирующихся блоков. Когда новый блок является дубликатом " -"существующего блока, ZFS записывает новую ссылку на существующие данные " -"вместо всего дублирующегося блока. Возможна значительная экономия места, " -"если данные содержат много дублирующихся файлов или повторяющейся " -"информации. Предупреждение: дедупликация требует большого объёма памяти, а " -"включение сжатия обеспечивает большую часть экономии места без " -"дополнительных затрат." +"В дополнение к crossref:zfs[zfs-send-ssh,отправке зашифрованных резервных " +"копий через SSH], использование опции `-w` (raw) с командой `zfs send` " +"передает зашифрованные блоки данных в целевой пул. Сырая отправка " +"обеспечивает несколько преимуществ:" + +#. type: Plain text +#: documentation/content/en/books/handbook/zfs/_index.adoc:3899 +msgid "the receiving system never sees plaintext data." +msgstr "принимающая система никогда не видит данные в открытом виде." + +#. type: Plain text +#: documentation/content/en/books/handbook/zfs/_index.adoc:3900 +msgid "" +"the receiving system does not require the passphrase since no decryption " +"takes place." +msgstr "" +"принимающая система не требует кодовую фразу, поскольку расшифровка не " +"выполняется." + +#. type: Plain text +#: documentation/content/en/books/handbook/zfs/_index.adoc:3901 +msgid "Backups can be sent without first loading the encryption key." +msgstr "" +"Резервные копии можно отправлять без предварительной загрузки ключа " +"шифрования." + +#. type: Plain text +#: documentation/content/en/books/handbook/zfs/_index.adoc:3902 +msgid "" +"an untrusted system can receive the encrypted data but cannot decrypt or " +"modify it without the encryption key." +msgstr "" +"Ненадёжная система может получить зашифрованные данные, но не может " +"расшифровать или изменить их без ключа шифрования." #. type: Plain text -#: documentation/content/en/books/handbook/zfs/_index.adoc:2540 -msgid "To activate deduplication, set the `dedup` property on the target pool:" -msgstr "Для активации дедупликации установите свойство `dedup` в целевой пул:" +#: documentation/content/en/books/handbook/zfs/_index.adoc:3904 +msgid "" +"To send the snapshot created above as a raw stream to the dataset `secret` " +"in the pool `backup`, enter the following command:" +msgstr "" +"Чтобы отправить созданный выше снимок в виде необработанного потока в набор " +"данных `secret` в пуле `backup`, введите следующую команду:" #. type: delimited block . 4 -#: documentation/content/en/books/handbook/zfs/_index.adoc:2544 +#: documentation/content/en/books/handbook/zfs/_index.adoc:3908 #, no-wrap -msgid "# zfs set dedup=on pool\n" -msgstr "# zfs set dedup=on pool\n" +msgid "# zfs send -w zroot/secretdata@snap1 | zfs recv backup/secret\n" +msgstr "# zfs send -w zroot/secretdata@snap1 | zfs recv backup/secret\n" #. type: Plain text -#: documentation/content/en/books/handbook/zfs/_index.adoc:2549 +#: documentation/content/en/books/handbook/zfs/_index.adoc:3913 msgid "" -"Deduplicating only affects new data written to the pool. Merely activating " -"this option will not deduplicate data already written to the pool. A pool " -"with a freshly activated deduplication property will look like this example:" +"Without the `-w` option, `zfs send` transmits the data in unencrypted form. " +"The receiving system may then re-encrypt the data using a different key. " +"However, doing so prevents future incremental raw sends to that destination." msgstr "" -"Дедупликация затрагивает только новые данные, записываемые в пул. Простое " -"включение этой опции не приведёт к дедупликации уже записанных в пул данных. " -"Пул с только что активированным свойством дедупликации будет выглядеть " -"следующим образом:" +"Без опции `-w` команда `zfs send` передает данные в незашифрованном виде. " +"Принимающая система затем может повторно зашифровать данные, используя " +"другой ключ. Однако это предотвращает будущие инкрементальные «сырые» " +"отправки на это место назначения." -#. type: delimited block . 4 -#: documentation/content/en/books/handbook/zfs/_index.adoc:2555 +#. type: Title === +#: documentation/content/en/books/handbook/zfs/_index.adoc:3915 #, no-wrap +msgid "Loading Encryption Keys at Boot" +msgstr "Загрузка ключей шифрования при загрузке" + +#. type: Plain text +#: documentation/content/en/books/handbook/zfs/_index.adoc:3920 msgid "" -"# zpool list\n" -"NAME SIZE ALLOC FREE CKPOINT EXPANDSZ FRAG CAP DEDUP HEALTH ALTROOT\n" -"pool 2.84G 2.19M 2.83G - - 0% 0% 1.00x ONLINE -\n" +"The `zfskeys` man:rc[8] script loads encryption keys at boot for encrypted " +"datasets whose `keylocation` property points to a key file with a `file://` " +"URL. The script runs after pool import and before mounting the file " +"systems, so datasets handled this way mount automatically during the normal " +"ZFS startup. The script does not handle datasets with `keylocation=prompt`; " +"load their keys manually with `zfs load-key` after the system has booted." msgstr "" -"# zpool list\n" -"NAME SIZE ALLOC FREE CKPOINT EXPANDSZ FRAG CAP DEDUP HEALTH ALTROOT\n" -"pool 2.84G 2.19M 2.83G - - 0% 0% 1.00x ONLINE -\n" +"Скрипт `zfskeys` из man:rc[8] загружает ключи шифрования при загрузке для " +"зашифрованных наборов данных, чьё свойство `keylocation` указывает на файл " +"ключа с URL-адресом `file://`. Скрипт запускается после импорта пула и перед " +"монтированием файловых систем, поэтому наборы данных, обрабатываемые таким " +"образом, монтируются автоматически во время обычного запуска ZFS. Скрипт не " +"обрабатывает наборы данных с `keylocation=prompt`; загружайте их ключи " +"вручную с помощью `zfs load-key` после загрузки системы." #. type: Plain text -#: documentation/content/en/books/handbook/zfs/_index.adoc:2560 +#: documentation/content/en/books/handbook/zfs/_index.adoc:3922 msgid "" -"The `DEDUP` column shows the actual rate of deduplication for the pool. A " -"value of `1.00x` shows that data has not deduplicated yet. The next example " -"copies some system binaries three times into different directories on the " -"deduplicated pool created above." +"To switch the dataset created earlier from a passphrase to a key file, " +"generate 32 bytes of random data as the new key, restrict access to the key " +"file, and change the encryption key of the dataset:" msgstr "" -"Столбец `DEDUP` показывает фактический уровень дедупликации для пула. " -"Значение `1.00x` означает, что данные пока не дедуплицированы. В следующем " -"примере некоторые системные двоичные файлы копируются три раза в разные " -"каталоги в пуле с дедупликацией, созданном выше." +"Чтобы переключить набор данных, созданный ранее, с парольной фразы на файл " +"ключа, сгенерируйте 32 байта случайных данных в качестве нового ключа, " +"ограничьте доступ к файлу ключа и измените ключ шифрования набора данных:" #. type: delimited block . 4 -#: documentation/content/en/books/handbook/zfs/_index.adoc:2566 +#: documentation/content/en/books/handbook/zfs/_index.adoc:3928 #, no-wrap msgid "" -"# for d in dir1 dir2 dir3; do\n" -"> mkdir $d && cp -R /usr/bin $d &\n" -"> done\n" +"# dd if=/dev/random of=/root/secretdata.key bs=32 count=1\n" +"# chmod 600 /root/secretdata.key\n" +"# zfs change-key -o keyformat=raw -o keylocation=file:///root/secretdata.key zroot/secretdata\n" msgstr "" -"# for d in dir1 dir2 dir3; do\n" -"> mkdir $d && cp -R /usr/bin $d &\n" -"> done\n" +"# dd if=/dev/random of=/root/secretdata.key bs=32 count=1\n" +"# chmod 600 /root/secretdata.key\n" +"# zfs change-key -o keyformat=raw -o keylocation=file:///root/secretdata.key " +"zroot/secretdata\n" #. type: Plain text -#: documentation/content/en/books/handbook/zfs/_index.adoc:2569 -msgid "To observe deduplicating of redundant data, use:" -msgstr "Для наблюдения за дедупликацией избыточных данных используйте:" +#: documentation/content/en/books/handbook/zfs/_index.adoc:3931 +msgid "Enable the script in [.filename]#/etc/rc.conf#:" +msgstr "Включите скрипт в файле [.filename]#/etc/rc.conf#:" #. type: delimited block . 4 -#: documentation/content/en/books/handbook/zfs/_index.adoc:2575 +#: documentation/content/en/books/handbook/zfs/_index.adoc:3935 #, no-wrap +msgid "# sysrc zfskeys_enable=\"YES\"\n" +msgstr "# sysrc zfskeys_enable=\"YES\"\n" + +#. type: Plain text +#: documentation/content/en/books/handbook/zfs/_index.adoc:3939 msgid "" -"# zpool list\n" -"NAME SIZE ALLOC FREE CKPOINT EXPANDSZ FRAG CAP DEDUP HEALTH ALTROOT\n" -"pool 2.84G 20.9M 2.82G - - 0% 0% 3.00x ONLINE -\n" +"By default, the script loads the keys of all encrypted datasets with a " +"`file://` key location. To restrict key loading to specific datasets, list " +"them in `zfskeys_datasets`, separated by spaces:" msgstr "" -"# zpool list\n" -"NAME SIZE ALLOC FREE CKPOINT EXPANDSZ FRAG CAP DEDUP HEALTH ALTROOT\n" -"pool 2.84G 20.9M 2.82G - - 0% 0% 3.00x ONLINE -\n" +"По умолчанию сценарий загружает ключи всех зашифрованных наборов данных с " +"расположением ключей `file://`. Чтобы ограничить загрузку ключей конкретными " +"наборами данных, перечислите их в `zfskeys_datasets`, разделяя пробелами:" + +#. type: delimited block . 4 +#: documentation/content/en/books/handbook/zfs/_index.adoc:3943 +#, no-wrap +msgid "# sysrc zfskeys_datasets=\"zroot/secretdata\"\n" +msgstr "# sysrc zfskeys_datasets=\"zroot/secretdata\"\n" + +#. type: delimited block = 4 +#: documentation/content/en/books/handbook/zfs/_index.adoc:3949 +msgid "" +"Anyone able to read the key file can decrypt the dataset. Keep the key file " +"owned by `root` with mode `600`, and store it on storage that is itself " +"protected, such as an encrypted root file system or removable media that is " +"only connected during boot." +msgstr "" +"Любой, кто может прочитать файл ключа, сможет расшифровать набор данных. " +"Держите файл ключа принадлежащим `root` с правами `600` и храните его на " +"хранилище, которое само защищено, например, на зашифрованной корневой " +"файловой системе или сменном носителе, который подключается только во время " +"загрузки." + +#. type: Title == +#: documentation/content/en/books/handbook/zfs/_index.adoc:3952 +#, no-wrap +msgid "Boot Environments" +msgstr "Загрузочные окружения" #. type: Plain text -#: documentation/content/en/books/handbook/zfs/_index.adoc:2580 +#: documentation/content/en/books/handbook/zfs/_index.adoc:3957 msgid "" -"The `DEDUP` column shows a factor of `3.00x`. Detecting and deduplicating " -"copies of the data uses a third of the space. The potential for space " -"savings can be enormous, but comes at the cost of having enough memory to " -"keep track of the deduplicated blocks." +"A boot environment is a bootable crossref:zfs[zfs-term-clone,clone] of the " +"dataset tree that contains the operating system. On systems installed with " +"the Root-on-ZFS layout, these datasets live under `zroot/ROOT`, with the " +"running system in `zroot/ROOT/default`. Creating a boot environment " +"snapshots and clones the root datasets, which completes in seconds and " +"consumes almost no space until the environments start to diverge." msgstr "" -"Столбец `DEDUP` показывает коэффициент `3.00x`. Обнаружение и дедупликация " -"копий данных используют треть пространства. Потенциальная экономия " -"пространства может быть огромной, но достигается за счет наличия " -"достаточного объёма памяти для отслеживания дедуплицированных блоков." +"Загрузочное окружение — это загрузочный crossref:zfs[zfs-term-clone,клон] " +"дерева наборов данных, которое содержит операционную систему. На системах, " +"установленных с раскладкой Root-on-ZFS, эти наборы данных находятся в `zroot/" +"ROOT`, а работающая система — в `zroot/ROOT/default`. Создание загрузочного " +"окружения создаёт снимки и клоны корневых наборов данных, что занимает " +"секунды и почти не потребляет места на диске, пока окружения не начнут " +"расходиться." #. type: Plain text -#: documentation/content/en/books/handbook/zfs/_index.adoc:2583 +#: documentation/content/en/books/handbook/zfs/_index.adoc:3960 msgid "" -"Deduplication is not always beneficial when the data in a pool is not " -"redundant. ZFS can show potential space savings by simulating deduplication " -"on an existing pool:" +"Manage boot environments with man:bectl[8]. Create a new environment before " +"a major change, such as an operating system or large package upgrade:" msgstr "" -"Дедупликация не всегда полезна, если данные в пуле не содержат избыточности. " -"ZFS может показать потенциальную экономию пространства, имитируя " -"дедупликацию на существующем пуле:" +"Управление загрузочными окружениями с помощью man:bectl[8]. Создайте новое " +"окружение перед серьезным изменением, таким как обновление операционной " +"системы или крупного пакета:" #. type: delimited block . 4 -#: documentation/content/en/books/handbook/zfs/_index.adoc:2588 +#: documentation/content/en/books/handbook/zfs/_index.adoc:3968 #, no-wrap msgid "" -"# zdb -S pool\n" -"Simulated DDT histogram:\n" +"# bectl create beforeupgrade\n" +"# bectl list\n" +"BE Active Mountpoint Space Created\n" +"default NR / 2.43G 2026-07-11 11:26\n" +"beforeupgrade - - 328K 2026-07-11 11:31\n" msgstr "" -"# zdb -S pool\n" -"Simulated DDT histogram:\n" +"# bectl create beforeupgrade\n" +"# bectl list\n" +"BE Active Mountpoint Space Created\n" +"default NR / 2.43G 2026-07-11 11:26\n" +"beforeupgrade - - 328K 2026-07-11 11:31\n" -#. type: delimited block . 4 -#: documentation/content/en/books/handbook/zfs/_index.adoc:2604 -#, no-wrap +#. type: Plain text +#: documentation/content/en/books/handbook/zfs/_index.adoc:3971 msgid "" -"bucket allocated referenced\n" -"______ ______________________________ ______________________________\n" -"refcnt blocks LSIZE PSIZE DSIZE blocks LSIZE PSIZE DSIZE\n" -"------ ------ ----- ----- ----- ------ ----- ----- -----\n" -" 1 2.58M 289G 264G 264G 2.58M 289G 264G 264G\n" -" 2 206K 12.6G 10.4G 10.4G 430K 26.4G 21.6G 21.6G\n" -" 4 37.6K 692M 276M 276M 170K 3.04G 1.26G 1.26G\n" -" 8 2.18K 45.2M 19.4M 19.4M 20.0K 425M 176M 176M\n" -" 16 174 2.83M 1.20M 1.20M 3.33K 48.4M 20.4M 20.4M\n" -" 32 40 2.17M 222K 222K 1.70K 97.2M 9.91M 9.91M\n" -" 64 9 56K 10.5K 10.5K 865 4.96M 948K 948K\n" -" 128 2 9.50K 2K 2K 419 2.11M 438K 438K\n" -" 256 5 61.5K 12K 12K 1.90K 23.0M 4.47M 4.47M\n" -" 1K 2 1K 1K 1K 2.98K 1.49M 1.49M 1.49M\n" -" Total 2.82M 303G 275G 275G 3.20M 319G 287G 287G\n" +"In the `Active` column, `N` marks the environment in use now, and `R` marks " +"the one that becomes active on reboot." msgstr "" -"bucket allocated referenced\n" -"______ ______________________________ ______________________________\n" -"refcnt blocks LSIZE PSIZE DSIZE blocks LSIZE PSIZE DSIZE\n" -"------ ------ ----- ----- ----- ------ ----- ----- -----\n" -" 1 2.58M 289G 264G 264G 2.58M 289G 264G 264G\n" -" 2 206K 12.6G 10.4G 10.4G 430K 26.4G 21.6G 21.6G\n" -" 4 37.6K 692M 276M 276M 170K 3.04G 1.26G 1.26G\n" -" 8 2.18K 45.2M 19.4M 19.4M 20.0K 425M 176M 176M\n" -" 16 174 2.83M 1.20M 1.20M 3.33K 48.4M 20.4M 20.4M\n" -" 32 40 2.17M 222K 222K 1.70K 97.2M 9.91M 9.91M\n" -" 64 9 56K 10.5K 10.5K 865 4.96M 948K 948K\n" -" 128 2 9.50K 2K 2K 419 2.11M 438K 438K\n" -" 256 5 61.5K 12K 12K 1.90K 23.0M 4.47M 4.47M\n" -" 1K 2 1K 1K 1K 2.98K 1.49M 1.49M 1.49M\n" -" Total 2.82M 303G 275G 275G 3.20M 319G 287G 287G\n" +"В столбце `Active` метка `N` обозначает окружение, используемое в данный " +"момент, а `R` — то, которое станет активным после перезагрузки." + +#. type: Plain text +#: documentation/content/en/books/handbook/zfs/_index.adoc:3977 +msgid "" +"Perform the upgrade with man:freebsd-update[8] or man:pkg[8] as usual. The " +"upgrade modifies the active environment, while `beforeupgrade` preserves the " +"system as it was. If the upgraded system fails to boot or misbehaves, " +"reboot and select `beforeupgrade` from the `Boot Environments` menu of the " +"FreeBSD loader. Selecting an environment in the loader menu affects the " +"current boot only. To make the rollback permanent, activate the environment:" +msgstr "" +"Выполните обновление с помощью man:freebsd-update[8] или man:pkg[8] как " +"обычно. Обновление изменяет активное окружение, тогда как `beforeupgrade` " +"сохраняет систему в её прежнем состоянии. Если обновлённая система не " +"загружается или работает некорректно, перезагрузитесь и выберите " +"`beforeupgrade` из меню `Boot Environments` загрузчика FreeBSD. Выбор " +"окружения в меню загрузчика влияет только на текущую загрузку. Чтобы сделать " +"откат постоянным, активируйте это окружение:" #. type: delimited block . 4 -#: documentation/content/en/books/handbook/zfs/_index.adoc:2606 +#: documentation/content/en/books/handbook/zfs/_index.adoc:3981 #, no-wrap -msgid "dedup = 1.05, compress = 1.11, copies = 1.00, dedup * compress / copies = 1.16\n" -msgstr "dedup = 1.05, compress = 1.11, copies = 1.00, dedup * compress / copies = 1.16\n" +msgid "# bectl activate beforeupgrade\n" +msgstr "# bectl activate beforeupgrade\n" #. type: Plain text -#: documentation/content/en/books/handbook/zfs/_index.adoc:2616 +#: documentation/content/en/books/handbook/zfs/_index.adoc:3984 msgid "" -"After `zdb -S` finishes analyzing the pool, it shows the space reduction " -"ratio that activating deduplication would achieve. In this case, `1.16` is " -"a poor space saving ratio mainly provided by compression. Activating " -"deduplication on this pool would not save any amount of space, and is not " -"worth the amount of memory required to enable deduplication. Using the " -"formula _ratio = dedup * compress / copies_, system administrators can plan " -"the storage allocation, deciding whether the workload will contain enough " -"duplicate blocks to justify the memory requirements. If the data is " -"reasonably compressible, the space savings may be good. Good practice is to " -"enable compression first as compression also provides greatly increased " -"performance. Enable deduplication in cases where savings are considerable " -"and with enough available memory for the crossref:zfs[zfs-term-deduplication," -"DDT]." +"Running `bectl activate -t _beName_` instead activates an environment for " +"the next boot only, which is useful when testing changes on a remote system." msgstr "" -"После завершения анализа пула командой `zdb -S` отображается коэффициент " -"сокращения пространства, который был бы достигнут при активации " -"дедупликации. В данном случае значение `1.16` указывает на низкий уровень " -"экономии пространства, в основном обеспечиваемый сжатием. Активация " -"дедупликации для этого пула не сэкономит значительного объёма пространства и " -"не оправдает объём памяти, необходимый для её включения. Используя формулу " -"_ratio = dedup * compress / copies_, системные администраторы могут " -"планировать распределение хранилища, определяя, будет ли рабочая нагрузка " -"содержать достаточное количество дублирующихся блоков, чтобы оправдать " -"требования к памяти. Если данные достаточно хорошо сжимаемы, экономия " -"пространства может быть значительной. Рекомендуется сначала включить сжатие, " -"так как оно также значительно повышает производительность. Активируйте " -"дедупликацию только в случаях, когда экономия пространства существенна и " -"имеется достаточный объём доступной памяти для crossref:zfs[zfs-term-" -"deduplication,DDT]." - -#. type: Title === -#: documentation/content/en/books/handbook/zfs/_index.adoc:2618 -#, no-wrap -msgid "ZFS and Jails" -msgstr "ZFS и клетки" +"Выполнение `bectl activate -t _beName_` вместо этого активирует окружение " +"только для следующей загрузки, что полезно при тестировании изменений на " +"удаленной системе." #. type: Plain text -#: documentation/content/en/books/handbook/zfs/_index.adoc:2624 +#: documentation/content/en/books/handbook/zfs/_index.adoc:3986 msgid "" -"Use `zfs jail` and the corresponding `jailed` property to delegate a ZFS " -"dataset to a crossref:jails[jails,Jail]. `zfs jail _jailid_` attaches a " -"dataset to the specified jail, and `zfs unjail` detaches it. To control the " -"dataset from within a jail, set the `jailed` property. ZFS forbids mounting " -"a jailed dataset on the host because it may have mount points that would " -"compromise the security of the host." +"To inspect or repair the contents of an inactive environment without booting " +"it, mount it at a temporary location:" msgstr "" -"Используйте `zfs jail` и соответствующее свойство `jailed`, чтобы " -"делегировать набор данных ZFS в crossref:jails[jails,Клетку]. `zfs jail " -"_идентификатор_клетки_` присоединяет набор данных к указанной клетке, а `zfs " -"unjail` отсоединяет его. Для управления набором данных изнутри клетки " -"установите свойство `jail`. ZFS запрещает монтирование на хосте набора " -"данных со свойством jail, так как его точки монтирования могут нарушить " -"безопасность хоста." +"Чтобы осмотреть или восстановить содержимое неактивного окружения без его " +"загрузки, смонтируйте его во временное расположение:" -#. type: Title == -#: documentation/content/en/books/handbook/zfs/_index.adoc:2626 +#. type: delimited block . 4 +#: documentation/content/en/books/handbook/zfs/_index.adoc:3992 #, no-wrap -msgid "Delegated Administration" -msgstr "Делегированное администрирование" +msgid "" +"# bectl mount beforeupgrade\n" +"/tmp/be_mount.c1Xk\n" +"# bectl umount beforeupgrade\n" +msgstr "" +"# bectl mount beforeupgrade\n" +"/tmp/be_mount.c1Xk\n" +"# bectl umount beforeupgrade\n" #. type: Plain text -#: documentation/content/en/books/handbook/zfs/_index.adoc:2634 +#: documentation/content/en/books/handbook/zfs/_index.adoc:3995 msgid "" -"A comprehensive permission delegation system allows unprivileged users to " -"perform ZFS administration functions. For example, if each user's home " -"directory is a dataset, users need permission to create and destroy " -"snapshots of their home directories. A user performing backups can get " -"permission to use replication features. ZFS allows a usage statistics " -"script to run with access to only the space usage data for all users. " -"Delegating the ability to delegate permissions is also possible. Permission " -"delegation is possible for each subcommand and most properties." -msgstr "" -"Комплексная система делегирования прав позволяет непривилегированным " -"пользователям выполнять функции администрирования ZFS. Например, если " -"домашний каталог каждого пользователя является набором данных, пользователям " -"нужно разрешение на создание и удаление снимков своих домашних каталогов. " -"Пользователь, выполняющий резервное копирование, может получить разрешение " -"на использование функций репликации. ZFS позволяет скрипту статистики " -"использования работать с доступом только к данным о занятом пространстве для " -"всех пользователей. Также возможно делегирование права на делегирование " -"разрешений. Делегирование прав доступно для каждой подкоманды и большинства " -"свойств." +"Destroy an environment that is no longer needed to reclaim the space it uses:" +msgstr "" +"Уничтожьте окружение, которое больше не нужно, чтобы освободить занимаемое " +"окружением пространство:" + +#. type: delimited block . 4 +#: documentation/content/en/books/handbook/zfs/_index.adoc:3999 +#, no-wrap +msgid "# bectl destroy beforeupgrade\n" +msgstr "# bectl destroy beforeupgrade\n" + +#. type: delimited block = 4 +#: documentation/content/en/books/handbook/zfs/_index.adoc:4004 +msgid "" +"Creating a boot environment before every man:freebsd-update[8] upgrade or " +"large man:pkg[8] operation provides an instant way back to a known-good " +"system without restoring from backups." +msgstr "" +"Создание загрузочного окружения перед каждым man:freebsd-update[8] upgrade " +"или крупной операцией man:pkg[8] обеспечивает мгновенный способ вернуться к " +"заведомо исправной системе без восстановления из резервных копий." #. type: Title === -#: documentation/content/en/books/handbook/zfs/_index.adoc:2636 +#: documentation/content/en/books/handbook/zfs/_index.adoc:4007 #, no-wrap -msgid "Delegating Dataset Creation" -msgstr "Делегирование создания наборов данных" +msgid "Boot Environments and Applications" +msgstr "Загрузочные окружения и приложения" #. type: Plain text -#: documentation/content/en/books/handbook/zfs/_index.adoc:2642 +#: documentation/content/en/books/handbook/zfs/_index.adoc:4012 msgid "" -"`zfs allow _someuser_ create _mydataset_` gives the specified user " -"permission to create child datasets under the selected parent dataset. A " -"caveat: creating a new dataset involves mounting it. That requires setting " -"the FreeBSD `vfs.usermount` man:sysctl[8] to `1` to allow non-root users to " -"mount a file system. Another restriction aimed at preventing abuse: non-" -"`root` users must own the mountpoint where mounting the file system." +"A boot environment contains only the datasets under `zroot/ROOT`. On the " +"default Root-on-ZFS layout that includes the whole root file system with [." +"filename]#/usr/local# and [.filename]#/var/db#, so installed packages and " +"their metadata roll back together with the operating system. Datasets " +"outside `zroot/ROOT`, such as `zroot/home`, `zroot/var/log`, and `zroot/var/" +"mail`, are shared: every environment sees the same files, and activating an " +"older environment does not return them to an earlier state." msgstr "" -"`zfs allow _someuser_ create _mydataset_` предоставляет указанному " -"пользователю разрешение на создание дочерних наборов данных в выбранном " -"родительском наборе данных. Важное замечание: создание нового набора данных " -"включает его монтирование. Для этого необходимо установить параметр `vfs." -"usermount` в man:sysctl[8] FreeBSD в значение `1`, чтобы разрешить " -"непривилегированным пользователям монтировать файловую систему. Ещё одно " -"ограничение, направленное на предотвращение злоупотреблений: " -"непривилегированные пользователи должны быть владельцами точки монтирования, " -"куда монтируется файловая система." +"Загрузочное окружение содержит только наборы данных в `zroot/ROOT`. В " +"стандартной компоновке Root-on-ZFS это включает всю корневую файловую " +"систему с [.filename]#/usr/local# и [.filename]#/var/db#, поэтому " +"установленные пакеты и их метаданные откатываются вместе с операционной " +"системой. Наборы данных за пределами `zroot/ROOT`, такие как `zroot/home`, `" +"zroot/var/log` и `zroot/var/mail`, являются общими: каждое окружение видит " +"одни и те же файлы, и активация более старого окружения не возвращает их в " +"более раннее состояние." -#. type: Title === -#: documentation/content/en/books/handbook/zfs/_index.adoc:2644 +#. type: Plain text +#: documentation/content/en/books/handbook/zfs/_index.adoc:4015 +msgid "" +"Plan the dataset layout around this split before relying on boot " +"environments. Data that must survive a rollback, such as the databases of " +"an application installed from packages, belongs on its own dataset outside " +"`zroot/ROOT`:" +msgstr "" +"Спланируйте структуру набора данных с учётом этого разделения до того, как " +"полагаться на загрузочные окружения. Данные, которые должны пережить откат, " +"например базы данных приложения, установленного из пакетов, должны " +"находиться в собственном наборе данных вне `zroot/ROOT`:" + +#. type: delimited block . 4 +#: documentation/content/en/books/handbook/zfs/_index.adoc:4019 #, no-wrap -msgid "Delegating Permission Delegation" -msgstr "Делегирование права делегировать разрешения" +msgid "# zfs create -o mountpoint=/var/db/postgres zroot/pgdata\n" +msgstr "# zfs create -o mountpoint=/var/db/postgres zroot/pgdata\n" #. type: Plain text -#: documentation/content/en/books/handbook/zfs/_index.adoc:2648 +#: documentation/content/en/books/handbook/zfs/_index.adoc:4023 msgid "" -"`zfs allow _someuser_ allow _mydataset_` gives the specified user the " -"ability to assign any permission they have on the target dataset, or its " -"children, to other users. If a user has the `snapshot` permission and the " -"`allow` permission, that user can then grant the `snapshot` permission to " -"other users." +"With this layout, rolling back to an older environment returns the database " +"server binaries to their previous version while the database contents remain " +"untouched. The reverse also holds: files written to shared datasets while " +"testing a new environment persist after switching back, so boot environments " +"do not replace crossref:zfs[zfs-zfs-snapshot,snapshots] of those datasets." msgstr "" -"`zfs allow _someuser_ allow _mydataset_` предоставляет указанному " -"пользователю возможность назначать любые разрешения, которые у него есть для " -"целевого набора данных или его дочерних элементов, другим пользователям. " -"Если пользователь имеет разрешение `snapshot` и разрешение `allow`, он может " -"предоставить разрешение `snapshot` другим пользователям." +"При такой компоновке откат к более старой среде возвращает бинарные файлы " +"сервера баз данных к их предыдущей версии, в то время как содержимое базы " +"данных остается нетронутым. Обратное также верно: файлы, записанные в общие " +"наборы данных при тестировании новой среды, сохраняются после переключения " +"обратно, поэтому загрузочные среды не заменяют crossref:zfs[zfs-zfs-" +"snapshot,снимки] этих наборов данных." #. type: Title == -#: documentation/content/en/books/handbook/zfs/_index.adoc:2650 +#: documentation/content/en/books/handbook/zfs/_index.adoc:4025 #, no-wrap msgid "Advanced Topics" msgstr "Сложные темы" #. type: Title === -#: documentation/content/en/books/handbook/zfs/_index.adoc:2653 +#: documentation/content/en/books/handbook/zfs/_index.adoc:4028 #, no-wrap msgid "Tuning" msgstr "Настройка" #. type: Plain text -#: documentation/content/en/books/handbook/zfs/_index.adoc:2656 -msgid "Adjust tunables to make ZFS perform best for different workloads." +#: documentation/content/en/books/handbook/zfs/_index.adoc:4033 +msgid "" +"Adjust tunables to make ZFS perform best for different workloads. FreeBSD " +"exposes the ZFS kernel tunables as man:sysctl[8] variables under `vfs.zfs`; " +"man:zfs[4] documents every tunable and its default value. Set values that " +"must apply from boot in [.filename]#/boot/loader.conf#; adjust runtime-" +"changeable values with man:sysctl[8] and make them permanent in [.filename]#/" +"etc/sysctl.conf#." msgstr "" -"Настройте параметры для оптимальной производительности ZFS в различных " -"рабочих нагрузках." +"Отрегулируйте параметры настройки, чтобы ZFS показывал наилучшую " +"производительность для различных рабочих нагрузок. FreeBSD предоставляет " +"параметры ядра ZFS как переменные man:sysctl[8] в разделе `vfs.zfs`; " +"man:zfs[4] документирует каждый параметр и его значение по умолчанию. " +"Установите значения, которые должны применяться с момента загрузки, в [." +"filename]#/boot/loader.conf#; изменяйте значения, доступные для изменения во " +"время работы, с помощью man:sysctl[8] и сделайте их постоянными в [." +"filename]#/etc/sysctl.conf#." #. type: Plain text -#: documentation/content/en/books/handbook/zfs/_index.adoc:2660 +#: documentation/content/en/books/handbook/zfs/_index.adoc:4038 msgid "" -"[[zfs-advanced-tuning-arc_max]] `_vfs.zfs.arc.max_` starting with 13.x (`vfs." -"zfs.arc_max` for 12.x) - Upper size of the crossref:zfs[zfs-term-arc,ARC]. " -"The default is all RAM but 1 GB, or 5/8 of all RAM, whichever is more. Use a " -"lower value if the system runs any other daemons or processes that may " -"require memory. Adjust this value at runtime with man:sysctl[8] and set it " -"in [.filename]#/boot/loader.conf# or [.filename]#/etc/sysctl.conf#." +"`_vfs.zfs.arc.max_` - Upper size of the crossref:zfs[zfs-term-arc,ARC]. The " +"default of `0` lets ZFS size the ARC automatically based on the amount of " +"installed memory. Use a lower value if the system runs any other daemons or " +"processes that may require memory; see crossref:zfs[zfs-advanced-arc,ARC " +"Sizing and Monitoring] for guidance. Adjust this value at runtime with man:" +"sysctl[8] and set it in [.filename]#/boot/loader.conf# or [.filename]#/etc/" +"sysctl.conf#." msgstr "" -"[[zfs-advanced-tuning-arc_max]] `_vfs.zfs.arc.max_` начиная с 13.x (`vfs.zfs." -"arc_max` для 12.x) - Верхний размер crossref:zfs[zfs-term-arc,ARC]. По " -"умолчанию используется весь объём ОЗУ за исключением 1 ГБ или 5/8 от всего " -"объёма ОЗУ, в зависимости от того, что больше. Используйте меньшее значение, " -"если в системе работают другие демоны или процессы, которым может " -"потребоваться память. Изменяйте это значение во время работы с помощью man:" -"sysctl[8] и задавайте его в [.filename]#/boot/loader.conf# или [.filename]#/" -"etc/sysctl.conf#." +"`_vfs.zfs.arc.max_`— верхний размер crossref:zfs[zfs-term-arc,ARC]. Значение " +"по умолчанию `0` позволяет ZFS автоматически определять размер ARC на основе " +"объёма установленной оперативной памяти. Используйте меньшее значение, если " +"в системе работают другие демоны или процессы, которым может потребоваться " +"память. Смотрите crossref:zfs[zfs-advanced-arc,«Размер и мониторинг ARC»] " +"для получения информации. Изменяйте это значение во время работы с помощью " +"man:sysctl[8] и задавайте его в [.filename]#/boot/loader.conf# или [." +"filename]#/etc/sysctl.conf#." + +#. type: Plain text +#: documentation/content/en/books/handbook/zfs/_index.adoc:4042 +msgid "" +"`_vfs.zfs.arc.min_` - Lower size of the crossref:zfs[zfs-term-arc,ARC]. The " +"default of `0` lets ZFS choose a small minimum automatically. Increase this " +"value to prevent other applications from pressuring out the entire ARC. " +"Adjust this value at runtime with man:sysctl[8] and set it in [.filename]#/" +"boot/loader.conf# or [.filename]#/etc/sysctl.conf#." +msgstr "" +"`_vfs.zfs.arc.min_`— нижний размер crossref:zfs[zfs-term-arc,ARC]. Значение " +"по умолчанию `0` позволяет ZFS автоматически выбирать небольшое минимальное " +"значение. Увеличьте это значение, чтобы предотвратить вытеснение всего ARC " +"другими приложениями. Настройка этого значения возможна во время выполнения " +"с помощью man:sysctl[8], а также в [.filename]#/boot/loader.conf# или [." +"filename]#/etc/sysctl.conf#." + +#. type: Plain text +#: documentation/content/en/books/handbook/zfs/_index.adoc:4046 +msgid "" +"`_vfs.zfs.arc.meta_balance_` - Balance between caching metadata and file " +"data in the crossref:zfs[zfs-term-arc,ARC]; values above `100` increasingly " +"favor metadata, and the default is `500`. Increase this value if the " +"workload involves operations on a large number of files and directories, or " +"frequent metadata operations, at the cost of less file data fitting in the " +"ARC. This tunable replaces `vfs.zfs.arc.meta_limit`, which OpenZFS 2.2 " +"removed. Adjust this value at any time with man:sysctl[8]." +msgstr "" +"`_vfs.zfs.arc.meta_balance_` — баланс между кэшированием метаданных и данных " +"файлов в crossref:zfs[zfs-term-arc,ARC]; значения выше `100` всё больше " +"отдают предпочтение метаданным, по умолчанию — `500`. Увеличьте это " +"значение, если рабочая нагрузка связана с операциями над большим количеством " +"файлов и каталогов или частыми операциями с метаданными, ценой уменьшения " +"объёма данных файлов, помещающихся в ARC. Этот настраиваемый параметр " +"заменяет `vfs.zfs.arc.meta_limit`, который был удалён в OpenZFS 2.2. " +"Изменяйте это значение в любое время с помощью man:sysctl[8]." + +#. type: Plain text +#: documentation/content/en/books/handbook/zfs/_index.adoc:4050 +msgid "" +"`_vfs.zfs.vdev.min_auto_ashift_` - Lower `ashift` (sector size) used " +"automatically at pool creation time. The value is a power of two. The " +"default value of `9` represents `2^9 = 512`, a sector size of 512 bytes. To " +"avoid _write amplification_ and get the best performance, set this value to " +"the largest sector size used by a device in the pool." +msgstr "" +"`_vfs.zfs.vdev.min_auto_ashift_` - Минимальное значение `ashift` (размер " +"сектора), автоматически используемое при создании пула. Значение является " +"степенью двойки. Значение по умолчанию `9` соответствует `2^9 = 512`, то " +"есть размеру сектора 512 байт. Чтобы избежать _усиления записи_ (write " +"amplification) и получить наилучшую производительность, установите это " +"значение равным наибольшему размеру сектора среди устройств в пуле." #. type: Plain text -#: documentation/content/en/books/handbook/zfs/_index.adoc:2667 +#: documentation/content/en/books/handbook/zfs/_index.adoc:4052 msgid "" -"[[zfs-advanced-tuning-arc_meta_limit]] `_vfs.zfs.arc.meta_limit_` starting " -"with 13.x (`vfs.zfs.arc_meta_limit` for 12.x) - Limit the amount of the " -"crossref:zfs[zfs-term-arc,ARC] used to store metadata. The default is one " -"fourth of `vfs.zfs.arc.max`. Increasing this value will improve performance " -"if the workload involves operations on a large number of files and " -"directories, or frequent metadata operations, at the cost of less file data " -"fitting in the crossref:zfs[zfs-term-arc,ARC]. Adjust this value at runtime " -"with man:sysctl[8] in [.filename]#/boot/loader.conf# or [.filename]#/etc/" -"sysctl.conf#." +"See crossref:zfs[zfs-zpool-create,Creating and Destroying Storage Pools] for " +"why pools on 4 KB-sector drives should use an `ashift` of 12." msgstr "" -"[[zfs-advanced-tuning-arc_meta_limit]] `_vfs.zfs.arc.meta_limit_` начиная с " -"13.x (`vfs.zfs.arc_meta_limit` для 12.x) — ограничивает объём crossref:" -"zfs[zfs-term-arc,ARC], используемого для хранения метаданных. По умолчанию " -"составляет одну четвертую от `vfs.zfs.arc.max`. Увеличение этого значения " -"может повысить производительность при работе с большим количеством файлов и " -"каталогов или частых операциях с метаданными, за счет уменьшения объёма " -"данных файлов, помещающихся в crossref:zfs[zfs-term-arc,ARC]. Это значение " -"можно изменить во время работы с помощью man:sysctl[8] в [.filename]#/boot/" -"loader.conf# или [.filename]#/etc/sysctl.conf#." +"См. crossref:zfs[zfs-zpool-create,Создание и уничтожение пулов хранения] о " +"том, почему пулы на дисках с секторами 4 КБ должны использовать `ashift` со " +"значением 12." #. type: Plain text -#: documentation/content/en/books/handbook/zfs/_index.adoc:2672 +#: documentation/content/en/books/handbook/zfs/_index.adoc:4058 msgid "" -"[[zfs-advanced-tuning-arc_min]] `_vfs.zfs.arc.min_` starting with 13.x (`vfs." -"zfs.arc_min` for 12.x) - Lower size of the crossref:zfs[zfs-term-arc,ARC]. " -"The default is one half of `vfs.zfs.arc.meta_limit`. Adjust this value to " -"prevent other applications from pressuring out the entire crossref:zfs[zfs-" -"term-arc,ARC]. Adjust this value at runtime with man:sysctl[8] and in [." -"filename]#/boot/loader.conf# or [.filename]#/etc/sysctl.conf#." +"`_vfs.zfs.prefetch.disable_` - Disable prefetch. A value of `0` enables and " +"`1` disables it. The default is `0`. Prefetch works by reading larger " +"blocks than requested into the crossref:zfs[zfs-term-arc,ARC] in hopes to " +"soon need the data. If the workload has a large number of random reads, " +"disabling prefetch may actually improve performance by reducing unnecessary " +"reads. Adjust this value at any time with man:sysctl[8]." msgstr "" -"[[zfs-advanced-tuning-arc_min]] `_vfs.zfs.arc.min_` начиная с 13.x (`vfs.zfs." -"arc_min` для 12.x) - Нижний размер crossref:zfs[zfs-term-arc,ARC]. По " -"умолчанию составляет половину от `vfs.zfs.arc.meta_limit`. Измените это " -"значение, чтобы предотвратить вытеснение всего crossref:zfs[zfs-term-arc," -"ARC] другими приложениями. Настройка этого значения возможна во время " -"выполнения с помощью man:sysctl[8], а также в [.filename]#/boot/loader.conf# " -"или [.filename]#/etc/sysctl.conf#." +"`_vfs.zfs.prefetch.disable_` — Отключает предварительную выборку. Значение " +"`0` включает её, а `1` отключает. По умолчанию используется `0`. " +"Предварительная выборка работает, считывая блоки большего размера, чем " +"запрошено, в раздел crossref:zfs[zfs-term-arc,ARC], в надежде, что данные " +"скоро понадобятся. Если рабочая нагрузка включает большое количество " +"случайных чтений, отключение предварительной выборки может улучшить " +"производительность, сократив ненужные чтения. Это значение можно изменить в " +"любое время с помощью man:sysctl[8]." #. type: Plain text -#: documentation/content/en/books/handbook/zfs/_index.adoc:2673 +#: documentation/content/en/books/handbook/zfs/_index.adoc:4064 msgid "" -"[[zfs-advanced-tuning-vdev-cache-size]] `_vfs.zfs.vdev.cache.size_` - A " -"preallocated amount of memory reserved as a cache for each device in the " -"pool. The total amount of memory used will be this value multiplied by the " -"number of devices. Set this value at boot time and in [.filename]#/boot/" -"loader.conf#." +"`_vfs.zfs.txg.timeout_` - Upper number of seconds between crossref:zfs[zfs-" +"term-txg,transaction group]s. The current transaction group writes to the " +"pool and a fresh transaction group starts if this amount of time elapses " +"since the previous transaction group. A transaction group may trigger " +"earlier if writing enough data. The default value is 5 seconds. A larger " +"value may improve read performance by delaying asynchronous writes, but this " +"may cause uneven performance when writing the transaction group. Adjust " +"this value at any time with man:sysctl[8]." +msgstr "" +"`_vfs.zfs.txg.timeout_` — Максимальное количество секунд между группами " +"crossref:zfs[zfs-term-txg,транзакций]. Текущая группа транзакций " +"записывается в пул, и начинается новая группа транзакций, если с момента " +"предыдущей группы транзакций прошло указанное время. Группа транзакций может " +"запуститься раньше при записи достаточного объёма данных. Значение по " +"умолчанию составляет 5 секунд. Увеличение этого значения может улучшить " +"производительность чтения за счет задержки асинхронных записей, но это может " +"привести к неравномерной производительности при записи группы транзакций. " +"Это значение можно изменить в любое время с помощью man:sysctl[8]." + +#. type: Plain text +#: documentation/content/en/books/handbook/zfs/_index.adoc:4067 +msgid "" +"`_vfs.zfs.l2arc.write_max_` - Limit the amount of data written to the " +"crossref:zfs[zfs-term-l2arc,L2ARC] per second. This tunable extends the " +"longevity of SSDs by limiting the amount of data written to the device. " +"Adjust this value at any time with man:sysctl[8]." msgstr "" -"[[zfs-advanced-tuning-vdev-cache-size]] `_vfs.zfs.vdev.cache.size_` - " -"Предварительно выделенный объём памяти, зарезервированный в качестве кэша " -"для каждого устройства в пуле. Общий объём используемой памяти будет равен " -"этому значению, умноженному на количество устройств. Установите это значение " -"при загрузке и в [.filename]#/boot/loader.conf#." +"`_vfs.zfs.l2arc.write_max_` — Ограничивает объём данных, записываемых в " +"crossref:zfs[zfs-term-l2arc,L2ARC] в секунду. Этот параметр увеличивает срок " +"службы SSD, ограничивая объём данных, записываемых на устройство. Значение " +"можно изменить в любой момент с помощью man:sysctl[8]." #. type: Plain text -#: documentation/content/en/books/handbook/zfs/_index.adoc:2674 +#: documentation/content/en/books/handbook/zfs/_index.adoc:4070 msgid "" -"[[zfs-advanced-tuning-min-auto-ashift]] `_vfs.zfs.min_auto_ashift_` - Lower " -"`ashift` (sector size) used automatically at pool creation time. The value " -"is a power of two. The default value of `9` represents `2^9 = 512`, a sector " -"size of 512 bytes. To avoid _write amplification_ and get the best " -"performance, set this value to the largest sector size used by a device in " -"the pool." +"`_vfs.zfs.l2arc.write_boost_` - Adds the value of this tunable to `vfs.zfs." +"l2arc.write_max` and increases the write speed to the SSD until evicting the " +"first block from the crossref:zfs[zfs-term-l2arc,L2ARC]. This \"Turbo " +"Warmup Phase\" reduces the performance loss from an empty L2ARC after a " +"reboot. Adjust this value at any time with man:sysctl[8]." msgstr "" -"[[zfs-advanced-tuning-min-auto-ashift]] `_vfs.zfs.min_auto_ashift_` - " -"Минимальное значение `ashift` (размер сектора), автоматически используемое " -"при создании пула. Значение является степенью двойки. Значение по умолчанию " -"`9` соответствует `2^9 = 512`, то есть размеру сектора 512 байт. Чтобы " -"избежать _усиления записи_ (write amplification) и получить наилучшую " -"производительность, установите это значение равным наибольшему размеру " -"сектора среди устройств в пуле." +"`_vfs.zfs.l2arc.write_boost_` — Добавляет значение этого параметра к `vfs.zfs" +".l2arc.write_max` и увеличивает скорость записи на SSD до вытеснения первого " +"блока из crossref:zfs[zfs-term-l2arc,L2ARC]. Эта \"Фаза турборазогрева\" " +"снижает потерю производительности из-за пустого L2ARC после перезагрузки. " +"Значение можно изменить в любое время с помощью man:sysctl[8]." #. type: Plain text -#: documentation/content/en/books/handbook/zfs/_index.adoc:2680 +#: documentation/content/en/books/handbook/zfs/_index.adoc:4073 msgid "" -"Common drives have 4 KB sectors. Using the default `ashift` of `9` with " -"these drives results in write amplification on these devices. Data " -"contained in a single 4 KB write is instead written in eight 512-byte " -"writes. ZFS tries to read the native sector size from all devices when " -"creating a pool, but drives with 4 KB sectors report that their sectors are " -"512 bytes for compatibility. Setting `vfs.zfs.min_auto_ashift` to `12` " -"(`2^12 = 4096`) before creating a pool forces ZFS to use 4 KB blocks for " -"best performance on these drives." +"`_vfs.zfs.l2arc.rebuild_enabled_` - Make the contents of the crossref:" +"zfs[zfs-term-l2arc,L2ARC] persist across reboots. With the default of `1`, " +"ZFS rebuilds the L2ARC from the log blocks stored on the cache device when " +"importing a pool, avoiding the long warm-up period an empty cache would " +"otherwise need. Set this value to `0` to always start with an empty L2ARC." msgstr "" -"Обычные диски имеют секторы размером 4 КБ. Использование значения `ashift` " -"по умолчанию (`9`) для таких дисков приводит к усилению записи на этих " -"устройствах. Данные, которые должны быть записаны одним блоком 4 КБ, вместо " -"этого записываются восемью блоками по 512 байт. ZFS пытается определить " -"родной размер сектора всех устройств при создании пула, но диски с секторами " -"4 КБ сообщают, что их секторы имеют размер 512 байт для совместимости. " -"Установка `vfs.zfs.min_auto_ashift` в значение `12` (`2^12 = 4096`) перед " -"созданием пула заставляет ZFS использовать блоки 4 КБ для наилучшей " -"производительности на таких дисках." +"`_vfs.zfs.l2arc.rebuild_enabled_` - Обеспечивает сохранение содержимого " +"crossref:zfs[zfs-term-l2arc,L2ARC] при перезагрузках. При значении по " +"умолчанию `1`, ZFS перестраивает L2ARC из журнальных блоков, хранящихся на " +"устройстве кэша, при импорте пула, избегая длительного периода прогрева, " +"который потребовался бы пустому кэшу. Установите это значение в `0`, чтобы " +"всегда начинать с пустого L2ARC." #. type: Plain text -#: documentation/content/en/books/handbook/zfs/_index.adoc:2683 +#: documentation/content/en/books/handbook/zfs/_index.adoc:4077 msgid "" -"Forcing 4 KB blocks is also useful on pools with planned disk upgrades. " -"Future disks use 4 KB sectors, and `ashift` values cannot change after " -"creating a pool." +"`_vfs.zfs.vdev.max_active_` - Upper number of I/O requests active on each " +"device in the pool. A higher value keeps the device command queues full and " +"may give higher throughput. A lower value reduces latency. Adjust this " +"value at any time with man:sysctl[8]." msgstr "" -"Принудительное использование блоков размером 4 КБ также полезно для пулов с " -"запланированным обновлением дисков. Будущие диски используют секторы " -"размером 4 КБ, а значения `ashift` нельзя изменить после создания пула." +"`_vfs.zfs.vdev.max_active_` — максимальное количество активных запросов " +"ввода-вывода на каждом устройстве в пуле. Более высокое значение " +"поддерживает очередь команд устройства заполненной и может увеличить " +"пропускную способность. Более низкое значение уменьшает задержки. Это " +"значение можно изменить в любое время с помощью man:sysctl[8]." #. type: Plain text -#: documentation/content/en/books/handbook/zfs/_index.adoc:2687 +#: documentation/content/en/books/handbook/zfs/_index.adoc:4080 +msgid "" +"`_vfs.zfs.vdev.*_min_active_` and `_vfs.zfs.vdev.*_max_active_` - Lower and " +"upper number of concurrent I/O requests the scheduler issues to each device " +"for every I/O class: `sync_read`, `sync_write`, `async_read`, `async_write`, " +"`scrub`, and others. These per-class limits replace the delay-based " +"crossref:zfs[zfs-term-scrub,scrub] and crossref:zfs[zfs-term-resilver," +"resilver] throttling found in older versions of ZFS. For example, " +"increasing `vfs.zfs.vdev.scrub_max_active` lets a scrub use a larger share " +"of each device's queue, finishing sooner at the cost of foreground I/O " +"latency." +msgstr "" +"`_vfs.zfs.vdev.*_min_active_` и `_vfs.zfs.vdev.*_max_active_` — нижний и " +"верхний предел количества одновременных запросов ввода-вывода, которые " +"планировщик отправляет каждому устройству для каждого класса ввода-вывода: " +"`sync_read`, `sync_write`, `async_read`, `async_write`, `scrub` и других. " +"Эти ограничения для каждого класса заменяют основанное на задержках " +"ограничение crossref:zfs[zfs-term-scrub,scrub] и crossref:zfs[zfs-term-" +"resilver,resilver], которое использовалось в более старых версиях ZFS. " +"Например, увеличение `vfs.zfs.vdev.scrub_max_active` позволяет операциям " +"проверки (scrub) использовать большую долю очереди каждого устройства, " +"завершаясь быстрее за счет увеличения задержки операций ввода-вывода " +"переднего плана." + +#. type: Plain text +#: documentation/content/en/books/handbook/zfs/_index.adoc:4083 +msgid "" +"`_vfs.zfs.resilver_min_time_ms_` - Lower amount of time, in milliseconds, " +"that a crossref:zfs[zfs-term-resilver,resilver] spends working between " +"transaction group flushes; the default is `3000` (3 seconds). Increase this " +"value to complete a resilver sooner when a degraded pool is at risk of " +"losing another device, at the cost of slowing down normal pool operation. " +"Adjust this value at any time with man:sysctl[8]." +msgstr "" +"_`vfs.zfs.resilver_min_time_ms_`_ — минимальное количество времени в " +"миллисекундах, которое crossref:zfs[zfs-term-resilver,resilver] тратит на " +"работу между сбросами групп транзакций; по умолчанию равно `3000` (3 секунды)" +". Увеличьте это значение, чтобы завершить процесс восстановления (resilver) " +"быстрее, когда деградировавший пул находится под угрозой потери другого " +"устройства, ценой замедления нормальной работы пула. Изменяйте это значение " +"в любое время с помощью man:sysctl[8]." + +#. type: Title === +#: documentation/content/en/books/handbook/zfs/_index.adoc:4085 +#, no-wrap +msgid "ARC Sizing and Monitoring" +msgstr "Определение размера ARC и мониторинг" + +#. type: Plain text +#: documentation/content/en/books/handbook/zfs/_index.adoc:4091 msgid "" -"In some specific cases, the smaller 512-byte block size might be " -"preferable. When used with 512-byte disks for databases or as storage for " -"virtual machines, less data transfers during small random reads. This can " -"provide better performance when using a smaller ZFS record size." +"ZFS keeps recently and frequently used data and metadata in RAM in the " +"crossref:zfs[zfs-term-arc,ARC]. The ARC grows on demand up to `vfs.zfs.arc." +"max` and shrinks again when other programs need memory, so on a dedicated " +"storage server it is normal for most of the RAM to be in use. The ARC " +"stores blocks in their compressed on-disk form and decompresses them on " +"access. This _compressed ARC_ lets the same amount of RAM cache more data, " +"increasing the effective hit rate." msgstr "" -"В некоторых конкретных случаях меньший размер блока 512 байт может быть " -"предпочтительнее. При использовании с дисками 512 байт для баз данных или в " -"качестве хранилища для виртуальных машин уменьшается объём передаваемых " -"данных при небольших случайных чтениях. Это может обеспечить лучшую " -"производительность при использовании меньшего размера записи ZFS." +"ZFS хранит недавно и часто используемые данные и метаданные в оперативной " +"памяти в crossref:zfs[zfs-term-arc,ARC]. ARC растет по мере необходимости до " +"`vfs.zfs.arc.max` и снова уменьшается, когда другим программам нужна память, " +"поэтому на выделенном сервере хранения нормально, что большая часть " +"оперативной памяти используется. ARC хранит блоки в их сжатом виде на диске " +"и распаковывает их при доступе. Этот _сжатый ARC_ позволяет тому же объему " +"оперативной памяти кэшировать больше данных, увеличивая эффективную частоту " +"попаданий." #. type: Plain text -#: documentation/content/en/books/handbook/zfs/_index.adoc:2691 +#: documentation/content/en/books/handbook/zfs/_index.adoc:4094 +msgid "" +"man:top[1] shows the current ARC size in its memory summary line. The " +"`kstat.zfs.misc.arcstats` man:sysctl[8] tree exposes detailed statistics, " +"including the current size, the target maximum, and hit and miss counters:" +msgstr "" +"man:top[1] отображает текущий размер ARC в строке сводки по памяти. Дерево " +"`kstat.zfs.misc.arcstats` из man:sysctl[8] предоставляет подробную " +"статистику, включая текущий размер, целевой максимум, а также счетчики " +"попаданий и промахов:" + +#. type: delimited block . 4 +#: documentation/content/en/books/handbook/zfs/_index.adoc:4102 +#, no-wrap msgid "" -"[[zfs-advanced-tuning-prefetch_disable]] `_vfs.zfs.prefetch.disable_` - " -"Disable prefetch. A value of `0` enables and `1` disables it. The default is " -"`0`, unless the system has less than 4 GB of RAM. Prefetch works by reading " -"larger blocks than requested into the crossref:zfs[zfs-term-arc,ARC] in " -"hopes to soon need the data. If the workload has a large number of random " -"reads, disabling prefetch may actually improve performance by reducing " -"unnecessary reads. Adjust this value at any time with man:sysctl[8]." -msgstr "" -"[[zfs-advanced-tuning-prefetch_disable]] `_vfs.zfs.prefetch.disable_` — " -"Отключает предварительную выборку. Значение `0` включает её, а `1` " -"отключает. По умолчанию используется `0`, если в системе не менее 4 ГБ " -"оперативной памяти. Предварительная выборка работает, считывая блоки " -"большего размера, чем запрошено, в раздел crossref:zfs[zfs-term-arc,ARC], в " -"надежде, что данные скоро понадобятся. Если рабочая нагрузка включает " -"большое количество случайных чтений, отключение предварительной выборки " -"может улучшить производительность, сократив ненужные чтения. Это значение " -"можно изменить в любое время с помощью man:sysctl[8]." - -#. type: Plain text -#: documentation/content/en/books/handbook/zfs/_index.adoc:2692 -msgid "" -"[[zfs-advanced-tuning-vdev-trim_on_init]] `_vfs.zfs.vdev.trim_on_init_` - " -"Control whether new devices added to the pool have the `TRIM` command run on " -"them. This ensures the best performance and longevity for SSDs, but takes " -"extra time. If the device has already been secure erased, disabling this " -"setting will make the addition of the new device faster. Adjust this value " -"at any time with man:sysctl[8]." -msgstr "" -"[[zfs-advanced-tuning-vdev-trim_on_init]] `_vfs.zfs.vdev.trim_on_init_` — " -"Управляет тем, будет ли для новых устройств, добавленных в пул, выполняться " -"команда `TRIM`. Это обеспечивает наилучшую производительность и " -"долговечность для SSD, но занимает дополнительное время. Если устройство уже " -"было безопасно очищено, отключение этой настройки ускорит добавление нового " -"устройства. Значение можно изменить в любой момент с помощью man:sysctl[8]." - -#. type: Plain text -#: documentation/content/en/books/handbook/zfs/_index.adoc:2693 -msgid "" -"[[zfs-advanced-tuning-vdev-max_pending]] `_vfs.zfs.vdev.max_pending_` - " -"Limit the number of pending I/O requests per device. A higher value will " -"keep the device command queue full and may give higher throughput. A lower " -"value will reduce latency. Adjust this value at any time with man:sysctl[8]." -msgstr "" -"[[zfs-advanced-tuning-vdev-max_pending]] `_vfs.zfs.vdev.max_pending_` — " -"Ограничивает количество ожидающих запросов ввода-вывода для каждого " -"устройства. Более высокое значение поддерживает очередь команд устройства " -"заполненной и может увеличить пропускную способность. Более низкое значение " -"уменьшает задержки. Это значение можно изменить в любое время с помощью man:" -"sysctl[8]." - -#. type: Plain text -#: documentation/content/en/books/handbook/zfs/_index.adoc:2699 -msgid "" -"[[zfs-advanced-tuning-top_maxinflight]] `_vfs.zfs.top_maxinflight_` - Upper " -"number of outstanding I/Os per top-level crossref:zfs[zfs-term-vdev,vdev]. " -"Limits the depth of the command queue to prevent high latency. The limit is " -"per top-level vdev, meaning the limit applies to each crossref:zfs[zfs-term-" -"vdev-mirror,mirror], crossref:zfs[zfs-term-vdev-raidz,RAID-Z], or other vdev " -"independently. Adjust this value at any time with man:sysctl[8]." -msgstr "" -"[[zfs-advanced-tuning-top_maxinflight]] `_vfs.zfs.top_maxinflight_` — " -"Верхний предел количества необработанных операций ввода-вывода для каждого " -"корневого crossref:zfs[zfs-term-vdev,vdev]. Ограничивает глубину очереди " -"команд для предотвращения высокой задержки. Лимит применяется к каждому " -"корневому vdev, то есть ограничение действует независимо для каждого " -"crossref:zfs[zfs-term-vdev-mirror,зеркала], crossref:zfs[zfs-term-vdev-raidz," -"RAID-Z] или другого vdev. Значение можно изменить в любое время с помощью " -"man:sysctl[8]." +"% sysctl kstat.zfs.misc.arcstats.size kstat.zfs.misc.arcstats.c_max kstat.zfs.misc.arcstats.hits kstat.zfs.misc.arcstats.misses\n" +"kstat.zfs.misc.arcstats.size: 8963041280\n" +"kstat.zfs.misc.arcstats.c_max: 15843122176\n" +"kstat.zfs.misc.arcstats.hits: 954912441\n" +"kstat.zfs.misc.arcstats.misses: 21356847\n" +msgstr "" +"% sysctl kstat.zfs.misc.arcstats.size kstat.zfs.misc.arcstats.c_max " +"kstat.zfs.misc.arcstats.hits kstat.zfs.misc.arcstats.misses\n" +"kstat.zfs.misc.arcstats.size: 8963041280\n" +"kstat.zfs.misc.arcstats.c_max: 15843122176\n" +"kstat.zfs.misc.arcstats.hits: 954912441\n" +"kstat.zfs.misc.arcstats.misses: 21356847\n" #. type: Plain text -#: documentation/content/en/books/handbook/zfs/_index.adoc:2701 +#: documentation/content/en/books/handbook/zfs/_index.adoc:4105 msgid "" -"[[zfs-advanced-tuning-l2arc_write_max]] `_vfs.zfs.l2arc_write_max_` - Limit " -"the amount of data written to the crossref:zfs[zfs-term-l2arc,L2ARC] per " -"second. This tunable extends the longevity of SSDs by limiting the amount of " -"data written to the device. Adjust this value at any time with man:sysctl[8]." -msgstr "" -"[[zfs-advanced-tuning-l2arc_write_max]] `_vfs.zfs.l2arc_write_max_` — " -"Ограничивает объём данных, записываемых в crossref:zfs[zfs-term-l2arc,L2ARC] " -"в секунду. Этот параметр увеличивает срок службы SSD, ограничивая объём " -"данных, записываемых на устройство. Значение можно изменить в любой момент с " -"помощью man:sysctl[8]." - -#. type: Plain text -#: documentation/content/en/books/handbook/zfs/_index.adoc:2707 -msgid "" -"[[zfs-advanced-tuning-l2arc_write_boost]] `_vfs.zfs.l2arc_write_boost_` - " -"Adds the value of this tunable to crossref:zfs[zfs-advanced-tuning-" -"l2arc_write_max,`vfs.zfs.l2arc_write_max`] and increases the write speed to " -"the SSD until evicting the first block from the crossref:zfs[zfs-term-l2arc," -"L2ARC]. This \"Turbo Warmup Phase\" reduces the performance loss from an " -"empty crossref:zfs[zfs-term-l2arc,L2ARC] after a reboot. Adjust this value " -"at any time with man:sysctl[8]." -msgstr "" -"[[zfs-advanced-tuning-l2arc_write_boost]] `_vfs.zfs.l2arc_write_boost_` — " -"Добавляет значение этого параметра к crossref:zfs[zfs-advanced-tuning-" -"l2arc_write_max,`vfs.zfs.l2arc_write_max`] и увеличивает скорость записи на " -"SSD до вытеснения первого блока из crossref:zfs[zfs-term-l2arc,L2ARC]. Эта " -"\"Фаза турборазогрева\" снижает потерю производительности из-за пустого " -"crossref:zfs[zfs-term-l2arc,L2ARC] после перезагрузки. Значение можно " -"изменить в любое время с помощью man:sysctl[8]." - -#. type: Plain text -#: documentation/content/en/books/handbook/zfs/_index.adoc:2712 -msgid "" -"[[zfs-advanced-tuning-scrub_delay]]`_vfs.zfs.scrub_delay_` - Number of ticks " -"to delay between each I/O during a crossref:zfs[zfs-term-scrub,`scrub`]. To " -"ensure that a `scrub` does not interfere with the normal operation of the " -"pool, if any other I/O is happening the `scrub` will delay between each " -"command. This value controls the limit on the total IOPS (I/Os Per Second)" -msgstr "" -"[[zfs-advanced-tuning-scrub_delay]]`_vfs.zfs.scrub_delay_` — Количество " -"тактов задержки между каждой операцией ввода-вывода во время перекрестного " -"crossref:zfs[zfs-term-scrub,`scrub`]. Чтобы гарантировать, что `scrub` не " -"мешает нормальной работе пула, если происходят другие операции ввода-вывода, " -"`scrub` будет задерживаться между каждой командой. Это значение контролирует " -"ограничение на общее количество IOPS (операций ввода-вывода в секунду)" - -#. type: Plain text -#: documentation/content/en/books/handbook/zfs/_index.adoc:2720 -msgid "" -"generated by the `scrub`. The granularity of the setting is determined by " -"the value of `kern.hz` which defaults to 1000 ticks per second. Changing " -"this setting results in a different effective IOPS limit. The default value " -"is `4`, resulting in a limit of: 1000 ticks/sec / 4 = 250 IOPS. Using a " -"value of _20_ would give a limit of: 1000 ticks/sec / 20 = 50 IOPS. Recent " -"activity on the pool limits the speed of `scrub`, as determined by crossref:" -"zfs[zfs-advanced-tuning-scan_idle,`vfs.zfs.scan_idle`]. Adjust this value at " -"any time with man:sysctl[8]." -msgstr "" -", сгенерированных командой `scrub`. Гранулярность настройки определяется " -"значением `kern.hz`, которое по умолчанию равно 1000 тикам в секунду. " -"Изменение этого параметра приводит к изменению эффективного лимита IOPS. " -"Значение по умолчанию — `4`, что даёт лимит: 1000 тиков/сек / 4 = 250 IOPS. " -"Использование значения _20_ установит лимит: 1000 тиков/сек / 20 = 50 IOPS. " -"Недавняя активность в пуле ограничивает скорость `scrub`, как определено в " -"crossref:zfs[zfs-advanced-tuning-scan_idle,`vfs.zfs.scan_idle`]. Это " -"значение можно изменить в любое время с помощью man:sysctl[8]." +"package:filesystems/zfs-stats[] summarizes these statistics in a human-" +"readable report." +msgstr "" +"package:filesystems/zfs-stats[] обобщает эти статистические данные в " +"удобочитаемом отчете." #. type: Plain text -#: documentation/content/en/books/handbook/zfs/_index.adoc:2736 -msgid "" -"[[zfs-advanced-tuning-resilver_delay]] `_vfs.zfs.resilver_delay_` - Number " -"of milliseconds of delay inserted between each I/O during a crossref:zfs[zfs-" -"term-resilver,resilver]. To ensure that a resilver does not interfere with " -"the normal operation of the pool, if any other I/O is happening the resilver " -"will delay between each command. This value controls the limit of total IOPS " -"(I/Os Per Second) generated by the resilver. ZFS determins the granularity " -"of the setting by the value of `kern.hz` which defaults to 1000 ticks per " -"second. Changing this setting results in a different effective IOPS limit. " -"The default value is 2, resulting in a limit of: 1000 ticks/sec / 2 = 500 " -"IOPS. Returning the pool to an crossref:zfs[zfs-term-online,Online] state " -"may be more important if another device failing could crossref:zfs[zfs-term-" -"faulted,Fault] the pool, causing data loss. A value of 0 will give the " -"resilver operation the same priority as other operations, speeding the " -"healing process. Other recent activity on the pool limits the speed of " -"resilver, as determined by crossref:zfs[zfs-advanced-tuning-scan_idle,`vfs." -"zfs.scan_idle`]. Adjust this value at any time with man:sysctl[8]." -msgstr "" -"[[zfs-advanced-tuning-resilver_delay]] `_vfs.zfs.resilver_delay_` — " -"количество миллисекунд задержки, вставляемой между каждым операцией ввода-" -"вывода во время crossref:zfs[zfs-term-resilver,ресильверинга]. Чтобы " -"гарантировать, что ресильверинг не мешает нормальной работе пула, при " -"наличии других операций ввода-вывода ресильверинг будет добавлять задержку " -"между каждой командой. Данный параметр ограничивает общее количество IOPS " -"(операций ввода-вывода в секунду), генерируемых ресильверингом. ZFS " -"определяет гранулярность настройки через значение `kern.hz`, которое по " -"умолчанию равно 1000 тикам в секунду. Изменение этого параметра приводит к " -"изменению эффективного лимита IOPS. Значение по умолчанию — 2, что даёт " -"лимит: 1000 тиков/сек / 2 = 500 IOPS. Возвращение пула в состояние crossref:" -"zfs[zfs-term-online,Online] может быть более важным, если выход из строя " -"другого устройства может перевести пул в состояние crossref:zfs[zfs-term-" -"faulted,Fault], что приведёт к потере данных. Значение 0 даст операции " -"ресильверинга такой же приоритет, как и другим операциям, ускоряя процесс " -"восстановления. Недавняя активность в пуле ограничивает скорость " -"ресильверинга, как определено в crossref:zfs[zfs-advanced-tuning-scan_idle," -"`vfs.zfs.scan_idle`]. Этот параметр можно изменить в любое время с помощью " -"man:sysctl[8]." - -#. type: Plain text -#: documentation/content/en/books/handbook/zfs/_index.adoc:2740 -msgid "" -"[[zfs-advanced-tuning-scan_idle]] `_vfs.zfs.scan_idle_` - Number of " -"milliseconds since the last operation before considering the pool is idle. " -"ZFS disables the rate limiting for crossref:zfs[zfs-term-scrub,`scrub`] and " -"crossref:zfs[zfs-term-resilver,resilver] when the pool is idle. Adjust this " -"value at any time with man:sysctl[8]." +#: documentation/content/en/books/handbook/zfs/_index.adoc:4109 +msgid "" +"The ARC yields memory under pressure, but on systems that share RAM between " +"ZFS and other large consumers such as databases, virtual machines, or jails, " +"the competition can cause uneven performance on both sides. Capping the ARC " +"leaves a predictable amount of memory for the other workloads. For example, " +"to limit the ARC to 8 GB, add this line to [.filename]#/boot/loader.conf#:" msgstr "" -"[[zfs-advanced-tuning-scan_idle]] `_vfs.zfs.scan_idle_` - Количество " -"миллисекунд с момента последней операции, после которого пул считается " -"бездействующим. ZFS отключает ограничение скорости для crossref:zfs[zfs-term-" -"scrub,`scrub`] и crossref:zfs[zfs-term-resilver,ресильверинга], когда пул " -"бездействует. Это значение можно изменить в любое время с помощью man:" -"sysctl[8]." - -#. type: Plain text -#: documentation/content/en/books/handbook/zfs/_index.adoc:2742 -msgid "" -"[[zfs-advanced-tuning-txg-timeout]] `_vfs.zfs.txg.timeout_` - Upper number " -"of seconds between crossref:zfs[zfs-term-txg,transaction group]s. The " -"current transaction group writes to the pool and a fresh transaction group " -"starts if this amount of time elapsed since the previous transaction group. " -"A transaction group may trigger earlier if writing enough data. The default " -"value is 5 seconds. A larger value may improve read performance by delaying " -"asynchronous writes, but this may cause uneven performance when writing the " -"transaction group. Adjust this value at any time with man:sysctl[8]." -msgstr "" -"[[zfs-advanced-tuning-txg-timeout]] `_vfs.zfs.txg.timeout_` — Максимальное " -"количество секунд между группами crossref:zfs[zfs-term-txg,транзакций]. " -"Текущая группа транзакций записывается в пул, и начинается новая группа " -"транзакций, если с момента предыдущей группы транзакций прошло указанное " -"время. Группа транзакций может запуститься раньше при записи достаточного " -"объёма данных. Значение по умолчанию составляет 5 секунд. Увеличение этого " -"значения может улучшить производительность чтения за счет задержки " -"асинхронных записей, но это может привести к неравномерной " -"производительности при записи группы транзакций. Это значение можно изменить " -"в любое время с помощью man:sysctl[8]." +"ARC возвращает память при нехватке ресурсов, но на системах, где ОЗУ " +"разделяется между ZFS и другими крупными потребителями, такими как базы " +"данных, виртуальные машины или клетки, конкуренция может вызывать " +"неравномерную производительность с обеих сторон. Ограничение ARC оставляет " +"предсказуемый объём памяти для других рабочих нагрузок. Например, чтобы " +"ограничить ARC до 8 ГБ, добавьте эту строку в [.filename]#/boot/loader.conf#:" -#. type: Title === -#: documentation/content/en/books/handbook/zfs/_index.adoc:2744 +#. type: delimited block . 4 +#: documentation/content/en/books/handbook/zfs/_index.adoc:4113 #, no-wrap -msgid "ZFS on i386" -msgstr "ZFS на i386" +msgid "vfs.zfs.arc.max=\"8G\"\n" +msgstr "vfs.zfs.arc.max=\"8G\"\n" #. type: Plain text -#: documentation/content/en/books/handbook/zfs/_index.adoc:2747 +#: documentation/content/en/books/handbook/zfs/_index.adoc:4116 msgid "" -"Some of the features provided by ZFS are memory intensive, and may require " -"tuning for upper efficiency on systems with limited RAM." +"Changing `vfs.zfs.arc.max` with man:sysctl[8] takes effect immediately, " +"although shrinking a warm ARC frees memory gradually." msgstr "" -"Некоторые функции ZFS требуют значительных ресурсов памяти и могут " -"потребовать настройки для повышения эффективности на системах с ограниченным " -"объёмом ОЗУ." - -#. type: Title ==== -#: documentation/content/en/books/handbook/zfs/_index.adoc:2748 -#, no-wrap -msgid "Memory" -msgstr "Память" - -#. type: Plain text -#: documentation/content/en/books/handbook/zfs/_index.adoc:2756 -msgid "" -"As a lower value, the total system memory should be at least one gigabyte. " -"The amount of recommended RAM depends upon the size of the pool and which " -"features ZFS uses. A general rule of thumb is 1 GB of RAM for every 1 TB of " -"storage. If using the deduplication feature, a general rule of thumb is 5 " -"GB of RAM per TB of storage to deduplicate. While some users use ZFS with " -"less RAM, systems under heavy load may panic due to memory exhaustion. ZFS " -"may require further tuning for systems with less than the recommended RAM " -"requirements." -msgstr "" -"В качестве минимального значения общий объём оперативной памяти системы " -"должен составлять не менее одного гигабайта. Рекомендуемый объём оперативной " -"памяти зависит от размера пула и используемых возможностей ZFS. Общее " -"правило — 1 ГБ оперативной памяти на каждый 1 ТБ дискового пространства. При " -"использовании функции дедупликации рекомендуется выделять 5 ГБ оперативной " -"памяти на каждый 1 ТБ хранилища. Хотя некоторые пользователи используют ZFS " -"с меньшим объёмом оперативной памяти, системы под высокой нагрузкой могут " -"завершаться аварийно из-за нехватки памяти. Для систем с объёмом оперативной " -"памяти меньше рекомендуемого может потребоваться дополнительная настройка " -"ZFS." +"Изменение `vfs.zfs.arc.max` с помощью man:sysctl[8] вступает в силу " +"немедленно, хотя уменьшение теплого ARC освобождает память постепенно." -#. type: Title ==== -#: documentation/content/en/books/handbook/zfs/_index.adoc:2757 +#. type: Title === +#: documentation/content/en/books/handbook/zfs/_index.adoc:4118 #, no-wrap -msgid "Kernel Configuration" -msgstr "Настройка ядра" +msgid "Synchronous Writes, the ZIL, and SLOG" +msgstr "Синхронные записи, ZIL и SLOG" + +#. type: Plain text +#: documentation/content/en/books/handbook/zfs/_index.adoc:4124 +msgid "" +"Every pool has a crossref:zfs[zfs-term-zil,ZIL]. Applications that request " +"synchronous semantics with man:fsync[2] or the `O_SYNC` flag do not get an " +"acknowledgment until ZFS commits the corresponding intent log record to " +"stable storage. By default the ZIL lives on the pool's regular vdevs, so " +"every synchronous write competes with normal pool I/O. Asynchronous writes " +"bypass the ZIL and are written with the next crossref:zfs[zfs-term-txg," +"transaction group]." +msgstr "" +"Каждый пул имеет crossref:zfs[zfs-term-zil,ZIL]. Приложения, запрашивающие " +"синхронную семантику с помощью man:fsync[2] или флага `O_SYNC`, не получают " +"подтверждение до тех пор, пока ZFS не зафиксирует соответствующую запись " +"журнала намерений в стабильном хранилище. По умолчанию ZIL располагается на " +"обычных vdev пула, поэтому каждая синхронная запись конкурирует с обычным " +"вводом-выводом пула. Асинхронные записи обходят ZIL и записываются со " +"следующей crossref:zfs[zfs-term-txg,транзакционной группой]." #. type: Plain text -#: documentation/content/en/books/handbook/zfs/_index.adoc:2760 +#: documentation/content/en/books/handbook/zfs/_index.adoc:4126 msgid "" -"Due to the address space limitations of the i386(TM) platform, ZFS users on " -"the i386(TM) architecture must add this option to a custom kernel " -"configuration file, rebuild the kernel, and reboot:" +"A dedicated crossref:zfs[zfs-term-vdev-log,log] vdev, often called a _SLOG_ " +"(separate log), moves the ZIL to a fast device:" msgstr "" -"Из-за ограничений адресного пространства платформы i386(TM), пользователям " -"ZFS на архитектуре i386(TM) необходимо добавить следующую опцию в файл " -"конфигурации собственного ядра, пересобрать ядро и перезагрузить систему:" +"Выделенный перекрестная ссылка:zfs[zfs-term-vdev-log,log] vdev, часто " +"называемый _SLOG_ (отдельный журнал), перемещает ZIL на быстрое устройство:" #. type: delimited block . 4 -#: documentation/content/en/books/handbook/zfs/_index.adoc:2764 +#: documentation/content/en/books/handbook/zfs/_index.adoc:4130 #, no-wrap -msgid "options KVA_PAGES=512\n" -msgstr "options KVA_PAGES=512\n" +msgid "# zpool add mypool log mirror nda0 nda1\n" +msgstr "# zpool add mypool log mirror nda0 nda1\n" #. type: Plain text -#: documentation/content/en/books/handbook/zfs/_index.adoc:2769 +#: documentation/content/en/books/handbook/zfs/_index.adoc:4134 msgid "" -"This expands the kernel address space, allowing the `vm.kvm_size` tunable to " -"push beyond the imposed limit of 1 GB, or the limit of 2 GB for PAE. To " -"find the most suitable value for this option, divide the desired address " -"space in megabytes by four. In this example `512` for 2 GB." +"A SLOG helps only workloads that generate a lot of synchronous writes, such " +"as NFS servers and databases. It makes no difference for purely " +"asynchronous workloads." msgstr "" -"Это расширяет адресное пространство ядра, позволяя настройке `vm.kvm_size` " -"выйти за установленный предел в 1 ГБ или предел в 2 ГБ для PAE. Чтобы найти " -"наиболее подходящее значение для этой опции, разделите желаемое адресное " -"пространство в мегабайтах на четыре. В данном примере `512` для 2 ГБ." +"SLOG помогает только рабочим нагрузкам, которые генерируют много синхронных " +"записей, например, NFS-серверам и базам данных. Для чисто асинхронных " +"рабочих нагрузок он не имеет значения." -#. type: Title ==== -#: documentation/content/en/books/handbook/zfs/_index.adoc:2770 +#. type: Plain text +#: documentation/content/en/books/handbook/zfs/_index.adoc:4138 +msgid "" +"A few gigabytes of SLOG capacity is plenty: the ZIL holds at most a few " +"seconds of incoming writes, roughly one transaction group's worth, before " +"ZFS writes the data to its final location in the pool. Choose SSDs with " +"power-loss protection and low sustained write latency, and mirror the log " +"devices. ZFS reads the ZIL only after a crash, so losing an unmirrored SLOG " +"together with a system crash loses the writes that were acknowledged but not " +"yet committed to the pool." +msgstr "" +"Несколько гигабайт ёмкости SLOG вполне достаточно: ZIL хранит максимум " +"несколько секунд входящих записей, примерно объём одной группы транзакций, " +"прежде чем ZFS запишет данные в их конечное расположение в пуле. Выбирайте " +"SSD с защитой от потери питания и низкой задержкой устойчивой записи, а " +"также зеркалируйте устройства журнала. ZFS читает ZIL только после сбоя, " +"поэтому потеря незеркалированного SLOG вместе со сбоем системы приводит к " +"потере записей, которые были подтверждены, но ещё не зафиксированы в пуле." + +#. type: Plain text +#: documentation/content/en/books/handbook/zfs/_index.adoc:4140 +msgid "The `sync` dataset property controls synchronous write behavior:" +msgstr "Свойство `sync` набора данных управляет поведением синхронной записи:" + +#. type: Plain text +#: documentation/content/en/books/handbook/zfs/_index.adoc:4142 +msgid "" +"`sync=standard` (the default) commits synchronous writes to the ZIL and " +"asynchronous writes with the next transaction group." +msgstr "" +"`sync=standard` (по умолчанию) фиксирует синхронные записи в ZIL, а " +"асинхронные записи — со следующей группой транзакций." + +#. type: Plain text +#: documentation/content/en/books/handbook/zfs/_index.adoc:4143 +msgid "" +"`sync=always` treats every write as synchronous, trading performance for " +"safety that helps only applications which fail to request synchronous writes " +"when they should." +msgstr "" +"`sync=always` обрабатывает каждую запись как синхронную, жертвуя " +"производительностью ради безопасности, которая помогает только приложениям, " +"которые не запрашивают синхронные записи, когда это необходимо." + +#. type: Plain text +#: documentation/content/en/books/handbook/zfs/_index.adoc:4144 +msgid "`sync=disabled` treats every write as asynchronous." +msgstr "`sync=disabled` обрабатывает каждую запись как асинхронную." + +#. type: delimited block = 4 +#: documentation/content/en/books/handbook/zfs/_index.adoc:4150 +msgid "" +"With `sync=disabled`, ZFS acknowledges synchronous writes before they reach " +"stable storage. The pool itself stays consistent, but after a crash or " +"power failure, applications and NFS clients silently lose up to a few " +"seconds of data they believed was safely written. Do not use " +"`sync=disabled` for databases, NFS exports, or any other data that matters." +msgstr "" +"С `sync=disabled` ZFS подтверждает синхронные записи до того, как они " +"достигнут стабильного хранилища. Сам пул остается согласованным, но после " +"сбоя или отключения питания приложения и NFS-клиенты незаметно теряют до " +"нескольких секунд данных, которые, как они считали, были безопасно записаны. " +"Не используйте `sync=disabled` для баз данных, NFS-экспортов или любых " +"других важных данных." + +#. type: Plain text +#: documentation/content/en/books/handbook/zfs/_index.adoc:4154 +msgid "" +"The `logbias` property tunes how ZFS uses the log: `logbias=latency` (the " +"default) favors the SLOG to minimize commit latency, while " +"`logbias=throughput` writes synchronous data directly to the main pool, " +"reserving SLOG capacity for latency-sensitive datasets. See man:zfsprops[7] " +"for details." +msgstr "" +"Свойство `logbias` регулирует, как ZFS использует журнал: `logbias=latency` (" +"по умолчанию) предпочитает SLOG для минимизации задержки фиксации, тогда как " +"`logbias=throughput` записывает синхронные данные напрямую в основной пул, " +"оставляя ёмкость SLOG для наборов данных, чувствительных к задержке. " +"Подробности см. в man:zfsprops[7]." + +#. type: Title === +#: documentation/content/en/books/handbook/zfs/_index.adoc:4156 #, no-wrap -msgid "Loader Tunables" -msgstr "Настройки загрузчика" +msgid "Direct I/O" +msgstr "Прямой ввод-вывод" + +#. type: delimited block = 4 +#: documentation/content/en/books/handbook/zfs/_index.adoc:4161 +msgid "" +"Direct I/O requires OpenZFS 2.3 or later, first available in FreeBSD 15.0." +msgstr "" +"Прямой ввод-вывод требует OpenZFS 2.3 или более поздней версии, впервые " +"доступной в FreeBSD 15.0." #. type: Plain text -#: documentation/content/en/books/handbook/zfs/_index.adoc:2774 +#: documentation/content/en/books/handbook/zfs/_index.adoc:4164 msgid "" -"Increases the [.filename]#kmem# address space on all FreeBSD architectures. " -"A test system with 1 GB of physical memory benefitted from adding these " -"options to [.filename]#/boot/loader.conf# and then restarting:" +"The `direct` dataset property controls how ZFS handles requests made with " +"the `O_DIRECT` flag:" msgstr "" -"Увеличивает адресное пространство `kmem` на всех архитектурах FreeBSD. " -"Тестовая система с 1 ГБ физической памяти показала улучшение после " -"добавления этих параметров в `/boot/loader.conf` и последующей перезагрузки:" +"Свойство набора данных `direct` управляет тем, как ZFS обрабатывает запросы, " +"сделанные с флагом `O_DIRECT`:" -#. type: delimited block . 4 -#: documentation/content/en/books/handbook/zfs/_index.adoc:2781 +#. type: Plain text +#: documentation/content/en/books/handbook/zfs/_index.adoc:4166 +msgid "" +"`direct=standard` (the default) honors `O_DIRECT`: properly aligned reads " +"and writes bypass the crossref:zfs[zfs-term-arc,ARC]." +msgstr "" +"`direct=standard` (по умолчанию) учитывает `O_DIRECT`: корректно выровненные " +"чтения и записи обходят crossref:zfs[zfs-term-arc,ARC]." + +#. type: Plain text +#: documentation/content/en/books/handbook/zfs/_index.adoc:4167 +msgid "" +"`direct=always` treats every properly aligned read or write as a direct " +"request." +msgstr "" +"`direct=always` обрабатывает каждое правильно выровненное чтение или запись " +"как прямой запрос." + +#. type: Plain text +#: documentation/content/en/books/handbook/zfs/_index.adoc:4168 +msgid "" +"`direct=disabled` silently ignores `O_DIRECT` and handles every request " +"through the ARC." +msgstr "" +"`direct=disabled` беззвучно игнорирует `O_DIRECT` и обрабатывает каждый " +"запрос через ARC." + +#. type: Plain text +#: documentation/content/en/books/handbook/zfs/_index.adoc:4172 +msgid "" +"Direct I/O avoids the memory copies and caching overhead of the ARC. On " +"pools of very fast NVMe devices this overhead can dominate the cost of the I/" +"O itself, and applications that maintain their own caches, such as " +"databases, waste RAM by caching the same data twice. For such workloads, " +"direct I/O can increase throughput and reduce memory use." +msgstr "" +"Прямой ввод-вывод позволяет избежать копирования в памяти и накладных " +"расходов на кэширование ARC. В пулах очень быстрых NVMe-устройств эти " +"накладные расходы могут доминировать над стоимостью самого ввода-вывода, а " +"приложения, поддерживающие собственные кэши, например базы данных, тратят " +"оперативную память впустую, кэшируя одни и те же данные дважды. Для таких " +"рабочих нагрузок прямой ввод-вывод может увеличить пропускную способность и " +"снизить использование памяти." + +#. type: Plain text +#: documentation/content/en/books/handbook/zfs/_index.adoc:4176 +msgid "" +"ZFS still verifies checksums for direct reads and writes, so data integrity " +"protection is unchanged. Direct writes must be aligned to the dataset " +"`recordsize`; ZFS silently redirects the unaligned portion of a request " +"through the ARC. See man:zfsprops[7] for the full alignment rules and " +"restrictions." +msgstr "" +"ZFS по-прежнему проверяет контрольные суммы для прямых чтений и записей, " +"поэтому защита целостности данных не изменяется. Прямые записи должны быть " +"выровнены по значению `recordsize` набора данных; ZFS незаметно " +"перенаправляет невыровненную часть запроса через ARC. См. man:zfsprops[7] " +"для получения полных правил и ограничений по выравниванию." + +#. type: Title === +#: documentation/content/en/books/handbook/zfs/_index.adoc:4178 #, no-wrap +msgid "`recordsize` and `volblocksize`" +msgstr "`recordsize` и `volblocksize`" + +#. type: Plain text +#: documentation/content/en/books/handbook/zfs/_index.adoc:4182 +msgid "" +"The `recordsize` property sets the largest block ZFS uses to store a file in " +"a dataset, 128 KB by default. Matching the block size to the workload's I/O " +"pattern avoids reading and writing more data than the application asked for." +msgstr "" +"Свойство `recordsize` задаёт наибольший блок, который ZFS использует для " +"хранения файла в наборе данных, по умолчанию 128 КБ. Согласование размера " +"блока с шаблоном ввода-вывода рабочей нагрузки позволяет избежать чтения и " +"записи большего объёма данных, чем запрашивает приложение." + +#. type: Plain text +#: documentation/content/en/books/handbook/zfs/_index.adoc:4186 msgid "" -"vm.kmem_size=\"330M\"\n" -"vm.kmem_size_max=\"330M\"\n" -"vfs.zfs.arc.max=\"40M\"\n" -"vfs.zfs.vdev.cache.size=\"5M\"\n" +"For databases that perform small random reads and writes, set `recordsize` " +"to the database page size, typically 8 KB or 16 KB, before creating the " +"database files. For datasets storing large media files or backup streams " +"that are read and written sequentially, `recordsize=1M` reduces metadata " +"overhead and improves compression. Volumes use the `volblocksize` property " +"instead, which defaults to 16 KB and cannot change after creating the volume." msgstr "" -"vm.kmem_size=\"330M\"\n" -"vm.kmem_size_max=\"330M\"\n" -"vfs.zfs.arc.max=\"40M\"\n" -"vfs.zfs.vdev.cache.size=\"5M\"\n" +"Для баз данных, выполняющих небольшие случайные чтения и записи, установите " +"`recordsize` равным размеру страницы базы данных, обычно 8 КБ или 16 КБ, до " +"создания файлов базы данных. Для наборов данных, хранящих большие медиафайлы " +"или потоки резервных копий, которые читаются и записываются последовательно, " +"`recordsize=1M` снижает накладные расходы на метаданные и улучшает сжатие. " +"Тома используют свойство `volblocksize` вместо этого, которое по умолчанию " +"составляет 16 КБ и не может быть изменено после создания тома." #. type: Plain text -#: documentation/content/en/books/handbook/zfs/_index.adoc:2784 +#: documentation/content/en/books/handbook/zfs/_index.adoc:4189 msgid "" -"For a more detailed list of recommendations for ZFS-related tuning, see " -"https://wiki.freebsd.org/ZFSTuningGuide[]." +"Changing `recordsize` affects newly written files only; existing files keep " +"their original block size. Not even crossref:zfs[zfs-zfs-rewrite,`zfs " +"rewrite`] applies a new `recordsize` to existing files, as property changes " +"that affect the logical block size have no effect on rewritten blocks; copy " +"the files anew to store them with the new value." msgstr "" -"Для более подробного списка рекомендаций по настройке ZFS см. https://wiki." -"freebsd.org/ZFSTuningGuide[]." +"Изменение `recordsize` влияет только на новые записанные файлы; существующие " +"файлы сохраняют свой исходный размер блока. Даже crossref:zfs[zfs-zfs-" +"rewrite,`zfs rewrite`] не применяет новое значение `recordsize` к " +"существующим файлам, поскольку изменения свойств, влияющие на логический " +"размер блока, не действуют на перезаписанные блоки; скопируйте файлы заново, " +"чтобы сохранить их с новым значением." #. type: Title == -#: documentation/content/en/books/handbook/zfs/_index.adoc:2786 +#: documentation/content/en/books/handbook/zfs/_index.adoc:4191 #, no-wrap msgid "Further Resources" msgstr "Дополнительные ресурсы" #. type: Plain text -#: documentation/content/en/books/handbook/zfs/_index.adoc:2789 +#: documentation/content/en/books/handbook/zfs/_index.adoc:4194 +msgid "" +"https://openzfs.github.io/openzfs-docs/[OpenZFS Documentation], including " +"the Performance and Tuning guides" +msgstr "" +"https://openzfs.github.io/openzfs-docs/[Документация OpenZFS], включая " +"руководства по производительности и настройке" + +#. type: Plain text +#: documentation/content/en/books/handbook/zfs/_index.adoc:4195 msgid "https://openzfs.org/[OpenZFS]" msgstr "https://openzfs.org/[OpenZFS]" #. type: Plain text -#: documentation/content/en/books/handbook/zfs/_index.adoc:2790 -msgid "https://wiki.freebsd.org/ZFSTuningGuide[FreeBSD Wiki - ZFS Tuning]" -msgstr "https://wiki.freebsd.org/ZFSTuningGuide[FreeBSD Wiki - Настройка ZFS]" +#: documentation/content/en/books/handbook/zfs/_index.adoc:4196 +msgid "" +"man:zfs[4] describes every kernel tunable, man:zpoolconcepts[7] describes " +"vdev types and pool layout, and man:zfsprops[7] describes every dataset " +"property" +msgstr "" +"man:zfs[4] описывает каждый настраиваемый параметр ядра, man:zpoolconcepts[7]" +" описывает типы vdev и структуру пула, а man:zfsprops[7] описывает каждое " +"свойство набора данных" + +#. type: Plain text +#: documentation/content/en/books/handbook/zfs/_index.adoc:4197 +msgid "Snapshot and replication automation tools from the Ports Collection:" +msgstr "Инструменты автоматизации снимков и репликации из коллекции портов:" + +#. type: Plain text +#: documentation/content/en/books/handbook/zfs/_index.adoc:4198 +msgid "" +"package:filesystems/zrepl[] - a replication daemon supporting push and pull " +"setups, automatic snapshot management, and resumable transfers" +msgstr "" +"package:filesystems/zrepl[] - демон репликации, поддерживающий конфигурации " +"push и pull, автоматическое управление снимками и возобновляемые передачи" + +#. type: Plain text +#: documentation/content/en/books/handbook/zfs/_index.adoc:4199 +msgid "" +"package:sysutils/sanoid[] - policy-driven snapshot management, with the " +"bundled `syncoid` handling replication over SSH" +msgstr "" +"package:sysutils/sanoid[] — управление снимками на основе политик, с " +"входящим в комплект `syncoid` для репликации по SSH" + +#. type: Plain text +#: documentation/content/en/books/handbook/zfs/_index.adoc:4200 +msgid "" +"package:filesystems/zfstools[] - automatic snapshot rotation in the style of " +"the OpenSolaris auto-snapshot service, run from man:cron[8]" +msgstr "" +"package:filesystems/zfstools[] - автоматическая ротация снимков в стиле " +"службы автоматических снимков OpenSolaris, запускаемая из man:cron[8]" #. type: Plain text -#: documentation/content/en/books/handbook/zfs/_index.adoc:2791 +#: documentation/content/en/books/handbook/zfs/_index.adoc:4201 msgid "" -"https://calomel.org/zfs_raid_speed_capacity.html[Calomel Blog - ZFS Raidz " -"Performance, Capacity and Integrity]" +"package:filesystems/zap[] - simple snapshot maintenance and remote " +"replication, configured through ZFS properties instead of a configuration " +"file" msgstr "" -"https://calomel.org/zfs_raid_speed_capacity.html[Calomel Blog - ZFS Raidz " -"Performance, Capacity and Integrity]" +"package:filesystems/zap[] - простое обслуживание снапшотов и удаленная " +"репликация, настраиваемое через свойства ZFS вместо файла конфигурации" #. type: Title == -#: documentation/content/en/books/handbook/zfs/_index.adoc:2793 +#: documentation/content/en/books/handbook/zfs/_index.adoc:4203 #, no-wrap msgid "ZFS Features and Terminology" msgstr "Особенности и терминология ZFS" #. type: Plain text -#: documentation/content/en/books/handbook/zfs/_index.adoc:2802 +#: documentation/content/en/books/handbook/zfs/_index.adoc:4212 msgid "" -"More than a file system, ZFS is fundamentally different. ZFS combines the " -"roles of file system and volume manager, enabling new storage devices to add " -"to a live system and having the new space available on the existing file " -"systems in that pool at once. By combining the traditionally separate " -"roles, ZFS is able to overcome previous limitations that prevented RAID " -"groups being able to grow. A _vdev_ is a top level device in a pool and can " -"be a simple disk or a RAID transformation such as a mirror or RAID-Z array. " -"ZFS file systems (called _datasets_) each have access to the combined free " -"space of the entire pool. Used blocks from the pool decrease the space " -"available to each file system. This approach avoids the common pitfall with " -"extensive partitioning where free space becomes fragmented across the " -"partitions." -msgstr "" -"ZFS — это не просто файловая система, а принципиально иной подход. ZFS " -"объединяет функции файловой системы и менеджера томов, позволяя добавлять " -"новые устройства хранения в работающую систему и сразу же использовать новое " +"ZFS is fundamentally different from traditional file systems. ZFS combines " +"the roles of file system and volume manager, enabling the addition of new " +"storage devices to a live system and making the new space available on the " +"existing file systems in that pool at once. By combining the traditionally " +"separate roles, ZFS overcomes previous limitations that prevented RAID " +"groups from growing. A _vdev_ is a top level device in a pool and can be a " +"simple disk or a RAID transformation such as a mirror or RAID-Z array. ZFS " +"file systems (called _datasets_) each have access to the combined free space " +"of the entire pool. Used blocks from the pool decrease the space available " +"to each file system. This approach avoids the common pitfall with extensive " +"partitioning where free space becomes fragmented across the partitions." +msgstr "" +"ZFS принципиально отличается от традиционных файловых систем. ZFS объединяет " +"функции файловой системы и менеджера томов, позволяя добавлять новые " +"устройства хранения в работающую систему и сразу же использовать новое " "пространство в существующих файловых системах пула. Благодаря объединению " "традиционно разделённых ролей, ZFS преодолевает прежние ограничения, которые " "мешали расширению RAID-групп. Устройство _vdev_ — это устройство верхнего " "уровня в пуле, которое может быть простым диском или RAID-преобразованием, " "таким как зеркало или массив RAID-Z. Файловые системы ZFS (называемые " "_наборами данных_) имеют доступ к объединённому свободному пространству " "всего пула. Используемые блоки из пула уменьшают доступное пространство для " "каждой файловой системы. Такой подход позволяет избежать распространённой " "проблемы с разбиением на разделы, когда свободное пространство " "фрагментируется между разделами." #. type: Table -#: documentation/content/en/books/handbook/zfs/_index.adoc:2808 +#: documentation/content/en/books/handbook/zfs/_index.adoc:4218 #, no-wrap msgid "[[zfs-term-pool]]pool" msgstr "[[zfs-term-pool]]pool" #. type: Table -#: documentation/content/en/books/handbook/zfs/_index.adoc:2811 +#: documentation/content/en/books/handbook/zfs/_index.adoc:4221 #, no-wrap msgid "" "A storage _pool_ is the most basic building block of ZFS. A pool consists of one or more vdevs, the underlying devices that store the data. A pool is then used to create one or more file systems (datasets) or block devices (volumes).\n" -"These datasets and volumes share the pool of remaining free space. Each pool is uniquely identified by a name and a GUID. The ZFS version number on the pool determines the features available." -msgstr "" -"Пул (_pool_) — это базовая строительная единица ZFS. Оно состоит из одного или нескольких vdev — устройств хранения данных. На основе хранилища создаются файловые системы (наборы данных, datasets) или блочные устройства (тома, volumes).\n" -"Эти наборы данных и тома используют общий пул свободного пространства. Каждый пул имеет уникальное имя и GUID. Доступные функции определяются версией ZFS, используемой в пуле." +"These datasets and volumes share the pool of remaining free space. Each pool is uniquely identified by a name and a GUID. Pools created by modern OpenZFS are at pool version 5000; from that version on, individual capabilities are managed by _feature flags_ rather than the version number. See man:zpool-features[7] and crossref:zfs[zfs-zpool-upgrade,Upgrading a Storage Pool] for details." +msgstr "" +"Пул (_pool_) — это базовая строительная единица ZFS. Оно состоит из одного " +"или нескольких vdev — устройств хранения данных. На основе хранилища " +"создаются файловые системы (наборы данных, datasets) или блочные устройства (" +"тома, volumes).\n" +"Эти наборы данных и тома используют общий пул свободного пространства. " +"Каждый пул имеет уникальное имя и GUID. Пулы, созданные современной OpenZFS, " +"имеют версию пула 5000; начиная с этой версии, отдельные возможности " +"управляются с помощью _функциональных флагов_ (feature flags), а не номера " +"версии. Подробнее см. man:zpool-features[7] и crossref:zfs[zfs-zpool-" +"upgrade,«Обновление пула хранения»]." #. type: Table -#: documentation/content/en/books/handbook/zfs/_index.adoc:2812 +#: documentation/content/en/books/handbook/zfs/_index.adoc:4222 #, no-wrap msgid "[[zfs-term-vdev]]vdev Types" msgstr "[[zfs-term-vdev]]vdev Types" #. type: Table -#: documentation/content/en/books/handbook/zfs/_index.adoc:2845 +#: documentation/content/en/books/handbook/zfs/_index.adoc:4256 #, no-wrap msgid "" -"A pool consists of one or more vdevs, which themselves are a single disk or a group of disks, transformed to a RAID. When using a lot of vdevs, ZFS spreads data across the vdevs to increase performance and maximize usable space. All vdevs must be at least 128 MB in size.\n" +"A pool consists of one or more vdevs, which themselves are a single disk or a group of disks, transformed to a RAID. When using a lot of vdevs, ZFS spreads data across the vdevs to increase performance and maximize usable space. All vdevs must be at least 64 MB in size.\n" "\n" -"* [[zfs-term-vdev-disk]] _Disk_ - The most basic vdev type is a standard block device. This can be an entire disk (such as [.filename]#/dev/ada0# or [.filename]#/dev/da0#) or a partition ([.filename]#/dev/ada0p3#). On FreeBSD, there is no performance penalty for using a partition rather than the entire disk. This differs from recommendations made by the Solaris documentation.\n" +"* [[zfs-term-vdev-disk]] _Disk_ - The most basic vdev type is a standard block device. This can be an entire disk (such as [.filename]#/dev/ada0#) or a partition ([.filename]#/dev/ada0p3#). On FreeBSD, there is no performance penalty for using a partition rather than the entire disk. This differs from recommendations made by the Solaris documentation.\n" "+\n" "[CAUTION]\n" "====\n" "Using an entire disk as part of a bootable pool is strongly discouraged, as this may render the pool unbootable.\n" "Likewise, you should not use an entire disk as part of a mirror or RAID-Z vdev.\n" "Reliably determining the size of an unpartitioned disk at boot time is impossible and there's no place to put in boot code.\n" "====\n" "\n" "* [[zfs-term-vdev-file]] _File_ - Regular files may make up ZFS pools, which is useful for testing and experimentation. Use the full path to the file as the device path in `zpool create`.\n" "* [[zfs-term-vdev-mirror]] _Mirror_ - When creating a mirror, specify the `mirror` keyword followed by the list of member devices for the mirror. A mirror consists of two or more devices, writing all data to all member devices. A mirror vdev will hold as much data as its smallest member. A mirror vdev can withstand the failure of all but one of its members without losing any data.\n" "+\n" "[NOTE]\n" "====\n" -"To upgrade a regular single disk vdev to a mirror vdev at any time, use `zpool\n" -"crossref:zfs[zfs-zpool-attach,attach]`.\n" +"To upgrade a regular single disk vdev to a mirror vdev at any time, use `zpool crossref:zfs[zfs-zpool-attach,attach]`.\n" "====\n" "\n" -"* [[zfs-term-vdev-raidz]] _RAID-Z_ - ZFS uses RAID-Z, a variation on standard RAID-5 that offers better distribution of parity and eliminates the \"RAID-5 write hole\" in which the data and parity information become inconsistent after an unexpected restart. ZFS supports three levels of RAID-Z which provide varying levels of redundancy in exchange for decreasing levels of usable storage. ZFS uses RAID-Z1 through RAID-Z3 based on the number of parity devices in the array and the number of disks which can fail before the pool stops being operational.\n" +"* [[zfs-term-vdev-raidz]] _RAID-Z_ - ZFS uses RAID-Z, a variation on standard RAID-5 that offers better distribution of parity and eliminates the \"RAID-5 write hole\" in which the data and parity information become inconsistent after an unexpected restart. ZFS supports three levels of RAID-Z which provide varying levels of redundancy in exchange for decreasing levels of usable storage. ZFS uses RAID-Z1 through RAID-Z3 based on the number of parity devices in the array and the number of disks which can fail before the pool stops being operational.\n" "+\n" "In a RAID-Z1 configuration with four disks, each 1 TB, usable storage is 3 TB and the pool will still be able to operate in degraded mode with one faulted disk. If another disk goes offline before replacing and resilvering the faulted disk would result in losing all pool data.\n" "+\n" -"In a RAID-Z3 configuration with eight disks of 1 TB, the volume will provide 5 TB of usable space and still be able to operate with three faulted disks. Sun(TM) recommends no more than nine disks in a single vdev. If more disks make up the configuration, the recommendation is to divide them into separate vdevs and stripe the pool data across them.\n" +"In a RAID-Z3 configuration with eight disks of 1 TB, the volume will provide 5 TB of usable space and still be able to operate with three faulted disks. The traditional recommendation is no more than nine disks in a single vdev. If more disks make up the configuration, the recommendation is to divide them into separate vdevs and stripe the pool data across them.\n" "+\n" "A configuration of two RAID-Z2 vdevs consisting of 8 disks each would create something like a RAID-60 array. A RAID-Z group's storage capacity is about the size of the smallest disk multiplied by the number of non-parity disks. Four 1 TB disks in RAID-Z1 has an effective size of about 3 TB, and an array of eight 1 TB disks in RAID-Z3 will yield 5 TB of usable space.\n" -"* [[zfs-term-vdev-spare]] _Spare_ - ZFS has a special pseudo-vdev type for keeping track of available hot spares. Note that installed hot spares are not deployed automatically; manually configure them to replace the failed device using `zfs replace`.\n" -"* [[zfs-term-vdev-log]] _Log_ - ZFS Log Devices, also known as ZFS Intent Log\n" -" (crossref:zfs[zfs-term-zil,ZIL]) move the intent log from the regular pool devices to a dedicated device, typically an SSD. Having a dedicated log device improves the performance of applications with a high volume of synchronous writes like databases. Mirroring of log devices is possible, but RAID-Z is not supported. If using a lot of log devices, writes will be load-balanced across them.\n" -"* [[zfs-term-vdev-cache]] _Cache_ - Adding a cache vdev to a pool will add the\n" -" storage of the cache to the crossref:zfs[zfs-term-l2arc,L2ARC]. Mirroring cache devices is impossible. Since a cache device stores only new copies of existing data, there is no risk of data loss." -msgstr "" -"Пул состоит из одного или нескольких vdev, которые, в свою очередь, представляют собой отдельный диск или группу дисков, преобразованных в RAID. При использовании множества vdev ZFS распределяет данные между ними для повышения производительности и максимизации доступного пространства. Все vdev должны быть размером не менее 128 МБ.\n" +"+\n" +"Growing a raidz vdev one disk at a time is possible with crossref:zfs[zfs-zpool-raidz-expansion,RAID-Z expansion], which requires OpenZFS 2.3 or later, first available in FreeBSD 15.0.\n" +"* [[zfs-term-vdev-draid]] _dRAID_ - A variant of RAID-Z that distributes data, parity, and spare capacity across all member disks using fixed-width stripes. Instead of dedicated hot spare disks, dRAID provides _distributed spares_: spare capacity spread over every member disk, allowing a failed disk to rebuild sequentially onto all remaining disks at once and restoring redundancy much faster than a traditional resilver onto a single spare. Specify a dRAID vdev as `draid[parity][:datad][:childrenc][:sparess]`, as described in man:zpoolconcepts[7]. See crossref:zfs[zfs-zpool-draid,dRAID Pools] for details.\n" +"* [[zfs-term-vdev-spare]] _Spare_ - ZFS has a special pseudo-vdev type for keeping track of available hot spares. When man:zfsd[8] is enabled, ZFS deploys installed hot spares automatically to replace failed devices; otherwise, configure them manually to replace the failed device using `zpool replace`. See crossref:zfs[zfs-zpool-spares,Hot Spares and Automatic Replacement with zfsd] for details.\n" +"* [[zfs-term-vdev-log]] _Log_ - Every pool has a ZFS Intent Log (crossref:zfs[zfs-term-zil,ZIL]), stored on the regular pool devices by default. A dedicated log vdev, often called a SLOG, moves the intent log to a separate device, typically an SSD. Having a dedicated log device improves the performance of applications with a high volume of synchronous writes like databases. Mirroring of log devices is possible, but RAID-Z is not supported. If using a lot of log devices, writes will be load-balanced across them. See crossref:zfs[zfs-advanced-zil-slog,\"Synchronous Writes, the ZIL, and SLOG\"] for details.\n" +"* [[zfs-term-vdev-cache]] _Cache_ - Adding a cache vdev to a pool will add the storage of the cache to the crossref:zfs[zfs-term-l2arc,L2ARC]. Mirroring cache devices is impossible. Since a cache device stores only new copies of existing data, there is no risk of data loss.\n" +"* [[zfs-term-vdev-special]] _Special/Dedup_ - Allocation class vdevs that store pool metadata, optionally small file blocks (controlled by the `special_small_blocks` dataset property), and deduplication tables on fast devices such as SSDs, speeding up a pool of slower disks. These vdevs are pool-critical: losing a special or dedup vdev loses the pool, so give them the same level of redundancy as the data vdevs. See crossref:zfs[zfs-zpool-special,Special Allocation Classes] for details." +msgstr "" +"Пул состоит из одного или нескольких vdev, которые, в свою очередь, " +"представляют собой отдельный диск или группу дисков, преобразованных в RAID. " +"При использовании множества vdev ZFS распределяет данные между ними для " +"повышения производительности и максимизации доступного пространства. Все " +"vdev должны быть размером не менее 64 МБ.\n" "\n" -"* [[zfs-term-vdev-disk]] _Диск_ — Самый базовый тип vdev — это стандартное блочное устройство. Это может быть целый диск (например, [.filename]#/dev/ada0# или [.filename]#/dev/da0#) или раздел ([.filename]#/dev/ada0p3#). В FreeBSD нет потери производительности при использовании раздела вместо целого диска. Это отличается от рекомендаций документации Solaris.\n" +"* [[zfs-term-vdev-disk]] _Диск_ — Самый базовый тип vdev — это стандартное " +"блочное устройство. Это может быть целый диск (например, [.filename]#/dev/" +"ada0#) или раздел ([.filename]#/dev/ada0p3#). В FreeBSD нет потери " +"производительности при использовании раздела вместо целого диска. Это " +"отличается от рекомендаций документации Solaris.\n" "+\n" "[CAUTION]\n" "====\n" -"Настоятельно не рекомендуется использовать целый диск в составе загружаемого пула, так как это может сделать пул незагружаемым.\n" -"Аналогично, не следует использовать целый диск в составе зеркала (mirror) или RAID-Z vdev.\n" -"Надежное определение размера неразмеченного диска во время загрузки невозможно, и нет места для размещения загрузочного кода.\n" +"Настоятельно не рекомендуется использовать целый диск в составе загружаемого " +"пула, так как это может сделать пул незагружаемым.\n" +"Аналогично, не следует использовать целый диск в составе зеркала (mirror) " +"или RAID-Z vdev.\n" +"Надежное определение размера неразмеченного диска во время загрузки " +"невозможно, и нет места для размещения загрузочного кода.\n" "====\n" "\n" -"* [[zfs-term-vdev-file]] _Файл_ — Обычные файлы могут составлять пулы ZFS, что полезно для тестирования и экспериментов. Используйте полный путь к файлу в качестве пути к устройству в команде `zpool create`.\n" -"* [[zfs-term-vdev-mirror]] _Зеркало (Mirror)_ - При создании зеркала укажите ключевое слово `mirror`, за которым следует список устройств-участников зеркала. Зеркало состоит из двух или более устройств, и все данные записываются на все устройства-участники. Зеркальный vdev будет хранить столько данных, сколько может поместиться на его самом маленьком устройстве. Зеркальный vdev может пережить отказ всех устройств, кроме одного, без потери данных.\n" +"* [[zfs-term-vdev-file]] _Файл_ — Обычные файлы могут составлять пулы ZFS, " +"что полезно для тестирования и экспериментов. Используйте полный путь к " +"файлу в качестве пути к устройству в команде `zpool create`.\n" +"* [[zfs-term-vdev-mirror]] _Зеркало (Mirror)_ - При создании зеркала укажите " +"ключевое слово `mirror`, за которым следует список устройств-участников " +"зеркала. Зеркало состоит из двух или более устройств, и все данные " +"записываются на все устройства-участники. Зеркальный vdev будет хранить " +"столько данных, сколько может поместиться на его самом маленьком устройстве. " +"Зеркальный vdev может пережить отказ всех устройств, кроме одного, без " +"потери данных.\n" "+\n" "[NOTE]\n" "====\n" -"Чтобы в любой момент обновить обычный vdev с одним диском до зеркального vdev, используйте команду `zpool\n" -"crossref:zfs[zfs-zpool-attach,attach]`.\n" +"Чтобы в любой момент обновить обычный vdev с одним диском до зеркального " +"vdev, используйте команду `zpool crossref:zfs[zfs-zpool-attach,attach]`.\n" "====\n" "\n" -"* [[zfs-term-vdev-raidz]] _RAID-Z_ - ZFS использует RAID-Z — вариацию стандартного RAID-5, которая обеспечивает лучшее распределение чётности и устраняет проблему \"записи дырки RAID-5\", когда данные и информация о чётности становятся несогласованными после неожиданного перезапуска. ZFS поддерживает три уровня RAID-Z, которые обеспечивают разную степень избыточности в обмен на уменьшение доступного пространства. ZFS использует RAID-Z1, RAID-Z2 и RAID-Z3 в зависимости от количества устройств чётности в массиве и количества дисков, которые могут отказать до того, как пул перестанет работать.\n" +"* [[zfs-term-vdev-raidz]] _RAID-Z_ - ZFS использует RAID-Z — вариацию " +"стандартного RAID-5, которая обеспечивает лучшее распределение чётности и " +"устраняет проблему \"записи дырки RAID-5\", когда данные и информация о " +"чётности становятся несогласованными после неожиданного перезапуска. ZFS " +"поддерживает три уровня RAID-Z, которые обеспечивают разную степень " +"избыточности в обмен на уменьшение доступного пространства. ZFS использует " +"RAID-Z1, RAID-Z2 и RAID-Z3 в зависимости от количества устройств чётности в " +"массиве и количества дисков, которые могут отказать до того, как пул " +"перестанет работать.\n" "+\n" -"В конфигурации RAID-Z1 с четырьмя дисками по 1 ТБ доступное пространство составляет 3 ТБ, и пул сможет продолжать работу в деградированном режиме при отказе одного диска. Если другой диск выйдет из строя до замены и восстановления отказавшего диска, это приведет к потере всех данных пула.\n" +"В конфигурации RAID-Z1 с четырьмя дисками по 1 ТБ доступное пространство " +"составляет 3 ТБ, и пул сможет продолжать работу в деградированном режиме при " +"отказе одного диска. Если другой диск выйдет из строя до замены и " +"восстановления отказавшего диска, это приведет к потере всех данных пула.\n" "+\n" -"В конфигурации RAID-Z3 с восемью дисками по 1 ТБ том предоставит 5 ТБ доступного пространства и сможет работать при отказе трёх дисков. Sun(TM) рекомендует использовать не более девяти дисков в одном vdev. Если конфигурация состоит из большего количества дисков, рекомендуется разделить их на отдельные vdev и распределить данные пула между ними.\n" +"В конфигурации RAID-Z3 с восемью дисками по 1 ТБ том предоставит 5 ТБ " +"доступного пространства и сможет работать при отказе трёх дисков. " +"Традиционная рекомендация использовать не более девяти дисков в одном vdev. " +"Если конфигурация состоит из большего количества дисков, рекомендуется " +"разделить их на отдельные vdev и распределить данные пула между ними.\n" "+\n" -"Конфигурация из двух RAID-Z2 vdev, каждый из которых состоит из 8 дисков, создаст аналог массива RAID-60. Емкость RAID-Z группы примерно равна размеру самого маленького диска, умноженному на количество дисков без чётности. Четыре диска по 1 ТБ в RAID-Z1 дают эффективный размер около 3 ТБ, а массив из восьми дисков по 1 ТБ в RAID-Z3 обеспечит 5 ТБ доступного пространства.\n" -"* [[zfs-term-vdev-spare]] _Резервный (Spare)_ - ZFS имеет специальный псевдо-vdev для отслеживания доступных горячих резервов. Обратите внимание, что установленные горячие резервы не развертываются автоматически; их необходимо вручную настроить для замены отказавшего устройства с помощью команды `zfs replace`.\n" -"* [[zfs-term-vdev-log]] _Журнал (Log)_ - Устройства журнала ZFS, также известные как журнал намерений ZFS (Intent Log)\n" -" (crossref:zfs[zfs-term-zil,ZIL]), перемещают журнал намерений с обычных устройств пула на выделенное устройство, обычно SSD. Наличие выделенного устройства журнала улучшает производительность приложений с большим объёмом синхронных записей, таких как базы данных. Возможно зеркалирование устройств журнала, но RAID-Z не поддерживается. При записи на несколько устройств журнала нагрузка будут балансироваться между ними.\n" -"* [[zfs-term-vdev-cache]] _Кэш (Cache)_ - Добавление кэширующих vdev к пулу увеличит\n" -" хранилище кэша в crossref:zfs[zfs-term-l2arc,L2ARC]. Зеркалирование устройств кэша невозможно. Поскольку устройство кэша хранит только новые копии существующих данных, риск потери данных отсутствует." +"Конфигурация из двух RAID-Z2 vdev, каждый из которых состоит из 8 дисков, " +"создаст аналог массива RAID-60. Емкость RAID-Z группы примерно равна размеру " +"самого маленького диска, умноженному на количество дисков без чётности. " +"Четыре диска по 1 ТБ в RAID-Z1 дают эффективный размер около 3 ТБ, а массив " +"из восьми дисков по 1 ТБ в RAID-Z3 обеспечит 5 ТБ доступного пространства.\n" +"+\n" +"Увеличение raidz-виртуального устройства (vdev) по одному диску за раз " +"возможно с помощью crossref:zfs[zfs-zpool-raidz-expansion,расширения RAID-Z]" +", которое требует OpenZFS 2.3 или новее, впервые доступной в FreeBSD 15.0.\n" +"* [[zfs-term-vdev-draid]] _dRAID_ — вариант RAID-Z, который распределяет " +"данные, четность и резервную ёмкость по всем дискам-членам с использованием " +"полос фиксированной ширины. Вместо выделенных горячих запасных дисков dRAID " +"предоставляет _распределённые запасные_: резервную ёмкость, распределённую " +"по каждому диску-члену, что позволяет отказавшему диску восстановиться " +"последовательно на все остальные диски одновременно и восстановить " +"избыточность намного быстрее, чем при традиционном восстановлении на один " +"запасной диск. Задайте dRAID-виртуальное устройство как " +"`draid[parity][:datad][:childrenc][:sparess]`, как описано в " +"man:zpoolconcepts[7]. Подробнее см. crossref:zfs[zfs-zpool-draid,«Пулы " +"dRAID»].\n" +"* [[zfs-term-vdev-spare]] _Резервный (Spare)_ - ZFS имеет специальный псевдо-" +"vdev для отслеживания доступных горячих резервов. Когда man:zfsd[8] включён, " +"ZFS автоматически задействует установленные горячие запасные диски для " +"замены отказавших устройств; в противном случае настройте их вручную для " +"замены отказавшего устройства с помощью `zpool replace`. Подробнее см. " +"crossref:zfs[zfs-zpool-spares,«Горячие запасные диски и автоматическая " +"замена с zfsd»].\n" +"* [[zfs-term-vdev-log]] _Журнал_ — каждый пул имеет журнал намерений ZFS " +"(crossref:zfs[zfs-term-zil,ZIL]), который по умолчанию хранится на обычных " +"устройствах пула. Выделенное журнальное виртуальное устройство (часто " +"называемое SLOG) перемещает журнал намерений на отдельное устройство, обычно " +"SSD. Наличие выделенного журнального устройства повышает производительность " +"приложений с большим объёмом синхронных записей, например баз данных. " +"Зеркалирование журнальных устройств возможно, но RAID-Z не поддерживается. " +"При использовании большого количества журнальных устройств запись " +"распределяется между ними. Подробнее см. crossref:zfs[zfs-advanced-zil-slog," +"\"Синхронные записи, ZIL и SLOG\"].\n" +"* [[zfs-term-vdev-cache]] _Кэш (Cache)_ - Добавление кэширующих vdev к пулу " +"увеличит хранилище кэша в crossref:zfs[zfs-term-l2arc,L2ARC]. Зеркалирование " +"устройств кэша невозможно. Поскольку устройство кэша хранит только новые " +"копии существующих данных, риск потери данных отсутствует.\n" +"* [[zfs-term-vdev-special]] _Специальное/Дедупликационное_ — виртуальные " +"устройства классов распределения, которые хранят метаданные пула, " +"опционально блоки небольших файлов (управляется свойством набора данных " +"`special_small_blocks`) и таблицы дедупликации на быстрых устройствах, таких " +"как SSD, ускоряя пул с более медленными дисками. Эти виртуальные устройства " +"являются критичными для пула: потеря специального или дедупликационного " +"виртуального устройства приводит к потере пула, поэтому обеспечьте им тот же " +"уровень избыточности, что и для виртуальных устройств с данными. Подробнее " +"см. crossref:zfs[zfs-zpool-special,«Классы специального распределения»]." #. type: Table -#: documentation/content/en/books/handbook/zfs/_index.adoc:2846 +#: documentation/content/en/books/handbook/zfs/_index.adoc:4257 #, no-wrap msgid "[[zfs-term-txg]] Transaction Group (TXG)" msgstr "[[zfs-term-txg]] Группы транзакций (TXG)" #. type: Table -#: documentation/content/en/books/handbook/zfs/_index.adoc:2867 +#: documentation/content/en/books/handbook/zfs/_index.adoc:4278 #, no-wrap msgid "" "Transaction Groups are the way ZFS groups blocks changes together and writes them to the pool. Transaction groups are the atomic unit that ZFS uses to ensure consistency. ZFS assigns each transaction group a unique 64-bit consecutive identifier. There can be up to three active transaction groups at a time, one in each of these three states:\n" "\n" "* _Open_ - A new transaction group begins in the open state and accepts new\n" " writes. There is always a transaction group in the open state, but the\n" " transaction group may refuse new writes if it has reached a limit. Once the\n" " open transaction group has reached a limit, or reaching the\n" -" crossref:zfs[zfs-advanced-tuning-txg-timeout,`vfs.zfs.txg.timeout`], the transaction group advances to the next state.\n" +" crossref:zfs[zfs-advanced-tuning,`vfs.zfs.txg.timeout`], the transaction group advances to the next state.\n" "* _Quiescing_ - A short state that allows any pending operations to finish without blocking the creation of a new open transaction group. Once all the transactions in the group have completed, the transaction group advances to the final state.\n" "* _Syncing_ - Write all the data in the transaction group to stable storage.\n" " This process will in turn change other data, such as metadata and space maps,\n" " that ZFS will also write to stable storage. The process of syncing involves\n" " several passes. On the first and biggest, all the changed data blocks; next\n" " come the metadata, which may take several passes to complete. Since allocating\n" " space for the data blocks generates new metadata, the syncing state cannot\n" " finish until a pass completes that does not use any new space. The syncing\n" " state is also where _synctasks_ complete. Synctasks are administrative\n" " operations such as creating or destroying snapshots and datasets that complete\n" " the uberblock change. Once the sync state completes the transaction group in\n" " the quiescing state advances to the syncing state. All administrative\n" " functions, such as crossref:zfs[zfs-term-snapshot,`snapshot`] write as part of the transaction group. ZFS adds a created synctask to the open transaction group, and that group advances as fast as possible to the syncing state to reduce the latency of administrative commands." msgstr "" -"Группы транзакций — это способ, которым ZFS объединяет изменения блоков и записывает их в пул. Группы транзакций являются атомарной единицей, используемой ZFS для обеспечения согласованности. ZFS назначает каждой группе транзакций уникальный 64-битный последовательный идентификатор. Одновременно может быть до трёх активных групп транзакций, каждая в одном из следующих состояний:\n" +"Группы транзакций — это способ, которым ZFS объединяет изменения блоков и " +"записывает их в пул. Группы транзакций являются атомарной единицей, " +"используемой ZFS для обеспечения согласованности. ZFS назначает каждой " +"группе транзакций уникальный 64-битный последовательный идентификатор. " +"Одновременно может быть до трёх активных групп транзакций, каждая в одном из " +"следующих состояний:\n" "\n" -"* _Открытое (Open)_ — Новая группа транзакций начинается в открытом состоянии и\n" +"* _Открытое (Open)_ — Новая группа транзакций начинается в открытом " +"состоянии и\n" "принимает новые операции записи. Всегда существует группа транзакций\n" "в открытом состоянии, но она может отказать в приёме новых записей,\n" "если достигнут лимит. Как только открытая группа транзакций достигает\n" -"лимита или срабатывает crossref:zfs[zfs-advanced-tuning-txg-timeout,`vfs.zfs.txg.timeout`], группа переходит в следующее состояние.\n" -"* _Завершающееся (Quiescing)_ — Краткое состояние, позволяющее завершить все ожидающие операции без блокировки создания новой открытой группы транзакций. Как только все транзакции в группе завершены, группа переходит в финальное состояние.\n" -"* _Синхронизируемое (Syncing)_ — Запись всех данных группы транзакций в устойчивое хранилище. Этот процесс, в свою очередь,\n" -"изменяет другие данные, такие как метаданные и карты пространства, которые ZFS также записывает в устойчивое хранилище.\n" -"Процесс синхронизации включает несколько проходов. На первом и самом большом записываются все изменённые блоки данных;\n" -"затем идут метаданные, которые могут потребовать нескольких проходов. Поскольку выделение пространства для блоков данных\n" -"генерирует новые метаданные, состояние синхронизации не может завершиться, пока не будет выполнен проход,\n" -"не использующий новое пространство. В состоянии синхронизации также завершаются _синхронизационные задачи_.\n" -"Синхронизационные задачи — это административные операции, такие как создание или удаление снимков и наборов данных,\n" -"завершающие изменение uberblock. Как только состояние синхронизации завершается, группа транзакций\n" -"в Завершающемся состоянии переходит в Синхронизируемое. Все административные функции, такие как crossref:zfs[zfs-term-snapshot,`снимок`],\n" -"записываются как часть группы транзакций. ZFS добавляет созданную синхронизационную задачу в открытую группу транзакций,\n" +"лимита или срабатывает crossref:zfs[zfs-advanced-tuning,`vfs.zfs.txg." +"timeout`], группа переходит в следующее состояние.\n" +"* _Завершающееся (Quiescing)_ — Краткое состояние, позволяющее завершить все " +"ожидающие операции без блокировки создания новой открытой группы транзакций. " +"Как только все транзакции в группе завершены, группа переходит в финальное " +"состояние.\n" +"* _Синхронизируемое (Syncing)_ — Запись всех данных группы транзакций в " +"устойчивое хранилище. Этот процесс, в свою очередь,\n" +"изменяет другие данные, такие как метаданные и карты пространства, которые " +"ZFS также записывает в устойчивое хранилище.\n" +"Процесс синхронизации включает несколько проходов. На первом и самом большом " +"записываются все изменённые блоки данных;\n" +"затем идут метаданные, которые могут потребовать нескольких проходов. " +"Поскольку выделение пространства для блоков данных\n" +"генерирует новые метаданные, состояние синхронизации не может завершиться, " +"пока не будет выполнен проход,\n" +"не использующий новое пространство. В состоянии синхронизации также " +"завершаются _синхронизационные задачи_.\n" +"Синхронизационные задачи — это административные операции, такие как создание " +"или удаление снимков и наборов данных,\n" +"завершающие изменение uberblock. Как только состояние синхронизации " +"завершается, группа транзакций\n" +"в Завершающемся состоянии переходит в Синхронизируемое. Все административные " +"функции, такие как crossref:zfs[zfs-term-snapshot,`снимок`],\n" +"записываются как часть группы транзакций. ZFS добавляет созданную " +"синхронизационную задачу в открытую группу транзакций,\n" "и эта группа как можно быстрее переходит в синхронизируемое состояние,\n" "чтобы уменьшить задержку административных команд." #. type: Table -#: documentation/content/en/books/handbook/zfs/_index.adoc:2868 +#: documentation/content/en/books/handbook/zfs/_index.adoc:4279 #, no-wrap msgid "[[zfs-term-arc]]Adaptive Replacement Cache (ARC)" msgstr "[[zfs-term-arc]]Adaptive Replacement Cache (ARC)" #. type: Table -#: documentation/content/en/books/handbook/zfs/_index.adoc:2870 +#: documentation/content/en/books/handbook/zfs/_index.adoc:4281 #, no-wrap msgid "ZFS uses an Adaptive Replacement Cache (ARC), rather than a more traditional Least Recently Used (LRU) cache. An LRU cache is a simple list of items in the cache, sorted by how recently object was used, adding new items to the head of the list. When the cache is full, evicting items from the tail of the list makes room for more active objects. An ARC consists of four lists; the Most Recently Used (MRU) and Most Frequently Used (MFU) objects, plus a ghost list for each. These ghost lists track evicted objects to prevent adding them back to the cache. This increases the cache hit ratio by avoiding objects that have a history of occasional use. Another advantage of using both an MRU and MFU is that scanning an entire file system would evict all data from an MRU or LRU cache in favor of this freshly accessed content. With ZFS, there is also an MFU that tracks the most frequently used objects, and the cache of the most commonly accessed blocks remains." msgstr "ZFS использует Adaptive Replacement Cache (ARC), а не более традиционный кэш Least Recently Used (LRU). LRU-кэш — это простой список элементов в кэше, отсортированный по времени последнего использования объекта, при этом новые элементы добавляются в начало списка. Когда кэш заполнен, освобождение места для более активных объектов происходит за счёт удаления элементов из конца списка. ARC состоит из четырёх списков: Most Recently Used (MRU) и Most Frequently Used (MFU), а также дополнительных \"теневых\" списков для каждого из них. Эти теневые списки отслеживают удалённые объекты, чтобы предотвратить их повторное добавление в кэш. Это увеличивает процент попаданий в кэш, исключая объекты, которые использовались лишь изредка. Ещё одно преимущество использования как MRU, так и MFU заключается в том, что сканирование всей файловой системы вытеснило бы все данные из MRU- или LRU-кэша в пользу только что прочитанного содержимого. В ZFS также присутствует MFU, который отслеживает наиболее часто используемые объекты, и кэш наиболее часто запрашиваемых блоков остаётся неизменным." #. type: Table -#: documentation/content/en/books/handbook/zfs/_index.adoc:2871 +#: documentation/content/en/books/handbook/zfs/_index.adoc:4282 #, no-wrap msgid "[[zfs-term-l2arc]]L2ARC" msgstr "[[zfs-term-l2arc]]L2ARC" #. type: Table -#: documentation/content/en/books/handbook/zfs/_index.adoc:2889 +#: documentation/content/en/books/handbook/zfs/_index.adoc:4298 #, no-wrap msgid "" "L2ARC is the second level of the ZFS caching system. RAM stores the primary\n" "ARC. Since the amount of available RAM is often limited, ZFS can also use\n" "crossref:zfs[zfs-term-vdev-cache,cache vdevs]. Solid State Disks (SSDs) are\n" "often used as these cache devices due to their higher speed and lower latency\n" "compared to traditional spinning disks. L2ARC is entirely optional, but having\n" "one will increase read speeds for cached files on the SSD instead of having to\n" "read from the regular disks. L2ARC can also speed up\n" "crossref:zfs[zfs-term-deduplication,deduplication] because a deduplication table\n" "(DDT) that does not fit in RAM but does fit in the L2ARC will be much faster\n" -"than a DDT that must read from disk. Limits on the data rate added to the cache\n" -"devices prevents prematurely wearing out SSDs with extra writes. Until the cache\n" -"is full (the first block evicted to make room), writes to the L2ARC limit to the\n" -"sum of the write limit and the boost limit, and afterwards limit to the write\n" -"limit. A pair of man:sysctl[8] values control these rate limits.\n" -"crossref:zfs[zfs-advanced-tuning-l2arc_write_max,`vfs.zfs.l2arc_write_max`]\n" -"controls the number of bytes written to the cache per second, while\n" -"crossref:zfs[zfs-advanced-tuning-l2arc_write_boost,`vfs.zfs.l2arc_write_boost`] adds to this limit during the \"Turbo Warmup Phase\" (Write Boost)." -msgstr "" -"L2ARC — это второй уровень системы кэширования ZFS. Основной кэш (ARC) хранится в оперативной памяти.\n" -"Поскольку объём доступной оперативной памяти часто ограничен, ZFS также может использовать\n" +"than a DDT that must read from disk.\n" +"Since OpenZFS 2.0, the L2ARC is persistent: after a reboot, ZFS rebuilds the cache contents from the headers stored on the cache device instead of starting with an empty cache.\n" +"Limits on the data rate added to the cache devices prevent prematurely wearing out SSDs with extra writes.\n" +"Until the cache is full (the first block evicted to make room), writes to the L2ARC limit to the sum of the write limit and the boost limit, and afterwards limit to the write limit.\n" +"A pair of man:sysctl[8] values control these rate limits: `vfs.zfs.l2arc.write_max` controls the number of bytes written to the cache per second, while `vfs.zfs.l2arc.write_boost` adds to this limit until the first eviction from the cache.\n" +"See crossref:zfs[zfs-advanced-tuning,Tuning] for details." +msgstr "" +"L2ARC — это второй уровень системы кэширования ZFS. Основной кэш (ARC) " +"хранится в оперативной памяти.\n" +"Поскольку объём доступной оперативной памяти часто ограничен, ZFS также " +"может использовать\n" "crossref:zfs[zfs-term-vdev-cache,кэширующие vdev].\n" "Твердотельные накопители (SSD) часто используются в качестве\n" -"таких кэширующих устройств благодаря их более высокой скорости и меньшей задержке по сравнению\n" -"с традиционными жёсткими дисками. L2ARC полностью опционален, но его наличие увеличит скорость чтения\n" -"для кэшированных файлов на SSD, избавляя от необходимости читать с обычных дисков.\n" -"L2ARC также может ускорить crossref:zfs[zfs-term-deduplication,дедупликацию], поскольку таблица дедупликации (DDT),\n" -"которая не помещается в оперативную память, но помещается в L2ARC, будет работать значительно быстрее,\n" -"чем DDT, которую должны считать с диска. Ограничения на скорость записи данных\n" -"на кэширующие устройства предотвращают преждевременный износ SSD\n" -"из-за дополнительных операций записи. Пока кэш не заполнен (первый блок вытеснен для освобождения места),\n" -"записи в L2ARC ограничиваются суммой лимита записи и лимита ускорения,\n" -"а после - только лимитом записи. Пара значений man:sysctl[8] управляет этими ограничениями скорости.\n" -"crossref:zfs[zfs-advanced-tuning-l2arc_write_max,`vfs.zfs.l2arc_write_max`] контролирует количество байт,\n" -"записываемых в кэш в секунду, а crossref:zfs[zfs-advanced-tuning-l2arc_write_boost,`vfs.zfs.l2arc_write_boost`]\n" -"добавляется к этому лимиту во время \"Фазы турбо-разогрева\" (Write Boost)." +"таких кэширующих устройств благодаря их более высокой скорости и меньшей " +"задержке по сравнению\n" +"с традиционными жёсткими дисками.\n" +"L2ARC полностью опционален, но его наличие увеличит скорость чтения\n" +"для кэшированных файлов на SSD, избавляя от необходимости читать с обычных " +"дисков.\n" +"L2ARC также может ускорить crossref:zfs[zfs-term-deduplication,дедупликацию]" +", поскольку таблица дедупликации (DDT - deduplication table),\n" +"которая не помещается в оперативную память, но помещается в L2ARC, будет " +"работать значительно быстрее,\n" +"чем DDT, которую должны считать с диска.\n" +"Начиная с OpenZFS 2.0, L2ARC является постоянным: после перезагрузки ZFS " +"восстанавливает содержимое кэша из заголовков, хранящихся на кэширующем " +"устройстве, вместо того чтобы начинать с пустого кэша.\n" +"Ограничения на скорость записи данных\n" +"на кэширующие устройства предотвращают преждевременный износ SSD из-за " +"дополнительных операций записи. Пока кэш не заполнен (первый блок вытеснен " +"для освобождения места),\n" +"записи в L2ARC ограничиваются суммой лимита записи и лимита ускорения, а " +"после - только лимитом записи.\n" +"Пара значений man:sysctl[8] управляет этими ограничениями скорости. `vfs.zfs." +"l2arc.write_max` контролирует количество байт, записываемых в кэш в " +"секунду,а `vfs.zfs.l2arc.write_boost` добавляется к этому лимиту до первого " +"вытеснения из кэша. Подробнее смотрите раздел crossref:zfs[zfs-advanced-" +"tuning,Настройка]." #. type: Table -#: documentation/content/en/books/handbook/zfs/_index.adoc:2890 +#: documentation/content/en/books/handbook/zfs/_index.adoc:4299 #, no-wrap msgid "[[zfs-term-zil]]ZIL" msgstr "[[zfs-term-zil]]ZIL" #. type: Table -#: documentation/content/en/books/handbook/zfs/_index.adoc:2892 -#, no-wrap -msgid "ZIL accelerates synchronous transactions by using storage devices like SSDs that are faster than those used in the main storage pool. When an application requests a synchronous write (a guarantee that the data is stored to disk rather than merely cached for later writes), writing the data to the faster ZIL storage then later flushing it out to the regular disks greatly reduces latency and improves performance. Synchronous workloads like databases will profit from a ZIL alone. Regular asynchronous writes such as copying files will not use the ZIL at all." -msgstr "ZIL ускоряет синхронные транзакции, используя устройства хранения, такие как SSD, которые быстрее, чем устройства в основном пуле хранения. Когда приложение запрашивает синхронную запись (гарантию того, что данные записаны на диск, а не просто кэшированы для последующей записи), запись данных в более быстрый ZIL с последующей выгрузкой на обычные диски значительно снижает задержки и повышает производительность. Синхронные нагрузки, такие как базы данных, выиграют от использования одного только ZIL. Обычные асинхронные операции записи, например, копирование файлов, вообще не используют ZIL." +#: documentation/content/en/books/handbook/zfs/_index.adoc:4301 +#, no-wrap +msgid "The ZFS Intent Log (ZIL) is the on-disk record that ZFS uses to replay synchronous writes after a crash. Every pool has a ZIL; by default it occupies a small amount of space on the regular pool devices. When an application requests a synchronous write (a guarantee that the data is stored to disk rather than merely cached for later writes), ZFS commits the data to the ZIL first and flushes it out to the regular storage with the next transaction group. Moving the ZIL to a dedicated crossref:zfs[zfs-term-vdev-log,log vdev] (SLOG) on a device faster than the main storage, such as an SSD, greatly reduces latency and improves performance. Synchronous workloads like databases will profit from a fast ZIL alone. Regular asynchronous writes such as copying files will not use the ZIL at all. See crossref:zfs[zfs-advanced-zil-slog,\"Synchronous Writes, the ZIL, and SLOG\"] for details." +msgstr "" +"Журнал намерений ZFS (ZIL) — это запись на диске, которую ZFS использует для " +"воспроизведения синхронных записей после сбоя. Каждый пул имеет ZIL; по " +"умолчанию он занимает небольшой объём пространства на обычных устройствах " +"пула. Когда приложение запрашивает синхронную запись (гарантию того, что " +"данные сохранены на диске, а не просто закэшированы для последующей записи), " +"ZFS сначала фиксирует данные в ZIL, а затем сбрасывает их в обычное " +"хранилище со следующей группой транзакций. Перемещение ZIL на выделенное " +"crossref:zfs[zfs-term-vdev-log,журнальное виртуальное устройство] (SLOG) на " +"устройстве, более быстром, чем основное хранилище, например SSD, значительно " +"снижает задержку и повышает производительность. Синхронные рабочие нагрузки, " +"такие как базы данных, выиграют от одного только быстрого ZIL. Обычные " +"асинхронные записи, например копирование файлов, вообще не используют ZIL. " +"Подробнее см. crossref:zfs[zfs-advanced-zil-slog,\"Синхронные записи, ZIL и " +"SLOG\"]." #. type: Table -#: documentation/content/en/books/handbook/zfs/_index.adoc:2893 +#: documentation/content/en/books/handbook/zfs/_index.adoc:4302 #, no-wrap msgid "[[zfs-term-cow]]Copy-On-Write" msgstr "[[zfs-term-cow]]Копирование при Записи (Copy-On-Write)" #. type: Table -#: documentation/content/en/books/handbook/zfs/_index.adoc:2895 +#: documentation/content/en/books/handbook/zfs/_index.adoc:4304 #, no-wrap msgid "Unlike a traditional file system, ZFS writes a different block rather than overwriting the old data in place. When completing this write the metadata updates to point to the new location. When a shorn write (a system crash or power loss in the middle of writing a file) occurs, the entire original contents of the file are still available and ZFS discards the incomplete write. This also means that ZFS does not require a man:fsck[8] after an unexpected shutdown." msgstr "В отличие от традиционной файловой системы, ZFS записывает новый блок вместо перезаписи старых данных на том же месте. После завершения записи метаданные обновляются, указывая на новое местоположение. Если происходит обрыв записи (сбой системы или отключение питания во время записи файла), исходное содержимое файла остаётся доступным, а ZFS отменяет незавершённую запись. Это также означает, что ZFS не требует выполнения man:fsck[8] после неожиданного выключения." #. type: Table -#: documentation/content/en/books/handbook/zfs/_index.adoc:2896 +#: documentation/content/en/books/handbook/zfs/_index.adoc:4305 #, no-wrap msgid "[[zfs-term-dataset]]Dataset" msgstr "[[zfs-term-dataset]]Набор данных (Dataset)" #. type: Table -#: documentation/content/en/books/handbook/zfs/_index.adoc:2906 +#: documentation/content/en/books/handbook/zfs/_index.adoc:4315 #, no-wrap msgid "" "_Dataset_ is the generic term for a ZFS file system, volume, snapshot or clone.\n" "Each dataset has a unique name in the format _poolname/path@snapshot_. The root\n" "of the pool is a dataset as well. Child datasets have hierarchical names like\n" "directories. For example, _mypool/home_, the home dataset, is a child of\n" "_mypool_ and inherits properties from it. Expand this further by creating\n" "_mypool/home/user_. This grandchild dataset will inherit properties from the\n" "parent and grandparent. Set properties on a child to override the defaults\n" "inherited from the parent and grandparent. Administration of datasets and their\n" "children can be crossref:zfs[zfs-zfs-allow,delegated]." msgstr "" "_Набор данных_ — это общий термин для файловой системы ZFS, тома, снимка или клона.\n" "Каждый набор данных имеет уникальное имя в формате _имяпула/путь@снимок_.\n" "Корень пула также является набором данных. Дочерние наборы данных имеют иерархические имена, подобные каталогам.\n" "Например, _mypool/home_, набор данных home, является дочерним для _mypool_ и наследует его свойства.\n" "Это можно расширить, создав _mypool/home/user_. Этот внучатый набор данных будет\n" "наследовать свойства от родительского и вышестоящего наборов данных.\n" "Установка свойств для дочернего набора данных позволяет переопределить значения\n" "по умолчанию, унаследованные от родительских наборов.\n" "Управление наборами данных и их дочерними элементами может быть crossref:zfs[zfs-zfs-allow,делегировано]." #. type: Table -#: documentation/content/en/books/handbook/zfs/_index.adoc:2907 +#: documentation/content/en/books/handbook/zfs/_index.adoc:4316 #, no-wrap msgid "[[zfs-term-filesystem]]File system" msgstr "[[zfs-term-filesystem]]Файловая система" #. type: Table -#: documentation/content/en/books/handbook/zfs/_index.adoc:2909 +#: documentation/content/en/books/handbook/zfs/_index.adoc:4318 #, no-wrap msgid "A ZFS dataset is most often used as a file system. Like most other file systems, a ZFS file system mounts somewhere in the systems directory hierarchy and contains files and directories of its own with permissions, flags, and other metadata." msgstr "Набор данных ZFS чаще всего используется как файловая система. Как и большинство других файловых систем, файловая система ZFS монтируется в определённое место иерархии каталогов системы и содержит собственные файлы и каталоги с правами доступа, флагами и другими метаданными." #. type: Table -#: documentation/content/en/books/handbook/zfs/_index.adoc:2910 +#: documentation/content/en/books/handbook/zfs/_index.adoc:4319 #, no-wrap msgid "[[zfs-term-volume]]Volume" msgstr "[[zfs-term-volume]]Том" #. type: Table -#: documentation/content/en/books/handbook/zfs/_index.adoc:2912 +#: documentation/content/en/books/handbook/zfs/_index.adoc:4321 #, no-wrap msgid "ZFS can also create volumes, which appear as disk devices. Volumes have a lot of the same features as datasets, including copy-on-write, snapshots, clones, and checksumming. Volumes can be useful for running other file system formats on top of ZFS, such as UFS virtualization, or exporting iSCSI extents." msgstr "ZFS также может создавать тома, которые отображаются как дисковые устройства. Тома обладают многими функциями, аналогичными наборам данных, включая копирование при записи, снимки, клоны и контрольные суммы. Тома могут быть полезны для работы других файловых систем поверх ZFS, таких как виртуализация UFS или экспорт областей iSCSI." #. type: Table -#: documentation/content/en/books/handbook/zfs/_index.adoc:2913 +#: documentation/content/en/books/handbook/zfs/_index.adoc:4322 #, no-wrap msgid "[[zfs-term-snapshot]]Snapshot" msgstr "[[zfs-term-snapshot]]Снимок (Snapshot)" #. type: Table -#: documentation/content/en/books/handbook/zfs/_index.adoc:2933 +#: documentation/content/en/books/handbook/zfs/_index.adoc:4342 #, no-wrap msgid "" "The crossref:zfs[zfs-term-cow,copy-on-write] (COW) design of ZFS allows for\n" "nearly instantaneous, consistent snapshots with arbitrary names. After taking a\n" "snapshot of a dataset, or a recursive snapshot of a parent dataset that will\n" "include all child datasets, new data goes to new blocks, but without reclaiming\n" "the old blocks as free space. The snapshot contains the original file system\n" "version and the live file system contains any changes made since taking the\n" "snapshot using no other space. New data written to the live file system uses new\n" "blocks to store this data. The snapshot will grow as the blocks are no longer\n" -"used in the live file system, but in the snapshot alone. Mount these snapshots\n" -"read-only allows recovering of previous file versions. A\n" -"crossref:zfs[zfs-zfs-snapshot,rollback] of a live file system to a specific\n" +"used in the live file system, but in the snapshot alone. Mounting these snapshots\n" +"read-only allows recovering previous file versions. A\n" +"crossref:zfs[zfs-zfs-snapshot-rollback,rollback] of a live file system to a specific\n" "snapshot is possible, undoing any changes that took place after taking the\n" "snapshot. Each block in the pool has a reference counter which keeps track of\n" "the snapshots, clones, datasets, or volumes use that block. As files and\n" -"snapshots get deleted, the reference count decreases, reclaiming the free space\n" +"snapshots get deleted, the reference count decreases, reclaiming the free space\n" "when no longer referencing a block. Marking snapshots with a\n" -"crossref:zfs[zfs-zfs-snapshot,hold] results in any attempt to destroy it will\n" +"crossref:zfs[zfs-zfs-snapshot-hold,hold] means any attempt to destroy it\n" "returns an `EBUSY` error. Each snapshot can have holds with a unique name each.\n" -"The crossref:zfs[zfs-zfs-snapshot,release] command removes the hold so the snapshot can deleted. Snapshots, cloning, and rolling back works on volumes, but independently mounting does not." +"The crossref:zfs[zfs-zfs-snapshot-hold,release] command removes the hold so the snapshot can be deleted. Snapshots, cloning, and rolling back works on volumes, but independently mounting does not." msgstr "" -"Дизайн crossref:zfs[zfs-term-cow,copy-on-write] (COW) в ZFS позволяет создавать\n" -"почти мгновенные, согласованные снимки с произвольными именами. После создания\n" +"Дизайн crossref:zfs[zfs-term-cow,copy-on-write] (COW) в ZFS позволяет " +"создавать\n" +"почти мгновенные, согласованные снимки с произвольными именами. После " +"создания\n" "снимка набора данных или рекурсивного снимка родительского набора, который\n" -"включит все дочерние наборы, новые данные записываются в новые блоки, но без\n" -"освобождения старых блоков как свободного пространства. Снимок содержит исходную\n" -"версию файловой системы, а активная файловая система — все изменения, сделанные\n" -"после создания снимка, не используя дополнительного пространства. Новые данные,\n" -"записанные в активную файловую систему, сохраняются в новых блоках. Снимок будет\n" -"расти по мере того, как блоки перестают использоваться в активной файловой системе\n" -"и остаются только в снимке. Монтирование этих снимков в режиме только для чтения\n" +"включит все дочерние наборы, новые данные записываются в новые блоки, но " +"без\n" +"освобождения старых блоков как свободного пространства. Снимок содержит " +"исходную\n" +"версию файловой системы, а активная файловая система — все изменения, " +"сделанные\n" +"после создания снимка, не используя дополнительного пространства. Новые " +"данные,\n" +"записанные в активную файловую систему, сохраняются в новых блоках. Снимок " +"будет\n" +"расти по мере того, как блоки перестают использоваться в активной файловой " +"системе\n" +"и остаются только в снимке. Монтирование этих снимков в режиме только для " +"чтения\n" "позволяет восстановить предыдущие версии файлов. \n" -"crossref:zfs[zfs-zfs-snapshot,Откат] активной файловой системы к определённому\n" +"crossref:zfs[zfs-zfs-snapshot-rollback,Откат] активной файловой системы к " +"определённому\n" "снимку возможен, отменяя все изменения, произошедшие после создания снимка.\n" "\n" -"Каждый блок в пуле имеет счетчик ссылок, который отслеживает использование этого\n" -"блока снимками, клонами, наборами данных или томами. По мере удаления файлов и\n" -"снимков счетчик ссылок уменьшается, освобождая пространство, когда блок больше\n" +"Каждый блок в пуле имеет счетчик ссылок, который отслеживает использование " +"этого\n" +"блока снимками, клонами, наборами данных или томами. По мере удаления файлов " +"и\n" +"снимков счетчик ссылок уменьшается, освобождая пространство, когда блок " +"больше\n" "не используется. Если пометить снимки с помощью \n" -"crossref:zfs[zfs-zfs-snapshot,удержания (hold)], то это приведет к тому, что любая попытка удалить его вернет ошибку `EBUSY`. Каждый снимок может иметь удержания с уникальными именами. Команда crossref:zfs[zfs-zfs-snapshot,release] удаляет удержание, позволяя удалить снимок. Снимки, клонирование и откат работают с томами, но независимое монтирование — нет." +"crossref:zfs[zfs-zfs-snapshot-hold,удержания (hold)], то это приведет к " +"тому, что любая попытка удалить его вернет ошибку `EBUSY`. Каждый снимок " +"может иметь удержания с уникальными именами. Команда crossref:zfs[zfs-zfs-" +"snapshot-hold,release] удаляет удержание, позволяя удалить снимок. Снимки, " +"клонирование и откат работают с томами, но независимое монтирование — нет." #. type: Table -#: documentation/content/en/books/handbook/zfs/_index.adoc:2934 +#: documentation/content/en/books/handbook/zfs/_index.adoc:4343 #, no-wrap msgid "[[zfs-term-clone]]Clone" msgstr "[[zfs-term-clone]]Клон (Clone)" #. type: Table -#: documentation/content/en/books/handbook/zfs/_index.adoc:2936 +#: documentation/content/en/books/handbook/zfs/_index.adoc:4345 #, no-wrap msgid "Cloning a snapshot is also possible. A clone is a writable version of a snapshot, allowing the file system to fork as a new dataset. As with a snapshot, a clone initially consumes no new space. As new data written to a clone uses new blocks, the size of the clone grows. When blocks are overwritten in the cloned file system or volume, the reference count on the previous block decreases. Removing the snapshot upon which a clone bases is impossible because the clone depends on it. The snapshot is the parent, and the clone is the child. Clones can be _promoted_, reversing this dependency and making the clone the parent and the previous parent the child. This operation requires no new space. Since the amount of space used by the parent and child reverses, it may affect existing quotas and reservations." msgstr "Также возможно клонирование снимка. Клон — это доступная для записи версия снимка, позволяющая файловой системе разветвляться как новый набор данных. Как и снимок, клон изначально не занимает дополнительного пространства. По мере записи новых данных в клон используются новые блоки, и размер клона увеличивается. При перезаписи блоков в клонированной файловой системе или томе счетчик ссылок на предыдущий блок уменьшается. Удалить снимок, на котором основан клон, невозможно, потому что клон зависит от него. Снимок является родителем, а клон — потомком. Клоны можно _повышать_, меняя эту зависимость местами, делая клон родителем, а предыдущего родителя — потомком. Эта операция не требует дополнительного пространства. Поскольку объём пространства, используемого родителем и потомком, меняется местами, это может повлиять на существующие квоты и резервирования." #. type: Table -#: documentation/content/en/books/handbook/zfs/_index.adoc:2937 +#: documentation/content/en/books/handbook/zfs/_index.adoc:4346 +#, no-wrap +msgid "[[zfs-term-bookmark]]Bookmark" +msgstr "[[zfs-term-bookmark]]Bookmark" + +#. type: Table +#: documentation/content/en/books/handbook/zfs/_index.adoc:4351 +#, no-wrap +msgid "" +"A bookmark records the point in time at which a snapshot was taken, without keeping any of the snapshot data.\n" +"Bookmarks serve as the source of incremental crossref:zfs[zfs-zfs-send,`zfs send`] streams, making it possible to destroy the snapshot on the sending side while retaining the ability to send further increments.\n" +"Create a bookmark from an existing snapshot with `zfs bookmark`.\n" +"See crossref:zfs[zfs-zfs-bookmark,Bookmarks] for details." +msgstr "" +"Закладка фиксирует момент времени, в который был сделан снапшот, не сохраняя " +"при этом никаких данных снапшота.\n" +"Закладки служат источником инкрементальных потоков crossref:zfs[zfs-zfs-" +"send,`zfs send`], что позволяет уничтожить снапшот на отправляющей стороне, " +"сохраняя возможность отправлять дальнейшие инкременты.\n" +"Создайте закладку из существующего снапшота с помощью `zfs bookmark`.\n" +"Подробности см. в crossref:zfs[zfs-zfs-bookmark,Закладки]." + +#. type: Table +#: documentation/content/en/books/handbook/zfs/_index.adoc:4352 +#, no-wrap +msgid "[[zfs-term-hold]]Hold" +msgstr "[[zfs-term-hold]]Hold" + +#. type: Table +#: documentation/content/en/books/handbook/zfs/_index.adoc:4357 +#, no-wrap +msgid "" +"A hold is a named tag placed on a snapshot that prevents its destruction.\n" +"Attempts to destroy a held snapshot fail with an `EBUSY` error until releasing every hold with `zfs release`.\n" +"Holds protect snapshots that backup and replication tools still depend on.\n" +"See crossref:zfs[zfs-zfs-snapshot-hold,Snapshot Holds] for details." +msgstr "" +"Удержание — это именованная метка, помещаемая на снимок, которая " +"предотвращает его уничтожение.\n" +"Попытки уничтожить удерживаемый снимок завершаются с ошибкой `EBUSY`, пока " +"не будут сняты все удержания с помощью `zfs release`.\n" +"Удержания защищают снимки, от которых всё ещё зависят инструменты резервного " +"копирования и репликации.\n" +"Подробнее см. crossref:zfs[zfs-zfs-snapshot-hold,Удержания снимков]." + +#. type: Table +#: documentation/content/en/books/handbook/zfs/_index.adoc:4358 #, no-wrap msgid "[[zfs-term-checksum]]Checksum" msgstr "[[zfs-term-checksum]]Контрольная сумма" #. type: Table -#: documentation/content/en/books/handbook/zfs/_index.adoc:2949 +#: documentation/content/en/books/handbook/zfs/_index.adoc:4377 #, no-wrap msgid "" "Every block is also checksummed. The checksum algorithm used is a per-dataset\n" "property, see crossref:zfs[zfs-zfs-set,`set`]. The checksum of each block is\n" "transparently validated when read, allowing ZFS to detect silent corruption. If\n" "the data read does not match the expected checksum, ZFS will attempt to recover\n" -"the data from any available redundancy, like mirrors or RAID-Z. Triggering a\n" +"the data from any available redundancy, like mirrors or RAID-Z. Trigger a\n" "validation of all checksums with crossref:zfs[zfs-term-scrub,`scrub`]. Checksum algorithms include:\n" "\n" "* `fletcher2`\n" "* `fletcher4`\n" "* `sha256`\n" -" The `fletcher` algorithms are faster, but `sha256` is a strong cryptographic hash and has a much lower chance of collisions at the cost of some performance. Deactivating checksums is possible, but strongly discouraged." -msgstr "" -"Каждый блок также имеет контрольную сумму. Используемый алгоритм контрольной суммы\n" -"является свойством для каждого набора данных, см. crossref:zfs[zfs-zfs-set,`set`].\n" -"Контрольная сумма каждого блока прозрачно проверяется при чтении,\n" -"что позволяет ZFS обнаруживать скрытые повреждения. Если прочитанные данные не соответствуют ожидаемой контрольной сумме, ZFS попытается восстановить данные из любого доступного резервирования, например,\n" -"зеркал или RAID-Z. Запуск проверки всех контрольных сумм выполняется с помощью crossref:zfs[zfs-term-scrub,`scrub`]. Доступные алгоритмы контрольных сумм включают:\n" +"* `sha512`\n" +"* `skein`\n" +"* `edonr`\n" +"* `blake3` (since FreeBSD 14.0)\n" "\n" +"The `fletcher` algorithms are faster, but the cryptographic hashes (`sha256`, `sha512`, `skein`, `edonr`, and `blake3`) have a much lower chance of collisions at the cost of some performance.\n" +"The default value of `on` currently selects `fletcher4`; crossref:zfs[zfs-term-deduplication,deduplication] requires a cryptographic hash such as `sha256`.\n" +"Deactivating checksums is possible, but strongly discouraged." +msgstr "" +"Каждый блок также имеет контрольную сумму. Используемый алгоритм контрольной " +"суммы\n" +"является свойством для каждого набора данных, см. crossref:zfs[zfs-zfs-" +"set,`set`].\n" +"Контрольная сумма каждого блока прозрачно проверяется при чтении,\n" +"что позволяет ZFS обнаруживать скрытые повреждения. Если прочитанные данные " +"не соответствуют\n" +"ожидаемой контрольной сумме, ZFS попытается восстановить данные из любого " +"доступного резервирования, например,\n" +"зеркал или RAID-Z. Запуск проверки всех контрольных сумм выполняется с " +"помощью crossref:zfs[zfs-term-scrub,`scrub`].\n" +"Доступные алгоритмы контрольных сумм включают:\n" "* `fletcher2`\n" "* `fletcher4`\n" "* `sha256`\n" +"* `sha512`\n" +"* `skein`\n" +"* `edonr`\n" +"* `blake3` (since FreeBSD 14.0)\n" "\n" -"Алгоритмы `fletcher` работают быстрее, но `sha256` является криптографически стойким хешем и имеет гораздо меньшую вероятность коллизий ценой некоторого снижения производительности. Возможно отключение контрольных сумм, но это крайне не рекомендуется." +"Алгоритмы `fletcher` работают быстрее, но криптографические хеши (`sha256`, " +"`sha512`, `skein`, `edonr` и `blake3`) имеют значительно меньшую вероятность " +"коллизий ценой некоторого снижения производительности.\n" +"Значение по умолчанию `on` в настоящее время выбирает `fletcher4`; " +"crossref:zfs[zfs-term-deduplication,дедупликация] требует криптографического " +"хеша, например `sha256`.\n" +"Возможно отключение контрольных сумм, но это крайне не рекомендуется." #. type: Table -#: documentation/content/en/books/handbook/zfs/_index.adoc:2950 +#: documentation/content/en/books/handbook/zfs/_index.adoc:4378 #, no-wrap msgid "[[zfs-term-compression]]Compression" msgstr "[[zfs-term-compression]]Сжатие (compression)" #. type: Table -#: documentation/content/en/books/handbook/zfs/_index.adoc:2964 +#: documentation/content/en/books/handbook/zfs/_index.adoc:4395 #, no-wrap msgid "" -"Each dataset has a compression property, which defaults to off. Set this property to an available compression algorithm. This causes compression of all new data written to the dataset. Beyond a reduction in space used, read and write throughput often increases because fewer blocks need reading or writing.\n" +"Each dataset has a compression property. Since OpenZFS 2.2, new datasets have compression enabled by default (`compression=on`, which selects LZ4). This causes compression of all new data written to the dataset. Beyond a reduction in space used, read and write throughput often increases because fewer blocks need reading or writing.\n" "\n" "[[zfs-term-compression-lz4]]\n" -"* _LZ4_ - Added in ZFS pool version 5000 (feature flags), LZ4 is now the recommended compression algorithm. LZ4 works about 50% faster than LZJB when operating on compressible data, and is over three times faster when operating on uncompressible data. LZ4 also decompresses about 80% faster than LZJB. On modern CPUs, LZ4 can often compress at over 500 MB/s, and decompress at over 1.5 GB/s (per single CPU core).\n" +"* _LZ4_ - Added in ZFS pool version 5000 (feature flags), LZ4 is the algorithm that `compression=on` selects and the recommended general-purpose choice. LZ4 works about 50% faster than LZJB when operating on compressible data, and is over three times faster when operating on uncompressible data. LZ4 also decompresses about 80% faster than LZJB. On modern CPUs, LZ4 can often compress at over 500 MB/s, and decompress at over 1.5 GB/s (per single CPU core).\n" +"\n" +"[[zfs-term-compression-zstd]]\n" +"* _ZSTD_ - Zstandard offers higher compression ratios than LZ4 with a configurable trade-off between speed and compression, ranging from the fast `zstd-fast` variants to `zstd-19` for maximum space savings. See crossref:zfs[zfs-zfs-compression-zstd,Zstandard Compression] for details.\n" "\n" "[[zfs-term-compression-lzjb]]\n" -"* _LZJB_ - The default compression algorithm. Created by Jeff Bonwick (one of the original creators of ZFS). LZJB offers good compression with less CPU overhead compared to GZIP. In the future, the default compression algorithm will change to LZ4.\n" +"* _LZJB_ - A legacy compression algorithm, created by Jeff Bonwick (one of the original creators of ZFS). LZJB offers good compression with less CPU overhead compared to GZIP. LZ4 has replaced it as the default algorithm; prefer LZ4 or ZSTD for new datasets.\n" "\n" "[[zfs-term-compression-gzip]]\n" "* _GZIP_ - A popular stream compression algorithm available in ZFS. One of the main advantages of using GZIP is its configurable level of compression. When setting the `compress` property, the administrator can choose the level of compression, ranging from `gzip1`, the lowest level of compression, to `gzip9`, the highest level of compression. This gives the administrator control over how much CPU time to trade for saved disk space.\n" "\n" "[[zfs-term-compression-zle]]\n" "* _ZLE_ - Zero Length Encoding is a special compression algorithm that compresses continuous runs of zeros alone. This compression algorithm is useful when the dataset contains large blocks of zeros." msgstr "" -"Каждый набор данных имеет свойство сжатия (compression), которое по умолчанию отключено. Установите это свойство в один из доступных алгоритмов сжатия. Это приведёт к сжатию всех новых данных, записываемых в набор данных. Помимо уменьшения используемого пространства, пропускная способность при чтении и записи часто увеличивается, поскольку требуется читать или записывать меньше блоков.\n" +"Каждый набор данных имеет свойство сжатия (compression). Начиная с OpenZFS " +"2.2, для новых наборов данных сжатие включено по умолчанию (`compression=on`" +", что выбирает алгоритм LZ4). Установите это свойство в один из доступных " +"алгоритмов сжатия. Это приведёт к сжатию всех новых данных, записываемых в " +"набор данных. Помимо уменьшения используемого пространства, пропускная " +"способность при чтении и записи часто увеличивается, поскольку требуется " +"читать или записывать меньше блоков.\n" "\n" "[[zfs-term-compression-lz4]]\n" -"* _LZ4_ — добавлен в версии 5000 (флаги функций) пула ZFS и теперь является рекомендуемым алгоритмом сжатия. LZ4 работает примерно на 50% быстрее, чем LZJB, при работе с сжимаемыми данными и более чем в три раза быстрее при работе с несжимаемыми данными. LZ4 также распаковывает данные примерно на 80% быстрее, чем LZJB. На современных процессорах LZ4 часто может сжимать данные со скоростью более 500 МБ/с и распаковывать со скоростью более 1,5 ГБ/с (на одно ядро CPU).\n" +"* _LZ4_ — добавлен в версии 5000 (флаги функций) пула ZFS, LZ4 — это " +"алгоритм, который выбирается параметром `compression=on`, и является " +"рекомендуемым выбором для общего назначения. LZ4 работает примерно на 50% " +"быстрее, чем LZJB, при работе с сжимаемыми данными и более чем в три раза " +"быстрее при работе с несжимаемыми данными. LZ4 также распаковывает данные " +"примерно на 80% быстрее, чем LZJB. На современных процессорах LZ4 часто " +"может сжимать данные со скоростью более 500 МБ/с и распаковывать со " +"скоростью более 1,5 ГБ/с (на одно ядро CPU).\n" +"\n" +"[[zfs-term-compression-zstd]]\n" +"* _ZSTD_ — Zstandard обеспечивает более высокую степень сжатия, чем LZ4, с " +"настраиваемым компромиссом между скоростью и степенью сжатия, начиная от " +"быстрых вариантов `zstd-fast` и заканчивая `zstd-19` для максимальной " +"экономии места. Подробнее см. crossref:zfs[zfs-zfs-compression-zstd,«Сжатие " +"Zstandard»].\n" "\n" "[[zfs-term-compression-lzjb]]\n" -"* _LZJB_ — алгоритм сжатия по умолчанию. Создан Джеффом Бонвиком (одним из оригинальных создателей ZFS). LZJB обеспечивает хорошее сжатие с меньшей нагрузкой на CPU по сравнению с GZIP. В будущем алгоритм сжатия по умолчанию изменится на LZ4.\n" +"* _LZJB_ — устаревший алгоритм сжатия, создан Джеффом Бонвиком (одним из " +"первоначальных создателей ZFS). LZJB обеспечивает хорошее сжатие с меньшей " +"нагрузкой на CPU по сравнению с GZIP. LZ4 заменил его в качестве алгоритма " +"по умолчанию, для новых наборов данных предпочитайте LZ4 или ZSTD.\n" "\n" "[[zfs-term-compression-gzip]]\n" -"* _GZIP_ — популярный алгоритм потокового сжатия, доступный в ZFS. Одним из основных преимуществ использования GZIP является настраиваемый уровень сжатия. При установке свойства `compress` администратор может выбрать уровень сжатия от `gzip1` (минимальный уровень сжатия) до `gzip9` (максимальный уровень сжатия). Это позволяет администратору контролировать баланс между использованием CPU и экономией дискового пространства.\n" +"* _GZIP_ — популярный алгоритм потокового сжатия, доступный в ZFS. Одним из " +"основных преимуществ использования GZIP является настраиваемый уровень " +"сжатия. При установке свойства `compress` администратор может выбрать " +"уровень сжатия от `gzip1` (минимальный уровень сжатия) до `gzip9` (" +"максимальный уровень сжатия). Это позволяет администратору контролировать " +"баланс между использованием CPU и экономией дискового пространства.\n" "\n" "[[zfs-term-compression-zle]]\n" -"* _ZLE_ — Zero Length Encoding (кодирование нулевой длины) — это специальный алгоритм сжатия, который сжимает только непрерывные последовательности нулей. Этот алгоритм полезен, когда набор данных содержит большие блоки нулей." +"* _ZLE_ — Zero Length Encoding (кодирование нулевой длины) — это специальный " +"алгоритм сжатия, который сжимает только непрерывные последовательности " +"нулей. Этот алгоритм полезен, когда набор данных содержит большие блоки " +"нулей." #. type: Table -#: documentation/content/en/books/handbook/zfs/_index.adoc:2965 +#: documentation/content/en/books/handbook/zfs/_index.adoc:4396 #, no-wrap msgid "[[zfs-term-copies]]Copies" msgstr "[[zfs-term-copies]]Копии (copies)" #. type: Table -#: documentation/content/en/books/handbook/zfs/_index.adoc:2968 +#: documentation/content/en/books/handbook/zfs/_index.adoc:4400 #, no-wrap msgid "" "When set to a value greater than 1, the `copies` property instructs ZFS to\n" "maintain copies of each block in the crossref:zfs[zfs-term-filesystem,file\n" "system] or crossref:zfs[zfs-term-volume,volume]. Setting this property on important datasets provides added redundancy from which to recover a block that does not match its checksum. In pools without redundancy, the copies feature is the single form of redundancy. The copies feature can recover from a single bad sector or other forms of minor corruption, but it does not protect the pool from the loss of an entire disk." msgstr "" "Когда свойству `копии (copies)` присваивается значение больше 1, ZFS сохраняет копии каждого блока в crossref:zfs[zfs-term-filesystem,файловой системе] или crossref:zfs[zfs-term-volume,томе].\n" "Установка этого свойства для важных наборов данных обеспечивает дополнительную избыточность, позволяющую восстановить блок, контрольная сумма которого не совпадает.\n" "В пулах без избыточности функция копирования является единственной формой избыточности. Функция копирования позволяет восстановиться после повреждения отдельного сектора или других незначительных повреждений, но не защищает пул от потери всего диска." #. type: Table -#: documentation/content/en/books/handbook/zfs/_index.adoc:2969 +#: documentation/content/en/books/handbook/zfs/_index.adoc:4401 #, no-wrap msgid "[[zfs-term-deduplication]]Deduplication" msgstr "[[zfs-term-deduplication]]Дедубликация (Deduplication)" #. type: Table -#: documentation/content/en/books/handbook/zfs/_index.adoc:2971 +#: documentation/content/en/books/handbook/zfs/_index.adoc:4405 +#, no-wrap +msgid "" +"Checksums make it possible to detect duplicate blocks when writing data. With deduplication, the reference count of an existing, identical block increases, saving storage space. ZFS keeps a deduplication table (DDT) in memory to detect duplicate blocks. The table contains a list of unique checksums, the location of those blocks, and a reference count. When writing new data, ZFS calculates checksums and compares them to the list. When finding a match it uses the existing block. Using the SHA256 checksum algorithm with deduplication provides a secure cryptographic hash. Deduplication is tunable. If `dedup` is `on`, then a matching checksum means that the data is identical. Setting `dedup` to `verify`, ZFS performs a byte-for-byte check on the data ensuring they are actually identical. If the data is not identical, ZFS will note the hash collision and store the two blocks separately. As the DDT must store the hash of each unique block, it consumes a large amount of memory. A general rule of thumb is 5-6 GB of RAM per 1 TB of deduplicated data. In situations not practical to have enough RAM to keep the entire DDT in memory, performance will suffer greatly as the DDT must read from disk before writing each new block. Deduplication can use L2ARC to store the DDT, providing a middle ground between fast system memory and slower disks. Consider using compression instead, which often provides nearly as much space savings without the increased memory.\n" +"_Fast dedup_ batches DDT updates in a log, allows pruning stale entries with `zpool ddtprune`, and caps the table size with the `dedup_table_quota` pool property; it requires OpenZFS 2.3 or later, first available in FreeBSD 15.0.\n" +"See crossref:zfs[zfs-zfs-deduplication,Deduplication] for details." +msgstr "" +"Контрольные суммы позволяют обнаруживать дублирующиеся блоки при записи " +"данных. При дедупликации счетчик ссылок существующего идентичного блока " +"увеличивается, что экономит место на диске. ZFS хранит таблицу дедупликации " +"(DDT) в памяти для обнаружения дублирующихся блоков. Таблица содержит список " +"уникальных контрольных сумм, расположение этих блоков и счетчик ссылок. При " +"записи новых данных ZFS вычисляет контрольные суммы и сравнивает их со " +"списком. При обнаружении совпадения используется существующий блок. " +"Использование алгоритма контрольной суммы SHA256 с дедупликацией " +"обеспечивает безопасное криптографическое хеширование. Дедупликация " +"настраивается. Если `dedup` установлен в `on`, то совпадение контрольных " +"сумм означает, что данные идентичны. Если `dedup` установлен в `verify`, ZFS " +"выполняет побайтовую проверку данных, гарантируя их полное совпадение. Если " +"данные не идентичны, ZFS зафиксирует коллизию хешей и сохранит два блока " +"отдельно. Поскольку DDT должна хранить хеш каждого уникального блока, она " +"потребляет значительный объём памяти. Общее правило — 5–6 ГБ оперативной " +"памяти на 1 ТБ дедуплицированных данных. В ситуациях, когда невозможно иметь " +"достаточно памяти для хранения всей DDT в оперативной памяти, " +"производительность сильно снизится, так как DDT будет считываться с диска " +"перед записью каждого нового блока. Дедупликация может использовать L2ARC " +"для хранения DDT, что представляет собой компромисс между быстрой системной " +"памятью и медленными дисками.\n" +"Рекомендуется также рассмотреть использование сжатия, которое часто " +"обеспечивает почти такую же экономию места без увеличения потребления памяти." +"\n" +"_Быстрая дедупликация_ (fast dedup) группирует обновления DDT в журнале, " +"позволяет удалять устаревшие записи с помощью `zpool ddtprune` и " +"ограничивает размер таблицы свойством пула `dedup_table_quota`; для неё " +"требуется OpenZFS 2.3 или новее, впервые доступная в FreeBSD 15.0. Подробнее " +"см. crossref:zfs[zfs-zfs-deduplication,«Дедупликация»]." + +#. type: Table +#: documentation/content/en/books/handbook/zfs/_index.adoc:4406 +#, no-wrap +msgid "[[zfs-term-block-cloning]]Block Cloning" +msgstr "[[zfs-term-block-cloning]]Block Cloning" + +#. type: Table +#: documentation/content/en/books/handbook/zfs/_index.adoc:4411 #, no-wrap -msgid "Checksums make it possible to detect duplicate blocks when writing data. With deduplication, the reference count of an existing, identical block increases, saving storage space. ZFS keeps a deduplication table (DDT) in memory to detect duplicate blocks. The table contains a list of unique checksums, the location of those blocks, and a reference count. When writing new data, ZFS calculates checksums and compares them to the list. When finding a match it uses the existing block. Using the SHA256 checksum algorithm with deduplication provides a secure cryptographic hash. Deduplication is tunable. If `dedup` is `on`, then a matching checksum means that the data is identical. Setting `dedup` to `verify`, ZFS performs a byte-for-byte check on the data ensuring they are actually identical. If the data is not identical, ZFS will note the hash collision and store the two blocks separately. As the DDT must store the hash of each unique block, it consumes a large amount of memory. A general rule of thumb is 5-6 GB of ram per 1 TB of deduplicated data). In situations not practical to have enough RAM to keep the entire DDT in memory, performance will suffer greatly as the DDT must read from disk before writing each new block. Deduplication can use L2ARC to store the DDT, providing a middle ground between fast system memory and slower disks. Consider using compression instead, which often provides nearly as much space savings without the increased memory." -msgstr "Контрольные суммы позволяют обнаруживать дублирующиеся блоки при записи данных. При дедупликации счетчик ссылок существующего идентичного блока увеличивается, что экономит место на диске. ZFS хранит таблицу дедупликации (DDT) в памяти для обнаружения дублирующихся блоков. Таблица содержит список уникальных контрольных сумм, расположение этих блоков и счетчик ссылок. При записи новых данных ZFS вычисляет контрольные суммы и сравнивает их со списком. При обнаружении совпадения используется существующий блок. Использование алгоритма контрольной суммы SHA256 с дедупликацией обеспечивает безопасное криптографическое хеширование. Дедупликация настраивается. Если `dedup` установлен в `on`, то совпадение контрольных сумм означает, что данные идентичны. Если `dedup` установлен в `verify`, ZFS выполняет побайтовую проверку данных, гарантируя их полное совпадение. Если данные не идентичны, ZFS зафиксирует коллизию хешей и сохранит два блока отдельно. Поскольку DDT должна хранить хеш каждого уникального блока, она потребляет значительный объём памяти. Общее правило — 5–6 ГБ оперативной памяти на 1 ТБ дедуплицированных данных. В ситуациях, когда невозможно иметь достаточно памяти для хранения всей DDT в оперативной памяти, производительность сильно снизится, так как DDT будет считываться с диска перед записью каждого нового блока. Дедупликация может использовать L2ARC для хранения DDT, что представляет собой компромисс между быстрой системной памятью и медленными дисками. Рекомендуется также рассмотреть использование сжатия, которое часто обеспечивает почти такую же экономию места без увеличения потребления памяти." +msgid "" +"Block cloning allows a file copy to reference the existing on-disk blocks of the source file instead of duplicating them, so the copy completes almost instantly and consumes no extra space until either file changes.\n" +"On FreeBSD, man:cp[1] uses man:copy_file_range[2], so ordinary file copies become block clones when the feature is enabled (the default on FreeBSD 15.0).\n" +"The `bcloneused`, `bclonesaved`, and `bcloneratio` pool properties report the resulting space savings.\n" +"See crossref:zfs[zfs-zfs-block-cloning,Block Cloning] for details." +msgstr "" +"Блочное клонирование позволяет копии файла ссылаться на блоки исходного " +"файла, существующие на диске, вместо их дублирования, поэтому копия " +"выполняется почти мгновенно и не занимает дополнительное место, пока ни один " +"из файлов не изменится.\n" +"На FreeBSD man:cp[1] использует man:copy_file_range[2], поэтому обычные " +"копии файлов становятся блочными клонами, когда эта функция включена (по " +"умолчанию в FreeBSD 15.0).\n" +"Свойства пула `bcloneused`, `bclonesaved` и `bcloneratio` сообщают о " +"полученной экономии места.\n" +"Подробности см. в crossref:zfs[zfs-zfs-block-cloning,Блочное клонирование]." #. type: Table -#: documentation/content/en/books/handbook/zfs/_index.adoc:2972 +#: documentation/content/en/books/handbook/zfs/_index.adoc:4412 #, no-wrap msgid "[[zfs-term-scrub]]Scrub" msgstr "[[zfs-term-scrub]]Scrub" #. type: Table -#: documentation/content/en/books/handbook/zfs/_index.adoc:2983 +#: documentation/content/en/books/handbook/zfs/_index.adoc:4423 #, no-wrap msgid "" "Instead of a consistency check like man:fsck[8], ZFS has `scrub`. `scrub` reads\n" "all data blocks stored on the pool and verifies their checksums against the\n" "known good checksums stored in the metadata. A periodic check of all the data\n" "stored on the pool ensures the recovery of any corrupted blocks before needing\n" "them. A scrub is not required after an unclean shutdown, but good practice is at\n" -"least once every three months. ZFS verifies the checksum of each block during\n" +"least once every month. ZFS verifies the checksum of each block during\n" "normal use, but a scrub makes certain to check even infrequently used blocks for\n" "silent corruption. ZFS improves data security in archival storage situations.\n" -"Adjust the relative priority of `scrub` with\n" -"crossref:zfs[zfs-advanced-tuning-scrub_delay,`vfs.zfs.scrub_delay`] to prevent the scrub from degrading the performance of other workloads on the pool." +"Pause a running scrub with `zpool scrub -p` and resume it later by running `zpool scrub` again.\n" +"See crossref:zfs[zfs-zpool-scrub,Scrubbing a Pool] for details." msgstr "" -"Вместо проверки согласованности, такой как man:fsck[8], в ZFS используется `scrub`.\n" -"`scrub` читает все блоки данных в пуле и проверяет их контрольные суммы по сравнению\n" +"Вместо проверки согласованности, такой как man:fsck[8], в ZFS используется " +"`scrub`.\n" +"`scrub` читает все блоки данных в пуле и проверяет их контрольные суммы по " +"сравнению\n" "с известными корректными контрольными суммами, хранящимися в метаданных.\n" -"Периодическая проверка всех данных в пуле гарантирует восстановление повреждённых блоков до того,\n" -"как они понадобятся. Проведение `scrub` не требуется после некорректного завершения работы,\n" -"но рекомендуется выполнять её хотя бы раз в три месяца. ZFS проверяет контрольные суммы каждого блока\n" -"при обычном использовании, но `scrub` обеспечивает проверку даже редко используемых блоков\n" -"на тихую порчу данных. ZFS повышает безопасность данных в архивных системах хранения.\n" -"Настройте относительный приоритет `scrub` с помощью crossref:zfs[zfs-advanced-tuning-scrub_delay,`vfs.zfs.scrub_delay`],\n" -"чтобы предотвратить снижение производительности других задач в пуле из-за проверки." +"Периодическая проверка всех данных в пуле гарантирует восстановление " +"повреждённых блоков до того,\n" +"как они понадобятся. Проведение `scrub` не требуется после некорректного " +"завершения работы,\n" +"но рекомендуется выполнять её хотя бы раз в месяц. ZFS проверяет контрольные " +"суммы каждого блока\n" +"при обычном использовании, но `scrub` обеспечивает проверку даже редко " +"используемых блоков\n" +"на тихую порчу данных. ZFS повышает безопасность данных в архивных системах " +"хранения.\n" +"Приостановите выполняющуюся проверку (scrub) с помощью `zpool scrub -p` и " +"возобновите её позже,\n" +"снова запустив `zpool scrub`. Подробнее см. crossref:zfs[zfs-zpool-scrub,«" +"Проверка пула»]." + +#. type: Table +#: documentation/content/en/books/handbook/zfs/_index.adoc:4424 +#, no-wrap +msgid "[[zfs-term-checkpoint]]Checkpoint" +msgstr "[[zfs-term-checkpoint]]Checkpoint" + +#. type: Table +#: documentation/content/en/books/handbook/zfs/_index.adoc:4429 +#, no-wrap +msgid "" +"A checkpoint preserves the entire state of a pool at a single point in time, including pool-wide configuration changes that snapshots cannot capture.\n" +"Rewinding to a checkpoint with `zpool import --rewind-to-checkpoint` undoes everything that happened after taking it, such as enabling pool features, adding or removing vdevs, or destroying datasets.\n" +"A pool has at most one checkpoint at a time.\n" +"See crossref:zfs[zfs-zpool-checkpoint,Pool Checkpoints] for details." +msgstr "" +"Контрольная точка сохраняет полное состояние пула в единый момент времени, " +"включая изменения конфигурации всего пула, которые снимки не могут " +"зафиксировать.\n" +"Возврат к контрольной точке с помощью `zpool import --rewind-to-checkpoint` " +"отменяет всё, что произошло после её создания, например, включение функций " +"пула, добавление или удаление vdev, или уничтожение наборов данных.\n" +"Пул может иметь не более одной контрольной точки одновременно.\n" +"Подробности см. в crossref:zfs[zfs-zpool-checkpoint,Контрольные точки пула]." + +#. type: Table +#: documentation/content/en/books/handbook/zfs/_index.adoc:4430 +#, no-wrap +msgid "[[zfs-term-trim]]TRIM" +msgstr "[[zfs-term-trim]]TRIM" + +#. type: Table +#: documentation/content/en/books/handbook/zfs/_index.adoc:4434 +#, no-wrap +msgid "" +"TRIM notifies SSDs and other flash-based storage which blocks the pool no longer uses, allowing the device to erase them in advance and sustain write performance.\n" +"Run `zpool trim` manually, or set the `autotrim` pool property to `on` to trim freed space continuously.\n" +"See crossref:zfs[zfs-zpool-trim,TRIM and Initialization] for details." +msgstr "" +"TRIM уведомляет SSD и другие накопители на флеш-памяти о блоках, которые пул " +"больше не использует, позволяя устройству заранее стирать их и поддерживать " +"производительность записи.\n" +"Запустите `zpool trim` вручную или установите свойство пула `autotrim` в " +"значение `on`, чтобы непрерывно выполнять TRIM для освобожденного " +"пространства.\n" +"Подробности см. в crossref:zfs[zfs-zpool-trim,TRIM и инициализация]." #. type: Table -#: documentation/content/en/books/handbook/zfs/_index.adoc:2984 +#: documentation/content/en/books/handbook/zfs/_index.adoc:4435 #, no-wrap msgid "[[zfs-term-quota]]Dataset Quota" msgstr "[[zfs-term-quota]]Квота набора данных" #. type: Table -#: documentation/content/en/books/handbook/zfs/_index.adoc:2998 +#: documentation/content/en/books/handbook/zfs/_index.adoc:4449 #, no-wrap msgid "" "ZFS provides fast and accurate dataset, user, and group space accounting as well as quotas and space reservations. This gives the administrator fine grained control over space allocation and allows reserving space for critical file systems.\n" "\n" "ZFS supports different types of quotas: the dataset quota, the\n" "crossref:zfs[zfs-term-refquota,reference quota (refquota)], the\n" "crossref:zfs[zfs-term-userquota,user quota], and the\n" "crossref:zfs[zfs-term-groupquota,group quota].\n" "\n" "Quotas limit the total size of a dataset and its descendants, including snapshots of the dataset, child datasets, and the snapshots of those datasets.\n" "\n" "[NOTE]\n" "====\n" "Volumes do not support quotas, as the `volsize` property acts as an implicit quota.\n" "====" msgstr "" "ZFS обеспечивает быстрый и точный учёт пространства для наборов данных, пользователей и групп, а также квоты и резервирование пространства. Это даёт администратору детальный контроль над распределением пространства и позволяет резервировать место для критически важных файловых систем.\n" "\n" "ZFS поддерживает различные типы квот: квоту набора данных,\n" "crossref:zfs[zfs-term-refquota,референтную квоту (refquota)],\n" "crossref:zfs[zfs-term-userquota,пользовательскую квоту] и\n" "crossref:zfs[zfs-term-groupquota,групповую квоту].\n" "\n" "Квоты ограничивают общий размер набора данных и его потомков, включая снимки набора данных, дочерние наборы данных и снимки этих наборов данных.\n" "\n" "[NOTE]\n" "====\n" "Тома не поддерживают квоты, так как свойство `volsize` действует как неявная квота.\n" "====" #. type: Table -#: documentation/content/en/books/handbook/zfs/_index.adoc:2999 +#: documentation/content/en/books/handbook/zfs/_index.adoc:4450 #, no-wrap msgid "[[zfs-term-refquota]]Reference Quota" msgstr "[[zfs-term-refquota]]Квота ссылки" #. type: Table -#: documentation/content/en/books/handbook/zfs/_index.adoc:3001 +#: documentation/content/en/books/handbook/zfs/_index.adoc:4452 #, no-wrap msgid "A reference quota limits the amount of space a dataset can consume by enforcing a hard limit. This hard limit includes space referenced by the dataset alone and does not include space used by descendants, such as file systems or snapshots." msgstr "Референтная квота ограничивает объём пространства, который может занимать набор данных, устанавливая жёсткий лимит. Этот жёсткий лимит включает только пространство, на которое ссылается сам набор данных, и не учитывает пространство, используемое его потомками, такими как файловые системы или снимки." #. type: Table -#: documentation/content/en/books/handbook/zfs/_index.adoc:3002 +#: documentation/content/en/books/handbook/zfs/_index.adoc:4453 #, no-wrap msgid "[[zfs-term-userquota]]User Quota" msgstr "[[zfs-term-userquota]]Квота пользователя" #. type: Table -#: documentation/content/en/books/handbook/zfs/_index.adoc:3004 +#: documentation/content/en/books/handbook/zfs/_index.adoc:4455 #, no-wrap msgid "User quotas are useful to limit the amount of space used by the specified user." msgstr "Пользовательские квоты полезны для ограничения объёма пространства, используемого указанным пользователем." #. type: Table -#: documentation/content/en/books/handbook/zfs/_index.adoc:3005 +#: documentation/content/en/books/handbook/zfs/_index.adoc:4456 #, no-wrap msgid "[[zfs-term-groupquota]]Group Quota" msgstr "[[zfs-term-groupquota]]Квота группы" #. type: Table -#: documentation/content/en/books/handbook/zfs/_index.adoc:3007 +#: documentation/content/en/books/handbook/zfs/_index.adoc:4458 #, no-wrap msgid "The group quota limits the amount of space that a specified group can consume." msgstr "Квота группы ограничивает объём пространства, который может использовать указанная группа." #. type: Table -#: documentation/content/en/books/handbook/zfs/_index.adoc:3008 +#: documentation/content/en/books/handbook/zfs/_index.adoc:4459 #, no-wrap msgid "[[zfs-term-reservation]]Dataset Reservation" msgstr "[[zfs-term-reservation]]Резервирование для набора данных" #. type: Table -#: documentation/content/en/books/handbook/zfs/_index.adoc:3016 +#: documentation/content/en/books/handbook/zfs/_index.adoc:4467 #, no-wrap msgid "" "The `reservation` property makes it possible to guarantee an amount of space\n" "for a specific dataset and its descendants. This means that setting a 10 GB\n" "reservation on [.filename]#storage/home/bob# prevents other datasets from using\n" "up all free space, reserving at least 10 GB of space for this dataset. Unlike a\n" -"regular crossref:zfs[zfs-term-refreservation,`refreservation`], space used by snapshots and descendants is not counted against the reservation. For example, if taking a snapshot of [.filename]#storage/home/bob#, enough disk space other than the `refreservation` amount must exist for the operation to succeed. Descendants of the main data set are not counted in the `refreservation` amount and so do not encroach on the space set.\n" +"regular crossref:zfs[zfs-term-refreservation,`refreservation`], space used by snapshots and descendant datasets does count against the reservation.\n" "\n" "Reservations of any sort are useful in situations such as planning and testing the suitability of disk space allocation in a new system, or ensuring that enough space is available on file systems for audio logs or system recovery procedures and files." msgstr "" -"Свойство `reservation` позволяет гарантировать определённый объём пространства для конкретного набора данных и его потомков.\n" -"Это означает, что установка резерва в 10 ГБ для [.filename]#storage/home/bob# предотвращает использование всего свободного пространства другими наборами данных, резервируя как минимум 10 ГБ для этого набора.\n" -"В отличие от обычного `reservation`, при crossref:zfs[zfs-term-refreservation,`refreservation`] пространство, используемое снимками и потомками,\n" -"не учитывается в резерве. Например, при создании снимка [.filename]#storage/home/bob# для успешного выполнения операции должно быть достаточно дискового пространства, помимо объёма `refreservation`.\n" -"Потомки основного набора данных не учитываются в объёме `refreservation` и, следовательно, не занимают зарезервированное пространство.\n" -"\n" -"Резервирование любого типа полезно в таких ситуациях, как планирование и тестирование распределения дискового пространства в новой системе, или для обеспечения достаточного места в файловых системах для аудио-логов, процедур восстановления системы и файлов." +"Свойство `reservation` позволяет гарантировать определённый объём " +"пространства для конкретного набора данных и его потомков.\n" +"Это означает, что установка резерва в 10 ГБ для [.filename]#storage/home/bob#" +" предотвращает использование всего свободного пространства другими наборами " +"данных, резервируя как минимум 10 ГБ для этого набора.\n" +"В отличие от обычного `reservation`, при crossref:zfs[zfs-term-" +"refreservation,`refreservation`] пространство, \n" +"используемое снимками и потомками наборов данных,\n" +"не учитывается в резерве.\n" +"Резервирование любого типа полезно в таких ситуациях, как планирование и " +"тестирование распределения\n" +"дискового пространства в новой системе, или для обеспечения достаточного " +"места в файловых системах для аудио-логов, процедур восстановления системы и " +"файлов." #. type: Table -#: documentation/content/en/books/handbook/zfs/_index.adoc:3017 +#: documentation/content/en/books/handbook/zfs/_index.adoc:4468 #, no-wrap msgid "[[zfs-term-refreservation]]Reference Reservation" msgstr "[[zfs-term-refreservation]]Референтное резервирование" #. type: Table -#: documentation/content/en/books/handbook/zfs/_index.adoc:3023 +#: documentation/content/en/books/handbook/zfs/_index.adoc:4474 #, no-wrap msgid "" "The `refreservation` property makes it possible to guarantee an amount of space\n" "for the use of a specific dataset _excluding_ its descendants. This means that\n" "setting a 10 GB reservation on [.filename]#storage/home/bob#, and another\n" -"dataset tries to use the free space, reserving at least 10 GB of space for this\n" -"dataset. In contrast to a regular crossref:zfs[zfs-term-reservation,reservation], space used by snapshots and descendant datasets is not counted against the reservation. For example, if taking a snapshot of [.filename]#storage/home/bob#, enough disk space other than the `refreservation` amount must exist for the operation to succeed. Descendants of the main data set are not counted in the `refreservation` amount and so do not encroach on the space set." +"dataset tries to use the free space, reserving at least 10 GB of space for this\n" +"dataset. In contrast to a regular crossref:zfs[zfs-term-reservation,reservation], space used by snapshots and descendant datasets is not counted against the reservation. For example, if taking a snapshot of [.filename]#storage/home/bob#, enough disk space other than the `refreservation` amount must exist for the operation to succeed. Descendants of the main data set are not counted in the `refreservation` amount and so do not encroach on the space set." msgstr "" -"Свойство `refreservation` позволяет гарантировать определённый объём пространства\n" +"Свойство `refreservation` позволяет гарантировать определённый объём " +"пространства\n" "для использования конкретным набором данных _исключая_ его потомков.\n" -"Это означает, что если установить резервирование в 10 ГБ для [.filename]#storage/home/bob#, а другой набор данных попытается использовать свободное пространство, то он оставит как минимум 10 ГБ, зарезервированных для [.filename]#storage/home/bob#.\n" -"В отличие от обычного crossref:zfs[zfs-term-reservation,резервирования], пространство,\n" -"используемое снимками и наборами-потомками, не учитывается в резервировании. Например, при создании снимка [.filename]#storage/home/bob# для успешного выполнения операции должно быть достаточно места на диске помимо объёма, указанного в `refreservation`. Наборы данных-потомки не учитываются в объёме `refreservation` и, следовательно, не уменьшают зарезервированное пространство." +"Это означает, что если установить резервирование в 10 ГБ для [.filename]#" +"storage/home/bob#, а другой набор данных попытается использовать свободное " +"пространство, то он оставит как минимум 10 ГБ, зарезервированных для [." +"filename]#storage/home/bob#.\n" +"В отличие от обычного crossref:zfs[zfs-term-reservation,резервирования], " +"пространство,\n" +"используемое снимками и наборами-потомками, не учитывается в резервировании. " +"Например, при создании снимка [.filename]#storage/home/bob# для успешного " +"выполнения операции должно быть достаточно места на диске помимо объёма, " +"указанного в `refreservation`. Наборы данных-потомки не учитываются в объёме " +"`refreservation` и, следовательно, не уменьшают зарезервированное " +"пространство." + +#. type: Table +#: documentation/content/en/books/handbook/zfs/_index.adoc:4475 +#, no-wrap +msgid "[[zfs-term-boot-environment]]Boot Environment" +msgstr "[[zfs-term-boot-environment]]Boot Environment" + +#. type: Table +#: documentation/content/en/books/handbook/zfs/_index.adoc:4479 +#, no-wrap +msgid "" +"A boot environment is a bootable clone of the datasets that hold the FreeBSD system, managed with man:bectl[8].\n" +"Creating a boot environment before a system upgrade makes it possible to boot the previous, known-good system from the loader menu if the upgrade causes problems.\n" +"See crossref:zfs[zfs-boot-environments,Boot Environments] for details." +msgstr "" +"Загрузочное окружение — это загрузочная копия наборов данных, содержащих " +"систему FreeBSD, управляемая с помощью man:bectl[8].\n" +"Создание загрузочного окружения перед обновлением системы позволяет " +"загрузить предыдущую, заведомо рабочую систему из меню загрузчика, если " +"обновление вызовет проблемы.\n" +"Подробности см. в crossref:zfs[zfs-boot-environments,Загрузочные окружения]." #. type: Table -#: documentation/content/en/books/handbook/zfs/_index.adoc:3024 +#: documentation/content/en/books/handbook/zfs/_index.adoc:4480 #, no-wrap msgid "[[zfs-term-resilver]]Resilver" msgstr "[[zfs-term-resilver]]Ресильверинг" #. type: Table -#: documentation/content/en/books/handbook/zfs/_index.adoc:3025 -#, no-wrap -msgid "When replacing a failed disk, ZFS must fill the new disk with the lost data. _Resilvering_ is the process of using the parity information distributed across the remaining drives to calculate and write the missing data to the new drive." -msgstr "При замене вышедшего из строя диска ZFS необходимо заполнить новый диск утерянными данными. _Ресильверинг_ (resilvering — серебрение, восстановление зеркала) — это процесс использования информации о чётности, распределенной по оставшимся дискам, для вычисления и записи отсутствующих данных на новый диск." +#: documentation/content/en/books/handbook/zfs/_index.adoc:4486 +#, no-wrap +msgid "" +"When replacing a failed disk, ZFS must fill the new disk with the lost data.\n" +"_Resilvering_ is the process of writing that data to the replacement device: mirrors resilver by copying the data from the surviving members, while RAID-Z reconstructs it from the parity information distributed across the remaining drives.\n" +"Unlike a traditional RAID rebuild, resilvering copies allocated data alone rather than every sector of the device.\n" +"A _sequential resilver_ (`zpool attach -s` or `zpool replace -s`) rebuilds mirror and dRAID vdevs even faster by copying blocks in disk order, skipping checksum verification and deferring it to an automatically scheduled scrub.\n" +"See crossref:zfs[zfs-zpool-resilver,Dealing with Failed Devices] for details." +msgstr "" +"При замене вышедшего из строя диска ZFS должен заполнить новый диск " +"утерянными данными.\n" +"_Ресилверинг_ — это процесс записи этих данных на заменяющее устройство: " +"зеркала выполняют ресилверинг путём копирования данных с выживших " +"участников, а RAID-Z восстанавливает их из информации о чётности, " +"распределённой по оставшимся дискам.\n" +"В отличие от традиционной перестройки RAID, ресилверинг копирует только " +"выделенные данные, а не каждый сектор устройства.\n" +"_Последовательный ресилверинг_ (`zpool attach -s` или `zpool replace -s`) " +"перестраивает зеркальные и dRAID vdev-ы ещё быстрее, копируя блоки в порядке " +"диска, пропуская проверку контрольных сумм и откладывая её на автоматически " +"запланированную проверку (scrab).\n" +"Подробности см. в crossref:zfs[zfs-zpool-resilver,Dealing with Failed " +"Devices]." #. type: Table -#: documentation/content/en/books/handbook/zfs/_index.adoc:3026 +#: documentation/content/en/books/handbook/zfs/_index.adoc:4487 #, no-wrap msgid "[[zfs-term-online]]Online" msgstr "[[zfs-term-online]]Online" #. type: Table -#: documentation/content/en/books/handbook/zfs/_index.adoc:3028 +#: documentation/content/en/books/handbook/zfs/_index.adoc:4489 #, no-wrap msgid "A pool or vdev in the `Online` state has its member devices connected and fully operational. Individual devices in the `Online` state are functioning." -msgstr "Пул или vdev в состоянии `Online` имеет подключенные и полностью работоспособные устройства-участники. Отдельные устройства в состоянии `Online` функционируют." +msgstr "Пул или vdev в состоянии `Online` имеет подключённые и полностью работоспособные устройства-участники. Отдельные устройства в состоянии `Online` функционируют." #. type: Table -#: documentation/content/en/books/handbook/zfs/_index.adoc:3029 +#: documentation/content/en/books/handbook/zfs/_index.adoc:4490 #, no-wrap msgid "[[zfs-term-offline]]Offline" msgstr "[[zfs-term-offline]]Offline" #. type: Table -#: documentation/content/en/books/handbook/zfs/_index.adoc:3033 +#: documentation/content/en/books/handbook/zfs/_index.adoc:4494 #, no-wrap msgid "" "The administrator puts individual devices in an `Offline` state if enough\n" "redundancy exists to avoid putting the pool or vdev into a\n" "crossref:zfs[zfs-term-faulted,Faulted] state. An administrator may choose to offline a disk in preparation for replacing it, or to make it easier to identify." msgstr "" "Администратор переводит отдельные устройства в состояние `Offline`,\n" "если существует достаточная избыточность, чтобы избежать перевода пула или vdev в состояние crossref:zfs[zfs-term-faulted,Faulted].\n" "Администратор может отключить диск для подготовки к его замене или для упрощения идентификации." #. type: Table -#: documentation/content/en/books/handbook/zfs/_index.adoc:3034 +#: documentation/content/en/books/handbook/zfs/_index.adoc:4495 #, no-wrap msgid "[[zfs-term-degraded]]Degraded" msgstr "[[zfs-term-degraded]]Degraded" #. type: Table -#: documentation/content/en/books/handbook/zfs/_index.adoc:3041 +#: documentation/content/en/books/handbook/zfs/_index.adoc:4502 #, no-wrap msgid "" "A pool or vdev in the `Degraded` state has one or more disks that disappeared\n" "or failed. The pool is still usable, but if other devices fail, the pool may\n" "become unrecoverable. Reconnecting the missing devices or replacing the failed\n" "disks will return the pool to an crossref:zfs[zfs-term-online,Online] state\n" "after the reconnected or new device has completed the\n" "crossref:zfs[zfs-term-resilver,Resilver] process." msgstr "" "Пул или vdev в состоянии `Degraded` имеет один или несколько дисков, которые исчезли или вышли из строя.\n" "Пул по-прежнему можно использовать, но если другие устройства выйдут из строя, пул может стать невосстановимым.\n" "Повторное подключение отсутствующих устройств\n" "или замена неисправных дисков вернет пул\n" "в состояние crossref:zfs[zfs-term-online,Online] после того,\n" -"как повторно подключенное или новое устройство завершит процесс crossref:zfs[zfs-term-resilver,ресильверинга]." +"как повторно подключённое или новое устройство завершит процесс crossref:zfs[zfs-term-resilver,ресильверинга]." #. type: Table -#: documentation/content/en/books/handbook/zfs/_index.adoc:3042 +#: documentation/content/en/books/handbook/zfs/_index.adoc:4503 #, no-wrap msgid "[[zfs-term-faulted]]Faulted" msgstr "[[zfs-term-faulted]]Faulted" #. type: Table -#: documentation/content/en/books/handbook/zfs/_index.adoc:3047 +#: documentation/content/en/books/handbook/zfs/_index.adoc:4509 #, no-wrap msgid "" "A pool or vdev in the `Faulted` state is no longer operational. Accessing the\n" "data is no longer possible. A pool or vdev enters the `Faulted` state when the\n" "number of missing or failed devices exceeds the level of redundancy in the vdev.\n" "If reconnecting missing devices the pool will return to an\n" "crossref:zfs[zfs-term-online,Online] state. Insufficient redundancy to compensate for the number of failed disks loses the pool contents and requires restoring from backups." msgstr "" "Пул или vdev в состоянии `Faulted` больше не функционирует. Доступ к данным становится невозможным.\n" "Пул или vdev переходит в состояние `Faulted`, когда количество отсутствующих или неисправных устройств\n" "превышает уровень избыточности vdev.\n" "Если отсутствующие устройства будут снова подключены, пул вернётся в состояние crossref:zfs[zfs-term-online,Online].\n" "Недостаточная избыточность для компенсации количества неисправных дисков приводит к потере содержимого пула и требует восстановления из резервных копий." +#. type: Table +#: documentation/content/en/books/handbook/zfs/_index.adoc:4510 +#, no-wrap +msgid "[[zfs-term-unavail]]Unavail" +msgstr "[[zfs-term-unavail]]Unavail" + +#. type: Table +#: documentation/content/en/books/handbook/zfs/_index.adoc:4514 +#, no-wrap +msgid "" +"A device in the `Unavail` state cannot be opened, because it is missing or inaccessible.\n" +"The pool continues operating if enough redundancy exists to compensate, running in a crossref:zfs[zfs-term-degraded,Degraded] state.\n" +"If a top-level vdev is `Unavail`, accessing the pool contents is impossible." +msgstr "" +"Устройство в состоянии `Unavail` не может быть открыто, поскольку оно " +"отсутствует или недоступно.\n" +"Пул продолжает работать, если имеется достаточная избыточность для " +"компенсации, функционируя в crossref:zfs[zfs-term-degraded,состоянии " +"Degraded (деградировавшем)].\n" +"Если вышестоящий vdev находится в состоянии `Unavail`, доступ к содержимому " +"пула невозможен." + +#. type: Table +#: documentation/content/en/books/handbook/zfs/_index.adoc:4515 +#, no-wrap +msgid "[[zfs-term-removed]]Removed" +msgstr "[[zfs-term-removed]]Removed" + +#. type: Table +#: documentation/content/en/books/handbook/zfs/_index.adoc:4518 +#, no-wrap +msgid "" +"A device in the `Removed` state was physically detached while the system was running.\n" +"Device removal detection is hardware-dependent and unsupported on some platforms.\n" +"When the device reconnects, man:zfsd[8] brings it back online; if the device does not return, zfsd activates an available hot spare in its place." +msgstr "" +"Устройство в состоянии `Removed` было физически отсоединено во время работы " +"системы.\n" +"Обнаружение удаления устройства зависит от аппаратного обеспечения и не " +"поддерживается на некоторых платформах.\n" +"Когда устройство переподключается, man:zfsd[8] возвращает его в онлайн; если " +"устройство не возвращается, zfsd активирует доступный горячий резерв вместо " +"него." + +#, no-wrap +#~ msgid "# service zfs enable\n" +#~ msgstr "# service zfs enable\n" + +#~ msgid "To create a simple, non-redundant pool using a single disk device:" +#~ msgstr "" +#~ "Чтобы создать простой, не избыточный пул, используя одно дисковое " +#~ "устройство:" + +#, no-wrap +#~ msgid "# zpool create example /dev/da0\n" +#~ msgstr "# zpool create example /dev/da0\n" + +#, no-wrap +#~ msgid "" +#~ "# df\n" +#~ "Filesystem 1K-blocks Used Avail Capacity Mounted on\n" +#~ "/dev/ad0s1a 2026030 235230 1628718 13% /\n" +#~ "devfs 1 1 0 100% /dev\n" +#~ "/dev/ad0s1d 54098308 1032846 48737598 2% /usr\n" +#~ "example 17547136 0 17547136 0% /example\n" +#~ msgstr "" +#~ "# df\n" +#~ "Filesystem 1K-blocks Used Avail Capacity Mounted on\n" +#~ "/dev/ad0s1a 2026030 235230 1628718 13% /\n" +#~ "devfs 1 1 0 100% /dev\n" +#~ "/dev/ad0s1d 54098308 1032846 48737598 2% /usr\n" +#~ "example 17547136 0 17547136 0% /example\n" + +#~ msgid "" +#~ "This example creates a RAID-Z pool, specifying the disks to add to the " +#~ "pool:" +#~ msgstr "" +#~ "В этом примере создаётся пул RAID-Z с указанием дисков для добавления в " +#~ "пул:" + +#, no-wrap +#~ msgid "" +#~ "\tNAME STATE READ WRITE CKSUM\n" +#~ "\tstorage DEGRADED 0 0 0\n" +#~ "\t raidz1 DEGRADED 0 0 0\n" +#~ "\t da0 ONLINE 0 0 0\n" +#~ "\t da1 OFFLINE 0 0 0\n" +#~ "\t da2 ONLINE 0 0 0\n" +#~ msgstr "" +#~ "\tNAME STATE READ WRITE CKSUM\n" +#~ "\tstorage DEGRADED 0 0 0\n" +#~ "\t raidz1 DEGRADED 0 0 0\n" +#~ "\t da0 ONLINE 0 0 0\n" +#~ "\t da1 OFFLINE 0 0 0\n" +#~ "\t da2 ONLINE 0 0 0\n" + +#, no-wrap +#~ msgid "" +#~ "\tNAME STATE READ WRITE CKSUM\n" +#~ "\tstorage ONLINE 0 0 0\n" +#~ "\t raidz1 ONLINE 0 0 0\n" +#~ "\t da0 ONLINE 0 0 0\n" +#~ "\t da1 ONLINE 0 0 0\n" +#~ "\t da2 ONLINE 0 0 0\n" +#~ msgstr "" +#~ "\tNAME STATE READ WRITE CKSUM\n" +#~ "\tstorage ONLINE 0 0 0\n" +#~ "\t raidz1 ONLINE 0 0 0\n" +#~ "\t da0 ONLINE 0 0 0\n" +#~ "\t da1 ONLINE 0 0 0\n" +#~ "\t da2 ONLINE 0 0 0\n" + +#, no-wrap +#~ msgid "" +#~ "# zpool status storage\n" +#~ " pool: storage\n" +#~ " state: ONLINE\n" +#~ " scrub: scrub completed with 0 errors on Sat Jan 26 19:57:37 2013\n" +#~ "config:\n" +#~ msgstr "" +#~ "# zpool status storage\n" +#~ " pool: storage\n" +#~ " state: ONLINE\n" +#~ " scrub: scrub completed with 0 errors on Sat Jan 26 19:57:37 2013\n" +#~ "config:\n" + +#~ msgid "" +#~ "Creating a ZFS storage pool requires permanent decisions, as the pool " +#~ "structure cannot change after creation. The most important decision is " +#~ "which types of vdevs to group the physical disks into. See the list of " +#~ "crossref:zfs[zfs-term-vdev,vdev types] for details about the possible " +#~ "options. After creating the pool, most vdev types do not allow adding " +#~ "disks to the vdev. The exceptions are mirrors, which allow adding new " +#~ "disks to the vdev, and stripes, which upgrade to mirrors by attaching a " +#~ "new disk to the vdev. Although adding new vdevs expands a pool, the pool " +#~ "layout cannot change after pool creation. Instead, back up the data, " +#~ "destroy the pool, and recreate it." +#~ msgstr "" +#~ "Создание пула хранения ZFS требует принятия окончательного решения о " +#~ "нескольких параметрах, так как структура пула не может быть изменена " +#~ "после создания. Наиболее важное решение — это выбор типов vdev, в которые " +#~ "будут объединены физические диски. Подробнее о возможных вариантах см. в " +#~ "списке crossref:zfs[zfs-term-vdev,типов vdev]. После создания пула " +#~ "большинство типов vdev не позволяют добавлять диски в vdev. Исключения " +#~ "составляют зеркала (mirror), которые позволяют добавлять новые диски в " +#~ "vdev, и страйпы (stripe), которые могут быть преобразованы в зеркала " +#~ "путём добавления нового диска к vdev. Хотя добавление новых vdev " +#~ "расширяет пул, компоновка пула не может быть изменена после его создания. " +#~ "Вместо этого необходимо создать резервную копию данных, удалить пул и " +#~ "воссоздать его." + +#~ msgid "Create a simple mirror pool:" +#~ msgstr "Создание простого зеркального пула:" + +#, no-wrap +#~ msgid "" +#~ " NAME STATE READ WRITE CKSUM\n" +#~ " mypool ONLINE 0 0 0\n" +#~ " mirror-0 ONLINE 0 0 0\n" +#~ " ada1 ONLINE 0 0 0\n" +#~ " ada2 ONLINE 0 0 0\n" +#~ msgstr "" +#~ " NAME STATE READ WRITE CKSUM\n" +#~ " mypool ONLINE 0 0 0\n" +#~ " mirror-0 ONLINE 0 0 0\n" +#~ " ada1 ONLINE 0 0 0\n" +#~ " ada2 ONLINE 0 0 0\n" + +#, no-wrap +#~ msgid "" +#~ " NAME STATE READ WRITE CKSUM\n" +#~ " mypool ONLINE 0 0 0\n" +#~ " mirror-0 ONLINE 0 0 0\n" +#~ " ada1 ONLINE 0 0 0\n" +#~ " ada2 ONLINE 0 0 0\n" +#~ " mirror-1 ONLINE 0 0 0\n" +#~ " ada3 ONLINE 0 0 0\n" +#~ " ada4 ONLINE 0 0 0\n" +#~ msgstr "" +#~ " NAME STATE READ WRITE CKSUM\n" +#~ " mypool ONLINE 0 0 0\n" +#~ " mirror-0 ONLINE 0 0 0\n" +#~ " ada1 ONLINE 0 0 0\n" +#~ " ada2 ONLINE 0 0 0\n" +#~ " mirror-1 ONLINE 0 0 0\n" +#~ " ada3 ONLINE 0 0 0\n" +#~ " ada4 ONLINE 0 0 0\n" + +#, no-wrap +#~ msgid "" +#~ "errors: No known data errors\n" +#~ "# zpool attach mypool ada0p3 ada1p3\n" +#~ "Make sure to wait until resilvering finishes before rebooting.\n" +#~ msgstr "" +#~ "errors: No known data errors\n" +#~ "# zpool attach mypool ada0p3 ada1p3\n" +#~ "Make sure to wait until resilvering finishes before rebooting.\n" + +#, no-wrap +#~ msgid "If you boot from pool 'mypool', you may need to update boot code on newly attached disk _ada1p3_.\n" +#~ msgstr "If you boot from pool 'mypool', you may need to update boot code on newly attached disk _ada1p3_.\n" + +#, no-wrap +#~ msgid "Assuming you use GPT partitioning and _da0_ is your new boot disk you may use the following command:\n" +#~ msgstr "Assuming you use GPT partitioning and _da0_ is your new boot disk you may use the following command:\n" + +#, no-wrap +#~ msgid "" +#~ "errors: No known data errors\n" +#~ "# zpool status\n" +#~ " pool: mypool\n" +#~ " state: ONLINE\n" +#~ " scan: resilvered 781M in 0h0m with 0 errors on Fri May 30 08:15:58 2014\n" +#~ "config:\n" +#~ msgstr "" +#~ "errors: No known data errors\n" +#~ "# zpool status\n" +#~ " pool: mypool\n" +#~ " state: ONLINE\n" +#~ " scan: resilvered 781M in 0h0m with 0 errors on Fri May 30 08:15:58 2014\n" +#~ "config:\n" + +#, no-wrap +#~ msgid "" +#~ "# zpool status\n" +#~ " pool: mypool\n" +#~ " state: ONLINE\n" +#~ " scan: scrub repaired 0 in 0h0m with 0 errors on Fri May 30 08:29:51 2014\n" +#~ "config:\n" +#~ msgstr "" +#~ "# zpool status\n" +#~ " pool: mypool\n" +#~ " state: ONLINE\n" +#~ " scan: scrub repaired 0 in 0h0m with 0 errors on Fri May 30 08:29:51 2014\n" +#~ "config:\n" + +#~ msgid "" +#~ "To cancel a scrub operation if needed, run `zpool scrub -s _mypool_`." +#~ msgstr "" +#~ "Если возникла необходимость отменить операцию scrub, выполните `zpool " +#~ "scrub -s _mypool_`." + +#, no-wrap +#~ msgid "" +#~ " NAME STATE READ WRITE CKSUM\n" +#~ " healer ONLINE 0 0 0\n" +#~ " mirror-0 ONLINE 0 0 0\n" +#~ " ada0 ONLINE 0 0 0\n" +#~ " ada1 ONLINE 0 0 1\n" +#~ msgstr "" +#~ " NAME STATE READ WRITE CKSUM\n" +#~ " healer ONLINE 0 0 0\n" +#~ " mirror-0 ONLINE 0 0 0\n" +#~ " ada0 ONLINE 0 0 0\n" +#~ " ada1 ONLINE 0 0 1\n" + +#~ msgid "Upgrade a v28 pool to support `Feature Flags`:" +#~ msgstr "Обновление пула v28 для поддержки `Feature Flags`:" + +#, no-wrap +#~ msgid "" +#~ "# zpool status\n" +#~ " pool: mypool\n" +#~ " state: ONLINE\n" +#~ "status: The pool is formatted using a legacy on-disk format. The pool can\n" +#~ " still be used, but some features are unavailable.\n" +#~ "action: Upgrade the pool using 'zpool upgrade'. Once this is done, the\n" +#~ " pool will no longer be accessible on software that does not support feat\n" +#~ " flags.\n" +#~ " scan: none requested\n" +#~ "config:\n" +#~ msgstr "" +#~ "# zpool status\n" +#~ " pool: mypool\n" +#~ " state: ONLINE\n" +#~ "status: The pool is formatted using a legacy on-disk format. The pool can\n" +#~ " still be used, but some features are unavailable.\n" +#~ "action: Upgrade the pool using 'zpool upgrade'. Once this is done, the\n" +#~ " pool will no longer be accessible on software that does not support feat\n" +#~ " flags.\n" +#~ " scan: none requested\n" +#~ "config:\n" + +#, no-wrap +#~ msgid "" +#~ " NAME STATE READ WRITE CKSUM\n" +#~ " mypool ONLINE 0 0 0\n" +#~ " mirror-0 ONLINE 0 0 0\n" +#~ "\t ada0 ONLINE 0 0 0\n" +#~ "\t ada1 ONLINE 0 0 0\n" +#~ msgstr "" +#~ " NAME STATE READ WRITE CKSUM\n" +#~ " mypool ONLINE 0 0 0\n" +#~ " mirror-0 ONLINE 0 0 0\n" +#~ "\t ada0 ONLINE 0 0 0\n" +#~ "\t ada1 ONLINE 0 0 0\n" + +#, no-wrap +#~ msgid "" +#~ "The following pools are formatted with legacy version numbers and are upgraded to use feature flags.\n" +#~ "After being upgraded, these pools will no longer be accessible by software that does not support feature flags.\n" +#~ msgstr "" +#~ "The following pools are formatted with legacy version numbers and are upgraded to use feature flags.\n" +#~ "After being upgraded, these pools will no longer be accessible by software that does not support feature flags.\n" + +#, no-wrap +#~ msgid "" +#~ "VER POOL\n" +#~ "--- ------------\n" +#~ "28 mypool\n" +#~ msgstr "" +#~ "VER POOL\n" +#~ "--- ------------\n" +#~ "28 mypool\n" + +#, no-wrap +#~ msgid "" +#~ "Use 'zpool upgrade -v' for a list of available legacy versions.\n" +#~ "Every feature flags pool has all supported features enabled.\n" +#~ "# zpool upgrade mypool\n" +#~ "This system supports ZFS pool feature flags.\n" +#~ msgstr "" +#~ "Use 'zpool upgrade -v' for a list of available legacy versions.\n" +#~ "Every feature flags pool has all supported features enabled.\n" +#~ "# zpool upgrade mypool\n" +#~ "This system supports ZFS pool feature flags.\n" + +#, no-wrap +#~ msgid "" +#~ "Successfully upgraded 'mypool' from version 28 to feature flags.\n" +#~ "Enabled the following features on 'mypool':\n" +#~ " async_destroy\n" +#~ " empty_bpobj\n" +#~ " lz4_compress\n" +#~ " multi_vdev_crash_dump\n" +#~ msgstr "" +#~ "Successfully upgraded 'mypool' from version 28 to feature flags.\n" +#~ "Enabled the following features on 'mypool':\n" +#~ " async_destroy\n" +#~ " empty_bpobj\n" +#~ " lz4_compress\n" +#~ " multi_vdev_crash_dump\n" + +#~ msgid "" +#~ "The newer features of ZFS will not be available until `zpool upgrade` has " +#~ "completed. Use `zpool upgrade -v` to see what new features the upgrade " +#~ "provides, as well as which features are already supported." +#~ msgstr "" +#~ "Новые возможности ZFS станут доступны только после выполнения команды " +#~ "`zpool upgrade`. Используйте `zpool upgrade -v`, чтобы увидеть, какие " +#~ "новые возможности предоставляет обновление, а также какие функции уже " +#~ "поддерживаются." + +#~ msgid "Upgrade a pool to support new feature flags:" +#~ msgstr "Обновление пула для поддержки новых флагов функций:" + +#, no-wrap +#~ msgid "All pools are formatted using feature flags.\n" +#~ msgstr "All pools are formatted using feature flags.\n" + +#, no-wrap +#~ msgid "" +#~ "POOL FEATURE\n" +#~ "---------------\n" +#~ "zstore\n" +#~ " multi_vdev_crash_dump\n" +#~ " spacemap_histogram\n" +#~ " enabled_txg\n" +#~ " hole_birth\n" +#~ " extensible_dataset\n" +#~ " bookmarks\n" +#~ " filesystem_limits\n" +#~ "# zpool upgrade mypool\n" +#~ "This system supports ZFS pool feature flags.\n" +#~ msgstr "" +#~ "POOL FEATURE\n" +#~ "---------------\n" +#~ "zstore\n" +#~ " multi_vdev_crash_dump\n" +#~ " spacemap_histogram\n" +#~ " enabled_txg\n" +#~ " hole_birth\n" +#~ " extensible_dataset\n" +#~ " bookmarks\n" +#~ " filesystem_limits\n" +#~ "# zpool upgrade mypool\n" +#~ "This system supports ZFS pool feature flags.\n" + +#~ msgid "" +#~ "Two commonly used and useful dataset properties are the NFS and SMB share " +#~ "options. Setting these defines if and how ZFS shares datasets on the " +#~ "network. At present, FreeBSD supports setting NFS sharing alone. To get " +#~ "the current status of a share, enter:" +#~ msgstr "" +#~ "Два часто используемых и полезных свойства наборов данных — это параметры " +#~ "общих ресурсов NFS и SMB. Установка этих параметров определяет, будет ли " +#~ "ZFS предоставлять наборы данных в сети и как именно. В настоящее время " +#~ "FreeBSD поддерживает настройку только общего доступа NFS. Чтобы проверить " +#~ "текущее состояние общего ресурса, введите:" + +#, no-wrap +#~ msgid "# zfs set userquota@joe=50G\n" +#~ msgstr "# zfs set userquota@joe=50G\n" + +#, no-wrap +#~ msgid "# zfs set userquota@joe=none\n" +#~ msgstr "# zfs set userquota@joe=none\n" + +#~ msgid "" +#~ "To activate deduplication, set the `dedup` property on the target pool:" +#~ msgstr "" +#~ "Для активации дедупликации установите свойство `dedup` в целевой пул:" + +#~ msgid "Adjust tunables to make ZFS perform best for different workloads." +#~ msgstr "" +#~ "Настройте параметры для оптимальной производительности ZFS в различных " +#~ "рабочих нагрузках." + +#~ msgid "" +#~ "[[zfs-advanced-tuning-vdev-cache-size]] `_vfs.zfs.vdev.cache.size_` - A " +#~ "preallocated amount of memory reserved as a cache for each device in the " +#~ "pool. The total amount of memory used will be this value multiplied by " +#~ "the number of devices. Set this value at boot time and in [.filename]#/" +#~ "boot/loader.conf#." +#~ msgstr "" +#~ "[[zfs-advanced-tuning-vdev-cache-size]] `_vfs.zfs.vdev.cache.size_` - " +#~ "Предварительно выделенный объём памяти, зарезервированный в качестве кэша " +#~ "для каждого устройства в пуле. Общий объём используемой памяти будет " +#~ "равен этому значению, умноженному на количество устройств. Установите это " +#~ "значение при загрузке и в [.filename]#/boot/loader.conf#." + +#~ msgid "" +#~ "Common drives have 4 KB sectors. Using the default `ashift` of `9` with " +#~ "these drives results in write amplification on these devices. Data " +#~ "contained in a single 4 KB write is instead written in eight 512-byte " +#~ "writes. ZFS tries to read the native sector size from all devices when " +#~ "creating a pool, but drives with 4 KB sectors report that their sectors " +#~ "are 512 bytes for compatibility. Setting `vfs.zfs.min_auto_ashift` to " +#~ "`12` (`2^12 = 4096`) before creating a pool forces ZFS to use 4 KB blocks " +#~ "for best performance on these drives." +#~ msgstr "" +#~ "Обычные диски имеют секторы размером 4 КБ. Использование значения " +#~ "`ashift` по умолчанию (`9`) для таких дисков приводит к усилению записи " +#~ "на этих устройствах. Данные, которые должны быть записаны одним блоком 4 " +#~ "КБ, вместо этого записываются восемью блоками по 512 байт. ZFS пытается " +#~ "определить родной размер сектора всех устройств при создании пула, но " +#~ "диски с секторами 4 КБ сообщают, что их секторы имеют размер 512 байт для " +#~ "совместимости. Установка `vfs.zfs.min_auto_ashift` в значение `12` (`2^12 " +#~ "= 4096`) перед созданием пула заставляет ZFS использовать блоки 4 КБ для " +#~ "наилучшей производительности на таких дисках." + +#~ msgid "" +#~ "Forcing 4 KB blocks is also useful on pools with planned disk upgrades. " +#~ "Future disks use 4 KB sectors, and `ashift` values cannot change after " +#~ "creating a pool." +#~ msgstr "" +#~ "Принудительное использование блоков размером 4 КБ также полезно для пулов " +#~ "с запланированным обновлением дисков. Будущие диски используют секторы " +#~ "размером 4 КБ, а значения `ashift` нельзя изменить после создания пула." + +#~ msgid "" +#~ "In some specific cases, the smaller 512-byte block size might be " +#~ "preferable. When used with 512-byte disks for databases or as storage " +#~ "for virtual machines, less data transfers during small random reads. " +#~ "This can provide better performance when using a smaller ZFS record size." +#~ msgstr "" +#~ "В некоторых конкретных случаях меньший размер блока 512 байт может быть " +#~ "предпочтительнее. При использовании с дисками 512 байт для баз данных или " +#~ "в качестве хранилища для виртуальных машин уменьшается объём передаваемых " +#~ "данных при небольших случайных чтениях. Это может обеспечить лучшую " +#~ "производительность при использовании меньшего размера записи ZFS." + +#~ msgid "" +#~ "[[zfs-advanced-tuning-vdev-trim_on_init]] `_vfs.zfs.vdev.trim_on_init_` - " +#~ "Control whether new devices added to the pool have the `TRIM` command run " +#~ "on them. This ensures the best performance and longevity for SSDs, but " +#~ "takes extra time. If the device has already been secure erased, disabling " +#~ "this setting will make the addition of the new device faster. Adjust this " +#~ "value at any time with man:sysctl[8]." +#~ msgstr "" +#~ "[[zfs-advanced-tuning-vdev-trim_on_init]] `_vfs.zfs.vdev.trim_on_init_` — " +#~ "Управляет тем, будет ли для новых устройств, добавленных в пул, " +#~ "выполняться команда `TRIM`. Это обеспечивает наилучшую производительность " +#~ "и долговечность для SSD, но занимает дополнительное время. Если " +#~ "устройство уже было безопасно очищено, отключение этой настройки ускорит " +#~ "добавление нового устройства. Значение можно изменить в любой момент с " +#~ "помощью man:sysctl[8]." + +#~ msgid "" +#~ "[[zfs-advanced-tuning-top_maxinflight]] `_vfs.zfs.top_maxinflight_` - " +#~ "Upper number of outstanding I/Os per top-level crossref:zfs[zfs-term-vdev," +#~ "vdev]. Limits the depth of the command queue to prevent high latency. " +#~ "The limit is per top-level vdev, meaning the limit applies to each " +#~ "crossref:zfs[zfs-term-vdev-mirror,mirror], crossref:zfs[zfs-term-vdev-" +#~ "raidz,RAID-Z], or other vdev independently. Adjust this value at any time " +#~ "with man:sysctl[8]." +#~ msgstr "" +#~ "[[zfs-advanced-tuning-top_maxinflight]] `_vfs.zfs.top_maxinflight_` — " +#~ "Верхний предел количества необработанных операций ввода-вывода для " +#~ "каждого корневого crossref:zfs[zfs-term-vdev,vdev]. Ограничивает глубину " +#~ "очереди команд для предотвращения высокой задержки. Лимит применяется к " +#~ "каждому корневому vdev, то есть ограничение действует независимо для " +#~ "каждого crossref:zfs[zfs-term-vdev-mirror,зеркала], crossref:zfs[zfs-term-" +#~ "vdev-raidz,RAID-Z] или другого vdev. Значение можно изменить в любое " +#~ "время с помощью man:sysctl[8]." + +#~ msgid "" +#~ "[[zfs-advanced-tuning-scrub_delay]]`_vfs.zfs.scrub_delay_` - Number of " +#~ "ticks to delay between each I/O during a crossref:zfs[zfs-term-scrub," +#~ "`scrub`]. To ensure that a `scrub` does not interfere with the normal " +#~ "operation of the pool, if any other I/O is happening the `scrub` will " +#~ "delay between each command. This value controls the limit on the total " +#~ "IOPS (I/Os Per Second)" +#~ msgstr "" +#~ "[[zfs-advanced-tuning-scrub_delay]]`_vfs.zfs.scrub_delay_` — Количество " +#~ "тактов задержки между каждой операцией ввода-вывода во время " +#~ "перекрестного crossref:zfs[zfs-term-scrub,`scrub`]. Чтобы гарантировать, " +#~ "что `scrub` не мешает нормальной работе пула, если происходят другие " +#~ "операции ввода-вывода, `scrub` будет задерживаться между каждой командой. " +#~ "Это значение контролирует ограничение на общее количество IOPS (операций " +#~ "ввода-вывода в секунду)" + +#~ msgid "" +#~ "generated by the `scrub`. The granularity of the setting is determined by " +#~ "the value of `kern.hz` which defaults to 1000 ticks per second. Changing " +#~ "this setting results in a different effective IOPS limit. The default " +#~ "value is `4`, resulting in a limit of: 1000 ticks/sec / 4 = 250 IOPS. " +#~ "Using a value of _20_ would give a limit of: 1000 ticks/sec / 20 = 50 " +#~ "IOPS. Recent activity on the pool limits the speed of `scrub`, as " +#~ "determined by crossref:zfs[zfs-advanced-tuning-scan_idle,`vfs.zfs." +#~ "scan_idle`]. Adjust this value at any time with man:sysctl[8]." +#~ msgstr "" +#~ ", сгенерированных командой `scrub`. Гранулярность настройки определяется " +#~ "значением `kern.hz`, которое по умолчанию равно 1000 тикам в секунду. " +#~ "Изменение этого параметра приводит к изменению эффективного лимита IOPS. " +#~ "Значение по умолчанию — `4`, что даёт лимит: 1000 тиков/сек / 4 = 250 " +#~ "IOPS. Использование значения _20_ установит лимит: 1000 тиков/сек / 20 = " +#~ "50 IOPS. Недавняя активность в пуле ограничивает скорость `scrub`, как " +#~ "определено в crossref:zfs[zfs-advanced-tuning-scan_idle,`vfs.zfs." +#~ "scan_idle`]. Это значение можно изменить в любое время с помощью man:" +#~ "sysctl[8]." + +#~ msgid "" +#~ "[[zfs-advanced-tuning-resilver_delay]] `_vfs.zfs.resilver_delay_` - " +#~ "Number of milliseconds of delay inserted between each I/O during a " +#~ "crossref:zfs[zfs-term-resilver,resilver]. To ensure that a resilver does " +#~ "not interfere with the normal operation of the pool, if any other I/O is " +#~ "happening the resilver will delay between each command. This value " +#~ "controls the limit of total IOPS (I/Os Per Second) generated by the " +#~ "resilver. ZFS determins the granularity of the setting by the value of " +#~ "`kern.hz` which defaults to 1000 ticks per second. Changing this setting " +#~ "results in a different effective IOPS limit. The default value is 2, " +#~ "resulting in a limit of: 1000 ticks/sec / 2 = 500 IOPS. Returning the " +#~ "pool to an crossref:zfs[zfs-term-online,Online] state may be more " +#~ "important if another device failing could crossref:zfs[zfs-term-faulted," +#~ "Fault] the pool, causing data loss. A value of 0 will give the resilver " +#~ "operation the same priority as other operations, speeding the healing " +#~ "process. Other recent activity on the pool limits the speed of resilver, " +#~ "as determined by crossref:zfs[zfs-advanced-tuning-scan_idle,`vfs.zfs." +#~ "scan_idle`]. Adjust this value at any time with man:sysctl[8]." +#~ msgstr "" +#~ "[[zfs-advanced-tuning-resilver_delay]] `_vfs.zfs.resilver_delay_` — " +#~ "количество миллисекунд задержки, вставляемой между каждым операцией ввода-" +#~ "вывода во время crossref:zfs[zfs-term-resilver,ресильверинга]. Чтобы " +#~ "гарантировать, что ресильверинг не мешает нормальной работе пула, при " +#~ "наличии других операций ввода-вывода ресильверинг будет добавлять " +#~ "задержку между каждой командой. Данный параметр ограничивает общее " +#~ "количество IOPS (операций ввода-вывода в секунду), генерируемых " +#~ "ресильверингом. ZFS определяет гранулярность настройки через значение " +#~ "`kern.hz`, которое по умолчанию равно 1000 тикам в секунду. Изменение " +#~ "этого параметра приводит к изменению эффективного лимита IOPS. Значение " +#~ "по умолчанию — 2, что даёт лимит: 1000 тиков/сек / 2 = 500 IOPS. " +#~ "Возвращение пула в состояние crossref:zfs[zfs-term-online,Online] может " +#~ "быть более важным, если выход из строя другого устройства может перевести " +#~ "пул в состояние crossref:zfs[zfs-term-faulted,Fault], что приведёт к " +#~ "потере данных. Значение 0 даст операции ресильверинга такой же приоритет, " +#~ "как и другим операциям, ускоряя процесс восстановления. Недавняя " +#~ "активность в пуле ограничивает скорость ресильверинга, как определено в " +#~ "crossref:zfs[zfs-advanced-tuning-scan_idle,`vfs.zfs.scan_idle`]. Этот " +#~ "параметр можно изменить в любое время с помощью man:sysctl[8]." + +#~ msgid "" +#~ "[[zfs-advanced-tuning-scan_idle]] `_vfs.zfs.scan_idle_` - Number of " +#~ "milliseconds since the last operation before considering the pool is " +#~ "idle. ZFS disables the rate limiting for crossref:zfs[zfs-term-scrub," +#~ "`scrub`] and crossref:zfs[zfs-term-resilver,resilver] when the pool is " +#~ "idle. Adjust this value at any time with man:sysctl[8]." +#~ msgstr "" +#~ "[[zfs-advanced-tuning-scan_idle]] `_vfs.zfs.scan_idle_` - Количество " +#~ "миллисекунд с момента последней операции, после которого пул считается " +#~ "бездействующим. ZFS отключает ограничение скорости для crossref:zfs[zfs-" +#~ "term-scrub,`scrub`] и crossref:zfs[zfs-term-resilver,ресильверинга], " +#~ "когда пул бездействует. Это значение можно изменить в любое время с " +#~ "помощью man:sysctl[8]." + +#, no-wrap +#~ msgid "ZFS on i386" +#~ msgstr "ZFS на i386" + +#~ msgid "" +#~ "Some of the features provided by ZFS are memory intensive, and may " +#~ "require tuning for upper efficiency on systems with limited RAM." +#~ msgstr "" +#~ "Некоторые функции ZFS требуют значительных ресурсов памяти и могут " +#~ "потребовать настройки для повышения эффективности на системах с " +#~ "ограниченным объёмом ОЗУ." + +#, no-wrap +#~ msgid "Memory" +#~ msgstr "Память" + +#~ msgid "" +#~ "As a lower value, the total system memory should be at least one " +#~ "gigabyte. The amount of recommended RAM depends upon the size of the " +#~ "pool and which features ZFS uses. A general rule of thumb is 1 GB of RAM " +#~ "for every 1 TB of storage. If using the deduplication feature, a general " +#~ "rule of thumb is 5 GB of RAM per TB of storage to deduplicate. While " +#~ "some users use ZFS with less RAM, systems under heavy load may panic due " +#~ "to memory exhaustion. ZFS may require further tuning for systems with " +#~ "less than the recommended RAM requirements." +#~ msgstr "" +#~ "В качестве минимального значения общий объём оперативной памяти системы " +#~ "должен составлять не менее одного гигабайта. Рекомендуемый объём " +#~ "оперативной памяти зависит от размера пула и используемых возможностей " +#~ "ZFS. Общее правило — 1 ГБ оперативной памяти на каждый 1 ТБ дискового " +#~ "пространства. При использовании функции дедупликации рекомендуется " +#~ "выделять 5 ГБ оперативной памяти на каждый 1 ТБ хранилища. Хотя некоторые " +#~ "пользователи используют ZFS с меньшим объёмом оперативной памяти, системы " +#~ "под высокой нагрузкой могут завершаться аварийно из-за нехватки памяти. " +#~ "Для систем с объёмом оперативной памяти меньше рекомендуемого может " +#~ "потребоваться дополнительная настройка ZFS." + +#, no-wrap +#~ msgid "Kernel Configuration" +#~ msgstr "Настройка ядра" + +#~ msgid "" +#~ "Due to the address space limitations of the i386(TM) platform, ZFS users " +#~ "on the i386(TM) architecture must add this option to a custom kernel " +#~ "configuration file, rebuild the kernel, and reboot:" +#~ msgstr "" +#~ "Из-за ограничений адресного пространства платформы i386(TM), " +#~ "пользователям ZFS на архитектуре i386(TM) необходимо добавить следующую " +#~ "опцию в файл конфигурации собственного ядра, пересобрать ядро и " +#~ "перезагрузить систему:" + +#, no-wrap +#~ msgid "options KVA_PAGES=512\n" +#~ msgstr "options KVA_PAGES=512\n" + +#~ msgid "" +#~ "This expands the kernel address space, allowing the `vm.kvm_size` tunable " +#~ "to push beyond the imposed limit of 1 GB, or the limit of 2 GB for PAE. " +#~ "To find the most suitable value for this option, divide the desired " +#~ "address space in megabytes by four. In this example `512` for 2 GB." +#~ msgstr "" +#~ "Это расширяет адресное пространство ядра, позволяя настройке `vm." +#~ "kvm_size` выйти за установленный предел в 1 ГБ или предел в 2 ГБ для PAE. " +#~ "Чтобы найти наиболее подходящее значение для этой опции, разделите " +#~ "желаемое адресное пространство в мегабайтах на четыре. В данном примере " +#~ "`512` для 2 ГБ." + +#, no-wrap +#~ msgid "Loader Tunables" +#~ msgstr "Настройки загрузчика" + +#~ msgid "" +#~ "Increases the [.filename]#kmem# address space on all FreeBSD " +#~ "architectures. A test system with 1 GB of physical memory benefitted " +#~ "from adding these options to [.filename]#/boot/loader.conf# and then " +#~ "restarting:" +#~ msgstr "" +#~ "Увеличивает адресное пространство `kmem` на всех архитектурах FreeBSD. " +#~ "Тестовая система с 1 ГБ физической памяти показала улучшение после " +#~ "добавления этих параметров в `/boot/loader.conf` и последующей " +#~ "перезагрузки:" + +#, no-wrap +#~ msgid "" +#~ "vm.kmem_size=\"330M\"\n" +#~ "vm.kmem_size_max=\"330M\"\n" +#~ "vfs.zfs.arc.max=\"40M\"\n" +#~ "vfs.zfs.vdev.cache.size=\"5M\"\n" +#~ msgstr "" +#~ "vm.kmem_size=\"330M\"\n" +#~ "vm.kmem_size_max=\"330M\"\n" +#~ "vfs.zfs.arc.max=\"40M\"\n" +#~ "vfs.zfs.vdev.cache.size=\"5M\"\n" + +#~ msgid "" +#~ "For a more detailed list of recommendations for ZFS-related tuning, see " +#~ "https://wiki.freebsd.org/ZFSTuningGuide[]." +#~ msgstr "" +#~ "Для более подробного списка рекомендаций по настройке ZFS см. https://" +#~ "wiki.freebsd.org/ZFSTuningGuide[]." + +#~ msgid "https://wiki.freebsd.org/ZFSTuningGuide[FreeBSD Wiki - ZFS Tuning]" +#~ msgstr "" +#~ "https://wiki.freebsd.org/ZFSTuningGuide[FreeBSD Wiki - Настройка ZFS]" + +#~ msgid "" +#~ "https://calomel.org/zfs_raid_speed_capacity.html[Calomel Blog - ZFS Raidz " +#~ "Performance, Capacity and Integrity]" +#~ msgstr "" +#~ "https://calomel.org/zfs_raid_speed_capacity.html[Calomel Blog - ZFS Raidz " +#~ "Performance, Capacity and Integrity]" + +#, no-wrap +#~ msgid "When replacing a failed disk, ZFS must fill the new disk with the lost data. _Resilvering_ is the process of using the parity information distributed across the remaining drives to calculate and write the missing data to the new drive." +#~ msgstr "При замене вышедшего из строя диска ZFS необходимо заполнить новый диск утерянными данными. _Ресильверинг_ (resilvering — серебрение, восстановление зеркала) — это процесс использования информации о чётности, распределённой по оставшимся дискам, для вычисления и записи отсутствующих данных на новый диск." + #, no-wrap #~ msgid "# gpart bootcode -p /boot/boot1.efi -i 1 ada1\n" #~ msgstr "# gpart bootcode -p /boot/boot1.efi -i 1 ada1\n"