XM Satellite Radio AA-RU5HC-TE User Manual

Reference

Guide

hp StorageWorks

Storage System Scripting Utility

Command View EVA

Product Version: 3.2

Fifth Edition (July 2004)

Part Number: AA-RU5HC-TE

This guide describes the commands available in the Storage System Scripting Utility (SSSU) for Command View EVA. These commands configure and control HSV controllers.

the implied warranties of merchantability and fitness for a particular purpose. Hewlett-Packard shall not be liable for errors contained herein or for incidental or consequential damages in connection with the furnishing, performance, or use of this material.

This document contains proprietary information, which is protected by copyright. No part of this document may be photocopied, reproduced, or translated into another language without the prior written consent of Hewlett-Packard. The information contained in this document is subject to change without notice.

Compaq Computer Corporation is a wholly-owned subsidiary of Hewlett-Packard Company. Adobe® and Acrobat® are trademarks of Adobe Systems Incorporated. Intel® and Celeron® are U.S. registered trademarks of Intel Corporation. Intel® and Itanium® are trademarks or registered trademarks of Intel Corporation in the U.S. and other countries

and are used under license. Intel® Itanium™ Processor Family is a trademark in the U.S. and other countries and is used under license. Microsoft®, MS-DOS®, MS Windows®, Windows®, and Windows NT® are U.S. registered trademarks of

Microsoft Corporation. Oracle® is a registered U.S. trademark of Oracle Corporation, Redwood City, California. UNIX® is a registered trademark of The Open Group. Hewlett-Packard Company shall not be liable for technical or editorial errors or omissions contained herein. The

information is provided “as is” without warranty of any kind and is subject to change without notice. The warranties for Hewlett-Packard Company products are set forth in the express limited warranty statements for such products. Nothing herein should be construed as constituting an additional warranty.

Printed in the U.S.A.

Command View EVA Storage System Scripting Utility Reference Guide Fifth Edition (July 2004) Part Number: AA-RU5HC-TE

About this Guide. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .7

Intended audience. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8

Related documentation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9

Conventions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10

Document conventions. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10

Text symbols . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10

Getting help . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12

HP technical support . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12

HP storage web site . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12

HP authorized reseller . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12

1 Introduction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .13

Description . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14

Formatting and output of returned data . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14

Installing the Storage System Scripting Utility . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15

Installing the HP-UX kit . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15

To execute SSSU. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16

Installing the IBM Host Kit . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16

LINUX . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17

Novell NetWare . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17

OVMS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18

SUN . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18

TRU64 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19

To execute SSSU. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 20

WINDOWS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 20

Starting the Storage System Scripting Utility. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21

Syntax. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21

Examples . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21

Understanding paths and naming conventions. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 23

Cross Vraid . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 26

Contents

3Command View EVA Storage System Scripting Utility Reference Guide

Contents

2 SSSU Command Reference . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .27

Command introduction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 28

ADD . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 29

ADD COPY . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 30

ADD DR_GROUP . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 32

ADD DISK_GROUP . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 34

ADD FOLDER . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 36

ADD HOST . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 37

ADD LUN . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 39

ADD SNAPSHOT . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 40

ADD SYSTEM. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 42

ADD VDISK . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 44

CAPTURE CONFIGURATION . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 49

CAPTURE VALIDATE. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 52

DELETE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 53

DELETE DR_GROUP. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 54

DELETE DISK_GROUP . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 55

DELETE FOLDER. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 56

DELETE HOST . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 57

DELETE LUN . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 58

DELETE SYSTEM . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 59

DELETE VDISK . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 60

EMVERSION. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 62

EXERCISE_DISK . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 63

EXIT . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 64

FILE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 65

HELP . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 66

REDISCOVER . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 67

RESTART. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 68

SELECT . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 69

SELECT MANAGER . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 70

SELECT SYSTEM. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 71

SET . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 72

SET DR_GROUP. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 73

SET DISK. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 76

SET DISK_GROUP . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 77

SET FOLDER. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 79

SET HOST . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 80

4 Command View EVA Storage System Scripting Utility Reference Guide

Contents

SET MONITOR . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 82

SET OPTIONS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 83

SET SYSTEM . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 86

SET VDISK . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 87

SHOW. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 90

SHOW DR_GROUP . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 91

SHOW DISK . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 92

SHOW DISK_GROUP. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 93

SHOW HOST . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 94

SHOW LUN . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 95

SHOW MANAGER . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 96

SHOW MONITOR. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 97

SHOW OPTIONS. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 98

SHOW POWER . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 99

SHOW SYSTEM . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 100

SHOW VDISK . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 101

SHOW WORLD_WIDE_NAME. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 102

SHUTDOWN . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 103

2 Configuration Examples . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .105

Creating a simple configuration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 106

Creating the storage system . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 106

Creating and presenting a virtual disk . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 108

Using the SHOW commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 110

SHOW SYSTEM . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 110

SHOW VDISK. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 111

SHOW HOST. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 112

SHOW LUN. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 113

A Glossary. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .115

Index . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .125

Tables

1 Document Conventions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7

5Command View EVA Storage System Scripting Utility Reference Guide

Contents

6 Command View EVA Storage System Scripting Utility Reference Guide

about this

guide

This reference guide describes the HP StorageWorks Storage System Scripting Utility (SSSU) commands.

“About this guide” topics include:

■ Intended audience, page 8

■ Related documentation, page 9

■ Conventions, page 10

■ Getting help, page 12

About this Guide

7Command View EVA Storage System Scripting Utility Reference Guide

About this Guide

Intended audience

This guide is intended for storage administrators who are experienced with the following:

■ Enterprise Virtual Array v2.006, v3.0, v3.010, v3.014, and v3.020

■ Configuration of SAN fabrics

■ HP-UX, HP Open VMS, HP Tru64, Microsoft Windows, Sun Solaris, IBM

AIX, Novell Netware, and Linux AS and SLES8 operating systems

8 Command View EVA Storage System Scripting Utility Reference Guide

Conventions

Conventions consist of the following:

■ Document conventions

■ Text symbols

Document conventions

The document conventions included in Tabl e 1 apply in most cases.

Table 1: Document conventions

Cross-reference links Blue text: Figure 1 Key and field names, menu items,

buttons, and dialog box titles File names, application names, and text

emphasis User input, command and directory

names, and system responses (output and messages)

Variables

Web site addresses

Element Convention

Bold

Italics

Monospace font COMMAND NAMES

monospace font unless they are case sensitive

are uppercase

<monospace, italic font>

Blue, underlined sans serif font text:

http://www.hp.com

Text symbols

The following symbols may be found in the text of this guide. They have the following meanings.

WARNING: Text set off in this manner indicates that failure to follow

directions in the warning could result in bodily harm or death.

10 Command View EVA Storage System Scripting Utility Reference Guide

About this Guide

Caution: Text set off in this manner indicates that failure to follow directions

could result in damage to equipment or data.

Note: Text set off in this manner presents commentary, sidelights, or interesting points

of information.

Command View EVA Storage System Scripting Utility Reference Guide

About this Guide

Getting help

If you still have a question after reading this guide, contact an HP-authorized service provider or access our web site:

HP technical support

Telephone numbers for worldwide technical support are listed on the following HP web site: of origin.

Note: For continuous quality improvement, calls may be recorded or monitored.

Be sure to have the following information available before calling:

■ Technical support registration number (if applicable)

■ Product serial numbers

■ Product model names and numbers

■ Applicable error messages

http://www.hp.com

http://www .hp.com/support/

. From this web site, select the country

■ Operating system type and revision level

■ Detailed, specific questions

HP storage web site

The HP web site has the latest information on this product as well as the latest drivers. Access storage at:

http://www.hp.com/country/us/eng/p rodserv/storage.html

. From this web site,

select the appropriate product or solution.

HP authorized reseller

For the name of your nearest HP-authorized reseller:

■ In the United States, call 1-800-345-1518

■ In Canada, call 1-800-263-5868

■ Elsewhere, see the HP web site for locations and telephone numbers:

http://www .hp .com

12 Command View EVA Storage System Scripting Utility Reference Guide

Introduction

This chapter introduces the HP StorageWorks Enterprise Storage System Scripting Utility (SSSU) for the HP StorageWorks Enterprise Virtual Array. The following topics are covered:

■ Description, page 14

■ Installing the Storage System Scripting Utility, page 15

■ Starting the Storage System Scripting Utility, page 21

■ Understanding paths and naming conventions, page 23

■ Cross Vraid, page 26

13Command View EVA Storage System Scripting Utility Reference Guide

Introduction

Description

The Storage System Scripting Utility (SSSU) for Enterprise Virtual Array is a command line application that allows you to configure and control EVA 3000 and 5000 controllers.

You can execute configuration requests using Command View EVA or SSSU. Command View EVA is the graphical user interface that allows you to control and monitor a storage system. Use Command View EVA to handle simple or initial configuration tasks easily and expediently. Use SSSU to script and run repetitious and complex configuration tasks.

Formatting and output of returned data

All returned SHOW command data is formatted in the form of:

XMLtag : Data

The XML tag displays before the data, and then the tag’s data displays.

14 Command View EVA Storage System Scripting Utility Reference Guide

Installing the Storage System Scripting Utility

The following procedures assume that you have loaded the Web kit to a CD-ROM.

SSSU is installed from your Enterprise Virtual Array host operating system kits. Refer to Chapter 2 in your Enterprise Virtual Array Installation and Configuration Guide for detailed instructions for installing SSSU.

Once installed, SSSU can run as a simple executable. For convenience, you can add the directory containing the SSSU executable to your path or copy the executable to a directory already in your path. Ensure that the SSSU executable’s attributes are set with the correct security and execution flags appropriate for your environment.

The executable file is named sssu or SSSU.EXE depending on the operating system environment.

Depending on your operating system and workstation, follow one of the procedures below to install SSSU.

Installing the HP-UX kit

1. If you are re-installing SSSU, remove the older version with the command:

# swremove SSSU

2. Find the CD-ROM device (c3t2d0 in the example shown in step 3) by entering:

# ioscan -fnuCdisk

Class I H/W Path DriverS/W State H/W Type Description

==========================================================

disk 33 8/4.5.0 sdisk CLAIMED DEVICE SEAGATE ST32550W

/dev/dsk/c0t5d0 /dev/rdsk/c0t5d0

disk 3 8/16/5.2.0 sdisk CLAIMED DEVICE TOSHIBA CD-ROM

XM-5401

/dev/dsk/c3t2d0 /dev/rdsk/c3t2d0

disk 4 8/16/5.4.0 sdisk CLAIMED DEVICE DEC RZ29B (C) D

/dev/dsk/c3t4d0 /dev/rdsk/c3t4d0

Introduction

15Command View EVA Storage System Scripting Utility Reference Guide

Introduction

3. Mount the CD-ROM with the command:

# mount /dev/dsk/c3t2d0 /cdrom

4. Copy the depot file from the CD-ROM to a temporary directory on the host system.

# cp /cdrom/sssu_v7_hpux.depot /tmp

5. Enter the following command to run the installation program (swinstall):

# swinstall -s /tmp/sssu_v7_hpux.depot

The SSSU executable is installed in the following directory:

#/sbin

To execute SSSU

■ Command line version, type

#sssu

Installing the IBM Host Kit

The IBM AIX Kit v3.0e for Enterprise Virtual Array installs the supported FCA driver and the Storage System Scripting Utility (SSSU).

The HSV controllers can be configured with SSSU as an alternative to the Command View EVA Element Manager. SSSU allows a command line interface for issuing commands directly to the controller. Complex configuration requests and operations can be handled by either the Command View EVA Element Manager or SSSU. Simple or initial configuration requests can be handled easily and expediently through the element manager, but repetitious and complex configuration steps can be scripted and executed through the command line interface.

The CAPTURE CONFIGURATION command is the only way to capture, save, and recreate a storage system’s configuration.

The following section describes how to install and uninstall the IBM AIX Kit, including the Secure Path driver on the IBM AIX host server. The Secure Path driver is necessary for your IBM AIX server to interact with the Enterprise Virtual Array.

1. Mount the AIX platform kit.

2. Go to the /aix_spec directory.

16 Command View EVA Storage System Scripting Utility Reference Guide

3. Execute the command

LINUX

If you have already installed the FCA drivers, you can choose to install just the SSSU.

1. Mount the CD-ROM.

2. Change to the RPMS directory.

3. Enter the following command:

Novell NetWare

The HSV controllers can be configured with SSSU. SSSU provides a command line interface for issuing commands directly to the controller. Complex configuration requests and operations can be handled by SSSU. Repetitious and complex configuration steps can be scripted and executed through the command line interface.

Introduction

installp -acd sssu-v31.rte all

rpm -ivh sssu-<version>.rpm

Note: The CAPTURE CONFIGURATION command is the only way to capture, save,

and recreate a storage system’s configuration.

Follow this procedure to install the SSSU application.

Note: You must use a Windows NT/2000 client, not a NetWare server, to install the

SSSU.

1. Insert the Novell NetWare Kit v3.0e for Enterprise Virtual Array CD-ROM.

2. Copy the SSSU.NLM file to the system directory on the server where you will be running the utility. You can copy the file from a client, or on the server, with the Console One file utitility.

17Command View EVA Storage System Scripting Utility Reference Guide

Introduction

OVMS

1. Remove the currently installed version of SSSU by entering the following command

$ Product remove product SSSU

2. Insert the OpenVMS Kit v3.0e for Enterprise Virtual Array CD-ROM.

3. Copy the self-extracting executable file SSSUVxBLDxx.exe from the CD-ROM to a temporary directory on the host system.

4. Enter the following command to extract the file:

$ run SSSUVxBLDxx

The following file is extracted:

HP-ALPHA-SSSU-V0x00-xx-1.PCSI

Note: The xx designations in the SSSUVxBLDxx command and extracted

HP-ALPHA-SSSU-V0x00-xx-1.PCSI file indicate the latest build number.

5. Use the PolyCenter Software Installation program to install SSSU with the command:

$ product install sssu

6. Follow the instructions to complete the installation. The SSSU executable is installed in the following directory by default:

sys$system

SUN

If you have already installed the FCA drivers, you can choose to install just the SSSU.

1. Follow the steps in the normal installation.

2. Choose the manual option.

3. Follow the instructions and select just the CPQhsv package. The SSSU executable is installed in the following directory by default:

/opt/CPQhsv/bin

18 Command View EVA Storage System Scripting Utility Reference Guide

TRU64

Introduction

Note: This is the default installation directory, which the user may alter during the

installation process. If you have used a different installation directory, the path would be

/<BASE_DIR>/CPQhsv/bin.

1. Insert the Tru64 UNIX Kit v3.0e for Enterprise Virtual Array CD-ROM.

2. Enter the following command to extract the file (for v5.x):

# mount –r –t cdfs –o rrip /dev/disk/cdrom0c /mnt

Note: Substitute your CD-ROM device for cdrom0c, if necessary.

3. Change directories on the CD-ROM by entering:

# cd /mnt

4. Enter the following command to run the installation program:

# setld –l .

Note: The –l is a lowercase L.

The installation asks whether you want to install the listed subsets.

5. Enter the corresponding number of the software and press Return.

6. Select option y and press Return. The SSSU executable is installed in the following directory:

#/usr/opt/ENTP003/sbin

Another method for installing SSSU is as follows.

1. Create a temporary directory on the Tru64 system.

2. Copy the file from the Web to the temporary directory.

3. Change the directory to the temp directory:

# tar -xvf filename.tar # setld –l.

19Command View EVA Storage System Scripting Utility Reference Guide

Introduction

To execute SSSU

In the command line version, type:

WINDOWS

You can run SSSU directly from the CD-ROM. The SSSU executable is located in the SSSU directory on the CD-ROM. Also, you can copy the executable to your server and run it from a directory of your choosing.

1. Start the Window NT/2000/Server 2003 Kit v3.0e for Enterprise Virtual

2. Click the Solution Software for Windows NT/2000/Server 2003 button on

3. Click the Install Storage System Scripting Utility (SSSU) button on the

The SSSU executable is installed in the following directory:

#/usr/opt/ENTP003/sbin

#sssu

Array kit. If you have created a CD-ROM and if autorun is enabled, the installation program starts automatically. Otherwise, navigate to the root of the kit and double-click Launch.exe.

the first screen.

bottom of the second screen. The installation wizard starts.

4. Follow the instructions to complete the installation.

20 Command View EVA Storage System Scripting Utility Reference Guide

Starting the Storage System Scripting Utility

SSSU starts at a command prompt window, shell, or equivalent.

Note: To run SSSU, you must set up password access to the element manager

from the management appliance. You cannot set this password from within

The SET OPTIONS command on page 83 controls how SSSU behaves. The

SSSU.

options you set with the SET OPTIONS command are in effect for the current session only. Each time you start SSSU, the default options are reinstated.

Note: The CAPTURE CONFIGURATION command on page 49 is the only way to

capture, save, and recreate a storage system’s configuration. After you have successfully created a storage system, use the CAPTURE CONFIGURATION command to create scripts that you can use to recreate a storage system in the event of failure or to create an exact replica.

Syntax

Introduction

Examples

SSSU <additional arguments>

If SSSU is started without arguments, a generic application <NoSystemSelected> prompt is displayed on the terminal and input can be accepted.

If SSSU is started with arguments, those commands are echoed to the input terminal and executed, and then the utility exits.

Note: You must enclose in double quotes any commands or object names that have

embedded blanks (spaces).

SSSU

SSSU “FILE snapD1.txt”

SSSU “cmd1” “cmd2” “cmd2”

The first example starts SSSU without additional arguments and prompts you for commands.

21Command View EVA Storage System Scripting Utility Reference Guide

Introduction

The second example starts SSSU and then executes the file snapD1.txt from the current directory.

The third example starts SSSU and executes multiple commands.

22 Command View EVA Storage System Scripting Utility Reference Guide

Understanding paths and naming conventions

This section describes important information about paths and naming conventions in SSSU.

Introduction

Note: For detailed descriptions of the following commands, refer to Chapter 2.

The following important root folders let you organize your storage system:

■ “\Hosts\”

■ “\Virtual Disks\”

■ “\Disk Groups\”

■ “\Data Replication\”

■ “\Hardware\” - This folder exists within SSSU; however, you cannot

create any objects within this folder.

You cannot create root-level folders. You can, however, create additional folders within the “\Hosts\” and “\Virtual Disks\” folders to organize your storage system (see “ADD FOLDER”on page 36).

Note: SSSU requires that you qualify specified names with full paths. If, however, you

are using the default placement when adding Hosts and Virtual Disks, you do not need to include the full path.

Hosts Examples

For example, to add a host named engineering to the root Hosts folder:

ADD HOST engineering WORLD_WIDE_NAME=1111-2222-3333-4444

Whenever you refer to this host, you must give the full path. For example, when adding a LUN to this host:

ADD LUN 4 HOST=\Hosts\engineering VDISK="\Virtual Disks\Yekao\ACTIVE"

23Command View EVA Storage System Scripting Utility Reference Guide

Introduction

If you create a folder structure within the root Hosts, you must include all levels of the folder structure in your commands.

Here is an example of how to add the engineering host to the resources folder within the Host root folder:

ADD HOST \Hosts\resources\engineering WORLD=1111-2222-3333-4444

Virtual Disk Example

Because of the space in the root name for the Virtual Disks folder, you must always enclose strings that include the name of this folder within double quotes (“”).

Note: Remember to include full paths for objects and enclose any paths that contain

spaces in double quotes.

For example, to add a virtual disk family new_code to the root folder Virtual Disks:

ADD VDISK “\Virtual Disks\new_code” SIZE=10

This example creates a 10-GB virtual disk family in the default disk group

new_code.

Note: This is a virtual disk family. The actual virtual disk name (the active virtual disk)

is \Virtual Disk\new_code\ACTIVE.

If you create a virtual disk (ADD VDISK) within a deeper folder structure, you need to include this full path within double quotes.

ADD VDISK “\Virtual Disks\engineering\gene_research” SIZE=2

Disk Groups Example

When a path includes the root folder “\Disk Groups\”, you must enclose the entire path in double quotes:

SHOW DISK_GROUP “\Disk Groups\admin”

ADD VDISK “\Virtual Disks\new_code” SIZE=10 DISK_GROUP=“\Disk Groups\admin”

24 Command View EVA Storage System Scripting Utility Reference Guide

Introduction

Note: Although this guide shows commands spanning more than one line, always

enter the SSSU command on one line.

Note on OS_UNIT_ID and CONSOLE_LUN_ID

This value is used for IBM AIX (set to zero), OpenVMS (required), and Tru64 UNIX (recommended). Other host operating systems ignore the value. See the host operating system installation guides for more information.

Note on changing comments on a disk enclosure

SSSU does not allow comments to be changed on a disk enclosure. Anyone needing to do this can change them using the CommandView EVA UI.

25Command View EVA Storage System Scripting Utility Reference Guide

Introduction

Cross Vraid

Cross Vraid for Snapshot and Snapclone allow customers to change the Vraid type when creating snapshots or snapclones for better disk utilization when making redundant copies of data. Cross Vraid is supported in the following manner:

■ Cross Vraid Snapshot (ADD SNAPSHOT) and Snapclones (ADD COPY)

within the same disk group.

■ Cross Vraid Snapclones (ADD COPY) across disk groups (including standard

and FATA disk groups)

The SSSU v3.2 and Command View EVA v3.2 along with VCS v3.020 are required to support Cross Vraid Snaps.

Refer to ADD COPY and ADD SNAPSHOT for more information.

26 Command View EVA Storage System Scripting Utility Reference Guide

SSSU Command Reference

This chapter defines all the commands available in SSSU, including:

■ ADD, page 29

■ CAPTURE CONFIGURATION, page 49

■ DELETE, page 53

■ EMVERSION, page 62

■ EXIT, page 64

■ FILE, page 65

■ HELP, page 66

■ RESTART, page 68

■ SELECT, page 69

■ SET, page 72

■ SHOW, page 90

■ SHUTDOWN, page 103

In addition, this chapter includes syntax and examples. The commands are presented in alphabetical order.

27Command View EVA Storage System Scripting Utility Reference Guide

SSSU Command Reference

Command introduction

Most of the commands have switches that you can also use. These are described under the entry for the command in this chapter.

You can display a list of switches for each command directly within the interface by entering a ? after the command or option name. For example, ADD ? displays all of the switches available with the ADD command, and ADD SYSTEM ? displays the switches available for the ADD SYSTEM command (see “Getting

help” on page 12).

Remember when you issue commands:

■ Use the full path to qualify specified names.

■ If a path name contains a space, enclose the entire name in double quotes (“”).

For a full discussion of these requirements, see “Understanding paths and naming

conventions” on page 23. Appendix A, “Configuration Examples,” provides a simple configuration example

for using these commands to create and present a single LUN to a host. It also includes sample output from SHOW commands.

Note: Commands are not case sensitive, and it is often not necessary to type complete

command names. For example, you can type sho for SHOW or shu for SHUTDOWN.

28 Command View EVA Storage System Scripting Utility Reference Guide

ADD

SSSU Command Reference

Use the ADD commands to create new systems, folders, disk_groups, dr_groups, virtual disks, copies, snapshots, as well as to add LUNs and hosts within the Enterprise Virtual Array.

Note: Creating copies, dr_groups, and snapshots of virtual disks is dependent on your

licensing level. See the documentation that came with your hardware for more information.

29Command View EVA Storage System Scripting Utility Reference Guide

SSSU Command Reference

ADD COPY

Use the ADD COPY command to create a copy of the specified virtual disk. A copy is a new virtual disk family. The ADD COPY command is equivalent to creating a snapclone within Command View EVA.

Syntax

ADD COPY <copy_name> VDISK=<vdisk_family>

Switches

The following switches are available with the ADD COPY command.

DISK_GROUP=

This is the name of the disk group where you want to create the virtual disk copy. The disk group must already exist to use this switch. If not specified, SSSU uses the same group as the source VDISK.

OS_UNIT_ID=

The ID that is presented to the host operating system. If set to zero, no ID is presented to the host.

REDUNDANCY=

The amount of data protection set when creating the virtual disk. If not specified, the default is Vraid0.

■ Vraid0—Provides no data protection. It distributes data among its member

disks into stripes and uses all members to process I/O requests. This method has no overhead associated with duplication of information and provides the highest performance.

■ Vraid1—Provides the highest level of data protection but uses the most

space. It duplicates data written to one disk onto a backup disk. In a multidisk configuration, Vraid1 mirrors each pair of disks to each other. These disk pairs can then be striped to create a virtual disk.

■ Vraid5—Provides a moderate level of data protection. This method

distributes the parity information among all disk members. If one drive fails, the failed disk can be recreated after it is replaced.

30 Command View EVA Storage System Scripting Utility Reference Guide

+ 100 hidden pages

XM Satellite Radio AA-RU5HC-TE User Manual

contents

About this Guide

Intended audience

Related documentation

Conventions

Document conventions

Table 1: Document conventions

Text symbols

Getting help

HP technical support

HP storage web site

HP authorized reseller

Introduction

Description

Formatting and output of returned data

Installing the Storage System Scripting Utility

Installing the HP-UX kit

To execute SSSU

Installing the IBM Host Kit

LINUX

Novell NetWare

OVMS

TRU64

To execute SSSU

WINDOWS

Starting the Storage System Scripting Utility

Syntax

Examples

Understanding paths and naming conventions

Hosts Examples

Virtual Disk Example

Disk Groups Example

Note on OS_UNIT_ID and CONSOLE_LUN_ID

Note on changing comments on a disk enclosure

Cross Vraid

SSSU Command Reference

Command introduction

ADD COPY

Syntax

Switches

DISK_GROUP=

OS_UNIT_ID=

REDUNDANCY=