راهنمای Service Scripts در Dell PowerStore؛ قسمت اول

Service Scripts در Dell PowerStore ابزارهایی برای عیب‌یابی مشکلات، رفع مسائل رایج، انجام برخی وظایف عملیاتی و بازیابی سیستم از وضعیت خطا هستند. این Scriptها نسبت به PowerStore Manager، CLI و REST API اطلاعات عمیق‌تر و کنترل سطح پایین‌تری روی سیستم فراهم می‌کنند.

در قسمت اول این مجموعه، روش دسترسی و اجرای Service Scripts و سپس عملیات پایه Appliance، مدیریت Autoprovisioning و ثبت Configuration Cluster بررسی می‌شود. ادامه مجموعه در قسمت دوم به CAC/PIV و Maintenance اولیه اختصاص دارد.

خلاصه مقاله

برای اجرای Service Scripts باید Service Account در دسترس باشد، SSH در PowerStore Manager فعال شود و از یک SSH Client روی سیستمی با دسترسی شبکه به Cluster استفاده شود. این قسمت svc_appliance، svc_appliance_provisioning و svc_arrayconfig را پوشش می‌دهد.

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

قسمت 1 از 23

قسمت فعلی: اجرای Service Scripts، مدیریت Appliance، Provisioning و Configuration Capture.

قسمت بعدی: مدیریت امنیت و Maintenance اولیه PowerStore — CAC/PIV، Cleanup، DIMM CE State و Firmware Update Alert.

Service Scripts در Dell PowerStore چیست؟

Service Scripts برای عیب‌یابی، رفع مشکلات متداول، انجام بعضی وظایف عملیاتی و Recovery سیستم از وضعیت‌های خطا در PowerStore در نظر گرفته شده‌اند. این ابزارها سطح متفاوتی از دسترسی و اطلاعات را نسبت به Interfaceهای مدیریتی معمول ارائه می‌کنند.

Service Commandها با درنظرگرفتن نیاز مدیران سیستم‌های ذخیره‌سازی، کارشناسان Field Service و کارکنان Support طراحی شده‌اند. این Commandها در Operating Environment مبتنی بر Linux مربوط به PowerStore Appliance اجرا می‌شوند.

کاربر باید با Linux Shell، Commandهای مرتبط، سخت‌افزار PowerStore نصب‌شده و Operating Environment آن آشنا باشد.

هشدار

بعضی Commandها ممکن است به آموزش بیشتر یا root Access نیاز داشته باشند. اگر چنین الزامی در توضیحات Command ذکر شده است، بدون تأیید Service Representative مجاز آن را اجرا نکنید.

پیش‌نیازهای اجرای Service Scripts

  1. گذرواژه Service Account را دریافت کنید.
  2. در PowerStore Manager و بخش Settings، SSH را فعال کنید.
  3. یک SSH Client مانند PuTTY را روی کامپیوتری نصب کنید که به Cluster دسترسی شبکه داشته باشد.

اجرای Service Scripts از طریق SSH

اجرای Service Script شامل اتصال به Cluster، ورود با Service Account و اجرای Script موردنظر است.

اتصال به Cluster با Management IP

SSH Client را اجرا کرده و با استفاده از Management IP Address به Cluster متصل شوید.

برای مثال، هنگام استفاده از PuTTY باید Management IP مقصد را برای اتصال مشخص کنید.

ورود به Serviceability Docker Container

Username و Password حساب Service را برای ورود وارد کنید.

پس از Login موفق باید مستقیماً به Serviceability Docker Container متصل شده باشید.

مشاهده Service Scriptها و Help

برای مشاهده فهرست Scriptهای موجود، دستور زیر را اجرا کنید.

نمونه دستور
svc_help

هر Script دارای Option نوع --help است. برای نمونه:

نمونه دستور
svc_diag --help

مدیریت Appliance با svc_appliance

svc_appliance برای Shutdown مدیریت‌شده و Reboot یک Appliance منفرد در SAN Mode استفاده می‌شود. Scope این Service Script یک Appliance است.

مشخصات و Syntax دستور

مشخصات عملیاتی svc_appliance
مشخصهمقدار
Functionعیب‌یابی و بازیابی
ModeNormal یا Service
UsageService
Service User Passwordلازم است
root Accessلازم نیست
Data Unavailabilityممکن است
Data Lossخیر
ScopeAppliance
Prerequisiteهیچ‌کدام
فرمت دستور
svc_appliance [-h] [-d] {reboot,shutdown}

Operation نوع reboot برای راه‌اندازی مجدد Appliance و shutdown برای خاموش‌کردن آن استفاده می‌شود. Option نوع -d یا --debug سطح Logging را به Debug افزایش می‌دهد و Logها را در Console چاپ می‌کند.

Reboot کردن Appliance

فرمت دستور
svc_appliance reboot [-h] [-a] [-f] [-d]
Optionهای Reboot
Optionعملکرد
-h, --helpنمایش Help و خروج
-a, --asyncاجرا در Asynchronous Mode
-f, --forceنادیده‌گرفتن هشدارها و اجبار Reboot
-d, --debugفعال‌کردن Debugging برای Verbose Logging
نکته

این عملیات فقط زمانی باید استفاده شود که Service Provider آن را توصیه کرده باشد. رویه استاندارد Reboot کردن Nodeها به‌صورت یکی‌یکی است، مگر اینکه Support روش دیگری را توصیه کند.

هشدار

استفاده از --force هشدارهای شروع عملیات را نادیده می‌گیرد و ممکن است باعث عدم دسترس‌پذیری داده شود.

Shutdown کردن Appliance

برای خاموش‌کردن Appliance از Operation نوع shutdown استفاده می‌شود.

فرمت دستور
svc_appliance shutdown [-h] [-a] [-f] [-d]
Optionهای Shutdown
Optionعملکرد
-h, --helpنمایش Help و خروج
-a, --asyncاجرا در Asynchronous Mode
-f, --forceنادیده‌گرفتن هشدارها و اجبار Shutdown
-d, --debugفعال‌کردن Debugging برای Verbose Logging
هشدار

اجرای Shutdown با --force ممکن است باعث عدم دسترس‌پذیری داده شود.

مدیریت Provisioning با svc_appliance_provisioning

svc_appliance_provisioning قابلیت Autoprovisioning را روی Appliance انتخاب‌شده فعال یا غیرفعال می‌کند.

مشخصات و Syntax

مشخصات svc_appliance_provisioning
مشخصهمقدار
Functionپیکربندی
ModeService و Normal
Usageاستفاده عمومی
Service User Passwordلازم نیست
root Accessلازم نیست
Data Unavailabilityخیر
Data Lossخیر
ScopeAppliance
Prerequisiteهیچ‌کدام
فرمت دستور
svc_appliance_provisioning [-h] {enable,list,disable}

عملیات enable، list و disable

Operation نوع enable، Provisioning را روی Appliance فعال می‌کند. Operation نوع list وضعیت Provisioning را نمایش می‌دهد و disable برای غیرفعال‌کردن Provisioning استفاده می‌شود.

این Script به Service User Password یا root Access نیاز ندارد و برای آن احتمال Data Unavailability یا Data Loss ذکر نشده است.

نمونه غیرفعال‌کردن Provisioning

در مثال زیر Provisioning برای Appliance A2 غیرفعال می‌شود.

نمونه دستور
svc_appliance_provisioning disable A2

پس از غیرفعال‌شدن Provisioning، Storage Objectهای جدید روی Appliance A2 قرار نمی‌گیرند.

ثبت Configuration با svc_arrayconfig

svc_arrayconfig یک Snapshot از Configuration فعلی Cluster ثبت می‌کند. Scope این Script برابر Cluster است.

مشخصات و محدودیت Primary Node

مشخصات svc_arrayconfig
مشخصهمقدار
Functionعیب‌یابی
ModeNormal
Usageاستفاده عمومی
Service User Passwordلازم نیست
root Accessلازم نیست
Data Unavailabilityخیر
Data Lossخیر
ScopeCluster
PrerequisitePrimary Appliance باید در Normal Mode باشد
فرمت دستور
svc_arrayconfig [-h] {run}
نکته

svc_arrayconfig فقط روی Primary Node قابل اجرا است و نمی‌توان آن را از Secondary Node اجرا کرد.

دریافت System Snapshot بدون root

اگر root Access در اختیار ندارید، می‌توان با svc_arrayconfig فایل‌های JSON ایجاد کرد و سپس آن‌ها را در یک Archive قرار داد و از سیستم دانلود کرد.

در PowerStoreOS نسخه 3.0 و بالاتر، Cluster IP Address روی Secondary Node B قرار دارد. برای اجرای Script و دانلود System Snapshot باید Management IP Address مربوط به Node را در اختیار داشته باشید.

  1. به‌عنوان Service User وارد Service Container شوید.
  2. svc_arrayconfig را برای ایجاد فایل‌های JSON در Subdirectory مقصد اجرا کنید.
  3. وجود فایل‌های خروجی را بررسی کنید.
  4. فایل‌های JSON را در Archive قرار دهید.
  5. Bundle ایجادشده را از Directory مربوط به Service User دانلود کنید.
نمونه دستور
svc_arrayconfig run -o /home/service/user/capture
نمونه دستور
ls -la capture |wc -l
نمونه دستور
tar -zcvf array_config_collection.tar.tgz capture/*
ls /home/service/user/array*

ثبت پیکربندی فعلی Cluster

Operation نوع run پیکربندی فعلی Cluster را Capture می‌کند و مجموعه‌ای از Optionها برای کنترل Capture در اختیار کاربر قرار می‌دهد.

فرمت دستور
svc_arrayconfig run [-h] [-l value] [-c value] [-m] [-f {json,csv}]
 [-t {full,delta,metrics,full_metrics}] [-b value]
 [--timestamp value] [--response value]
 [--ts value] [--ts_query value]

این عملیات نیز فقط روی Primary Node قابل اجرا است.

انواع Capture و Optionهای svc_arrayconfig run

Optionهای اصلی Configuration Capture
Optionکاربرد
-h, --helpنمایش Help
-l, --limitتعیین محدودیت اندازه فایل بر حسب MB؛ پیش‌فرض بدون محدودیت است
-t, --typeانتخاب full، delta، metrics یا full_metrics
-b, --baseتعیین Base Directory برای تولید delta
-f, --formatانتخاب JSON یا CSV؛ پیش‌فرض JSON است
-c, --configتعیین Configuration File برای کنترل Capture Configuration
نکته

برای Capture نوع delta باید Base نیز مشخص شود. Output Directory انتخاب‌شده به‌عنوان Base باید متعلق به یک Capture قبلی از نوع full باشد.

نکات و محدودیت‌های اجرایی قسمت اول

سه Service Script این قسمت Scope و اثر عملیاتی یکسانی ندارند. svc_appliance می‌تواند Data Availability را تحت تأثیر قرار دهد، در حالی که برای svc_appliance_provisioning و svc_arrayconfig احتمال Data Unavailability و Data Loss ذکر نشده است.

Reboot کل Appliance نباید جایگزین رویه استاندارد Reboot تک‌به‌تک Nodeها شود، مگر اینکه Support چنین روشی را توصیه کند. svc_arrayconfig نیز فقط روی Primary Node اجرا می‌شود.

خلاصه:

پیش از اجرای هر Service Script، Function، Mode، Scope، سطح دسترسی، Prerequisite و اثر احتمالی عملیات بر Data Availability را بررسی کنید.

جمع‌بندی مدیریت پایه Service Scripts

قسمت اول راهنمای Service Scripts در Dell PowerStore مسیر ورود به Serviceability Docker Container و سه حوزه پایه را پوشش می‌دهد: کنترل Power یک Appliance، مدیریت Autoprovisioning و Capture کردن Configuration فعلی Cluster.

در عملیات Appliance، احتمال Data Unavailability مهم‌ترین ملاحظه است. برای svc_arrayconfig نیز اجرای Script فقط روی Primary Node و قرارداشتن Primary Appliance در Normal Mode باید در نظر گرفته شود.

قسمت دوم این مجموعه به مدیریت CAC/PIV، Cleanup، DIMM CE State و Firmware Update Alert اختصاص دارد.

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

آیا همه Service Scripts در Dell PowerStore به root نیاز دارند؟

خیر. نیاز به root به Service Script بستگی دارد. برای نمونه، svc_appliance_provisioning و svc_arrayconfig به root Access نیاز ندارند.

قبل از اجرای Service Script چگونه Syntax آن را بررسی کنیم؟

هر Script دارای Option نوع --help است و دستور svc_help نیز فهرست Scriptها را نمایش می‌دهد.

آیا svc_appliance به Service User Password نیاز دارد؟

بله. در مشخصات این Service Script نیاز به Service User Password اعلام شده است.

آیا Reboot کردن Appliance می‌تواند دسترسی به داده را مختل کند؟

بله. برای svc_appliance احتمال Data Unavailability وجود دارد، هرچند احتمال Data Loss برای آن خیر اعلام شده است.

آیا svc_arrayconfig روی Secondary Node اجرا می‌شود؟

خیر. این Service Script فقط روی Primary Node قابل اجرا است.

فرمت پیش‌فرض Configuration Capture چیست؟

فرمت پیش‌فرض JSON است و CSV نیز به‌عنوان فرمت خروجی قابل انتخاب است.

delta Capture در svc_arrayconfig به چه چیزی نیاز دارد؟

باید Base مشخص شود و Base Directory مربوط به Capture قبلی از نوع full باشد.

ادامه راهنمای Service Scripts در PowerStore

قسمت دوم این مجموعه، مدیریت CAC/PIV و عملیات Maintenance اولیه شامل Cleanup، DIMM CE State و Firmware Update Alert را پوشش می‌دهد. برای اجرای Service Scriptها در محیط عملیاتی، Scope، سطح دسترسی و اثر احتمالی هر Command بر Availability را پیش از اجرا بررسی کنید.
ارتباط با کارشناسان آکو