| VGCONVERT(8) | دستورهای مدیریتی و نگهداری | VGCONVERT(8) |
نام (NAME)
vgconvert - تغییر فرمت متادیتای گروه حجم (منسوخشده)
خلاصه دستور (SYNOPSIS)
vgconvert
توضیحات (DESCRIPTION)
دستور vgconvert دیگر بخشی از LVM نیست و همراه با حذف پشتیبانی از فرمت متادیتای قدیمی LVM1 از سامانه حذف شده است. برای تبدیل گروههای حجم (VGs) از فرمت LVM1 به LVM2 از یک نسخه قدیمیتر LVM استفاده کنید.
کاربرد (USAGE)
vgconvert VG ...
[ -M|--metadatatype lvm2 ]
[ --labelsector Number ]
[ --bootloaderareasize Size[m|UNIT] ]
[ --pvmetadatacopies 0|1|2 ]
[ --metadatasize Size[m|UNIT] ]
[ --reportformat basic|json|json_std ]
[ گزینههای_عمومی ]
گزینههای عمومی برای lvm:
[ -h|--help ]
[ -q|--quiet ]
[ -t|--test ]
[ -v|--verbose ]
[ -y|--yes ]
[ --commandprofile String ]
[ --config String ]
[ --devices PV ]
[ --devicesfile String ]
[ --driverloaded y|n ]
[ --journal String ]
[ --lockopt String ]
[ --longhelp ]
[ --nohints ]
[ --nolocking ]
[ --profile String ]
[ --version ]
گزینهها (OPTIONS)
--bootloaderareasize Size[m|UNIT]
رزرو فضا
برای
بوتلودر
بین ناحیه
متادیتای LVM
و اولین PE.
ناحیه
بوتلودر
برای
بوتلودرها
رزرو شده
است تا
دادهها یا
متادیتای
خود را در آن
جاسازی
کنند؛ LVM از
آن استفاده
نخواهد کرد.
ناحیه
بوتلودر
از جایی
آغاز
میشود که
در غیر این
صورت اولین PE
در آنجا
مستقر
میشد.
اولین PE به
اندازه
ناحیه
بوتلودر
به جلو
منتقل
میشود و
سپس در صورت
لزوم برای
مطابقت با
تراز
دادهها
بیشتر
جابهجا
خواهد شد.
شروع ناحیه
بوتلودر
همواره
تراز است؛
همچنین به
--dataalignment و --dataalignmentoffset
مراجعه
کنید. ناحیه
بوتلودر
ممکن است به
دلیل تراز،
بزرگتر از
اندازه
درخواستی
باشد اما
هرگز کمتر
از آن
نخواهد بود.
برای
مشاهده
شروع و
اندازه
ناحیه
بوتلودر
یک PV موجود
از pvs -o +pv_ba_start,pv_ba_size
استفاده
کنید.
--commandprofile String
نمایه
دستوری
مورد
استفاده
برای
پیکربندی
دستور. برای
اطلاعات
بیشتر
درباره
نمایهها
به lvm.conf(5)
مراجعه
فرمایید.
--config String
تنظیمات
پیکربندی
برای دستور.
این
تنظیمات بر
مقادیر
پیکربندی
در lvm.conf(5) تقدم
دارند.
آرگومان String
از همان
قالب lvm.conf(5)
بهره
میبرد یا
میتواند
از نحو
بخش/فیلد
استفاده
کند. برای
اطلاعات
بیشتر
درباره
پیکربندی
به lvm.conf(5)
مراجعه
فرمایید.
-d|--debug ...
تنظیم سطح
اشکالزدایی
(دیباگ). این
گزینه را از
۱ تا ۶ بار
تکرار کنید
تا جزئیات
پیامهای
ارسالی به
فایل لاگ
و/یا syslog (در
صورت فعال
بودن)
افزایش
یابد.
--devices PV
محدود کردن
دستگاههایی
که برای
دستور قابل
مشاهده و
دسترسی
هستند.
دستگاههایی
که در این
فهرست
نباشند
مفقود به
نظر خواهند
رسید. این
گزینه
میتواند
تکرار شود،
یا فهرستی
جدا شده با
ویرگول از
دستگاهها
را بپذیرد.
این گزینه
بر فایل
دستگاهها
اولویت
دارد.
--devicesfile String
فایلی شامل
فهرست
دستگاههایی
که LVM باید
استفاده
کند. این
فایل باید
در مسیر /etc/lvm/devices/
وجود داشته
باشد و با
دستور lvmdevices(8)
مدیریت
میشود. این
گزینه
تنظیمات
devices/devicesfile و devices/use_devicesfile
در lvm.conf(5) را
بازنویسی
میکند.
--driverloaded y|n
در صورت
تنظیم بر
روی no، دستور
تلاشی برای
استفاده از
device-mapper نخواهد
کرد. این
گزینه برای
مقاصد
آزمایش و
اشکالزدایی
کاربرد
دارد.
-f|--force ...
نادیدهگرفتن
بررسیها،
تاییدیهها
و
محافظتهای
گوناگون. با
نهایت
احتیاط
استفاده
شود.
-h|--help
نمایش متن
راهنما.
--journal String
ثبت
اطلاعات در
ژورنال systemd.
این
اطلاعات
علاوه بر
اطلاعاتی
است که توسط
تنظیم log/journal در
lvm.conf فعال
میشود.
مقادیر
مجاز: command: ثبت
اطلاعات
درباره
دستور؛ output:
ثبت خروجی
پیشفرض
دستور؛ debug:
ثبت
اطلاعات
کامل
اشکالزدایی
دستور.
--labelsector Number
بهطور
پیشفرض، PV
با یک شناسه
LVM2 در سکتور
دوم خود
(سکتور ۱)
برچسبگذاری
میشود. این
گزینه به
شما امکان
میدهد از
سکتور
متفاوتی در
نزدیکی
ابتدای
دیسک (بین ۰
تا ۳ شامل
خود آنها -
LABEL_SCAN_SECTORS را در
سورس کد
ببینید)
استفاده
کنید. با
احتیاط
استفاده
شود.
--lockopt String
برای ارسال
گزینهها
در شرایط
خاص به lvmlockd
استفاده
میشود.
برای
اطلاعات
بیشتر به lvmlockd(8)
مراجعه
فرمایید.
--longhelp
نمایش متن
راهنمای
بلند و
جامع.
--metadatasize Size[m|UNIT]
مقدار
تقریبی
فضای
استفادهشده
برای هر
ناحیه
متادیتای VG.
اندازه
ممکن است
گرد شود.
-M|--metadatatype lvm2
نوع
متادیتای
روی دیسک را
برای
استفاده
تعیین
میکند.
مقدار lvm2 (یا
صرفاً 2)
قالب
استاندارد
و فعلی است.
مقدار lvm1 (یا
صرفاً 1)
دیگر
استفاده
نمیشود.
--nohints
عدم
استفاده از
فایل
راهنماها (hints)
برای یافتن
دستگاهها
به عنوان PV.
هنگامی که
از
راهنماها
استفاده
نشود، ممکن
است دستور
دستگاههای
بیشتری را
برای یافتن
PVها اسکن
کند. دستور
همچنان
باطلسازی
استاندارد
فایل
راهنما را
در زمان
مقتضی
انجام
خواهد داد.
--nolocking
غیرفعال
کردن
قفلگذاری.
با احتیاط
استفاده
شود؛
دستورات
همزمان
ممکن است
نتایج
نادرستی به
همراه
داشته
باشند.
--profile String
نام مستعار
برای --commandprofile یا
--metadataprofile بسته به
نوع دستور.
--pvmetadatacopies 0|1|2
تعداد
نواحی
متادیتا که
بر روی یک PV
برای ذخیره
متادیتای VG
اختصاص
مییابد.
هنگامی که ۲
باشد، یک
نسخه از
متادیتای VG
در ابتدای PV
و نسخه دوم
در انتهای
آن ذخیره
میشود.
هنگامی که ۱
باشد، یک
نسخه از
متادیتای VG
در ابتدای PV
ذخیره
میشود.
هنگامی که ۰
باشد، هیچ
نسخهای از
متادیتای VG
بر روی PV
مربوطه
ذخیره
نمیشود.
این گزینه
ممکن است در
VGهایی که
شامل تعداد
زیادی PV
هستند مفید
باشد (این
امر در
آینده
محدودیتهایی
بر امکان
استفاده از
vgsplit ایجاد
میکند).
-q|--quiet ...
فرونشاندن
خروجی و
پیامهای
لاگ. بر
گزینههای
--debug و --verbose
اولویت
دارد. با یک
بار تکرار
بیشتر،
همچنین از
تمامی
اعلانها
با پاسخ
پیشفرض 'no'
رد میشود.
--reportformat basic|json|json_std
قالب خروجی
فعلی
گزارشها
را که به
صورت
سراسری با
تنظیم report/output_format
در lvm.conf(5) تعریف
شده است،
بازنویسی
میکند.
مقدار basic
همان قالب
اصلی با
ستونها و
ردیفها
است. اگر بیش
از یک گزارش
به ازای هر
دستور وجود
داشته
باشد، هر
گزارش با
نام گزارش
برای
شناسایی
پیشوند
میگیرد.
مقدار json
خروجی
گزارش را در
قالب JSON
تولید
میکند.
مقدار json_std
خروجی
گزارش را در
قالبی از JSON
سازگارتر
با
استانداردهای
رسمی JSON
ارائه
میدهد.
برای
اطلاعات
بیشتر به
lvmreport(7) مراجعه
فرمایید.
-t|--test
اجرا در
حالت
آزمایش.
دستورات
اقدام به
بهروزرسانی
متادیتا
نخواهند
کرد. این
قابلیت با
غیرفعال
کردن تمامی
عملیاتهای
نوشتن
متادیتا و
همزمان
بازگرداندن
وضعیت
موفقیتآمیز
به تابع
فراخواننده
پیادهسازی
شده است. این
امر ممکن
است در
عملیاتهای
چندمرحلهای
منجر به
پیامهای
خطای
نامتعارف
شود، اگر
ابزاری
وابسته به
بازخوانی
مجدد
متادیتایی
باشد که
میپندارد
تغییر
یافته است
اما در واقع
تغییر
نیافته
است.
-v|--verbose ...
تنظیم سطح
پرگویی
خروجی. این
گزینه را از
۱ تا ۴ بار
تکرار کنید
تا جزئیات
پیامهای
ارسالی به stdout
و stderr افزایش
یابد.
--version
نمایش
اطلاعات
نسخه
نرمافزار.
-y|--yes
عدم پرسش
تعاملی
برای
دریافت
تاییدیه و
در نظر
گرفتن
همیشگی
پاسخ مثبت (yes).
با نهایت
احتیاط
استفاده
شود. (برای
پاسخ منفی
خودکار، به
-qq مراجعه
نمایید).
متغیرها (VARIABLES)
- VG
- نام گروه حجم (Volume Group). برای نامهای معتبر به lvm(8) مراجعه نمایید.
- String
- برای اطلاعات در مورد محتوای رشته، به توضیحات همان گزینه رجوع کنید.
- Size[UNIT]
- اندازه یک عدد ورودی است که یک واحد اختیاری را میپذیرد. واحدهای ورودی همواره صرفنظر از بزرگی یا کوچکی حروف به عنوان مقادیر بر مبنای دو تفسیر میشوند؛ برای نمونه 'k' و 'K' هر دو به معنی ۱۰۲۴ هستند. واحد پیشفرض ورودی با حرف و در ادامه با |UNIT مشخص شده است. مقدار UNIT بیانگر دیگر واحدهای ورودی ممکن است: b|B بایت، s|S سکتورهای ۵۱۲ بایتی، k|K کیبیبایت (KiB)، m|M میبیبایت (MiB)، g|G گیبیبایت (GiB)، t|T تبیبایت (TiB)، p|P پبیبایت (PiB)، e|E اگزیبایت (EiB). (این مورد نباید با کنترل خروجی --units اشتباه گرفته شود که در آن حروف بزرگ به معنای مضاربی از ۱۰۰۰ هستند).
متغیرهای محیطی (ENVIRONMENT VARIABLES)
برای اطلاعات بیشتر درباره متغیرهای محیطی مورد استفاده در lvm به lvm(8) مراجعه فرمایید. به عنوان نمونه، LVM_VG_NAME معمولاً میتواند به جای یک پارامتر الزامی VG جایگزین شود.
همچنین ببینید (SEE ALSO)
lvm(8), lvm.conf(5), lvmconfig(8), lvmdevices(8),
pvchange(8), pvck(8), pvcreate(8), pvdisplay(8), pvmove(8), pvremove(8), pvresize(8), pvs(8), pvscan(8),
vgcfgbackup(8), vgcfgrestore(8), vgchange(8), vgck(8), vgcreate(8), vgconvert(8), vgdisplay(8), vgexport(8), vgextend(8), vgimport(8), vgimportclone(8), vgimportdevices(8), vgmerge(8), vgmknodes(8), vgreduce(8), vgremove(8), vgrename(8), vgs(8), vgscan(8), vgsplit(8),
lvcreate(8), lvchange(8), lvconvert(8), lvdisplay(8), lvextend(8), lvreduce(8), lvremove(8), lvrename(8), lvresize(8), lvs(8), lvscan(8),
lvm-fullreport(8), lvm-lvpoll(8), blkdeactivate(8), lvmdump(8),
dmeventd(8), lvmpolld(8), lvmlockd(8), lvmlockctl(8), cmirrord(8), lvmdbusd(8), fsadm(8),
lvmsystemid(7), lvmreport(7), lvmcache(7), lvmraid(7), lvmthin(7), lvmvdo(7), lvmautoactivation(7)
| مه ۲۰۲۵ | lvm2 |