User guide

ChassisName
Enter the user-defined character string that identifies the controller. You can use any of the following
characters in the string:
a–z, A–Z, 0–9, !, @, #, *, (, ), ,, -, _, +, :, ., /, [space]
You do not need to use quotation marks around the string, but doing so allows the string to begin
with a space character. However, the string cannot end with a space character.
Currently, only shared-storage controllers such as the RA4x00, MSA1000, and Smart Array Cluster
Storage support the ChassisName option. The RA4x00 controller uses a 24-character string, while
other applicable controllers use a 20-character string.
ClearConfigurationWithDataLoss
This command is now deprecated.
The default value for this option is No. Clearing the configuration causes data loss because it
deletes all logical volumes and arrays on the controller. If you clear a configuration, you can write
commands later in the script file to create a new configuration from the liberated drive capacity.
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.
PreferredPathMode
The setting that you select for this option determines how the preferred I/O path to a particular
logical drive is set for a redundant array controller that is in an active/active configuration.
Not all controllers support this feature, and controllers in an active/standby configuration disregard
this option.
• Auto is the default setting for new configurations. In this case, the storage system automatically
selects the I/O path from the redundant controller to the logical drive and dynamically load
balances all paths.
• Manual enables you to assign the logical drive to a specific redundant controller. If you select
this setting, use the PreferredPath command to specify the path.
If you are reconfiguring a controller and do not specify a setting for this option, the existing setting
remains the same.
ReadCache, WriteCache
Enter a number between 0 and 100 to specify the percentage of cache to be allocated to drive
reads or writes. The default value for both options is 50.
The allowable cache ratios depend on the controller model and whether it has battery-backed
write cache, as described in the following table.
A "+" indicates that the specified cache ratio is allowed for that type of controller, while a "–"
indicates that the ratio is not allowed.
All other controllers
without
battery-backed write
cache
All other controllers
with battery-backed
write cache
RA4x00 with 48MB
cache
RA4x00 with 16MB
cache
Read:write ratio
++++100:0
––++90:10
––++80:20
–+––75:25
Using HPACUSCRIPTING 35