نام (NAME)

vgextend - افزودن حجمهای فیزیکی جدید و گسترش ظرفیت گروه حجم LVM

خلاصه دستور (SYNOPSIS)

vgextend [گزینهها] گروه_حجم دستگاه_فیزیکی...

توضیحات (DESCRIPTION)

دستور vgextend با اضافه کردن یک یا چند حجم فیزیکی (PV) جدید به یک گروه حجم موجود، ظرفیت ذخیرهسازی آزاد آن را افزایش میدهد.

همچنین، PVهایی که مفقود شده و سپس بازگشته‌اند (برای نمونه به دلیل خطای موقت دستگاه)، می‌توانند بدون مقداردهی اولیه مجدد به VG بازگردانده شوند (گزینه --restoremissing را ببینید).

اگر PVهای مشخص‌شده هنوز با pvcreate مقداردهی اولیه نشده باشند، دستور vgextend آن‌ها را مقداردهی خواهد کرد. در این حالت می‌توان از گزینه‌های pvcreate مانند --labelsector، --metadatasize، --metadataignore، --pvmetadatacopies، --dataalignment و --dataalignmentoffset استفاده کرد.

کاربرد (USAGE)

vgextend VG PV ...

گزینه‌های عمومی برای lvm:

گزینه‌ها (OPTIONS)

-A|--autobackup y|n
تعیین می‌کند که آیا پس از اعمال تغییرات به طور خودکار از متادیتا نسخه پشتیبان تهیه شود یا خیر. فعال کردن این گزینه شدیداً توصیه می‌شود! برای اطلاعات بیشتر به vgcfgbackup(8) مراجعه فرمایید.

--commandprofile String
نمایه دستوری مورد استفاده برای پیکربندی دستور. برای اطلاعات بیشتر درباره نمایه‌ها به lvm.conf(5) مراجعه فرمایید.

--config String
تنظیمات پیکربندی برای دستور. این تنظیمات بر مقادیر پیکربندی در lvm.conf(5) تقدم دارند. آرگومان رشته از همان قالب lvm.conf(5) بهره می‌برد یا می‌تواند از نحو بخش/فیلد استفاده کند. برای اطلاعات بیشتر درباره پیکربندی به lvm.conf(5) مراجعه فرمایید.

--dataalignment Size[k|UNIT]
هم‌تراز ساختن نقطه شروع ناحیه داده PV با مضربی از این عدد. برای مشاهده مکان نخستین اکستنت فیزیکی (PE) در یک PV موجود، از pvs -o +pe_start استفاده نمایید. علاوه بر این، ممکن است با یک آفست هم‌ترازی جابه‌جا شود؛ به --dataalignmentoffset مراجعه فرمایید. همچنین هنگام ساخت یک VG، اندازه مناسب PE را مشخص کنید.

--dataalignmentoffset Size[k|UNIT]
انتقال نقطه شروع ناحیه داده PV به میزان این آفست مازاد.

-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
نمایش متن راهنمای تفصیلی و کامل.

--metadataignore y|n
ویژگی metadataignore مربوط به PV را تعیین می‌کند. اگر بر روی yes تنظیم شود، نواحی متادیتا روی این PV نادیده گرفته می‌شوند و lvm متادیتا را در این نواحی ذخیره نخواهد کرد. در صورت تنظیم بر روی no، دستور lvm متادیتا را روی PV ذخیره می‌نماید.

--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 و رونوشت دیگر در انتهای آن نگهداری می‌شود. وقتی ۱ باشد، یک رونوشت در ابتدای 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) مراجعه فرمایید.

--restoremissing
بازگرداندن یک PV به یک VG پس از آنکه PV مفقود شده و سپس بازگشته بود (برای مثال به علت خطای موقت). در این حالت PV مجدداً مقداردهی اولیه نخواهد شد.

-t|--test
اجرا در حالت آزمایش. دستورات اقدام به به‌روزرسانی متادیتا نخواهند کرد. این قابلیت با غیرفعال کردن تمامی عملیات‌های نوشتن متادیتا و همزمان بازگرداندن وضعیت موفقیت‌آمیز به تابع فراخواننده پیاده‌سازی شده است. این امر ممکن است در عملیات‌های چندمرحله‌ای منجر به پیام‌های خطای نامتعارف شود، اگر ابزاری وابسته به بازخوانی مجدد متادیتایی باشد که می‌پندارد تغییر یافته است اما در واقع تغییر نیافته است.

-v|--verbose ...
تنظیم سطح پرگویی خروجی. این گزینه را بین ۱ تا ۴ بار تکرار کنید تا جزئیات پیام‌های ارسالی به خروجی استاندارد و خطای استاندارد بیشتر شود.

--version
نمایش اطلاعات نسخه و نگارش نرم‌افزار.

-y|--yes
عدم پرسش تعاملی برای دریافت تاییدیه و در نظر گرفتن همیشگی پاسخ مثبت (yes). با نهایت احتیاط استفاده شود. (برای پاسخ منفی خودکار، به -qq مراجعه نمایید).

-Z|--zero y|n
کنترل می‌کند که آیا ۴ سکتور نخست (۲۰۴۸ بایت) دستگاه پاکسازی (wipe) شوند یا خیر. حالت پیش‌فرض پاکسازی این سکتورها است مگر آنکه گزینه --restorefile یا --uuid (یا هر دو) تعیین شده باشند.

متغیرها (VARIABLES)

VG

نام گروه حجم (Volume Group). برای نام‌های معتبر به lvm(8) مراجعه فرمایید.

PV

نام حجم فیزیکی (Physical Volume)، یک مسیر دستگاه در مسیر /dev. برای دستوراتی که اکستنت‌های فیزیکی را مدیریت می‌کنند، آرگومان مکانی PV عموماً یک پسوند مشخص‌کننده یک محدوده (یا چند محدوده) از اکستنت‌های فیزیکی (PE) را می‌پذیرد. هنگامی که نخستین PE حذف شود، پیش‌فرض آن آغاز دستگاه خواهد بود و هنگامی که آخرین PE حذف شود، پیش‌فرض آن پایان دستگاه است. محدوده ابتدا و انتها (شامل دو طرف): PV[:PE-PE]... محدوده ابتدا و طول (شمارش از ۰): PV[:PE+PE]...

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 جایگزین شود.

مثال‌ها (EXAMPLES)

افزودن دو PV به یک VG:
vgextend vg00 /dev/sda4 /dev/sdn1

همچنین ببینید (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)