Revision history (start here) 1 HP StorageWorks XP Tiered Storage Manager CLI Reference Guide Part number: T1785-96003 First edition: 11/2005
Overview of HP StorageWorks XP Tiered Storage Manager 10 1 Overview of HP StorageWorks XP Tiered Storage Manager This chapter explains the software c
Detailed Command Descriptions 100 targetStorageTierName=MegaTech-HighCost eraseData=No totalCapacityInGB=19 description=This property was cha
Tiered Storage Manager Properties Files 101 5 Tiered Storage Manager Properties Files This chapter describes the properties files for the Tiered Stor
Tiered Storage Manager Properties Files 102 Table 5-1 Properties Specifiable for the Tiered Storage Manager CLI Type File Name Property For Detai
Tiered Storage Manager Properties Files 103 When specifying a file name, precede the file name with the @ character. When a string starting with the
Tiered Storage Manager Properties Files 104 5-3-4 logger.tracelogLevel Property Specify the threshold for the output level of the trace log. With the
Troubleshooting 105 6 Troubleshooting This chapter describes the actions to be taken if problems occur with the Tiered Storage Manager CLI. 6-1 Troub
Troubleshooting 106 Table 6-1 Troubleshooting Tiered Storage Manager CLI Problem Cause Recommended Action In Solaris or HP-UX, add the directory
Acronyms and Abbreviations 107 Acronyms and Abbreviations API application programming interface BNF Bachus Naur form CLI command line interface GB
Index 108 Index A adding volume, 75 AddVolumeToMigrationGroup command, 75 argument, 39 B batch (script) file, 38 C CancelTask command, 97 candidate
Index 109 ModifyStorageTier command, 65; newfiltercondition parameter, 12 ModifyTask command, 94 N newfiltercondition parameter, 12 O obtaining: list
Overview of HP StorageWorks XP Tiered Storage Manager 11 Figure 1-1 Flow of Migration Operations 1. Map volumes (LDEVs) Use the External Storage XP
Overview of HP StorageWorks XP Tiered Storage Manager 12 NOTE: The storage tier must be created such that it contains a volume whose characteristic
Overview of HP StorageWorks XP Tiered Storage Manager 13 1-2-2 Volume Search and Volume Filter Conditions Volumes in a storage domain and storage tie
Overview of HP StorageWorks XP Tiered Storage Manager 14 When volume filter conditions are further specified by the filtercondition parameter, candid
Overview of HP StorageWorks XP Tiered Storage Manager 15 # CLPRNumber=0 # cacheMode=Disable # IOSupressionMode=Disable sourceContro
Overview of HP StorageWorks XP Tiered Storage Manager 16 # targetControllerDeviceNumber=2:A6 # targetControllerDeviceNumber=2:A7 Figure 1-2 E
Overview of HP StorageWorks XP Tiered Storage Manager 17 1-2-4 Editing a Migration Plan A candidate migration plan created by the CreateMigrationPlan
Overview of HP StorageWorks XP Tiered Storage Manager 18 • Active.WaitingMigration: Waiting for migration to be performed • Active.Migrating: Migra
Requirements and Installation 19 2 Requirements and Installation This chapter explains the system requirements for operating the Tiered Storage Manag
2 Legal notices © Copyright 2005 Hewlett-Packard Development Company, L.P. Hewlett-Packard Company makes no warranty of any kind with regard to this m
Requirements and Installation 20 For commands such as the GetVolumes command that can obtain a large amount of information depending on parameter set
Requirements and Installation 21 system-drive\TieredStorageManager\0110\CLI\htsmcli.bat system-drive\TieredStorageManager\0110\CLI\htsmcli.properties
Requirements and Installation 22 1. Execute the env command to verify that the value set for the PATH system environment variable contains the path
Requirements and Installation 23 2-4 Tiered Storage Manager CLI Uninstallation and Unsetup To perform unsetup of CLI, you must execute the batch file
Requirements and Installation 24 By using the desired umask, if you want to create a file to which the standard output is to be redirected, use the s
Using the Tiered Storage Manager CLI 25 3 Using the Tiered Storage Manager CLI This chapter provides an overview of the Tiered Storage Manager CLI an
Using the Tiered Storage Manager CLI 26 Table 3-1 CLI Command Categories Category Command Name Description ModifyMigrationGroup Changes attribute
Using the Tiered Storage Manager CLI 27 Table 3-2 Description of CLI Command Elements Command Element Description options Options contain informati
Using the Tiered Storage Manager CLI 28 Table 3-3 Range of Valid Parameter Values Parameter Permissible Value or Range Valid Characters and Paramete
Using the Tiered Storage Manager CLI 29 Table 3-3 Range of Valid Parameter Values Parameter Permissible Value or Range Valid Characters and Paramete
Contents 3 Contents Revision history (start here) Revision tables ...
Using the Tiered Storage Manager CLI 30 Table 3-3 Range of Valid Parameter Values Parameter Permissible Value or Range Valid Characters and Paramete
Using the Tiered Storage Manager CLI 31 The following is an example specification for filtercondition, for a filter condition for a storage tier: Pro
Using the Tiered Storage Manager CLI 32 Table 3-4 Range of Valid Property Values for Filter Condition Expressions Property Name Permissible Value or
Using the Tiered Storage Manager CLI 33 Table 3-4 Range of Valid Property Values for Filter Condition Expressions Property Name Permissible Value or
Using the Tiered Storage Manager CLI 34 Table 3-4 Range of Valid Property Values for Filter Condition Expressions Property Name Permissible Value or
Using the Tiered Storage Manager CLI 35 Table 3-4 Range of Valid Property Values for Filter Condition Expressions Property Name Permissible Value or
Using the Tiered Storage Manager CLI 36 Table 3-5 Recommended/Maximum Values for Tiered Storage Manager Operations Type of Operation Description Re
Using the Tiered Storage Manager CLI 37 Table 3-6 Common Options for the Tiered Storage Manager CLI Option Option Argument Description -u or --use
Using the Tiered Storage Manager CLI 38 Table 3-7 Impact of CLI Commands on Repository Information Category Command Name Repository Information Dis
Using the Tiered Storage Manager CLI 39 To start a CLI command on a Management client, specify the file as described below from the command line: Whe
Contents 4 4-4-4 ModifyTask ...
Using the Tiered Storage Manager CLI 40 . . CancelTask DeleteTasks FOR HELP, TYPE: "htsmcli help [comma
Detailed Command Descriptions 41 4 Detailed Command Descriptions This chapter contains a detailed description for each CLI command. Each command is p
Detailed Command Descriptions 42 Table 4-1 Options of the CreateStorageDomain Command Option Name Arguments Optional or Required Description -d or
Detailed Command Descriptions 43 Table 4-3 Items Output by the CreateStorageDomain Command Type of Information Item Name Description Output by -d
Detailed Command Descriptions 44 Table 4-6 Items Output by the DeleteStorageDomain Command Type of Information Item Name Description Output by -d
Detailed Command Descriptions 45 Table 4-7 Options of the GetStorageDomains Command Option Name Arguments Optional or Required Description -d or -
Detailed Command Descriptions 46 Table 4-9 Items Output by the GetStorageDomains Command Type of Information Item Name Description Output by -d Di
Detailed Command Descriptions 47 totalCapacityInGB=Unknown usedCapacityInGB=Unknown usedCapacityPercentage=Unknown freeCapacityInGB=U
Detailed Command Descriptions 48 usedCapacityPercentage=Unknown freeCapacityInGB=Unknown freeCapacityPercentage=Unknown numberOfStora
Detailed Command Descriptions 49 Table 4-11 Parameters of the ModifyStorageDomain Command Parameter Name Optional or Required Description name Req
Figures 5 Figures Figure 1-1 Flow of Migration Operations...
Detailed Command Descriptions 50 • Migration group (when a migration group name is specified) You can also further limit the items obtained by speci
Detailed Command Descriptions 51 Table 4-15 Properties Specifiable for the filtercondition Parameter Property Name Operators Description SubsystemV
Detailed Command Descriptions 52 Table 4-16 Items Output by the GetVolumes Command Type of Information Item Name Description Output by -d Displaye
Detailed Command Descriptions 53 Table 4-16 Items Output by the GetVolumes Command Type of Information Item Name Description Output by -d Displaye
Detailed Command Descriptions 54 Table 4-16 Items Output by the GetVolumes Command Type of Information Item Name Description Output by -d Displaye
Detailed Command Descriptions 55 Table 4-17 GUI-Displayed Character Strings Representing Reasons a Volume Cannot Be a Migration Target, and a Descrip
Detailed Command Descriptions 56 volumeLockStatus=Unlocked path=No hostNames= canMigrate=No List of 2 reason(s) for vol
Detailed Command Descriptions 57 arrayGroupNumber=Unknown controllerArrayGroupName= E9980-1 arrayGroupName=Unknown businessCo
Detailed Command Descriptions 58 Output (2): RESPONSE: An instance of StorageDomain(1 of 1) name=MegaTechXP12000-Primary List of 2 LogicalUnit e
Detailed Command Descriptions 59 4-1-6 Refresh The Refresh command can be used to perform refresh processing (processing to re-obtain configuration i
Tables 6 Table 4-41 Items Output by the GetMigrationGroups Command ... 70
Detailed Command Descriptions 60 Table 4-19 Options of the CreateStorageTier Command Option Name Option Arguments Optional or Required Description
Detailed Command Descriptions 61 D:\>htsmcli CreateStorageTier --detail storagedomainname="MegaTechXP12000-Primary" name="MegaTech-
Detailed Command Descriptions 62 Table 4-25 Items Output by the DeleteStorageTier Command Type of Information Item Name Description Output by -d S
Detailed Command Descriptions 63 Table 4-27 Parameters of the GetStorageTiers Command Parameter name Optional or Required Description storagedomain
Detailed Command Descriptions 64 An instance of StorageTier(1 of 2) name=MegaTech-HighCost filterCondition=RAIDLevel = 'RAID5(3D
Detailed Command Descriptions 65 totalCapacityInGB=9 totalCapacityPercentageToStorageDomain=1 usedCapacityInGB=0 usedCapacity
Detailed Command Descriptions 66 Table 4-30 Parameters of the ModifyStorageTier Command Parameter Name Optional or Required Description newname Op
Detailed Command Descriptions 67 description= D:\> 4-2-5 GetVolumes (with storagetiername Specified) The GetVolumes command with storagetie
Detailed Command Descriptions 68 Table 4-33 Options of the CreateMigrationGroup Command Option Name Option Arguments Optional or Required Descripti
Detailed Command Descriptions 69 Command Syntax htsmcli server-location DeleteMigrationGroup { -u | --username } user-name { -p | --passwor
Revision history (start here) 7 About this guide This guide provides information about: • Installing HP StorageWorks Command View XP Advanced Editio
Detailed Command Descriptions 70 Information cannot be obtained for migration groups in storage domains that are being refreshed. Command Syntax ht
Detailed Command Descriptions 71 Table 4-41 Items Output by the GetMigrationGroups Command Type of Information Item Name Description Output by -d
Detailed Command Descriptions 72 migrationStatus= numberOfVolumes=0 description=MigrationGroup01 An instance of MigrationGroup(
Detailed Command Descriptions 73 Example (3): In this example, to obtain summary information for all migration groups in the storage domain MegaTechX
Detailed Command Descriptions 74 Table 4-44 Items Output by the ModifyMigrationGroup Command Type of Information Item Name Description Output by
Detailed Command Descriptions 75 Table 4-45 Options of the AddVolumeToMigrationGroup Command Option Name Option Arguments Optional or Required Des
Detailed Command Descriptions 76 Example: In this example, a volume is added to the MG011 migration group in the MegaTechXP12000-Primary storage doma
Detailed Command Descriptions 77 { -p | --password } { password | @name-of-password-file } [ { -o | --output } name-of-the-standard-output-re
Detailed Command Descriptions 78 Table 4-50 Output, RemoveVolumeFromMigrationGroup Command Type of Information Item Name Description Output by -d D
Detailed Command Descriptions 79 Command Syntax htsmcli server-location Getvolumes { -u | --username } user-name { -p | --password } { passw
Revision history (start here) 8 HP technical support Telephone numbers for worldwide technical support are listed on the HP web site: http://www.hp.c
Detailed Command Descriptions 80 migrationgroupname=migration-group-name targetstoragetiername=target-storage-tier-name [ filtercondition
Detailed Command Descriptions 81 Table 4-53 Items Output by the CreateMigrationPlan Command Type of Information Item Name Description permitCross
Detailed Command Descriptions 82 # LUSE=No # LU=3:A7 # emulationType=OPEN-V # CVS=Yes # capacityInKB=10,240,320 # SLPRNumber=
Detailed Command Descriptions 83 # targetControllerDeviceNumber=2:A5 # targetControllerDeviceNumber=2:A6 # targetControllerDeviceNumber=2
Detailed Command Descriptions 84 pair # LUSE=No # LU=3:A7 # emulationType=OPEN-V # CVS=Yes # capacityInKB=10,240,320 # S
Detailed Command Descriptions 85 # targetControllerDeviceNumber=2:A4 # targetControllerDeviceNumber=2:A5 # targetControllerDeviceNumber=2
Detailed Command Descriptions 86 Table 4-55 Parameters of the CreateMigrationTask Command Parameter Name Optional or Required Description erasedata
Detailed Command Descriptions 87 sourceControllerDeviceNumber=3:A7 targetControllerDeviceNumber=2:84 D:\> 4-4-3 GetTasks The GetTasks
Detailed Command Descriptions 88 Table 4-58 Parameters of the GetTasks Command Parameter Name Optional or Required Description targetstoragetiernam
Detailed Command Descriptions 89 Table 4-59 Items Output by the GetTasks Command Type of Information Item Name Description Output by -d creatio
Revision history (start here) 9 Revision history (start here) Revision tables Table 2 Revisions Date Edition Revision November, 2005 First Initial
Detailed Command Descriptions 90 Table 4-59 Items Output by the GetTasks Command Type of Information Item Name Description Output by -d sourceS
Detailed Command Descriptions 91 Table 4-59 Items Output by the GetTasks Command Type of Information Item Name Description Output by -d status
Detailed Command Descriptions 92 totalCapacityInGB=19 description= List of 2 MigrationInfo elements: An instance of MigrationInfo(1
Detailed Command Descriptions 93 sourceSLPRNumber=0 sourceCLPRNumber=0 sourceRaidLevel=RAID5(3D+1P) sourceDiskType=Un
Detailed Command Descriptions 94 storageDomainName=MegaTechXP12000-Primary migrationGroupName=MG011 targetStorageTierName=MegaTech-HighCo
Detailed Command Descriptions 95 Table 4-62 Items Output by the ModifyTask Command Type of Information Item Name Description Output by -d Task inf
Detailed Command Descriptions 96 An instance of MigrationInfo(2 of 2) sourceControllerDeviceNumber=3:A7 targetControllerDeviceNumber=
Detailed Command Descriptions 97 Table 4-64 Items Output by the CancelTask Command Parameter Name Optional or Required Description id Required Sp
Detailed Command Descriptions 98 Table 4-66 Parameters of the DeleteTasks Command Parameter Name Optional or Required Description storagedomainname
Detailed Command Descriptions 99 Table 4-67 Items Output by the DeleteTasks Command Type of Information Item Name Description DataErasureStartedT
Comentarios a estos manuales