HP StorageWorks XP Tiered Storage Manager CLI Reference Guide (December 2005)

Contents 3
Contents
Revision history (start here)
Revision tables ....................................................................................................................................................... 9
1 Overview of HP StorageWorks XP Tiered Storage Manager
1-1 Tiered Storage Manager Software Components....................................................................................... 10
1-2 Volume Migration Using the Tiered Storage Manager CLI........................................................................ 10
1-2-1 Storage Tier Filter Conditions......................................................................................................... 12
1-2-2 Volume Search and Volume Filter Conditions................................................................................ 13
1-2-3 Creating a Candidate Migration Plan.............................................................................................. 13
1-2-4 Editing a Migration Plan.................................................................................................................. 17
1-2-5 Creating and Executing a Migration Task....................................................................................... 17
2 Requirements and Installation
2-1 Requirements for CLI Operations.............................................................................................................. 19
2-2 CLI Memory Requirements ....................................................................................................................... 19
2-3 Tiered Storage Manager CLI Installation and Setup ................................................................................. 20
2-3-1 Requirements for CLI Installation and Setup..................................................................................20
2-3-2 CLI Installation and Setup on a Windows System.......................................................................... 20
2-3-3 CLI Installation and Setup on a Solaris or HP-UX System............................................................. 21
2-4 Tiered Storage Manager CLI Uninstallation and Unsetup......................................................................... 23
2-5 Precautions Regarding Execution of the CLI Commands ......................................................................... 23
3 Using the Tiered Storage Manager CLI
3-1 CLI Command Overview ........................................................................................................................... 25
3-2 Description of the CLI Command Elements .............................................................................................. 26
3-3 CLI Command Syntax ............................................................................................................................... 27
3-3-1 CLI Command Parameters............................................................................................................. 27
3-3-2 Filter Condition Expressions........................................................................................................... 30
3-4 Miscellaneous Operational Information ..................................................................................................... 35
3-4-1 Recommended/Maximum Values for Tiered Storage Manager Operations................................... 35
3-4-2 Common Options (Username, Password, and Output) .................................................................. 36
3-4-3 Tiered Storage Manager Repository Information ........................................................................... 37
3-4-4 CLI Return Responses ................................................................................................................... 38
3-5 Starting the Tiered Storage Manager CLI ................................................................................................. 38
3-5-1 Using CLI Commands in a Batch (Script) File ................................................................................ 39
3-6 Displaying CLI Help................................................................................................................................... 39
4 Detailed Command Descriptions
4-1 Storage Domain Management Commands ............................................................................................... 41
4-1-1 CreateStorageDomain.................................................................................................................... 41
4-1-2 DeleteStorageDomain .................................................................................................................... 43
4-1-3 GetStorageDomains ....................................................................................................................... 44
4-1-4 ModifyStorageDomain .................................................................................................................... 48
4-1-5 GetVolumes.................................................................................................................................... 49
4-1-6 Refresh........................................................................................................................................... 59
4-2 Storage Tier Management Commands ..................................................................................................... 59
4-2-1 CreateStorageTier.......................................................................................................................... 59
4-2-2 DeleteStorageTier .......................................................................................................................... 61
4-2-3 GetStorageTiers ............................................................................................................................. 62
4-2-4 ModifyStorageTier .......................................................................................................................... 65
4-2-5 GetVolumes (with storagetiername Specified) ............................................................................... 67
4-3 Migration Group Management Commands ............................................................................................... 67
4-3-1 CreateMigrationGroup.................................................................................................................... 67
4-3-2 DeleteMigrationGroup .................................................................................................................... 68
4-3-3 GetMigrationGroups ....................................................................................................................... 69
4-3-4 ModifyMigrationGroup .................................................................................................................... 73
4-3-5 AddVolumeToMigrationGroup ........................................................................................................ 74
4-3-6 RemoveVolumeFromMigrationGroup............................................................................................. 76
4-3-7 GetVolumes (with migrationgroupname Specified) ........................................................................ 78
4-4 Migration Commands ................................................................................................................................ 79
4-4-1 CreateMigrationPlan....................................................................................................................... 79
4-4-2 CreateMigrationTask ...................................................................................................................... 85
4-4-3 GetTasks ........................................................................................................................................ 87