نام (NAME)

nvme-dim - ارسال دستور مدیریت اطلاعات شناسایی (DIM) به یک یا چند کنترلر شناسایی

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

nvme dim [--task=<task> | -t <task>] [--nqn=<nqn> | -n <nqn>]
                        [--device=<device> | -d <device>]
                        [--output-format=<fmt> | -o <fmt>] [--verbose | -v]

توضیحات (DESCRIPTION)

دستور مدیریت اطلاعات شناسایی (DIM - Discovery Information Management) را به یک یا چند کنترلر شناسایی (Discovery Controller) ارسال می‌کند. دستور DIM امکان انجام دو نوع وظیفه را فراهم می‌کند: ثبت (register) یا لغو ثبت (deregister).

دستور DIM برای ثبت صریح در کنترلرهای شناسایی (DC)، به‌ویژه کنترلرهای شناسایی مرکزی (CDC) استفاده می‌شود. کنترلرهای CDC پایگاه داده‌ای (DB) از تمامی میزبان‌ها و زیرسیستم‌های ذخیره‌سازی در یک شبکه را نگهداری می‌کنند. وظیفهٔ ثبت برای افزودن یک میزبان به پایگاه دادهٔ CDC استفاده می‌شود. وظیفهٔ لغو ثبت برای حذف یک میزبان از پایگاه دادهٔ CDC به کار می‌رود.

در طول یک عملیات ثبت، میزبان اطلاعات الزامی نظیر NQN و شناسهٔ (ID) میزبان، و همچنین نام میزبان (hostname) و نسخهٔ سیستم‌عاملی را که بر روی آن اجرا می‌شود ارسال می‌کند. همچنین یک نام نمادین اختیاری برای میزبان (Host Symbolic Name) وجود دارد که می‌تواند در CDC ثبت شود.

این دستور تنها می‌تواند روی اتصالات DC موجود اعمال شود که پیش‌تر با دستور nvme-discover(1) و با استفاده از گزینهٔ --persistent ایجاد شده‌اند.

گزینه‌ها (OPTIONS)

-t <task>, --task <task>

وظیفه‌ای که باید انجام شود: «register» یا «deregister».

-n <subnqn>, --nqn <nqn>

دستور DIM به کنترلر شناسایی (DC) منطبق با این NQN ارسال خواهد شد. می‌توان فهرستی از NQNهای جداشده با کاما را برای اعمال دستور به بیش از یک DC مشخص کرد.

-d <device>, --device <device>

دستور DIM به کنترلرهای شناسایی (DC) مرتبط با این دستگیرهٔ دستگاه NVMe ارسال خواهد شد. می‌توان فهرستی از دستگیره‌های دستگاه جداشده با کاما را برای اعمال دستور به بیش از یک DC مشخص کرد.

-o <fmt>, --output-format=<fmt>

تنظیم قالب گزارش‌دهی به normal، json یا binary. در هر زمان تنها یک قالب خروجی می‌تواند استفاده شود.

-v, --verbose

افزایش سطح جزئیات اطلاعات در خروجی.

مثال‌ها (EXAMPLES)

•ثبت در کنترلر شناسایی مرکزی (CDC) با نام nqn.1988-11.com.dell:SFSS:1:20220118125153e8:

# nvme dim --task=register --nqn=nqn.1988-11.com.dell:SFSS:1:20220118125153e8

•لغو ثبت از کنترلر شناسایی مرکزی (CDC) مرتبط با nvme4:

# nvme dim --task=deregister --device=nvme4

همچنین ببینید (SEE ALSO)

nvme-discover(1)

NVME

بخشی از مجموعهٔ nvme-user