نام (NAME)

vgexport - صادر کردن و غیرفعالسازی ثبت گروه حجم جهت انتقال به سامانهای دیگر

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

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

توضیحات (DESCRIPTION)

دستور vgexport یک گروه حجم غیرفعال را در وضعیت صادرشده (exported) قرار میدهد تا دیسکهای آن بدون تداخل برای انتقال و اتصال به سیستمی دیگر آماده شوند. این وضعیت تضمین می‌کند که گروه حجم و دیسک‌های فیزیکی آن در حال استفاده نبوده و تا زمانی که مجدداً توسط دستور vgimport(8) وارد (import) نشوند، قابل استفاده نخواهند بود. قرار دادن یک گروه حجم در حالت غیرقابل‌استفاده و برون‌خط (آفلاین)، در مواقعی همچون جابه‌جایی فیزیکی دیسک‌ها به یک سامانه دیگر بسیار سودمند است. صادر کردن گروه حجم همچنین سطحی از محافظت را در برابر دسترسی تصادفی به حجم‌های منطقی (LVs) یا استفاده زودهنگام توسط سرویس‌های خودکار سیستمی فراهم می‌سازد.

یک گروه حجم تا زمانی که تمامی حجم‌های منطقی (LVs) آن غیرفعال (inactive) نشده باشند، قابل صادر کردن نیست.

دستورات LVM گروه‌های حجم صادرشده را نادیده می‌گیرند و در صورت تلاش برای استفاده از آن‌ها خطا صادر می‌کنند.

برای یک گروه حجم صادرشده، دستور vgs حرف "x" را در سومین مشخصه VG نمایش می‌دهد و دستور pvs حرف "x" را در دومین مشخصه PV نشان خواهد داد. همچنین هر دو دستور vgs و pvs مقدار "exported" را در فیلد گزارشی export نمایش می‌دهند.

دستور vgexport شناسه سامانه (system ID) گروه حجم را پاک می‌کند و دستور vgimport شناسه سامانه را با میزبان اجراکننده تطبیق می‌دهد (اگر میزبان دارای system ID باشد).

کاربرد (USAGE)

صادر کردن گروههای حجم مشخصشده:

vgexport VG|Tag|Select ...

صادر کردن تمامی گروههای حجم:

vgexport -a|--all

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

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

گزینه‌ها (OPTIONS)

-a|--all
صادر کردن تمامی گروه‌های حجم موجود در سیستم.

--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 نخواهد کرد. این گزینه برای مقاصد آزمایش و اشکال‌زدایی کاربرد دارد.

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

-S|--select String
انتخاب اشیاء برای پردازش و گزارش‌گیری بر اساس معیارهای مشخص‌شده. نحو معیارها در --select help و lvmreport(7) تشریح شده است. برای دستورات گزارش‌گیری، یک سطر به ازای هر شیء منطبق با معیارها نمایش داده می‌شود. برای فیلدهای قابل انتخاب اشیاء به --options help مراجعه نمایید. سطرها می‌توانند با یک فیلد اضافی "selected" (-o selected) نمایش داده شوند که در صورت انطباق سطر با گزینش مقدار ۱ و در غیر این صورت مقدار ۰ را نشان می‌دهد. برای دستورات غیرگزارشی که موجودیت‌های LVM را پردازش می‌کنند، از گزینش برای انتخاب موارد جهت پردازش استفاده می‌شود.

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

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

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

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

متغیرها (VARIABLES)

VG

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

Tag

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

Select

گزینش نشان می‌دهد که در صورت استفاده از گزینه --select می‌توان پارامتر موضعی الزامی را حذف کرد. هیچ آرگومانی در این موقعیت قرار نمی‌گیرد.

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

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