.TH "VGMERGE" "8" "مه ۲۰۲۵" "lvm2" "دستورهای مدیریتی و نگهداری"
.
.SH "نام (NAME)"
vgmerge \- ادغام دو گروه حجم در یکدیگر در سامانه LVM
.
.SH "خلاصه دستور (SYNOPSIS)"
\fBvgmerge\fP [\fIگزینهها\fR] \fIگروه_حجم_مقصد\fR \fIگروه_حجم_مبدأ\fR
.
.SH "توضیحات (DESCRIPTION)"
دستور \fBvgmerge\fR دو گروه حجم مجزا را ادغام میکند؛ به این ترتیب که گروه حجم مبدأ غیرفعال شده و حجمهای فیزیکی و منطقی آن به گروه حجم مقصد ملحق میشوند.
.P
گروه حجم مبدأ که غیرفعال است در صورتی با گروه حجم مقصد ادغام می‌شود که اندازه اکستنت‌های فیزیکی (Physical Extent) در هر دو گروه برابر بوده و مجموع PVها و LVهای هر دو گروه در محدوده محدودیت‌های گروه حجم مقصد بگنجد.
.
.SH "کاربرد (USAGE)"
\fBvgmerge\fP \fIVG\fP \fIVG\fP
.br
.RS 4
.na
[ \fB\-A\fP|\fB\-\-autobackup\fP \fBy\fP|\fBn\fP ]
.br
[ \fB\-l\fP|\fB\-\-list\fP ]
.br
[    \fB\-\-poolmetadataspare\fP \fBy\fP|\fBn\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\-A\fP|\fB\-\-autobackup\fP \fBy\fP|\fBn\fP
.br
تعیین می‌کند که آیا پس از اعمال تغییرات به طور خودکار از متادیتا نسخه پشتیبان تهیه شود یا خیر.
فعال کردن این گزینه شدیداً توصیه می‌شود!
برای اطلاعات بیشتر به \fBvgcfgbackup\fP(8) مراجعه فرمایید.
.
.HP
\fB\-\-commandprofile\fP \fIString\fP
.br
نمایه دستوری مورد استفاده برای پیکربندی دستور.
برای اطلاعات بیشتر درباره نمایه‌ها به \fBlvm.conf\fP(5) مراجعه فرمایید.
.
.HP
\fB\-\-config\fP \fIString\fP
.br
تنظیمات پیکربندی برای دستور. این تنظیمات بر مقادیر پیکربندی در \fBlvm.conf\fP(5) تقدم دارند.
آرگومان رشته از همان قالب \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\-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\-l\fP|\fB\-\-list\fP
.br
نمایش مشخصات گروه حجم مقصد پس از ادغام، مشابه دستور \fBvgdisplay \-v\fP.
.
.HP
\fB\-\-lockopt\fP \fIString\fP
.br
برای ارسال گزینه‌ها در شرایط خاص به lvmlockd استفاده می‌شود.
برای اطلاعات بیشتر به \fBlvmlockd\fP(8) مراجعه فرمایید.
.
.HP
\fB\-\-longhelp\fP
.br
نمایش متن راهنمای تفصیلی و کامل.
.
.HP
\fB\-\-nohints\fP
.br
عدم استفاده از فایل راهنماها (hints) برای یافتن دستگاه‌های PV.
هنگامی که از راهنماها استفاده نشود، ممکن است دستور دستگاه‌های بیشتری را برای یافتن
PVها اسکن کند. دستور همچنان باطل‌سازی استاندارد فایل راهنما را در زمان مناسب اجرا خواهد کرد.
.
.HP
\fB\-\-nolocking\fP
.br
غیرفعال کردن قفل‌گذاری. با احتیاط استفاده شود؛
دستورات همزمان ممکن است نتایج نادرستی به همراه داشته باشند.
.
.HP
\fB\-\-poolmetadataspare\fP \fBy\fP|\fBn\fP
.br
فعال یا غیرفعال کردن ایجاد و مدیریت خودکار یک LV متادیتای یدکی در گروه حجم (VG).
یک LV متادیتای یدکی، فضای ذخیره‌سازی رزرو شده‌ای است که می‌توان از آن هنگام تعمیر و بازیابی یک pool استفاده کرد.
.
.HP
\fB\-\-profile\fP \fIString\fP
.br
نام مستعار برای \fB\-\-commandprofile\fP یا \fB\-\-metadataprofile\fP، بسته به دستور مورد استفاده.
.
.HP
\fB\-q\fP|\fB\-\-quiet\fP ...
.br
فرونشاندن خروجی و پیام‌های لاگ. بر گزینه‌های \fB\-\-debug\fP و \fB\-\-verbose\fP اولویت دارد.
با یک بار تکرار بیشتر، همچنین تمامی پرسش‌ها را با پاسخ فرضی 'no' بدون نمایش رد می‌کند.
.
.HP
\fB\-t\fP|\fB\-\-test\fP
.br
اجرا در حالت آزمایش. دستورات اقدام به به‌روزرسانی متادیتا نخواهند کرد.
این قابلیت با غیرفعال کردن تمامی عملیات‌های نوشتن متادیتا و همزمان
بازگرداندن وضعیت موفقیت‌آمیز به تابع فراخواننده پیاده‌سازی شده است.
این امر ممکن است در عملیات‌های چندمرحله‌ای منجر به پیام‌های خطای نامتعارف شود،
اگر ابزاری وابسته به بازخوانی مجدد متادیتایی باشد که می‌پندارد تغییر یافته است
اما در واقع تغییر نیافته است.
.
.HP
\fB\-v\fP|\fB\-\-verbose\fP ...
.br
تنظیم سطح پرگویی خروجی. این گزینه را بین ۱ تا ۴ بار تکرار کنید تا جزئیات
پیام‌های ارسالی به خروجی استاندارد و خطای استاندارد بیشتر شود.
.
.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 "مثال‌ها (EXAMPLES)"
.
ادغام یک گروه حجم غیرفعال به نام "vg00" در گروه حجم فعال یا غیرفعال دیگری به نام "databases" با ارائه گزارش پرگوی زمان اجرا:
.br
.B vgmerge \-v databases vg00
.
.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)