usr/src/man/man1m/raidctl.1m

   1 '\" te
   2 .\" Copyright (c) 2007, Sun Microsystems, Inc. All Rights Reserved.
   3 .\" The contents of this file are subject to the terms of the Common Development and Distribution License (the "License").  You may not use this file except in compliance with the License.
   4 .\" You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE or http://www.opensolaris.org/os/licensing.  See the License for the specific language governing permissions and limitations under the License.
   5 .\" When distributing Covered Code, include this CDDL HEADER in each file and include the License file at usr/src/OPENSOLARIS.LICENSE.  If applicable, add the following below this CDDL HEADER, with the fields enclosed by brackets "[]" replaced with your own identifying information: Portions Copyright [yyyy] [name of copyright owner]
   6 .TH RAIDCTL 1M "Feb 5, 2009"
   7 .SH NAME
   8 raidctl \- RAID hardware utility
   9 .SH SYNOPSIS
  10 .LP
  11 .nf
  12 \fBraidctl\fR \fB-C\fR \fI"disks"\fR [\fB-r\fR \fIraid_level\fR] [\fB-z\fR \fIcapacity\fR] [\fB-s\fR \fIstripe_size\fR] [\fB-f\fR]
  13      controller
  14 .fi
  15
  16 .LP
  17 .nf
  18 \fBraidctl\fR \fB-d\fR [\fB-f\fR] \fIvolume\fR
  19 .fi
  20
  21 .LP
  22 .nf
  23 \fBraidctl\fR \fB-F\fR \fIfilename\fR [\fB-f\fR] \fIcontroller\fR\&.\|.\|.
  24 .fi
  25
  26 .LP
  27 .nf
  28 \fBraidctl\fR \fB-a\fR {\fBset\fR | \fBunset\fR} \fB-g\fR \fIdisk\fR {\fBvolume\fR | \fBcontroller\fR}
  29 .fi
  30
  31 .LP
  32 .nf
  33 \fBraidctl\fR \fB-p\fR \fI"param=value"\fR [\fB-f\fR] \fIvolume\fR
  34 .fi
  35
  36 .LP
  37 .nf
  38 \fBraidctl\fR \fB-c\fR [\fB-f\fR] [\fB-r\fR \fIraid_level\fR] \fIdisk1\fR \fIdisk2\fR [\fIdisk3\fR...]
  39 .fi
  40
  41 .LP
  42 .nf
  43 \fBraidctl\fR \fB-l\fR -g \fIdisk controller\fR
  44 .fi
  45
  46 .LP
  47 .nf
  48 \fBraidctl\fR \fB-l\fR \fIvolume\fR
  49 .fi
  50
  51 .LP
  52 .nf
  53 \fBraidctl\fR \fB-l\fR \fIcontroller\fR\&.\|.\|.
  54 .fi
  55
  56 .LP
  57 .nf
  58 \fBraidctl\fR [\fB-l\fR]
  59 .fi
  60
  61 .LP
  62 .nf
  63 \fBraidctl\fR \fB-S\fR [\fBvolume\fR | \fBcontroller\fR]
  64 .fi
  65
  66 .LP
  67 .nf
  68 \fBraidctl\fR \fB-S\fR -g \fIdisk controller\fR
  69 .fi
  70
  71 .LP
  72 .nf
  73 \fBraidctl\fR \fB-h\fR
  74 .fi
  75
  76 .SH DESCRIPTION
  77 .sp
  78 .LP
  79 The \fBraidctl\fR utility is a hardware RAID configuration tool that supports
  80 different RAID controllers by providing a CLI (command-line interface) to
  81 end-users to create, delete or display RAID volume(s). The utility can also
  82 used to set properties of a volume, assign hot-spare (HSP) disks to volumes or
  83 controllers, and to update firmware/fcode/BIOS for RAID controllers.
  84 .sp
  85 .LP
  86 The \fBraidctl\fR utility requires privileges that are controlled by the
  87 underlying file-system permissions. Only privileged users can manipulate the
  88 RAID system configuration. If a non-privileged user attempts to run
  89 \fBraidctl\fR, the command fails with an exit status of 1.
  90 .sp
  91 .LP
  92 The \fBraidctl\fR utility, as described in this man page, defines a broad set
  93 of command line options to provide  management for full-featured RAID
  94 controllers. However, support for a given option depends on two elements:
  95 .RS +4
  96 .TP
  97 .ie t \(bu
  98 .el o
  99 the presence of a software driver
 100 .RE
 101 .RS +4
 102 .TP
 103 .ie t \(bu
 104 .el o
 105 the firmware level of the RAID device
 106 .RE
 107 .sp
 108 .LP
 109 The dependency on a software driver is due to the design of \fBraidctl\fR. The
 110 utility is built on a common library that enables the insertion of plug-in
 111 modules for different drivers. Currently, the Solaris operating system is
 112 shipped with a plug-in for the \fBmpt\fR driver. This plug-in does not support
 113 all of the \fBraidctl\fR options. On a given storage device, options might be
 114 further limited by the device's firmware level.
 115 .sp
 116 .LP
 117 The level of support for the various \fBraidctl\fR options cannot be determined
 118 by \fBraidctl\fR. The user must rely on the documentation for his RAID
 119 controller or hardware platform.
 120 .sp
 121 .LP
 122 Currently, \fBraidctl\fR Currently, \fBraidctl\fR provides some level of
 123 support for the following RAID controllers:
 124 .RS +4
 125 .TP
 126 .ie t \(bu
 127 .el o
 128 LSI1020 SCSI HBA
 129 .RE
 130 .RS +4
 131 .TP
 132 .ie t \(bu
 133 .el o
 134 LSI1030 SCSI HBA
 135 .RE
 136 .RS +4
 137 .TP
 138 .ie t \(bu
 139 .el o
 140 LSI1064 SAS HBA
 141 .RE
 142 .RS +4
 143 .TP
 144 .ie t \(bu
 145 .el o
 146 LSI1068 SAS HBA
 147 .RE
 148 .sp
 149 .LP
 150 All of the above HBAs are maintained by the \fBmpt\fR driver, on X86-32/64 and
 151 SPARC platforms.
 152 .SH OPTIONS
 153 .sp
 154 .LP
 155 The following options are supported:
 156 .sp
 157 .ne 2
 158 .na
 159 \fB\fB-C\fR \fI"disks"\fR [\fB-r\fR \fIraid_level\fR] [\fB-z\fR \fIcapacity\fR]
 160 [\fB-s\fR \fIstripe_size\fR] [\fB-f\fR] controller\fR
 161 .ad
 162 .sp .6
 163 .RS 4n
 164 Create a RAID volume using specified disks.
 165 .sp
 166 When creating a RAID volume using this option, the identity of the newly
 167 created volume is automatically generated and raidctl reports it to the user.
 168 .sp
 169 The argument specified by this option contains the elements used to form the
 170 volume that will be created. Elements can be either disks or sub-volumes, where
 171 disks are separated by space(s) and a sub-volume is a set of disks grouped by
 172 parenthesis. All disks should be in \fBC.ID.L\fR expression (for example,
 173 \fB0.1.2\fR represents a physical disk of channel 0, target id 1, and logical
 174 unit number 2). The argument must match the RAID level specified by the
 175 \fB-r\fR option, even if it's omitted. This means the argument can only be:
 176 .sp
 177 .ne 2
 178 .na
 179 \fBfor RAID 0\fR
 180 .ad
 181 .sp .6
 182 .RS 4n
 183 At least 2 disks
 184 .RE
 185
 186 .sp
 187 .ne 2
 188 .na
 189 \fBfor RAID 1\fR
 190 .ad
 191 .sp .6
 192 .RS 4n
 193 Only 2 disks
 194 .RE
 195
 196 .sp
 197 .ne 2
 198 .na
 199 \fBfor RAID 1E\fR
 200 .ad
 201 .sp .6
 202 .RS 4n
 203 At least 3 disks
 204 .RE
 205
 206 .sp
 207 .ne 2
 208 .na
 209 \fBfor RAID 5\fR
 210 .ad
 211 .sp .6
 212 .RS 4n
 213 At least 3 disks
 214 .RE
 215
 216 .sp
 217 .ne 2
 218 .na
 219 \fBfor RAID 10\fR
 220 .ad
 221 .sp .6
 222 .RS 4n
 223 At least 2 sub-volumes, each sub-volume must be formed by 2 disks
 224 .RE
 225
 226 .sp
 227 .ne 2
 228 .na
 229 \fBfor RAID 50\fR
 230 .ad
 231 .sp .6
 232 .RS 4n
 233 At least 2 sub-volumes, each sub-volume must be formed by at least 3 disks, and
 234 the disk amount in each sub-volume should be the same
 235 .RE
 236
 237 For example, the expression "0.0.0 0.1.0" means that the 2 specified disks form
 238 a RAID volume, which can either be a RAID 0 or a RAID 1 volume. "(0.0.0
 239 0.1.0)(0.2.0 0.3.0)" means that the first 2 disks and the last 2 disks form 2
 240 sub-volumes, and that these 2 sub-volumes form a RAID 10 volume. See the
 241 \fBEXAMPLES\fR section for more samples.
 242 .sp
 243 The \fB-r\fR option specifies the RAID level of the volume that will be
 244 created. Possible levels are 0, 1, 1E, 5, 10, 50. If this option is omitted,
 245 \fBraidctl\fR creates a RAID 1 volume by default.
 246 .sp
 247 The \fB-z\fR option specifies the capacity of the volume that will be created.
 248 The unit can be tera-bytes, giga-bytes, or mega-bytes (for example, 2t, 10g,
 249 20m, and so on). If this option is omitted, \fBraidctl\fR calculates the
 250 maximum capacity of the volume that can be created by the specified disks and
 251 uses this value to create the volume.
 252 .sp
 253 The \fB-s\fR option specifies the stripe size of the volume that will be
 254 created. The possible values are 512, 1k, 2k, 4k, 8k, 16k, 32k, 64k, or 128k.
 255 If this option is omitted, \fBraidctl\fR chooses an appropriate value for the
 256 volume (for example, 64k).
 257 .sp
 258 In some cases, the creation of a RAID volume may cause data on specified disks
 259 to be lost (for instance, on LSI1020, LSI1030, SAS1064, or SAS1068 HBAs), and
 260 \fBraidctl\fR prompts the user for confirmation about the creation. Use the
 261 \fB-f\fR option to force the volume creation without prompting the user for
 262 confirmation.
 263 .sp
 264 The controller argument is used to identify which RAID controller the specified
 265 disks belongs. The \fB-l\fR option can be used to list the controller's ID
 266 number.
 267 .RE
 268
 269 .sp
 270 .ne 2
 271 .na
 272 \fB\fB-d\fR [\fB-f\fR] \fIvolume\fR\fR
 273 .ad
 274 .sp .6
 275 .RS 4n
 276 Delete the RAID volume specified as volume. The volume is specified in
 277 canonical form (for example, \fBc0t0d0\fR).
 278 .sp
 279 When a volume is deleted, all data is lost. Therefore, unless the \fB-f\fR
 280 option is specified, \fBraidctl\fR prompts the user for confirmation before
 281 deleting the volume.
 282 .sp
 283 When a RAID 1 volume is deleted from a LSI1020, LSI1030, SAS1064, or SAS1068
 284 HBA, the primary and secondary disks are "split". If the volume was in
 285 \fBSYNCING\fR state, the primary will contain the data, and the secondary will
 286 not. If the volume state was \fBOPTIMAL\fR, both disks will contain a complete
 287 image of the data.
 288 .RE
 289
 290 .sp
 291 .ne 2
 292 .na
 293 \fB\fB-F\fR \fIfilename\fR [\fB-f\fR] \fIcontroller\fR\&.\|.\|.\fR
 294 .ad
 295 .sp .6
 296 .RS 4n
 297 Update the firmware running on the specified controller(s). The \fBraidctl\fR
 298 utility prompts the user for confirmation of this action, unless the \fB-f\fR
 299 option is provided.
 300 .RE
 301
 302 .sp
 303 .ne 2
 304 .na
 305 \fB\fB-a\fR {\fBset\fR | \fBunset\fR} \fB-g\fR \fIdisk\fR {\fBvolume\fR |
 306 \fBcontroller\fR}\fR
 307 .ad
 308 .sp .6
 309 .RS 4n
 310 If the volume is specified, \fBraidctl\fR sets or unsets the disk as a local
 311 hot-spare disk dedicated to the volume, depending on the value specified by the
 312 \fB-a\fR option. If the controller is specified, \fBraidctl\fR sets or unsets
 313 the disk as a global hot-spare disk.
 314 .RE
 315
 316 .sp
 317 .ne 2
 318 .na
 319 \fB\fB-p\fR \fI"param=value"\fR [\fB-f\fR] \fIvolume\fR\fR
 320 .ad
 321 .sp .6
 322 .RS 4n
 323 Change the property value for a given RAID volume. This option can be used to
 324 change cache write policy or to activate a volume. When changing the cache
 325 write policy, \fIparam\fR should be the string \fBwp\fR (\fBSET_WR_POLICY\fR),
 326 and \fIvalue\fR can be either \fBon\fR or \fBoff\fR. When used to activate a
 327 volume, \fIparam\fR should be \fBstate\fR and \fIvalue\fR should be
 328 \fBactivate\fR.
 329 .sp
 330 Changing a RAID volume's property may affect the internal behavior of the RAID
 331 controller, so \fBraidctl\fR prompts the user for a confirmation before
 332 applying the change, unless the \fB-f\fR option is specified.
 333 .RE
 334
 335 .sp
 336 .ne 2
 337 .na
 338 \fB\fB-c\fR [\fB-f\fR] [\fB-r\fR \fIraid_level\fR] \fIdisk1\fR \fIdisk2\fR
 339 [\fIdisk3\fR...]\fR
 340 .ad
 341 .sp .6
 342 .RS 4n
 343 Create a volume using the specified disks. This is an alternative to the
 344 \fB-C\fR option with similar functionality. This option is preserved for
 345 compatibility reasons, but only works with LSI1020, LSI1030, SAS1064, and
 346 SAS1068 HBAs to create RAID 0, RAID 1, or RAID 1E volumes. For other HBAs, the
 347 user can only use the \fB-C\fR option.
 348 .sp
 349 The \fB-r\fR option can be used to specify the RAID level of the target volume.
 350 If the \fB-r\fR option is omitted, \fBraidctl\fR will create a RAID 1 volume.
 351 .sp
 352 Disks must be specified in Solaris canonical format (for example, c0t0d0).
 353 .sp
 354 Creating a RAID 1 volume with this option replaces the contents of disk2 with
 355 the contents of disk1.
 356 .sp
 357 When the user creates a RAID volume with this option, the RAID volume assumes
 358 the identity of disk1. Other disks become invisible and the RAID volume appears
 359 as one disk.
 360 .sp
 361 Creating a volume with this option is by default interactive. The user must
 362 answer a prompt affirmatively to create the volume. Use the \fB-f\fR option to
 363 force the volume creation without prompting the user for confirmation.
 364 .RE
 365
 366 .sp
 367 .ne 2
 368 .na
 369 \fB\fB-l\fR -g \fIdisk controller\fR\fR
 370 .ad
 371 .sp .6
 372 .RS 4n
 373 Display information about the specified disk of the given controller. The
 374 output includes the following information:
 375 .sp
 376 .ne 2
 377 .na
 378 \fBDisk\fR
 379 .ad
 380 .sp .6
 381 .RS 4n
 382 Displays the disk in \fBC.ID.L\fR expression disk.
 383 .RE
 384
 385 .sp
 386 .ne 2
 387 .na
 388 \fBVendor\fR
 389 .ad
 390 .sp .6
 391 .RS 4n
 392 Displays the vendor ID string.
 393 .RE
 394
 395 .sp
 396 .ne 2
 397 .na
 398 \fBProduct\fR
 399 .ad
 400 .sp .6
 401 .RS 4n
 402 Displays the product ID string.
 403 .RE
 404
 405 .sp
 406 .ne 2
 407 .na
 408 \fBCapacity\fR
 409 .ad
 410 .sp .6
 411 .RS 4n
 412 Displays the total capacity of the disk.
 413 .RE
 414
 415 .sp
 416 .ne 2
 417 .na
 418 \fBStatus\fR
 419 .ad
 420 .sp .6
 421 .RS 4n
 422 Displays the current status of disk. The status can be either "\fBGOOD\fR"
 423 (operating normally), "\fBFAILED\fR" (non-functional), or "\fBMISSING\fR" (disk
 424 not present).
 425 .RE
 426
 427 .sp
 428 .ne 2
 429 .na
 430 \fBHSP\fR
 431 .ad
 432 .sp .6
 433 .RS 4n
 434 Indicates if the disk has been set as a global hot-spare disk, local hot-spare
 435 disk, or a normal one. If it is a local hot-spare disk, all volumes which this
 436 disk is assigned to are displayed.
 437 .RE
 438
 439 .sp
 440 .ne 2
 441 .na
 442 \fBGUID\fR
 443 .ad
 444 .sp .6
 445 .RS 4n
 446 GUID string for the specified disk. This is an additional datum and might be
 447 unavailable in some cases.
 448 .RE
 449
 450 .RE
 451
 452 .sp
 453 .ne 2
 454 .na
 455 \fB\fB-l\fR \fIvolume\fR\fR
 456 .ad
 457 .sp .6
 458 .RS 4n
 459 Display information about the specified volume. The output includes the
 460 following information:
 461 .sp
 462 .ne 2
 463 .na
 464 \fBVolume\fR
 465 .ad
 466 .sp .6
 467 .RS 4n
 468 Displays volume in canonical format.
 469 .RE
 470
 471 .sp
 472 .ne 2
 473 .na
 474 \fBSub\fR
 475 .ad
 476 .sp .6
 477 .RS 4n
 478 Displays sub-volumes, if the specified volume is of RAID 10 or RAID 50 volume.
 479 .RE
 480
 481 .sp
 482 .ne 2
 483 .na
 484 \fBDisk\fR
 485 .ad
 486 .sp .6
 487 .RS 4n
 488 Displays all disks that form the specified volume.
 489 .RE
 490
 491 .sp
 492 .ne 2
 493 .na
 494 \fBStripe Size\fR
 495 .ad
 496 .sp .6
 497 .RS 4n
 498 Displays the stripe size of the volume.
 499 .RE
 500
 501 .sp
 502 .ne 2
 503 .na
 504 \fBStatus\fR
 505 .ad
 506 .sp .6
 507 .RS 4n
 508 Displays the status of the specified volume, or the sub-volumes or disks that
 509 form the  specified  volume. For an inactive  volume, the status should  be
 510 \fBINACTIVE\fR; otherwise it can be \fBOPTIMAL\fR (operating optimally),
 511 \fBDEGRADED\fR (operating with reduced functionality), \fBFAILED\fR
 512 (non-functional), or \fBSYNC\fR (disks  are syncing). For a disk, the status
 513 can be \fBGOOD\fR, \fBFAILED\fR, or \fBMISSING\fR.
 514 .RE
 515
 516 .sp
 517 .ne 2
 518 .na
 519 \fBCache\fR
 520 .ad
 521 .sp .6
 522 .RS 4n
 523 Indicates whether the cache is applied to \fBI/O\fR write activities. The cache
 524 can be either "\fBON\fR" or "\fBOFF\fR".
 525 .RE
 526
 527 .sp
 528 .ne 2
 529 .na
 530 \fBRAID level\fR
 531 .ad
 532 .sp .6
 533 .RS 4n
 534 Displays the RAID level. The RAID level can be either 0, 1, 1E, 5, 10, or 50.
 535 .RE
 536
 537 .RE
 538
 539 .sp
 540 .ne 2
 541 .na
 542 \fB\fB-l\fR \fIcontroller ...\fR\fR
 543 .ad
 544 .sp .6
 545 .RS 4n
 546 Display information about the specified controller(s). The output includes the
 547 following information:
 548 .sp
 549 .ne 2
 550 .na
 551 \fBController\fR
 552 .ad
 553 .sp .6
 554 .RS 4n
 555 Displays the RAID controller's ID number.
 556 .RE
 557
 558 .sp
 559 .ne 2
 560 .na
 561 \fBType\fR
 562 .ad
 563 .sp .6
 564 .RS 4n
 565 Displays the RAID controller's product type.
 566 .RE
 567
 568 .sp
 569 .ne 2
 570 .na
 571 \fBfw_version\fR
 572 .ad
 573 .sp .6
 574 .RS 4n
 575 Displays the controller's firmware version.
 576 .RE
 577
 578 .RE
 579
 580 .sp
 581 .ne 2
 582 .na
 583 \fB[\fB-l\fR]\fR
 584 .ad
 585 .sp .6
 586 .RS 4n
 587 List all RAID related objects that the \fBraidctl\fR utility can manipulate,
 588 including all available RAID controllers, RAID volumes, and physical disks. The
 589 \fB-l\fR option can be omitted.
 590 .sp
 591 The output includes the following information:
 592 .sp
 593 .ne 2
 594 .na
 595 \fBController\fR
 596 .ad
 597 .sp .6
 598 .RS 4n
 599 Displays the RAID controller's ID number.
 600 .RE
 601
 602 .sp
 603 .ne 2
 604 .na
 605 \fBVolume\fR
 606 .ad
 607 .sp .6
 608 .RS 4n
 609 Displays the logical RAID volume name.
 610 .RE
 611
 612 .sp
 613 .ne 2
 614 .na
 615 \fBDisk\fR
 616 .ad
 617 .sp .6
 618 .RS 4n
 619 Displays the RAID disk in \fBC.ID.L\fR expression.
 620 .RE
 621
 622 .RE
 623
 624 .sp
 625 .ne 2
 626 .na
 627 \fB\fB-S\fR [\fBvolume\fR | \fBcontroller\fR]\fR
 628 .ad
 629 .sp .6
 630 .RS 4n
 631 Takes a snapshot of the RAID configuration information including all available
 632 RAID devices, RAID controllers, volumes, and disks.
 633 .sp
 634 Each line of the output specifies a RAID device and its related information,
 635 separated by space(s). All volumes and disks belong to the last specified
 636 controller.
 637 .sp
 638 The output lists the following information:
 639 .sp
 640 .ne 2
 641 .na
 642 \fBController\fR
 643 .ad
 644 .sp .6
 645 .RS 4n
 646 Displays the controller ID number, and the controller type string in
 647 double-quotation marks.
 648 .RE
 649
 650 .sp
 651 .ne 2
 652 .na
 653 \fBVolume\fR
 654 .ad
 655 .sp .6
 656 .RS 4n
 657 Displays the RAID volume name, number of component disks, the \fBC.ID.L\fR
 658 expression of the component disks, the RAID level, and the status. The status
 659 can be either \fBOPTIMAL\fR, \fBDEGRADED\fR, \fBFAILED\fR, or \fBSYNCING\fR.
 660 .RE
 661
 662 .sp
 663 .ne 2
 664 .na
 665 \fBDisk\fR
 666 .ad
 667 .sp .6
 668 .RS 4n
 669 Displays the \fBC.ID.L\fR expression of the disk, and the status. The status
 670 can be either \fBGOOD\fR, \fBFAILED\fR, or \fBHSP\fR (disk has been set as a
 671 stand-by disk).
 672 .RE
 673
 674 If a volume or a controller is specified, a snapshot is only taken of the
 675 information for the specified volume or controller.
 676 .RE
 677
 678 .sp
 679 .ne 2
 680 .na
 681 \fB\fB-S\fR -g \fIdisk controller\fR\fR
 682 .ad
 683 .sp .6
 684 .RS 4n
 685 Takes a snapshot of the information for the specified disk.
 686 .RE
 687
 688 .sp
 689 .ne 2
 690 .na
 691 \fB\fB-h\fR\fR
 692 .ad
 693 .sp .6
 694 .RS 4n
 695 Print out the usage string.
 696 .RE
 697
 698 .SH EXAMPLES
 699 .LP
 700 \fBExample 1 \fRCreating the RAID Configuration
 701 .sp
 702 .LP
 703 The following command creates a RAID 0 volume of 10G on controller 0, and the
 704 stripe size will be set to 64k:
 705
 706 .sp
 707 .in +2
 708 .nf
 709 # \fBraidctl -C "0.0.0 0.2.0" -r 0 -z 10g -s 64k 0\fR
 710 .fi
 711 .in -2
 712 .sp
 713
 714 .sp
 715 .LP
 716 The following command creates a RAID 1 volume on controller 2:
 717
 718 .sp
 719 .in +2
 720 .nf
 721 # \fBraidctl -C "0.0.0 1.1.0" -r 1 2\fR
 722 .fi
 723 .in -2
 724 .sp
 725
 726 .sp
 727 .LP
 728 The following command creates a RAID 5 volume on controller 2:
 729
 730 .sp
 731 .in +2
 732 .nf
 733 # \fBraidctl -C "0.0.0 0.1.0 0.2.0" -r 5 2\fR
 734 .fi
 735 .in -2
 736 .sp
 737
 738 .sp
 739 .LP
 740 The following command creates a RAID 10 volume on controller 0:
 741
 742 .sp
 743 .in +2
 744 .nf
 745 # \fBraidctl -C "(0.0.0 0.1.0)(0.2.0 0.3.0)" -r 10 0\fR
 746 .fi
 747 .in -2
 748 .sp
 749
 750 .sp
 751 .LP
 752 The following command creates a RAID 50 volume on controller 0:
 753
 754 .sp
 755 .in +2
 756 .nf
 757 # \fBraidctl -C "(0.0.0 0.1.0 0.2.0)(0.3.0 0.4.0 0.5.0)" -r 50 0\fR
 758 .fi
 759 .in -2
 760 .sp
 761
 762 .LP
 763 \fBExample 2 \fRDisplaying the RAID Configuration
 764 .sp
 765 .LP
 766 The following command displays all available controllers, volumes, and disks:
 767
 768 .sp
 769 .in +2
 770 .nf
 771 # \fBraidctl -l\fR
 772
 773 Controller: 0
 774 Controller: 2
 775          Volume:c2t0d0
 776          Disk: 0.0.0
 777          Disk: 0.1.0
 778          Disk: 0.2.0
 779          Disk: 0.3.0(HSP)
 780 .fi
 781 .in -2
 782 .sp
 783
 784 .sp
 785 .LP
 786 The following command displays information about controller 2:
 787
 788 .sp
 789 .in +2
 790 .nf
 791 # \fBraidctl -l 2\fR
 792
 793 Controller      Type            Fw_version
 794 --------------------------------------------------------------
 795 c2              LSI 1030        1.03.39.00
 796 .fi
 797 .in -2
 798 .sp
 799
 800 .sp
 801 .LP
 802 The following command displays information about the specified volume:
 803 .sp
 804 .in +2
 805 .nf
 806 # \fBraidctl -l c2t0d0\fR
 807
 808 Volume                  Size    Stripe  Status  Cache   RAID
 809          Sub                     Size                    Level
 810                 Disk
 811 --------------------------------------------------------------
 812 c2t0d0                 10240M  64K     OPTIMAL ON      RAID5
 813                 0.0.0   5120M           GOOD
 814                 0.1.0   5120M           GOOD
 815                 0.2.0   5120M           GOOD
 816 .fi
 817 .in -2
 818 .sp
 819
 820 .sp
 821 .LP
 822 The following command displays information about disk 0.0.0 on controller 0:
 823 .sp
 824 .in +2
 825 .nf
 826 # \fBraidctl -l -g 0.0.0  0\fR
 827
 828 Disk    Vendor  Product         Firmware Capacity        Status  HSP
 829 --------------------------------------------------------------------
 830 0.0.0   HITACHI H101473SCSUN72G SQ02     68.3G           GOOD    N/A
 831 GUID:2000000cca02536c
 832 .fi
 833 .in -2
 834 .sp
 835
 836 .LP
 837 \fBExample 3 \fRDeleting the RAID Configuration
 838 .sp
 839 .LP
 840 The following command deletes a volume:
 841
 842 .sp
 843 .in +2
 844 .nf
 845 # \fBraidctl -d c0t0d0\fR
 846 .fi
 847 .in -2
 848 .sp
 849
 850 .LP
 851 \fBExample 4 \fRUpdating Flash Images on the Controller
 852 .sp
 853 .LP
 854 The following command updates flash images on the controller 0:
 855
 856 .sp
 857 .in +2
 858 .nf
 859 # \fBraidctl -F lsi_image.fw 0\fR
 860 .fi
 861 .in -2
 862 .sp
 863
 864 .LP
 865 \fBExample 5 \fRSetting or Unsetting a Hot-Spare Disk
 866 .sp
 867 .LP
 868 The following command sets disk 0.3.0 on controller 2 as a global hot-spare
 869 disk:
 870
 871 .sp
 872 .in +2
 873 .nf
 874 # \fBraidctl -a set -g 0.3.0 2\fR
 875 .fi
 876 .in -2
 877 .sp
 878
 879 .sp
 880 .LP
 881 The following command sets disk 0.3.0 on controller 2 as a local hot-spare disk
 882 to volume c2t0d0:
 883
 884 .sp
 885 .in +2
 886 .nf
 887 # \fBraidctl -a set -g 0.3.0 c2t0d0\fR
 888 .fi
 889 .in -2
 890 .sp
 891
 892 .sp
 893 .LP
 894 The following command converts disk 0.3.0 on controller 2 from a global
 895 hot-spare disk to a normal one:
 896
 897 .sp
 898 .in +2
 899 .nf
 900 # \fBraidctl -a unset -g 0.3.0 2\fR
 901 .fi
 902 .in -2
 903 .sp
 904
 905 .sp
 906 .LP
 907 The following command removes disk 0.3.0 from being a local hot-spare disk from
 908 volume c2t0d0:
 909
 910 .sp
 911 .in +2
 912 .nf
 913 # \fBraidctl -a unset -g 0.3.0 c2t0d0\fR
 914 .fi
 915 .in -2
 916 .sp
 917
 918 .LP
 919 \fBExample 6 \fRSetting the Volume's Property
 920 .sp
 921 .LP
 922 The following command sets the write policy of the volume to "\fBoff\fR":
 923
 924 .sp
 925 .in +2
 926 .nf
 927 # \fBraidctl -a set -p "wp=off" c0t0d0\fR
 928 .fi
 929 .in -2
 930 .sp
 931
 932 .LP
 933 \fBExample 7 \fRCreating Volumes with the \fB-c\fR Option
 934 .sp
 935 .LP
 936 The following command creates a RAID 1 volume:
 937
 938 .sp
 939 .in +2
 940 .nf
 941 # \fBraidctl -c c0t0d0 c0t1d0\fR
 942 .fi
 943 .in -2
 944 .sp
 945
 946 .sp
 947 .LP
 948 The following command creates a RAID 0 volume:
 949
 950 .sp
 951 .in +2
 952 .nf
 953 # \fBraidctl -c -r 0 c0t1d0 c0t2d0 c0t3d0\fR
 954 .fi
 955 .in -2
 956 .sp
 957
 958 .LP
 959 \fBExample 8 \fRTaking a Snapshot of the RAID Configuration
 960 .sp
 961 .LP
 962 The following command takes a snapshot of all RAID devices:
 963
 964 .sp
 965 .in +2
 966 .nf
 967 # \fB# raidctl -S\fR
 968
 969 1 "LSI 1030"
 970 c1t1d0 2 0.2.0 0.3.0 1 DEGRADED
 971 0.2.0 GOOD
 972 0.3.0 FAILED
 973 .fi
 974 .in -2
 975 .sp
 976
 977 .sp
 978 .LP
 979 The following command takes a snapshot about volume c1t0d0:
 980
 981 .sp
 982 .in +2
 983 .nf
 984 # \fBraidctl -S c1t0d0\fR
 985
 986 c1t0d0 2 0.0.0 0.1.0 1 OPTIMAL
 987 .fi
 988 .in -2
 989 .sp
 990
 991 .sp
 992 .LP
 993 The following command takes a snapshot about disk 0.1.0 on controller 1:
 994
 995 .sp
 996 .in +2
 997 .nf
 998 # \fBraidctl -S -g 0.1.0 1\fR
 999
1000 0.1.0 GOOD
1001 .fi
1002 .in -2
1003 .sp
1004
1005 .SH EXIT STATUS
1006 .sp
1007 .LP
1008 The following exit values are returned:
1009 .sp
1010 .ne 2
1011 .na
1012 \fB\fB0\fR\fR
1013 .ad
1014 .sp .6
1015 .RS 4n
1016 Successful completion.
1017 .RE
1018
1019 .sp
1020 .ne 2
1021 .na
1022 \fB\fB1\fR\fR
1023 .ad
1024 .sp .6
1025 .RS 4n
1026 Invalid command line input or permission denied.
1027 .RE
1028
1029 .sp
1030 .ne 2
1031 .na
1032 \fB\fB2\fR\fR
1033 .ad
1034 .sp .6
1035 .RS 4n
1036 Request operation failed.
1037 .RE
1038
1039 .SH ATTRIBUTES
1040 .sp
1041 .LP
1042 See \fBattributes\fR(5) for descriptions of the following attributes:
1043 .sp
1044
1045 .sp
1046 .TS
1047 box;
1048 c | c
1049 l | l .
1050 ATTRIBUTE TYPE  ATTRIBUTE VALUE
1051 _
1052 Interface Stability     Committed
1053 .TE
1054
1055 .SH SEE ALSO
1056 .sp
1057 .LP
1058 \fBattributes\fR(5), \fBmpt\fR(7D)
1059 .sp
1060 .LP
1061 System Administration Guide: Basic Administration
1062 .SH WARNINGS
1063 .sp
1064 .LP
1065 Do not create raid volumes on internal \fBSAS\fR disks if you are going to use
1066 the Solaris Multipathing I/O feature (also known as MPxIO). Creating a new raid
1067 volume under Solaris Multipathing will give your root device a new \fBGUID\fR
1068 which does not match the \fBGUID\fR for the existing devices. This will cause a
1069 boot failure since your root device entry in \fB/etc/vfstab\fR will not match.
1070 .SH NOTES
1071 .sp
1072 .LP
1073 The \fB-z\fR option is not supported on systems that use the \fBmpt\fR driver
1074 and LSI RAID controllers.