نام (NAME)

lvconvert - تبدیل و تغییر ساختار نوع چینش حجم منطقی در LVM

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

lvconvert موقعیت_گزینهها [گزینهها] حجم_منطقی

توضیحات (DESCRIPTION)

دستور lvconvert ساختار یا طرحبندی حجم منطقی (LV) را تبدیل میکند؛ به عنوان مثال تبدیل به حجم آینهای (mirror)، ساختار RAID، حجم پویا (thin pool)، یا فعالسازی ذخیرهسازی کش (cache). این ابزار همچنین شامل امکاناتی برای نگهداری داده‌های حجم‌های منطقی است. نوع حجم منطقی (LV type) ساختار چینش داده‌ها و افزونگی (redundancy) را کنترل می‌کند و به آن نوع سگمنت (segtype) نیز گفته می‌شود.

برای نمایش نوع فعلی حجم منطقی، این دستور را اجرا کنید:

lvs -o name,segtype LV

در برخی موارد، یک حجم منطقی (LV) لایه منفردی از نگاشت‌کننده دستگاه (device mapper یا dm) بر روی دستگاه‌های فیزیکی است. در موارد دیگر، حجم‌های منطقی پنهان (دستگاه‌های dm) میان حجم منطقی مرئی و دستگاه‌های فیزیکی لایه‌بندی می‌شوند. به این حجم‌های منطقی در لایه‌های میانی، زیرحجم منطقی (sub LV) گفته می‌شود. دستوری که بر روی یک حجم منطقی مرئی اجرا می‌شود گاهی به جای حجم مشخص‌شده، بر روی یک زیرحجم منطقی عمل می‌کند. در موارد دیگر، زیرحجم منطقی باید مستقیماً در خط فرمان مشخص شود.

زیرحجم‌های منطقی را می‌توان با این دستور نمایش داد:

lvs -a

نوع linear (خطی) در حالتی که یک خط داده (stripe) وجود داشته باشد، معادل نوع striped است. در این حالت، این دو نوع گاهی می‌توانند به جای یکدیگر استفاده شوند.

در بیشتر موارد، نوع mirror منسوخ شده است و باید از نوع raid1 استفاده شود؛ هر دوی آن‌ها پیاده‌سازی‌هایی از آینه‌سازی (mirroring) هستند.

انواع آرایه‌های خط‌کشی‌شده RAID عبارتند از: raid0/raid0_meta، raid5 (نام مستعار برای raid5_ls)، raid6 (نام مستعار برای raid6_zr) و raid10 (نام مستعار برای raid10_near).

برخلاف آینه‌سازی، ساختارهای raid5 و raid6 داده‌ها را به‌صورت خط‌کشی‌شده (stripe) ذخیره کرده و بلوک‌های پاریتی (parity) را محاسبه می‌کنند. این بلوک‌های پاریتی می‌توانند در صورت خرابی دستگاه‌ها برای بازیابی بلوک‌های داده استفاده شوند. در یک حجم raid5 حداکثر یک دستگاه و در raid6 حداکثر دو دستگاه می‌توانند بدون از دست رفتن داده‌ها دچار خرابی شوند. انواع خط‌کشی‌شده RAID معمولاً بلوک‌های داده و پاریتی را برای بهبود کارایی جابه‌جا (rotate) می‌کنند تا از ازدحام بار روی یک دستگاه جلوگیری شود. چینش‌های خاصی از بلوک‌های پاریتی و داده (طرح‌بندی‌ها یا layouts) می‌توانند برای بهینه‌سازی کارایی ورودی/خروجی (I/O) یا تبدیل بین سطوح RAID مورد استفاده قرار گیرند. برای اطلاعات بیشتر به lvmraid(7) مراجعه کنید.

طرح‌بندی‌های بلوک‌های پاریتی چرخشی در raid5 می‌تواند شامل موارد زیر باشد: چپ‌ـ‌نامتقارن (raid5_la)، چپ‌ـ‌متقارن (raid5_ls با نام مستعار raid5)، راست‌ـ‌نامتقارن (raid5_ra)، راست‌ـ‌متقارن (raid5_rs) و raid5_n که بلوک‌های پاریتی را نمی‌چرخاند. طرح‌بندی‌های raid6 عبارتند از: شروع مجدد با صفر (raid6_zr با نام مستعار raid6)، شروع مجدد بعدی (raid6_nr) و ادامه بعدی (raid6_nc).

طرح‌بندی‌های حاوی n_ امکان تبدیل بین سطوح RAID را فراهم می‌کنند (مانند تبدیل raid5_n به raid6 یا raid5_n به striped/raid0/raid0_meta). علاوه بر این، طرح‌بندی‌های ویژه raid6 برای تبدیل سطح RAID بین raid5 و raid6 عبارتند از: raid6_ls_6، raid6_rs_6، raid6_la_6 و raid6_ra_6. این طرح‌بندی‌ها متناظر با همتایان خود در raid5 هستند (به عنوان مثال raid5_rs می‌تواند مستقیماً به raid6_rs_6 و بالعکس تبدیل شود).

ساختار raid10 (نام مستعار برای raid10_near) در حال حاضر محدود به یک کپی داده و تعداد زوجی از زیرحجم‌های منطقی (sub LVs) است. این یک طرح‌بندی گروه آینه‌ای است، بنابراین در هر گروه آینه‌ای یک زیرحجم منطقی می‌تواند بدون از دست رفتن داده‌ها دچار خرابی شود.

انواع خط‌کشی‌شده RAID از تبدیل طرح‌بندی، اندازه خط داده (stripesize) و تعداد خطوط داده (stripes) پشتیبانی می‌کنند.

ترکیب انواع RAID خط‌کشی‌شده با raid1 امکان تبدیل از خطی به striped/raid0/raid0_meta و بالعکس را فراهم می‌کند؛ به عنوان مثال: linear -> raid1 -> raid5_n (با افزودن خطوط داده) -> striped/raid0/raid0_meta.

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

تبدیل حجم منطقی (LV) به نوع خطی (linear).

lvconvert --type linear LV

—

تبدیل حجم منطقی به نوع خط‌کشی‌شده (striped).

lvconvert --type striped LV

—

تبدیل حجم منطقی به نوع آینه‌ای (mirror) (همچنین به نوع raid1 مراجعه کنید):

lvconvert --type mirror LV

—

تبدیل حجم منطقی به RAID یا تغییر طرح‌بندی RAID
(باید سطح خاصی از RAID مانند raid1 مشخص شود).

lvconvert --type raid LV

—

تبدیل حجم منطقی به raid1 یا mirror، یا تغییر تعداد تصاویر آینه‌ای.

lvconvert -m|--mirrors [+|-]Number LV

—

تبدیل حجم منطقی raid برای تغییر تعداد تصاویر خط‌کشی (stripe).

lvconvert --stripes Number LV1

—

تبدیل حجم منطقی raid برای تغییر اندازه خط‌کشی (stripe size).

lvconvert -I|--stripesize Size[k|UNIT] LV1

—

جداسازی تصویر از یک حجم منطقی raid1 یا mirror و استفاده از آن‌ها برای ایجاد یک حجم جدید.

lvconvert --splitmirrors Number -n|--name LV_new LV1

—

جداسازی تصویر از یک حجم raid1 و ردیابی تغییرات نسبت به مبدا برای ادغام در آینده.

lvconvert --splitmirrors Number --trackchanges LV1

—

ادغام مجدد تصاویر حجم منطقی که قبلاً از یک حجم raid1 جدا شده بودند.

lvconvert --mergemirrors VG|LV1|Tag ...

—

تبدیل حجم منطقی به حجم منطقی پویا (thin LV) با استفاده از حجم اصلی به عنوان مبدا خارجی.

lvconvert --type thin --thinpool LV LV1

—

تبدیل حجم منطقی به حجم منطقی پویا با استفاده از حجم اصلی به عنوان حجم داده استخر پویا.

lvconvert --type thin LV1

—

اتصال یک استخر کش به حجم منطقی، که حجم منطقی را به نوع کش (cache) تبدیل می‌کند.

lvconvert --type cache --cachepool LV LV1

—

اتصال یک writecache به حجم منطقی، که حجم منطقی را به نوع writecache تبدیل می‌کند.

lvconvert --type writecache --cachevol LV LV1

—

اتصال یک کش به حجم منطقی، که حجم منطقی را به نوع کش (cache) تبدیل می‌کند.

lvconvert --type cache --cachevol LV LV1

—

افزودن یک writecache به حجم منطقی با استفاده از یک دستگاه کش مشخص.

lvconvert --type writecache --cachedevice PV LV1

—

افزودن یک کش (cache) به حجم منطقی با استفاده از یک دستگاه کش مشخص.

lvconvert --type cache --cachedevice PV LV1

—

تبدیل حجم منطقی به نوع استخر پویا (thin-pool).

lvconvert --type thin-pool LV1

—

تبدیل حجم منطقی به نوع استخر کش (cache-pool).

lvconvert --type cache-pool LV1

—

تبدیل حجم منطقی به نوع vdopool.

lvconvert --type vdo-pool LV1

—

جدا کردن کش از یک حجم منطقی.

lvconvert --splitcache LV1

—

ادغام حجم منطقی پویا (thin LV) در حجم مبدا خود.

lvconvert --mergethin LV1 ...

—

ادغام تصویر لحظه‌ای COW در حجم مبدا خود.

lvconvert --mergesnapshot LV1 ...

—

ترکیب تصویر لحظه‌ای پیشین COW (آرگومان دوم) با حجم مبدا پیشین (آرگومان اول)
برای معکوس کردن دستور splitsnapshot.

lvconvert --type snapshot LV LV1

—

جایگزینی PVهای آسیب‌دیده در یک حجم raid یا mirror.
تعمیر یک استخر پویا.
تعمیر یک استخر کش.

lvconvert --repair LV1

—

جایگزینی یک یا چند PV مشخص در یک حجم منطقی raid با PV دیگر.

lvconvert --replace PV LV1

—

بررسی و نظارت بر حجم منطقی برای ادامه فرایند تبدیل.

lvconvert --startpoll LV1

—

افزودن یا حذف چکسام‌های یکپارچگی داده‌ها در تصاویر raid.

lvconvert --raidintegrity y|n LV1

—

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

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

گزینه‌ها (OPTIONS)

--alloc contiguous|cling|cling_by_tags|normal|anywhere|inherit
سیاست تخصیص را زمانی که یک دستور نیاز به تخصیص اکستنت‌های فیزیکی (PEs) از گروه حجم (VG) دارد، تعیین می‌کند. هر VG و LV دارای یک سیاست تخصیص است که می‌تواند با vgchange/lvchange تغییر داده شود یا در خط فرمان بازنویسی شود. سیاست normal قوانین معمول مانند عدم قرار دادن خطوط موازی داده بر روی یک PV مشترک را اعمال می‌کند. سیاست inherit سیاست VG را بر LV اعمال می‌کند. سیاست contiguous نیازمند آن است که PEهای جدید در مجاورت PEهای موجود قرار گیرند. سیاست cling اکستنت‌های جدید را بر روی همان PV که PEهای فعلی در همان خط داده LV مستقر هستند قرار می‌دهد. اگر PEهای کافی وجود داشته باشد ولی normal از آن‌ها استفاده نکند، anywhere از آن‌ها بهره می‌گیرد حتی اگر به بهای کاهش کارایی (مانند قرارگیری دو خط داده روی یک PV یکسان) تمام شود. آرگومان‌های مکانی اختیاری PV در خط فرمان نیز می‌توانند برای محدود کردن PVهای مورد استفاده دستور جهت تخصیص به کار روند. برای اطلاعات بیشتر درباره تخصیص به lvm(8) مراجعه کنید.

-b|--background
اگر عملیات نیاز به نظارت و پیگیری (polling) داشته باشد، این گزینه باعث می‌شود دستور پیش از اتمام کامل برگردد و پیگیری در پس‌زمینه انجام شود.

-H|--cache
مشخص می‌کند که دستور در حال کار با یک حجم منطقی کش (cache LV) یا استخر کش (cache pool) است. به --type cache و --type cache-pool مراجعه کنید. برای اطلاعات بیشتر درباره حافظه پنهان LVM به lvmcache(7) مراجعه کنید.

--cachedevice PV
نام دستگاه مورد استفاده برای کش.

--cachemetadataformat auto|1|2
فرمت متاداده کش مورد استفاده توسط هدف کش (cache target) را تعیین می‌کند.

--cachemode writethrough|writeback|passthrough
مشخص می‌کند که چه زمانی عملیات نوشتن روی حجم منطقی کش، کامل در نظر گرفته شود. حالت writeback نوشتن را بلافاصله پس از ثبت در حافظه کش کامل تلقی می‌کند. حالت writethrough نوشتن را تنها پس از ثبت همزمان در حافظه کش و حجم اصلی کامل می‌داند. حالت passthrough تمام عملیات نوشتن را مستقیماً به حجم اصلی هدایت می‌کند و از کش عبور نمی‌دهد.

--cachepolicy String
سیاست کش را برای یک حجم منطقی کش مشخص می‌کند. برای اطلاعات بیشتر به lvmcache(7) مراجعه کنید.

--cachepool LV
نام یک استخر کش (cache pool).

--cachesettings String
پارامترهای قابل تنظیم هسته را برای حجم‌های dm-cache یا dm-writecache تعیین می‌کند. از قالب 'option=value' یا 'option1=value option2=value' استفاده کنید. برای اطلاعات بیشتر به lvmcache(7) مراجعه کنید.

--cachesize Size[m|UNIT]
اندازه کش مورد استفاده.

--cachevol LV
نام یک حجم کش (cache volume).

-c|--chunksize Size[k|UNIT]
اندازه تکه‌ها (chunk size) در یک تصویر لحظه‌ای، استخر کش یا استخر پویا. برای تصاویر لحظه‌ای، مقدار باید توانی از ۲ بین ۴ کیلوبایت تا ۵۱۲ کیلوبایت باشد و پیش‌فرض آن ۴ کیلوبایت است. برای استخر کش، مقدار باید مضربی از ۳۲ کیلوبایت بین ۳۲ کیلوبایت تا ۱ گیگابایت باشد و پیش‌فرض آن ۶۴ کیلوبایت است. برای استخر پویا، مقدار باید مضربی از ۶۴ کیلوبایت بین ۶۴ کیلوبایت تا ۱ گیگابایت باشد و مقدار پیش‌فرض بسته به اندازه استخر متغیر است.

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

--compression y|n
فعال یا غیرفعال بودن فشرده‌سازی برای حجم VDO را کنترل می‌کند. برای اطلاعات بیشتر به lvmvdo(7) مراجعه کنید.

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

-d|--debug ...
تنظیم سطح اشکال‌زدایی (دیباگ). از ۱ تا ۶ بار تکرار برای افزایش جزئیات پیام‌های ارسالی به فایل وقایع و خروجی خطا.

--deduplication y|n
فعال یا غیرفعال بودن حذف داده‌های تکراری (deduplication) برای حجم VDO را کنترل می‌کند. برای اطلاعات بیشتر به lvmvdo(7) مراجعه کنید.

--devices PV
دستگاه‌های قابل مشاهده و دسترسی برای دستور را محدود می‌کند. دستگاه‌هایی که فهرست نشده‌اند به عنوان دستگاه ناموجود در نظر گرفته می‌شوند.

--devicesfile String
فایلی شامل فهرست دستگاه‌هایی که LVM مجاز به استفاده از آن‌ها است. این فایل باید در مسیر /etc/lvm/devices/ وجود داشته باشد و با دستور lvmdevices(8) مدیریت شود.

--discards passdown|nopassdown|ignore
نحوه مدیریت درخواست‌های discard توسط لایه استخر پویا در هسته را تعیین می‌کند: گزینه ignore درخواست‌های discard را نادیده می‌گیرد. گزینه nopassdown فضا را در استخر پویا آزاد می‌کند اما به دستگاه فیزیکی زیرین ارسال نمی‌کند. گزینه passdown فضا را آزاد کرده و دستور را به دستگاه لایه زیرین نیز ارسال می‌کند.

--driverloaded y|n
در صورت تنظیم بر روی no، دستور تلاشی برای استفاده از device-mapper نخواهد کرد (برای اهداف آزمایشی و اشکال‌زدایی).

--errorwhenfull y|n
رفتار استخر پویا در زمان پر شدن کامل فضای داده را تعیین می‌کند. در صورت تنظیم yes، نگاشت‌کننده دستگاه بلافاصله خطای ورودی/خروجی صادر می‌کند؛ در صورت no، عملیات نوشتن تا زمان تخصیص فضای بیشتر متوقف (معلق) می‌ماند.

-f|--force ...
نادیده گرفتن بررسی‌های مختلف ایمنی، تاییدیه‌ها و محافظت‌ها. با احتیاط فراوان استفاده شود.

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

--integritysettings String
تنظیمات قابل تنظیم هسته برای dm-integrity را تعیین می‌کند. برای اطلاعات بیشتر به lvmraid(7) مراجعه کنید.

-i|--interval Number
گزارش منظم پیشرفت عملیات در فواصل زمانی مشخص (بر حسب ثانیه).

--journal String
ثبت اطلاعات گزارش در ژورنال systemd علاوه بر گزارش‌های فعال‌شده در تنظیمات lvm.conf.

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

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

--merge
نام مستعار برای --mergethin، --mergemirrors یا --mergesnapshot بر اساس نوع حجم منطقی.

--mergemirrors
ادغام تصاویر حجم منطقی که از یک حجم منطقی raid1 جدا شده بودند. به --splitmirrors به همراه --trackchanges مراجعه کنید.

--mergesnapshot
ادغام تصویر لحظه‌ای COW در حجم مبدا خود. هنگام ادغام، اگر حجم‌های مبدا و تصویر لحظه‌ای باز نباشند، ادغام بلافاصله آغاز می‌شود؛ در غیر این صورت ادغام در اولین فعال‌سازی بعدی انجام خواهد شد.

--mergethin
ادغام حجم منطقی پویا در حجم منطقی مبدا خود. حجم مبدا محتوای تصویر لحظه‌ای پویا را دریافت کرده و تصویر لحظه‌ای حذف می‌شود.

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

--mirrorlog core|disk
نوع گزارش آینه‌ای را برای حجم‌های نوع "mirror" مشخص می‌کند (برای نوع "raid1" کاربرد ندارد). گزینه disk یک زیرحجم منطقی پایدار برای نگهداری گزارش همگام‌سازی ایجاد می‌کند. گزینه core گزارش همگام‌سازی را تنها در حافظه اصلی نگه می‌دارد (پس از راه‌اندازی مجدد سیستم نیاز به همگام‌سازی دوباره است).

-m|--mirrors [+|-]Number
تعداد تصاویر آینه‌ای را علاوه بر تصویر اولیه مشخص می‌کند؛ برای مثال --mirrors 1 به معنای دو نسخه کپی از داده‌ها است.

-n|--name String
نام یک حجم منطقی جدید را تعیین می‌کند. در صورت عدم تعیین، نامی پیش‌فرض مانند "lvol#" ایجاد می‌شود.

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

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

--noudevsync
غیرفعال کردن همگام‌سازی با udev. فرایند منتظر اعلان از سوی udev نمی‌ماند و بلافاصله به کار خود ادامه می‌دهد.

--originname LV
نامی که برای حجم مبدا خارجی هنگام تبدیل یک حجم منطقی به حجم پویا (thin LV) استفاده می‌شود. نام حجم اولیه به این نام تغییر می‌یابد.

--pooldatavdo y|n
استفاده از حجم نوع VDO برای حجم داده استخر (pool data volume).

--poolmetadata LV
نام یک حجم منطقی که برای ذخیره متاداده استخر به کار می‌رود.

--poolmetadatasize Size[m|UNIT]
اندازه حجم منطقی متاداده جدید برای استخر را مشخص می‌کند.

--poolmetadataspare y|n
فعال یا غیرفعال کردن ایجاد و مدیریت خودکار یک حجم منطقی متاداده یدکی (spare pool metadata LV) در گروه حجم (VG).

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

-q|--quiet ...
سرکوب پیام‌های خروجی و وقایع‌نگاری. اولویت بالاتری نسبت به --debug و --verbose دارد. تکرار مجدد آن هشدارهای حیاتی را نیز سرکوب می‌کند.

--raidintegrity y|n
فعال یا غیرفعال کردن چکسام‌های یکپارچگی داده‌ها برای تصاویر raid با استفاده از dm-integrity.

--raidintegrityblocksize Number
اندازه بلوک مورد استفاده برای dm-integrity در تصاویر raid. معمولاً باید با اندازه بلوک سیستم فایل (مانند ۵۱۲ یا ۴۰۹۶ بایت) یکسان باشد.

--raidintegritymode String
استفاده از ژورنال (پیش‌فرض journal) یا نقشه بیتی (bitmap) برای حفظ همگامی چکسام‌های یکپارچگی در زمان خرابی ناگهانی سیستم.

-r|--readahead auto|none|Number
تعداد سکتورهای پیش‌خوانی (read ahead) حجم منطقی را تعیین می‌کند. auto مقدار پیش‌فرضی است که به هسته اجازه انتخاب می‌دهد. none پیش‌خوانی را غیرفعال می‌کند.

-R|--regionsize Size[m|UNIT]
اندازه هر ناحیه همگام‌سازی raid یا mirror. مقدار پیش‌فرض در lvm.conf(5) با تنظیم activation/raid_region_size تعیین می‌شود.

--repair
جایگزینی PVهای معیوب در یک حجم raid یا mirror، یا اجرای ابزار تعمیر روی یک استخر پویا یا کش. برای اطلاعات بیشتر به lvmraid(7) و lvmthin(7) مراجعه کنید.

--replace PV
جایگزینی یک PV خاص در حجم منطقی raid با یک PV دیگر. PV جدید می‌تواند به عنوان آرگومان مکانی در انتهای دستور ذکر شود.

-k|--setactivationskip y|n
تنظیم پایدار (yes) یا حذف (no) نشانگر رد کردن فعال‌سازی (activation skip) روی حجم منطقی.

-s|--snapshot
ترکیب یک حجم لحظه‌ای پیشین COW با حجم مبدا پیشین برای معکوس کردن دستور قبلی --splitsnapshot.

--splitcache
جداسازی استخر کش از یک حجم منطقی کش و حفظ حجم استخر کش بدون استفاده. پیش از جداسازی، کش تخلیه می‌شود. همچنین به --uncache مراجعه کنید.

--splitmirrors Number
جداسازی تعداد مشخصی تصویر از حجم raid1 یا mirror و ایجاد یک حجم منطقی جدید از آن‌ها. اگر --name مشخص نشود، نام پیش‌فرضی تولید می‌شود.

--splitsnapshot
جداسازی یک تصویر لحظه‌ای COW از حجم مبدا آن. حجم جداشده حاوی تکه‌های تغییریافته در لحظه جداسازی خواهد بود.

--startpoll
شروع پیگیری و نظارت (polling) روی حجم منطقی جهت ادامه پردازش تبدیل.

--stripes Number
تعداد خطوط داده (stripes) در یک حجم منطقی خط‌کشی‌شده. این مقدار نشان‌دهنده تعداد دستگاه‌های فیزیکی است که داده‌ها به صورت همزمان بین آن‌ها پخش می‌شوند.

-I|--stripesize Size[k|UNIT]
اندازه خط داده (stripe size)؛ مقدار داده‌ای که پیش از انتقال به دستگاه بعدی روی یک دستگاه نوشته می‌شود.

--swapmetadata
استخراج حجم متاداده از یک استخر و جایگزینی آن با یک حجم مشخص دیگر. حجم استخراج‌شده می‌تواند برای بازبینی و تعمیر مورد استفاده قرار گیرد.

-t|--test
اجرا در حالت آزمایشی (test). هیچ داده و متاداده‌ای در دیسک تغییر نمی‌کند؛ تمام عملیات نوشتن متاداده غیرفعال است.

-T|--thin
مشخص می‌کند که دستور در حال کار با یک حجم منطقی پویا یا استخر پویا است. به --type thin، --type thin-pool و --virtualsize مراجعه کنید. برای اطلاعات بیشتر به lvmthin(7) رجوع فرمایید.

--thinpool LV
نام یک حجم منطقی استخر پویا (thin pool LV).

--trackchanges
قابل استفاده به همراه --splitmirrors روی یک حجم raid1. باعث ردیابی تغییرات روی حجم اصلی raid1 می‌شود تا بعداً ادغام مجدد با سرعت بالا امکان‌پذیر گردد.

--type linear|striped|snapshot|raid|mirror|thin|thin-pool|vdo|vdo-pool|cache|cache-pool|writecache
نوع حجم منطقی (نوع سگمنت یا segtype). برای اطلاعات بیشتر درباره افزونگی و کارایی (raid<N>، mirror، striped، linear) به lvmraid(7) مراجعه کنید. برای تخصیص پویا (thin، thin-pool) به lvmthin(7) مراجعه کنید. برای کش‌گذاری و بهبود کارایی (cache، cache-pool) به lvmcache(7) مراجعه کنید. برای تصاویر لحظه‌ای کپی هنگام نوشتن (snapshot) به بخش کاربردها مراجعه فرمایید. برای VDO (vdo) به lvmvdo(7) مراجعه کنید. بسیاری از دستورها از ذکر صریح گزینه نوع صرف‌نظر می‌کنند زیرا نوع از روی گزینه‌های دیگر استنباط می‌شود (مانند --stripes، --mirrors، --snapshot، --virtualsize، --thin، --cache). از انواع استنباطی با دقت استفاده کنید زیرا ممکن است منجر به نتایج غیرمنتظره شوند.

--uncache
جداسازی استخر کش از یک حجم منطقی کش و حذف دائمی استخر کش بدون استفاده. پیش از جداسازی، کش تخلیه می‌شود. همچنین به --splitcache مراجعه کنید.

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

--vdopool LV
نام یک حجم منطقی استخر VDO. برای اطلاعات بیشتر درباره کاربرد VDO به lvmvdo(7) مراجعه کنید.

--vdosettings String
تعیین گزینه‌های قابل تنظیم VDO برای حجم‌های منطقی VDO. از قالب 'option=value' یا 'option1=value option2=value' استفاده کنید.

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

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

-V|--virtualsize Size[m|UNIT]
اندازه مجازی یک حجم منطقی پویای جدید. برای اطلاعات بیشتر به lvmthin(7) مراجعه کنید.

-W|--wipesignatures y|n
کنترل شناسایی و پاک‌سازی متعاقب امضاها روی حجم‌های منطقی جدید. پیش از پاک کردن هر امضا یک اعلان تایید نمایش داده می‌شود مگر آنکه با --yes تایید شده باشد.

-y|--yes
عدم درخواست تایید تعاملی و فرض پاسخ مثبت (yes) برای تمامی پرسش‌ها. با احتیاط کامل استفاده شود.

-Z|--zero y|n
برای تصاویر لحظه‌ای، پاک کردن (صفر کردن) ۴ کیلوبایت ابتدایی داده‌ها در تصویر لحظه‌ای را کنترل می‌کند. برای استخرهای پویا و استخرهای کش، صفر کردن اولین بلوک متاداده استخر را کنترل می‌کند.

متغیرها (VARIABLES)

VG

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

LV

نام حجم منطقی (Logical Volume). برای نام‌های معتبر به lvm(8) مراجعه کنید. یک آرگومان مکانی LV معمولاً شامل نام VG و نام LV است، مانند VG/LV. شناسه LV1 نشان می‌دهد که حجم منطقی باید دارای نوع خاصی باشد؛ انواع مجاز در توضیحات آورده شده است (raid بیانگر انواع raid<N> است).

PV

نام حجم فیزیکی (Physical Volume)، که یک مسیر دستگاه زیر شاخه /dev است. برای دستورهایی که اکستنت‌های فیزیکی را مدیریت می‌کنند، آرگومان مکانی PV معمولاً پسوندی را می‌پذیرد که نشان‌دهنده یک بازه (یا چندین بازه) از اکستنت‌های فیزیکی (PE) است. در صورت حذف اولین PE، به‌طور پیش‌فرض از ابتدای دستگاه در نظر گرفته می‌شود و در صورت حذف آخرین PE، به انتهای دستگاه ختم می‌شود. بازه شروع و پایان (شامل هر دو): PV[:PE-PE]... بازه شروع و طول (با شمارش از ۰): PV[:PE+PE]...

Tag

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

String

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

Size[UNIT]

اندازه یک عدد ورودی است که یک یکای اختیاری را می‌پذیرد. یکاهای ورودی صرف‌نظر از بزرگ یا کوچک بودن حروف همواره بر مبنای دو (باینری) در نظر گرفته می‌شوند؛ به عنوان مثال 'k' و 'K' هر دو نشان‌دهنده ۱۰۲۴ هستند. یکای ورودی پیش‌فرض با یک حرف مشخص شده و به دنبال آن |UNIT می‌آید. نماد UNIT نشان‌دهنده سایر یکاهای ممکن برای ورودی است: b|B بایت (bytes)، s|S بخش‌های ۵۱۲ بایتی (sectors)، 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 جایگزین کرد.

کاربردهای پیشرفته (ADVANCED USAGE)

شیوه‌های جایگزین دستور، کاربردهای پیشرفته دستور، و فهرست تمام ساختارهای نحوی معتبر جهت جامعیت سند.

تغییر اندازه ناحیه (region size) یک حجم منطقی.

lvconvert -R|--regionsize Size[m|UNIT] LV1

—

تغییر نوع لاگ آینه‌ای مورد استفاده توسط یک حجم منطقی mirror.

lvconvert --mirrorlog core|disk LV1

—

تبدیل حجم منطقی به یک حجم منطقی پویا با استفاده از حجم اصلی به عنوان مبدا خارجی.

lvconvert -T|--thin --thinpool LV LV1

—

تبدیل حجم منطقی به یک حجم منطقی پویا با استفاده از LV به عنوان حجم داده استخر پویا.

lvconvert -T|--thin LV1

—

اتصال یک استخر کش به حجم منطقی.

lvconvert -H|--cache --cachepool LV LV1

—

اتصال یک کش به حجم منطقی، که حجم منطقی را به نوع کش (cache) تبدیل می‌کند.

lvconvert -H|--cache --cachevol LV LV1

—

تبدیل حجم منطقی به نوع vdopool.

lvconvert --vdopool LV

—

جداسازی و حذف کش از یک حجم منطقی.

lvconvert --uncache LV1

—

جابه‌جایی حجم متاداده در یک استخر پویا یا استخر کش (فقط برای مقاصد تعمیر).

lvconvert --swapmetadata --poolmetadata LV LV1

—

ادغام حجم منطقی جداشده از یک حجم آینه‌ای (شیوه دیگر، از --mergemirrors استفاده کنید).
ادغام حجم منطقی پویا در حجم مبدا خود (شیوه دیگر، از --mergethin استفاده کنید).
ادغام تصویر لحظه‌ای COW در حجم مبدا خود (شیوه دیگر، از --mergesnapshot استفاده کنید).

lvconvert --merge VG|LV1|Tag ...

—

جداسازی یک تصویر لحظه‌ای COW از حجم مبدا آن.

lvconvert --splitsnapshot LV1

—

ترکیب یک تصویر لحظه‌ای پیشین COW (آرگومان دوم) با حجم مبدا پیشین (آرگومان اول)
برای معکوس کردن دستور splitsnapshot.

lvconvert -s|--snapshot LV LV1

—

پیگیری وضعیت حجم منطقی برای ادامه تبدیل (همچنین به --startpoll مراجعه کنید)
یا انتظار تا اتمام همگام‌سازی تبدیل/آینه.

lvconvert LV1

—

نکات (NOTES)

این ترکیب دستوری پیشین دو عملیات متفاوت را انجام می‌داد:
lvconvert --thinpool LV1 --poolmetadata LV2
اگر LV1 یک استخر پویا نبود، دستور LV1 را به یک استخر پویا تبدیل می‌کرد و در صورت تمایل از حجم منطقی مشخص‌شده برای متاداده استفاده می‌کرد. اما اگر LV1 از قبل یک استخر پویا بود، دستور حجم متاداده فعلی را با LV2 جابه‌جا می‌کرد (تنها برای مقاصد تعمیر).

به همین ترتیب، این ترکیب دستوری پیشین دو عملیات متفاوت را انجام می‌داد:
lvconvert --cachepool LV1 --poolmetadata LV2
اگر LV1 یک استخر کش نبود، دستور LV1 را به یک استخر کش تبدیل می‌کرد و در صورت تمایل از حجم منطقی مشخص‌شده برای متاداده استفاده می‌کرد. اما اگر LV1 از قبل یک استخر کش بود، دستور حجم متاداده فعلی را با LV2 جابه‌جا می‌کرد (تنها برای مقاصد تعمیر).

مثال‌ها (EXAMPLES)

تبدیل یک حجم منطقی خطی به یک حجم منطقی آینه‌ای دوطرفه:
lvconvert --type mirror --mirrors 1 vg/lvol1

تبدیل یک حجم منطقی خطی به یک حجم منطقی دوطرفه RAID1:
lvconvert --type raid1 --mirrors 1 vg/lvol1

تبدیل یک حجم منطقی آینه‌ای برای استفاده از لاگ درون‌حافظه‌ای:
lvconvert --mirrorlog core vg/lvol1

تبدیل یک حجم منطقی آینه‌ای برای استفاده از لاگ روی دیسک:
lvconvert --mirrorlog disk vg/lvol1

تبدیل یک حجم منطقی mirror یا raid1 به یک حجم منطقی خطی:
lvconvert --type linear vg/lvol1

تبدیل یک حجم منطقی mirror به یک حجم raid1 با همان تعداد تصویر:
lvconvert --type raid1 vg/lvol1

تبدیل یک حجم منطقی خطی به یک حجم آینه‌ای دوطرفه، با تخصیص اکستنت‌های جدید از محدوده‌های مشخص PV:
lvconvert --mirrors 1 vg/lvol1 /dev/sda:0-15 /dev/sdb:0-15

تبدیل یک حجم منطقی آینه‌ای به خطی و آزادسازی اکستنت‌های فیزیکی از یک PV مشخص:
lvconvert --type linear vg/lvol1 /dev/sda

جداسازی یک تصویر از یک حجم mirror یا raid1 و ساخت یک حجم منطقی جدید از آن:
lvconvert --splitmirrors 1 --name lv_split vg/lvol1

جداسازی یک تصویر از یک حجم raid1 و ردیابی تغییرات اعمال‌شده بر حجم raid1 تا زمانی که تصویر جداشده منفصل باقی بماند:
lvconvert --splitmirrors 1 --trackchanges vg/lvol1

ادغام مجدد تصویری که قبلاً با گزینه‌های --splitmirrors و --trackchanges ایجاد شده بود در حجم اصلی raid1:
lvconvert --mergemirrors vg/lvol1_rimage_1

جایگزینی PV با نام /dev/sdb1 با PV دیگر /dev/sdf1 در یک حجم منطقی raid1/4/5/6/10:
lvconvert --replace /dev/sdb1 vg/lvol1 /dev/sdf1

جایگزینی ۳ حجم فیزیکی /dev/sd[b-d]1 با /dev/sd[f-h]1 در یک حجم raid1:
lvconvert --replace /dev/sdb1 --replace /dev/sdc1 --replace /dev/sdd1

جایگزینی حداکثر ۲ حجم فیزیکی /dev/sd[bc]1 با /dev/sd[gh]1 در یک حجم raid6:
lvconvert --replace /dev/sdb1 --replace /dev/sdc1 vg/lvol1 /dev/sd[gh]1

تبدیل یک حجم منطقی ضخیم (thick LV) به حجم داده استخر پویا (thin-pool) و ادامه استفاده از آن از طریق thinLV و تنظیم اندازه متاداده استخر به 1GiB:
lvconvert --type thin --poolmetadatasize 1G vg/lvol1

تبدیل یک حجم منطقی به یک استخر پویا با فشرده‌سازی و حذف داده‌های تکراری با VDO:
lvconvert --type thin-pool --pooldatavdo y vg/lvol1

تبدیل یک حجم منطقی به یک حجم منطقی پویا در استخر پویای مشخص‌شده؛ حجم موجود به عنوان مبدا فقط‌خواندنی خارجی برای حجم پویای جدید استفاده می‌شود:
lvconvert --type thin --thinpool vg/tpool1 vg/lvol1

تبدیل یک حجم منطقی به یک حجم منطقی پویا در استخر پویای مشخص‌شده با تغییر نام مبدا خارجی به "external":
lvconvert --type thin --thinpool vg/tpool1

تبدیل یک حجم منطقی به حجم استخر کش با استفاده از حجم مشخص دیگری برای متاداده استخر کش:
lvconvert --type cache-pool --poolmetadata vg/poolmeta1 vg/lvol1

تبدیل یک حجم منطقی به حجم منطقی کش با استفاده از استخر کش و اندازه تکه (chunk size) مشخص‌شده:
lvconvert --type cache --cachepool vg/cpool1 -c 128 vg/lvol1

جداسازی و حفظ استخر کش از یک حجم منطقی کش:
lvconvert --splitcache vg/lvol1

جداسازی و حذف کامل استخر کش از یک حجم منطقی کش:
lvconvert --uncache vg/lvol1

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