HP Smart Storage Administrator User Guide Abstract This document identifies, and provides instructions for, the tools available for configuration, management, monitoring, and diagnosing of HP ProLiant controller and server products. This document is for the person who installs, administers, and troubleshoots servers and storage systems. HP assumes you are qualified in the servicing of computer equipment and trained in recognizing hazards in products with hazardous energy levels.
© Copyright 2013, 2014 Hewlett-Packard Development Company, L.P. The information contained herein is subject to change without notice. The only warranties for HP products and services are set forth in the express warranty statements accompanying such products and services. Nothing herein should be construed as constituting an additional warranty. HP shall not be liable for technical or editorial errors or omissions contained herein. Confidential computer software.
Contents Overview ..................................................................................................................................... 5 About HP SSA .......................................................................................................................................... 5 Array configuration overview ...................................................................................................................... 6 Benefits of using HP SSA .............................
Fault-tolerance methods ................................................................................................................ 109 Diagnosing array problems .................................................................................................................... 118 Diagnostic tools ........................................................................................................................... 118 Troubleshooting resources......................................................
Overview About HP SSA HP SSA is the main tool for configuring arrays on HP Smart Array controllers. It exists in three interface formats: the HP SSA GUI, the HP SSA CLI, and HP SSA Scripting. All formats provide support for configuration tasks (on page 6). Some of the advanced tasks are available in only one format. The diagnostic features in HP SSA are also available in the standalone software HP Smart Storage Administrator Diagnostics Utility CLI (on page 101).
Array configuration overview Benefits of using HP SSA HP Smart Storage Administrator is an advanced utility that enables you to perform many complex configuration tasks. Previously, other HP configuration utilities, including Array Configuration Utility and Option ROM Configuration for Arrays, were recommended for storage configuration. Although ACU is still supported, HP SSA replaces it starting with HP ProLiant Gen8 servers. There are many GUI differences between ACU and HP SSA.
To identify controller-specific feature support and SAAP requirements, see the controller user guide or the HP website (http://www.hp.com/go/smartarray). For more information, see "About SAAP (on page 121).
Procedure HP Smart Array G6 and G7 controllers Split mirror backup and rollback of RAID 1, 1+0, 1 (ADM) and 10 – (ADM) mirrors 1 2 HP Smart Array Gen8 controllers + Scripting is the most efficient method for this task. The task is supported only from the Configuration screen.
Future versions of HP SSA will be available as native 32-bit or native 64-bit applications, as long as 32-bit operating systems are supported.
Operations Accessing HP SSA in the offline environment To access and launch the HP SSA GUI in an offline environment, use one of the following methods: • Launching HP SSA with HP Intelligent Provisioning (Gen8 or later) (on page 10) • Launching HP SSA during POST (Gen8 or later) (on page 10) • Launching HP SSA from an ISO image (all generations) (on page 10) To access the HP SSA CLI or HP SSA Scripting in an offline environment, you must launch HP SSA from an ISO image.
Booting from the ISO image on a drive, on a key, or through iLO provides the same GUI interface. The user can select to run Offline HP SSA GUI, HP SSA CLI, or HP SSA Scripting. Mounting the image on a local drive 1. Download the HP ProLiant Offline HP Smart Storage Administrator ISO image from the HP website (http://www.hp.com/go/hpssa). 2. Using ISO mounting software, mount the Offline HP SSA ISO image to a drive. 3. Set the server to boot the image. 4. Reboot the server.
• A good, working knowledge of PXE and TFTP • A network with a DHCP server on it • A TFTP server configured on the same network as the DHCP server • A network file server that hosts the ISO images and is accessible by a PXE booted system • PXELinux (http://syslinux.zytor.com/wiki/index.php/PXELINUX) These instructions presume that you are using a Linux TFTP server and the TFTP package (http://www.kernel.org/pub/software/network/tftp). Other TFTP servers should work similarly.
The paths to the files on the TFTP server are vmlinuz and initrd.img. You must modify them to include any directories or naming conventions you may have on your TFTP server. Specify the ISO image path For the PXE-booted server to find the ISO image, you must add the ISO image path to the append line in the PXELinux configuration file. Add the following arguments: iso1=nfs://192.168.0.99/path/to/hpssacd/image/hpssaoffline-1.60-16.0.
Accessing HP SSA in the online environment To access, install, and launch HP SSA in the online environment, you must download the HP SSA executables. All three formats have separate executables. HP SSA Scripting is a standalone application that is distributed with the HP SSA CLI application. Users familiar with ACU Scripting must now install the HP SSA CLI application to obtain the scripting executable.
o For remote mode, enter: hpssa– start HP SSA launches in a browser window. 2. For a list of options, enter the following: hpssa- h Launching HP SSA on a local server to configure a remote server 1. On the local server (host), click Start, and then select Programs>HP System Tools>HP Smart Storage Administrator>HP Smart Storage Administrator Preferences. The HP Smart Storage Administrator Preferences screen appears.
o Optional: Under Preferred Language, select a language or leave as System Default. o Click Exit. 2. On the server that you want to configure, connect to the Systems Insight Manager server (port: 280), and then log in. 3. Select Device Queries. 4. Under Device by Type, select All Servers. 5. Connect to the server that is running HP SSA. 6. Under Device Links, select System Management Homepage. The login screen for the System Management Homepage opens. 7.
Icon and key stroke legend The HP SSA GUI includes many icons (also defined in the Help file) to help with identification and troubleshooting.
Navigating the GUI When you open HP SSA, the Welcome screen appears.
• The Smart Storage Administrator quick navigation menu is in the top, left-hand corner of the screen. Clicking the down arrow displays the available devices, and clicking one of the available devices displays additional information and options for the device. You can also return to a server Home screen, or you can choose Configuration or Diagnostics for a device listed. For more information, see "Configure screen (on page 19)" or "Diagnostics screen (on page 21).
The Configure screen displays the GUI elements from the Welcome screen and lists available actions, status messages, more detailed information, and a controller configuration summary for a selected controller.
• Devices and Tools—This panel, at left, displays systems, controllers, arrays, physical drives, logical drives, and a cache and license manager.
• Diagnostics Report • SmartSSD Wear Gauge Report When selecting either report, the available actions on the Actions panel include viewing the report or saving the report. For a list of possible tasks that are available on the Diagnostics screen, see "Diagnostic tasks (on page 44)." HP SSA help The Help button, at upper right, opens the embedded HP SSA help file.
Configuration tasks From the Configure screen, you can perform tasks related to controllers, arrays, physical drives, and logical drives. For certain tasks, the controller must have SAAP activated by a registered license key. For more information, see "About SAAP (on page 121)." When a controller or device is selected, the tasks that appear are a subset of the total number of possible tasks for the selected item. HP SSA lists or omits tasks based on the controller model and configuration.
Item Tasks Unused space Create Logical Drive More Information Physical drive Erase Drive** View Status Alerts Unassigned drives Create Array More Information *This task is not available on all controller models. **If performed with an HP Smart Array G6 or G7 controller, this task requires a registered SAAP license key or a controller where SAAP functionality is standard. See "About SAAP (on page 121)." †If performed with a Gen8 controller, this task requires a registered HP SmartCache license key.
5. Do one of the following: o Configure an additional controller. Repeat steps 3 through 5. o Click Exit HP SSA. Performing a Configuration task 1. Open HP SSA. For more information, see "Using the HP SSA GUI (on page 16)." 2. 3. Open the Configure panel by doing one of the following: o Choose a device and click Configure in the quick navigation menu. o Select an available device from the Home screen, and then click Configure under the available options. Select a device from the Devices menu.
HP SSD Smart Path HP SSD Smart Path enables an optimized data path to high performance solid state drives. The optimized path bypasses the controller’s RAID processing components and sends I/O directly to the drives. To enable or disable HP SSD Smart Path: 1. Open HP SSA. For more information, see "Using the HP SSA GUI (on page 16)." 2. 3. Open the Configure panel by doing one of the following: o Choose a device and click Configure in the quick navigation menu.
By default, HP SSA Smart Path is enabled on SSD drives. 8. Under Configure>Devices, choose the array with the logical drive(s) you just created. 9. If you want to disable HP SSA Smart Path, click Disable HP SSD Smart Path. 10. Click Save. Rapid Parity Initialization When you create a logical drive, you must initialize the parity using Rapid Parity Initialization. RAID levels that use parity (RAID 5, RAID 6 (ADG), RAID 50, and RAID 60) require that the parity blocks be initialized to valid values.
For more information, see "Using the HP SSA GUI (on page 16)." 2. 3. Open the Configure panel by doing one of the following: o Choose a device and click Configure in the quick navigation menu. o Select an available device from the Home screen, and then click Configure under the available options. Select Arrays from the Devices menu. A list of arrays appears. 4. Select an array, and select Create Logical Drive from the Actions menu. 5.
3. To create an array, select from the list of available SATA SSD drives listed. When finished, click Create Array. 4. The Create Logical Drive window appears. Under the option SSD Over Provisioning Optimization, select Do not perform SSD Over Provisioning Optimization on the Array. 5. Click Create Logical Drive.
Changing the Spare Activation Mode The spare activation mode feature enables the controller firmware to activate a spare drive under the following conditions: • When a data drive reports a predictive failure (SMART) status • When a data drive fails; this mode is the default. In normal operations, and for older controllers, the firmware starts rebuilding a spare drive only when a data drive fails.
3. Select a controller from the Devices menu. 4. Select Create Array from the Actions panel. The Array details screen appears. 5. Select a controller, drive type, and physical drives, and click Create Array. 6. Select settings for Create Plaintext Volume, RAID Level, Strip Size/Full Strip Size, Sectors/Track, Size, and Caching. Click Create Logical Drive when complete. 7. Click Manage Spare Drives. 8. From the menu, select one of the following spare drive types: 9.
10. Click Save. 11. A confirmation screen appears. Click Yes to continue. 12. Click Manage Spare Drives to make additional selections, or click Finish. Cache Manager Caching increases database performance by writing data to the cache memory, instead of directly to the logical drives. Caching can be disabled to reserve the cache module for other logical drives on the array. To enable HP SmartCache: 1. Open HP SSA. For more information, see "Using the HP SSA GUI (on page 16)." 2. 3.
4. Click Controller Cache in the Cache Manager menu. 5. Click Caching Settings. 6. Select one or more logical drives to be cached.
7. Verify caching settings. 8. Click OK. About HP SmartCache HP SmartCache enables solid state drives to be used as caching devices for hard drive media. Data can be accessed from the solid state drive instead of hard drives.
3. Select Cache Manager from the Tools menu. 4. Click Enable HP SmartCache in the Actions menu. 5. Select one or more physical drives from the list of available drives. 6. Click OK.
7. A pop-up window appears, indicating certain features will not be available with HP SmartCache enabled. If you want to continue, click Yes. 8. Create SmartCache for Logical Drive appears. 9. Select the logical drive to cache. 10. Select the size of the cache. HP recommends 10% of the drive size, and it must be a minimum of 1 GiB. 11. Click Create SmartCache for Logical Drive.
12. Smart Cache Details, SmartCache Statistics, and Device Path appear. Click Finish to proceed. The SmartCache is created for the Logical Drive. Installing a license key with HP SmartCache You can use HP SSA to install the license key and activate HP SmartCache functionality. To install a license key: 1. Open HP SSA. For more information, see "Using the HP SSA GUI (on page 16)." 2. 3.
4. Under actions, click Add License Key. 5. Enter the license key number. 6. Click Save. Working with mirrored arrays Among the advanced tasks possible with the HP SSA GUI, you can split a mirrored array and then recombine it. This process entails splitting a RAID 1 or RAID 1+0 mirror into two identical new arrays consisting of RAID 0 logical drives. Support for these procedures requires the following: • The HP SSA GUI must be run in offline mode.
4. From the Arrays menu, select the appropriate array. 5. Select Manage Data Drives from the Actions panel. 6. Under Available Array Action(s), select Mirror Array. 7. Select a physical drive. 8. Click OK. The mirrored array details are displayed. 9. Click Finish. 10. When HP SSA finishes splitting the array, two logical drives appear in the Arrays menu: o When a RAID 1 or RAID 1+0 array splits, two RAID 0 logical drives are created.
Creating a split mirror backup This task splits an array that consists of one or more RAID 1, RAID 1+0, RAID 1 (ADM), or RAID 10 (ADM) logical drives, and then creates two arrays: a primary array and a backup array. To create a split mirror backup: 1. Run the HP SSA GUI in offline mode. See "Accessing HP SSA in the offline environment (on page 10)." 2. Open the Configure panel by doing one of the following: o Choose a device and click Configure in the quick navigation menu.
o Re-mirror the array and roll back to the contents of the backup array. Discard existing data. This option re-creates the mirrored array but restores its original contents, which are in the backup array. HP recommends that you do not perform this option under the following circumstances: — In an online environment — If the logical drive to be rolled back is mounted — If the logical drive to be rolled back is in use by the operating system o Activate the backup array.
• All existing logical drives in the source array must be in OK state. • The destination array must have sufficient capacity to hold all logical drives present in the source array. Setting Auto RAID 0 CAUTION: If you select this option for any logical drives, you will experience data loss for that logical drive if one physical drive fails. Assign RAID 0 to drives that require large capacity and high speed, but pose no data safety risk.
4. A new window appears, confirming each array will contain a single RAID 0 logical drive. Click Yes to continue.
5. A new window appears, confirming RAID 0 configuration. Click Finish to complete. Diagnostic tasks The HP SSA Diagnostics feature replaced the Array Diagnostic Utility supported by SmartStart v8.20 and earlier. HP SSA generates the following reports and logs: • Array diagnostic report This report contains information about all devices, such as array controllers, storage enclosures, drive cages, as well as logical, physical, and tape drives.
• View SmartSSD Wear Gauge Report • Save SmartSSD Wear Gauge Report For the view tasks, HP SSA generates and displays the report or log. For the save tasks, HP SSA generates a report without the graphical display. For either task, you can save the report. In online and offline environments, HP SSA saves the diagnostic report to a compressed folder, which contains an XML report, a plain text report, and a viewer file so you can display and navigate the report through a web browser.
The Actions panel for Array Diagnostic Report appears. 5. Click one of the task buttons: o If you select View Diagnostic Report, the report appears. When you are finished viewing the current report, click Close or Save. If you select Save Diagnostic Report, wait for the report to generate, and then click Close Report or Save Report.
• Command mode ("Opening the CLI in Command mode" on page 47) You can make an isolated change of just one configuration parameter on one device. For VMware ESXi 5.x, HP SSA CLI works similarly to the Command mode. However, slight differences exist, requiring you to run HP SSA CLI through the VMware vSphere esxcli command-line utility. For more information about using HP SSA CLI for ESXi 5.x, see the HP VMware Utilities User Guide.
a required variable and plain brackets to denote an optional variable, the structure of a typical HP SSA CLI command line is as follows: [parameter=value] The variable This variable provides the path to the device that you want to configure. The device can be a controller, an array, a logical drive, or a physical drive.
A typical screen response in this case could be: Available options are: 8 16 (current value) 32 64 128 (default) 256 To determine which parameters can be queried, use the help feature of the CLI ("The help command" on page 52). Hiding warning prompts When you enter a command for an operation that can potentially destroy user data, the CLI displays a warning and prompts you for input (a y or an n) before continuing the operation. This situation is undesirable when running batch file scripts.
Keyword Abbreviation in HP SSA CLI Keyword Abbreviation in HP SSA CLI exitonerror eoe surfacescandelay ssd expandpriority ep surfacescanmode ssm inconsistencyrepairpolicy irp sufacescanpriority sp licensekey lk surfacescanschedule sss logicaldrive ld tapedrive td mnpdelay mnpd waitforcacheroom wfcr *The CLI also uses this keyword and abbreviation for the terms box name and RAID array ID. The show command The show command enables you to obtain information about a device.
Post Prompt Timeout: 15 secs Cache Board Present: True Cache Status: OK Accelerator Ratio: 10% Read / 90% Write Drive Write Cache: Disabled Total Cache Size: 1024 MB Total Cache Memory Available: 816 MB No-Battery Write Cache: Disabled Cache Backup Power Source: Capacitors Battery/Capacitor Count: 1 Battery/Capacitor Status: OK SATA NCQ Supported: True Spare Activation Mode: Activate on drive failure Controller Temperature (C): 40 Cache Module Temperature (C): 0 Capacitor Temperature Boot Controller:
physicaldrive 1:1:2 (port 1:box 1:bay 2, SAS, 36 GB, OK) physicaldrive 1:1:8 (port 1:box 1:bay 8, SAS, 9.1 GB, OK) physicaldrive 1:1:10 (port 1:box 1:bay 10, SAS, 9.1 GB, OK) physical physicaldrive 1:1:11 (port 1:box 1:bay 11, SAS, 9.1 GB, OK) Displaying the current versions of the application layers The version command displays the current versions of the application and other software layers. Syntax: version Example command: version A typical output would be: HP SSA CLI Version: 1.XX.X.
where is a controller with a volume that can be set as the boot volume. Example command: controller slot=1 modify bootcontroller=enable Setting the boot volume This procedure is only available in the offline environment. The boot volume is the volume that contains the OS and its support files. To work properly, the boot volume must be accessible by the designated boot controller. See "Setting the boot controller (on page 52).
The controller does not need to be specified because it is currently the set target. Now clear the target, reset it, and enter a few commands for the new set target: => clear target => set target ctrl slot=3 => array A add drives=1:7,1:8,1:9 => array B add spares=1:10,1:11 => ctrl slot=4 ld 3 modify ss=64 => modify rp=high This sequence includes a command for a different target (the controller in slot 4) as a demonstration.
• is a controller or all controllers. • designates the target file in which the diagnostic information is saved. • [ris=on|off] determines whether RIS information is or is not included. The off value is provided for backward compatibility and is ignored. • [ssdrpt=on|off] specifies to generate or not generate the Smart SSD Wear Gauge report. The default is off. • [xml=on|off] outputs diagnostic information in formatted XML.
Example commands: => ctrl slot=5 lk=12345-65432-78787-43434-24680 delete => ctrl slot=4 add lk=9876543210222224444466666 Optimizing controller performance for video On some controller models, you can optimize the controller performance for video. To use this features on an HP Smart Array G6 or G7 controller, a registered SAAP ("About SAAP" on page 121) license key is required.
Parameter Acceptable values Comments size #|min|max|maxmbr|? sectors 32|63|default|? This parameter determines the desired size of the logical drive. Units are MB.* The default setting is max. aa enable|disable|? drivetype The default setting depends on the operating system. The default setting is enable. sas|satalogical|sata|saslogical|par — allelscsi|ss_sas|ss_sata|? *Use only these units. Do not enter any extra text in the command to specify the units.
=> ctrl ch="Lab 4" pd all show In this case, the screen response is: MSA1000 at Lab 4 array A physicaldrive 1:1:12 (port 1:box 1:bay12, Parallel SCSI, 36.4 GB, OK) unassigned physicaldrive 1:1:13 (port 1:box 1:bay13, Parallel SCSI, 9.1 GB, OK) physicaldrive 1:1:14 (port 1:box 1:bay14, Parallel SCSI, 9.1 GB, OK) Create the second array on the two remaining physical drives.
When moving the logical drive, you can choose one of the following destinations: • An existing array • A new array you create To move a logical drive to an existing array, use the following information. Syntax: modify [newarray=] Command examples: ctrl slot=1 ld 3 modify newarray=C ctrl slot=1 ld 3 modify newarray=? // shows the available arrays To move a logical drive and create a new array, use the following information. Syntax: modify [drives=[#: ]#:#,[#: ]#:#,[#: ]#:#–[#: ]#:#,.
Example commands: controller slot=5 ssdpd all show controller slot=5 ssdpd all show detail Viewing SSD information The ssdinfo keyword provides a summary for solid state drives for the specified controller.
SSD Over Provisioning Optimization Access to solid state devices can be optimized by deallocating all used blocks before any data is written to the drive. The optimization process is performed when the first logical drive in an array is created, and when a physical drive is used to replace a failed drive. Not all controllers support this option. This feature is disabled by default in the CLI.
=> ctrl slot=4 array all add spares=1:5,1:7 => ctrl slot=5 array A add spares=1:1–1:5 => ctrl slot=5 array A remove spares=1:1–1:5 Setting the spare activation mode The spare activation mode feature enables the controller firmware to activate a spare drive under the following conditions: • When a data drive reports a predictive failure (SMART) status • When a data drive fails; this mode is the default.
where is an array (or a logical drive, if the array contains only one logical drive). The forced parameter represses any warning message prompts. If you specify a drive range, any drives in the range that do not meet the previous criteria are not used. If you add an odd number of drives to an array that contains a RAID 1+0 logical drive, you are prompted to convert the RAID 1+0 logical drive to RAID 5 or RAID 6 (ADG). Adding the forced parameter to the command prevents this prompt from appearing.
Like array creation and expansion, the useable space in all drives is reduced to the size of the smallest physical drive in the destination disk set. Moving an array automatically removes any previously assigned spare drives. If spares are assigned to the existing array, they must be designated for the array when it is moved. Syntax: modify drives=[#:]#:#-[#:]#:# spares=[#:]#:#-[#:]#:# where is an array, and the specified physical drives are the new destination for the array.
one RAID 0 logical drive. For more information about RAID 0, see "RAID 0—No fault tolerance (on page 109)." Example command: => ctrl slot=1 create type=arrayr0 drives=allunassigned Extending a logical drive If the operating system supports logical drive extension, you can use any unassigned capacity on an array to enlarge one or more of the logical drives on the array. IMPORTANT: An array expansion, logical drive extension, or logical drive migration takes about 15 minutes per gigabyte.
• If you do not specify a stripe size, the CLI uses the default stripe size value for the RAID level that you specify. Example commands: => ctrl slot=3 ld 1 modify raid=1 => ctrl slot=4 ld 2 modify ss=16 => ctrl slot=2 ld 3 modify raid=5 ss=16 Setting the preferred path mode The preferred path mode determines how I/O traffic to the logical drives is managed on controllers that are in an active/active configuration.
Changing the Rebuild Priority setting The Rebuild Priority setting determines the urgency with which the controller treats an internal command to rebuild a failed logical drive. • At the low setting, normal system operations take priority over a rebuild. • At the medium setting, rebuilding occurs for half of the time, and normal system operations occur for the rest of the time. • At the medium high setting, rebuilding is given a higher priority over normal system operations.
Changing the surface scan delay time The setting for the surface scan delay determines the time interval for which a controller must be inactive before a surface scan analysis is started on the physical drives that are connected to it. Surface scan analysis is an automatic background process that ensures that you can recover data if a drive failure occurs.
where is a controller that supports drive write cache. Example command: => ctrl slot=5 modify dwc=enable Enabling or disabling the array accelerator If the controller has an array accelerator, you can disable or enable it for specified logical drives. NOTE: Disabling the array accelerator for a logical drive reserves use of the accelerator cache for other logical drives on the array.
The backup array always contains RAID 0 logical drives. The primary array continues to be fully accessible to the OS while the backup array is hidden from the operating system. The "remirror" action remirrors the array and preserves the existing data. Discard the backup array. This option recreates the original mirrored array with the contents of the primary array. The "rollback" action remirrors the array and rollback to the contents of the backup array. Discard existing data.
Then, enter the following command at the system command line prompt: hpssascripting -i FILENAME [-internal | -external] [-reset] -e FILENAME The -i switch information specifies the input file to use. The -internal and -external switches limit configuration operations to internal or external controllers. The -reset flag destroys any existing data and overwrites the current configuration with the configuration specified in the script. The -e switch information allows the user to rename an error file.
You can use this script as a template for your own script. Action = Configure|Reconfigure Method = Custom Controller = All|Slot [N][:N] | WWN [N] | First | SerialNumber [N] | IOCabinet [N],IOBay [N],IOChassis [N],Slot [N],Cabinet [N],Cell [N] ClearConfigurationWithDataLoss = Yes|No |Forced LicenseKey = XXXXX-XXXXX-XXXXX-XXXXX-XXXXX DeleteLicenseKey = XXXXX-XXXXX-XXXXX-XXXXX-XXXXX | * ; COMMENT: * is a wild card that enables you to delete all license keys on the specified controller.
Sizeblocks = N ShrinkSize = N NumberOfParityGroups = N NPG (same as NumberOfParityGroups) Sectors = 32|63 StripSize = 8|16|32|64|128|256|512|1024 ArrayAccelerator = Enable|Disable ; Caching Logical Drive Options CachingLogicalDrive = 1|2|3… max Volumes/2 RAID = 0|1 ;FW and Controller dependent Size = N Sample custom capture script Running SSA Scripting in capture mode captures the configuration of all array controllers on the server in a capture file.
Drive= 2E:1:1 OnlineSpare= No ; Logical Drive Specifications LogicalDrive= 1 RAID= 0 Size= 139979 Sectors= 32 StripeSize= 128 ArrayAccelerator= Enabled Sample encryption script Initial encryption configuration When the controller is new and unconfigured, or after the user has executed the "EncryptionClearConfig" command to delete the encryption configuration, the user must initialize the encryption parameters before first use of the controller.
AllowPlainText= false When creating volumes, you can set an additional volume option to determine whether the volume will be encrypted or plaintext. You must first log in as the Crypto Officer user to use this feature. By default, volumes are encrypted. Action= Configure Method= Custom Controller= SLOT 1 EncryptionUser= crypto EncryptionPassword= Password.
Category Options Description Control Action Method These options define the overall behavior of HP SSA when it processes scripts and creates configurations. Control options can occur only once in a script file and must be listed first.
Action mode You must specify an Action mode: • In Configure mode, you can create new arrays, but you cannot modify existing arrays. The controller must be connected to unassigned physical drives for this mode to be available. • In Reconfigure mode, you can modify existing arrays. For example, you can set up an array expansion, a logical drive extension, or a migration. These procedures do not destroy data, unless you specifically want the data to be deleted.
Controller You must enter a value for this option because it identifies the controller that you want to configure: • All—Configure all detected internal and external controllers in the system. • Slot N[:N]—Configure the internal controller in slot number N. External controllers can be identified by appending the Port Number. • WWN N—Configure the external controller that has the World Wide Name N. • SerialNumber N—Configure the shared storage controller that has serial number N.
IRPEnable The IRPEnable option controls the behavior of the controller Inconsistency Repair Policy. This option is used to tune the controller performance for Video applications and requires the installation of a valid license key. Command options are Enable or Disable. LicenseKey, DeleteLicenseKey These options enable you to enter a 25-character license key to activate or uninstall some controller features. Hyphens can be entered, but are not required.
The allowable cache ratios depend on the controller model and whether it has battery-backed write cache. RebuildPriority, ExpandPriority These options establish the priority for rebuild and expand functions. Rebuild has four possible values: Low, Medium, MediumHigh, and High. MediumHigh is only available when Rapid Parity Initialization is enabled. Expand has only three possible values: Low, Medium, and High. These options are not required.
• Array (on page 81) • CachingArray (on page 81) • Drive (on page 82) • DriveType (on page 82) • Join • OnlineSpareMode (on page 82) • OnlineSpare (on page 83) • Split ("SplitMirror" on page 83) Array Enter a letter or pair of letters to identify the array that is to be created or reconfigured, and observe these additional limitations: • In Configure mode, HP SSA creates a new array.
Drive You can use this option in the input file to specify new physical drives for the array. Use this option to build a new array or to expand, shrink, or move an existing array. Observe the following guidelines: • If you are expanding an array, each drive that you add must have a capacity no less than that of the smallest drive already in the array. The added drives and the existing drives in the array must all be the same type (for example, SAS or SATA).
Behavior Description AutoReplace The spare drive becomes a data drive when the rebuild is complete. AutoReplace spares cannot be shared across arrays. OnlineSpareMode is only supported on select HP Smart Array Px2x controllers and later. OnlineSpare The value for this option determines whether the array specified previously in the script will be configured with spare drives. The interface type for drives and spare drives must match, for example, all SAS or all SATA. • X:Y,...
• ArrayAccelerator (on page 84) • LogicalDrive (on page 84) • CachingLogicalDrive (on page 84) • CachedLogicalDrive (on page 84) • NumberOfParityGroups (on page 85) • PreferredPath (on page 85) • RAID (on page 85) • Renumber (on page 86) • Repeat (on page 86) • ResourceVolumeOwner • Sectors (on page 86) • ShrinkSize • Size (on page 86) • SizeBlocks (on page 87) • StripeSize • StripSize (on page 87) ArrayAccelerator This option specifies whether the array accelerator is enable
In Configure mode, HP SSA accepts the ID number of any existing logical drive. Caching logical drives and cached data drives must be on the same Array Controller. NumberOfParityGroups When you create a RAID 50 or RAID 60 configuration, you must also set the number of parity groups. You can use any integer value greater than 1 for this setting, with the restriction that the total number of physical drives in the array must be exactly divisible by the number of parity groups.
When using an HP Smart Array G6 or G7 controller, some RAID levels require SAAP ("About SAAP" on page 121). RAID levels supported in a Caching Local Volume are limited by the firmware. Renumber This option renumbers the logical drive to N. Typically used after a Join command, this option ensures the proper logical volume numbering is set, for example, the boot volume is ID 1.
• N—The size in MB • MAX—Uses all available unused space in the array for the logical drive. This value is the default. • MAXMBR—Creates the largest size of volume supportable by a 32-bit MBR (2TiB) In Reconfigure mode, the default setting is the existing size of the logical drive. If you enter a larger value, HP SSA extends the logical drive to the new size if there is unused drive capacity on the same array, as long as the operating system supports logical drive extension.
• 512—512 KB • 1024—1024 KB (supported starting with Gen8 controllers) The default strip size value depends on the action mode: • In Configure action mode, the default value is determined by the RAID level that you specified earlier in the script. • In Reconfigure action mode, the default value for this option is the strip size that is already configured for the logical drive.
EncryptionClearConfig This command deletes all secrets and Critical Security Parameters from the controller. This command does not delete or modify any existing logical volumes. However, if the volumes are encrypted, they will be placed into an offline state by the controller. If any encrypted logical volumes exist on the controller, this command must be run offline. To run this command, enter the value KeyName. The KeyName is required if encrypted logical volumes exist on the controller.
EncryptionUserPasswordSet This command sets the encryption password for the User role. The command value is the password. FirmwareLock This command toggles the array controller firmware through the values Lock and Unlock. Firmware must be unlocked prior being updated. Encryption logical volume category The following commands have been added to HP SSA Scripting versions 1.60.0.0 and later to support data encryption features introduced with select Gen8+ controllers.
