HP NetRAID-4MFlexible Array Storage ToolCommand Line InterfaceUser’s GuideHP Part Number 5969-8467Printed in January 2001

xCommand Line Interface User’s Guide Working with Enabling the Container’s Volatile Read-ahead Cache 9-20Working with Enabling the Container’s NVRAM

5-22Command Line Interface User’s Guide Taking Ownership of a DisksetTaking ownership of a diskset assigns ownership of a diskset to either the contro

5-23Working with Disksets display information about your disksets, as in the following example. In the example, the Owner column indicates that the co

5-24Command Line Interface User’s Guide Disks Attached OS Managed Label Shared Spare------ -------- ---------- ---------- ------

5-25Working with Disksets Before releasing ownership of a diskset, use the disk_set list command to display information about your disksets, as in the

5-26Command Line Interface User’s Guide Disks Attached OS Managed Label Shared Spare------ -------- ---------- ---------- ------

5-27Working with Disksets After running the disk_set changespare pool command to change a diskset’s sparepool assignment, use the disk_set list comman

6-1 6Working with Container AttributesA container is a logical disk created from freespace and made up of one or more partitions on one or more physic

6-2Command Line Interface User’s Guide Understanding Container Identification AttributesThe container identification attributes identify a container.

6-3Working with Container Attributes Table 6-1. Container Identification AttributesAttributeCLI Operations Related Commands Discussed in...drive lette

xiContents Understanding the Update Snapshot Container Attributes that You Can Specify 10-7Understanding How to Update a Container Snapshot 10-8Removi

6-4Command Line Interface User’s Guide The following sections describe the container identification attributes.container numberCreateDisplayRenumberco

6-5Working with Container Attributes Displaying, Assigning, and Removing a Drive Letter (Windows Only)The drive letter attribute identifies the drive

6-6Command Line Interface User’s Guide The specification of the drive letter is optional. If you omit the drive letter, the CLI assigns the next avail

6-7Working with Container Attributes column. On UNIX systems, containers are associated with root special files not drive letters.See your UNIX docume

6-8Command Line Interface User’s Guide Executing: container list Cluster Num Total Oth Stripe Scsi Partition Dr Partner Label Ty

6-9Working with Container Attributes To specify a cluster partner, use a command listed in Table 6-2, as in the following example. In the example, the

6-10Command Line Interface User’s Guide and the peer partner is indicated with the number 1. For example, container 3 on the peer partner is indicated

6-11Working with Container Attributes following example, the container offline command takes container 0 on cluster partner 1 (the peer cluster partne

6-12Command Line Interface User’s Guide You can also assign a label to a container when you create it using the following commands: container create

6-13Working with Container Attributes To display a container’s type, use the container list command, as in the following example. In the example, the

xiiCommand Line Interface User’s Guide Displaying the Mail Subject Line 12-4Displaying the Mail Body Line 12-5Setting the Mail Server 12-5How to Set

6-14Command Line Interface User’s Guide Cluster Num Total Oth Stripe ScsiDr Partner Label Type Size Ctr Size Usage C:ID:L

6-15Working with Container Attributes Executing: container list /full=TRUE Cluster Num Total Oth Stripe Scsi CreationDr Partne

6-16Command Line Interface User’s Guide Table 6-5. Container Size AttributesThe total size of a container is the result of your specifying freespace.

6-17Working with Container Attributes Understanding FreespaceFreespace is the space on an initialized disk that is not being used by other RAID compon

6-18Command Line Interface User’s Guide To convert freespace to container space, use the container create raid5 command, the container create stripe c

6-19Working with Container Attributes Displaying and Setting a Container’s Total SizeThe total size attribute indicates the number of bytes in a conta

6-20Command Line Interface User’s Guide 0 0 Volume 15MB None 2:01:0 64KB: 15MB 0 1 Stripe 45MB 32KB

6-21Working with Container Attributes Table 6-6. Container Access AttributesThe following sections describe the container access attributes.Displaying

6-22Command Line Interface User’s Guide Cluster Num Total Oth Stripe Scsi Dr Partner Label Type Size Ctr Size Usage C:

6-23Working with Container Attributes To set a container’s availability to read/write, use the container readwrite command, as in the following exampl

xiiiContents Locking Information in the Network Connection Database 14-7Unlocking Information in the Network Connection Database 14-8Deleting Informat

6-24Command Line Interface User’s Guide To display whether a container is locked, use the container list command with the /full switch, as in the foll

6-25Working with Container Attributes Table 6-7. Container Usage AttributesThe following sections describe the container usage attributes.Displaying a

6-26Command Line Interface User’s Guide snapshot container, you can specify whether to use compact mode. Compact mode uses a smaller backing container

6-27Working with Container Attributes Displaying a Multi-partition ContainerThe multi-partition container attribute indicates that a file system resid

6-28Command Line Interface User’s Guide To display whether a container is a UNIX-opened container, use the container list command, as in the following

6-29Working with Container Attributes Executing: container list Cluster Num Total Oth Stripe Scsi Partition Dr Partner Labe

6-30Command Line Interface User’s Guide -- ------- ----- ------ ------ --- ------ ------- ------ ------------- 0 0 Volume 30MB

6-31Working with Container Attributes Displaying a Mirror Set Create StateThe mirror set create state attribute indicates the creation of a mirror set

6-32Command Line Interface User’s Guide associated with these attributes, the CLI commands you use to perform these operations, and the section that d

6-33Working with Container Attributes In the example, the State column indicates container 0 is being used as a Copy container in a container reconfig

6-34Command Line Interface User’s Guide the example, the State column indicates Raid5, which means that container 0 is being used as a RAID-5 set in a

6-35Working with Container Attributes To display whether a container is being used as a temporary container in a reconfiguration operation, use the co

6-36Command Line Interface User’s Guide The following sections describe the snapshot state attributes.Displaying the Snapshot Original Container Creat

6-37Working with Container Attributes Displaying the Snapshot Backing Container StateThe snapshot backing container state attribute indicates that a c

6-38Command Line Interface User’s Guide Num Total Oth Stripe Scsi Dr Label Type Size Ctr Size Usage C:ID:L State-- ---

6-39Working with Container Attributes Understanding Container Cache AttributesYour RAID controller supports two global cache buffer pools that are ava

6-40Command Line Interface User’s Guide The following sections describe the container cache attributes.Displaying a Container’s Global Container Read

6-41Working with Container Attributes Write Cache Status : Inactive, cache disabledDisplaying a Container’s Global Container Write Cache SizeTh

6-42Command Line Interface User’s Guide Write Cache Status : Inactive, cache disabledTo set a container’s read cache, use the container create

6-43Working with Container Attributes Displaying a Container’s Write Cache StatusThe write cache status setting attribute indicates the current state

1-1 1Getting StartedHewlett-Packard™NetRAID-4M®RAID Controller products integrate advanced RAID technology with state-of-the-art controller hardware t

7-1 7Working With Single-level ContainersThis chapter explains how to use the CLI to work with and create single-level containers. A single-level cont

7-2Command Line Interface User’s Guide See the Flexible Array Storage Tool User’s Guide for a description of single-level container concepts.The follo

7-3Working With Single-level Containers Specifying Freespace When Creating a Volume SetA volume set’s size is created from freespace. To specify frees

7-4Command Line Interface User’s Guide Enables the NVRAM write-back cache setting for the specified volume set if a battery is present and its statu

7-5Working With Single-level Containers 2:02:0 Free 64.0KB:8.47GB 2:03:0 Free 64.0KB:8.47GB 2:04:0 Free 64.0KB:8.47GBTo

7-6Command Line Interface User’s Guide Understanding Volume Set Creation in a UNIX EnvironmentOn UNIX systems, the message displayed after you execute

7-7Working With Single-level Containers Understanding the Stripe Set Attributes You Can SpecifyYou use the container create stripe command to create a

7-8Command Line Interface User’s Guide Stripe Set for further information on the container list command.In the following example, the container create

7-9Working With Single-level Containers Specifying a Label for a Stripe SetThe container label attribute identifies a name assigned to a container. No

1-2Command Line Interface User’s Guide material related to storage management on RAID controllers presented in the Flexible Array Storage Tool User’s

7-10Command Line Interface User’s Guide HPN0> container create stripe /cache=TRUE /label=Mars ((2,01,0), 100M)Executing: container create stripe /c

7-11Working With Single-level Containers Identifying Some Tasks to Perform After Creating a Stripe SetAfter you create a stripe set, you can: Add a f

7-12Command Line Interface User’s Guide Specifying Mirror Disk CapacityThe disk used to hold the mirror set must be the same size as the disk that is

7-13Working With Single-level Containers Specifying Synchronous or Asynchronous Mirror Set CreationWhen you create a mirror set you can optionally spe

7-14Command Line Interface User’s Guide After running the container create mirror command, use the container list command to display information about

7-15Working With Single-level Containers Assign a drive letter. See Chapter 6, Working with Container Attributes, for a description of how to assign

7-16Command Line Interface User’s Guide container label parity (setting up by scrubbing) synchronous or asynchronous RAID-5 set creationSpecifying

7-17Working With Single-level Containers Executing: container create raid5 /stripe_size=65,536 ((CHANNEL=2,ID=1,LUN=0), 104,857,600) (CHANNEL=2,ID=2,L

7-18Command Line Interface User’s Guide Container Label in Chapter 6, Working with Container Attributes, for a description of the container set label

7-19Working With Single-level Containers In the following example, the container create raid5 command with the /wait switch creates a RAID-5 set and r

1-3Getting Started Chapter 5, Working with Disksets, describes how to manage disksets that are part of a clustered system. This includes information o

7-20Command Line Interface User’s Guide RAID-5 set, as in the following example. In the example, the Type column indicates that a RAID-5 set resides o

7-21Working With Single-level Containers Add a file system. See Chapter 9, Modifying Containers, for a description of how to add a file system. As

8-1 8Working with Multi-level ContainersThis chapter explains how to use the CLI to create multi-level containers. A multi-level container is a combin

8-2Command Line Interface User’s Guide The RAID software supports three types of multi-level containers: Multi-level stripe sets Multi-level volume

8-3Working with Multi-level Containers Stripe set of mirror set creation in a NetWare environment Stripe set of mirror set creation in a UNIX envir

8-4Command Line Interface User’s Guide while creating a stripe set of mirror sets or at a later time using the container set label command. See Displa

8-5Working with Multi-level Containers After running the container create mstripe command, use the container list command to display information about

8-6Command Line Interface User’s Guide For information on how to display the NetWare console remotely on the NT client running FAST, see the Flexible

8-7Working with Multi-level Containers Understanding the Stripe Set of Volume Set Attributes You can SpecifyYou use the container create mstripe comma

1-4Command Line Interface User’s Guide ConventionsThe following typographical conventions are used in this user’s guide.In some examples in this docum

8-8Command Line Interface User’s Guide In the following example, the container create mstripe command with the /label switch creates a stripe set of v

8-9Working with Multi-level Containers These three containers make up the stripe set of volume sets. The Total Size column indicates that the stripe s

8-10Command Line Interface User’s Guide Use the container list command to display the root special file associated with the stripe set of volume sets.

8-11Working with Multi-level Containers data stream switches to the next partition in the stripe. The stripe size can be 8 KB, 16 KB, 32 KB, or 64 KB.

8-12Command Line Interface User’s Guide sets have been created. See Working with a Stripe Set on page 7-5 in Chapter 7, Working With Single-level Cont

8-13Working with Multi-level Containers 0 0 Stripe 400MB 32KB None 0 63 Stripe 200MB 32KB 2:01:0 64.

8-14Command Line Interface User’s Guide Assign a drive letter. See Chapter 6, Working with Container Attributes, for a description of how to assign

8-15Working with Multi-level Containers display the stripe size of a stripe set of RAID-5 sets using the container list command. See Understanding How

8-16Command Line Interface User’s Guide Num Total Oth Stripe Scsi Partition Dr Label Type Size Ctr Size Usage C:ID:

8-17Working with Multi-level Containers 2:03:0 64.0KB: 50.0MB 62 RAID-5 100MB 2:01

1-5Getting Started Flexible Array Storage Tool User’s Guide The Flexible Array Storage Tool User’s Guide provides information about FAST that you ne

8-18Command Line Interface User’s Guide Assign a drive letter. See Chapter 6, Working with Container Attributes, for a description of how to assign

8-19Working with Multi-level Containers Specifying a Label for a Volume Set of Stripe SetsThe container label attribute indicates a name assigned to a

8-20Command Line Interface User’s Guide HPN0> container create mvolume 0 1Executing: container create mvolume 0 1Container 0 createdAfter running t

8-21Working with Multi-level Containers For information on how to display the NetWare console remotely on the NT client running FAST, see the Flexible

8-22Command Line Interface User’s Guide Volume set of mirror set creation in a UNIX environment Some tasks to perform after creating a volume set o

8-23Working with Multi-level Containers containers, as in the following example. In the example, the Type column indicates two Mirror sets reside on c

8-24Command Line Interface User’s Guide Understanding a Volume Set of Mirror Sets in a NetWare EnvironmentWhen creating a multilevel container of volu

8-25Working with Multi-level Containers Creating a Volume Set of RAID-5 SetsA volume set of RAID-5 sets is a multi-level container made up of a top-le

8-26Command Line Interface User’s Guide In the following example, the container create mvolume command with the /label switch creates a volume set of

8-27Working with Multi-level Containers volume set of RAID-5 sets, as in the following example. In the example, the Type column indicates a top-level

iiCopyright© Copyright 2001, Hewlett-Packard Company.This document contains proprietary information that is protected by copyright. All rights are res

8-28Command Line Interface User’s Guide Understanding a Volume Set of RAID-5 Set Creation in a UNIX EnvironmentOn UNIX systems, the message displayed

8-29Working with Multi-level Containers Understanding the Volume Set of Volume Sets Attribute You can SpecifyYou use the container create mvolume comm

8-30Command Line Interface User’s Guide -- ------- ----- ------ ------ --- ------ ------- ------ ------------- 0 0 Volume 100MB

8-31Working with Multi-level Containers After you create a multilevel volume set on a NetWare server, you must run the list devices command on the Net

8-32Command Line Interface User’s Guide command after promoting a volume set that was built from multiple partitions with the container promote comman

8-33Working with Multi-level Containers Specifying Synchronous or Asynchronous Command Execution for a Volume Set of Mirror SetsWhen you create a volu

8-34Command Line Interface User’s Guide container 0 (a volume set of volume sets created with the container promote command) is used to create the vol

8-35Working with Multi-level Containers NetWare console and then create the necessary NetWare disk partitions and volumes.For information on how to cr

9-1 9Modifying ContainersThis chapter explains how to use the CLI commands to manipulate and modify containers. Before you can work with containers, y

2-1 2Introducing the Command Line InterfaceYou can invoke the CLI by doing the following: Accessing the CLI from the MS-DOS Prompt Accessing the CLI

9-2Command Line Interface User’s Guide Working with Container ReconfigurationThe CLI allows you to reconfigure an existing container. See the Flexible

9-3Modifying Containers Reconfiguring a Container’s TypeThe container type attribute indicates the type of container to which the existing container i

9-4Command Line Interface User’s Guide Stripe set of mirror sets Stripe set of volume sets Stripe set of stripe sets Stripe set of RAID-5 sets S

9-5Modifying Containers Specifying Synchronous or Asynchronous Command ExecutionThe wait attribute indicates whether the command prompt returns after

9-6Command Line Interface User’s Guide To change a volume set to a stripe set, use the container reconfigure command with the /stripe switch, as in th

9-7Modifying Containers Typically, you use the container promote command as part of a process to provide fault tolerance for existing volume sets. To

9-8Command Line Interface User’s Guide container ID is 0, and an underlying Volume set, whose container ID is 63. (Container 63 is a hidden container.

9-9Modifying Containers Understanding How to Add a Level to a ContainerThis section provides an example that describes how to add a level to a contain

9-10Command Line Interface User’s Guide Understanding How to Add a Level to a Container in a UNIX EnvironmentThe container add level feature is not av

9-11Modifying Containers Assign a drive letter to the split container using the container assign drive_letter command. See Chapter 6, Working with C

2-2Command Line Interface User’s Guide Note: If you specified the path to the afacli executable program in the System Variables on Windows NT or Windo

9-12Command Line Interface User’s Guide Executing: container split 0Container 1 createdAfter running the container split command to split a mirror set

9-13Modifying Containers The following sections discuss each of these topics.Understanding the Container Unmirroring Attributes You can SpecifyYou use

9-14Command Line Interface User’s Guide Scrubbing a Mirror SetThe CLI allows you to scrub a mirror set. Scrubbing a mirror set reconstructs the data o

9-15Modifying Containers Executing: container scrub /no_repair=FALSE 2 Specifying Synchronous or Asynchronous Command ExecutionThe wait attribute indi

9-16Command Line Interface User’s Guide that the container consists of partitions on SCSI devices 2:01:0 and 2:02:0.HPN0> container listExecuting:

9-17Modifying Containers Understanding the RAID-5 Set Restore Attributes You can SpecifyYou use the container restore raid5 command to restore a RAID-

9-18Command Line Interface User’s Guide 2:02:0 64.0KB: 100MB

9-19Modifying Containers HPN0> container scrub /no_repair=FALSE 2Executing: container scrub /no_repair=FALSE 2 Specifying Synchronous or Asynchrono

9-20Command Line Interface User’s Guide HPN0> container listExecuting: container list Cluster Num Total Oth Stripe Scsi Par

9-21Modifying Containers To work with enabling a container’s volatile read-ahead cache, you must understand: The container set cache attributes you c

2-3Introducing the Command Line Interface Accessing the CLI from the UNIX PromptTo access the CLI from the UNIX prompt, type hpncli from the command p

9-22Command Line Interface User’s Guide To enable a container’s volatile read-ahead cache, use the container set cache command with the /read_cache_en

9-23Modifying Containers Understanding the NVRAM Write-back Cache Attributes You can SpecifyYou use the container set cache command to enable a contai

9-24Command Line Interface User’s Guide following table summarizes the values for the /unprotected and /write_cache_enable switches:Understanding How

9-25Modifying Containers column indicates None, which means no file system resides on container 0.HPN0> container listExecuting: container list

9-26Command Line Interface User’s Guide When a disk fails or you remove a disk, the cache buffers associated with a container remain locked on the con

9-27Modifying Containers container show cache command to display information about the cache buffers associated with a container.Understanding Releasi

9-28Command Line Interface User’s Guide How to assign spare disks to a single containerThe following sections discuss each of these topics.Understan

9-29Modifying Containers 0 2:03:0Removing Spare Disks from a Single ContainerThe CLI allows you to remove one or more spare disks assigned to

9-30Command Line Interface User’s Guide Executing container remove spare 0 (CHANNEL=2,ID=3,LUN=0)After running the container remove spare command to r

9-31Modifying Containers the example, the Type column indicates a Mirror set on container 0 and container 1.HPN0> container listExecuting: containe

9-32Command Line Interface User’s Guide To work with removing one or more spare disks from all containers managed by a controller, you must understand

9-33Modifying Containers After running the container remove global_spare command to remove one or more spare disks from all containers managed by a co

9-34Command Line Interface User’s Guide Adding a file system to a container in a UNIX environmentThe following sections discuss each of these topics

9-35Modifying Containers Specifying File System CompressionThe file system compression attribute indicates whether to compress the NTFS file system th

9-36Command Line Interface User’s Guide In the following example, the container format command with the /quick switch performs a quick format on the c

9-37Modifying Containers After running the container format command to add a file sys-tem, use the container list command to display information about

9-38Command Line Interface User’s Guide Understanding the Extend File System Attributes You can SpecifyYou use the container extend file_system comman

9-39Modifying Containers F: 0 0 Volume 100MB NTFS 2:01:0 64.0KB: 100MB Understanding Extending a File System on a Container i

9-40Command Line Interface User’s Guide To remove a file system from a container, use the container remove file_system command, as in the following ex

9-41Modifying Containers To work with extending a volume set, you must understand: The extend volume set attributes you can specify How to extend a

3-1 3Working with ControllersThis chapter explains how to use the CLI to manage a RAID controller so that you can manage such storage resources as dis

9-42Command Line Interface User’s Guide 0 0 Volume 100MB None 2:01:0 64.0KB: 100MB You may also want to use the disk show

9-43Modifying Containers To work with extending a multi-level container of volume sets, you must understand: The extend multi-level container of volu

9-44Command Line Interface User’s Guide Container 0 extended.After running the container extend mvolume command, use the container list command to dis

9-45Modifying Containers indicates container 0, and the Usage column indicates None (there is no resident file system on the container). HPN0> cont

9-46Command Line Interface User’s Guide Understanding the Container Delete Attributes You Can SpecifyYou use the container delete command to delete a

9-47Modifying Containers Before deleting a container, use the container list command to display information about your containers, as in the following

9-48Command Line Interface User’s Guide configuration, you must first upgrade to NetWare 5.1 Service Pack 1 (or higher), then unload and reload NSS (w

10-1 10Working with Snapshot ContainersThis chapter explains how to use the CLI to create, update, and remove snapshot containers. You can perform sna

10-2Command Line Interface User’s Guide Creating a Snapshot ContainerYou can create a snapshot of any type container, except a mirror set. When you ma

10-3Working with Snapshot Containers using a read-only application (for example, a backup utility) with the snapshot. The container create snapshot co

3-2Command Line Interface User’s Guide operations, the CLI displays an appropriate message. In this case, you can open the controller for read-only op

10-4Command Line Interface User’s Guide In the following example, the container create snapshot command with the /stripe_size switch uses container 0

10-5Working with Snapshot Containers 0 1 Stripe 200MB 32KB None 2:02:0 64.0KB: 100MB

10-6Command Line Interface User’s Guide The RO column indicates a blank space for the snapped container, 0+62, and the snapshot container, 1+63, whi

10-7Working with Snapshot Containers Updating a Snapshot ContainerUpdating a snapshot container updates archive information on the snapshot container

10-8Command Line Interface User’s Guide Understanding How to Update a Container SnapshotThis section provides an example that describe how to update t

10-9Working with Snapshot Containers Removing a Snapshot ContainerRemoving a snapshot container removes the link between the original container and th

10-10Command Line Interface User’s Guide information about your containers, as in the following example. In the example, the State column indicates Sn

10-11Working with Snapshot Containers 2:03:0 Clearing NVRAM of Unconfigured Snapshot Cont

10-12Command Line Interface User’s Guide HPN0> controller show unconfigured_snapshotExecuting: controller show unconfigured_snapshots NVRAM is bein

11-1 11Working with Diagnostic CommandsThis chapter explains how to use the CLI to perform diagnostic operations on a controller. Diagnostic informati

3-3Working with Controllers The CLI allows you to open a controller in the following modes: Read/write Read-only Snapshot Modes of Opening and Clo

11-2Command Line Interface User’s Guide Understanding Diagnostic AttributesDiagnostic attributes are the characteristics of a controller that can be a

11-3Working with Diagnostic Commands to 32 and the delay time is set to 10, the controller batches I/O request responses for one millisecond only if t

11-4Command Line Interface User’s Guide Displaying a Boot-time ParameterThe boot parameter attribute indicates a specific boot-time parameter for whic

11-5Working with Diagnostic Commands .Partitions:6 . . .Battery Information----------

11-6Command Line Interface User’s Guide Executing: diagnostic show history /current=TRUE *** HISTORY BUFFER FROM CURRENT CONTROLLER RUN ***

11-7Working with Diagnostic Commands Setting a Boot ParameterYou use the diagnostic set boot_parameter command to set a controller boot-time parameter

11-8Command Line Interface User’s Guide HPN0> diagnostic moderation set count 100Executing: diagnostic moderation set Count 100After running the di

11-9Working with Diagnostic Commands time is set to 20 milliseconds (that is, 20 milliseconds = 200 x 100 microseconds).HPN0> diagnostic moderation

12-1 12Working with Event NotificationThis chapter explains how to use the CLI to enable, display, test, and disable controller event notification mes

3-4Command Line Interface User’s Guide Opening a Controller in Snapshot ModeA snapshot is an instantaneous read-only copy of a container "snapped

12-2Command Line Interface User’s Guide Enabling E-Mail NotificationBefore using the CLI to manage controller e-mail notifications, use the following

12-3Working with Event Notification Displaying the Mail ServerThe mail server name attribute identifies the name of the computer that processes e-mail

12-4Command Line Interface User’s Guide Executing: mail show messageMessage : AdapterFailureTo: : [email protected] : sul9999bBody

12-5Working with Event Notification To : [email protected] : HP NetRAID-4M controller messageBody : The controller "%adapter%

12-6Command Line Interface User’s Guide How to Set the Mail ServerThis section provides an example that describes how to set the e-mail server that se

12-7Working with Event Notification How to Set Mail Message ReportingThis section provides an example that describes how to set e-mail notification me

12-8Command Line Interface User’s Guide message reporting is set for the DriveLetterChange event type and the FileSystemChange event type.HPN0> mai

12-9Working with Event Notification To send a test e-mail notification message, use the mail test command, as in the following example. In the example

12-10Command Line Interface User’s Guide Body : A drive letter assignment change occurred on container (%container%).%nl%Controller : "%adapt

13-1 13Working with Tasks This chapter explains how to use the CLI to display and manage tasks running on a controller. A task is an operation that ru

3-5Working with Controllers the domain name for the NetWare system. The Adapter Name column indicates that HPN0 is the name of the controller installe

13-2Command Line Interface User’s Guide Table 13-1. Task AttributesThe following sections describe how to display the task attributes.Displaying the T

13-3Working with Tasks TaskId Function Done% Container State Specific1 Specific2------ -------- ------- --------- ----- --------- --------- 103 C

13-4Command Line Interface User’s Guide Displaying the Container IDThe container ID attribute indicates the identification numbers of the containers a

13-5Working with Tasks is running, and the Specific1 column indicates 00000000, which means that no errors were found.HPN0> task listExecuting: tas

13-6Command Line Interface User’s Guide Windows NT and Windows 2000 (basic disk only): the status line appears in the MS DOS prompt title bar NetWa

13-7Working with Tasks Controller TasksTaskId Function Done% Container State Specific1 Specific2------ -------- ------- --------- ----- --------- --

13-8Command Line Interface User’s Guide HPN0> task listExecuting: task list Controller TasksTaskId Function Done% Container State Specific1 Speci

13-9Working with Tasks Before suspending a task, use the task list command to display information about all tasks running on a controller, as in the f

13-10Command Line Interface User’s Guide Before resuming a task, use the task list command to display information about all tasks running on a control

14-1 14Working with Remote ManagementThis chapter explains how to use the CLI to locate and open a controller on another computer. Once you open a con

iii ContentsContents1 Getting StartedAudience 1-1Supported Platforms 1-2Organization 1-2Conventions 1-4Related Documentation 1-4Notes, Cautions, and

3-6Command Line Interface User’s Guide Table 3-1. Controller AttributesController Attribute CLI OperationsRelated Commands Discussed In...controlle

14-2Command Line Interface User’s Guide Understanding Remote Management AttributesThe remote management attributes are the characteristics of remote m

14-3Working with Remote Management To display whether a computer’s connection information is locked or unlocked in the network connection database, us

14-4Command Line Interface User’s Guide Displaying the Remote User NameThe remote user name attribute indicates the name of a user who is accessing a

14-5Working with Remote Management the remote scan command does not remove the record from the network connection database even if the associated comp

14-6Command Line Interface User’s Guide U \\\TIGERNET\\GOLIATH L \\\TIGERNET\\OAK U \\\TIGERNET\\SUPREME L

14-7Working with Remote Management werewolf.go.movies.com using the TCPIP network protocol. The default domain is tigernet.HPN0> remote add werewol

14-8Command Line Interface User’s Guide Lock Status Computer------------ -------------------------- U \\\TIGERNET\\BULLDOG U

14-9Working with Remote Management remote scan command to delete the computer’s connection record from the network connection database. Before unlocki

14-10Command Line Interface User’s Guide U \\\TIGERNET\\BULLDOG U \\\TIGERNET\\GOLIATH L \\\TIGERNET\\OAK U

14-11Working with Remote Management After executing the remote delete command, use the remote list command to display a list of computers that have a

3-7Working with Controllers The following sections describe how to display the controller attributes.Displaying whether a Controller Resides in a Clus

15-1 15Working with ScriptsThis chapter explains how to write and execute automated scripts that can be used to perform a variety of CLI tasks. Script

15-2Command Line Interface User’s Guide The following sections describe how to execute CLI scripts from the afacli and OS command prompts.Executing a

15-3Working with Scripts Executing Scripts at the DOS Command PromptYou can execute a CLI script at the DOS command prompt as follows: Enter the scri

15-4Command Line Interface User’s Guide $ clist.txtThe CLI commands in this script file must be entered on a single line and separated by a ":&qu

15-5Working with Scripts Executing Scripts at the NetWare and Windows NT/2000 Command PromptsYou can execute a CLI script at the NetWare command promp

15-6Command Line Interface User’s Guide Example ScriptsThis section provides example scripts that you may find useful or that you can adapt for your w

15-7Working with Scripts enclosure show slotenclosure show temperatureenclosure show fanenclosure show powerdiagnostic moderation show timerdiagnostic

15-8Command Line Interface User’s Guide container create raid5 /cache /scrub ((0,0,0),30M) (0,1,0) (0,2,0) (0,3,0) (1,0,0) (1,1,0) (1,2,0) (2,1,0) (2,

Index-1 IndexAaccess mode 3-9activity light, blinking 4-19adapter name 3-2adding a file system 9-33in UNIX 9-37adding a level to a containerhow to 9-9

3-8Command Line Interface User’s Guide details for the controlling partner.The Cluster Partner Controller 1 Information items show controller details

Command Line Interface User’s Guide Index-2 container update snapshot wait 10-7container usage 6-24controller attribute 3-8controller cluster environm

Index-3Index product ID 4-5quick format 9-35RAID-5 set 7-15RAID-5 set restore 9-17RAID-5 set scrub 9-18RAID-5 set state 6-38RAID-5 set unprotected sta

Command Line Interface User’s Guide Index-4 write cache setting 6-42write cache status setting 6-43write-back cache 9-23attributes for stripe set of R

Index-5Index container extend volume 9-40container move 6-10container promote 9-6container readonly 6-22container readwrite 6-23container reconfigurat

Command Line Interface User’s Guide Index-6 mail test 12-9open 3-3remote add 14-6remote delete 14-10remote list 14-3remote lock 14-7remote scan 14-4re

Index-7Index synchronous and asynchronous command execution 9-36container IDdisplaying 6-10renumbering 6-10container identification attributescluster

Command Line Interface User’s Guide Index-8 container update snapshot wait attribute 10-7container usage attributesmulti-partition container 6-27NetWa

Index-9Index destination container 6-33diagnostic attributesunderstanding 11-2diagnostic commandsdiagnostic clear boot_parameter 11-6diagnostic dump s

Command Line Interface User’s Guide Index-10 diskset attributes 5-2attached 5-6creator ID 5-4disks 5-6diskset ID 5-3failover 5-9label 5-7members 5-10O

Index-11Index container 9-40file system 9-4, 9-37multi-level container of volume sets 9-42volume set 9-41Ffailovercontroller automatic 3-17disk 9-27ma

3-9Working with Controllers Type column indicates that HP NetRAID-4M is the controller type (product name) for controller HPN0.HPN0> controller lis

Command Line Interface User’s Guide Index-12 mirror set 7-12i/o wait durationscrubbing a mirror set 9-14scrubbing a RAID-5 set 9-18volume set of mirro

Index-13Index multi-level containersworking with 8-1multi-level containers of mirror setsworking with 8-31multi-level stripe setsworking with 8-2multi

Command Line Interface User’s Guide Index-14 how to create 7-19no repair when scrubbing 9-18restore attributes 9-17restoring 9-16scrub attributes 9-18

Index-15Index displaying 14-4removecontainer drive letter 6-6failover disk attributes 9-29file system attributes 9-39global failover disks attributes

Command Line Interface User’s Guide Index-16 creating 10-2link 10-1snapshot commandscontainer create snapshot 10-2container remove snapshot 10-9contai

Index-17Index container label 8-7stripe size 8-7stripe set of volume setsattributes 8-7creating in NetWare 8-9creating in UNIX 8-9how to create 8-8str

Command Line Interface User’s Guide Index-18 Vverify a diskrepair bad blocks 4-18withoug reparing bad blocks 4-18verifying a disk 4-18visible containe

3-10Command Line Interface User’s Guide Executing: controller details Controller Information---------------------- Remote Computer: SUL9999B

3-11Working with Controllers To display the controller’s CPU type, use the controller details command, as in the following example. In the example, th

3-12Command Line Interface User’s Guide Access Mode: READ-WRITEController Serial Number: Last Six Digits = A7F90F Number of Chann

3-13Working with Controllers the Controller CPU Speed item indicates that the controller CPU speed is 233 Mhz. HPN0> controller detailsExecuting: c

3-14Command Line Interface User’s Guide Devices per Channel: 15 Controller CPU: Strong Arm 110 Controller CPU Speed: 233 Mhz

3-15Working with Controllers Rescanning a ControllerThe controller rescan operation scans the controller’s channels and verifies the presence of curre

ivCommand Line Interface User’s Guide Displaying a Controller Name 3-8Displaying a Controller’s Type 3-8Displaying a Controller’s Availability 3-9Dis

3-16Command Line Interface User’s Guide You can set a maximum pause of 150 seconds for all I/O activity on the currently opened controller. Note: A co

3-17Working with Controllers Note: The pause_io command is not available in the UNIX environment.To resume a controller’s I/O operations, use the cont

3-18Command Line Interface User’s Guide Caution: The controller deletes any data on the replacement disk when automatic spare is enabled and you remov

3-19Working with Controllers flash image (UFI) files, or to save a controller’s current flash contents to a pair of UFI files.NetRAID-4M controllers u

3-20Command Line Interface User’s Guide Each NetRAID-4M controller requires a different pair of UFI files, since the flash components and contents var

3-21Working with Controllers If the CLI encounters a problem during these integrity checks, it issues an error and does not continue the flash update.

3-22Command Line Interface User’s Guide The following sections describe how to display and, if appropriate, manipulate the channel attributes.Displayi

3-23Working with Controllers Displaying the Maximum Number of Targets on a Channel The targets or devices per channel attribute indicates the maximum

3-24Command Line Interface User’s Guide Displaying a Channel’s SpeedThe channel speed attribute indicates the speed at which a channel is operating. I

3-25Working with Controllers Table 3-3. Battery AttributesDisplaying the Condition of a Controller’s BatteryTo display the condition of the battery, u

vContents Displaying the Revision Number 4-5Displaying the Number of Blocks 4-6Displaying the Bytes per Block 4-6Displaying Disk Usage 4-6Displaying D

3-26Command Line Interface User’s Guide Reconditioning the BatteryTo recondition the battery, use the controller battery_recondition command, as in th

4-1 4Working with DisksThis chapter explains how to use the CLI to manage the disks connected to a RAID controller.In this document, a disk is a rando

4-2Command Line Interface User’s Guide Understanding Disk AttributesDisk attributes are the characteristics of a disk that you can administer or disp

4-3Working with Disks Displaying the SCSI Device ID The SCSI device ID attribute identifies an ID number assigned to each SCSI device attached to a SC

4-4Command Line Interface User’s Guide connected to the controller, which is Disk for device 2:01:0 and 2:02:0.HPN0> disk listExecuting: disk list

4-5Working with Disks the Vendor ID column indicates that ACME is the name of the vendor for device 2:01:0. (Note that the example eliminates some ite

4-6Command Line Interface User’s Guide 2:01:0 Disk N ACME ST39102LW 0006Displaying the Number of BlocksThe number of

4-7Working with Disks controller. To determine the usage of your disks, use the disk list command. Table 4-2 shows the possible disk usage values:Tabl

4-8Command Line Interface User’s Guide from the disk show defects command with the /full switch. The example shows the total number of primary defect

4-9Working with Disks Displaying the Initialization State of a DiskTo determine if the disks attached to a controller are initialized, use the disk li

viCommand Line Interface User’s Guide Adding a Disk to a Diskset 5-12Removing a Disk from a Diskset 5-13Deleting a Diskset 5-15Assigning Diskset Mana

4-10Command Line Interface User’s Guide convenience, you can simplify the specification of the SCSI device ID. Ordinarily, when specifying a CLI comm

4-11Working with Disks C:ID:L Device Type Blocks Bytes/Block Usage Shared------ ----------- --------- ----------- ---------------- -

4-12Command Line Interface User’s Guide Table 4-3. Partition AttributesThe following sections describe how to display and, if appropriate, manipulat

4-13Working with Disks Displaying a Partition’s OffsetThe partition offset attribute indicates the logical distance from the beginning of a disk to th

4-14Command Line Interface User’s Guide Scsi Partition Container MultiLevelC:ID:L Offset:Size Num Type Num Type R/W------ -------------

4-15Working with Disks The CLI also lets you renumber (assign another ID to) a container. See Chapter 9, Modifying Containers, for a description of ho

4-16Command Line Interface User’s Guide C:ID:L Offset:Size Num Type Num Type R/W------ ------------- --- ------ --- ------ ---2:01:0 64.0KB: 10

4-17Working with Disks the R/W column shows that the partitions on SCSI devices (2:01:0) and (2:02:0) are read/write (RW) accessible.HPN0> disk sho

4-18Command Line Interface User’s Guide Scsi Partition Container MultiLevelC:ID:L Offset:Size Num Type Num Type R/W------ -------------

4-19Working with Disks Blinking a Disk LightThe disk blink command causes a disk drive’s activity light to flash or stop flashing. This feature allows

viiContents Understanding Container Usage Attributes 6-24Displaying a Full Compact Snapshot Container 6-25Displaying the Resident File System 6-26Disp

4-20Command Line Interface User’s Guide Understanding S.M.A.R.T. AttributesS.M.A.R.T. attributes are characteristics of the S.M.A.R.T. technology tha

4-21Working with Disks The following sections describe how to display and, if appropriate, set the S.M.A.R.T. attributes.Displaying S.M.A.R.T. Capable

4-22Command Line Interface User’s Guide Set the MRIE of your devicesTo display the MRIE for a device, use the disk show smart command, as in the fo

4-23Working with Disks After setting the MRIE value, use the disk show smart command to verify the MRIE setting. Displaying and Enabling the Exception

4-24Command Line Interface User’s Guide Displaying and Enabling the Exception Control Setting on page 4-23 for further information.Displaying and Ena

4-25Working with Disks Displaying and Enabling Error LoggingThe log errors attribute indicates whether S.M.A.R.T. exception logging is enabled. The CL

4-26Command Line Interface User’s Guide Displaying and Setting the Exception Report IntervalThe interval timer attribute indicates the frequency of S

4-27Working with Disks After setting the S.M.A.R.T. interval timer, use the disk show smart command to verify the exception interval timer setting. Di

4-28Command Line Interface User’s Guide After setting the report count, use the disk show smart command to verify the report count setting.Displaying

5-1 5Working with DisksetsThis chapter explains how to use the CLI to manage disksets. A diskset is a logical grouping of disks used on a clustered sy

viiiCommand Line Interface User’s Guide Working with a Stripe Set 7-6Understanding the Stripe Set Attributes You Can Specify 7-7Understanding How to

5-2Command Line Interface User’s Guide Understanding Diskset AttributesDiskset attributes are the characteristics of a diskset that you can administer

5-3Working with Disksets The following sections describe how to display and, if appropriate, manipulate the diskset attributes.Displaying the Diskset

5-4Command Line Interface User’s Guide Diskset ID column indicates that there is one diskset on the controller. The diskset ID is 0x01be868c1d74a640.

5-5Working with Disksets Displaying the OwnerThe owner attribute indicates the name of the controller that owns the diskset. When you create a diskset

5-6Command Line Interface User’s Guide Displaying the Number of Disks in a DisksetThe disks attribute indicates the number of disks in a diskset. You

5-7Working with Disksets Executing: disk_set list Diskset ID Creator ID Owner------------------- ------------------ ---------

5-8Command Line Interface User’s Guide to a diskset. See Creating a Diskset on page 5-11 for information on creating a diskset. You use the disk_set c

5-9Working with Disksets Displaying if a Diskset is a Member of a Spare PoolThe spare attribute indicates if a diskset is a member of a spare pool. A

5-10Command Line Interface User’s Guide ------ -------- ---------- ---------- ------ -------- -------1 NO NO Saturn YES YES

5-11Working with Disksets Creating a DisksetYou use the disk_set create command to create a diskset. When you create a diskset, you specify the disks

ixContents Working with a Stripe Set of RAID-5 Sets (RAID-50) 8-14Creating Multi-level Volume Sets 8-18Creating a Volume Set of Stripe Sets 8-18Creati

5-12Command Line Interface User’s Guide After running the disk_set create command to create a diskset, use the disk_set list command to display inform

5-13Working with Disksets ------ -------- ---------- ---------- ------ -----2 NO NO Saturn YES NOTo add a

5-14Command Line Interface User’s Guide (2:00:0), (2:01:0), and (2:02:0). Note that the example alters the disk_set list output so that the data can f

5-15Working with Disksets ------------------- ------------------ ------------------0x01be868c1d74a640 0xfafaf001007a1c00 \\.\HPN0 Disks At

5-16Command Line Interface User’s Guide 0x01be868c1d74a640 and whose creator ID is 0xfafaf001007a1c00 is deleted.HPN0>disk_set delete 0x01be868c1d7

5-17Working with Disksets HPN0> disk_set listExecuting: disk_set list Diskset ID Creator ID Owner------------------- -------

5-18Command Line Interface User’s Guide Attaching a DisksetAttaching a diskset makes the diskset available for use by the controller and the host oper

5-19Working with Disksets ------------------- ------------------ ------------------0x01be868c1d74a640 0xfafaf001007a1c00 \\.\HPN0 Disks At

5-20Command Line Interface User’s Guide After running the disk_set detach command to detach a diskset, use the disk_set list command to display inform

5-21Working with Disksets To change a diskset’s label, use the disk_set changelabel command, as in the following example. In the example, the command