Appendix A. CHALLENGE RAID raid5 Commands for OPS Installation

The raid5 commands are summarized in Table A-1.

Table A-1. raid5 Parameters

Parameter

Use

bind

Bind (group) physical disks into a RAID-5 unit

chglun

Change parameters for a currently bound group

clearlog

Destroy the contents of the RAID storage controller's error log

clearstats

Reset statistics logging on the RAID storage processor, setting all log counters to 0

firmware

Update the firmware on the CHALLENGE RAID storage processor

getagent

Get names and descriptions of devices controlled by the storage-control processor

getcache

Get information about the storage system caching environment

getcontrol

Get information about the processor's configuration

getcrus

Display status information on all system components, such as the fan module, battery backup unit, and so on

getdisk

Display status information on one disk module or all disk modules in the system

getlog

Display the storage processor log, in which errors are stored, or display the head and tail of the log

getlun

Display information about a disk group

setcache

Change information about the RAID controller's caching environment

unbind

Deconfigure physical disks from their current logical configuration, destroying all data on the logical unit (group)



Note: For complete details of raid5 commands, see the CHALLENGE RAID-5 Installation and Maintenance Instructions (document number 007-0128-001) or the CHALLENGE RAID-5 Owner's Guide (document number 007-2532-001.

This appendix gives details on raid5 commands that are important for OPS operation and which are referenced in this guide:

raid5 bind

The syntax of /usr/raid5/raid5 bind is as follows:

/usr/raid/raid5 [-vp] [-d device] bind raid-type lun-number disk-names [optional-args]

In this syntax, variables mean the following.

-v 

Enables verbose return. Use this flag to print detailed error message information.

-p 

Parses the raid5 command without calling the API. If the string does not parse correctly, an error message is printed to stderr; otherwise there is no output.

-d device 

Target RAID device, as returned by raid5 getagent.

The environment variable RaidAgentDevice is the default value for the device when none is specified with the -d flag. If RaidAgentDevice is not set and no -d switch is present, an error is generated.


Note: For information on raid5 getagent, see "Restarting the Agent and Checking the Config File" in Chapter 3.


raid-type  

r5: Raid level 5

lun-number  

Logical unit number to assign the unit (0-3).

disk-names 

Indicates which physical disks to bind, in the format bd, where b is the physical bus name (a through e) and d is the device number on the bus (0 through 3). For example, a0 represents the device 0 on bus A, and e2 represents device 2 on bus E.

The optional arguments are as follows.

-r rebuild-time 

Maximum time in hours to rebuild a replacement disk. Default is 4 hours; legal values are any number greater than or equal to 0.

A rebuild time of 2 hours rebuilds the disk more quickly, but degrades response time slightly. A rebuild time of 0 hours rebuilds as quickly as possible but degrades performance significantly.

If the customer requires fast response time and wants to minimize degradation to normal I/O activity, enter a longer period of time, such as 24 hours. The customer can change the rebuild time later without damaging the information stored on the physical disk unit.

-s stripe-size 

Number of blocks (sectors) per physical disk in a RAID-5 stripe. Each sector is 0.5 KB. Default is 128 sectors (65,536 bytes); legal values are any number greater than 0, in even multiples of 16.

The smaller the stripe element size, the more efficient the distribution of data read or written. However, if the stripe size is too small for a single host I/O operation, the ORACLE database application must access two stripes, thus causing the hardware to read and/or write from two disk modules instead of one. Generally, it is best to use the smallest stripe element size that will rarely force access to another stripe.

With RAID–5 technology, the hardware writes parity information to each disk module in the array. For highest data availability for a RAID–5 group, the disk modules making up the group should be on different SCSI internal buses (A, B, C, and so on). Figure A-1 illustrates user and parity data with the default stripe element size of 128 sectors (65,536 bytes) in a five-module RAID–5 group. The stripe size comprises all stripe elements. Notice that the disk block addresses in the stripe proceed sequentially from the first module to the second, third, and fourth, then back to the first, and so on.

Figure A-1. Distribution of User and Parity Data in a RAID–5 Group

Figure A-1 Distribution of User and Parity Data in a RAID–5 Group

-c cache-flags 

Values are:

  • none: no caching

  • read: read caching

  • write: write caching

  • rw: read and write caching

The default is none. confer with the customer as to whether the site wants caching enabled. The customer can also specify caching in a separate operation. For complete information on caching, see Chapter 7 of the CHALLENGE RAID-5 Owner's Guide.

-z stripe-count 

Number of stripes in a LUN. For example, in binding a RAID-5 group with a stripe count of 2, partition the LUN into 2 stripes, thus preventing access to the remainder of the available space. This option is useful for short bind operations. Legal values are any number greater than or equal to 0. The default is 0, which binds the maximum number of stripes available.

The raid5 command with the bind parameter has no output.


Note: For information on setting up caching and on dual processor, load balancing, and device names, see Chapter 4, "Installing the CHALLENGE RAID Software and Configuring Disks," in the CHALLENGE RAID-5 Installation and Maintenance Guide.


raid5 getagent

Use the getagent parameter with raid5 to display information on devices controlled by the API:

raid5 getagent

Following is a sample output for one device; normally, the output would give information on all devices.

Name: Disk Array
Desc: RAID5 Disk Array
Node: sc4d2l0
Signature:0xf3b51700
Peer Signature: 0x657e0a00
Revision: 7.12.4
SCSI ID: 1
Prom Rev: 0x0076100
SP Memory: 64
Serial No: 94-7240-808

Table A-2 summarizes entries in the raid5 getagent output.

Table A-2. Output of raid5 getagent

Entry

Meaning

Name

ASCII string found in the agent configuration file which assigns a name to the node being accessed (see node description below)

Desc

ASCII string found in the agent configuration file which describes the node being accessed (see node description below)

Node

The /dev/scsi entry which the agent uses as a path to the actual SCSI device; this value must be entered by the user for every CLI command (except getagent)

Signature

Unique 32 bit identifier for the storage processor (SP) being accessed through Node

Peer Signature

Unique 32 bit identifier for the other SP in the chassis; 0 if no additional SP is present

Revision

Revision of firmware currently running on the storage control processor

Prom Rev

PROM revision currently present on the storage control processor

SP Memory

Amount of DDRAM present on the storage control processor

Serial No

12 digit ASCII string that uniquely identifies this subsystem


raid5 firmware

To update the firmware on the CHALLENGE RAID storage-control processor, type as root

raid5 -d device firmware /usr/raid5/flare7.67.0.prom.7.99.bin


Note: You must use this command every time you replace a parity disk.

In this string, filename is the full pathname of the new firmware image. This image contains microcode that runs on the storage-control processor and possibly also a microcode image destined for the storage-control processor PROM, which runs the power-on diagnostics.

This command has no output.