arraymgr(1M)

Set Auto Rebuild on or off. On allows the disk array to automatically begin a rebuild in the event of a disk failure. Off requires a rebuild to be started manually. In either case, the disk array must have enough available capacity to perform the rebuild.

Set controller X or controller Y as the active controller for the disk array. This option is only available if there are two controllers installed in the disk array.

Set the SCSI address of the specified controller (X or Y) to the value of addr. The address must be a value from 0 to 15 and must not conflict with any other SCSI devices connected to the same SCSI channel.

Assigns the text string specified by alias_name as the alias for the disk array. The alias is another mechanism for identifying the disk array when executing a command. The alias name can be up to 12 characters in length and can include upper case letters, numbers, spaces, number sign (#), underscore (_), and period (.).

Aliasing can be used in a variety of ways to help identify disk arrays in large systems. For example, by assigning numbers to racks and to the shelf positions within the racks, each disk array can be uniquely identified using an appropriate alias. If a rack is assigned number 12, the disk array installed on shelf 3 of the rack could be identified using an alias of 12_03. This technique simplifies locating the disk array should it need service.

Change the apparent state of read cache on or off. This switch only changes the read cache setting presented to the operating system and does not affect the operation of the disk array, which always has read cache enabled. This switch is provided for operating system interoperability.

Set Format Pattern Fill on or off. This feature impacts the performance of the disk array. When disabled the disk array does not write a format pattern to the unused portion of each 64K data block. This improves the write performance of the disk array, but leaves invalid data in the unused portion of the block. Enabling the format pattern fill causes the disk array to fill the unused portion of each block with a known data pattern. This increases the amount of time required to perform each write, but it ensures that any unused portions of the disk contain a recognizable data pattern. The need to use this feature depends on how well your OS can detect unwritten portions of the disk. If your OS requires a known format pattern to distinguish areas of the disk that do not contain valid data, then enable write pattern fill.

Force server lock. Used in multi-host configurations, this option allows a host to take immediate ownership of the disk array lock. This lock gives the owner exclusive ability to perform destructive operations, such as reading and clearing the disk array logs.

Starts and stops background disk integrity testing. When starting, the testing will begin within 60 seconds of issuing the command. Disk integrity testing checks the condition of the disk media, looking for potential problems and data errors.

Controls the interval at which disk integrity testing is performed. A value of 1 to 365 specifies the number of days between testing. If a value of 0 is specified, testing is disabled and will not be performed. The default value is 9 days. If the disk array is reset or power cycled, the default value of 9 days will be restored.

Set Active Spare on or off. On enables the disk array to allocate enough capacity to rebuild a failed disk. Off disables Active Spare.

Set Auto Include on or off. On allows the disk array to automatically include any disk when it is installed in the disk array cabinet. Off requires that a disk be manually included after it is installed.

This option sets the level of protection offered by data resiliency. It determines how often the content of the controller maps are copied to the disk. Keeping the map information on the disks protect against controller map loss.

SingleController is used if the disk array is operating with only one controller. This suppresses the single controller warning messages that are normally generated when the disk array is operating with one controller.

Secure continually updates the disks with any changes in the controller maps. This is the highest level of data protection, but it may result in decreased I/O performance.

Normal updates the maps on the disks at regular intervals (typically 4 seconds). This option offers both data protection and good performance.

HighPerformance updates the disk maps only during shutdown of the disk array. This is the lowest level of data protection, but it offers the highest level of performance.

Flush current server logs to disk. The contents of the server log are copied to a disk file.

Set Terminator Power on or off.

Set Secondary Controller Offline. When set on, this option causes the secondary controller to remove itself from the SCSI bus. The secondary controller no longer responds to host commands and appears to be disconnected from the SCSI bus. This allows the secondary controller to be set to the same SCSI ID as the primary controller. If the primary controller fails, the secondary controller takes over and the host driver does not have to contend with a change in SCSI ID. This is useful for systems that do not use a driver that can gracefully handle a change in SCSI ID on the disk array.

Set Rebuild Priority high or low. High sets the rebuild to the same priority as host I/Os. This allows the rebuild to complete as quickly as possible, but slows down the servicing of I/Os. Low sets the rebuild priority lower than host I/Os. This ensures that host I/Os are serviced more quickly, but it delays the completion of the rebuild.

Set SCSI Parity Checking on or off.

Set Disable Remote Reset on or off. On disables Remote Reset, and off enables it. Remote Reset is useful when the disk array controllers are connected to separate SCSI buses. In some situations, a reset on one SCSI bus can cause the clearing of all commands on the other bus. When this occurs, the host would typically have to wait for a timeout before realizing that commands had been lost. If Remote Reset is enabled (Disable Remote Reset off), the other controller will automatically reset its own SCSI bus, thus alerting the host that commands have been lost. This allows the host to respond quickly and reissue any lost commands.

Reset the disk array. This operation performs a reset of the disk array.

Shutdown (shut) or restart (start) the disk array. A shutdown takes the disk array offline, making all data on the array unavailable to the host. A restart brings the disk array back online.

Set the capacity threshold warning to the percentage specified by value. The capacity threshold warning generates an alert when the percentage of disk array capacity specified by value is in use.

Set SDTR on or off.

Verbose mode displays additional command execution, state, and/or status messages.

Change the apparent state of write cache on or off. This switch only changes the write cache setting presented to the operating system and does not affect the operation of the disk array, which always has write cache enabled. The disk array write cache is stored in NVRAM which eliminates the need to disable write cache for protection against power loss. This switch is provided for interoperability with those operating systems that require write cache be turned off.

Set WDTR on or off.

Display extended usage message. This option overrides all others.

This privilege is raised to provide discretionary read access to the devices.

This privilege is raised to provide discretionary write access to the devices.

This privilege is raised to provide mandatory read access to the devices.

This privilege is raised to provide mandatory write access to the devices.

This privilege is raised to allow the mknod(2) system call to succeed.

The command generates its own audit records and submits these directly to the system audit trail. This privilege is raised whenever the command needs to write an audit record.