راهنمای Service Scripts در Dell PowerStore؛ Help، Hypervisor، Import و Service Tool در قسمت هفتم

این قسمت هفتم از راهنمای Service Scripts در Dell PowerStore ادامه مباحث عیب‌یابی و Health Check قسمت ششم است. تمرکز این بخش روی چهار گروه متفاوت از ابزارهای Service قرار دارد: مشاهده Scriptهای قابل استفاده، جمع‌آوری اطلاعات Hypervisor، تنظیم محدودیت‌های Import Service و مدیریت Service Toolها و Service Escalation.

در پایان این قسمت، کارکرد svc_help، svc_hypervisor، svc_import_config و svc_inject، Scope هرکدام، سطح دسترسی موردنیاز و Syntax عملیات اصلی آن‌ها مشخص خواهد بود.

خلاصه مقاله

svc_help برای مشاهده Scriptهای موجود، svc_hypervisor برای جمع‌آوری Support Materials مرتبط با ESXi، svc_import_config برای کنترل محدودیت‌های Import Service و svc_inject برای مدیریت Service Tool، Key و Service Escalation استفاده می‌شوند. این چهار ابزار از نظر Scope و سطح دسترسی یکسان نیستند و پیش از اجرا باید Mode، Scope و پیش‌نیاز هرکدام بررسی شود.

مسیر مطالعه این راهنما

جایگاه قسمت هفتم در مجموعه Service Scripts
  • عیب‌یابی و Health Check در Dell PowerStore؛ قسمت ششم — عیب‌یابی، Datapath، Drive Statistics، داده‌های غیرقابل‌کاهش و Health Check.
  • قسمت هفتم ـ قسمت فعلی: Help، Hypervisor، Import Service و Service Tool.
  • قسمت هشتم: System Journal و مجموعه‌ای از ابزارهای مدیریتی Service Scripts.

ابزارهای Service این قسمت و سطح دسترسی آن‌ها

چهار Script این قسمت از نظر هدف و سطح دسترسی یکسان نیستند. svc_help یک ابزار عمومی برای مشاهده Scriptهای موجود است، در حالی که svc_import_config برای تغییر پیکربندی Import به سطح دسترسی بالاتری نیاز دارد.

مقایسه Scope و سطح دسترسی Scriptهای قسمت هفتم
ScriptکارکردحالتScopeگذرواژه Servicerootعدم دسترس‌پذیری دادهاز دست رفتن داده
svc_helpعملیات سیستمNormal یا ServiceClusterخیرخیرخیرخیر
svc_hypervisorعیب‌یابیNormal و ServiceNodeخیرخیرخیرخیر
svc_import_configپیکربندیService و NormalClusterبلهبلهخیرخیر
svc_injectبازیابیNormalNode یا Applianceخیرخیرخیرخیر

این تفاوت‌ها اهمیت دارند؛ زیرا وجود یک Service Script به این معنا نیست که همه عملیات آن با یک سطح دسترسی ثابت اجرا می‌شوند. پیش از اجرای هر ابزار باید Scope و الزامات دسترسی همان Script بررسی شود.

مشاهده راهنمای Service Scripts با svc_help

svc_help فهرست Service Scriptهای موجود را نمایش می‌دهد و برای دسترسی به پیام راهنمای Scriptها نیز استفاده می‌شود. این Script در Normal Mode یا Service Mode قابل اجرا است، Scope آن Cluster است و به گذرواژه Service یا دسترسی root نیاز ندارد.

فرمت دستور
svc_help [-h] [-a] [-s | --script]
گزینه‌های svc_help
پارامترکاربرد
-h, --helpپیام راهنما را نمایش می‌دهد و خارج می‌شود.
-a, --allهمه Scriptها را نمایش می‌دهد.
-s, --scriptپیام راهنمای Script را نمایش می‌دهد.

svc_help برای شناسایی Scriptهای موجود و دسترسی به Help آن‌ها به کار می‌رود و براساس مشخصات آن، باعث عدم دسترس‌پذیری یا از دست رفتن داده نمی‌شود.

عیب‌یابی Hypervisor با svc_hypervisor

svc_hypervisor برای جمع‌آوری Support Materials از Hypervisor روی Applianceها استفاده می‌شود. این Script همچنین امکان تهیه Snapshot از نصب فعلی Hypervisor را فراهم می‌کند تا تغییرات ایجادشده در Installation قابل شناسایی باشد.

Scope، حالت اجرا و محدودیت PowerStore X

svc_hypervisor در سطح Node عمل می‌کند و در Normal و Service Mode قابل اجرا است. گذرواژه Service و دسترسی root برای اجرای آن الزامی نیست.

نکته

این Script فقط برای اطلاعات مربوط به ESXi کاربرد دارد و پیش‌نیاز آن استفاده از PowerStore X Model Appliance است.

فرمت دستور
svc_hypervisor [-h] {run}

عملیات run، Support Materials را از Hypervisor روی Appliance جمع‌آوری می‌کند. با آرگومان output می‌توان Directory محل ذخیره اطلاعات جمع‌آوری‌شده را مشخص کرد.

جمع‌آوری Support Materials از ESXi

نمونه زیر اجرای Collection و ذخیره Support Materials در Directory تعیین‌شده را نشان می‌دهد.

نمونه دستور
svc_hypervisor run --output /home/user32/hypervisor/download/
vm-support v3.3: 10:48:41, action threads 4
Non-fatal errors encountered during the run:
   Cmd "/usr/sbin/vmkping -D -v" failed with exit code 255
Please attach this file when submitting an incident report.
To file a support incident, go to http://www.vmware.com/support/sr/sr_login.jsp
To see the files collected, check '/vmfs/volumes/9XFVDH2.A.INTERNAL/esx-H0111-host-1-2019-05-01--10.48-2358636.tgz'
Finished successfully.
/home/user32/hypervisor/download/esx-H0111-host-1-2019-05-01--10.48-2358636.tgz
Script svc_hypervisor finished successfully

در این نمونه، خروجی یک خطای Non-fatal برای vmkping را نشان می‌دهد، اما در ادامه Finished successfully و پایان موفق svc_hypervisor گزارش می‌شود. مسیر فایل ایجادشده نیز در خروجی قابل مشاهده است.

تنظیم Import Service با svc_import_config

svc_import_config برای تغییر پیکربندی Import Service استفاده می‌شود. این ابزار در سطح Cluster عمل می‌کند و دو عملیات اصلی set و list را در اختیار قرار می‌دهد.

محدودیت دسترسی

اجرای svc_import_config به گذرواژه کاربر Service و دسترسی root نیاز دارد.

فرمت دستور
svc_import_config [-h] {set,list}

عملیات set محدودیت‌های Import Configuration را تنظیم می‌کند و عملیات list همه Import Configurationهای موجود در Management Database را نمایش می‌دهد.

تنظیم محدودیت‌های Import Configuration

فرمت دستور
svc_import_config set [-h] [--max_remote_systems <value>] [--max_import_host_systems <value>] [--max_non_disruptive_import_sessions_mirror_limit <value>] [--max_import_sessions_in_copy <value>] [--max_agentless_import_sessions_mirror_limit <value>]
محدودیت‌های قابل تنظیم برای Import Service
گزینهکاربرد
--max_remote_systemsحداکثر تعداد سیستم‌های External Dell پشتیبانی‌شده برای Import را تعیین می‌کند.
--max_import_host_systemsحداکثر تعداد Host Systemهای پشتیبانی‌شده برای Import را تعیین می‌کند.
--max_non_disruptive_import_sessions_mirror_limitحداکثر تعداد Nondisruptive Import Sessionهای مجاز در وضعیت Mirror-enabled را تعیین می‌کند.
--max_import_sessions_in_copyحداکثر تعداد Active Import Sessionهای پشتیبانی‌شده برای عملیات Background Copy را تعیین می‌کند.
--max_agentless_import_sessions_mirror_limitحداکثر تعداد Agentless Import Sessionهای مجاز در وضعیت Mirror-enabled را تعیین می‌کند.

در محدودیت Nondisruptive، اگر مجموع Import Sessionهای دارای Background Copy و Sessionهای Nondisruptive در وضعیت Ready-for-Cutover از Limit بیشتر شود، سیستم Nondisruptive Active Import Session جدیدی آغاز نمی‌کند. Volume Group Import Sessionها مستقیماً در این حد شمرده نمی‌شوند، اما Member Import Sessionهای آن‌ها در محاسبه وارد می‌شوند.

max_import_sessions_in_copy تعداد Active Import Sessionهای پشتیبانی‌شده برای Background Copy را کنترل می‌کند. تعداد Sessionهای Active جدیدی که می‌توان آغاز کرد بر اساس تعداد Import Sessionهای موجود در وضعیت Ready for Cutover تغییر می‌کند و این Limit باید کمتر از max_import_sessions_in_ready_for_cutover باشد.

برای Agentless Import نیز اگر مجموع Import Sessionهای دارای Background Copy و Agentless Ready for Cutover از Limit تعیین‌شده بیشتر شود، Agentless Active Import Session جدید آغاز نمی‌شود. Volume Group Import Sessionها در این Limit شمرده نمی‌شوند، اما Member Import Sessionهای آن‌ها محاسبه می‌شوند.

مشاهده Import Configurationهای ثبت‌شده

عملیات list برای دریافت فهرست تمام Import Configurationهای موجود در Management Database استفاده می‌شود.

فرمت دستور
svc_import_config list [-h]

مدیریت Service Tool و Service Escalation با svc_inject

svc_inject روشی برای نصب Service Toolهای تأییدشده، کپی فایل‌های Software Upgrade یا نصب Secure Remote Support Recovery Packageها فراهم می‌کند. این Script در Normal Mode اجرا می‌شود و Scope آن Node یا Appliance است.

پیش‌نیاز

پیش از اجرای عملیات، Tool یا Package موردنظر باید روی Primary Node مربوط به Appliance کپی شده باشد.

فرمت دستور
svc_inject [-h] {status,info,generate-key,run,deactivate,delete}

عملیات اصلی svc_inject

عملیات svc_inject
عملیاتکاربرد
runService Tool یا Package مشخص‌شده را نصب می‌کند یا Service Escalation را فعال می‌سازد.
deleteService Tool یا Package تزریق‌شده را حذف می‌کند.
infoاطلاعات یک Package مشخص را نمایش می‌دهد.
generate-keyRoot Injection Key یا SupportAssist Recovery Package Key ایجاد می‌کند.
deactivateService Escalation را غیرفعال می‌کند.
statusوضعیت Service Escalation را گزارش می‌کند.

نصب Service Tool یا فعال‌کردن Service Escalation

فرمت دستور
svc_inject run [-h] [-s] [-q] {package}
گزینه‌های عملیات run
پارامترکاربرد
-h, --helpپیام راهنما را نمایش می‌دهد و خارج می‌شود.
-s, --singleTool را فقط روی Node فعلی نصب می‌کند.
-q, --quietPrompt یا Message اضافی را نمایش نمی‌دهد.
packageFull Path مربوط به Package یا Response Key مربوط به Root Injection Key.
نمونه دستور
svc_inject run 18328-61346-CD9BD-AD4DC-A33B2-B8EDF-FC4BC-FD15D-00
Current Challenge: FFCD6-29923-77FEB-70E6E-B97E7-3E879
INFO: Response successfully validated!
INFO: Enabling tool ...
INFO: Successfully enabled svc_service_shell
INFO: Run "svc_service_shell" to be granted root level access for servicing this system
Script svc_inject finished successfully

در نمونه فوق، پس از اعتبارسنجی موفق Response، ابزار svc_service_shell فعال می‌شود و پیام مربوط به استفاده از آن برای دریافت دسترسی سطح root جهت سرویس سیستم نمایش داده می‌شود.

حذف Service Tool و مشاهده اطلاعات Package

برای حذف یک Service Tool تزریق‌شده از عملیات delete استفاده می‌شود.

فرمت دستور
svc_inject delete [-h] {tool_name}
نمونه دستور
svc_inject delete test_esx_image-0.5.0.487325.tgz.bin
[No response if deletion was successful]

برای مشاهده اطلاعات مربوط به یک Tool تزریق‌شده از عملیات info استفاده می‌شود.

فرمت دستور
svc_inject info [-h] tool_name

ایجاد کلید و کنترل Service Escalation

عملیات generate-key برای ایجاد Root Injection Key یا SupportAssist Recovery Package Key در نظر گرفته شده است.

فرمت دستور
svc_inject generate-key [-h] [-s] [r]
گزینه‌های generate-key
پارامترکاربرد
-s, --srsایجاد SupportAssist Recovery Package Key.
-r, --rootایجاد Root Injection Key.
نمونه دستور
svc_inject generate-key -r
Current Challenge: 671FD-217B7-2F7CC-AB547-45814-40D99

برای غیرفعال‌کردن Service Escalation از عملیات deactivate استفاده می‌شود.

نمونه دستور
svc_inject deactivate
Service escalation has been deactivated

عملیات status نیز وضعیت Service Escalation را گزارش می‌کند.

نمونه دستور
svc_inject status
INFO: Access is currently DISABLED
INFO: Current attempt is: 0 (MAX: 3)
Script svc_inject finished successfully

نکات اجرایی و مرزهای دسترسی

مهم‌ترین تمایز میان Scriptهای این قسمت به Scope و سطح دسترسی مربوط است. svc_help در سطح Cluster و بدون دسترسی root اجرا می‌شود. svc_hypervisor در سطح Node قرار دارد و به PowerStore X Model و اطلاعات ESXi محدود است.

svc_import_config نیز Cluster Scope دارد، اما به گذرواژه Service و root نیاز دارد. در مقابل، اجرای خود svc_inject به root نیاز ندارد، هرچند از قابلیت‌های آن ایجاد Root Injection Key و کنترل Service Escalation است.

نکته اجرایی

برای svc_inject باید Tool یا Package پیش از اجرا روی Primary Node قرار گرفته باشد. برای svc_hypervisor نیز محدودیت PowerStore X Model و ESXi باید در نظر گرفته شود.

خلاصه:

براساس مشخصات چهار Script این قسمت، هیچ‌یک به‌عنوان عملیاتی که باعث عدم دسترس‌پذیری داده یا از دست رفتن داده شود معرفی نشده‌اند؛ اما الزامات دسترسی و پیش‌نیازهای آن‌ها متفاوت است.

جمع‌بندی مدیریت ابزارهای Service در این قسمت

قسمت هفتم راهنمای Service Scripts چهار نیاز متفاوت را پوشش می‌دهد. svc_help برای یافتن و مشاهده راهنمای Scriptها، svc_hypervisor برای جمع‌آوری Support Materials مربوط به ESXi روی PowerStore X، svc_import_config برای کنترل محدودیت‌های Import Service و svc_inject برای مدیریت Service Tool، Key و Service Escalation استفاده می‌شود.

پیش از اجرای هرکدام باید Scope، Mode و سطح دسترسی همان Script بررسی شود؛ به‌ویژه svc_import_config که به Service Password و root نیاز دارد و svc_inject که پیش‌نیاز آن قرارگرفتن Package یا Tool روی Primary Node است.

سوالات متداول

آیا svc_help برای اجرا به دسترسی root نیاز دارد؟

خیر. این Script در Normal یا Service Mode قابل استفاده است و نه گذرواژه Service و نه دسترسی root برای اجرای آن لازم نیست.

svc_hypervisor روی چه سیستم‌هایی کاربرد دارد؟

این Script برای PowerStore X Model Applianceها در نظر گرفته شده و اطلاعات جمع‌آوری‌شده آن مربوط به ESXi است.

آیا مقصد Support Materials در svc_hypervisor قابل تعیین است؟

بله. هنگام اجرای عملیات run می‌توان Directory مقصد را با آرگومان output مشخص کرد.

svc_import_config چه سطح دسترسی‌ای نیاز دارد؟

اجرای آن به گذرواژه کاربر Service و دسترسی root نیاز دارد و Scope آن Cluster است.

آیا svc_inject مستقیماً به root نیاز دارد؟

برای خود Script دسترسی root الزامی نیست، اما یکی از قابلیت‌های آن ایجاد Root Injection Key و فعال‌کردن مسیر Service Escalation است.

پیش از نصب Service Tool با svc_inject چه شرطی وجود دارد؟

Tool یا Package موردنظر باید ابتدا روی Primary Node مربوط به Appliance کپی شده باشد.

وضعیت Service Escalation چگونه بررسی می‌شود؟

عملیات status در svc_inject وضعیت Service Escalation و اطلاعات مربوط به Attempt فعلی را گزارش می‌کند.

بررسی فنی Dell PowerStore و Service Scripts

در قسمت بعدی مجموعه، بررسی System Journal و ابزارهای مدیریتی Service Scripts ادامه پیدا می‌کند. برای بررسی فنی Dell PowerStore، راهبری عملیات Service یا ارزیابی زیرساخت ذخیره‌سازی سازمانی می‌توانید از خدمات تخصصی آکو استفاده کنید.

خدمات ذخیره‌سازی سازمانی آکو
ارتباط با کارشناسان آکو