HP-UX Reference (11i v1 00/12) - 1M System Administration Commands N-Z (vol 4)
__________________________________________________________________________________________________________________________________________________________________________________________________
__________________________________________________________________________________________________________________________________________________________________________________________________
STANDARD Printed by: Nora Chuang [nchuang] STANDARD
/build/1111/BRICK/man1m/naaagt.1m
________________________________________________________________
___ ___
n
newarray(1M) newarray(1M)
NAME
newarray - configure a disk array
SYNOPSIS
newarray [-NConfig_Name |-rRAID_Level][Options] device_file
DESCRIPTION
newarray, a front-end program for the utility cfl (see cfl(1M)), facilitates the configuration of Hewlett-
Packard SCSI disk arrays. It is the recommended utility for all array configuration. Array configuration
maps a set of one or more physical disk mechanisms in an array to a set of one or more logical disks,
addressable by HP-UX. Logical disks are addressed through device files. Each logical disk in an array (also
known as a LUN, for Logical UNit), has its own device file. A logical disk can consist of a single physical
disk, a portion of a single physical disk, multiple physical disks, or portions of multiple physical disks. For
additional information about possible array configurations, see the array configuration table contained in
the file /etc/hpC2400/arraytab, and arraytab(4).
Supported configurations for the array device are pre-defined in the array configuration table, located in file
/etc/hpC2400/arraytab.
newarray can configure a complete set of logical partitions for an array in one operation. Due to the
inter-dependency of logical partitions, this is the recommended method for configuration. A single logical
partition can be added to an array configuration using an entry from the array configuration table by using
the -L option.
device_file is a character device file that specifies the I/O address, and driver to use when configuring
the disk array. The way that this file is used by newarray is system dependent. See dependencies
below. Logical partitions in an array are independently addressable by using the appropriate device file to
address the logical unit assigned to a partition.
Prior to configuring the array (except with the -L option ), all currently configured logical partitions are
removed from the configuration.
To simplify array configuration
newarray obtains much of the necessary information directly from the
array device, and its attached disk mechanisms. The array model number, and the number of available
physical disks available, is determined by querying the device. This information is used to locate the
appropriate configuration entry in the array configuration table. Optional parameters can be used to over-
ride the default, and inquiry values.
The preferred configuration method is to use the -N option to specify a configuration by name. The name
determines which configuration newarray uses from the array configuration table. Configuration param-
eters are obtained from the named configuration entry. Parameters of the chosen configuration can be
overridden using options to newarray, or by creating and using a custom configuration entry in the array
configuration table. See the WARNINGS section of this manpage.
Because the array controller type, and disk mechanism types are used in addition to the configuration
name to select an entry from the array configuration table the configuration name does not have to be
unique within the array configuration table. However, the combination of configuration name, array con-
troller type, and disk mechanism types must be unique within the array configuration table. During
configuration, the array controller type, and disk mechanism types are obtained by querying the devices.
The -r option specifies an operating mode, rather than specifying a configuration by name. The
-d
option, which specifies the size of a disk group, is often used with the -r
option. If -d is not used,
newarray selects the configuration in the array configuration table that most closely matches the disks in
the array.
When the configuration parameters have been determined, newarray calls cfl.
If the -V option is used, newarray prints its actions, and the parameters it passes to cfl to configure
the array (see cfl(1M)).
Array Configuration
newarray obtains its configuration values from the array configuration table. If not specified there,
default values are provided by cfl (see cfl(1M)). Configuration values can be overridden by newarray
options.
Options
-L unit addr Configures a single LUN from the specified configuration. The
-L option is useful for
adding disks to an array without changing the existing configuration. Because the order in
Section 1M−−562 − 1 − HP-UX Release 11i: December 2000
___
___