نام (NAME)

vgrename - تغییر نام یک گروه حجم در سامانه LVM

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

vgrename [گزینهها] نام_قدیم نام_جدید
vgrename [گزینهها] شناسه_UUID نام_جدید

توضیحات (DESCRIPTION)

دستور vgrename نام یک گروه حجم موجود را تغییر میدهد و پیوندهای نمادین موجود در /dev را به طور خودکار بهروزرسانی میکند.

تمام گروه‌های حجم (VG) قابل مشاهده در سامانه باید نام‌های متفاوتی داشته باشند؛ در غیر این صورت، بسیاری از دستورهای LVM از اجرا خودداری می‌کنند یا پیام‌های هشدار صادر می‌کنند. گروه‌های حجم با نام‌های یکسان ممکن است زمانی پدید آیند که دیسک‌ها میان رایانه‌های مختلف جابه‌جا شوند یا فیلترها تغییر یابند. اگر دیسکی که به تازگی متصل شده است دارای یک VG هم‌نام با VG دربرگیرنده سیستم‌فایل ریشه باشد، ممکن است رایانه به درستی راه‌اندازی نشود. هنگامی که دو VG نام یکسانی دارند، می‌توان از شناسه UUID گروه حجم به جای نام مبدا VG استفاده کرد.

نحوه استفاده (USAGE)

تغییر نام یک گروه حجم (VG):

vgrename VG VG_new

تغییر نام یک گروه حجم با مشخص کردن شناسه UUID گروه حجم:

vgrename String VG_new

گزینه‌های عمومی برای این دستور:

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

گزینه‌ها (OPTIONS)

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

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

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

-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: ثبت اطلاعات کامل اشکال‌زدایی دستور.

--lockopt String
برای ارسال گزینه‌های موارد خاص به lvmlockd استفاده می‌شود. برای اطلاعات بیشتر به lvmlockd(8) مراجعه کنید.

--longhelp
نمایش متن راهنمای بلند و جامع.

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

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

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

-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 ...
تنظیم سطح تفصیل خروجی. برای افزایش جزئیات پیام‌های ارسالی به خروجی استاندارد و خطای استاندارد، ۱ تا ۴ بار تکرار کنید.

--version
نمایش اطلاعات نسخه.

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

متغیرها (VARIABLES)

VG

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

String

برای اطلاعات درباره محتوای رشته به توضیحات گزینه مربوطه مراجعه کنید.

Size[UNIT]

اندازه (Size) یک عدد ورودی است که یک واحد اختیاری را می‌پذیرد. واحدهای ورودی همواره به صورت مقادیر پایه دو در نظر گرفته می‌شوند، بدون در نظر گرفتن بزرگی یا کوچکی حروف؛ برای مثال '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)

تغییر نام گروه حجم "vg02" به "myvg":
vgrename vg02 myvg

تغییر نام گروه حجم دارای شناسه UUID مشخص‌شده به "myvg":
vgrename Zvlifi-Ep3t-e0Ng-U42h-o0ye-KHu1-nl7Ns4 myvg

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