نام (NAME)

vgcreate - ایجاد یک گروه حجم (Volume Group) جدید در LVM

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

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

توضیحات (DESCRIPTION)

دستور vgcreate یک گروه حجم جدید را بر روی یک یا چند حجم فیزیکی (PV) ایجاد میکند. در صورت آماده نبودن دستگاهها، میتواند آنها را به طور خودکار مقداردهی کند. گزینه‌های pvcreate برای مقداردهی اولیه‌ی دستگاه‌ها نیز همراه با vgcreate در دسترس هستند.

هنگامی که vgcreate از یک PV موجود استفاده می‌کند، مقادیر فعلی آن PV برای اندازه متادیتا، شروع PE و غیره استفاده می‌شوند، حتی اگر مقادیر متفاوتی در دستور vgcreate تعیین شده باشد. برای تغییر این مقادیر، ابتدا باید دستور pvremove را روی دستگاه اجرا کنید.

کاربرد (USAGE)

vgcreate VG_new PV ...

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

گزینه‌ها (OPTIONS)

--addtag Tag
افزودن یک تگ (برچسب) به یک PV، VG یا LV. این گزینه می‌تواند برای افزودن چندین برچسب به طور همزمان تکرار شود. برای اطلاعات بیشتر درباره برچسب‌ها به lvm(8) مراجعه کنید.

--alloc contiguous|cling|cling_by_tags|normal|anywhere|inherit
تعیین سیاست تخصیص زمانی که دستوری نیاز به تخصیص اکستنت‌های فیزیکی (PE) از VG دارد. هر VG و LV دارای یک سیاست تخصیص است که می‌توان آن را با vgchange/lvchange تغییر داد یا در خط فرمان نادیده گرفت (override). سیاست normal قوانین معمول مانند عدم قرار دادن بخش‌های موازی (stripes) روی یک PV یکسان را اعمال می‌کند. سیاست inherit سیاست VG را بر روی یک LV اعمال می‌کند. سیاست contiguous مستلزم آن است که PEهای جدید در مجاورت PEهای موجود قرار گیرند. سیاست cling اکستنت‌های فیزیکی جدید را روی همان PV که PEهای موجود در همان خط (stripe) از LV قرار دارند قرار می‌دهد. اگر PEهای کافی برای تخصیص وجود داشته باشد اما سیاست normal از آن‌ها استفاده نکند، سیاست anywhere از آن‌ها استفاده خواهد کرد حتی اگر کارایی را کاهش دهد؛ برای نمونه با قرار دادن دو بخش روی یک PV یکسان. آرگومان‌های اختیاری مکانی PV در خط فرمان نیز می‌توانند برای محدود کردن اینکه کدام PVها برای تخصیص توسط دستور استفاده شوند به کار روند. برای اطلاعات بیشتر درباره تخصیص، به lvm(8) مراجعه کنید.

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

-c|--clustered y|n
این گزینه مختص clvm بود و اکنون با گزینه --shared در lvmlockd(8) جایگزین شده است.

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

--config String
تنظیمات پیکربندی برای دستور. این تنظیمات مقادیر lvm.conf(5) را بازنویسی می‌کنند. آرگومان رشته‌ای از همان فرمت lvm.conf(5) استفاده می‌کند یا می‌تواند از نحو بخش/فیلد (section/field) استفاده نماید. برای اطلاعات بیشتر درباره پیکربندی به 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
دستگاه‌هایی را که برای دستور قابل مشاهده و دسترسی هستند محدود می‌کند. دستگاه‌هایی که در فهرست قرار ندارند ناموجود تلقی خواهند شد. این گزینه می‌تواند تکرار شود، یا فهرستی از دستگاه‌ها را با ویرگول بپذیرد. این گزینه فایل devices را بازنویسی می‌کند.

--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) مراجعه کنید.

--locktype sanlock|dlm|none
مشخص کردن مستقیم نوع قفل VG به جای استفاده از --shared. برای اطلاعات بیشتر به lvmlockd(8) مراجعه فرمایید.

--longhelp
نمایش متن راهنمای طولانی.

-l|--maxlogicalvolumes Number
حداکثر تعداد مجاز LVها در یک VG را تعیین می‌کند.

-p|--maxphysicalvolumes Number
حداکثر تعداد مجاز PVها را که می‌توانند به این VG تعلق داشته باشند مشخص می‌کند. مقدار ۰ هرگونه محدودیت را برمی‌دارد. برای تعداد زیاد PVها، جهت بهبود کارایی گزینه‌های --pvmetadatacopies و --vgmetadatacopies را نیز بررسی کنید.

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

--metadatasize Size[m|UNIT]
مقدار تقریبی فضای استفاده‌شده برای هر ناحیه متادیتای VG. ممکن است این مقدار گرد شود.

-M|--metadatatype lvm2
نوع متادیتای روی دیسک را برای استفاده مشخص می‌کند. فرمت lvm2 (یا فقط 2) فرمت استاندارد فعلی است. فرمت lvm1 (یا فقط 1) دیگر مورد استفاده قرار نمی‌گیرد.

--nohints
عدم استفاده از فایل نکات (hints) برای یافتن دستگاه‌های حامل PV. ممکن است در صورت عدم استفاده از نکات، یک دستور برای پیدا کردن PVها دستگاه‌های بیشتری را بخواند. این دستور همچنان در صورت نیاز ابطال استاندارد فایل نکات را انجام خواهد داد.

--nolocking
غیرفعال کردن قفل‌گذاری. با احتیاط استفاده شود؛ دستورات همزمان ممکن است نتایج نادرستی ایجاد کنند.

-s|--physicalextentsize Size[m|UNIT]
اندازه اکستنت فیزیکی (PE) مربوط به PVها در این VG را تنظیم می‌کند. این مقدار باید توانی از ۲ و حداقل برابر با ۱ سکتور (که در آن اندازه سکتور برابر با بزرگ‌ترین اندازه سکتور PVهای فعلی در VG است)، یا حداقل ۱۲۸ KiB باشد. پس از تنظیم این مقدار، تغییر آن بدون ایجاد مجدد VG بسیار دشوار خواهد بود، مگر آنکه نیازی به جابه‌جایی هیچ اکستنتی نباشد.

--profile String
نام مستعاری برای --commandprofile یا --metadataprofile، بسته به نوع دستور.

--pvmetadatacopies 0|1|2
تعداد نواحی متادیتا که بر روی یک PV برای ذخیره‌سازی متادیتای VG کنار گذاشته می‌شوند. اگر ۲ باشد، یک رونوشت از متادیتای VG در ابتدای PV و دومین رونوشت در انتهای آن ذخیره می‌شود. اگر ۱ باشد، یک رونوشت از متادیتای VG در ابتدای PV ذخیره می‌گردد. اگر ۰ باشد، هیچ رونوشتی از متادیتای VG روی PV داده‌شده ذخیره نخواهد شد. این امر ممکن است در VGهایی که شامل تعداد زیادی PV هستند مفید باشد (اما محدودیت‌هایی در امکان استفاده بعدی از vgsplit ایجاد می‌کند).

-q|--quiet ...
بی‌صدا کردن خروجی و پیام‌های لاگ. این گزینه تنظیمات --debug و --verbose را خنثی می‌کند. با یک بار تکرار دیگر، اعلان‌های تایید نیز نادیده گرفته شده و پاسخ منفی فرض می‌شود.

--reportformat basic|json|json_std
قالب فعلی خروجی گزارش‌ها را که به صورت سراسری توسط تنظیم report/output_format در lvm.conf(5) تعیین شده است، بازنویسی می‌کند. قالب basic قالب اصلی به همراه سطرها و ستون‌ها است. اگر در هر دستور بیش از یک گزارش وجود داشته باشد، پیش از هر گزارش نام گزارش برای تفکیک درج می‌شود. قالب json خروجی گزارش را به فرمت JSON تولید می‌کند. قالب json_std خروجی گزارش را به فرمت JSON تولید می‌کند که تطابق بیشتری با استاندارد JSON دارد. برای اطلاعات بیشتر به lvmreport(7) مراجعه کنید.

--setautoactivation y|n
ویژگی فعال‌سازی خودکار (autoactivation) را روی یک VG یا LV تنظیم می‌کند. این ویژگی را با دستورات vgs یا lvs همراه با "-o autoactivation"; مشاهده کنید. هنگامی که ویژگی فعال‌سازی خودکار غیرفعال باشد، VG یا LV توسط دستوری که فعال‌سازی خودکار انجام می‌دهد (مانند vgchange، lvchange یا pvscan با گزینه -aay) فعال نخواهد شد. اگر فعال‌سازی خودکار روی یک VG غیرفعال شود، هیچ LVای در آن VG به طور خودکار فعال نمی‌شود و ویژگی فعال‌سازی خودکار LV نیز اثری نخواهد داشت. اگر فعال‌سازی خودکار روی یک VG فعال باشد، می‌توان آن را برای تک‌تک LVها غیرفعال نمود.

--shared
ایجاد یک VG اشتراکی با استفاده از lvmlockd در صورتی که LVM با پشتیبانی از lockd کامپایل شده باشد. سرویس lvmlockd بسته به اینکه کدام مدیر قفل در حال اجرا است، نوع قفل sanlock یا dlm را انتخاب خواهد کرد. این ویژگی امکان اشتراک‌گذاری یک VG روی دستگاه‌های مشترک را برای چندین میزبان فراهم می‌کند. lvmlockd و یک مدیر قفل باید پیکربندی شده و در حال اجرا باشند. برای اطلاعات بیشتر درباره VGهای مشترک به lvmlockd(8) مراجعه کنید.

--systemid String
شناسه سیستمی (system ID) را که به VG جدید داده خواهد شد مشخص می‌کند و شناسه سیستم میزبانی را که دستور را اجرا می‌کند بازنویسی می‌نماید. به طور معمول یک VG بدون این گزینه ایجاد می‌شود که در این صورت شناسه سیستم میزبان ایجادکننده به آن داده می‌شود. استفاده از این گزینه مستلزم احتیاط است، زیرا ممکن است شناسه سیستم VG جدید با شناسه سیستم میزبان اجراکننده تطابق نداشته باشد و در نتیجه VG برای آن میزبان غیرقابل دسترس شود. برای اطلاعات بیشتر به lvmsystemid(7) مراجعه نمایید.

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

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

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

--[vg]metadatacopies all|unmanaged|Number
تعداد رونوشت‌های متادیتای VG که نگهداری می‌شوند. متادیتای VG در نواحی متادیتای VG بر روی PVهای موجود در آن VG نگهداری می‌شود، یعنی فضای اختصاص‌یافته در ابتدا و/یا انتهای PVها. نگهداری یک رونوشت از متادیتای VG روی هر PV می‌تواند عملکرد را در VGهایی با تعداد بسیار زیاد PV کاهش دهد. هنگامی که این عدد روی مقداری غیرصفر تنظیم شود، LVM به صورت خودکار PVهایی را برای ذخیره‌سازی متادیتا انتخاب می‌کند و برای رسیدن به تعداد مشخص‌شده از پرچم‌های metadataignore روی PVها استفاده می‌نماید. این عدد می‌تواند با مقادیر رشته‌ای ویژه نیز جایگزین شود: unmanaged باعث می‌شود LVM پرچم‌های metadataignore روی PV را به طور خودکار مدیریت نکند. all باعث می‌شود LVM ابتدا پرچم‌های metadataignore را روی تمام PVها پاک کرده و سپس به حالت مدیریت‌نشده درآید.

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

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

متغیرها (VARIABLES)

VG

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

PV

نام حجم فیزیکی (Physical Volume)، مسیر دستگاهی در زیر /dev. برای دستوراتی که اکستنت‌های فیزیکی را مدیریت می‌کنند، آرگومان مکانی PV عموماً یک پسوند مشخص‌کننده یک محدوده (یا چندین محدوده) از اکستنت‌های فیزیکی (PEs) را می‌پذیرد. در صورت حذف نخستین 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)

ایجاد یک VG با دو PV با استفاده از اندازه پیش‌فرض اکستنت فیزیکی:
vgcreate myvg /dev/sdk1 /dev/sdl1

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