.TH "VGCFGRESTORE" "8" "مه ۲۰۲۵" "lvm2" "دستورهای مدیریتی و نگهداری"
.
.SH "نام (NAME)"
vgcfgrestore \- بازیابی متادیتا و پیکربندی گروههای حجم LVM از فایل پشتیبان
.
.SH "خلاصه دستور (SYNOPSIS)"
\fBvgcfgrestore\fP [\fIگزینهها\fR] \fIگروه_حجم\fR
.
.SH "توضیحات (DESCRIPTION)"
دستور \fBvgcfgrestore\fR متادیتای آسیبدیده یا از دسترفته یک گروه حجم (Volume Group) را از روی فایلهای پشتیبان یا آرشیو LVM بازیابی میکند. این ابزار متادیتای یک VG را از یک فایل پشتیبان متنی که توسط
.BR vgcfgbackup (8)
ایجاد شده است، بازگردانی می‌کند. این عمل متادیتای VG را بر روی دستگاه‌های مشخص‌شده در فایل پشتیبان می‌نویسد.
.P
می‌توان یک فایل پشتیبان را با گزینه
.B \-\-file
مشخص کرد. اگر فایل پشتیبانی مشخص نشود، از تازه‌ترین فایل پشتیبان موجود استفاده می‌شود. برای مشاهده فهرستی از فایل‌های پشتیبان و آرشیو موجود برای یک VG، از گزینه
.B \-\-list
استفاده کنید.
.P
\fBهشدار:\fP هنگامی که یک VG شامل استخرهای کم‌حجم (thin pools) باشد، تغییرات ایجادشده در متادیتای کم‌حجم قابل بازگشت نیستند و در صورتی که متادیتای thin تغییر کرده باشد، ممکن است داده‌ها از دست بروند. در این حالت برای بازیابی متادیتا، استفاده از گزینه اجبار (\fB\-\-force\fP) الزامی است.
.
.SH "کاربرد (USAGE)"
.
بازیابی متادیتای VG از آخرین نسخه پشتیبان:
.br
.P
\fBvgcfgrestore\fP \fIVG\fP
.br
.RS 4
.na
[ گزینه‌های عمومی / COMMON_OPTIONS ]
.ad
.RE
.P
\(em
.P
بازیابی متادیتای VG از فایل مشخص‌شده:
.br
.P
\fBvgcfgrestore\fP \fB\-f\fP|\fB\-\-file\fP \fIString\fP \fIVG\fP
.br
.RS 4
.na
[ گزینه‌های عمومی / COMMON_OPTIONS ]
.ad
.RE
.P
\(em
.P
فهرست کردن تمام نسخه‌های پشتیبان متادیتای VG:
.br
.P
\fBvgcfgrestore\fP \fB\-l\fP|\fB\-\-list\fP \fIVG\fP
.br
.RS 4
.na
[ گزینه‌های عمومی / COMMON_OPTIONS ]
.ad
.RE
.P
\(em
.P
فهرست کردن یک فایل پشتیبان متادیتای VG:
.br
.P
\fBvgcfgrestore\fP \fB\-l\fP|\fB\-\-list\fP \fB\-f\fP|\fB\-\-file\fP \fIString\fP
.br
.RS 4
.na
[ گزینه‌های عمومی / COMMON_OPTIONS ]
.ad
.RE
.RS 4
[ \fIVG\fP ]
.RE
.P
\(em
.P
گزینه‌های اختصاصی دستور:
.
.RS 4
.na
[ \fB\-M\fP|\fB\-\-metadatatype\fP \fBlvm2\fP ]
.br
[    \fB\-\-force\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\-\-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\-f\fP|\fB\-\-file\fP \fIString\fP
.br
خواندن نسخه پشتیبان متادیتا از فایل مشخص‌شده. معمولاً این فایل توسط دستور \fBvgcfgbackup\fP ایجاد شده است.
.
.HP
\fB\-\-force\fP ...
.br
اجبار به بازیابی متادیتا حتی در صورت وجود حجم‌های منطقی استخر کم‌حجم (thin pool LVs). با نهایت احتیاط استفاده شود. اکثر تغییرات اعمال‌شده بر متادیتای thin غیرقابل‌بازگشت هستند. اگر متادیتایی را بازیابی کنید که دقیقاً با متادیتای کرنل استخر thin مطابقت نداشته باشد، ممکن است داده‌های خود را از دست بدهید.
.
.HP
\fB\-h\fP|\fB\-\-help\fP
.br
نمایش متن راهنما.
.
.HP
\fB\-\-journal\fP \fIString\fP
.br
ثبت اطلاعات در ژورنال systemd. این اطلاعات علاوه بر مواردی است که توسط تنظیم log/journal در lvm.conf فعال می‌شود:
.br
\fBcommand\fP: ثبت اطلاعات پیرامون دستور؛
.br
\fBoutput\fP: ثبت خروجی پیش‌فرض دستور؛
.br
\fBdebug\fP: ثبت خروجی اشکال‌زدایی کامل دستور.
.
.HP
\fB\-l\fP|\fB\-\-list\fP
.br
فهرست کردن فایل‌های پشتیبان و آرشیو متادیتا مربوط به گروه حجم (VG). می‌تواند به همراه \fB\-\-file\fP به کار رود. این گزینه VG را بازیابی نمی‌کند.
.
.HP
\fB\-\-lockopt\fP \fIString\fP
.br
جهت ارسال گزینه‌ها در موارد خاص به lvmlockd استفاده می‌شود. برای اطلاعات بیشتر به \fBlvmlockd\fP(8) مراجعه کنید.
.
.HP
\fB\-\-longhelp\fP
.br
نمایش متن راهنمای تفصیلی و طولانی.
.
.HP
\fB\-M\fP|\fB\-\-metadatatype\fP \fBlvm2\fP
.br
نوع متادیتای روی دیسک را تعیین می‌کند. مقدار \fBlvm2\fP (یا صرفاً \fB2\fP) فرمت استاندارد و فعلی است. مقدار \fBlvm1\fP (یا صرفاً \fB1\fP) منسوخ شده و دیگر استفاده نمی‌شود.
.
.HP
\fB\-\-nohints\fP
.br
عدم استفاده از فایل راهنماها (hints file) برای یافتن دستگاه‌های حامل PV. هنگامی که از راهنماها استفاده نشود، ممکن است دستور دستگاه‌های بیشتری را برای یافتن PVها بررسی کند. دستور همچنان باطل‌سازی استاندارد فایل راهنما را در مواقع لازم انجام خواهد داد.
.
.HP
\fB\-\-nolocking\fP
.br
غیرفعال کردن سازوکار قفل‌گذاری. با احتیاط استفاده شود؛ اجرای همزمان دستورات ممکن است نتایج نادرستی ایجاد کند.
.
.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 "نکات (NOTES)"
.
برای جایگزینی PVها، دستور
.B vgdisplay \-\-partial \-\-verbose
شناسه‌های یکتا (UUID) و اندازه هر کدام از PVهایی را که دیگر وجود ندارند نشان خواهد داد. اگر یکی از PVهای موجود در VG مفقود شده باشد و مایلید PV دیگری با همان اندازه را جایگزین آن کنید، از دستور
.nf
\fBpvcreate \-\-restorefile filename \-\-uuid uuid\fP
.fi
(به‌همراه آرگومان‌های تکمیلی متناسب) استفاده نمایید تا آن را با همان UUID مربوط به PV مفقود مقداردهی اولیه کند. این مرحله را برای تمام PVهای مفقود دیگر در VG تکرار کنید. سپس از دستور
.nf
\fBvgcfgrestore \-\-file filename\fP
.fi
برای بازیابی متادیتای VG استفاده فرمایید.
.
.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)