HP NetRAID-4M Controller User Manual

HP NetRAID-4M

Flexible Array Storage Tool

Command Line Interface

User’s Guide

HP Part Number 5969-8467

Printed in January 2001

rights are reserved. No part of this document may be photocopied, reproduced, or translated to another language without the prior written consent of Hewlett-Packard Company.

Hewlett-Packard Company Network Server Division Technical Market in g / M S 45S-L E 10955 Tantau Avenue Cupertino, CA 95014 USA

Trademarks

SCSISelect and FAST are trademarks of Adaptec, Inc. which may be registered in some jurisdictions . Windows and Windows 2000 are registered tr ad em arks, and Windows NT is a trade mark of Microsoft Co rporation in the U.S. and other countries used under license. All other trademarks are owned by their respective owner s.

Changes

The information contained in this document is subject to change without notice.

Hewlett-Packard makes no warranty of any kind with regard to this material, including, but not limited to, the implied warranties of merchantability and fitness for a particular purpose. Hewlett-Pa ck ard shall not be liable for errors con t ained

herein or for incidental or consequential damages in connection with the furnishing, performance, or use of th is m a t erial.

Hewlett-Packard assumes no responsibility for the use or reliability of its software on equipment that is not furnished by Hewlett-Packard.

Technical Support and Services

If you have questions about installing or using this product, check this guide first—you will find answers to most of your questions here. If you need further assistance, please contact your server manufacturer.

This user’s guide is for the person who installs, administers, or troublesh oot s LAN ser vers. Hewlett- Packard Company assu mes you are qualified in the s er v icing of computer equipme nt and trained in recogniz i ng hazards in products with haza rdous energy levels.

Disclaimer

IF THIS PRODUCT DIRECTS YOU TO COPY MATERIALS, YOU MUST HAVE PERMISSION FROM THE COPYRIGHT OW NE R OF T HE M ATERIALS TO AVOID VIOLATING THE LAW WHICH COULD RESULT IN DAMAGES OR OTHER REMEDIES.

1 Getting Started

Audience 1-1 Supported Platforms 1-2 Organization 1-2 Conventions 1-4 Related Documentation 1-4

Notes, Cautions, and Warnings 1 -5

Contents

2 Introducing the Comma nd Line Interface

Accessing the CLI from the MS-DOS Prompt 2-1 Accessing the CLI from the Windows NT and Windows 2000

Start Button 2-2

Accessing the CLI from the Flexible Array Storage Tool

Window 2-2 Accessing the CLI from the NetWare Server Console 2-2 Accessing the CLI from the UNIX Prompt 2-3

3 Working with Controllers

Opening and Closing a Controller 3-2

Displaying a List of Available Controllers 3-2 Modes of Opening and Closing a Controller 3-3 Opening and Closing a Controller on NetWare from

Windows NT and Windows 2000 3-4

Understanding Controller Attributes 3-5

Displaying whether a Controller Resides in a Cluster

Environment 3-7

Displaying Cluster Partner Information 3-7

iii

Command Line Interface User’s Guide

Displaying a Controller Name 3-8

Displaying a Controller’s Type 3- 8 Displaying a Controller’s Availability 3-9 Displaying a Remote Com p uter Name 3-9 Displaying a Controller’s Serial Num b er 3-10 Displaying a Controller’s CPU Ty pe 3-10 Displaying the Number of Channels 3-11 Displaying the Number of Devices per Channel 3-12 Displaying a Controller’s CPU Speed 3-12 Displaying Controller Memory 3 -13

Displaying the Controller Firmware Build Number 3-14 Rescanning a Controller 3-15 Pausing and Resuming Controller I/O 3-15 Displaying and Enabling Controller Automatic Spare 3-17 Managing Flash EPROM Components 3-18

Understanding User Flash Image (UFI) Files 3-19 Understanding Channel Attributes 3-21

Displaying a Channel Number 3-22

Displaying a Host Controller ID 3 -22

Displaying the Maximum Number of Targets on a

Channel 3-23 Displaying a Channel’s Type 3-23 Displaying a Channel’s Speed 3-24

Resetting a Channel 3-24 Understanding Batteries 3-24

Displaying the Condition of a Controller’s Battery 3-25 Reconditioning the Battery 3-26

4 Working with Disks

Understanding Disk Attributes 4-2

Displaying the SCSI Device ID 4-3 Displaying Device Types 4-3 Displaying Removable Media 4-4 Displaying the Vendor ID 4-4 Displaying the Product ID 4-5

Displaying the Revision Number 4-5 Displaying the Number of Blocks 4-6 Displaying the Bytes per Block 4-6 Displaying Disk Usage 4-6 Displaying Disk Defects 4-7

Initializing a Disk 4-8

Displaying the Initializa tion State of a Disk 4-9 Initializing a Disk 4-9

Working with a Default SCSI ID 4-9

Displaying the Current Default SCSI Device ID 4-10 Setting a Default SCSI Device ID 4-10

Working with Partitions 4-11

Understanding Partition Attributes 4-11

Verifying a Disk 4-18

Verifying a Disk Without Repai ri ng Bad Blocks 4-18

Verifying a Disk and Repairing Bad Blocks 4-18 Blinking a Disk Light 4-1 9 Working with S.M.A.R.T. Disks 4-19

Understanding S.M.A.R.T. Attributes 4-20

Contents

5 Working with Disksets

Understanding Diskset Attributes 5-2

Displaying the Diskset ID 5-3

Displaying the Creator ID 5-4

Displaying the Owner 5-5

Displaying the Number of Disks in a Diskset 5-6

Displaying the Attached State of a Diskset 5-6

Displaying if a Diskset is Managed by the MS Cl uster

Service 5-7

Displaying a Diskset’s Label 5-7

Displaying if a Diskset Resides on a Controller with a

Shared Channel 5-8 Displaying if a Diskset is a Member of a Spare Pool 5-9 Displaying the Diskset Creation Date and Time 5-9 Displaying Members of a Diskset 5-10

Creating a Diskset 5-11

Command Line Interface User’s Guide

Adding a Disk to a Diskset 5-12 Removing a Disk from a Diskset 5-13 Deleting a Diskset 5-15 Assigning Diskset Ma nagement 5-16 Attaching a Diskset 5-18 Detaching a Diskset 5-19

Changing a Diskset’s Label 5-20 Changing Owne rship of a Diskset 5-21

Taking Ownership of a Diskset 5-22 Forcing Ownership of a Diskset 5-23 Releasing Ownership of a Diskset 5 -24

Changing a Diskset’s Sparepool Assignment 5-26

6 Working with Container Attributes

Understanding Container Identification Attributes 6-2

Displaying, Assigning, and Removing a Drive Letter

(Windows Only) 6-5 Displaying A Root Special File (U NIX Only) 6-6 Displaying and Specifying a Cluster Partner 6-7 Displaying and Renumbering a Container ID 6-9 Displaying and Setting a Container Label 6-11 Displaying and Setting a Container’s Type 6-12 Displaying a Container’s Other Container ID 6-13

Understanding Container Creation Attributes 6-14

Displaying a Container’s Creation Date 6-14 Displaying a Container’s Creation Time 6-15

Understanding Container Size Attributes 6-15

Understanding Freespace 6-17 Displaying and Setting a Container’s Total Size 6-19 Displaying and Setting Stripe S ize 6-19

Understanding Container Access Attributes 6-20

Displaying and Setting a Container’s Read-only

Availability 6-21 Displaying and Setting a Container’s Read/Write

Availability 6-22 Displaying and Setting a Container’s Lock Mode 6-23

Understanding Container Usage Attributes 6-24

Displaying a Full Compac t Snapshot Container 6-25 Displaying the Resident File System 6-26 Displaying a Multi-partition Container 6-27 Displaying a Container that Resides in a NetWa re

Environment 6-27 Displaying the UNIX-Opened Container 6-27 Displaying an Unknown File System 6-28 Displaying an Unmapped Container 6-28 Displaying an Unconfigured Container 6-29 Displaying a Valid Container 6-29

Understanding State Attributes 6-30

Understanding Mirror Set State Attributes 6-30 Understanding Reconfiguration State Attributes 6-31 Understanding Snapshot State Attributes 6-35 Understanding RAID-5 Set State Attributes 6-38

Understanding Container Cache Attributes 6-39

Displaying a Container’s Global Container Read Cache

Size 6-40 Displaying a Container’s Global Container Write Cache

Size 6-41 Displaying a Container’s Read Cache Setting 6-41 Displaying a Container’s Write Cache Setting 6-42 Displaying a Container’s Write Cache Status 6-43

Contents

7 Working With Single-level Containers

Working with a Volume Set 7-2

Understanding the Volume Set Attributes You Can

Specify 7-2 Understanding How to Create a Volume Set 7-4 Understanding Volume Set Creation in a NetWare

Environment 7-5 Understanding Volume Set Creation in a UNIX

Environment 7-6 Identifying Some Tasks to Perform After Creating a

Volume Set 7-6

vii

Command Line Interface User’s Guide

Working with a Stripe Set 7-6

Understanding the Stripe Set Attributes You Can

Specify 7-7 Understanding How to Create a Stripe Set 7-9 Understanding Stripe Set Creation in a NetWare

Environment 7-10 Understanding Stripe Set Creation in a UNIX

Environment 7-10 Identifying Some Tasks to Perform After Creating a

Stripe Set 7-11

Working with a Mirror Set 7-11

Understanding the Mirror Set Attributes You Can

Specify 7-11 Understanding How to Create a Mirror Set 7-13 Understanding Mirror Set Creation in a NetWare

Environment 7-14 Understanding Mirror Set Creation in a UNIX

Environment 7-14 Identifying Some Tasks to Perform After Creating a

Mirror Set 7-14

Working with a RAID-5 Set 7-15

Understanding the RAID-5 Set Attributes You Can

Specify 7-15 Understanding How to Create a RAID-5 Set 7-19 Understanding RAID-5 Set Creation in a NetWare

Environment 7-20 Understanding RAID-5 Set Creation in a UNIX

Environment 7-20 Identifying Some Tasks to Perform After Creating a

RAID-5 Set 7-20

8 Working with Multi-level Containers

Working with Multi-level Stripe Sets 8-2

Working with a Stripe Set of Mirror Sets 8-2 Working with a Stripe Set of Volume Sets 8-6 Creating a Stripe Set of Stripe Sets 8-10

viii

Working with a Stripe Set of RAID-5 Sets (RAID-

50) 8-14

Creating Multi-level Volume Sets 8-18

Creating a Volume Set of Stripe Sets 8-18 Creating a Volume Set of Mirror Sets 8 - 21 Creating a Volume Set of RAID-5 Sets 8-25 Creating a Volume Set of Volume Sets 8-28

Working with Multi-level Contain er’s of Mirror Sets 8-31

9 Modifying Containers

Working with Container Reconfiguration 9-2

Understanding the Container Reconfiguration

Attributes You can Specify 9-2 Understanding How to Reconfigure a Container 9-5 Understanding Container Reconfiguration in a UNIX

Environment 9-6

Working with Container Promotion 9-6

Understanding the Container Promotion Attributes You

can Specify 9-7 Understanding How to Promote a Container 9-7 Understanding Container Promotion in a UNIX

Environment 9-8

Working with Adding a Level to a Container 9-8

Understanding the Container Add Level Attributes You

can Specify 9-8 Understanding How to Add a Level to a Container 9-9 Understanding How to Add a Level to a Container in a

UNIX Environment 9-10

Working with Mirror Sets 9-10

Splitting a Mirror Set 9-10 Unmirroring a Mirror Set 9-12 Scrubbing a Mirror Set 9-14

Working with a RAID-5 Set 9-16

Restoring a RAID-5 Set 9 -1 6 Scrubbing a RAID-5 Set 9-18

Working with the Raw Container Cache 9-20

Contents

Command Line Interface User’s Guide

Working with Enabling the Container’s Vol atile Read-

ahead Cache 9-20

Working with Enabling the Container’s NVRAM Write-

back Cache 9-22

Working with Releasing a Container’s Cache

Buffers 9-25

Working with Container Rebuild 9-27

Assigning Spare Disks to a Single Container 9-27 Removing Spare Disks from a Single Contain e r 9-29 Assigning Global Spare Disks 9-30 Removing Global Spare Disks 9-31

Working with File Systems 9-33

Adding a File System 9-33 Extending a File System 9- 37 Removing a File System 9-39

Extending a Container 9-40

Extending a Volume Set 9 -40 Extending a Multi-level Container of Volume Sets 9-42

Taking a Container Offline 9-44

Understanding the Container Offline Attributes You

Can Specify 9-44

Understanding How to Take a Container Offline 9-44

Deleting a Container 9-45

Understanding the Container Delete At tributes You Can

Specify 9-46 Understanding How to Delete a Container 9-46 Understanding How to Delete a Container in a NetWare

Environment 9-47

10 Working with Snapshot Containers

Creating a Snapshot Container 10-2

Understanding the Create Snapshot Container

Attributes You Can Specify 10-2 Understanding How to Create a Snapshot

Container 10-4

Updating a Snapshot Container 10-7

Understanding the Update Snapshot Container

Attributes that You Can Specify 10-7

Understanding How to Update a Container

Snapshot 10-8

Removing a Snapshot Container 10-9

Understanding the Snapshot Container Remove

Attributes that You Can Specify 10-9

Understanding How to Remove a Container

Snapshot 10-9

Clearing NVRAM of Unconfigured Snapshot

Containers 10-11

Understanding the Controller Free Snapshot Attributes

You Can Specify 10-11

Understanding How to Clear NVRAM of Un configured

Snapshot Containers 10-11

Contents

11 Working with Diagnostic Commands

Understanding Diagnostic Attributes 11-2

Displaying the Interrupt Count 11- 2 Displaying the Interrupt Response Time 11-3

Displaying a Boot-time Pa ra meter 11-4 Dumping Diagnostic Data 11-4 Displaying Internal History Log 11-5 Dumping Data Structures 11-6 Clearing Boot Parameters 11-6 Setting a Boot Parameter 11-7 Setting the Interrupt Count 11-7 Setting the Interrupt Timer 11-8 Loading Containers 11-9

12 Working with Event Notification

Enabling E-Mail Notification 12-2 Understanding Event Notification Attributes 12-2

Displaying the Mail Server 12-3

Displaying the Mail Message Type 12-3

Displaying the Mail To Line 12-4

Command Line Interface User’s Guide

Displaying the Mail Subject Line 12-4 Displaying the Mail Body Line 12-5

Setting the Mail Server 12-5

How to Set the Mail Server 12-6

Setting Mail Message Reporting 12-6

How to Set Mail Message Reporting 12-7

Testing Mail Message Reporting 12-8

How to Test the Mail Server 12-8

Clearing Mail Message Reporting 12-9

How to Clear the Mail Server 12-9

13 Working with Tasks

Understanding Task Attributes 13-1

Displaying the Task ID 13 -2 Displaying the Task Function 1 3-3 Displaying the Task Percent Done 13-3 Displaying the Container ID 1 3-4 Displaying the Task State 1 3-4 Displaying Task Specific1 Information 13-4 Displaying Task Specific2 Information 13-5

Displaying the Task Status 13-5 Starting Tasks 13-6 Stopping Tasks 13-7 Suspending Tasks 13-8 Resuming Tasks 13-9

14 Working with Remote Management

Understanding Remote Management Attributes 14-2

Displaying the Lock Status 14-2

Displaying the Computer Name 1 4-3

Displaying the Remote User Name 14-4

Displaying the Remote User Access Mode 14-4 Scanning for Remote Management Services Agents 14-4 Adding Information to the Remote Connection Database 14-

xii

Locking Information in the Network Connection

Database 14-7

Unlocking Information in the Network Connection

Database 14-8

Deleting Information from the Network Connection

Database 14-10

15 Working with Scripts

Executing a Script 15-1

Executing a Script from the CLI Command Prompt 15-2 Executing a Script from the OS Command Prompt 15-2

Example Scripts 15-6

Example 1 15-6 Example 2 15-7 Example 3 15-8

Contents

Index

xiii

Getting Started

Hewlett-Packard™NetRAID-4M®RAID Controller products integrate advanced RAID technology with state-of-the-art controller hardware to deliver leadership performance, data availability, and storage management features.

To configure and manage components running on the HP NetRAID4M Controller products (hereinafter referred to as the RAID controller), Hewlett-Packard has developed a special sof tware suite. This software suite includes an easy-to-use graphical interface with wizard support--called the Flexible Array Storage Tool (FAST)--and a command line interface (CLI). Currently, FAST is available on Windows NT, Windows 2000 (basic disks only), and NetWare systems. The CLI is available on Windows NT, Windows 2000 (basic disks only), UNIX, and NetWare systems. Controllers on NetWare systems can be remotely managed.

The CLI provides a rich alternative to FAST. The CLI lets you perform most of the storage management tasks that you can perform with the FAST utility and, in addition, lets you perform some tasks not available in FAST. The CLI also allows you to use the CLI commands in DOS command scripts and UNIX shell scripts.

Audience

This user’s guide is written for system administrators and experienced users who are familiar with SCSI device configuration. This guide assumes that you are familiar with the concepts and commands of the operating system your RAID controller is running on. This guide also assumes you are familiar with the conceptual

1-1

Command Line Interface User’s Guide

material related to storage management on RAID controllers presented in the Flexible Array Storage Tool User’s Guide.

This version of the CLI can operate in the Microsoft Cluster Server (MSCS) software environment. If you are using the CLI in the MSCS software environment, the guide assumes you are familiar with:

■ The conceptual information related to MSCS (see th e Micr osoft

documentation associated with MSCS)

■ The tools associated with MSCS (specifically, the Cluster

Administrator)

This guide assumes you are familiar with the conceptual material on how the storage management applications (F AST and the CLI) work in the MSCS software environment. This conceptual material is presented in the Flexible Array Storage Tool User’s Guide.

Supported Platforms

The RAID family of controllers operate on a variety of operating system platforms. See the Installation Guide that wa s supplied with your controller for a list of the supported operating system platforms.

Organization

Chapter 1, Getting Started, provides an overview of this user’s guide, including intended audience, related documents, typographical conventions, and symbols.

Chapter 2, Introducing the Command Line Interface, explains how to start execution of the CLI for the different operating system environments.

Chapter 3, Working with Controllers, describes how to use the CLI to manage a RAID controller. You use controller CLI commands to display the status of a variety of controller attributes and to perform such controller-related tasks as opening, closing, and rescanning controllers and pausing I/O on a controller.

Chapter 4, Working with Disks, explains how to manage disks connected to a RAID controller. This chapter includes information about initializing, and verifying SCSI disks.

1-2

Getting Started

Chapter 5, Working with Disksets, desc ribes how to manage disksets that are part of a clustered system. This includes information on how to create, delete, and modify disksets.

Chapter 6, Working with Container Attributes, explains how to use container attributes, which are characteristics of a container that you administer or display using the CLI. This chapter includes information about how to display, and, if appropriate, manipulate the container attributes.

Chapter 7, Working With Single-level Containers, presents procedures for creating single-level containers. Information is also provided on container-create attributes and tasks that you can perform after you create a container.

Chapter 8, Working with Multi-level Containers, presents procedures for creating multi-level containers. Information is also provided on container-create attributes and tasks that you can perform after you create a container.

Chapter 9, Modifying Containers, explains how to manipulate existing containers. This chapter also describes how to add, extend,

and remove a container’s file system. Chapter 10, Working with Snapshot Containers, provides information

on how to create a snapshot container. This chapter also provides information on how to update and remove a snapshot container.

Chapter 11, Working with Diagnostic Commands, describes how to work with technical support personnel to perform system troubleshooting using the CLI diagnostic commands.

Chapter 12, Working with Event Notification, explains how to use the CLI to enable, display, test, and disable controller event notification messages.

Chapter 13, Working with Task s, describes how to manage tasks running on a controller.

Chapter 14, Working with Remote Management, explains how to use the CLI to locate and open a controller on another computer.

Chapter 15, Working with Scripts, describes how to write and execute automated scripts that can be used to perform a variety of CLI tasks.

1-3

Command Line Interface User’s Guide

Conventions

The following typographical con v entions are used in this user’s guide.

bold Used to highlight information depicted in

examples (for example, the Type column indicates that a RAID-5 set resides on container 0.)

Courier Used to highlight commands in text (for example,

the container create mirror command) and examples:

HPN0> container list Executing: container list No containers found.

In some examples in this document, a vertical line of dots replaces part of a command’s output display to save space on the page, as in the following example:

Device Name: HPN0 Controller Type: HP NetRAID-4M

. . .

Controller Hardware: 1.0

Introducing the Command Line Interface

You can invoke the CLI by doing the following:

■ Accessing the CLI from the MS-DOS Prompt

■ Accessing the CLI from the Windows NT and Windows 2000 Start

Button

■ Accessing the CLI from the Flexible Array Storage Tool Window

■ Accessing the CLI from the NetWare Server Console

■ Accessing the CLI from the UNIX Prompt

The following sections describe each access method.

Note: The CLI displays status information in the title bar of a

DOS command prompt window when it executes an asynchronous command. The status inform ation includes a percent number that indicates percentage completion. Note

that no status information appears in the FAST utility’s CLI window. On NetWare, the status information appears in a different window. On UNIX, the status information appears at the bottom of the CLI window.

Accessing the CLI from the MS-DOS Prompt

To access the CLI from the MS-DOS prompt, enter the afacli command, as in the following example:

C:\afacli

2-1

Command Line Interface User’s Guide

Note: If you specified the path to the afacli executable

program in the System Variables on Windows NT or Windows 2000 (basic disk only), then you do not need to specify the path when running afacli. Otherwise, to run the afacli program, you must change to the directory where the afacli program resides.

Accessing the CLI from the Windo ws NT and Windows 2000 Start Button

To access the CLI from the Windows NT or Windows 2000 Start button, follow these steps.

Note: These steps assume that you accepted the default

location for the software during the installation procedure.

1 Click the Start button a nd m ove the mous e cursor to the

Programs item. The Programs item displays a number of choices (for example, HP NetR aid -4M).

2 Move the mouse cursor to the HP NetRaid-4M item. The HP

NetRaid-4M menu appears.

3 Click on the AfaCli program icon on the HP NetRaid-4M

menu.

Accessing the CLI from the Flexible Array Storage Tool Window

See the Flexible Array Storage Tool User’s Guide for information on accessing the CLI from the FAST window.

Accessing the CLI from the NetWare Server Console

To access the CLI from the NetWare server console, type

hpncli at the prompt.

load

2-2

Introducing the Command Line Interface

Accessing the CLI from the UNIX Prompt

To access the CLI from the UNIX prompt, type hpncli fr o m the command prompt.

❒

2-3

Working with Controllers

This chapter explains how to use the CLI to manage a RAID controller so that you can manage such stor age resources as disks, containers, freespace, partitions, and file systems.

You use controller CLI commands to display the status of a variety of controller attributes and to perform such controller-related tasks as pausing and resuming I/O, and enabl ing or disabling automatic spare.

The following table provides a quick reference to the topics covered in this chapter:

For information about… Turn to...

Opening and Closing a Controller page 3-2 Understanding Controller Attributes page 3-5 Rescanning a Controller page 3-15 Pausing and Resuming Controller I/O page 3-15 Displaying and Enabling Controller Automatic Spare page 3-17 Managing Flash EPROM Components page 3-18 Understanding Channel Attributes page 3-21 Resetting a Channel page 3-24 Understanding Batteries page 3-24

If you open a controller with read/write access, you can use all of the CLI commands, including those commands that change the controller configuration. If you attempt to open a controller in read/write mode, and the controller is already open for read/write

3-1

Command Line Interface User’s Guide

operations, the CLI displays an appropriate message. In this case, you can open the controller for read-only operations.

If you open a controller with read-only access, you can use only the commands that do not change the controller configuration. If you execute a command that is not valid in read-only mode, the CLI displays an appropriate error message.

After you open a controller, you are ready to work with the controller attributes. See Understanding Controller Attributes on page 3-5 for information on how to work with controller attributes and perform controller tasks.

In this chapter, all examples use the controller named HPN0.

Opening and Closing a Controller

Before you can perform operations on a controller, you must first open it. You can open a controller in either snapshot, read/write, or read-only mode on the following operating systems:

■ Windows NT

■ Windows 2000 (basic disks only)

■ NetWare

■ UNIX

The following sections describe how to open and close controllers on the listed operating systems.

Displaying a List of A vailable Cont rollers

Before you open a controller, you may first want to use the controller list command to display a list of controllers, as in the following example. In the example, the Adapter Name column indicates that HPN0 is the name of the controller installed on the

computer. The example also indicates the controller’s path, which is \\.\

HPN0> controller list Executing: controller list

Adapter Name Adapter Type Availability Clustering

------------ ------------ ------------ ---------\\.\HPN0 HP NetRAID-4M read/write No

3-2

Working with Controllers

The CLI allows you to open a controller in the following modes:

■ Read/write

■ Read-only

■ Snapshot

Modes of Opening and Closing a Controller

The CLI allows you to open and close a controller on the supported operating system using the following modes:

■ Read/write

■ Read-only

■ Snapshot

The following sections describe how to open a controller in these three modes and how to close a controller.

Opening a Controller in Read/Write Mode

T o open a contr oller in read/write mode on the supported operating system, use the open command, as in the following example.

HPN0> open HPN0 Executing: open "HPN0"

Opening a Controller in Read-only Mode

To open a controller in read-only mode on the supported operating system, use the open command with the /readonly switch, as in the following example.

HPN0> open /readonly=TRUE HPN0 Executing: open /readonly=TRUE "HPN0"

If after opening a contr oller in read- only mode, you decide you want write access to that controller, you can do so without closing and reopening the controller. Simply specify the open command with the /readonly switch set to FALSE, as in the following example:

HPN0> open /readonly=FALSE HPN0 Executing: open /readonly=FALSE "HPN0"

3-3

Command Line Interface User’s Guide

Opening a Controller in Snapshot Mode

A snapshot is an instantaneous read-only copy of a container "snapped" at a precise point in time. Automated backup scripts can take advantage of the snapshot feature. The open command provides a snapshot mode that allows an automated backup script to work even if other users have the CLI open somewhere on the network. Note that when you open a controller in snapshot mode, you can use only the read-only related commands and the commands related to the snapshot feature. See W orking with Sna pshot Containers on page 10-1 for further information on the Snapshot feature.

To open the HPN0 controller in snapshot mode, use the open command with the /snapshot switch, as in the following example.

HPN0> open /snapshot=TRUE HPN0 Executing: open /snapshot=TRUE "HPN0"

Closing a Controller

To close an open controller on the supported operating system, use the close command, as in the following example:

HPN0> close Executing: close

A controller can also be closed by exiting from the CLI using the

exit command, as in the following example:

HPN0> exit Executing: exit

Note: The close and exit commands are not available

when accessing the CLI through FAST.

Opening and Closing a Controller on NetWare from Windows NT and Windows 2000

Before you open a controller on a NetWare system from Windows NT or Windows 2000 (basic disk only), you may want to display a list of controllers on the NetWare system. To display a list of controllers, use the controller list command with the /domain switch, as in the following example. In the example, D1 is

3-4

Working with Controllers

the domain name for the NetWare system. The Adapter Name column indicates that HPN0 is the name of the con troller installed

on the computer. The example also indicates the controller’s path, which is \\.\

HPN0> controller list /domain=D1 Executing: controller list /domain=D1

Adapter Name Adapter Type Availability Clustering

------------ ------------ ------------ ---------\\.\HPN0 HP NetRAID-4M read/write No

To open a controller on a NetWare system from Windows NT or Windows 2000 (basic disk only), use the open command with the /netware and /domain switches, as in the following example. In the example, the HPN0 controller is opened in the D1 domain on a NetWare system.

HPN0> open /netware /domain=D1 \\D1\HPN0

To close an open controller, use the close command, as in the following example:

HPN0> close

A controller can also be closed by exiting from the CLI using the

exit command, as in the following example.

HPN0> exit

After you open a controller, you are ready to work with the controller attributes.

Understanding Controller Attributes

Controllers exhibit a number of attributes or characteristics that you can administer or display using the CLI. The CLI supports two commands that provide information about the controller: controller list and controller details. T a ble 3-1 lists the controller attributes and their related CLI commands.

3-5

Command Line Interface User’s Guide

Table 3-1. Controller Attributes

Controller Attribute

controller cluster environment

cluster partner Display controller

controller name (also called device

name)

controller type Display controller

controller availability

controller remote computer

controller serial number

controller’s CPU type

number of channels

number of devices per channel

CLI Operations

Display controller

Related Commands Discussed In...

list

details

list controller

details

list controller

details

list controller

details

Displaying whether a Controller Resides in a Cluster Environment

Displaying Cluster Partner Information

Displaying a Controller Name

Displaying a

Controller’s Type

Displaying a Controller’s Availability

Displaying a Remote Computer Name

Displaying a Controller’s Serial Number

Displaying a

Controller’s CPU Type

Displaying the Number of Channels

Displaying the Number of Devices per Channel

3-6

+ 306 hidden pages