HP Microsoft Windows Server 2003 for Itanium-based Systems manual Using the Command Line Interface

Page 43

Using the Command Line Interface

In this section
Overview of the ACU CLI	43
Typical procedures	45

Overview of the ACU CLI

The ACU CLI is an interactive command console that provides immediate feedback to the user and is functionally equivalent to the ACU GUI.

The executable for the CLI is available from the HP PSP for Microsoft® Windows® or from the HP website.

Running the CLI

You can open the CLI in either Console mode or Command mode. In Console mode, you can adjust several configuration parameters on several devices without having to restart ACU each time. Command mode is more suitable for an isolated change of just one configuration parameter on one device.

The syntax of the command required to open the ACU CLI depends on the operating system that you are using and the mode that you want to use.

•Console mode

Windows:

C:\Program Files\Compaq\Hpacucli\Bin\hpacucli.exe

Alternatively, click Start, and navigate to Programs > HP System Tools > HP Array

Configuration Utility CLI. Linux:

[root@localhost root]# hpacucli

After you have entered Console mode in either operating system, the screen displays the following message and console prompt:

HP Array Configuration Utility CLI 7.15.17.0 Detecting Controllers...Done.

Type "help" for a list of supported commands. Type "exit" to close the console.

=>

•Command mode

To use Command mode, add the specific ACU CLI command ("The <command> variable" on page 44) to the end of the text line used to open ACU in Console mode before you press the Enter key. The following examples use help as the specific ACU CLI command.

Windows:

C:\Program Files\Compaq\Hpacucli\Bin\hpacucli.exe help

Linux:

[root@localhost root]# hpacucli help

Using the Command Line Interface 43

Image 43

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 ConnectionName ACU 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