.TH "VGCONVERT" "8" "مه ۲۰۲۵" "lvm2" "دستورهای مدیریتی و نگهداری"
.
.SH "نام (NAME)"
vgconvert \- تغییر فرمت متادیتای گروه حجم (منسوخشده)
.
.SH "خلاصه دستور (SYNOPSIS)"
\fBvgconvert\fP
.
.SH "توضیحات (DESCRIPTION)"
دستور \fBvgconvert\fR دیگر بخشی از LVM نیست و همراه با حذف پشتیبانی از فرمت متادیتای قدیمی LVM1 از سامانه حذف شده است.
برای تبدیل گروه‌های حجم (VGs) از فرمت LVM1 به LVM2 از یک نسخه قدیمی‌تر LVM استفاده کنید.
.
.SH "کاربرد (USAGE)"
.
\fBvgconvert\fP \fIVG\fP ...
.br
.RS 4
.na
[ \fB\-f\fP|\fB\-\-force\fP ]
.br
[ \fB\-M\fP|\fB\-\-metadatatype\fP \fBlvm2\fP ]
.br
[    \fB\-\-labelsector\fP \fINumber\fP ]
.br
[    \fB\-\-bootloaderareasize\fP \fISize\fP[m|UNIT] ]
.br
[    \fB\-\-pvmetadatacopies\fP \fB0\fP|\fB1\fP|\fB2\fP ]
.br
[    \fB\-\-metadatasize\fP \fISize\fP[m|UNIT] ]
.br
[    \fB\-\-reportformat\fP \fBbasic\fP|\fBjson\fP|\fBjson_std\fP ]
.br
[ \fIگزینه‌های_عمومی\fP ]
.ad
.RE
.P
گزینه‌های عمومی برای lvm:
.
.RS 4
.na
[ \fB\-d\fP|\fB\-\-debug\fP ]
.br
[ \fB\-h\fP|\fB\-\-help\fP ]
.br
[ \fB\-q\fP|\fB\-\-quiet\fP ]
.br
[ \fB\-t\fP|\fB\-\-test\fP ]
.br
[ \fB\-v\fP|\fB\-\-verbose\fP ]
.br
[ \fB\-y\fP|\fB\-\-yes\fP ]
.br
[    \fB\-\-commandprofile\fP \fIString\fP ]
.br
[    \fB\-\-config\fP \fIString\fP ]
.br
[    \fB\-\-devices\fP \fIPV\fP ]
.br
[    \fB\-\-devicesfile\fP \fIString\fP ]
.br
[    \fB\-\-driverloaded\fP \fBy\fP|\fBn\fP ]
.br
[    \fB\-\-journal\fP \fIString\fP ]
.br
[    \fB\-\-lockopt\fP \fIString\fP ]
.br
[    \fB\-\-longhelp\fP ]
.br
[    \fB\-\-nohints\fP ]
.br
[    \fB\-\-nolocking\fP ]
.br
[    \fB\-\-profile\fP \fIString\fP ]
.br
[    \fB\-\-version\fP ]
.ad
.RE
.
.SH "گزینه‌ها (OPTIONS)"
.
.HP
\fB\-\-bootloaderareasize\fP \fISize\fP[m|UNIT]
.br
رزرو فضا برای بوت‌لودر بین ناحیه متادیتای LVM و اولین PE. ناحیه بوت‌لودر برای بوت‌لودرها رزرو شده است تا داده‌ها یا متادیتای خود را در آن جاسازی کنند؛ LVM از آن استفاده نخواهد کرد. ناحیه بوت‌لودر از جایی آغاز می‌شود که در غیر این صورت اولین PE در آنجا مستقر می‌شد. اولین PE به اندازه ناحیه بوت‌لودر به جلو منتقل می‌شود و سپس در صورت لزوم برای مطابقت با تراز داده‌ها بیشتر جابه‌جا خواهد شد. شروع ناحیه بوت‌لودر همواره تراز است؛ همچنین به \fB\-\-dataalignment\fP و \fB\-\-dataalignmentoffset\fP مراجعه کنید. ناحیه بوت‌لودر ممکن است به دلیل تراز، بزرگ‌تر از اندازه درخواستی باشد اما هرگز کمتر از آن نخواهد بود. برای مشاهده شروع و اندازه ناحیه بوت‌لودر یک PV موجود از \fBpvs \-o +pv_ba_start,pv_ba_size\fP استفاده کنید.
.
.HP
\fB\-\-commandprofile\fP \fIString\fP
.br
نمایه دستوری مورد استفاده برای پیکربندی دستور. برای اطلاعات بیشتر درباره نمایه‌ها به \fBlvm.conf\fP(5) مراجعه فرمایید.
.
.HP
\fB\-\-config\fP \fIString\fP
.br
تنظیمات پیکربندی برای دستور. این تنظیمات بر مقادیر پیکربندی در \fBlvm.conf\fP(5) تقدم دارند. آرگومان String از همان قالب \fBlvm.conf\fP(5) بهره می‌برد یا می‌تواند از نحو بخش/فیلد استفاده کند. برای اطلاعات بیشتر درباره پیکربندی به \fBlvm.conf\fP(5) مراجعه فرمایید.
.
.HP
\fB\-d\fP|\fB\-\-debug\fP ...
.br
تنظیم سطح اشکال‌زدایی (دیباگ). این گزینه را از ۱ تا ۶ بار تکرار کنید تا جزئیات پیام‌های ارسالی به فایل لاگ و/یا syslog (در صورت فعال بودن) افزایش یابد.
.
.HP
\fB\-\-devices\fP \fIPV\fP
.br
محدود کردن دستگاه‌هایی که برای دستور قابل مشاهده و دسترسی هستند. دستگاه‌هایی که در این فهرست نباشند مفقود به نظر خواهند رسید. این گزینه می‌تواند تکرار شود، یا فهرستی جدا شده با ویرگول از دستگاه‌ها را بپذیرد. این گزینه بر فایل دستگاه‌ها اولویت دارد.
.
.HP
\fB\-\-devicesfile\fP \fIString\fP
.br
فایلی شامل فهرست دستگاه‌هایی که LVM باید استفاده کند. این فایل باید در مسیر \fI/etc/lvm/devices/\fP وجود داشته باشد و با دستور \fBlvmdevices\fP(8) مدیریت می‌شود. این گزینه تنظیمات \fBdevices/devicesfile\fP و \fBdevices/use_devicesfile\fP در \fBlvm.conf\fP(5) را بازنویسی می‌کند.
.
.HP
\fB\-\-driverloaded\fP \fBy\fP|\fBn\fP
.br
در صورت تنظیم بر روی no، دستور تلاشی برای استفاده از device-mapper نخواهد کرد. این گزینه برای مقاصد آزمایش و اشکال‌زدایی کاربرد دارد.
.
.HP
\fB\-f\fP|\fB\-\-force\fP ...
.br
نادیده‌گرفتن بررسی‌ها، تاییدیه‌ها و محافظت‌های گوناگون. با نهایت احتیاط استفاده شود.
.
.HP
\fB\-h\fP|\fB\-\-help\fP
.br
نمایش متن راهنما.
.
.HP
\fB\-\-journal\fP \fIString\fP
.br
ثبت اطلاعات در ژورنال systemd. این اطلاعات علاوه بر اطلاعاتی است که توسط تنظیم log/journal در lvm.conf فعال می‌شود. مقادیر مجاز:
\fBcommand\fP: ثبت اطلاعات درباره دستور؛
\fBoutput\fP: ثبت خروجی پیش‌فرض دستور؛
\fBdebug\fP: ثبت اطلاعات کامل اشکال‌زدایی دستور.
.
.HP
\fB\-\-labelsector\fP \fINumber\fP
.br
به‌طور پیش‌فرض، PV با یک شناسه LVM2 در سکتور دوم خود (سکتور ۱) برچسب‌گذاری می‌شود. این گزینه به شما امکان می‌دهد از سکتور متفاوتی در نزدیکی ابتدای دیسک (بین ۰ تا ۳ شامل خود آن‌ها \- LABEL_SCAN_SECTORS را در سورس کد ببینید) استفاده کنید. با احتیاط استفاده شود.
.
.HP
\fB\-\-lockopt\fP \fIString\fP
.br
برای ارسال گزینه‌ها در شرایط خاص به lvmlockd استفاده می‌شود. برای اطلاعات بیشتر به \fBlvmlockd\fP(8) مراجعه فرمایید.
.
.HP
\fB\-\-longhelp\fP
.br
نمایش متن راهنمای بلند و جامع.
.
.HP
\fB\-\-metadatasize\fP \fISize\fP[m|UNIT]
.br
مقدار تقریبی فضای استفاده‌شده برای هر ناحیه متادیتای VG. اندازه ممکن است گرد شود.
.
.HP
\fB\-M\fP|\fB\-\-metadatatype\fP \fBlvm2\fP
.br
نوع متادیتای روی دیسک را برای استفاده تعیین می‌کند. مقدار \fBlvm2\fP (یا صرفاً \fB2\fP) قالب استاندارد و فعلی است. مقدار \fBlvm1\fP (یا صرفاً \fB1\fP) دیگر استفاده نمی‌شود.
.
.HP
\fB\-\-nohints\fP
.br
عدم استفاده از فایل راهنماها (hints) برای یافتن دستگاه‌ها به عنوان PV. هنگامی که از راهنماها استفاده نشود، ممکن است دستور دستگاه‌های بیشتری را برای یافتن PVها اسکن کند. دستور همچنان باطل‌سازی استاندارد فایل راهنما را در زمان مقتضی انجام خواهد داد.
.
.HP
\fB\-\-nolocking\fP
.br
غیرفعال کردن قفل‌گذاری. با احتیاط استفاده شود؛ دستورات همزمان ممکن است نتایج نادرستی به همراه داشته باشند.
.
.HP
\fB\-\-profile\fP \fIString\fP
.br
نام مستعار برای \fB\-\-commandprofile\fP یا \fB\-\-metadataprofile\fP بسته به نوع دستور.
.
.HP
\fB\-\-pvmetadatacopies\fP \fB0\fP|\fB1\fP|\fB2\fP
.br
تعداد نواحی متادیتا که بر روی یک PV برای ذخیره متادیتای VG اختصاص می‌یابد. هنگامی که ۲ باشد، یک نسخه از متادیتای VG در ابتدای PV و نسخه دوم در انتهای آن ذخیره می‌شود. هنگامی که ۱ باشد، یک نسخه از متادیتای VG در ابتدای PV ذخیره می‌شود. هنگامی که ۰ باشد، هیچ نسخه‌ای از متادیتای VG بر روی PV مربوطه ذخیره نمی‌شود. این گزینه ممکن است در VGهایی که شامل تعداد زیادی PV هستند مفید باشد (این امر در آینده محدودیت‌هایی بر امکان استفاده از \fBvgsplit\fP ایجاد می‌کند).
.
.HP
\fB\-q\fP|\fB\-\-quiet\fP ...
.br
فرونشاندن خروجی و پیام‌های لاگ. بر گزینه‌های \fB\-\-debug\fP و \fB\-\-verbose\fP اولویت دارد. با یک بار تکرار بیشتر، همچنین از تمامی اعلان‌ها با پاسخ پیش‌فرض 'no' رد می‌شود.
.
.HP
\fB\-\-reportformat\fP \fBbasic\fP|\fBjson\fP|\fBjson_std\fP
.br
قالب خروجی فعلی گزارش‌ها را که به صورت سراسری با تنظیم report/output_format در \fBlvm.conf\fP(5) تعریف شده است، بازنویسی می‌کند. مقدار \fBbasic\fP همان قالب اصلی با ستون‌ها و ردیف‌ها است. اگر بیش از یک گزارش به ازای هر دستور وجود داشته باشد، هر گزارش با نام گزارش برای شناسایی پیشوند می‌گیرد. مقدار \fBjson\fP خروجی گزارش را در قالب JSON تولید می‌کند. مقدار \fBjson_std\fP خروجی گزارش را در قالبی از JSON سازگارتر با استانداردهای رسمی JSON ارائه می‌دهد. برای اطلاعات بیشتر به \fBlvmreport\fP(7) مراجعه فرمایید.
.
.HP
\fB\-t\fP|\fB\-\-test\fP
.br
اجرا در حالت آزمایش. دستورات اقدام به به‌روزرسانی متادیتا نخواهند کرد. این قابلیت با غیرفعال کردن تمامی عملیات‌های نوشتن متادیتا و همزمان بازگرداندن وضعیت موفقیت‌آمیز به تابع فراخواننده پیاده‌سازی شده است. این امر ممکن است در عملیات‌های چندمرحله‌ای منجر به پیام‌های خطای نامتعارف شود، اگر ابزاری وابسته به بازخوانی مجدد متادیتایی باشد که می‌پندارد تغییر یافته است اما در واقع تغییر نیافته است.
.
.HP
\fB\-v\fP|\fB\-\-verbose\fP ...
.br
تنظیم سطح پرگویی خروجی. این گزینه را از ۱ تا ۴ بار تکرار کنید تا جزئیات پیام‌های ارسالی به stdout و stderr افزایش یابد.
.
.HP
\fB\-\-version\fP
.br
نمایش اطلاعات نسخه نرم‌افزار.
.
.HP
\fB\-y\fP|\fB\-\-yes\fP
.br
عدم پرسش تعاملی برای دریافت تاییدیه و در نظر گرفتن همیشگی پاسخ مثبت (yes). با نهایت احتیاط استفاده شود. (برای پاسخ منفی خودکار، به \-qq مراجعه نمایید).
.
.SH "متغیرها (VARIABLES)"
.
.TP
.I VG
نام گروه حجم (Volume Group). برای نام‌های معتبر به \fBlvm\fP(8) مراجعه نمایید.
.TP
.I String
برای اطلاعات در مورد محتوای رشته، به توضیحات همان گزینه رجوع کنید.
.TP
.IR Size [UNIT]
اندازه یک عدد ورودی است که یک واحد اختیاری را می‌پذیرد.
واحدهای ورودی همواره صرف‌نظر از بزرگی یا کوچکی حروف به عنوان مقادیر بر مبنای دو تفسیر می‌شوند؛ برای نمونه 'k' و 'K' هر دو به معنی ۱۰۲۴ هستند.
واحد پیش‌فرض ورودی با حرف و در ادامه با |UNIT مشخص شده است.
مقدار UNIT بیانگر دیگر واحدهای ورودی ممکن است:
.BR b | B
بایت،
.BR s | S
سکتورهای ۵۱۲ بایتی،
.BR k | K
کیبی‌بایت (KiB)،
.BR m | M
میبی‌بایت (MiB)،
.BR g | G
گیبی‌بایت (GiB)،
.BR t | T
تبی‌بایت (TiB)،
.BR p | P
پبی‌بایت (PiB)،
.BR e | E
اگزی‌بایت (EiB).
(این مورد نباید با کنترل خروجی \fB\-\-units\fP اشتباه گرفته شود که در آن حروف بزرگ به معنای مضاربی از ۱۰۰۰ هستند).
.
.SH "متغیرهای محیطی (ENVIRONMENT VARIABLES)"
.
برای اطلاعات بیشتر درباره متغیرهای محیطی مورد استفاده در lvm به \fBlvm\fP(8) مراجعه فرمایید.
به عنوان نمونه، LVM_VG_NAME معمولاً می‌تواند به جای یک پارامتر الزامی VG جایگزین شود.
.
.SH "همچنین ببینید (SEE ALSO)"
.
.nh
.na
.BR lvm (8),
.BR lvm.conf (5),
.BR lvmconfig (8),
.BR lvmdevices (8),
.P
.BR pvchange (8),
.BR pvck (8),
.BR pvcreate (8),
.BR pvdisplay (8),
.BR pvmove (8),
.BR pvremove (8),
.BR pvresize (8),
.BR pvs (8),
.BR pvscan (8),
.P
.BR vgcfgbackup (8),
.BR vgcfgrestore (8),
.BR vgchange (8),
.BR vgck (8),
.BR vgcreate (8),
.BR vgconvert (8),
.BR vgdisplay (8),
.BR vgexport (8),
.BR vgextend (8),
.BR vgimport (8),
.BR vgimportclone (8),
.BR vgimportdevices (8),
.BR vgmerge (8),
.BR vgmknodes (8),
.BR vgreduce (8),
.BR vgremove (8),
.BR vgrename (8),
.BR vgs (8),
.BR vgscan (8),
.BR vgsplit (8),
.P
.BR lvcreate (8),
.BR lvchange (8),
.BR lvconvert (8),
.BR lvdisplay (8),
.BR lvextend (8),
.BR lvreduce (8),
.BR lvremove (8),
.BR lvrename (8),
.BR lvresize (8),
.BR lvs (8),
.BR lvscan (8),
.P
.BR lvm\-fullreport (8),
.BR lvm\-lvpoll (8),
.BR blkdeactivate (8),
.BR lvmdump (8),
.P
.BR dmeventd (8),
.BR lvmpolld (8),
.BR lvmlockd (8),
.BR lvmlockctl (8),
.BR cmirrord (8),
.BR lvmdbusd (8),
.BR fsadm (8),
.P
.BR lvmsystemid (7),
.BR lvmreport (7),
.BR lvmcache (7),
.BR lvmraid (7),
.BR lvmthin (7),
.BR lvmvdo (7),
.BR lvmautoactivation (7)