نام (NAME)

systemd-storagetm.service, systemd-storagetm - مدیریت دستگاه‌های ذخیره‌سازی NVMe-oF در حالت Target Mode

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

systemd-storagetm.service

/usr/lib/systemd/systemd-storagetm [OPTIONS...] [DEVICE]

توضیحات (DESCRIPTION)

systemd-storagetm.service سرویسی است که تمام دستگاه‌های بلوکی محلی را به عنوان دستگاه‌های ذخیره‌سازی انبوه NVMe-TCP ارائه می‌دهد. کاربرد اصلی آن، فراخوانی شدن توسط واحد storage-target-mode.target است که می‌توان سیستم را با آن بوت کرد.

هشدار

دیسک‌های NVMe در حال حاضر بدون احراز هویت یا رمزنگاری و در حالت خواندن/نوشتن ارائه می‌شوند. این بدان معناست که همتایان شبکه می‌توانند بدون هیچ محدودیتی از دستگاه بخوانند و روی آن بنویسند. بنابراین این قابلیت فقط باید در یک راه‌اندازی محلی استفاده شود.

توجه داشته باشید که برای عملکرد صحیح، شبکه نیز باید پیکربندی شده باشد. روش توصیه‌شده برای بوت شدن در حالت هدف ذخیره‌سازی، افزودن "rd.systemd.unit=storage-target-mode.target ip=link-local" به خط فرمان هسته است. توجه داشته باشید که "ip=link-local" تنها IP پیوند محلی، یعنی IPv4LL و IPv6LL را پیکربندی می‌کند که به معنای آدرس‌های غیرقابل مسیریابی است. این کار به دلایل امنیتی انجام می‌شود تا تنها سیستم‌های موجود در پیوند محلی بتوانند به دستگاه‌ها دسترسی داشته باشند. برای تخصیص آدرس‌های قابل مسیریابی، از "ip=dhcp" نیز می‌توانید استفاده کنید. برای جزئیات بیشتر به systemd-network-generator.service(8) مراجعه کنید.

مگر اینکه سوییچ --all استفاده شده باشد، این دستور انتظار دارد یک یا چند دستگاه بلوکی یا فایل معمولی به عنوان آرگومان جهت ارائه از طریق NVMe-TCP مشخص شوند.

گزینه‌ها (OPTIONS)

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

--nqn=

یک رشته دریافت می‌کند. در صورت مشخص شدن، نام واجد شرایط NVMe (یا همان NVMe Qualified Name) را برای استفاده در دستگاه‌های ذخیره‌سازی انبوه NVMe-TCP ارائه‌شده پیکربندی می‌کند. NQN باید از نحو توصیف‌شده در NVM Express Base Specification 2.0c[1]، بخش ۴.۵ با عنوان "NVMe Qualified Names" پیروی کند. توجه داشته باشید که NQN مشخص‌شده در اینجا، قبل از ارائه روی هدف NVMe، با یک نقطه و نام دستگاه بلوکی پسوندگذاری می‌شود. در صورت مشخص نشدن، به صورت پیش‌فرض برابر است با "nqn.2023-10.io.systemd:storagetm.ID"، که در آن ID با یک شناسهٔ ۱۲۸ بیتی برگرفته از machine-id(5) جایگزین می‌شود.

افزوده‌شده در نسخهٔ 255.

--all, -a

در صورت مشخص شدن، تمام دستگاه‌های بلوکی محلی، چه فعلی و چه آینده را از طریق NVMe-TCP ارائه می‌دهد (یعنی بر ورود و خروج دستگاه‌های بلوکی نظارت می‌کند و فهرست NVMe-TCP را در صورت نیاز به‌روزرسانی می‌نماید). توجه داشته باشید که به‌طور پیش‌فرض، هر دستگاه بلوکی که از همان دستگاه بلوکی پشتیبان سیستم‌فایل ریشهٔ فعلی سرچشمه گرفته باشد مستثنی می‌شود. اگر این سوییچ دو بار مشخص شود، این سازوکار ایمنی غیرفعال می‌گردد.

افزوده‌شده در نسخهٔ 255.

--list-devices

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

افزوده‌شده در نسخهٔ 257.

-h, --help

نمایش یک متن راهنمای کوتاه و خروج.

--version

نمایش یک نسخهٔ کوتاه از برنامه و خروج.

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

systemd(1), systemd.special(7)

یادداشت‌ها (NOTES)

1.: NVM Express Base Specification 2.0c

https://nvmexpress.org/wp-content/uploads/NVM-Express-Base-Specification-2.0c-2022.10.04-Ratified.pdf