نام (NAME)

vgcfgrestore - بازیابی متادیتا و پیکربندی گروههای حجم LVM از فایل پشتیبان

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

vgcfgrestore [گزینهها] گروه_حجم

توضیحات (DESCRIPTION)

دستور vgcfgrestore متادیتای آسیبدیده یا از دسترفته یک گروه حجم (Volume Group) را از روی فایلهای پشتیبان یا آرشیو LVM بازیابی میکند. این ابزار متادیتای یک VG را از یک فایل پشتیبان متنی که توسط vgcfgbackup(8) ایجاد شده است، بازگردانی می‌کند. این عمل متادیتای VG را بر روی دستگاه‌های مشخص‌شده در فایل پشتیبان می‌نویسد.

می‌توان یک فایل پشتیبان را با گزینه --file مشخص کرد. اگر فایل پشتیبانی مشخص نشود، از تازه‌ترین فایل پشتیبان موجود استفاده می‌شود. برای مشاهده فهرستی از فایل‌های پشتیبان و آرشیو موجود برای یک VG، از گزینه --list استفاده کنید.

هشدار: هنگامی که یک VG شامل استخرهای کم‌حجم (thin pools) باشد، تغییرات ایجادشده در متادیتای کم‌حجم قابل بازگشت نیستند و در صورتی که متادیتای thin تغییر کرده باشد، ممکن است داده‌ها از دست بروند. در این حالت برای بازیابی متادیتا، استفاده از گزینه اجبار (--force) الزامی است.

کاربرد (USAGE)

بازیابی متادیتای VG از آخرین نسخه پشتیبان:

vgcfgrestore VG

—

بازیابی متادیتای VG از فایل مشخص‌شده:

vgcfgrestore -f|--file String VG

—

فهرست کردن تمام نسخه‌های پشتیبان متادیتای VG:

vgcfgrestore -l|--list VG

—

فهرست کردن یک فایل پشتیبان متادیتای VG:

vgcfgrestore -l|--list -f|--file String

—

گزینه‌های اختصاصی دستور:

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

گزینه‌ها (OPTIONS)

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

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

-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|--file String
خواندن نسخه پشتیبان متادیتا از فایل مشخص‌شده. معمولاً این فایل توسط دستور vgcfgbackup ایجاد شده است.

--force ...
اجبار به بازیابی متادیتا حتی در صورت وجود حجم‌های منطقی استخر کم‌حجم (thin pool LVs). با نهایت احتیاط استفاده شود. اکثر تغییرات اعمال‌شده بر متادیتای thin غیرقابل‌بازگشت هستند. اگر متادیتایی را بازیابی کنید که دقیقاً با متادیتای کرنل استخر thin مطابقت نداشته باشد، ممکن است داده‌های خود را از دست بدهید.

-h|--help
نمایش متن راهنما.

--journal String
ثبت اطلاعات در ژورنال systemd. این اطلاعات علاوه بر مواردی است که توسط تنظیم log/journal در lvm.conf فعال می‌شود:
command: ثبت اطلاعات پیرامون دستور؛
output: ثبت خروجی پیش‌فرض دستور؛
debug: ثبت خروجی اشکال‌زدایی کامل دستور.

-l|--list
فهرست کردن فایل‌های پشتیبان و آرشیو متادیتا مربوط به گروه حجم (VG). می‌تواند به همراه --file به کار رود. این گزینه VG را بازیابی نمی‌کند.

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

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

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

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

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

--profile String
نام مستعار برای --commandprofile یا --metadataprofile بسته به دستور فراخوانده‌شده.

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

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

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

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

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

متغیرها (VARIABLES)

VG

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

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

نکات (NOTES)

برای جایگزینی PVها، دستور vgdisplay --partial --verbose شناسه‌های یکتا (UUID) و اندازه هر کدام از PVهایی را که دیگر وجود ندارند نشان خواهد داد. اگر یکی از PVهای موجود در VG مفقود شده باشد و مایلید PV دیگری با همان اندازه را جایگزین آن کنید، از دستور

pvcreate --restorefile filename --uuid uuid

(به‌همراه آرگومان‌های تکمیلی متناسب) استفاده نمایید تا آن را با همان UUID مربوط به PV مفقود مقداردهی اولیه کند. این مرحله را برای تمام PVهای مفقود دیگر در VG تکرار کنید. سپس از دستور

vgcfgrestore --file filename

برای بازیابی متادیتای VG استفاده فرمایید.

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