HP Storage Platform Storage Provisioning Tool for StoreAll User Guide Abstract This document describes storage provisioning and reporting on StoreAll platforms and explains the different storage configurations and storage layouts supported on these platforms. This document also describes the different operations supported by the Storage Provisioning Tooland describes how to use the tool's CLI options. This document also contains troubleshooting information for Storage Provisioning failures.
© Copyright 2014 Hewlett-Packard Development Company, L.P. Confidential computer software. Valid license from HP required for possession, use, or copying. Consistent with FAR 12.211 and 12.212, Commercial Computer Software, Computer Software Documentation, and Technical Data for Commercial Items are licensed to the U.S. Government under vendor's standard commercial license. The information contained herein is subject to change without notice.
Contents 1 Introduction...............................................................................................6 Overview................................................................................................................................6 Installation...............................................................................................................................6 Provisioning best practices......................................................................................
Adding a spare............................................................................................................31 Assigning host access....................................................................................................31 Rescaning storage.........................................................................................................32 Reassigning a controller.................................................................................................
Customer self repair................................................................................................................46 7 Documentation feedback...........................................................................
1 Introduction Overview The Storage Provisioning Tool (SPT) is a CLI-based tool that provides automation of storage provisioning, validation, query, and repair capabilities for the StoreAll storage configurations. NOTE: SPT is not applicable to the StoreAll 8200 and is not supported for the IBRIX X9720. SPT supports the following operations: • Auto-provisioning storage, based on a predefined layout. • Repairing storage configuration to the default layout. • Validating a configured storage.
Table 1 Basic syntax description (continued) Notations Description The string between the brackets identifies the type of input needed. For example, indicates you must input one of the subcommands, such as discover, in this part of the command line. […] Square brackets enclosing a string or selection of strings separated by the pipe symbol ( | ) indicate alternative optional command line parameters.
2 StoreAll 9730 storage provisioning Definitions Table 3 Terms and definitions Terms Definitions HP 1210m storage controller The HP 1210m storage controller is a PCIe-based RAID controller available on each server node in a couplet and operates in active-active pairs. MDS600 The MDS600 is a storage enclosure that can host 70 disk drives within its two disk drawers. Pool A pool is a set of one or more physical disk drives that serve as backing storage for one or more RAID volumes.
Table 5 Storage layout (continued) Features Balanced capacity Maximum capacity Performance Number of pools 8 7 11 Spares 2 2 2 Pool ownership alternate controllers alternate controllers alternate controllers NOTE: Pools are automatically assigned a primary controller since the HP 1210m storage controller operates in pairs. Typically, the first controller owns the odd-numbered pools and the second controller owns the even-numbered pools.
Figure 2 Maximum capacity storage profile Performance configuration Figure 3 (page 11) shows the pool and spare layout for a performance configuration.
Figure 3 Performance storage profile Volume configuration A volume is a logical partition of a pool and is exposed as block devices for operating system access. Each volume can also be perceived as a storage representation of a segment. Since the StoreAll file system imposes a limit of 8 TB for each segment, the volume sizes are also ensured to be within this supported limit. Volume configurations are dependent on drive type.
Choosing storage profiles for auto-provisioning CAUTION: In most cases, you do not have to select an alternate storage layout profile. However, in the event of a reprovisioning storage request based on a different storage layout (other than the default), you should delete the entire storage configuration and recreate it. To avoid data loss, HP recommends that you do the necessary backup prior to running this task.
2 5000C50040E0254F 1 2 51 Pooled 1863.02 OK 3 5000C50040E0C18F 1 3 51 Pooled 1863.02 OK 4 5000C50040E0D18F 1 4 51 Pooled 1863.02 OK 5 5000C50040E0CDFF 1 5 51 Pooled 1863.02 OK 6 5000C50040E2257B 1 6 51 Pooled 1863.02 OK 7 5000C50040E09CEF 1 7 51 Pooled 1863.02 OK 8 5000C50040E0A3B3 1 8 51 Pooled 1863.02 OK 9 5000C50040E09843 1 9 51 Pooled 1863.02 OK 10 5000C50040E047CB 1 10 51 Pooled 1863.02 OK 11 5000C50040E0CBAB 1 11 51 Pooled 1863.02 OK 12 5000C50040E0D233 1 12 51 Pooled 1863.
-------Free Drives Pooled Drives Spare Drives : 0 : 66 : 4 Listing volumes Syntax hpsp_spt -lv [ all | ] hpsp_spt --listVolumes [ all | ] Description Lists information for all volumes or an individual volume (if the World Wide Network ID is specified). If no argument is specified, all volumes are listed. NOTE: The all argument is case insensitive.
-------------------------------------------------------------------------------# UUID Bay Size(GB) RPM Link-Speed State Status -------------------------------------------------------------------------------1 5000C50040E0C8CB 1 1863.02 7200 3Gbps Pooled OK 2 5000C50040E0254F 2 1863.02 7200 3Gbps Pooled OK 3 5000C50040E0C18F 3 1863.02 7200 3Gbps Pooled OK 4 5000C50040E0D18F 4 1863.02 7200 3Gbps Pooled OK 5 5000C50040E0CDFF 5 1863.02 7200 3Gbps Pooled OK 6 5000C50040E2257B 6 1863.
21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 5000C50040E384CB 5000C50040E0B167 5000C50040E07AF7 5000C50040E38E5F 5000C50040E0C00F 5000C50040E22A2B 5000C50040E32E67 5000C50040E23487 5000C50040E2075F 5000C50040E22CB7 5000C50040E04E0B 5000C50040E0A19F 5000C50040E0AD43 5000C50040E064B3 5000C50040E0AF77 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 1863.02 1863.02 1863.02 1863.02 1863.02 1863.02 1863.02 1863.02 1863.02 1863.02 1863.02 1863.02 1863.02 1863.02 1863.
Example 4 List volume parity initialization status # hpsp_spt -ps -----------------------------------------------------------------------------------------# Name WWN Progress Status Elapsed-Time -----------------------------------------------------------------------------------------1 LUN_1 6B7A271BEA80001095AD41304B303352 4% Running 23 mins 33 secs 2 LUN_2 63189B3CEA80001095AE41304B303352 N/A INACTIVE N/A 3 LUN_3 648FD960EA80001095B041304B303352 4% Running 23 mins 25 secs 4 LUN_4 6C86D666EA80001095B141304B
13 LUN_13 N/A 9 6 6520.56* 14 LUN_14 N/A 9 6 6520.56* -------------------------------------------------*Approximate value Example 6 Actual provisioning # hpsp_spt -ap Applying profile: x9730_BalCap_Raid6-2T .....................
Repairing a storage system Syntax hpsp_spt -rp [--dryRun] hpsp_spt --repair [--dryRun] Description You can execute the --repair subcommand on a partially provisioned system. Without the --dryRun option, the command recreates volumes/pools. This command determines the missing pools and volumes that should have been there after an --autoProvision and tries to recreate them so that the volume configuration is brought to the same state it would be in after an --autoProvision.
Example 9 Delete volume $ hpsp_spt --deleteVolume 6AE694F5CFB80010960A415A3430324C Volume deletion might result in Data loss. Do you really want to delete the volume Deleted Volume: 6AE694F5CFB80010960A415A3430324C (y/n)?:y Reconfiguring spares Syntax hpsp_spt -rs hpsp_spt --reconfigureSpares Description Reconfigures the spares of all existing volumes based on the known configuration determined by the configured storage profile.
3 StoreAll 9320 storage provisioning Definitions Table 10 Terms and definitions Term Definition Vdisk A Vdisk is a set of one or more physical disk drives forming a RAID group that serve as backup storage for one or more volumes. Volume A volume can be viewed as a logical partition of a Vdisk. The RAID level of the volume is the RAID level of the Vdisk. Spare A spare is a disk drive that has been assigned to provide fail-over storage for a failed drive in a Vdisk.
9320 Vdisk layouts Figure 4 9320 Vdisk layouts for LFF drives NOTE: For LFF configurations, the starter and the expansion kit have the same layouts, as shown in Figure 4 (page 22).
NOTE: For SFF configurations, the starter and the expansion kit have different layouts, as shown in Figure 5 (page 22).
1 On all enclosures, the second volume is created for the use of the 2 TB hard drive model. 2 On all enclosures, the third volume is created for the use of the 3 TB hard drive model.
Command reference and examples Controller options Option Description -ctrlIp Is a mandatory option to be used in all the commands except --help and --version. This option requires the controller's management interface IP as --controllerIp Requires the username to connect to the controller's management interface. -usr --user Requires the password to connect to the controller's management interface.
Serial No. : 6XP264RV0000B230BXE3 Location(Box,Bay) : 1, 2 Status : OK Type : SAS Size : 286102 MB RPM : 10 Link Speed : 6Gbps Spare : no Enclosure UUID : 500c0ff013ae833c Volumes Associated: Name: HPIBX_13ae833c041 WWN: 00c0ff13c47300001a003f5001000000 3. UUID : 1.3 Serial No.
2. Name : HPIBX_13ae833c023 WWN : 00c0ff13c2070000b750375001000000 Node-id : 127.0.0.1 Owning Controller : B Raid Level : 5 Size : 1395.51 GB Status : OK Contributing Drives-UUID: 1.13, (Bay,Box): (13, 1) UUID: 1.14, (Bay,Box): (14, 1) UUID: 1.15, (Bay,Box): (15, 1) UUID: 1.16, (Bay,Box): (16, 1) UUID: 1.17, (Bay,Box): (17, 1) UUID: 1.18, (Bay,Box): (18, 1) 3. Name : HPIBX_13ae833c031 WWN : 00c0ff13c4730000896e445001000000 Node-id : 127.0.0.1 Owning Controller : A Raid Level : 5 Size : 1395.
5 1.5 5 279.40 10 6Gbps Vdisk OK 6 1.6 6 279.40 10 6Gbps Vdisk OK 7 1.7 7 279.40 10 6Gbps Vdisk OK 8 1.8 8 279.40 10 6Gbps Vdisk OK 9 1.9 9 279.40 10 6Gbps Vdisk OK 10 1.10 10 279.40 10 6Gbps Vdisk OK 11 1.11 11 279.40 10 6Gbps Vdisk OK 12 1.12 12 279.40 10 6Gbps Vdisk OK 13 1.13 13 279.40 10 6Gbps Vdisk OK 14 1.14 14 279.40 10 6Gbps Vdisk OK 15 1.15 15 279.40 10 6Gbps Vdisk OK 16 1.16 16 279.40 10 6Gbps Vdisk OK 17 1.17 17 279.40 10 6Gbps Vdisk OK 18 1.18 18 279.40 10 6Gbps Vdisk OK 19 1.19 19 279.
Example 14 Dry run provisioning hpsp_spt -cs -ctrlIp 10.20.12.101 -ap --dryRun -------------------------------------------------# Name WWN Drives Raid Size(GB) -------------------------------------------------1 HPIBX_VOL_1 N/A 5 5 1863.05* 2 HPIBX_VOL_2 N/A 6 5 2328.81* 3 HPIBX_VOL_3 N/A 6 5 2328.81* 4 HPIBX_VOL_4 N/A 6 5 2328.81* -------------------------------------------------*Approximate value hpsp_spt -cs -ctrlIp 10.20.12.101 -ap --dryRun Example 15 Actual provisioning hpsp_spt -cs -ctrlIp 10.20.12.
Description Only execute the --repair command on a partially provisioned system. Without the --dryRun option, the command recreates the missing volumes/pools by identifying the missing vdisks and volumes and creating them according to the pre-defined profiles. The command also assigns host access and reassigns controller ownership to vdisks (if needed) for non-mapped volumes. The output shows the volumes recreated during the repair operation.
Example 18 Delete volume $ hpsp_spt --deleteVolume 6AE694F5CFB80010960A415A3430324C Volume deletion might result in Data loss. Do you really want to delete the volume Deleted Volume: 6AE694F5CFB80010960A415A3430324C (y/n)?:y Deleting a spare Syntax -ds --deleteSpare Description Deletes the global spare indicated by the UUID argument. Example 19 Delete spare drive # hpsp_spt -deleteSpare 1.1 -ctrlIp 10.20.20.
Example 21 Assign host access # hpsp_spt -ha Operation completed successfully Rescaning storage Syntax -rescan --rescan Description Issues a rescan to the storage controller. Example 22 Rescan storage # hpsp_spt -rescan -ctrlIp 10.20.20.1 -usr manage -pwd \!manage CAUTION: This operation temporarily pauses all I/O processes, then resumes normal operation.
4 StoreAll 8800 storage provisioning Definitions Table 16 Terms and definitions Terms Definitions HP p1228 storage controller The HP p1228 storage controller is a PCI-based RAID controller available on each server node in a couplet, which operates as an active-active pair. D2700 A storage enclosure that can host 25 SFF disk drives. D6000 A storage enclosure that can host 70 LFF disk drives within its two disk drawers.
Storage provisioning with the D2700 Figure 6 Storage layout for D2700 Storage provisioning with the D6000 Figure 7 Storage layout for a D6000 34 StoreAll 8800 storage provisioning
NOTE: The other D6000 drawer has a symmetrical storage layout. The base D6000 SKU ships with 18 drives in each drawer, totaling 36 drives. The initial 18 drives per drawer are filled in the rearmost bays (18 to 35). The expansion SKU ships with 17 drives in each drawer, totaling 34 drives. These drives fill the remaining 17 bays in each drawer towards the front bays (1 to 17). Volume configuration A volume is a logical partition of a pool and is exposed as a block device for operating system access.
NOTE: The all argument is case insensitive. Example 24 List disk drives # hpsp_spt -ld -------------------------------------------------------------------------------# UUID Box Bay Port State Size(GB) Status -------------------------------------------------------------------------------1 5000CCA016277648 1 1 1E DriveUsageFree 838.36 OK 2 5000CCA01627817C 1 2 1E DriveUsageFree 838.36 OK 3 5000CCA01627B284 1 3 1E DriveUsageFree 838.36 OK 4 5000CCA0162771A8 1 4 1E DriveUsageFree 838.
Example 26 List enclosure drives # hpsp_spt -le 1. Enclosure Configuration: UUID : 5001438023519C80 Name : Drive Cage Serial : 5C7252P2A8 Model : D2700 SAS AJ941A Location : 1E, 1 Vendor : HP Status : OpStatusDegraded -- Enclosure Drives List --------------------------------------------------------------------------------# UUID Bay Size(GB) RPM Link-Speed State Status -------------------------------------------------------------------------------1 5000CCA016277648 1 838.
hpsp_spt --autoProvision [--dryRun] Description Without the --dryRun option, provision storage and expose all volumes to all hosts. The provisioning is done using predefined storage profiles. On successful execution, it lists the created volumes. With the --dryRun option, perform a dry run of provisioning without actually provisioning the storage. The output of –dryRun is the raw bytes of storage that will be available to the user after provisioning.
Example 30 Validate storage profile # hpsp_spt -vs Validating with : [8800_D2700] .. Valid Storage Configuration with profile: [8800_D2700] Field support commands Deleting volumes CAUTION: This is a hidden command (it is not listed in the tool's help) and should only be used by an HP field engineer. Syntax hpsp_spt -dv [--force] hpsp_spt --deleteVolume [--force] Description Deletes a single volume (specified by the WWN ID).
Example 33 Identify drive # hpsp_spt -id 5000CCA01B4B6494 Operation completed successfully --led on Assigning host access Syntax hpsp_spt -ha hpsp_spt --assignHostAccess Description Assigns host access to the volumes which are not mapped. This operation allows all volumes to be seen by all registered HBAs.
Example 36 Parity status # hpsp_spt -parityStatus ---------------------------------------------------------------------------------------------------# Name WWN Progress Status Elapsed-Time ---------------------------------------------------------------------------------------------------1 LUN_C1_P1_V1 6694FC7B26000010B004533457303049 15% JobStateRunning 13 mins 52 secs 2 LUN_C1_P2_V1 6A013F7C26000010B005533457303049 15% JobStateRunning 13 mins 47 secs 3 LUN_C1_P3_V1 6056957C26000010B006533457303049 15% JobS
5 Troubleshooting StoreAll 9730 provisioning failures hpsp_spt –ap operation failed with ERROR: 0x4526: Failed to retrieve drive(s) information DAN API returned stale drive objects with getUnpooledDrives() API. Suggested action 1. Run the following commands: a. ccu cli controller local set defaults b. ccu cli controller local y 2. 3. 4. 5. Power down the other node. Reboot the current node. Power up the other node.
3. 4. Contact technical support to make sure that both drawers report the same serial number. Retry the hpsp_spt operation. ERROR:0x4979: Unknown storage configuration, cannot proceed with validation The storage was not provisioned using hpsp_spt. Suggested action It is advisable to use hpsp_spt only for the listing operations. StoreAll 9320 provisioning failures ERROR:0x4976: Partially provisioned storage found, Suggested action: run "--repair" command and rerun "--validateStorage".
The MSA shell session closed. There was an invalid response from the MSA controller. Suggested action Retry the hpsp_spt operation. Retry the hpsp_spt operation with the peer controller’s IP address. Retry the operation after restarting the management controller: 1. SSH/telnet into the MSA controller. 2.
6 Support and other resources Contacting HP For worldwide technical support information, see the HP Support Center: http://www.hp.
Table 18 Document conventions (continued) Convention Element Monospace text • File and directory names • System output • Code • Commands, their arguments, and argument values Monospace, italic text • Code variables • Command variables Monospace, bold text WARNING! CAUTION: IMPORTANT: NOTE: TIP: Emphasized monospace text Indicates that failure to follow directions could result in bodily harm or death. Indicates that failure to follow directions could result in damage to equipment or data.
7 Documentation feedback HP is committed to providing documentation that meets your needs. To help us improve the documentation, send any errors, suggestions, or comments to Documentation Feedback (docsfeedback@hp.com). Include the document title and part number, version number, or the URL when submitting your feedback.