НАЗВА¶

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
    

ДОКЛАДНІШЕ ЩОДО ВИКОРИСТАННЯ¶

 qemu-img create -f qcow2 -o preallocation=metadata outdisk [розмір]

 fallocate -l розмір вихідний_диск

ПАРАМЕТРИ¶

--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 байтів, ось придатні значення для цього параметра:

--colors

--colours

Використовувати послідовності символів ANSI для розфарбовування повідомлень. Ці послідовності типово використовуються, якщо дані виводяться на термінал tty. Якщо дані, виведені програмою, спрямовуються до файла, послідовності визначення кольорів ANSI буде вимкнено, якщо ви не додасте до команди цей параметр.

-d

--debug

(Застарілий: використовуйте замість нього -v)

Увімкнути показ діагностичних повідомлень.

--delete РОЗДІЛ

Вилучити вказаний за назвою розділ. Точнішим визначенням цієї дії буде «не копіювати», оскільки virt-resize не вносить зміни до початкового образу диска.

Зауважте, що коли ви вилучаєте розділ, вилучаються і усі дані, які зберігалися на ньому. Більше того, у результаті усі розділи за вилученим перенумеровуються, що може призвести до неможливості завантаження гостьової системи.

Цей параметр можна вказувати декілька разів.

--expand РОЗДІЛ

Розширити вказаний за назвою розділ так, щоб він зайняв усе вільне місце (місце, яке лишатиметься вільним після усіх інших вказаних вами змін у розмірах).

Якщо virt-resize відомий спосіб, програма розширить безпосередній вміст розділу. Наприклад, якщо розділ є фізичним томом LVM, програма розширить фізичний том так, щоб він зайняв усе місце (подібно до виклику pvresize(8)). Якщо спосіб розширення виявиться невідомим virt-resize, програма не чіпатиме вмісту розділу.

У поточній версії virt-resize може змінювати розміри таких файлових систем:

--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).

ПРИМІТКИ¶

 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

АЛЬТЕРНАТИВНІ ІНСТРУМЕНТИ¶

Існує декілька пропрієтарних інструментів для зміни розмірів розділів. Тут ми не будемо згадувати назви жодного з таких інструментів.

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.