نام (NAME)

nvme-discover - ارسال دستور کشف NVMe-oF

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

nvme discover [--transport=<trtype> | -t <trtype>]
                        [--nqn=<subnqn> | -n <subnqn>]
                        [--traddr=<traddr> | -a <traddr>]
                        [--trsvcid=<trsvcid> | -s <trsvcid>]
                        [--host-traddr=<traddr> | -w <traddr>]
                        [--host-iface=<iface> | -f <iface>]
                        [--hostnqn=<hostnqn> | -q <hostnqn>]
                        [--hostid=<hostid> | -I <hostid>]
                        [--raw=<filename> | -r <filename>]
                        [--device=<device> | -d <device>]
                        [--config=<filename> | -J <filename>]
                        [--keep-alive-tmo=<sec> | -k <sec>]
                        [--reconnect-delay=<#> | -c <#>]
                        [--ctrl-loss-tmo=<#> | -l <#>]
                        [--nr-io-queues=<#> | -i <#>]
                        [--nr-write-queues=<#> | -W <#>]
                        [--nr-poll-queues=<#> | -P <#>]
                        [--queue-size=<#> | -Q <#>] [--keyring=<#>]
                        [--tls_key=<#>] [--hdr-digest | -g] [--data-digest | -G]
                        [--persistent | -p] [--quiet] [--tls] [--concat]
                        [--dump-config | -O] [--output-format=<fmt> | -o <fmt>]
                        [--force] [--nbft] [--no-nbft] [--nbft-path=<STR>]
                        [--context=<STR>]
                        [--output-format=<fmt> | -o <fmt>] [--verbose | -v]

توضیحات (DESCRIPTION)

ارسال یک یا چند درخواست Get Log Page به یک کنترل‌کننده کشف NVMe-over-Fabrics.

اگر هیچ پارامتری داده نشود، nvme discover تلاش می‌کند فایل /etc/nvme/discovery.conf را پیدا کند تا از آن برای تامین فهرستی از دستورات کشف جهت اجرا استفاده نماید. اگر فایل /etc/nvme/discovery.conf وجود نداشته باشد، دستور با خطا متوقف می‌شود.

در غیر این صورت، باید با استفاده از گزینه‌های --transport، --traddr و در صورت لزوم --trsvcid یک کنترل‌کننده کشف مشخص تعیین شود. سپس یک درخواست کشف به کنترل‌کننده کشف مشخص‌شده ارسال خواهد شد.

پیش‌زمینه (BACKGROUND)

مشخصات NVMe-over-Fabrics مفهوم کنترل‌کننده کشف (Discovery Controller) را تعریف می‌کند که یک میزبان NVMe می‌تواند روی یک شبکه فابریک از آن استعلام بگیرد تا زیرسیستم‌های NVMe موجود در اهداف NVMe (Targets) را که می‌تواند روی شبکه به آن‌ها متصل شود، کشف کند. کنترل‌کننده کشف، صفحات گزارش کشف (Discovery Log Pages) را بازمی‌گرداند که اطلاعات مشخصی (مانند آدرس شبکه و NQN یکتای زیرسیستم) را به میزبان NVMe ارائه می‌دهد تا میزبان بتواند با اجرای دستور اتصال NVMe، خود را به منبع ذخیره‌سازی موجود در آن زیرسیستم NVMe روی هدف متصل سازد.

توجه داشته باشید که مشخصات پایه NVMe ساختار NQN (نام واجد شرایط NVMe یا NVMe Qualified Name) را تعریف می‌کند که یک نقطه پایانی NVMe (دستگاه، زیرسیستم و غیره) باید برای تضمین نام یکتا طبق استاندارد NVMe از آن پیروی کند. به‌ویژه، Host NQN به صورت یکتا میزبان NVMe را مشخص می‌کند و ممکن است توسط کنترل‌کننده کشف برای مدیریت این‌که چه منابعی از اهداف NVMe برای اتصال به میزبان اختصاص داده شوند، استفاده شود.

یک کنترل‌کننده کشف دارای NQN مخصوص به خود است که در مشخصات NVMe-over-Fabrics تعریف شده است: nqn.2014-08.org.nvmexpress.discovery. تمام کنترل‌کننده‌های کشف باید از این نام NQN استفاده کنند. این NQN به طور پیش‌فرض توسط nvme-cli برای دستور discover استفاده می‌شود.

گزینه‌ها (OPTIONS)

-t <trtype>, --transport=<trtype>

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

-a <traddr>, --traddr=<traddr>

-s <trsvcid>, --trsvcid=<trsvcid>

-w <traddr>, --host-traddr=<traddr>

-f <iface>, --host-iface=<iface>

-q <hostnqn>, --hostnqn=<hostnqn>

-I <hostid>, --hostid=<hostid>

-r <filename>, --raw=<filename>

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

-J <filename>, --config=<filename>

-k <#>, --keep-alive-tmo=<#>

-c <#>, --reconnect-delay=<#>

-l <#>, --ctrl-loss-tmo=<#>

-i <#>, --nr-io-queues=<#>

-W <#>, --nr-write-queues=<#>

-P <#>, --nr-poll-queues=<#>

-Q <#>, --queue-size=<#>

--keyring=<#>

--tls_key=<#>

-g, --hdr-digest

-G, --data-digest

-p, --persistent

--tls

--concat

--quiet

-O, --dump-config

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

--force

--nbft

--no-nbft

--nbft-path=<STR>

--context <STR>

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

-v, --verbose

مثال‌ها (EXAMPLES)

# nvme discover --transport=rdma --traddr=192.168.1.3 \
--hostnqn=host1-rogue-nqn

# nvme discover --nbft

# nvme discover --nbft-path=/sys/firmware/acpi/tables/NBFT1

# Machine default 'nvme discover' commands. Query the
# Discovery Controller's two ports (some resources may only
# be accessible on a single port). Note an official
# nqn (Host) name defined in the NVMe specification is being used
# in this example.
-t rdma -a 192.168.69.33 -s 4420 -q nqn.2014-08.com.example:nvme:nvm-subsystem-sn-d78432
-t rdma -a 192.168.1.4   -s 4420 -q nqn.2014-08.com.example:nvme:nvm-subsystem-sn-d78432
در اعلان ترمینال "nvme discover" را وارد کنید.

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

nvme-connect(1) nvme-connect-all(1)

نویسندگان (AUTHORS)

این مستند توسط Jay Freyensee[1] نوشته شده است.

NVME

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

نکات (NOTES)

1.

Jay Freyensee