Provided by: guestfs-tools_1.52.2-2ubuntu1_amd64 
НАЗВА
virt-resize — програма для зміни розмірів дисків віртуальної машини
КОРОТКИЙ ОПИС
virt-resize [--resize /dev/sdaN=[+/-]<розмір>[%]]
[--expand /dev/sdaN] [--shrink /dev/sdaN]
[--ignore /dev/sdaN] [--delete /dev/sdaN] [...] вхідний_диск вихідний_диск
ОПИС
Virt-resize — програма, за допомогою якої можна змінити розміри диска віртуальної машини,
зробивши його більшим або меншим чи змінивши розміри розділів, які містяться на диску, або
вилучивши їх.
Virt-resize не може змінювати розмір образів дисків «на місці». Virt-resize не слід
використовувати для активних віртуальних машин — щоб отримати належний результат, перш ніж
змінювати розміри дисків, зупиніть роботу віртуальної машини.
Якщо ви ще не знайомі з принципами роботи пов'язаних інструментів, virt-filesystems(1) і
virt-df(1), рекомендуємо вам спершу ознайомитися із документацією щодо цих інструментів.
ПРИКЛАДИ
1. У цьому прикладі ми візьмемо "старий_диск", змінимо його розміри і запишемо як
"новий_диск", розширивши один із розділів гостьової системи на додаткові 5 ГБ:
virt-filesystems --long -h --all -a старий_диск
truncate -r старий_диск новий_диск
truncate -s +5G новий_диск
# Зауважте, що «/dev/sda2» є розділом у у файлі «старий_диск».
virt-resize --expand /dev/sda2 старий_диск новий_диск
2. Те саме, що і вище, але зі збільшенням розділу /boot на 200 МБ, з наданням решти місця
для /dev/sda2:
virt-resize --resize /dev/sda1=+200M --expand /dev/sda2 \
старий_диск новий_диск
3. Як у першому прикладі, але із розширенням логічного тому на останньому кроці. Саме цю
команду типово використовують для гостьових систем Linux, де використовується LVM:
virt-resize --expand /dev/sda2 --LV-expand /dev/vg_guest/lv_root \
старий_диск новий_диск
4. Як у першому прикладі, але дані буде виведено у форматі qcow2, а не у простому (raw)
форматі:
qemu-img create -f qcow2 -o preallocation=metadata newdisk.qcow2 15G
virt-resize --expand /dev/sda2 olddisk newdisk.qcow2
ДОКЛАДНІШЕ ЩОДО ВИКОРИСТАННЯ
РОЗШИРЕННЯ ДИСКА ВІРТУАЛЬНОЇ МАШИНИ
1. Припиніть роботу віртуальної машини
2. Встановіть розташування образу диска із вхідними даними
Встановіть розташування образу диска із вхідними даними (тобто файла або пристрою у
основній системі, де містяться дані диска гостьової системи). Якщо гостьовою системою
керує libvirt, ви можете скористатися для визначення назви образу диска командою
"virsh dumpxml", ось так:
# virsh dumpxml guestname | xpath /domain/devices/disk/source
Знайдено 1 вузли:
-- NODE --
<source dev="/dev/vg/lv_guest" />
3. Визначте поточні розміри
Скористайтеся програмою virt-filesystems(1) для перегляду списку поточних розділів і
їхніх розмірів:
# virt-filesystems --long --parts --blkdevs -h -a /dev/vg/lv_guest
Name Type Size Parent
/dev/sda1 partition 101M /dev/sda
/dev/sda2 partition 7.9G /dev/sda
/dev/sda device 8.0G -
(У цьому прикладі маємо справу з віртуальною машиною з диском у 8 ГБ, який ми хочемо
розширити до 10 ГБ).
4. Створіть диск для виведення даних
Virt-resize не може виконувати внесення змін до дисків «на місці». У вашій системі має
бути достатньо місця для зберігання диска-результату зі зміненим розміром.
Для збереження образу диска зі зміненим розміром створіть файл відповідного розміру:
# rm -f outdisk
# truncate -s 10G outdisk
Або скористайтеся lvcreate(1) для створення логічного тому:
# lvcreate -L 10G -n lv_name vg_name
Або скористайтеся virsh(1) vol-create-as для створення тому сховища даних libvirt:
# virsh pool-list
# virsh vol-create-as poolname newvol 10G
5. Зміна розміру
virt-resize має отримати два обов'язкових параметри, назву диска із вхідними даними і
назву диска із вихідними даними (обидві можуть бути, наприклад, пристроями, файлами
або адресами на віддаленому диску). Диском з виведеними даними має бути диск,
створений на попередньому кроці.
# virt-resize indisk outdisk
Ця команда просто копіює образ диска "indisk" до образу диска "outdisk" без зміни
розмірів або будь-яких змін у наявних розділах. Якщо диск "outdisk" є завеликим для
даних, створюється додатковий порожній розділ наприкінці диска, розмір якого
відповідатиме зайвому місцю. Якщо диск "outdisk" виявиться замалим, програма
повідомить про помилку.
Реалістичнішим буде варіант, коли вам потрібно розширити наявні розділи на образі
диска передаванням додаткових параметрів (повний список параметрів наведено у розділі
"ПАРАМЕТРИ" нижче).
"--expand" є найкориснішим параметром. За його допомогою можна розширити вказаний за
назвою розділ на диску так, щоб він зайняв усе зайве місце:
# virt-resize --expand /dev/sda2 indisk outdisk
(У цьому випадку наприкінці диска не створюватиметься додаткових розділів, оскільки
невикористаного місця просто не буде).
"--resize" — ще один широковживаний параметр. Наступна команда збільшить розмір
/dev/sda1 на 200 МБ і розширить /dev/sda2 так, щоб той заповнив решту доступного
місця:
# virt-resize --resize /dev/sda1=+200M --expand /dev/sda2 \
indisk outdisk
Якщо на розширюваному розділі у образі міститься файлова система або фізичний том LVM,
тоді, якщо virt-resize відомий спосіб, програма змінить розміри вмісту так, як це
роблять виклики команд pvresize(8), resize2fs(8), ntfsresize(8), btrfs(8),
xfs_growfs(8) або resize.f2fs(8). Втім, virt-resize не відомі способи зміни розмірів
деяких файлових систем, тому вам доведеться якось змінювати їхні розміри після
завантаження гостьової системи.
# virt-resize --expand /dev/sda2 nbd://example.com outdisk
Диском із вхідними даними може бути адреса, якщо як джерело слід використати
віддалений диск. Формат адреси є сумісним із guestfish. Див. "ДОДАВАННЯ ВІДДАЛЕНОГО
СХОВИЩА" in guestfish(1).
Інші параметри описано нижче.
6. Перевірка
Виконайте належне тестування нового образу диска, перш ніж витирати старий.
Якщо ви користуєтеся libvirt, внесіть зміни до XML так, щоб він вказував на новий
диск:
# virsh edit назва_гостьової_системи
Змініть <source ...>, див. http://libvirt.org/formatdomain.html#elementsDisks
Далі, запустіть домен з новим диском, розмір якого було змінено:
# virsh start назва_гостьової_системи
і перевірте, чи все лишається працездатним. Див. також додаткові зауваження у розділі
"ПРИМІТКИ" нижче.
7. Зміна розмірів логічних томів та інших сховищ у гостьовій системі
(Це завдання можна виконати без завантаження гостьової системи за допомогою
guestfish(1))
Після завантаження гостьової системи у ній має з'явитися вільне місце, принаймні для
файлових систем, способи зміни розмірів яких відомі virt-resize, та фізичних томів.
Користувачеві, ймовірно, слід буде змінити логічні томи у фізичних томах, а також
змінити розміри типів файлових систем, способи розширення яких не відомі virt-resize.
ЗМЕНШЕННЯ РОЗМІРІВ ДИСКА ВІРТУАЛЬНОЇ МАШИНИ
Зменшення розмірів є дещо складнішим завданням за збільшення. У цьому розділі наведено
лише загальний огляд.
По-перше, virt-resize не робитиме спроб стиснути будь-який вміст розділу (фізичні томи,
файлові системи). Користувачеві слід подбати про зменшення розмірів вмісту до передавання
диска на обробку до virt-resize, і virt-resize перевірить, чи було стиснено вміст належним
чином.
(Зменшення розмірів також можна виконати без завантаження системи за допомогою
guestfish(1))
Після стискання фізичних томів і файлових систем, вимкніть гостьову систему і виконайте
описані вище кроки 3 і 4 для розміщення нового образу диска.
Потім запустіть virt-resize із відповідними параметрами --shrink і/або --resize.
ІГНОРУВАННЯ І ВИЛУЧЕННЯ РОЗДІЛІВ
Крім того, virt-resize надає вам зручний спосіб ігнорувати або вилучати розділи при
копіюванні з диска вхідних даних на диск вихідних даних. Ігнорування розділу пришвидшує
копіювання там, де вам все одно що станеться із наявним вмістом розділу. Вилучення розділу
вилучає його повністю, але зауважте, що це також призводить до перенумерування усіх
розділів після вилучено, що може призвести до неможливості завантаження деяких гостьових
систем.
QCOW2 І НЕРОЗРІДЖЕНІ ФОРМАТИ RAW
Якщо дисх вхідних даних записано у форматі qcow2, ймовірно, варто записати вихідні дані
теж у форматі qcow2. Крім того, virt-resize може перетворювати дані з одного формату на
інший «на льоту». Формат виведених даних просто визначається форматом порожнього
контейнера для виведення даних, який ви надасте. Таким чином, щоб записати виведені дані у
форматі qcow2, скористайтеся такою командою:
qemu-img create -f qcow2 -o preallocation=metadata outdisk [розмір]
замість команди truncate.
Так само, щоб отримати дані у нерозрідженому простому форматі (raw) скористайтеся такою
командою:
fallocate -l розмір вихідний_диск
(у застарілих системах, де немає команди fallocate(1), скористайтеся командою "dd
if=/dev/zero of=outdisk bs=1M count=..")
ЛОГІЧНІ РОЗДІЛИ
Розміри логічних розділів (тобто /dev/sda5+ на дисках із таблицею розділів DOS) не може
бути змінено.
Щоб розібратися у тому, що відбувається, по-перше, слід пам'ятати, що один із чотирьох
розділів /dev/sda1-4 матиме тип розділу MBR 05 або "0f". Такий розділ називається
розширеним розділом. Для перегляду типу розділу MBR скористайтеся virt-filesystems(1).
Логічні розділи містяться у розширеному розділі.
Розширений розділ може бути збільшено, але не може бути зменшено (це можна зробити у
примусовому режимі, але ми не радимо так робити). При копіюванні розширеного розділу
неявним чином копіюються усі логічні розділи, які на ньому містяться. Virt-resize не
зазирає до розширеного розділу, отже сліпо копіює логічні розділи.
Вказати логічний розділ (/dev/sda5+) у рядку команди не можна. Якщо ви це зробите,
програма повідомить про помилку.
ПАРАМЕТРИ
--help
Показати довідкове повідомлення.
--align-first auto
--align-first never
--align-first always
Вирівняти перший розділ, щоб підвищити швидкодію (див. параметр --alignment).
Типовою поведінкою є використання параметра --align-first auto, який вирівнює лише
перший розділ, якщо це безпечно робити. Тобто, лише якщо програмі достеменно відомо,
як виправити завантажувач автоматично, і, у поточній версії, лише для гостьових систем
Windows.
--align-first never означає, що пересування першого розділу ніколи не відбуватиметься.
Це найбезпечніший варіант. Скористайтеся ним, якщо після зміни розмірів гостьова
система відмовляється завантажуватися.
--align-first always означає, що завжди відбуватиметься вирівнювання першого розділу
(якщо його треба вирівнювати). Для деяких гостьових систем це може завадити роботи
завантажувача, зробивши гостьову систему непридатною до завантаження.
--alignment N
Встановити вирівнювання розділів на межу "N" секторів. Типовою у virt-resize < 1.13.19
було межа у 64 сектори. Після цієї версії типове значення було змінено на 128
секторів.
Якщо припускати розмір сектора у гостьовій системі у 512 байтів, ось придатні значення
для цього параметра:
--alignment 1 (512 байтів)
Розділи буде розташовано поруч один із одним якомога ближче, але буде не
вирівняно. У деяких випадках це може призвести до жахливої втрати швидкодії.
Докладніший опис можна знайти на сторінці підручника щодо virt-alignment-scan(1).
--alignment 8 (4K)
Це мінімальне прийнятне вирівнювання для придатного значення швидкодії на сучасних
основних системах.
--alignment 128 (64K)
Таке вирівнювання надасть змогу скористатися непоганою швидкодією, якщо основна
система зберігається на високоякісних носіях для мережі.
--alignment 2048 (1M)
Це стандартне вирівнювання, яке використовується в усіх нововстановлених гостьових
системах з приблизно 2008 року.
--colors
--colours
Використовувати послідовності символів ANSI для розфарбовування повідомлень. Ці
послідовності типово використовуються, якщо дані виводяться на термінал tty. Якщо
дані, виведені програмою, спрямовуються до файла, послідовності визначення кольорів
ANSI буде вимкнено, якщо ви не додасте до команди цей параметр.
-d
--debug
(Застарілий: використовуйте замість нього -v)
Увімкнути показ діагностичних повідомлень.
--delete РОЗДІЛ
Вилучити вказаний за назвою розділ. Точнішим визначенням цієї дії буде «не копіювати»,
оскільки virt-resize не вносить зміни до початкового образу диска.
Зауважте, що коли ви вилучаєте розділ, вилучаються і усі дані, які зберігалися на
ньому. Більше того, у результаті усі розділи за вилученим перенумеровуються, що може
призвести до неможливості завантаження гостьової системи.
Цей параметр можна вказувати декілька разів.
--expand РОЗДІЛ
Розширити вказаний за назвою розділ так, щоб він зайняв усе вільне місце (місце, яке
лишатиметься вільним після усіх інших вказаних вами змін у розмірах).
Якщо virt-resize відомий спосіб, програма розширить безпосередній вміст розділу.
Наприклад, якщо розділ є фізичним томом LVM, програма розширить фізичний том так, щоб
він зайняв усе місце (подібно до виклику pvresize(8)). Якщо спосіб розширення
виявиться невідомим virt-resize, програма не чіпатиме вмісту розділу.
У поточній версії virt-resize може змінювати розміри таких файлових систем:
• Файлових систем ext2, ext3 і ext4.
• Файлових систем NTFS, якщо libguestfs було зібрано з підтримкою NTFS.
Роботу файлової системи під час її останнього використання має бути завершено у
штатному режимі. Крім того, ntfsresize(8) позначає файлові системи зі зміненими
розмірами як такі, що потребують перевірки, отже під час першого наступного
запуску Windows на розділі зі зміненим розміром буде виконано перевірку диска.
• Фізичні томи LVM. Зазвичай, virt-resize не змінює розміри вмісту фізичних томів,
втім, див. параметр --LV-expand. Користувач також може змінити розміри логічних
томів бажаним чином після завантаження системи.
• Файлові системи btrfs, якщо libguestfs було зібрано із підтримкою btrfs.
• Файлові системи XFS, якщо libguestfs було зібрано із підтримкою XFS.
• Розділи резервної пам'яті на диску Linux.
Будь ласка, зауважте, що libguestfs знищує наявний вміст розділу резервної пам'яті
на диску, відтворюючи його за допомогою "mkswap", тому такі розділи не слід
використовувати, якщо гостьова система присипляється.
• Файлові системи f2fs, якщо libguestfs було зібрано із підтримкою f2fs.
Зауважте, що параметри --expand і --shrink не можна використовувати у одній і тій
самій команді.
--format raw
Вказати формат образу диска вхідних даних. Якщо цей прапорець не вказано, його буде
автоматично визначено на основі даних самого образу.
Якщо ви працюєте із образами дисків гостьових систем у форматі raw із ненадійних
джерел, вам слід завжди вказувати назву формату.
Зауважте, що цей параметр не впливає на формат виведених даних. Див. "QCOW2 І
НЕРОЗРІДЖЕНІ ФОРМАТИ RAW".
--ignore РОЗДІЛ
Ігнорувати вказаний за назвою розділ. По суті, це означає, що розділ розміщується на
диску призначення, але його вміст з початкового диска не копіюється. Розділ
лишатиметься порожнім (заповненим нулями).
Цей параметр можна вказувати декілька разів.
--LV-expand ЛОГІЧНИЙ_ТОМ
Цій команді передається логічний том і, як останній крок, вона розширює цей том так,
щоб він зайняв усе вільне місце, яке доступне у групі томів. Типовим використанням,
якщо припускати, що ви працюєте із гостьовою системою Linux із єдиним фізичним томом
PV /dev/sda2 і кореневим пристроєм із назвою /dev/vg_guest/lv_root, є:
virt-resize indisk outdisk \
--expand /dev/sda2 --LV-expand /dev/vg_guest/lv_root
Ця команда спершу розширить розділ (і фізичний том), а потім розширить кореневий
пристрій так, що він займе усе наявне зайве місце на фізичному томі.
Розмір вмісту логічного тому також буде змінено, якщо virt-resize відомий спосіб, як
це зробити. Ви можете заборонити virt-resize змінювати розміри вмісту за допомогою
параметра --no-expand-content.
Скористайтеся virt-filesystems(1) для отримання списку файлових систем у гостьовій
системі.
Ви можете вказати у одній команді цей параметр декілька разів, але сенсу у цьому
небагато, хіба що вказані вами логічні томи належать до різних груп томів.
--machine-readable
--machine-readable=формат
За допомогою цього параметра можна зробити виведені дані придатнішими для обробки
комп'ютером, якщо для цієї обробки використовуються інші програми. Див. "ПРИДАТНЕ ДО
ЧИТАННЯ КОМП'ЮТЕРОМ ВИВЕДЕННЯ" нижче.
-n
--dry-run
Вивести резюме щодо дій, але не виконувати ці дії.
--no-copy-boot-loader
Типово, virt-resize копіює деякі сектори на початку диска (аж до початку першого
розділу). Найчастіше, у цих секторах міститься Master Boot Record (MBR) та
завантажувач. Вони потрібні для того, щоб гостьова система завантажувалася належним
чином.
Якщо ви вкажете цей прапорець, це початкове копіювання не виконуватиметься. У цьому
випадку може виникнути потреба у перевстановленні завантажувача.
--no-extra-partition
Типово, virt-resize створює додатковий розділ, якщо буде виявлено зайве невикористане
місце після усіх змін розмірів. Скористайтеся цим параметром для того, щоб запобігти
створенню цього додаткового розділу. Якщо ви так зробите, зайве місце буде
недоступним, аж доки ви не запустите fdisk, parted або якийсь інший інструмент поділу
на розділи у гостьовій системі.
Зауважте, що якщо зайвого місця виявиться менше за 10 МБ, додатковий розділ не
створюватиметься.
--no-expand-content
Типово, virt-resize намагатиметься розширити безпосередній вміст розділів, якщо
програмі відомий спосіб виконати таке розширення (див. параметр --expand вище).
Якщо ви вкажете параметр --no-expand-content, virt-resize не виконуватиме таких спроб.
--no-sparse
Вимкнути розріджене копіювання. Див. "РОЗРІДЖЕНЕ КОПІЮВАННЯ" нижче.
--ntfsresize-force
Передавання параметра --force до ntfsresize(8) уможливить зміну розмірів, навіть якщо
диск NTFS буде позначено як такий, що потребує перевірки коректності. Вам доведеться
скористатися цим параметром, якщо ви хочете змінити розміри гостьової системи Windows
без потреби у завантаженні Windows кожного разу між командами зміни розмірів.
--output-format raw
Визначає формат виведеного образу диска. Якщо цей прапорець не вказано, формат буде
автоматично визначено на основі даних щодо образу диска.
Якщо ви працюєте із образами дисків гостьових систем у форматі raw із ненадійних
джерел, вам слід завжди вказувати назву формату.
Зауважте, що цей параметр не створює образ диска у визначеному форматі. Цей параметр
призначено лише для того, щоб libguestfs не намагалася вгадати формат. Створити диск у
належному форматі маєте ви самі. Див. "QCOW2 І НЕРОЗРІДЖЕНІ ФОРМАТИ RAW".
-q
--quiet
Не виводити резюме.
--resize РОЗДІЛ=РОЗМІР
Змінити розмір вказаного за назвою розділу (розширити або стиснути його) так, щоб він
мав вказаний розмір.
"РОЗМІР" можна вказати як значення за модулем із додаванням суфікса b/K/M/G на
позначення байтів, кілобайтів, мегабайтів або гігабайтів, або як відсоток від
поточного розміру, або як відносну частку. Приклад:
--resize /dev/sda2=10G
--resize /dev/sda4=90%
--resize /dev/sda2=+1G
--resize /dev/sda2=-200M
--resize /dev/sda1=+128K
--resize /dev/sda1=+10%
--resize /dev/sda1=-10%
Ви можете збільшити розмір будь-якого розділу. Virt-resize розширить безпосередній
вміст розділу, якщо програмі відомий спосіб виконати таке розширення (див. --expand
вище).
Зменшити розмір розділів, які містять файлові системи або фізичні томи, можна лише
якщо ці файлові системи або фізичні томи вже зменшено у розмірах всередині розділу.
Virt-resize виконає перевірку виконання цієї умови до того, як розпочне обробку даних.
Якщо умову не виконано, програма повідомить про помилку (див. також --resize-force).
Цей параметр можна вказувати декілька разів.
--resize-force РОЗДІЛ=РОЗМІР
Це те саме, що і --resize, але із можливістю зменшувати розміри будь-яких розділів.
Загалом, це означає, що ви можете втратити якісь дані, які зберігалися наприкінці
зменшуваного розділу, але, можливо, ви цим не переймаєтеся (наприклад, якщо зменшуєте
розмір невикористаного розділу або можете легко відтворити вміст розділу, зокрема
розділу резервної пам'яті на диску).
Див. також опис параметра --ignore.
--shrink РОЗДІЛ
Зменшити вказаний за назвою розділ у розмірах так, щоб увесь образ диска вмістився у
образ призначення. Вказаний за назвою розділ має містити файлову систему або фізичний
том, які вже було зменшено у розмірах за допомогою іншого засобу (наприклад
guestfish(1) або інших програм). Virt-resize виконає перевірку виконання цієї умови і
повідомить про помилку, якщо попереднього зменшення файлової системи або фізичного
тому не виконано.
Об'єм, на який має бути зменшено увесь диск (після виконання усіх інших дій, вказаних
користувачем), називається «дефіцитом». Наприклад, просте копіювання (якщо не
виконується жодних інших дій) з образу диска у 5 ГБ на образ диска у 4 ГБ дає дефіцит
у 1 ГБ. У цьому випадку virt-resize повідомить про помилку, якщо користувач не вказав
такий розділ для стискання, на якому є понад гігабайт вільного місця.
Зауважте, що параметри --expand і --shrink не можна використовувати у одній і тій
самій команді.
--unknown-filesystems ignore
--unknown-filesystems warn
--unknown-filesystems error
Налаштувати поведінку virt-resize, якщо програмі надійшла команда розширити файлову
систему, а у libguestfs не передбачено її підтримки і virt-resize не знає способу, як
розширити вміст файлової системи.
Використання параметра --unknown-filesystems ignore призведе до того, що virt-resize
без додаткових повідомлень ігноруватиме такі файлові системи і нічого не виводитиме
щодо них.
Використання параметра --unknown-filesystems warn (типове поведінка) призводитиме до
того, що virt-resize попереджатиме про кожну файлову систему, яку не може бути
розширено, але продовжуватиме зміну розмірів розділів на диску.
Використання параметра --unknown-filesystems error призведе до того, що virt-resize
повідомлятиме про помилку, якщо виявить файлову систему, розміри якої не можна
збільшити.
Див. також "unknown/unavailable method for expanding the TYPE filesystem on
DEVICE/LV".
-v
--verbose
Увімкнути показ діагностичних повідомлень.
-V
--version
Показати дані щодо версії і завершити роботу.
--wrap
Wrap error, warning, and informative messages. This is the default when the output is
a tty. If the output of the program is redirected to a file, wrapping is disabled
unless you use this option.
-x Увімкнути трасування викликів програмного інтерфейсу libguestfs.
ПРИДАТНЕ ДО ЧИТАННЯ КОМП'ЮТЕРОМ ВИВЕДЕННЯ
Для виведення даних у зручному для машинної обробки форматі можна скористатися параметром
--machine-readable. Додавання цього параметра робить зручним використання virt-resize з
інших програм, графічних інтерфейсів тощо.
Існує два способи використання цього параметра.
По-перше, можна скористатися ним без інших параметрів для того, щоб дізнатися про
можливості виконуваного файла virt-resize. Типові виведені дані виглядатимуть так:
$ virt-resize --machine-readable
virt-resize
ntfsresize-force
32bitok
ntfs
btrfs
Виводиться список можливостей, по одній на рядок, і програма завершує роботу зі станом 0.
По-друге, можна скористатися цим параметром у поєднанні із іншими параметрами для того,
щоб зробити звичайні виведені програмою дані придатнішими для подальшої машинної обробки.
У поточній версії це означає таке:
1. Повідомлення смужки поступу можна обробляти зі стандартного виведення, шукаючи їх за
таким формальним виразом:
^[0-9]+/[0-9]+$
2. Програма, яка надсилає виклик, має обробляти повідомлення, надіслані до стандартного
виведення, (окрім повідомлень смужки поступу) як повідомлення щодо стану. Ці
повідомлення може бути записано до журналу і/або показано користувачеві.
3. Програма, яка надсилає виклик, має обробляти повідомлення, надіслані до stderr як
повідомлення про помилки. Крім того, virt-resize завершує роботу із ненульовим кодом
стану, якщо станеться критична помилка.
У версіях програми до 1.13.9 не передбачено використання параметра --machine-readable.
Якщо цей параметр буде використано для такої версії, програма поверне повідомлення про
помилку.
Можна вказати рядок форматування для керування виведенням, див. "РОЗШИРЕНЕ ПРИДАТНЕ ДО
ЧИТАННЯ КОМП'ЮТЕРОМ ВИВЕДЕННЯ" in guestfs(3).
ПРИМІТКИ
«Розділ 1 не закінчується на межі циліндра.»
Virt-resize вирівнює розділи на позиції, кратні до 128 секторів (див. параметр
--alignment). Зазвичай, це означає, що розділи не буде вирівняно за давньою геометрією CHS
(циліндр-голівка-сектор). Втім, геометрія CHS не має сенсу для дисків, які вироблено після
ранніх 1990-х, і зовсім не має сенсу для віртуальних жорстких дисків. Вирівнювання
розділів за циліндрами не є вимогою жодної сучасної операційної системи.
ЗАВАНТАЖЕННЯ ГОСТЬОВОЇ СИСТЕМИ ЗУПИНЯЄТЬСЯ НА «GRUB»
Якщо гостьова система Linux не завантажується після зміни розміру, і завантаження
зупиняється після виведення слова "GRUB" до консолі, спробуйте перевстановити grub.
guestfish -i -a newdisk
><fs> cat /boot/grub/device.map
# check the contents of this file are sensible or
# edit the file if necessary
><fs> grub-install / /dev/vda
><fs> exit
Для гнучкішого переналаштовування гостьової системи, зокрема випадків, коли вам потрібно
вказати інші параметри grub-install, скористайтеся virt-rescue(1).
ЗМІНА РОЗМІРІВ ЗАВАНТАЖУВАЛЬНИХ РОЗДІЛІВ WINDOWS
У Windows Vista і новіших версіях компанія Microsoft перейшла до використання окремого
розділу завантаження. У віртуальних машинах із цими операційними системами, типово,
/dev/sda1 є розділом завантаження, а /dev/sda2 є основним диском (C:). Зміна розмірів
першого розділу (розділу завантаження) спричиняє помилку завантажувача 0xC0000225. Зміна
розмірів другого розділу (тобто диска C:) має працювати.
WINDOWS CHKDSK
Диск Windows, на якому використовується NTFS, має бути коректним, перш ніж virt-resize
зможе ним скористатися. Якщо спроба виконати дію ntfsresize завершиться повідомленням про
помилку, спробуйте завантажити початкову віртуальну машину і запустіть "chkdsk /f" для
усіх розділів NTFS, потім завершіть роботу віртуальної машини у штатний спосіб. Докладнішу
інформацію наведено тут: https://bugzilla.redhat.com/show_bug.cgi?id=975753
Після зміни розмірів Windows може ініціювати тривалу обробку chkdsk при першому
завантаженні, якщо було розширено розділи NTFS. Це усього лише для забезпечення надійного
зберігання даних, і (якщо не буде знайдено помилок) ви можете бути спокійні.
СИНІЙ ЕКРАН СМЕРТІ UNMOUNTABLE_BOOT_VOLUME У WINDOWS
Після приготування системи гостьової операційної системи Windows із наступною зміною її
розміру за допомогою virt-resize ви можете отримати непридатну до завантаження систему,
яка показуватиме синій екран смерті із помилкою "UNMOUNTABLE_BOOT_VOLUME". Цю помилку
спричинено наявністю рядка "ExtendOemPartition=1" у файлі sysprep.inf. Якщо вилучити цей
рядок до обробки sysprep, проблема зникає.
WINDOWS 8
«Швидкий запуск» Windows 8 може заважати virt-resize змінювати розмір розділів NTFS. Див.
"ПРИСИПЛЯННЯ WINDOWS ТА ШВИДКИЙ ЗАПУСК WINDOWS 8" in guestfs(3).
РОЗРІДЖЕНЕ КОПІЮВАННЯ
Вам слід створити новий, заповнений нулями образ диска призначення, який використовуватиме
virt-resize.
Virt-resize типово виконує розріджене копіювання. Це означає, що програма не копіює ті
блоки з початкового диска, які заповнено лише нулями. Це підвищує швидкість та
ефективність роботи, але може призвести до некоректних результатів, якщо на образі диска
призначення є незанулені дані.
В основному, така проблема виникає, якщо образом призначення є розділ основної системи
(наприклад, "virt-resize source.img /dev/sda4"), оскільки звичайні інструменти поділу
диска на розділи лишають недоторканними усі дані, які раніше зберігалися на диску.
Якщо ви змушені використатися образ призначення, на якому вже зберігалися дані, вам слід
скористатися параметром --no-sparse. Зауважте, що це значно уповільнить роботу програми.
"unknown/unavailable method for expanding the TYPE filesystem on DEVICE/LV"
Virt-resize було наказано розширити розділ або логічний том, на якому міститься файлова
система типу "TYPE", але програмі недоступний або невідомий спосіб розширення цієї
файлової системи.
Причиною може бути будь-що із наведеного нижче:
1. Відповідна файлова система недоступна у libguestfs, оскільки у основній системі немає
належного пакунка із інструментами для роботи з цією файловою системою. Таке,
зазвичай, трапляється із файловими системами "btrfs", "ntfs", "xfs" та "f2fs".
Спробуйте такі команди:
virt-resize --machine-readable
guestfish -a /dev/null run : available
guestfish -a /dev/null run : filesystem_available TYPE
У цьому випадку достатньо встановити належні пакунки із підтримкою файлових систем.
Наприклад, достатньо встановити "libguestfs-xfs" у Red Hat Enterprise Linux, CentOS,
Debian, Ubuntu та дистрибутивах, які від них походять, щоб можна було працювати із
файловою системою "xfs".
2. У virt-resize не передбачено підтримки розширення цього типу файлових систем.
У цьому випадку нічого не поробиш: virt-resize не зможе розширити файлову систему
цього типу.
In both cases, virt-resize will not expand the mentioned filesystem; the result (unless
--unknown-filesystems error is specified) is that the partitions containing such
filesystems will be actually bigger as requested, but the filesystems will still be usable
at their older sizes.
АЛЬТЕРНАТИВНІ ІНСТРУМЕНТИ
Існує декілька пропрієтарних інструментів для зміни розмірів розділів. Тут ми не будемо
згадувати назви жодного з таких інструментів.
parted(8) і її графічний інтерфейс, gparted, можуть виконувати певні типи дій із зміни
розміру образів дисків. Ці програми можуть змінювати розмір і пересувати розділи, але не
слід вважати, що вони можуть виконувати будь-які дії із вмістом розділів, і, звичайно ж,
вони не можуть працювати з LVM.
guestfish(1) може виконувати усі ті дії, які може виконувати virt-resize, і набагато
більше, але на суттєво нижчому рівні. Ймовірно, вам доведеться вручну обчислювати відступи
у секторах, робити те, що за означенням має робити virt-resize. Якщо хочете дізнатися, які
команди у guestfish запускає virt-resize, скористайтеся параметром --debug.
До складу dracut(8) включено модуль із назвою "dracut-modules-growroot", яким можна
скористатися для збільшення розмірів кореневого розділу під час першого завантаження
гостьової системи. Документацію з цього модуля наведено у пов'язаному із ним файлі README.
СТАН ВИХОДУ
Ця програма повертає значення 0 у разі успішного завершення і ненульове значення, якщо
сталася помилка.
ТАКОЖ ПЕРЕГЛЯНЬТЕ
virt-filesystems(1), virt-df(1), guestfs(3), guestfish(1), lvm(8), pvresize(8),
lvresize(8), resize2fs(8), ntfsresize(8), btrfs(8), xfs_growfs(8), resize.f2fs(8),
virsh(1), parted(8), truncate(1), fallocate(1), grub(8), grub-install(8), virt-rescue(1),
virt-sparsify(1), virt-alignment-scan(1), http://libguestfs.org/.
АВТОР
Richard W.M. Jones http://people.redhat.com/~rjones/
АВТОРСЬКІ ПРАВА
Copyright (C) 2010-2023 Red Hat Inc.
LICENSE
BUGS
To get a list of bugs against libguestfs, use this link:
https://bugzilla.redhat.com/buglist.cgi?component=libguestfs&product=Virtualization+Tools
To report a new bug against libguestfs, use this link:
https://bugzilla.redhat.com/enter_bug.cgi?component=libguestfs&product=Virtualization+Tools
When reporting a bug, please supply:
• The version of libguestfs.
• Where you got libguestfs (eg. which Linux distro, compiled from source, etc)
• Describe the bug accurately and give a way to reproduce it.
• Run libguestfs-test-tool(1) and paste the complete, unedited output into the bug
report.