.TH "VGRENAME" "8" "مه ۲۰۲۵" "lvm2" "دستورهای مدیریتی و نگهداری"
.SH "نام (NAME)"
vgrename \- تغییر نام یک گروه حجم در سامانه LVM
.SH "خلاصه دستور (SYNOPSIS)"
\fBvgrename\fP [\fIگزینهها\fR] \fIنام_قدیم\fR \fIنام_جدید\fR
.br
\fBvgrename\fP [\fIگزینهها\fR] \fIشناسه_UUID\fR \fIنام_جدید\fR
.SH "توضیحات (DESCRIPTION)"
دستور \fBvgrename\fR نام یک گروه حجم موجود را تغییر میدهد و پیوندهای نمادین موجود در /dev را به طور خودکار بهروزرسانی میکند.
.P
تمام گروه‌های حجم (VG) قابل مشاهده در سامانه باید نام‌های متفاوتی داشته باشند؛ در غیر این صورت، بسیاری از دستورهای LVM از اجرا خودداری می‌کنند یا پیام‌های هشدار صادر می‌کنند. گروه‌های حجم با نام‌های یکسان ممکن است زمانی پدید آیند که دیسک‌ها میان رایانه‌های مختلف جابه‌جا شوند یا فیلترها تغییر یابند. اگر دیسکی که به تازگی متصل شده است دارای یک VG هم‌نام با VG دربرگیرنده سیستم‌فایل ریشه باشد، ممکن است رایانه به درستی راه‌اندازی نشود. هنگامی که دو VG نام یکسانی دارند، می‌توان از شناسه UUID گروه حجم به جای نام مبدا VG استفاده کرد.
.
.SH "نحوه استفاده (USAGE)"
.
تغییر نام یک گروه حجم (VG):
.br
.P
\fBvgrename\fP \fIVG\fP \fIVG\fP\fI_new\fP
.br
.RS 4
.na
[ COMMON_OPTIONS ]
.ad
.RE
.P
تغییر نام یک گروه حجم با مشخص کردن شناسه UUID گروه حجم:
.br
.P
\fBvgrename\fP \fIString\fP \fIVG\fP\fI_new\fP
.br
.RS 4
.na
[ COMMON_OPTIONS ]
.ad
.RE
.P
گزینه‌های عمومی برای این دستور:
.
.RS 4
.na
[ \fB\-A\fP|\fB\-\-autobackup\fP \fBy\fP|\fBn\fP ]
.br
[ \fB\-f\fP|\fB\-\-force\fP ]
.br
[    \fB\-\-reportformat\fP \fBbasic\fP|\fBjson\fP|\fBjson_std\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) تقدم دارند.
آرگومان 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
دستگاه‌های قابل مشاهده و در دسترس دستور را محدود می‌کند.
دستگاه‌هایی که در فهرست نباشند مفقود به نظر خواهند رسید. این گزینه را می‌توان تکرار کرد، یا فهرستی از دستگاه‌ها را با کاما جدا کرد. این گزینه بر فایل devices تقدم دارد.
.
.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 فعال شده‌اند.
مقدار command: ثبت اطلاعات درباره دستور.
مقدار output: ثبت خروجی پیش‌فرض دستور.
مقدار debug: ثبت اطلاعات کامل اشکال‌زدایی دستور.
.
.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\-\-profile\fP \fIString\fP
.br
نام مستعاری برای \-\-commandprofile یا \-\-metadataprofile، بسته به دستور.
.
.HP
\fB\-q\fP|\fB\-\-quiet\fP ...
.br
فرونشاندن پیام‌های خروجی و گزارش‌ها. بر \-\-debug و \-\-verbose تقدم دارد.
یک بار تکرار کنید تا هرگونه پرسش با پاسخ '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
تنظیم سطح تفصیل خروجی. برای افزایش جزئیات پیام‌های ارسالی به خروجی استاندارد و خطای استاندارد، ۱ تا ۴ بار تکرار کنید.
.
.HP
\fB\-\-version\fP
.br
نمایش اطلاعات نسخه.
.
.HP
\fB\-y\fP|\fB\-\-yes\fP
.br
به صورت تعاملی درخواست تایید نکن و همیشه پاسخ را yes فرض کن. با احتیاط بسیار زیاد استفاده کنید.
(برای فرض خودکار no، به \-qq مراجعه کنید.)
.
.SH "متغیرها (VARIABLES)"
.
.TP
.I VG
نام گروه حجم (Volume Group). برای نام‌های معتبر به \fBlvm\fP(8) مراجعه کنید.
.TP
.I String
برای اطلاعات درباره محتوای رشته به توضیحات گزینه مربوطه مراجعه کنید.
.TP
.IR Size [UNIT]
اندازه (Size) یک عدد ورودی است که یک واحد اختیاری را می‌پذیرد.
واحدهای ورودی همواره به صورت مقادیر پایه دو در نظر گرفته می‌شوند، بدون در نظر گرفتن بزرگی یا کوچکی حروف؛ برای مثال '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).
(این مورد نباید با گزینه کنترل خروجی \-\-units اشتباه گرفته شود، که در آن حروف بزرگ به معنای مضرب‌های ۱۰۰۰ هستند.)
.
.SH "متغیرهای محیطی (ENVIRONMENT VARIABLES)"
.
برای اطلاعات درباره متغیرهای محیطی استفاده‌شده توسط lvm به \fBlvm\fP(8) مراجعه کنید.
برای مثال، معمولاً می‌توان LVM_VG_NAME را به جای پارامتر الزامی VG جایگزین کرد.
.
.SH "مثال‌ها (EXAMPLES)"
.
تغییر نام گروه حجم "vg02" به "myvg":
.br
.B vgrename "vg02" "myvg"
.P
تغییر نام گروه حجم دارای شناسه UUID مشخص‌شده به "myvg":
.br
.B vgrename Zvlifi-Ep3t\-e0Ng\-U42h\-o0ye\-KHu1\-nl7Ns4 myvg
.
.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)