HP Microsoft Windows Server 2003 for Itanium-based Systems Scripting in ACU, Operating modes

Page 31

Scripting in ACU

In this section
Introduction to scripting in ACU	31
Operating modes	31
Command line syntax	31
Sample custom input script	32
Script file options	33
Error reporting	39

Introduction to scripting in ACU

ACU provides scripting support to enable you to configure array controllers in a customized, predictable, and unattended manner.

Each line of text in an ACU script file is written in the format option=value and can be in either uppercase or lowercase letters. You can improve the clarity of the script by leaving lines blank and by creating comments. To create a comment, enter a semicolon and then the comment text. ACU ignores all text on the same line after a semicolon.

Operating modes

Scripting in ACU has two modes of operation:

•In Capture mode, the configuration of all internal and external array controllers that are connected to a server is saved to a script file. You can then use the script file to replicate the array configuration on other servers that have similar storage resources.

NOTE: You can also perform array replication by using the HP Array Configuration Replicator (ACR). However, the two utilities are not functionally identical. ACU can read unmodified capture files from ACR, but ACR cannot necessarily use ACU files.

•In Input mode, the array configuration that is specified in a script file is applied to a target system. The script file can be an unmodified or modified capture file, or you can write the script file from scratch.

Input mode is subdivided into Automatic and Custom configuration modes.

•In Automatic mode, you can enter the values for a few critical options and allow ACU to use default values for all other options.

•In Custom mode, you can specify every detail of the array configuration.

Command line syntax

In Capture mode:

cpqacuxe -c FILENAME

Scripting in ACU 31

Image 31

Contents HP Array Configuration Utility User Guide Audience assumptions Contents Diagnosing array problems This section Features and system requirementsInstalling ACU Getting startedSetting the execution mode for Microsoft Windows Overview for using ACUComparison of ACU execution modes Choosing an operating mode Opening ACU in Local Application modeHttp//servername2301 Opening ACU in Browser modeSelect Device Queries Opening ACU through Systems Insight ManagerGUI operating modes Typical Standard mode screenTypical Configuration Wizards mode screen Typical Express Configuration mode screen Completing the configuration processUsing Standard Configuration mode Configuring a new controllerPossible tasks in Standard Configuration mode Using Express Configuration mode Click Create an array, and then click Begin Using the configuration wizardsCreating an array Click FinishConfiguring a new controller Click Create a logical drive, and then click Begin Creating a logical driveConfiguring a new controller Modifying a configuration using Standard Configuration mode Modifying an existing configurationChoices available after opening ACU Click Express Configuration, and then click Begin Modifying a configuration using Express modeModifying a configuration using the Configuration wizards Clear ConfigurationClick Controller Settings, and then click Begin Controller settingsCreate an array Create a logical drive Delete arrays Expand Array Delete logical drivesClick Delete logical drives, and then click Begin Click Migrate a logical drive, and then click Begin Extend logical driveMigrate a logical drive Click Extend logical drive, and then click BeginClick Spare Management, and then click Begin Spare managementSelective Storage Presentation RA4x00 controllersMSA and Smart Array Cluster storage controllers Click ACU Switch Configuration Configuring switchesRecombining a split, mirrored array Splitting a mirrored arrayModifying an existing configuration Operating modes Command line syntaxScripting in ACU Introduction to scripting in ACUCpqacuxe -i Filename Sample custom input scriptDescription of option categories in ACU scripting Script file optionsMethod Control categoryController category ActionRAIDArrayID ClearConfigurationWithDataLossController LicenseKey, DeleteLicenseKeySSPState SurfaceScanDelayArray category RebuildPriority, ExpandPriorityLogicalDrive Logical Drive categoryOnlineSpare DriveArrayAccelerator SizeSectors StripeSizeHostMode Error reportingSSPAdaptersWithAccess ConnectionNameACU scripting error messages 0-9, !, @, #, *, , , ,, -, , +, , ., /, and space. The ID Current configuration Overview of the ACU CLI Using the Command Line InterfaceRunning the CLI Target variable Command variableCLI syntax Keyword abbreviationsQuerying a device Typical proceduresExample command Hiding warning promptsSyntax Sample scenarioModifying the controller chassis name Example commandsExample Sample scenario Using Selective Storage PresentationManaging host modes connection profiles Modifying connection namesExtending a logical drive Deleting target devicesIdentifying devices Expanding an arrayTarget modify size=#max? forced Target modify raid=01+0156adg? ss=8163264128256default?Managing spare drives Migrating a logical driveChanging the Expand Priority setting Changing the Rebuild Priority settingChanging the controller cache ratio Re-enabling a failed logical drive Changing the surface scan delay timeEnabling or disabling the drive cache Typical scenario Setting the targetEnabling or disabling the array accelerator Disabling a redundant controller= rescan Rescanning the systemFactors involved in logical drive failure Probability of logical drive failureProbability of logical drive failure Drive arrays Drive arrays and fault-tolerance methodsDrive arrays and fault-tolerance methods Hardware-based fault-tolerance methods Fault-tolerance methodsAdvantages RAID 0-No fault toleranceDisadvantages RAID 1+0-drive mirroring RAID 6 ADG-Advanced Data Guarding RAID 5-distributed data guardingRAID RAID 6 ADG Comparing the hardware-based RAID methodsSelecting a RAID method Alternative fault-tolerance methodsPost messages Diagnosing array problemsDiagnostic tools Server DiagnosticsAcronyms and abbreviations SSP Index Index