.TH "VGIMPORTCLONE" "8" "مه ۲۰۲۵" "lvm2" "دستورهای مدیریتی و نگهداری"
.
.SH "نام (NAME)"
vgimportclone \- واردسازی یک گروه حجم از روی حجمهای فیزیکی کلونشده یا تکثیرشده
.
.SH "خلاصه دستور (SYNOPSIS)"
\fBvgimportclone\fP [\fIگزینهها\fR] \fIدستگاهها\fR...
.
.SH "توضیحات (DESCRIPTION)"
دستور \fBvgimportclone\fR گروه حجمی را که دیسکهای آن از روی حجمهای فیزیکی دیگر کلون یا کپی سختافزاری (Snapshot) شدهاند، با تخصیص UUIDهای جدید به حجمهای فیزیکی و تغییر نام گروه حجم وارد سامانه میکند.
.P
یک گروه حجم (VG) تکراری تا زمانی که امکان همزیستی آن با VG اصلی فراهم نشود، قابل استفاده نخواهد بود. دستور \fBvgimportclone\fR نام VG مرتبط با PVهای مشخص‌شده را تغییر داده و UUIDهای مربوط به VG و PV را دگرگون می‌سازد.
.
.SH "کاربرد (USAGE)"
.
\fBvgimportclone\fP \fIPV\fP ...
.br
.RS 4
.na
[ \fB\-n\fP|\fB\-\-basevgname\fP \fIVG\fP ]
.br
[ \fB\-i\fP|\fB\-\-import\fP ]
.br
[    \fB\-\-importdevices\fP ]
.br
[ گزینه‌های_عمومی ]
.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\-n\fP|\fB\-\-basevgname\fP \fIString\fP
.br
به‌طور پیش‌فرض، گروه حجم اسنپ‌شات برای جلوگیری از نام‌گذاری تکراری، به نام اصلی به‌همراه یک پسوند عددی تغییر نام خواهد یافت (برای نمونه، 'test_vg' به 'test_vg1' تغییر نام می‌یابد). این گزینه نام پایه گروه حجم (VG) را که برای تغییر نام تمام VGها به کار می‌رود، بازنویسی می‌کند. اگر گروه حجمی با نام مشخص‌شده از قبل وجود داشته باشد، یک پسوند عددی (مانند مثال قبلی) برای یکتا کردن آن افزوده خواهد شد.
.
.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
محدود کردن دستگاه‌هایی که برای دستور قابل مشاهده و دسترسی هستند. دستگاه‌هایی که در این فهرست نباشند مفقود به نظر خواهند رسید. این گزینه می‌تواند تکرار شود، یا فهرستی جدا شده با ویرگول از دستگاه‌ها را بپذیرد. این گزینه بر فایل دستگاه‌ها اولویت دارد.
.
.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
در صورت تنظیم بر روی n، دستور تلاشی برای استفاده از device-mapper نخواهد کرد. برای مقاصد آزمایش و اشکال‌زدایی.
.
.HP
\fB\-h\fP|\fB\-\-help\fP
.br
نمایش متن راهنما.
.
.HP
\fB\-i\fP|\fB\-\-import\fP
.br
واردسازی گروههای حجم صادرشده (Exported). در غیر این صورت، گروههای حجمی که صادر شده‌اند تغییر نخواهند کرد (و حجمهای فیزیکی متناظر با آنها نیز تغییر نمی‌کنند).
.
.HP
\fB\-\-importdevices\fP
.br
افزودن دستگاه‌ها به فایل دستگاه‌ها (devices file).
.
.HP
\fB\-\-journal\fP \fIString\fP
.br
ثبت اطلاعات در ژورنال systemd. این اطلاعات علاوه بر اطلاعاتی است که توسط تنظیم log/journal در lvm.conf فعال می‌شود.
.br
\fBcommand\fP: ثبت اطلاعات درباره دستور.
.br
\fBoutput\fP: ثبت خروجی پیش‌فرض دستور.
.br
\fBdebug\fP: ثبت کامل اشکال‌زدایی دستور.
.
.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
نام مستعار برای \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
تنظیم سطح پرگویی خروجی. این گزینه را از ۱ تا ۴ بار تکرار کنید تا جزئیات پیام‌های ارسالی به stdout و stderr افزایش یابد.
.
.HP
\fB\-\-version\fP
.br
نمایش اطلاعات نسخه نرم‌افزار.
.
.HP
\fB\-y\fP|\fB\-\-yes\fP
.br
عدم درخواست تاییدیه به صورت تعاملی و در نظر گرفتن همیشگی پاسخ مثبت (yes). با نهایت احتیاط استفاده شود. (برای پاسخ منفی خودکار، به \-qq مراجعه نمایید).
.
.SH "متغیرها (VARIABLES)"
.
.TP
.I PV
نام حجم فیزیکی (Physical Volume)، یک مسیر دستگاه در زیرشاخه /dev. برای دستوراتی که گستره‌های فیزیکی (PE) را مدیریت می‌کنند، یک آرگومان مکانی PV عموماً پسوندی را می‌پذیرد که محدوده (یا چندین محدوده) از گستره‌های فیزیکی را مشخص می‌سازد. هنگامی که اولین PE حذف شود، پیش‌فرض آن ابتدای دستگاه خواهد بود و هنگامی که آخرین PE حذف شود پیش‌فرض آن انتهای دستگاه است.
.br
محدوده آغاز و پایان (شامل هر دو):
.br
\fIPV\fP[\fB:\fP\fIPE\fP\fB\-\fP\fIPE\fP]...
.br
محدوده آغاز و طول (با شمارش از ۰):
.br
\fIPV\fP[\fB:\fP\fIPE\fP\fB+\fP\fIPE\fP]...
.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 "مثال‌ها (EXAMPLES)"
.
یک VG اصلی با نام "vg00" دارای حجمهای فیزیکی "/dev/sda" و "/dev/sdb" است. حجمهای فیزیکی (PV) متناظر حاصل از یک اسنپ‌شات سخت‌افزاری عبارتند از "/dev/sdc" و "/dev/sdd".
.P
تغییر نام گروه حجم متناظر با "/dev/sdc" و "/dev/sdd" از "vg00" به "vg00_snap" (و تغییر UUIDهای مرتبط):
.br
.B vgimportclone \-\-basevgname vg00_snap /dev/sdc /dev/sdd
.
.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)