xref: /freebsd/usr.sbin/mfiutil/mfiutil.8 (revision d0b2dbfa)
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.
9.\" 2. Redistributions in binary form must reproduce the above copyright
10.\"    notice, this list of conditions and the following disclaimer in the
11.\"    documentation and/or other materials provided with the distribution.
12.\" 3. The names of the authors may not be used to endorse or promote
13.\"    products derived from this software without specific prior written
14.\"    permission.
15.\"
16.\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND
17.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
18.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
19.\" ARE DISCLAIMED.  IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE
20.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
21.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
22.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
23.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
24.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
25.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
26.\" SUCH DAMAGE.
27.\"
28.\" $FreeBSD$
29.\"
30.Dd September 2, 2011
31.Dt MFIUTIL 8
32.Os
33.Sh NAME
34.Nm mfiutil ,
35.Nm mrsasutil
36.Nd Utility for managing LSI MegaRAID SAS controllers
37.Sh SYNOPSIS
38.Nm
39.Cm version
40.Nm
41.Op Fl D Ar device
42.Op Fl t Ar type
43.Op Fl u Ar unit
44.Cm show adapter
45.Nm
46.Op Fl D Ar device
47.Op Fl t Ar type
48.Op Fl u Ar unit
49.Cm show battery
50.Nm
51.Op Fl d
52.Op Fl e
53.Op Fl D Ar device
54.Op Fl t Ar type
55.Op Fl u Ar unit
56.Cm show config
57.Nm
58.Op Fl D Ar device
59.Op Fl t Ar type
60.Op Fl u Ar unit
61.Cm show drives
62.Nm
63.Op Fl D Ar device
64.Op Fl t Ar type
65.Op Fl u Ar unit
66.Cm show events
67.Op Fl c Ar class
68.Op Fl l Ar locale
69.Op Fl n Ar count
70.Op Fl v
71.Op Ar start Op Ar stop
72.Nm
73.Op Fl D Ar device
74.Op Fl t Ar type
75.Op Fl u Ar unit
76.Cm show firmware
77.Nm
78.Op Fl D Ar device
79.Op Fl t Ar type
80.Op Fl u Ar unit
81.Cm show foreign Op Ar volume
82.Nm
83.Op Fl D Ar device
84.Op Fl t Ar type
85.Op Fl u Ar unit
86.Cm show logstate
87.Nm
88.Op Fl d
89.Op Fl e
90.Op Fl D Ar device
91.Op Fl t Ar type
92.Op Fl u Ar unit
93.Cm show patrol
94.Nm
95.Op Fl d
96.Op Fl e
97.Op Fl D Ar device
98.Op Fl t Ar type
99.Op Fl u Ar unit
100.Cm show progress
101.Nm
102.Op Fl D Ar device
103.Op Fl t Ar type
104.Op Fl u Ar unit
105.Cm show volumes
106.Nm
107.Op Fl D Ar device
108.Op Fl t Ar type
109.Op Fl u Ar unit
110.Cm fail Ar drive
111.Nm
112.Op Fl D Ar device
113.Op Fl t Ar type
114.Op Fl u Ar unit
115.Cm good Ar drive
116.Nm
117.Op Fl D Ar device
118.Op Fl t Ar type
119.Op Fl u Ar unit
120.Cm rebuild Ar drive
121.Nm
122.Op Fl D Ar device
123.Op Fl t Ar type
124.Op Fl u Ar unit
125.Cm syspd Ar drive
126.Nm
127.Op Fl D Ar device
128.Op Fl t Ar type
129.Op Fl u Ar unit
130.Cm drive progress Ar drive
131.Nm
132.Op Fl D Ar device
133.Op Fl t Ar type
134.Op Fl u Ar unit
135.Cm drive clear Ar drive Brq "start | stop"
136.Nm
137.Op Fl D Ar device
138.Op Fl t Ar type
139.Op Fl u Ar unit
140.Cm start rebuild Ar drive
141.Nm
142.Op Fl D Ar device
143.Op Fl t Ar type
144.Op Fl u Ar unit
145.Cm abort rebuild Ar drive
146.Nm
147.Op Fl D Ar device
148.Op Fl t Ar type
149.Op Fl u Ar unit
150.Cm locate Ar drive Brq "on | off"
151.Nm
152.Op Fl D Ar device
153.Op Fl t Ar type
154.Op Fl u Ar unit
155.Cm cache Ar volume Op Ar setting Oo Ar value Oc Op ...
156.Nm
157.Op Fl D Ar device
158.Op Fl t Ar type
159.Op Fl u Ar unit
160.Cm name Ar volume Ar name
161.Nm
162.Op Fl D Ar device
163.Op Fl t Ar type
164.Op Fl u Ar unit
165.Cm volume progress Ar volume
166.Nm
167.Op Fl D Ar device
168.Op Fl t Ar type
169.Op Fl u Ar unit
170.Cm clear
171.Nm
172.Op Fl D Ar device
173.Op Fl t Ar type
174.Op Fl u Ar unit
175.Cm create Ar type
176.Op Fl v
177.Op Fl s Ar stripe_size
178.Ar drive Ns Op \&, Ns Ar drive Ns Op ",..."
179.Op Ar drive Ns Op \&, Ns Ar drive Ns Op ",..."
180.Nm
181.Op Fl D Ar device
182.Op Fl t Ar type
183.Op Fl u Ar unit
184.Cm delete Ar volume
185.Nm
186.Op Fl D Ar device
187.Op Fl t Ar type
188.Op Fl u Ar unit
189.Cm add Ar drive Op Ar volume
190.Nm
191.Op Fl D Ar device
192.Op Fl t Ar type
193.Op Fl u Ar unit
194.Cm remove Ar drive
195.Nm
196.Op Fl D Ar device
197.Op Fl t Ar type
198.Op Fl u Ar unit
199.Cm start patrol
200.Nm
201.Op Fl D Ar device
202.Op Fl t Ar type
203.Op Fl u Ar unit
204.Cm stop patrol
205.Nm
206.Op Fl D Ar device
207.Op Fl t Ar type
208.Op Fl u Ar unit
209.Cm patrol Ar command Op Ar interval Op Ar start
210.Nm
211.Op Fl D Ar device
212.Op Fl t Ar type
213.Op Fl u Ar unit
214.Cm foreign scan
215.Nm
216.Op Fl D Ar device
217.Op Fl t Ar type
218.Op Fl u Ar unit
219.Cm foreign clear Op Ar config
220.Nm
221.Op Fl D Ar device
222.Op Fl t Ar type
223.Op Fl u Ar unit
224.Cm foreign diag Op Ar config
225.Nm
226.Op Fl D Ar device
227.Op Fl t Ar type
228.Op Fl u Ar unit
229.Cm foreign preview Op Ar config
230.Nm
231.Op Fl D Ar device
232.Op Fl t Ar type
233.Op Fl u Ar unit
234.Cm foreign import Op Ar config
235.Nm
236.Op Fl D Ar device
237.Op Fl t Ar type
238.Op Fl u Ar unit
239.Cm flash Ar file
240.Nm
241.Op Fl D Ar device
242.Op Fl t Ar type
243.Op Fl u Ar unit
244.Cm start learn
245.Nm
246.Op Fl D Ar device
247.Op Fl t Ar type
248.Op Fl u Ar unit
249.Cm bbu Ar setting Ar value
250.Nm
251.Op Fl D Ar device
252.Op Fl t Ar type
253.Op Fl u Ar unit
254.Cm ctrlprop Ar rebuild Op Ar rate
255.Nm
256.Op Fl D Ar device
257.Op Fl t Ar type
258.Op Fl u Ar unit
259.Cm ctrlprop Ar alarm Op Ar 0/1
260.Sh DESCRIPTION
261The
262.Nm
263utility can be used to display or modify various parameters on LSI
264MegaRAID SAS RAID controllers.
265Each invocation of
266.Nm
267consists of zero or more global options followed by a command.
268Commands may support additional optional or required arguments after the
269command.
270.Pp
271Currently three global options are supported:
272.Bl -tag -width indent
273.It Fl D Ar device
274.Ar device
275specifies the device node of the controller to use.
276'/dev/' will be added to the device node if needed.
277If no device node is specified,
278then device will be made of the type and device.
279.It Fl t Ar type
280.Ar type
281specifies the type of the controller to work with either
282.Xr mfi 4
283or
284.Xr mrsas 4 .
285If no type is specified,
286then the name of the invoked tool used to derive the type.
287.It Fl u Ar unit
288.Ar unit
289specifies the unit of the controller to work with.
290If no unit is specified,
291then unit 0 is used.
292.El
293.Pp
294Various commands accept either or both of the two options:
295.Bl -tag -width indent
296.It Fl d
297Print numeric device IDs as drive identifier.
298This is the default.
299Useful in combination with
300.Fl e
301to print both, numeric device IDs and enclosure:slot information.
302.It Fl e
303Print drive identifiers in enclosure:slot form.
304See next paragraph on format details in context of input rather than
305output.
306.El
307.Pp
308Drives may be specified in two forms.
309First,
310a drive may be identified by its device ID.
311The device ID for configured drives can be found in
312.Cm show config .
313Second,
314a drive may be identified by its location as
315.Sm off
316.Op E Ar xx Ns \&:
317.Li S Ns Ar yy
318.Sm on
319where
320.Ar xx
321is the enclosure
322and
323.Ar yy
324is the slot for each drive as displayed in
325.Cm show drives .
326.Pp
327Volumes may be specified in two forms.
328First,
329a volume may be identified by its target ID.
330Second,
331on the volume may be specified by the corresponding
332.Em mfidX
333device,
334such as
335.Em mfid0 .
336.Pp
337The
338.Nm
339utility supports several different groups of commands.
340The first group of commands provide information about the controller,
341the volumes it manages, and the drives it controls.
342The second group of commands are used to manage the physical drives
343attached to the controller.
344The third group of commands are used to manage the logical volumes
345managed by the controller.
346The fourth group of commands are used to manage the drive configuration for
347the controller.
348The fifth group of commands are used to manage controller-wide operations.
349.Pp
350The informational commands include:
351.Bl -tag -width indent
352.It Cm version
353Displays the version of
354.Nm .
355.It Cm show adapter
356Displays information about the RAID controller such as the model number.
357.It Cm show battery
358Displays information about the battery from the battery backup unit.
359.It Cm show config
360Displays the volume and drive configuration for the controller.
361Each array is listed along with the physical drives the array is built from.
362Each volume is listed along with the arrays that the volume spans.
363If any hot spare drives are configured, then they are listed as well.
364.It Cm show drives
365Lists all of the physical drives attached to the controller.
366.It Xo Cm show events
367.Op Fl c Ar class
368.Op Fl l Ar locale
369.Op Fl n Ar count
370.Op Fl v
371.Op Ar start Op Ar stop
372.Xc
373Display entries from the controller's event log.
374The controller maintains a circular buffer of events.
375Each event is tagged with a class and locale.
376.Pp
377The
378.Ar class
379parameter limits the output to entries at the specified class or higher.
380The default class is
381.Dq warn .
382The available classes from lowest priority to highest are:
383.Bl -tag -width indent
384.It Cm debug
385Debug messages.
386.It Cm progress
387Periodic progress updates for long-running operations such as background
388initializations, array rebuilds, or patrol reads.
389.It Cm info
390Informational messages such as drive insertions and volume creations.
391.It Cm warn
392Indicates that some component may be close to failing.
393.It Cm crit
394A component has failed, but no data is lost.
395For example, a volume becoming degraded due to a drive failure.
396.It Cm fatal
397A component has failed resulting in data loss.
398.It Cm dead
399The controller itself has died.
400.El
401.Pp
402The
403.Ar locale
404parameter limits the output to entries for the specified part of the controller.
405The default locale is
406.Dq all .
407The available locales are
408.Dq volume ,
409.Dq drive ,
410.Dq enclosure ,
411.Dq battery ,
412.Dq sas ,
413.Dq controller ,
414.Dq config ,
415.Dq cluster ,
416and
417.Dq all .
418.Pp
419The
420.Ar count
421parameter is a debugging aid that specifies the number of events to fetch from
422the controller for each low-level request.
423The default is 15 events.
424.Pp
425By default, matching event log entries from the previous shutdown up to the
426present are displayed.
427This range can be adjusted via the
428.Ar start
429and
430.Ar stop
431parameters.
432Each of these parameters can either be specified as a log entry number or as
433one of the following aliases:
434.Bl -tag -width indent
435.It Cm newest
436The newest entry in the event log.
437.It Cm oldest
438The oldest entry in the event log.
439.It Cm clear
440The first entry since the event log was cleared.
441.It Cm shutdown
442The entry in the event log corresponding to the last time the controller was
443cleanly shut down.
444.It Cm boot
445The entry in the event log corresponding to the most recent boot.
446.El
447.It Cm show firmware
448Lists all of the firmware images present on the controller.
449.It Cm show foreign
450Displays detected foreign configurations on disks for importation or removal.
451.It Cm show logstate
452Display the various sequence numbers associated with the event log.
453.It Cm show patrol
454Display the status of the controller's patrol read operation.
455.It Cm show progress
456Report the current progress and estimated completion time for active
457operations on all volumes and drives.
458.It Cm show volumes
459Lists all of the logical volumes managed by the controller.
460.El
461.Pp
462The physical drive management commands include:
463.Bl -tag -width indent
464.It Cm fail Ar drive
465Mark
466.Ar drive
467as failed.
468.Ar Drive
469must be an online drive that is part of an array.
470.It Cm good Ar drive
471Mark
472.Ar drive
473as an unconfigured good drive.
474.Ar Drive
475must not be part of an existing array.
476.It Cm rebuild Ar drive
477Mark a failed
478.Ar drive
479that is still part of an array as a good drive suitable for a rebuild.
480The firmware should kick off an array rebuild on its own if a failed drive
481is marked as a rebuild drive.
482.It Cm syspd Ar drive
483Present the drive to the host operating system as a disk SYSPD block device in
484the format /dev/mfisyspdX.
485Clear this flag with
486.Cm good
487.Ar drive
488.It Cm drive progress Ar drive
489Report the current progress and estimated completion time of drive operations
490such as rebuilds or patrol reads.
491.It Cm drive clear Ar drive Brq "start | stop"
492Start or stop the writing of all 0x00 characters to a drive.
493.It Cm start rebuild Ar drive
494Manually start a rebuild on
495.Ar drive .
496.It Cm abort rebuild Ar drive
497Abort an in-progress rebuild operation on
498.Ar drive .
499It can be resumed with the
500.Cm start rebuild
501command.
502.It Cm locate Ar drive Brq "on | off"
503Change the state of the external LED associated with
504.Ar drive .
505.El
506.Pp
507The logical volume management commands include:
508.Bl -tag -width indent
509.It Cm cache Ar volume Op Ar setting Oo Ar value Oc Op ...
510If no
511.Ar setting
512arguments are supplied, then the current cache policy for
513.Ar volume
514is displayed;
515otherwise,
516the cache policy for
517.Ar volume
518is modified.
519One or more
520.Ar setting
521arguments may be given.
522Some settings take an additional
523.Ar value
524argument as noted below.
525The valid settings are:
526.Bl -tag -width indent
527.It Cm enable
528Enable caching for both read and write I/O operations.
529.It Cm disable
530Disable caching for both read and write I/O operations.
531.It Cm reads
532Enable caching only for read I/O operations.
533.It Cm writes
534Enable caching only for write I/O operations.
535.It Cm write-back
536Use write-back policy for cached writes.
537.It Cm write-through
538Use write-through policy for cached writes.
539.It Cm read-ahead Ar value
540Set the read ahead policy for cached reads.
541The
542.Ar value
543argument can be set to either
544.Dq none ,
545.Dq adaptive ,
546or
547.Dq always .
548.It Cm bad-bbu-write-cache Ar value
549Control the behavior of I/O write caching if the battery is dead or
550missing.
551The
552.Ar value
553argument can be set to either
554.Dq disable
555or
556.Dq enable .
557In general this setting should be left disabled to avoid data loss when
558the system loses power.
559.It Cm write-cache Ar value
560Control the write caches on the physical drives backing
561.Ar volume .
562The
563.Ar value
564argument can be set to either
565.Dq disable ,
566.Dq enable ,
567or
568.Dq default .
569.Pp
570In general this setting should be left disabled to avoid data loss when the
571physical drives lose power.
572The battery backup of the RAID controller does not save data in the write
573caches of the physical drives.
574.El
575.It Cm name Ar volume Ar name
576Sets the name of
577.Ar volume
578to
579.Ar name .
580.It Cm volume progress Ar volume
581Report the current progress and estimated completion time of volume operations
582such as consistency checks and initializations.
583.El
584.Pp
585The configuration commands include:
586.Bl -tag -width indent
587.It Cm clear
588Delete the entire configuration including all volumes, arrays, and spares.
589.It Xo Cm create Ar type
590.Op Fl v
591.Op Fl s Ar stripe_size
592.Ar drive Ns Op \&, Ns Ar drive Ns Op ",..."
593.Op Ar drive Ns Op \&, Ns Ar drive Ns Op ",..."
594.Xc
595Create a new volume.
596The
597.Ar type
598specifies the type of volume to create.
599Currently supported types include:
600.Bl -tag -width indent
601.It Cm jbod
602Creates a RAID0 volume for each drive specified.
603Each drive must be specified as a separate argument.
604.It Cm raid0
605Creates one RAID0 volume spanning the drives listed in the single drive list.
606.It Cm raid1
607Creates one RAID1 volume spanning the drives listed in the single drive list.
608.It Cm raid5
609Creates one RAID5 volume spanning the drives listed in the single drive list.
610.It Cm raid6
611Creates one RAID6 volume spanning the drives listed in the single drive list.
612.It Cm raid10
613Creates one RAID10 volume spanning multiple RAID1 arrays.
614The drives for each RAID1 array are specified as a single drive list.
615.It Cm raid50
616Creates one RAID50 volume spanning multiple RAID5 arrays.
617The drives for each RAID5 array are specified as a single drive list.
618.It Cm raid60
619Creates one RAID60 volume spanning multiple RAID6 arrays.
620The drives for each RAID6 array are specified as a single drive list.
621.It Cm concat
622Creates a single volume by concatenating all of the drives in the single drive
623list.
624.El
625.Pp
626.Sy Note :
627Not all volume types are supported by all controllers.
628.Pp
629If the
630.Fl v
631flag is specified after
632.Ar type ,
633then more verbose output will be enabled.
634Currently this just provides notification as drives are added to arrays and
635arrays to volumes when building the configuration.
636.Pp
637The
638.Fl s
639.Ar stripe_size
640parameter allows the stripe size of the array to be set.
641By default a stripe size of 64K is used.
642Valid values are 512 through 1M, though the MFI firmware may reject some
643values.
644.It Cm delete Ar volume
645Delete the volume
646.Ar volume .
647.It Cm add Ar drive Op Ar volume
648Mark
649.Ar drive
650as a hot spare.
651.Ar Drive
652must be in the unconfigured good state.
653If
654.Ar volume
655is specified,
656then the hot spare will be dedicated to arrays backing that volume.
657Otherwise,
658.Ar drive
659will be used as a global hot spare backing all arrays for this controller.
660Note that
661.Ar drive
662must be as large as the smallest drive in all of the arrays it is going to
663back.
664.It Cm remove Ar drive
665Remove the hot spare
666.Ar drive
667from service.
668It will be placed in the unconfigured good state.
669.El
670.Pp
671The controller management commands include:
672.Bl -tag -width indent
673.It Cm patrol Ar command Op Ar interval Op Ar start
674Set the patrol read operation mode.
675The
676.Ar command
677argument can be one of the following values:
678.Bl -tag -width indent
679.It Cm disable
680Disable patrol reads.
681.It Cm auto
682Enable periodic patrol reads initiated by the firmware.
683The optional
684.Ar interval
685argument specifies the interval in seconds between patrol reads.
686If patrol reads should be run continuously,
687then
688.Ar interval
689should consist of the word
690.Dq continuously .
691The optional
692.Ar start
693argument specifies a non-negative, relative start time for the next patrol read.
694If an interval or start time is not specified,
695then the existing setting will be used.
696.It Cm manual
697Enable manual patrol reads that are only initiated by the user.
698.El
699.It Cm start patrol
700Start a patrol read operation.
701.It Cm stop patrol
702Stop a currently running patrol read operation.
703.It Cm foreign scan
704Scan for foreign configurations and display the number found.
705The
706.Ar config
707argument for the commands below takes the form of a number from 0 to the total
708configurations found.
709.It Cm foreign clear Op config
710Clear the specified foreign
711.Ar config
712or all if no
713.Ar config
714argument is provided.
715.It Cm foreign diag Op config
716Display a diagnostic display of the specified foreign
717.Ar config
718or all if no
719.Ar config
720argument is provided.
721.It Cm foreign preview Op config
722Preview the specified foreign
723.Ar config
724after import or all if no
725.Ar config
726argument is provided.
727.It Cm foreign import Op config
728Import the specified foreign
729.Ar config
730or all if no
731.Ar config
732argument is provided.
733.It Cm flash Ar file
734Updates the flash on the controller with the firmware stored in
735.Ar file .
736A reboot is required for the new firmware to take effect.
737.It Cm start learn
738Start a battery relearn.
739Note that this seems to always result in the battery being completely drained,
740regardless of the BBU mode.
741In particular, the controller write cache will be disabled during the relearn
742even if transparent learning mode is enabled.
743.It Cm bbu Ar setting Ar value
744Update battery backup unit (BBU) properties related to battery relearning.
745The following settings are configurable:
746.Bl -tag -width indent
747.It Cm learn-delay
748Add a delay to the next scheduled battery relearn event.
749This setting is given in hours and must lie in the range of 0 to 255.
750.It Cm autolearn-mode
751Enable or disable automatic periodic battery relearning.
752The setting may be set to
753.Dq enable
754or
755.Dq disable
756to respectively enable or disable the relearn cycle.
757Alternatively, a mode of 0, 1 or 2 may be given.
758Mode 0 enables periodic relearning, mode 1 disables it, and mode 2 disables
759it and logs a warning to the event log when it detects that a battery relearn
760should be performed.
761.It Cm bbu-mode
762Set the BBU's mode of operation.
763This setting is not supported by all BBUs.
764Where it is supported, the possible values are the integers between 1 and 5
765inclusive.
766Modes 1, 2 and 3 enable a transparent learn cycle, whereas modes 4 and 5 do not.
767The BBU's data retention time is greater when transparent learning is not used.
768.El
769.It Cm ctrlprop Ar rebuild Op Ar rate
770With no arguments display the rate of rebuild (percentage)a for volumes.
771With an integer argument (0-100), set that value as the new rebuild rate for volumes.
772.It Cm ctrlprop Ar alarm Op Ar 0/1
773With no arguments display the current alarm enable/disable status.
774With a 0, disable alarms.
775With a 1, enable alarms.
776.El
777.Sh EXAMPLES
778Configure the cache for volume mfid0 to cache only writes:
779.Pp
780.Dl Nm Cm cache mfid0 writes
781.Dl Nm Cm cache mfid0 write-back
782.Pp
783Create a RAID5 array spanning the first four disks in the second enclosure:
784.Pp
785.Dl Nm Cm create raid5 e1:s0,e1:s1,e1:s2,e1:s4
786.Pp
787Configure the first three disks on a controller as JBOD:
788.Pp
789.Dl Nm Cm create jbod 0 1 2
790.Pp
791Create a RAID10 volume that spans two arrays each of which contains two disks
792from two different enclosures:
793.Pp
794.Dl Nm Cm create raid10 e1:s0,e1:s1 e2:s0,e2:s1
795.Pp
796Add drive with the device ID of 4 as a global hot spare:
797.Pp
798.Dl Nm Cm add 4
799.Pp
800Add the drive in slot 2 in the main chassis as a hot spare for volume mfid0:
801.Pp
802.Dl Nm Cm add s2 mfid0
803.Pp
804Reconfigure a disk as a SYSPD block device with no RAID
805.Pp
806.Dl Nm Cm syspd 0
807.Pp
808Configure the adapter to run periodic patrol reads once a week with the first
809patrol read starting in 5 minutes:
810.Pp
811.Dl Nm Cm patrol auto 604800 300
812.Pp
813Display the second detected foreign configuration:
814.Pp
815.Dl Nm Cm show foreign 1
816.Pp
817Set the current rebuild rate for volumes to 40%:
818.Dl Nm Cm ctrlprop rebuild 40
819.Sh SEE ALSO
820.Xr mfi 4 ,
821.Xr mrsas 4
822.Sh HISTORY
823The
824.Nm
825utility first appeared in
826.Fx 8.0 .
827