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.
© Copyright 1998-2004 Hewlett-Packard Development Company, L.P. Hewlett-Packard Company 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-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.
contents Contents About this Guide. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .7 Intended audience . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8 Related documentation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9 Conventions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Contents 2 SSSU Command Reference . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .27 Command introduction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 28 ADD . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 29 ADD COPY . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Contents SET MONITOR . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 82 SET OPTIONS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 83 SET SYSTEM . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 86 SET VDISK . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Contents 6 Command View EVA Storage System Scripting Utility Reference Guide
about this guide About this Guide This reference guide describes the HP StorageWorks Storage System Scripting Utility (SSSU) commands.
About this Guide Intended audience This guide is intended for storage administrators who are experienced with the following: 8 ■ Enterprise Virtual Array v2.006, v3.0, v3.010, v3.014, and v3.
About this Guide Related documentation This section lists documents that provide additional information: ■ HP StorageWorks Host Operating System Kit for Enterprise Virtual Array Installation and Configuration Guide (available for Sun Solaris, IBM AIX, Windows, Tru64 UNIX, OpenVMS, HP-UX, Novell Netware, and Linux operating systems) ■ HP StorageWorks Enterprise Virtual Array Users Guide ■ HP StorageWorks Enterprise Virtual Array - How to Get More Information ■ HP StorageWorks Enterprise Virtual Array
About this Guide Conventions Conventions consist of the following: ■ Document conventions ■ Text symbols Document conventions The document conventions included in Table 1 apply in most cases.
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.
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: http://www.hp.com. HP technical support Telephone numbers for worldwide technical support are listed on the following HP web site: http://www.hp.com/support/. From this web site, select the country of origin. Note: For continuous quality improvement, calls may be recorded or monitored.
Introduction 1 This chapter introduces the HP StorageWorks Enterprise Storage System Scripting Utility (SSSU) for the HP StorageWorks Enterprise Virtual Array.
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.
Introduction 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.
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.
Introduction 3. Execute the command installp -acd sssu-v31.rte all 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: rpm -ivh sssu-.rpm 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.
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.
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 //CPQhsv/bin. TRU64 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.
Introduction The SSSU executable is installed in the following directory: #/usr/opt/ENTP003/sbin To execute SSSU In the command line version, type: #sssu 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 Array kit.
Introduction 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 SSSU.The SET OPTIONS command on page 83 controls how SSSU behaves. The 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.
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.
Introduction Understanding paths and naming conventions This section describes important information about paths and naming conventions in SSSU. Note: For detailed descriptions of the following commands, refer to Chapter 2. hi 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.
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 (“”).
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.
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.
SSSU Command Reference 2 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.
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).
SSSU Command Reference ADD 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.
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 VDISK= 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.
SSSU Command Reference VDISK= This is the virtual disk name to be copied. WORLD_WIDE_LUN_NAME= Sets the World Wide LUN Name on unpresented storage. WAIT_FOR_COMPLETION Waits until the command’s operation completes before displaying the next SSSU prompt (and returning control) or before running another script line. For large (greater than 1 TB) virtual disks, using this option can result in a long period before the prompt displays. NOWAIT_FOR_COMPLETION Default. Returns control as soon as possible.
SSSU Command Reference ADD DR_GROUP Use the ADD DR_GROUP command to create a data replication group containing the specified source virtual disk. This source VDisk will be replicated on the specified destination system. Syntax ADD DR_GROUP VDISK= DESTINATION SYSTEM= Switches The following switches are available with the ADD DR_GROUP. ACCESSMODE= The access rights for a connected host. Possible values are readonly and disable.
SSSU Command Reference VDISK= The name of a source system VDISK to be placed within the DR Group. A destination VDISK is automatically created on the destination system. WRITEMODE= Defines the I/O interaction between the destination and source side. Possible values are synchronous and asynchronous. The default is synchronous. Required Switches The following switches are required for the ADD DR_GROUP command.
SSSU Command Reference ADD DISK_GROUP Use the ADD DISK_GROUP command to add disk groups to the system. Caution: Vraid1 and Vraid5 are virtual disk families that have a SINGLE or DOUBLE group spare policy to ensure that there is adequate space to regenerate data. If you set the spare policy to NONE, the disk group may not have enough available space to regenerate Vraid1 and Vraid5 data. Syntax ADD DISK_GROUP Switches The following switches are available with the ADD DISK_GROUP command.
SSSU Command Reference OCCUPANCY_ALARM= The point when a defined percentage of space is used. When this point is reached, an event log is generated and sent to the Management Appliance (optionally the host system) informing the administrator that the group is becoming full. Do not use the percentage sign (%) after the number. The default is 95%. SPARE_POLICY= This parameter determines the amount, if any, of storage space set aside for use in the event that disks fail. The default is single.
SSSU Command Reference ADD FOLDER Use the ADD FOLDER command to create a new folder within the specified folder to aid in organizing your storage system. You can create folders only under the “Virtual Disks” and “Hosts” root folders. You cannot create root folders.
SSSU Command Reference ADD HOST Use the ADD HOST command to add a host and its World Wide Name (WWN) to the list of hosts that can connect to virtual disks within the current system. The ADD HOST command adds the first Fibre Channel Adapter (FCA) only. The SET HOST command (see page 80) adds each subsequent FCA. Syntax ADD HOST WORLD_WIDE_NAME= Switches The following switches are available with the ADD HOST command. IP= This is the network IP address.
SSSU Command Reference ■ WINDOWS For the default operating system, refer to Agent Options - User Interface Options in the user interface. WORLD_WIDE_NAME= The World Wide Name (WWN) of the fibre channel adapter (FCA). Required switch The following switch must be set to ensure that Command View EVA recognizes the host added with the ADD HOST command.
SSSU Command Reference ADD LUN The ADD LUN command makes previously created VDISKs available to a host. Syntax ADD LUN VDISK= HOST= LUN_number is 1 through 255. Switches The following switches are available with the ADD LUN command. HOST= The name of the host to which the LUN is presented. VDISK= The name of the VDISK that is presented to the host.
SSSU Command Reference ADD SNAPSHOT The ADD SNAPSHOT command creates a picture (not a full copy) of a virtual disk family’s active virtual disk. Note: Creating snapshots of virtual disks depends on your licensing level. Attempting to add a snapshot without the license returns an error message. This message indicates that you need to enter your licensing information in the Command View EVA. You must have a registered license.
SSSU Command Reference ■ 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.
SSSU Command Reference ADD SYSTEM Use the ADD SYSTEM command to initialize an uninitialized storage system and to create a default disk group. You must select an uninitialized storage system before issuing the ADD SYSTEM command. If the system is already initialized, the command is rejected. Use the SHOW SYSTEM command (see “SHOW SYSTEM” on page 100) to display the names of the available uninitialized storage systems.
SSSU Command Reference DEVICE_COUNT= The number of physical disks to use for the default disk group of this system. The limit is the number of available disks in the storage system. The default and minimum value is 8. DISKGROUP_DISKTYPE= This parameter determines the types of disks to be considered for creating the disk group. The default value is ONLINE. ONLINE: Online Fibre channel disks are considered for creating the default disk group.
SSSU Command Reference ADD VDISK Use the ADD VDISK command to create a virtual disk with a specified name and parameters. Note: This command actually creates a virtual disk family and the ACTIVE partition. After you create the family, an initial virtual disk, “ACTIVE,” is placed as the only virtual disk in the family. This is referred to as the active virtual disk. When you later refer to this virtual disk, specify \ACTIVE after the family name.
SSSU Command Reference NOMIRRORED_WRITEBACK No writes are stored in mirrored caches. After the data is stored in one cache, the write is complete. The write is complete even if a mirror copy of the cache is not available. OS_UNIT_ID= The ID that is presented to the host operating system. If set to zero, no ID is presented to the host. PREFERRED_PATH= The preferred controller path that is specified to handle all I/O for the virtual disks.
SSSU Command Reference ■ 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.
SSSU Command Reference NOWAIT_FOR_COMPLETION Returns control as soon as possible. Some operations are invalid until the initial operation completes in the background. For example, you cannot present the Vdisk (add a LUN) until the command completes.
SSSU Command Reference Note: Remember that this name is the and that “\Virtual Disks\\ACTIVE” is the name of the ACTIVE virtual disk. You must use this full path (enclosed in double quotes) when referring to it with any other commands.
SSSU Command Reference CAPTURE CONFIGURATION Syntax CAPTURE CONFIGURATION CAPTURE CONFIGURATION queries the currently selected system and creates from one to five SSSU scripts. Not all systems require all five scripts. For example, step1A is always generated and may be the only file that is required. You use these scripts to recreate the original configuration and in some cases to assist in the recovery of any site. The scripts output to the console unless you specify a file.
SSSU Command Reference Step 1B script Creates all source VDISKs used in DR groups on this controller. Step 1C script Presents all source VDISKs (creates LUNS) that are used for DR groups to their hosts. This step exists to assist in recovering from a DR failure in which a source site was lost. LUNs can be presented in their original configuration by running the correct step 1C script. Step 2 script Recreates all DR-specific configuration information for which this system is the source.
SSSU Command Reference Be aware that a specific captured configuration may not be recreated on some systems. For example, if a captured configuration demands 120 disks and the target system contains only 80, the captured configuration will not be successful. 1. Select a manager to specify which management appliance will perform the script commands. 2. Select the system Uninitialized Storage System# to specify the uninitialized storage system on which you want to recreate the captured configuration. 3.
SSSU Command Reference CAPTURE VALIDATE Syntax CAPTURE VALIDATE CAPTURE VALIDATE checks the specified script file for modification by calculating its checksum and comparing the result against the checksum saved in the file. A script may have been modified (failed the CAPTURE VALIDATE command) but may still work. SSSU runs a script even if its checksum shows file modification. Example CAPTURE VALIDATE c:\reconfigure_sales_dr_step2.
SSSU Command Reference DELETE Use the DELETE commands to remove systems, folders, disk groups, DR groups, VDISKs, hosts, and LUNs from the storage system. You can control the behavior of all DELETE commands with the SET OPTIONS command (see “SET OPTIONS” on page 83 for details on how to use the SAFE_DELETE and NOSAFE_DELETE switches). Note: All of the DELETE commands require the full path from the root directory to the object you want to delete. Only the DELETE VDISK command has switches available.
SSSU Command Reference DELETE DR_GROUP Deletes the DR Group on the source and destination system. Be sure that VDISKS are unpresented and that the source and destination are not communicating. The SET OPTION NOSAFE_DELETE does not override this requirement. You can delete a DR Group on the source system at any time. Syntax DELETE DR_GROUP Example DELETE DR_GROUP “\Data Replication\payroll” This example deletes the DR_GROUP payroll.
SSSU Command Reference DELETE DISK_GROUP Use the DELETE DISK_GROUP command to delete a disk group from the configuration. The command is rejected if any virtual disks are present in the disk group. Syntax DELETE DISK_GROUP Example DELETE DISK_GROUP “\Disk Groups\human_resources” This example deletes a disk group named human_resources.
SSSU Command Reference DELETE FOLDER Use the DELETE FOLDER command to delete the specified empty folder. You should ensure folders are empty before deleting them because the DELETE FOLDER command will be rejected otherwise. To delete multiple layers of folders, you must do so sequentially. Note: Ensure folders are empty before deleting them because the DELETE FOLDER command is rejected if the folder has contents.
SSSU Command Reference DELETE HOST Syntax DELETE HOST Example DELETE HOST \Hosts\development This example deletes the host development.
SSSU Command Reference DELETE LUN Use the DELETE LUN command to remove access to a virtual disk through the LUN from a host. Syntax DELETE LUN Example DELETE LUN “\Hosts\accounting department\12” This example removes access to LUN 12 from the host accounting_department.
SSSU Command Reference DELETE SYSTEM Use the DELETE SYSTEM command to permanently remove the system from an EVA. The system will no longer be accessible, and all data will be lost. Caution: The DELETE SYSTEM command removes the entire system configuration. All customer data on the entire system is lost when you run this command. In addition, all information about LUNs and hosts on this system is lost. The DELETE SYSTEM command will be rejected if VDISKs exist.
SSSU Command Reference DELETE VDISK Use the DELETE VDISK command to permanently remove the specified virtual disk. The virtual disk is no longer accessible, and all data is lost. Caution: The DELETE VDISK command removes the entire virtual disk from the storage system. All customer data on the storage specified is destroyed when you run this command. In addition, all information about the LUNs presented from this virtual disk is lost as well. The DELETE VDISK command will be rejected if presented.
SSSU Command Reference The second example deletes the snapshot wed_nite_biz and does not wait for completion. Note: You cannot delete ACTIVE if a snapshot of the virtual disk exists. You must delete the snapshot and then delete ACTIVE.
SSSU Command Reference EMVERSION The EMVERISON command is at the root level, as is help. This command provides the user with the element manager version and build number. Syntax NoSystemSelected: emversion Switches No additional keywords, parameters, or switches are available with the EMVERSION command. Example Element manager information Version: 3.10 Build: 14 Note: You will need to select a manager before using the EMVERSION command, but you do not need to select a storage system.
SSSU Command Reference EXERCISE_DISK This command allows users to test hard disks in the array for defects. Syntax exercise_disk Switches The following switches are available with the EXERCISE_DISK command. START Begins testing, or exercising, the disks. The options are: All Tests all disks in a selected storage system. List of fully qualified disk names to exercise, comma separated and enclosed in quotes Tests specific disks as specified in the command. STOP Stops the testing.
SSSU Command Reference EXIT The EXIT command terminates the SSSU session. If SSSU is accepting input from the terminal or the command line, EXIT causes the program to terminate. If SSSU is processing a script from a file while encountering a FILE command, the behavior of the EXIT command depends on how the FILE command was issued: ■ If the FILE command was issued from the command line, an EXIT command in the file causes SSSU to terminate.
SSSU Command Reference FILE The FILE command causes the current mode of input to suspend and redirects the scripting utility to accept input from the specified file. Either the end of the file or an EXIT command in the specified file causes SSSU to again accept input from the previous input source. FILE commands can be nested. Nesting FILE commands means that a file being executed through a FILE command can have FILE commands within its command set.
SSSU Command Reference HELP The HELP command displays information about using the SSSU help. To get HELP on specific command syntax, enter a space and a question mark (?) wherever you would normally include a parameter, at any level of a command line. The help system will then list the options available for that parameter. Syntax HELP Examples HELP Command syntax help is available at any point within a command by typing a '?' The first example accesses HELP.
SSSU Command Reference REDISCOVER This command tells Command View EVA to conduct rediscovery to find new storage systems or update the status of existing systems. For example, when communication has been lost and then restored, REDISCOVER could be used.
SSSU Command Reference RESTART Use the RESTART command to restart a controller shown by the SHOW POWER command. A power object is a controller. Syntax RESTART Switches The following switches are available for the RESTART command: ■ ALL_PEERS ■ NOALL_PEERS These switches are described in the following paragraphs. ALL_PEERS Restarts all peer controllers (both controllers) on this system. NOALL_PEERS Default. Restarts only the specified controller.
SSSU Command Reference SELECT Use the SELECT command to select a system. After you select a system, the prompt changes to reflect the selected system.
SSSU Command Reference SELECT MANAGER Use the SELECT MANAGER command to direct the command prompt to a selected Command View EVA or management appliance. All configuration commands run on the selected Command View EVA or management appliance and affect its storage system configuration. The can be a server, appliance name, or an IP address. Unless the SAN administrator has changed the password, the default is “password.
SSSU Command Reference SELECT SYSTEM Use the SELECT SYSTEM command to direct the command prompt to the selected system or manager. All configuration commands then affect the selected system. If the system name has spaces in it, the name must be enclosed in double quotes (“”). Syntax SELECT SYSTEM Examples SELECT SYSTEM employees SELECT SYSTEM “payroll storage” In the first example, the employees system is selected. The system payroll storage is selected in the second example.
SSSU Command Reference SET Use the SET commands to change the properties of systems, disks, folders, DR groups, disk groups, hosts, and virtual disks. In addition, the SET commands let you reset existing storage settings and application options. 72 ■ All SET commands require the full path from the root directory to the object you want to rename. ■ You can perform only one property change per SET command.
SSSU Command Reference SET DR_GROUP Use SET DR_GROUP to set the mode of operation of an existing DR Group. Syntax SET DR_GROUP Switches The switches available with the SET DR_GROUP command are described in the following paragraphs. Note that from the destination side, a user can set only the COMMENT and NAME switches. ACCESSMODE= The access rights for a connected host. Possible values are readonly and disable. ADD_VDISK= Name of a source system VDISK to be added to the DR Group.
SSSU Command Reference DETACH_VDISK= Name of a source system VDISK to be removed from the DR Group. The corresponding destination VDISK on the destination system is removed from the DR Group but not deleted. The detached destination VDISK continues to exist as an independent VDISK. FAILOVER Reverses the roles of the DR Groups; the source becomes the destination and the destination becomes the source.
SSSU Command Reference Example SET DR_GROUP “\Data Replication\Transactions” SUSPEND This example suspends replication for the DR Group Transactions.
SSSU Command Reference SET DISK The SET DISK command changes the properties of a disk. Syntax SET DISK Switches The switches available for the SET DISK command are described in the following paragraphs. COMMENT= This is an optional switch that associates a user-defined comment with the new system. A maximum of 128 characters is allowed and the string must be enclosed in double quotes. NAME= New name to give to the specified disk.
SSSU Command Reference SET DISK_GROUP The SET DISK_GROUP command changes the specified disk group properties. Syntax SET DISK_GROUP Switches The switches available with the SET DISK_GROUP command are described in the following paragraphs. ADD= The number of disk drives to add to the specified disk group. COMMENT= This is an optional switch that associates a user-defined comment with the disk group. A maximum of 128 characters are allowed and the string must be enclosed in double quotes.
SSSU Command Reference ■ SINGLE—reserves space within a disk group to allow for data reconstruction for failure of a single disk drive ■ DOUBLE—reserves space within a disk group to allow for data reconstruction for failure of two disk drives Note: The space set aside is not in numbers of physical disks. It is the equivalent amount of storage space spread across all disks.
SSSU Command Reference SET FOLDER The SET FOLDER command changes the specified folder properties. Syntax SET FOLDER Switches The switches available for the SET FOLDER command are described in the following paragraphs. COMMENT= This is an optional switch that associates a user-defined comment with the new system. A maximum of 128 characters is allowed, and the string must be enclosed in double quotes. NAME= New name to give to the specified folder.
SSSU Command Reference SET HOST The SET HOST command adds or deletes World Wide Names, sets the operating systems for a host, and adds comments to a specified host. Note: Use the SET HOST command to add additional FCAs to hosts added to the storage system with the ADD HOST command. Syntax SET HOST Switches The following switches are available with the SET HOST command. ADD_WORLD_WIDE_NAME= Adds the World Wide Name of the host port.
SSSU Command Reference ■ IBMAIX ■ OPEN_VMS ■ SOLARIS ■ TRU64 ■ WINDOWS ■ CUSTOM = (You must include the equal sign after CUSTOM, and the value must be 16-digit hexidecimal characters.) Examples SET HOST \Hosts\install OPERATING_SYSTEM=OPEN_VMS SET HOST \Hosts\install ADD_WORLD_WIDE_NAME=1000-0000-C922-36CA The first example assigns OpenVMS as the operating system type for the host install. The second example adds a WWN to the host install.
SSSU Command Reference SET MONITOR The SET MONITOR command changes the specified monitor properties. Syntax SET MONITOR Switches The following switches are available with the SET MONITOR command: COMMENT= This is an optional switch that associates a user-defined comment with the monitor. A maximum of 128 characters (including spaces) is allowed, and the string must be enclosed in double quotes. NAME= New name to give to the specified monitor.
SSSU Command Reference SET OPTIONS The SET OPTIONS command changes the SSSU characteristics. Note: The 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. Syntax SET OPTIONS Switches The following switches are available with the SET OPTIONS command. COMMAND_DELAY= The number of seconds (0–300 seconds) to wait between issuing commands when running a script using the FILE command. The default is 10 seconds.
SSSU Command Reference ■ HALT_ON_ERROR—This is similar to EXIT_ON_ERROR. Any error causes the scripting utility to halt but not exit until any key is pressed. Then the scripting utility exits with an error code. This allows you to see the error before the window closes on exit. Note: When manually typing commands, HP does not recommend using the EXIT_ON_ERROR or HALT_ON_ERROR modes. You should avoid these modes because SSSU exits on any kind of error, including a typographical one.
SSSU Command Reference Caution: Using the NOSAFE_DELETE switch can cause accidental deletion of VDISKs or presentations. Example SET OPTION ON_ERROR=HALT_ON_ERROR NORETRIES The example sets the options for SSSU to stop upon encountering an error and not to retry the commands.
SSSU Command Reference SET SYSTEM Use the SET SYSTEM command to modify system properties. Syntax SET SYSTEM Switches The following switches are available for the SET SYSTEM command. COMMENT= This is an optional switch that associates a user-defined comment with the new system. A maximum of 128 characters is allowed, and the string must be enclosed in double quotes. CONSOLE_LUN_ID= The LUN used for console communication. If set to zero, a console LUN is not presented to the host.
SSSU Command Reference SET VDISK Syntax SET VDISK Switches The following switches are available for the SET VDISK command. COMMENT= This is an optional switch that associates a user-defined comment with the new system. A maximum of 128 characters is allowed and the string must be enclosed in double quotes. MIRRORED_WRITEBACK All writes are stored in mirrored caches. After the data is stored in both caches, the write is complete.
SSSU Command Reference ■ PATH_A_BOTH—Controller path A fails over to controller B. When controller A restarts, the virtual disks fail back to controller A. This is failover/failback mode. ■ PATH_A_FAILOVER—Controller path A fails over to controller B. When controller A restarts, the virtual disks do not fail back over to controller A. This is failover-only mode. ■ PATH_B_BOTH—Controller path B fails over to controller A. When controller B restarts, the virtual disks fail back to controller B.
SSSU Command Reference WRITE_PROTECT Does not allow writing to the virtual disk for all presented LUNs. NOWRITE_PROTECT Allows writing to the virtual disk for all presented LUNs. Example SET VDISK “\Virtual Disks\archive\ACTIVE” WORLD_WIDE_NAME_LUN_ NAME=6000-1fe1-ff00-0000 The example assigns the World Wide LUN Name to the ACTIVE virtual disk of the archive family.
SSSU Command Reference SHOW Use the SHOW commands to display information about various elements in the currently selected system. Note: All of the SHOW commands require the full path from the root directory to the object you want to display. Remember to include full paths for objects and enclose any paths that contain spaces in double quotes. The following switches are available for all SHOW commands. ■ SHOW FULL ■ SHOW NOFULL (This is the default.
SSSU Command Reference SHOW DR_GROUP Displays a list of data replication groups for the currently selected system. If you specify the name of the DR Group, it displays detailed information about the specified DR Group. Syntax SHOW DR_GROUP Example SHOW DR_GROUP “\Data Replication\Transactions” This example shows the DR_Group Transactions.
SSSU Command Reference SHOW DISK Use the SHOW DISK command to display disk configuration information for physical disks connected to the currently selected system. Syntax SHOW DISK Examples SHOW DISK SHOW DISK “\Disk Groups\Ungrouped Disks\Disk 039" The first example displays a list of all the physical disks in the currently selected system. The second example displays specific information about the physical “Disk 039.
SSSU Command Reference SHOW DISK_GROUP The SHOW DISK_GROUP command displays the disk groups currently configured by this system. If is specified, detailed information about the specified disk group is displayed. Syntax SHOW DISK_GROUP Examples SHOW DISK_GROUP SHOW DISK_GROUP “\Disk Groups\Default Disk Group” The first example displays a list of the available disk groups. The second example displays information about the default disk group.
SSSU Command Reference SHOW HOST The SHOW HOST command displays the hosts currently configured on this system. If is specified, information about the specified host is displayed. Syntax SHOW HOST Examples SHOW HOST SHOW HOST \Hosts\med_lab The first example displays the list of available hosts on the currently selected system. The second example displays specific information about the host med_lab.
SSSU Command Reference SHOW LUN The SHOW LUN command displays the LUNs currently configured on this system. Syntax SHOW LUN Examples SHOW LUN SHOW LUN \Hosts\SVT165\13 The first example displays the list of available LUNs on the selected system. The second example displays specific information about the LUN 13 on \Hosts\SVT165.
SSSU Command Reference SHOW MANAGER The SHOW MANAGER command displays information about the currently selected manager. Syntax SHOW MANAGER Switch The switches FULL and NOFULL can be specified but are ignored. Specifying a specific manager name is also ignored. The SHOW MANAGER command always displays the information for the currently selected manager. Example SHOW MANAGER The example displays information about the currently selected manager.
SSSU Command Reference SHOW MONITOR The SHOW MONITOR command displays the monitors currently installed on this system. If is specified, detailed information about that specified monitor is displayed. Syntax SHOW MONITOR Examples SHOW MONITOR SHOW MONITOR “\Hardware\Rack 1\blue_cab” The first example lists monitors available on the currently selected system. The second example displays information about the monitor blue_cab.
SSSU Command Reference SHOW OPTIONS The SHOW OPTIONS command displays the current SSSU options.
SSSU Command Reference SHOW POWER The SHOW POWER command displays the controllers currently configured on this system. If you specify , detailed information about that specific controller is displayed. Controllers are the only power objects. Syntax SHOW POWER Examples SHOW POWER SHOW POWER “\Hardware\Rack 1\Enclosure 7\Controller A” The first example displays a list of all power objects within the selected system.
SSSU Command Reference SHOW SYSTEM Use the SHOW SYSTEM command to display the systems currently managed by command view eva. If is specified, detailed information about that specified system is displayed. Syntax SHOW SYSTEM Examples SHOW SYSTEM SHOW SYSTEM payroll The first example displays a list of available systems on this manager. The second example displays specific information about the system payroll.
SSSU Command Reference SHOW VDISK The SHOW VDISK command displays the storage currently configured on this system. If is specified, detailed information about the specified storage is displayed. Syntax SHOW VDISK Examples SHOW VDISK SHOW VDISK “\Virtual Disks\scratch_disk\ACTIVE” The first example displays a list of all virtual disks in the currently selected system. The second example displays information about the specific active virtual disk scratch_disk\ACTIVE.
SSSU Command Reference SHOW WORLD_WIDE_NAME The SHOW WORLD_WIDE_NAME command displays the host World Wide Names (WWNs) that are visible to this system and not already assigned to a host. Syntax SHOW WORLD_WIDE_NAME Example SHOW WORLD_WIDE_NAME This example displays all of the WWNs visible to this system that have not been assigned to a host.
SSSU Command Reference SHUTDOWN Use the SHUTDOWN command to shut down any controller displayed by the SHOW POWER command. Syntax SHUTDOWN Switches The following switches are available with the SHUTDOWN command. ALL_PEERS Shuts down all peer controllers (both controllers) on this system. This will also power off all drive enclosures. NOALL_PEERS Default. Shuts down only the specified controller.
SSSU Command Reference 104 Command View EVA Storage System Scripting Utility Reference Guide
Configuration Examples A This appendix provides examples that describe how to use commands to create a simple configuration and to view specific system information.
Configuration Examples Creating a simple configuration This section presents a simple configuration example in two ways: ■ Annotated with steps (page 106 through page 109) ■ Sample output as it displays after executing all of the commands (page 109) Creating the storage system ■ Select the manager with the SELECT MANAGER command. ■ View the systems available on the manager (Uninitialized Storage System1, if this is an uninitialized storage system) with the SHOW SYSTEM command.
Configuration Examples 4. Select the Uninitialized Storage System1 system with the SELECT SYSTEM command. NoSystemSelected> SELECT SYSTEM “Uninitialized Storage System1” Uninitialized Storage System1> The prompt changes to reflect the selected system (Uninitialized Storage System1). 5. Initialize the storage system with the ADD SYSTEM command, providing a name for the system (such as Yekao). This creates one system using 8 disks in the default Disk Group. The default number of disks is 8.
Configuration Examples Creating and presenting a virtual disk Here are the steps to follow to create a virtual disk and present the system to a host. ■ Select the newly created system ■ Add a virtual disk (ADD VDISK) to the storage system ■ Add a host to the system (ADD HOST) ■ Add a LUN using a host and a VDISK 1. Use the SELECT SYSTEM command to select the system you just created.
Configuration Examples 4. Add the LUN to the host by using the ADD LUN command, supplying the full path to the virtual disk and the host machine. Yekao> ADD LUN 15 VDISK=”\Virtual Disks\Enicar\ACTIVE” HOST=\Hosts\SVT165 Remember, for any path or name that contains spaces, you must enclose the entire string in double quotes, as in the example above. Now LUN 15 is presenting the VDISK to the host.
Configuration Examples Using the SHOW commands This section provides examples of using the SHOW command, based on the storage system, host, and virtual disk created in the previous section, “Creating a simple configuration” on page 106. The purpose of this presentation is to provide a sample of SSSU output. To view information about various system attributes, you first select the system and then use the SHOW commands. SHOW SYSTEM Use the SHOW SYSTEM command to view information about the selected system.
Configuration Examples Yekao> SHOW VDISK Use the SHOW VDISK command to display information about the virtual disks (storage) within the selected system. 1. Enter the SHOW VDISK command (with a system selected) to display a list of available storage.
Configuration Examples Read_Cache_Policy : On Comm_Protocol : Write_Protect : No Enable_Disable : Enable OS_Unit_ID : 0 Preferred_path : No preference Comments : ID : 01200710b4080560bc49010000e0000000000d00 Condition_State: Operational_State : 1 Date Time: Created : 28-Jun-1946 18:28:34 Presentation [0]: StorageClientName : \Hosts\maui_6228 Lun : 1 DR_Attributes: Remote_VDisk: Yekao> SHOW HOST Use the SHOW HOST command to display information about the hosts available on the selected storage system. 1.
Configuration Examples Note: Remember that you need to type the full path to the host object and that if there are any spaces within the path or host name, the entire string needs to be enclosed within double quotes.
Configuration Examples 2. Use the SHOW LUN command, with the specific LUN named, to display the specific LUN information.
glossary This glossary defines terms used in this guide or related to this product and is not a comprehensive glossary of computer terms. active virtual disk A virtual disk is a simulated disk drive created by the controllers as storage for one or more hosts. An active virtual disk is accessible by one or more hosts for normal storage. An active virtual disk and its snapshot, if one exists, constitute a virtual disk family.
Glossary console LUN A SCSI-3 virtual object that makes a controller pair accessible by the host before any virtual disks are created. Also called a communication LUN. console LUN ID The ID that can be assigned when a host operating system requires a unique ID. The console LUN ID is assigned by the user, usually when the storage system is initialized. See also console LUN. controller A hardware/firmware device that manages communications between host systems and other devices.
Glossary Enterprise Virtual Array The hp name used to describe the storage system that includes controllers, storage devices, enclosures, cables, and power supplies. Also called the Enterprise Storage System. environmental monitoring unit See EMU. event log System information sent to the Management Appliance or host operating system. fabric A Fibre Channel fabric switch or two or more interconnected Fibre Channel switches allowing data transmission.
Glossary GB Gigabyte. A unit of measurement defining either: ■ A data transfer rate. See also GBps ■ A storage or memory capacity of 1,073,741,824 (230) bytes. GBps Gigabytes per second. A measurement of the rate at which the transfer of bytes of data occurs. A GBps is a transfer rate of 1,000,000,000 (109) bits per second. See also GB. Giga (G) The notation to represent 109 or 1 billion (1,000,000,000). HBA Host Bus Adapter. See FCA.
Glossary initialization A process that prepares a storage system for use. Specifically, the system binds controllers together as an operational pair and establishes preliminary data structures on the disk array. Initialization also sets up the first disk group, called the default disk group. LUN Logical Unit Number. The host-accessible presentation of a virtual disk on the system. manager The object that controls configuration of the system.
Glossary OSM Open SAN Manager. A centralized, appliance-based monitoring and management interface that supports multiple applications, operating systems, hardware platforms, storage systems, tape libraries, and SAN-related interconnect devices. It is included with and resides on the Management Appliance, a single aggregation point for data management. parity A method of checking if binary numbers or characters are correct by counting the ONE bits.
Glossary preferred path A preference for which controller of the controller pair manages the virtual disk. This preference is set by the user through the Command View EVA when creating the virtual disk. A user can change the preferred path of a virtual disk at any time. The main purpose of selecting a preferred path is load balancing.
Glossary snapshot A temporary virtual disk that reflects the contents of another virtual disk at a particular point in time. A snapshot operation is done only on an active virtual disk. The active disk and its snapshot constitute a virtual disk family. See also active virtual disk, virtual disk copy, and virtual disk family. spare policy This is the disk failure protection level set for the system and disk groups. See also disk failure protection. SSN Storage System Name.
Glossary uninitialized storage system A state in which the storage system is not ready for use. See also initialization. VDisk (virtual disk) A collection of blocks created on one or more disks that can be used by a host for information storage and retrieval. The host computer sees the virtual disk as “real,” with the characteristics of an identical physical disk. See also active virtual disk, virtual disk copy, virtual disk family, and virtual disk snapshot.
Glossary Vraid5 A virtualization technique that provides moderate data protection using parity striping. Parity is a data protection mechanism for a striped virtual disk. A striped virtual disk is one whose data to and from the host is broken down into chunks and distributed on the physical disks comprising the disk group in which the virtual disk was created. If the striped virtual disk has parity, another chunk (a parity chunk) is calculated from the set of data chunks and written to the physical disks.
index Index ADD COPY examples 31 switches DISK_GROUP= 30 OS_UNIT_ID= 30, 40 VDISK= 31 WORLD_WIDE_LUN_NAME= 31 ADD DISK_GROUP description 34 example 35 switches DEVICE_COUNT= 34 OCCUPANCY_ALARM= 35 SPARE_POLICY= 35 ADD DR_GROUP description 32 example 33 Syntax 32 ADD FOLDER description 36 examples 36 switch, COMMENT= 36 syntax 36 ADD HOST description 37 example 38 switches COMMENT= 37 OPERATING_SYSTEM= 37 WORLD_WIDE_NAME= 38 syntax 37 Index A using 108 ADD LUN description 39 examples 39 switches HOST= 3
Index MIRRORED_WRITEBACK 44 NOPREFERRED_PATH 45 NOREAD_CACHE 45 NOWRITE_PROTECT 46 OS_UNIT_ID= 45 PREFERRED_PATH= 45, 87 READ_CACHE 45 REDUNDANCY= 30, 40, 45 SIZE= 46 WORLD_WIDE_LUN_NAME= 46 WRITE_PROTECT 46 syntax 44 using 108 audience 14 authorized reseller, HP 12 C CAPTURE CONFIGURATION description 49 example 51 restoring configurations 50 syntax 49 CAPTURE VALIDATE description 52 example 52 syntax 52 configuration creating 106 importance of capturing 21 CONSOLE_LUN_ID and operating systems 42 conventi
Index F M FILE description 65 examples 65 syntax 65 FOLDER ADD 36 DELETE 56 SET 77 formatting and output of returned data 14 MANAGER SHOW 96 MONITOR SET 82 SHOW 97 N getting help 12 naming disk group example 23 host example 23 paths and 23 virtual disk example 23 H O HELP description 66 example 66 syntax 66, 67 help, obtaining 12 HOST ADD 37 SET 80 SHOW 94 HP authorized reseller 12 storage website 12 technical support 12 HP-UX 37, 80 HSV controllers 14 OpenVMS 37, 81 and the CONSOLE_LUN_ID 86 ope
Index returned data, formatting and output of 14 S SELECT 69 SELECT MANAGER examples 70 switches PASSWORD= 70 USER= 70 syntax 70 SELECT SYSTEM examples 71 syntax 71 using 107, 108 SET DISK description 76 example 76 switches COMMENT= 76 NAME= 76 syntax 76 SET DISK_GROUP description 77 example 78 switches ADD= 77 COMMENT= 77 DELETE= 77 NAME= 77 OCCUPANCY_ALARM= 77 syntax 77 SET DR_GROUP description 73 example 75 syntax 73 SET FOLDER description 77 example 79 switches COMMENT= 79 NAME= 79 syntax 79 128 SET
Index NOMIRRORED_WRITEBACK 45, 87 NOPREFERRED_PATH 88 NOREAD_CACHE 88 NOWRITE_PROTECT 89 OS_UNIT_ID= 87 READ_CACHE 88 SIZE= 88 WORLD_WIDE_LUN_NAME= 31, 88 WRITE_PROTECT 89 syntax 87 SHOW commands 90 output samples 110 SHOW DISK description 92 examples 92 syntax 92 SHOW DISK_GROUP description 93 examples 93 syntax 93 SHOW DR_GROUP description 91 example 91 syntax 91 SHOW HOST description 94 examples 94 output samples 112 syntax 94 SHOW LUN description 95 examples 95 output samples 113 syntax 95 SHOW MANAGER
Index SET 86 SHOW 100 T technical support, HP 12 text symbols 10 Tru64 UNIX 37, 81 and the CONSOLE_LUN_ID 86 V VDISK ADD 44 DELETE 60 SET 87 130 SHOW 101 virtual disk, creating and presenting a 108 Vraid0 30, 41, 46 Vraid1 30, 34, 41, 46 Vraid5 30, 34, 41, 46 W websites, HP storage 12 Windows 2000 38, 81 Windows NT 38, 81 WORLD_WIDE_LUN_NAME, use with snapshots 31 WORLD_WIDE_NAME, SHOW 102 Command View EVA Storage System Scripting Utility Reference Guide
