مدیریت Support Materials و DDSD در Dell PowerStore؛ راهنمای Service Scripts قسمت پنجم

مدیریت Support Materials و DDSD در Dell PowerStore؛ راهنمای Service Scripts قسمت پنجم

در قسمت پنجم راهنمای Service Scripts در Dell PowerStore، تمرکز بر جمع‌آوری و مدیریت Support Materials با svc_dc و سپس کنترل Logging مربوط به Data Domain Storage Direct یا DDSD و DD Boost با svc_dd است. svc_dc چرخه‌ای کامل از ایجاد Data Collection تا فهرست، حذف، دانلود و آپلود آن را در اختیار مدیر سیستم قرار می‌دهد.

این بخش ادامه مجموعه Service Scripts است. قسمت قبل به Counter Collection، SLIC، Security Compliance و Container Management پرداخته بود و قسمت بعدی با svc_diag وارد عیب‌یابی مستقیم سیستم می‌شود.

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

Support Materials در Dell PowerStore چیست؟

Service Script مربوط به svc_dc برای تحلیل فنی یک Support Materials Bundle یا Data Collection Bundle ایجاد می‌کند. محتوای Bundle با توجه به گزینه‌ها و Profile انتخاب‌شده می‌تواند شامل System Log، جزئیات Configuration و دیگر اطلاعات مرتبط با Troubleshooting باشد.

این داده‌ها برای تحلیل مسائل سیستم، از جمله مشکلات Performance، قابل استفاده هستند. برای آشنایی با مسیر عمومی جمع‌آوری اطلاعات سیستم، مقاله راهنمای جمع‌آوری داده‌های سیستم در Dell PowerStore می‌تواند مسیر مکمل این بخش باشد.

در سناریوهایی که هدف بررسی Performance است، Support Materials می‌تواند در کنار اطلاعات حاصل از پایش عملکرد Dell PowerStore برای تحلیل فنی استفاده شود.

ساختار کلی svc_dc و عملیات اصلی

svc_dc مجموعه Subcommandهای لازم برای ایجاد، مدیریت و انتقال Data Collection را در یک Service Script واحد ارائه می‌دهد.

svc_dc [-h] [-v] {run,delete,list,list_profiles,list_dumps,download,upload}

گزینه -h یا --help پیام راهنما را نمایش می‌دهد و گزینه -v یا --version شماره نسخه Program را نمایش داده و سپس خارج می‌شود.

دامنه، حالت اجرا و پیش‌نیازهای svc_dc

عملیات اصلی Support Materials

ایجاد Support Materials Bundle با svc_dc run

svc_dc run برای ایجاد یک Support Materials Bundle یا Data Collection جدید روی Local Appliance استفاده می‌شود. برای هر Appliance در Cluster یک Support Materials Archive ایجاد می‌شود و Archive به‌صورت Local روی همان Appliance ذخیره خواهد شد.

svc_dc run [-h] [--debug] [-v] [--output {json}] [-p <value>] [-a <value>]
[-vol <value>] [-vvol <value>] [-d <value>] [-u]
[-t {last_24_hours,last_48_hours,last_1_week,last_2_weeks,custom}]
[-from LOG_FROM_TIMESTAMP <value>] [-to LOG_TO_TIMESTAMP <value>]

انتخاب Appliance، Volume و Profile

گزینه -a یا --appliances فهرست Appliance IDهایی را تعیین می‌کند که باید در Collection حضور داشته باشند. مقدار پیش‌فرض این گزینه فقط Local Appliance است.

برای یافتن Appliance ID، دستور زیر در همین Workflow معرفی شده است:

svc_diag --basic

گزینه -vol یا --volumes فهرست Volume IDها و -vvol یا --virtual_volumes فهرست Virtual Volume IDها را مشخص می‌کند.

گزینه -p یا --profiles برای تعیین Profileهای مورد استفاده و -d یا --description برای ثبت توضیح مرتبط با Data Collection استفاده می‌شود.

گزینه --u یا --upload Data Collection ایجادشده را Upload می‌کند. --debug Verbose Logging را برای Debug فعال کرده و -v یا --verbose Verbose Command Output را فعال می‌کند. با --output {json} نیز خروجی در فرمت JSON نمایش داده می‌شود.

تعیین بازه زمانی Journal Log

گزینه -t یا --timeframe بازه زمانی جمع‌آوری Journal Logها را مشخص می‌کند. مقادیر تعریف‌شده شامل last_24_hours، last_48_hours، last_1_week، last_2_weeks و custom هستند.

در صورت انتخاب custom، گزینه -from یا -to مورد استفاده قرار می‌گیرد. Timestamp باید با فرمت YYYY-MM-DD HH:mm:ss و در UTC Time Zone باشد.

اجرای Data Collection

نمونه زیر ایجاد Support Materials روی دو Appliance با Profile Essential را نشان می‌دهد.

svc_dc run --profiles=essential --appliance=APM00162303297,APM00152832910
start_timestamp     status  description      creator_type profile appliances
2019-05-20 17:49:33 Success                  Scheduled    Ess,Det APM00162303297+1
2019-05-21 12:10:31 Success SR 87936386      System       Ess,Det APM00152832910
2019-05-21 17:49:33 Success                  Scheduled    Perf    APM00162303297+1
2019-05-22 17:49:33 Success After switch reb Manual       Ess     APM00162303297   <<
New collection

مدیریت Data Collectionهای موجود

پس از ایجاد Support Materials، عملیات‌های delete، list، list_profiles و list_dumps برای مدیریت Inventory و فایل‌های جمع‌آوری‌شده استفاده می‌شوند.

حذف Support Materials با svc_dc delete

svc_dc delete برای حذف یک Support Materials Bundle استفاده می‌شود.

svc_dc delete [-h] [--debug] [-v] [--output {json}] [id]

اگر ID مشخص نشود، Script در Interactive Mode اجرا می‌شود و همه Bundleهای ذخیره‌شده را نمایش می‌دهد. انتخاب Index مربوط به یک Collection باعث حذف همان Collection خواهد شد. اگر ID از ابتدا مشخص شده باشد، همان Bundle هدف عملیات است.

svc_dc delete
Index start_timestamp           id
0     2019-09-15 19:01:24       b3a42a8a-874b-4dfa-b812-1e0a9a35f105
1     2019-09-15 20:25:26       d97e6a7a-4eeb-4edb-b6bc-c1e80f787576
2     2019-09-15 20:26:05       0fcd64ae-9b50-4143-8bba-af817b6e9910
3     2019-09-15 20:52:17       40bb350f-9924-4c3d-b982-ec3c61087442
4     2019-09-18 16:02:46       9f82faec-2d32-48ad-b40c-02a36c30ab09
5     2019-09-18 16:13:12       77aed64d-7282-45b7-a691-d069a05b009b
6     2019-09-18 16:13:46       a773fd98-ce53-4ce3-8b67-60dae42b03a9
7     2019-09-18 18:24:35       a9ec44a0-09c2-47dc-baef-7a8e4a7bd3c3
8     2019-09-18 18:28:43       683a4339-0c25-4445-b5fc-9e9f16a5f4d0
Select a data collection index (q to quit): 4

فهرست‌کردن Support Materials با svc_dc list

اگر svc_dc list روی Master Appliance اجرا شود، Inventory مربوط به Support Materials از همه Applianceهای Cluster دریافت می‌شود. اجرای آن روی Appliance غیر Master فقط Inventory مربوط به Local Appliance را برمی‌گرداند.

svc_dc list [-h] [--debug] [-v] [--output {json}] [id]

در توضیحات این Subcommand، JSON تنها فرمت خروجی موجود معرفی شده است و بدون JSON، Command با خطا مواجه می‌شود.

svc_dc list --verbose
start_timestamp     status  description  creator_type profiles      id       appliances
2019-09-20 17:49:33 Success              Scheduled    Ess,Det       b3a42a8a APM00162303297
2019-09-21 12:10:31 Success              System       Ess,Det       d97e6a7a APM00152832910
2019-09-21 17:49:33 Success              Scheduled    Ess,Det,Hyp+1 8b0a69c2 APM00162303297
2019-09-22 17:49:33 Success              Scheduled    Ess,Det       b6bc2a8a APM00162303297

مشاهده Support Materials Profileها

svc_dc list_profiles برای فهرست‌کردن Data Collection Profileهای در دسترس و توضیح آن‌ها استفاده می‌شود.

svc_dc list_profiles [-h] [--debug] [-v] [--output {json}]

svc_dc list_profiles
Name                    Prompt
essential               Collect essential data.
detailed                Collect detailed information.
hypervisor              My problem may involve the hypervisor
controlpathHeapDump     Collect CP information.
nas                     Collect NAS information.

Profileهای نمونه شامل Essential، Detailed، Hypervisor، controlpathHeapDump و NAS هستند.

فهرست‌کردن System Dumpها

svc_dc list_dumps روی Master Appliance همه فایل‌های System Dump موجود در کل Cluster را دریافت می‌کند. اگر روی Appliance غیر Master اجرا شود، فقط Inventory مربوط به Local Appliance دریافت خواهد شد.

svc_dc list_dumps [-h] [--debug] [-v] [--output {json}] [id]

svc_dc list_dumps --verbose
List a summary of the system dumps on the cluster.

دانلود و آپلود Support Materials

پس از ایجاد Data Collection، svc_dc امکان انتقال Bundle به Remote Host یا Upload آن برای تحلیل از راه دور را فراهم می‌کند.

دانلود Bundle روی Remote Host

svc_dc download یک Support Materials Bundle را در مقصد مشخص‌شده دانلود می‌کند. در صورت تعیین‌نشدن ID، Script در Interactive Mode اجرا شده و Bundleهای موجود برای انتخاب نمایش داده می‌شوند.

svc_dc download [-h] [--debug] [-v] [--output {json}] [--ip value]
[--path value] [--username value] [-do] [-so] [id value]

در بخش آرگومان‌های نام‌دار، IP Address، Path، Username و Password مربوط به Remote Host معرفی شده‌اند.

svc_dc download --ip=10.12.13.45 --path=/home/eng
--username=tom
--password=password
40bb350f-9924-4c3d-b982-ec3c61087442

در نمونه بالا Support Materials Bundle با Identifier مشخص به Directory /home/eng روی Remote Host منتقل می‌شود.

آپلود Data Collection به CloudIQ

svc_dc upload برای Upload کردن Data Collection به CloudIQ از طریق Secure Remote Services استفاده می‌شود. برای زمینه تکمیلی ارتباط پشتیبانی می‌توان راهنمای Licensing، Workstation و Support Connectivity در Dell PowerStore را نیز بررسی کرد.

svc_dc upload [-h] [--debug] [-v] [--output {json}] [--skip-cp] [-f] [id]

اگر Data Collection ID مشخص نشود، Command در Interactive Mode اجرا می‌شود و Collectionهای موجود برای انتخاب نمایش داده خواهند شد.

مدیریت DDSD و DD Boost Logging با svc_dd

svc_dd امکان فعال یا غیرفعال‌کردن Data Domain Storage Direct یا DDSD و Logging مربوط به DD Boost را روی سیستم PowerStore فراهم می‌کند.

دامنه و شرایط اجرای svc_dd

در حالی که svc_dc در Normal یا Service Mode قابل استفاده است، svc_dd برای Service Mode تعریف شده است.

فعال‌سازی، غیرفعال‌سازی و تعیین Levelهای Logging

svc_dd [-h] [--enable_ddsd_logging] [--disable_ddsd_logging]
[--set_ddsd_warning] [--set_ddsd_debug] [--set_ddsd_info]
[--set_ddsd_error] [--set_ddboost_info] [--set_ddboost_debug]
[--enable_ddboost_logging] [--disable_ddboost_logging]
[--set_ddboost_error] [--show_logging]

نکات فنی و محدودیت‌های مهم

مطالب و محصولات مرتبط

جمع‌بندی مدیریت Support Materials و DDSD

قسمت پنجم Service Scripts دو حوزه مرتبط با Serviceability را پوشش می‌دهد. در بخش نخست، svc_dc چرخه کامل Support Materials را از ایجاد Data Collection و انتخاب Profile تا List، Delete، System Dump، Download و Upload در اختیار مدیر سیستم قرار می‌دهد. رفتار برخی عملیات نیز بسته به اجرای Script روی Master یا Local Appliance تغییر می‌کند.

در بخش دوم، svc_dd امکان مدیریت Logging مربوط به DDSD و DD Boost را در Service Mode و در Scope سطح Cluster فراهم می‌کند.

با پایان این قسمت، مسیر مجموعه به svc_diag می‌رسد؛ Service Scriptی که موضوع قسمت ششم و ورود مستقیم به عیب‌یابی سیستم Dell PowerStore است.

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