| mfiutil.8 (b626f5a73a48f44a31a200291b141e1da408a2ff) | mfiutil.8 (75f8dcc831bf80c7efc93d3461699f95033c1d28) |
|---|---|
| 1.\" Copyright (c) 2008, 2009 Yahoo!, Inc. 2.\" All rights reserved. 3.\" 4.\" Redistribution and use in source and binary forms, with or without 5.\" modification, are permitted provided that the following conditions 6.\" are met: 7.\" 1. Redistributions of source code must retain the above copyright 8.\" notice, this list of conditions and the following disclaimer. --- 312 unchanged lines hidden (view full) --- 321.Pp 322The 323.Ar count 324parameter is a debugging aid that specifies the number of events to fetch from 325the controller for each low-level request. 326The default is 15 events. 327.Pp 328By default, matching event log entries from the previous shutdown up to the | 1.\" Copyright (c) 2008, 2009 Yahoo!, Inc. 2.\" All rights reserved. 3.\" 4.\" Redistribution and use in source and binary forms, with or without 5.\" modification, are permitted provided that the following conditions 6.\" are met: 7.\" 1. Redistributions of source code must retain the above copyright 8.\" notice, this list of conditions and the following disclaimer. --- 312 unchanged lines hidden (view full) --- 321.Pp 322The 323.Ar count 324parameter is a debugging aid that specifies the number of events to fetch from 325the controller for each low-level request. 326The default is 15 events. 327.Pp 328By default, matching event log entries from the previous shutdown up to the |
| 329present are displayed. This range can be adjusted via the | 329present are displayed. 330This range can be adjusted via the |
| 330.Ar start 331and 332.Ar stop 333parameters. 334Each of these parameters can either be specified as a log entry number or as 335one of the following aliases: 336.Bl -tag -width indent 337.It Cm newest --- 40 unchanged lines hidden (view full) --- 378.It Cm rebuild Ar drive 379Mark a failed 380.Ar drive 381that is still part of an array as a good drive suitable for a rebuild. 382The firmware should kick off an array rebuild on its own if a failed drive 383is marked as a rebuild drive. 384.It Cm syspd Ar drive 385Present the drive to the host operating system as a disk SYSPD block device in | 331.Ar start 332and 333.Ar stop 334parameters. 335Each of these parameters can either be specified as a log entry number or as 336one of the following aliases: 337.Bl -tag -width indent 338.It Cm newest --- 40 unchanged lines hidden (view full) --- 379.It Cm rebuild Ar drive 380Mark a failed 381.Ar drive 382that is still part of an array as a good drive suitable for a rebuild. 383The firmware should kick off an array rebuild on its own if a failed drive 384is marked as a rebuild drive. 385.It Cm syspd Ar drive 386Present the drive to the host operating system as a disk SYSPD block device in |
| 386the format /dev/mfisyspdX. Clear this flag with | 387the format /dev/mfisyspdX. 388Clear this flag with |
| 387.Cm good 388.Ar drive 389.It Cm drive progress Ar drive 390Report the current progress and estimated completion time of drive operations 391such as rebuilds or patrol reads. 392.It Cm drive clear Ar drive Brq "start | stop" 393Start or stop the writing of all 0x00 characters to a drive. 394.It Cm start rebuild Ar drive --- 124 unchanged lines hidden (view full) --- 519.It Cm raid60 520Creates one RAID60 volume spanning multiple RAID6 arrays. 521The drives for each RAID6 array are specified as a single drive list. 522.It Cm concat 523Creates a single volume by concatenating all of the drives in the single drive 524list. 525.El 526.Pp | 389.Cm good 390.Ar drive 391.It Cm drive progress Ar drive 392Report the current progress and estimated completion time of drive operations 393such as rebuilds or patrol reads. 394.It Cm drive clear Ar drive Brq "start | stop" 395Start or stop the writing of all 0x00 characters to a drive. 396.It Cm start rebuild Ar drive --- 124 unchanged lines hidden (view full) --- 521.It Cm raid60 522Creates one RAID60 volume spanning multiple RAID6 arrays. 523The drives for each RAID6 array are specified as a single drive list. 524.It Cm concat 525Creates a single volume by concatenating all of the drives in the single drive 526list. 527.El 528.Pp |
| 527.Sy Note: | 529.Sy Note : |
| 528Not all volume types are supported by all controllers. 529.Pp 530If the 531.Fl v 532flag is specified after 533.Ar type , 534then more verbose output will be enabled. 535Currently this just provides notification as drives are added to arrays and --- 61 unchanged lines hidden (view full) --- 597.It Cm manual 598Enable manual patrol reads that are only initiated by the user. 599.El 600.It Cm start patrol 601Start a patrol read operation. 602.It Cm stop patrol 603Stop a currently running patrol read operation. 604.It Cm foreign scan | 530Not all volume types are supported by all controllers. 531.Pp 532If the 533.Fl v 534flag is specified after 535.Ar type , 536then more verbose output will be enabled. 537Currently this just provides notification as drives are added to arrays and --- 61 unchanged lines hidden (view full) --- 599.It Cm manual 600Enable manual patrol reads that are only initiated by the user. 601.El 602.It Cm start patrol 603Start a patrol read operation. 604.It Cm stop patrol 605Stop a currently running patrol read operation. 606.It Cm foreign scan |
| 605Scan for foreign configurations and display the number found. The | 607Scan for foreign configurations and display the number found. 608The |
| 606.Ar config 607argument for the commands below takes the form of a number from 0 to the total 608configurations found. 609.It Cm foreign clear Op config 610Clear the specified foreign 611.Ar config 612or all if no 613.Ar config --- 26 unchanged lines hidden (view full) --- 640regardless of the BBU mode. 641In particular, the controller write cache will be disabled during the relearn 642even if transparent learning mode is enabled. 643.It Cm bbu Ar setting Ar value 644Update battery backup unit (BBU) properties related to battery relearning. 645The following settings are configurable: 646.Bl -tag -width indent 647.It Cm learn-delay | 609.Ar config 610argument for the commands below takes the form of a number from 0 to the total 611configurations found. 612.It Cm foreign clear Op config 613Clear the specified foreign 614.Ar config 615or all if no 616.Ar config --- 26 unchanged lines hidden (view full) --- 643regardless of the BBU mode. 644In particular, the controller write cache will be disabled during the relearn 645even if transparent learning mode is enabled. 646.It Cm bbu Ar setting Ar value 647Update battery backup unit (BBU) properties related to battery relearning. 648The following settings are configurable: 649.Bl -tag -width indent 650.It Cm learn-delay |
| 648Add a delay to the next scheduled battery relearn event. This setting is 649given in hours and must lie in the range of 0 to 255. | 651Add a delay to the next scheduled battery relearn event. 652This setting is given in hours and must lie in the range of 0 to 255. |
| 650.It Cm autolearn-mode 651Enable or disable automatic periodic battery relearning. 652The setting may be set to 653.Dq enable 654or 655.Dq disable 656to respectively enable or disable the relearn cycle. 657Alternatively, a mode of 0, 1 or 2 may be given. 658Mode 0 enables periodic relearning, mode 1 disables it, and mode 2 disables 659it and logs a warning to the event log when it detects that a battery relearn 660should be performed. 661.It Cm bbu-mode | 653.It Cm autolearn-mode 654Enable or disable automatic periodic battery relearning. 655The setting may be set to 656.Dq enable 657or 658.Dq disable 659to respectively enable or disable the relearn cycle. 660Alternatively, a mode of 0, 1 or 2 may be given. 661Mode 0 enables periodic relearning, mode 1 disables it, and mode 2 disables 662it and logs a warning to the event log when it detects that a battery relearn 663should be performed. 664.It Cm bbu-mode |
| 662Set the BBU's mode of operation. This setting is not supported by all BBUs. | 665Set the BBU's mode of operation. 666This setting is not supported by all BBUs. |
| 663Where it is supported, the possible values are the integers between 1 and 5 664inclusive. 665Modes 1, 2 and 3 enable a transparent learn cycle, whereas modes 4 and 5 do not. 666The BBU's data retention time is greater when transparent learning is not used. 667.El 668.It Cm ctrlprop Ar rebuild Op Ar rate 669With no arguments display the rate of rebuild (percentage)a for volumes. 670With an integer argument (0-100), set that value as the new rebuild rate for volumes. 671.It Cm ctrlprop Ar alarm Op Ar 0/1 672With no arguments display the current alarm enable/disable status. | 667Where it is supported, the possible values are the integers between 1 and 5 668inclusive. 669Modes 1, 2 and 3 enable a transparent learn cycle, whereas modes 4 and 5 do not. 670The BBU's data retention time is greater when transparent learning is not used. 671.El 672.It Cm ctrlprop Ar rebuild Op Ar rate 673With no arguments display the rate of rebuild (percentage)a for volumes. 674With an integer argument (0-100), set that value as the new rebuild rate for volumes. 675.It Cm ctrlprop Ar alarm Op Ar 0/1 676With no arguments display the current alarm enable/disable status. |
| 673With a 0, disable alarms. With a 1, enable alarms. | 677With a 0, disable alarms. 678With a 1, enable alarms. |
| 674.El 675.Sh EXAMPLES 676Configure the cache for volume mfid0 to cache only writes: 677.Pp 678.Dl Nm Cm cache mfid0 writes 679.Dl Nm Cm cache mfid0 write-back 680.Pp 681Create a RAID5 array spanning the first four disks in the second enclosure: --- 42 unchanged lines hidden --- | 679.El 680.Sh EXAMPLES 681Configure the cache for volume mfid0 to cache only writes: 682.Pp 683.Dl Nm Cm cache mfid0 writes 684.Dl Nm Cm cache mfid0 write-back 685.Pp 686Create a RAID5 array spanning the first four disks in the second enclosure: --- 42 unchanged lines hidden --- |