PowerFlexのenable_background_device_scanner、API、ログの変更

Summary: この記事では、v3.0.0.2 HF1で「保守的」モード機能が導入された後、VxFlexOSでバックグラウンド スキャナーを有効にするためのscliコマンドおよびREST APIコマンドの変更点について説明します。これにより、レポート作成機能をより適切に制御し、お客様がどのモードを有効にするかを判断できます。以前のすべてのバージョン(v3.0.1まで)では、バックグラウンドスキャナーには、device_onlyモードとcomparison_mode(device_onlyモードのすべての機能も含まれていました)の2つのオプションがありました。 ...

This article applies to This article does not apply to This article is not tied to any specific product. Not all product versions are identified in this article.

Instructions

ScaleIO v2.5以降、HF1比較モードには、比較エラーの修正をスキップして/opt/emc/scaleio/logs/comparison.0ファイルにレポートする新しいオプションが含まれています。これにより、通常の状態で比較モードの一部であったdevice_only モードの読み取り、修復、およびレポート機能も無効になります。 

scliとAPIの変更に加えて、バックグラウンド スキャナー比較モードがv3.0.0.2 HFで有効になっている場合に、SDSノードにいくつかのログが追加されました。

 

変更ログの変更: /opt/emc/scaleio/sds/logs/comparison.x

 19/11 10:50:12.446570 Scanning combs for device be4c66a400000001, loop #1945 ended, #scanned combs=137, #sec combs (skipped)=69, #primary combs skipped=0, #scanned teeth=19418

comparisons.x ファイルのデフォルト数を 10 からそれより小さい数に減らす手順:

 echo "tgt_comparison_file_history =2" >> /opt/emc/scaleio/sds/cfg/conf.txt ; pkill sds

ファイルを削減する必要があるすべてのSDSでこれを実行します。プライマリとセカンダリの間で検証するための新しいCRC32出力ログファイル(PRIまたはSECからの1MBユーザーデータのハッシュ出力を含む):

 /opt/emc/scaleio/sds/logs/{randomID}_compare_combID_offset_[pri/sec].log

例:

 /opt/emc/scaleio/sds/logs/1259357004_compare_71f2800001b5_18432_pri.log
Trace entry correlating in comparison.x:
13/11 14:03:54.470982 vtreeId a227e28500000000 Comb 71f2800001b5, offset 18432 - compare error - succeeded to fix the secondary by the primary, randId 1259357004.

対応するsds/logs/trc.xログ:

trc.5:13/11 14:03:54.459658 0x7f598e35ddb8:mgStorageRegion_VerifyDataCRC:02769: primary and secondary checksums are different (pri=1025730551, sec=3956700141). will dump the error. randId 1259357004. combId:71f2800001b5,vTree:0xa227e28500000000,offsetVol:0x12da000,offsetInComb:18432,sizeInLbs:2048,phyToothIdx:2608,srcToothIdx:inv,dstToothIdx:inv New:(0,0) Requested:(3,1) volId:0
trc.5:13/11 14:03:54.470972 0x7f598e35ddb8:raidScan_FixSecondaryByPrimary:00295: comb:71f2800001b5,vTree:0xa227e28500000000,offsetVol:0x12da000,offsetTooth:0x0, Comb 71f2800001b5, offset 18432 - fix the secondary by the primary, randId 1259357004, rc = SUCCESS
trc.5:13/11 14:03:54.470988 0x7f598e35ddb8:raidScan_HandleComparisonError:01006: compare error - succeeded to fix the secondary by the primary. randId 1259357004. combId:71f2800001b5,vTree:0xa227e28500000000,offsetVol:0x12da000,offsetInComb:18432,sizeInLbs:2048,phyToothIdx:2608,srcToothIdx:inv,dstToothIdx:inv New:(0,0) Requested:(3,1) volId:0
trc.5:13/11 14:03:54.472246 0x7f598e35ddb8:raidScan_HandleComparisonError:01046: Sent a message to the MDM on compare error (randId 1259357004). combId:71f2800001b5,vTree:0xa227e28500000000,offsetVol:0x12da000,offsetInComb:18432,sizeInLbs:2048,phyToothIdx:2608,srcToothIdx:inv,dstToothIdx:inv New:(0,0) Requested:(3,1) volId:0

2つの出力ファイルの確認:

 -rw-rw-rw-. 1 root root     4096 Nov 13 14:03 1259357004_compare_71f2800001b5_18432_pri.log
-rw-r--r--. 1 root root     4096 Nov 19 11:10 1259357004_compare_71f2800001b5_18432_sec.log

diff 1259357004_compare_71f2800001b5_18432_pri.log 1259357004_compare_71f2800001b5_18432_sec.log
Binary files 1259357004_compare_71f2800001b5_18432_pri.log and 1259357004_compare_71f2800001b5_18432_sec.log differ


[root@localhost logs]# md5sum 1259357004_compare_71f2800001b5_18432_pri.log
d11924aadfe72dd1117f260f8b092caf  1259357004_compare_71f2800001b5_18432_pri.log
[root@localhost logs]# md5sum 1259357004_compare_71f2800001b5_18432_sec.log
620f0b67a91f7f74151bc5be745b7110  1259357004_compare_71f2800001b5_18432_sec.log

古いコマンド

 scli --enable_background_device_scanner
Error: Either a valid Storage Pool ID or name must be specified

Usage: scli --enable_background_device_scanner (((--protection_domain_id  | --protection_domain_name ) --storage_pool_name ) | --storage_pool_id ) --scanner_mode  [--scanner_bandwidth_limit ] [--report_and_fix | --report_only]
Description: Enable background device scanner
Parameters:
    --protection_domain_id          Protection Domain ID
    --protection_domain_name      Protection Domain name
    --storage_pool_name           Storage Pool name
    --storage_pool_id               Storage Pool ID
    --scanner_mode                Scanner mode of operation where MODE can be one of the following:
                                        device_only - Perform read operations. Fix from peer on errors
                                        data_comparison - Perform the device_only test and compare the data content with peer. Not supported for fine granularity Storage Pools
    --scanner_bandwidth_limit           Bandwidth limit in KB per second per device. The given value should be between 10KB and 10MB. The default value is 3MB
    --report_and_fix                    Report errors and automatically fix them (default)
    --report_only                       Report errors without fixing them

スキャナー モード

動作

結果

device_only

report_and_fix

読み取りエラーのみが検出され、報告され、修正されます。

report_only

読み取りエラーのみが検出されて報告されます(修正はされません)

指定なし

report_and_fixと同じ(オプション1)

data_comparison

report_and_fix

読み取りエラーと比較エラーの両方が検出され、修正されます。

report_only

読み取りエラーと比較エラーの両方が検出され、報告される(修正されない)

指定なし

report_and_fixと同じ(オプション3)

 

新しいコマンド

 
 Usage: scli --enable_background_device_scanner (((--protection_domain_id  | --protection_domain_name ) --storage_pool_name ) | --storage_pool_id ) --read_error_action  --compare_error_action  [--scanner_bandwidth_limit ]
Description: Enable background device scanner
Parameters:
    --protection_domain_id          Protection Domain ID
    --protection_domain_name      Protection Domain name
    --storage_pool_name           Storage Pool name
    --storage_pool_id               Storage Pool ID
    --read_error_action         Read error handling. Can be one of the following:
                                        report_and_fix - Perform read operations and automatically fix from peer on errors
                                        report_only    - Perform read operations and report errors without fixing them
    --compare_error_action      Compare error handling. Can be one of the following:
                                        no_compare     - Perform read operations without comparing data content with peer
                                        report_and_fix - Perform read operations, compare data content with peer, and automatically fix
                                                         Not supported for fine granularity Storage Pools
                                        report_only    - Perform read operations, compare data content with peer, and report mismatches without fixing them
                                                         Not supported for fine granularity Storage Pools
    --scanner_bandwidth_limit           Bandwidth limit in KB per second per device. The given value should be between 10KB and 10MB. The default value is 3MB

読み取りエラー モード

エラー モードを比較します。

結果

マッピング

 

no_scan

no_scan

無効な組み合わせ - これにはdisableコマンドがあります。

無効な1

scannerMode = NULL (サポート対象外)

report_only

無効な組み合わせ:読み取らないと比較できません。

無効な2

 

report_and_fix

無効な組み合わせ:読み取らないと比較できません。

無効な3

 

report_only

no_scan

読み取りエラーのみが検出されて報告されます(修正はされません)

2

scannerMode = device_only

compareErrorAction = NULL

readErrorAction = report_only

 

report_only

読み取りエラーと比較エラーの両方が検出され、報告される(修正されない)

4

scannerMode = data_comparison

compareErrorAction = report_only

readErrorAction = report_only

 

report_and_fix

読み取りエラーと比較エラーの両方が検出されて報告されますが、修正されるのは比較エラーのみです。

新規 1

scannerMode = data_comparison

compareErrorAction = report_and_fix

readErrorAction = report_only

 

report_and_fix

no_scan

読み取りエラーのみが検出され、報告され、修正されます。

1

scannerMode = device_only

compareErrorAction = NULL

readErrorAction = report_and_fix

 

report_only

読み取りエラーと比較エラーの両方が検出されて報告されますが、修正されるのは読み取りエラーのみです。

新規 2

scannerMode = data_comparison

compareErrorAction = report_only

readErrorAction = report_and_fix

 

report_and_fix

読み取りエラーと比較エラーの両方が検出され、報告され、修正されます。

3

scannerMode = data_comparison

compareErrorAction = report_and_fix

readErrorAction = report_and_fix

 

Affected Products

PowerFlex rack, ScaleIO
Article Properties
Article Number: 000275658
Article Type: How To
Last Modified: 22 Jan 2025
Version:  1
Find answers to your questions from other Dell users
Support Services
Check if your device is covered by Support Services.