Software Instruction Manual

HP SmartStart Scripting Toolkit Windows Edition
User Guide
Part Number 415598-403
June 2010 (Twelfth Edition)

Summary of content (74 pages)

80 86 25 a3 00 00 fa 41 0e 11 ff ff 00 00 78 c1
CONREP -s (Store to Data file) Example usage for HP ProLiant 100 series servers To extract the BIOS settings from an SL160z

  • PAGE 39

    CONREP –l (Load from Data File) Example Usage for HP ProLiant 100 series servers To load the BIOS configuration settings from a previously captured/edited data file (in this case “sl160zconrep.dat”) to an SL160z G6 server: [root@ilo002481b08134 conrep]# ./conrep -l -xconrepSL160zg6_20090728.xml -fsl160zconrep.dat conrep 3.00 - SmartStart Scripting Toolkit Configuration Replication Program Copyright (c) 2007-2009 Hewlett-Packard Development Company, L.P.

  • PAGE 40

    Auto Set
    COM1
    IRQ4
    Disabled
    Undefined
    LPT1
    IRQ7
    Writes_Enabled
    Disabled
    Disabled
  • PAGE 41

    ACU reads the array configuration described in a specified script file. See "Creating an ACU script file (on page 41)." ACU then applies this configuration to a target system. Capturing a configuration To capture the configuration of a system, enter the following command at the system command line prompt: hpacuscripting -c [drive:][path]OUTPUTFILENAME.ext [-internal | external] -e [drive:][path]ERRORFILENAME.ext OUTPUTFILENAME is the name of the capture file, and ext. is the file extension.

  • PAGE 42

    You can add blank lines and comments to any script to make it easier to read and understand. To create a comment, enter a semicolon, and then enter the comment text. ACU ignores all text on the same line after a semicolon. Sample custom input script The sample script in this section gives all possible values for each option. • If an option is shown in bold type, you must enter a value for that option when writing your own script.

  • PAGE 43

    Array = A|B|C|D|E|F|G|...Z|a|b|c|d|e|f OnlineSpare = None | N | Port:ID,Port:ID... | Box:Bay,Box:Bay... | Port:Box:Bay,Port:Box:Bay,... ; COMMENT: These values are available only in Custom method mode. In Auto method mode, the choices are Yes|No. Drive = * | N | Port:ID,Port:ID... | Port:Box:Bay,Port:Box:Bay,... Box:Bay,Box:Bay... | DriveType = SCSI | SAS | SATA LogicalDrive = 1|2|3|...

  • PAGE 44

    Category Options Description Control Action These options define the overall behavior of ACU when it processes scripts and creates configurations. Control options can occur only once in a script file and must be listed first.

  • PAGE 45

    • Method mode (on page 45) 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.

  • PAGE 46

    • Slot [N][:M]—Configure the internal controller in slot number N, or the external controller at port M in slot N. • 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. • IOCabinet[N],IOBay[N],IOChassis[N],Slot[N],Cabinet[N],Cell[N]—Configure the controller in the Integrity server that has the slot path information defined by this sequence of identifiers.

  • PAGE 47

    ReadCache, WriteCache Enter a number between 0 and 100 to specify the percentage of cache that is 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.

  • PAGE 48

    SurfaceScanDelay Enter a number between 1 and 30 to specify the duration of the surface scan delay in seconds. Video performance options To optimize the controller performance for video, set values for the following options as indicated: DPOEnable = No ElevatorSortEnable = Yes IRPEnable = No In addition: • Set the MNPDelay to any integer value from 1 to 60 (units are minutes). If you want to disable this option, set a value of zero instead.

  • PAGE 49

    If you use Custom method mode, choose one of the following methods to specify the drives to be used in the array. (Different arrays on the same controller can use different methods.) • To specify individual drives, use the applicable convention (port:ID, box:bay, or port:box:bay). • To specify only the number of drives to use (not which specific drive IDs to use), enter that number as the value for this option.

  • PAGE 50

    • Sectors (on page 51) • Size (on page 51) • SSPAdaptersWithAccess (on page 51) • StripeSize (on page 51) ArrayAccelerator This option specifies whether the array accelerator is enabled or disabled for the specified logical drive. The default value is Enabled. LogicalDrive The value that you enter for this option specifies the ID number of the logical drive that is to be created or modified.

  • PAGE 51

    RAID The value that you enter for this option specifies the RAID level of the logical drive. • When the Action mode is Configure, and the Method mode is Auto, ACU automatically selects the highest RAID level that the controller and drive configuration can support except RAID 50 or RAID 60. To specify RAID 50 or 60 for a controller that supports either of these RAID levels, use the Custom setting. In this case, you must also specify the number of parity groups ("ParityGroups" on page 50).

  • PAGE 52

    • For RAID 0, RAID 1, or RAID 1+0 arrays, you can enter any of the stripe size values listed in the sample script. • For RAID 5 arrays, the maximum stripe size in most cases is 256 KB, but old controller models are often limited to 64 KB. • For RAID 6 arrays, the maximum stripe size is either 64 KB or 256 KB, depending on the controller. The default stripe size value depends on the action mode.

  • PAGE 53

    • Microsoft® Windows® • OpenVMS • Tru64 • Linux • Solaris • Netware • HP-UX ACU scripting error messages Error code Error message Comment or clarification 1 General error. The ACU process cannot be initiated. You might see this error message if you are not authenticated to use ACU or if ACU is already running. 268 Error saving controller. ACU cannot save one or more controller configurations. 278-282 Controller is locked by another machine or user.

  • PAGE 54

    Error code Error message Comment or clarification 1112 Controller has maximum number of license keys. — 1114 Controller requires nonfailed physical drives to set license keys. — 2564 Controller is locked by another machine or user. — 2818 Invalid Method. The scripted Method value is not valid. 2819 Invalid Controller. The scripted controller does not match any existing controllers. 2820 Could not detect controller . — 2821 No controllers detected.

  • PAGE 55

    Error code Error message Comment or clarification 2834 Invalid logical drive. — 2835 Logical drive not specified. The script file has commands that require a logical drive, but no logical drive is specified. 2836 New logical drive ID does not match the next available logical drive ID. The script file specifies a logical drive ID that is not the first unused ID in the sequence.

  • PAGE 56

    Error code Error message Comment or clarification 2851 Invalid RAID Array ID. The scripted RAID Array ID is invalid. Use characters from the set a–z, A–Z, 0–9, !, @, #, *, (, ), ,, -, _, +, :, ., /, and [space]. The ID cannot end with a space character or exceed the maximum number of characters allowed by the controller. 2852 Invalid SSP state. — 2853 Cannot change SSP settings. — 2854 Invalid SSP adapter ID. — 2855 Controller does not support logical drive SSP states.

  • PAGE 57

    Error code Error message Comment or clarification 2876 Invalid physical drive count. The script specifies more drives than are available of the specified drive type. 2877 No spares available. No drives were found that could be used as spares for the specified array. 2878 Spare request for RAID 0 is invalid. RAID 0 does not support spares. 2879 Reset and reconfigure combined error. A controller reset with data loss was specified while in Reconfigure mode. 2880 Invalid drive type specified.

  • PAGE 58

    Command-line argument Description BootDeviceLUN[0]=1111 Your input, default LUN, or current value when read from HBA HPLPCFG return codes Value Meaning 0 The command was completed successfully. 1 There was an invalid command line option. 2 There was a file open error. 3 There was an NVRAM checksum error. 4 There was an NVRAM data error. 5 There was no adapter or Emulex HBA found on this host. 6 There was an error retrieving the I/O address.

  • PAGE 59

    You must then invoke the tool to load the contents of hba.ini input to the HBA NVRAM: hplpcfg /l hba.ini. Using HPONCFG The HPONFCG utility only supports HP ProLiant 300/500/700 and Blade servers. HP offers support for the RILOE II, iLO, iLO 2, and iLO 3 features available on ProLiant servers with the HPONCFG utility. HPONCFG is an online configuration tool used to set up and reconfigure RILOE II, iLO, iLO 2, and iLO3 without requiring a reboot of the server operating system.

  • PAGE 60

    Command-line argument Description performing any additional actions. -mouse This argument causes HPONCFG to configure the server for optimized mouse handling. HPONCFG return codes Value Meaning 0 The script was sent successfully to the device, or there is no RILOE II, iLO, iLO 2, or iLO 3 present in the system. 1 The script could not be sent to the device. If the script itself fails, errors are reported in the log file created by HPONCFG.

  • PAGE 61

    PAGE 62

    Setting a configuration A specific configuration can be sent to the iLO, iLO 2, iLO 3, or RILOE II by using the command format: HPONCFG /f add_user.xml /l log.txt In this example, the input file has contents: PAGE 63

    Command-line argument Description SelectBootEnable=1 Read-only variable BootDeviceWWID=22334455 Your input BootDeviceLUN[0]=1111 Your input and default LUN HPQLAREP return codes Value Meaning 0 The command was completed successfully. 1 There was an invalid command line option. 2 There was a file open error. 3 There was an NVRAM checksum error. 4 There was an NVRAM data error. 5 There was no adapter found on this host. 6 There was an error retrieving the I/O address.

  • PAGE 64

    WWID=11111111 HostAdapterBiosEnable=1 SelectBootEnable=1 BootDeviceWWID=22222222 BootDeviceLUN[0]=3 You must then invoke the tool to load the contents of hba.ini input to the HBA NVRAM: hpqlarep /l hba.ini. Using LO100CFG LO100CFG enables you to configure the LightsOut 100 device that appears on the HP ProLiant 100 series servers. Under Windows®, WMI is used through the Microsoft_IPMI class, make sure WMI is installed in the Windows® PE environment.

  • PAGE 65

    LO100CFG command file contents A typical data file generated by LO100CFG is similar to the following: /> PAGE 66

    Troubleshooting Troubleshooting table Issue Troubleshooting Data loss in Toolkit Improper use of the Toolkit utilities and modification of the CONREP data files can result in loss of critical data. Because of the potential data-loss risk, only experienced individuals should use the Toolkit utilities. Before using the Toolkit, all necessary precautions must be taken to ensure that mission-critical systems remain online if a failure occurs.

  • PAGE 67

    Technical support Reference documentation For support software and drivers, see the HP software and drivers website (http://www.hp.com/support/files). For more information on the Toolkit, see the additional documentation found on the Toolkit website (http://www.hp.com/servers/sstoolkit). For more information on unattended installation, see the following resources: o Operating system documentation o Windows Server® 2003 Technical Reference (http://technet2.microsoft.

  • PAGE 68

    Acronyms and abbreviations ACU Array Configuration Utility ADG Advanced Data Guarding (also known as RAID 6) API application program interface BIOS Basic Input/Output System CLI Command Line Interface CONREP Configuration Replication utility CPQACUXE Array Configuration Utility XE CPQLOCFG Lights-Out Configuration Utility DHCP Dynamic Host Configuration Protocol DOS disk operating system GUI graphical user interface HBA host bus adapter Acronyms and abbreviations 68

  • PAGE 69

    HPDISCOVERY HP Discovery Utility HPONCFG HP Lights-Out Online Configuration utility HWQUERY Hardware Query Utility I/O input/output IFHW IF Hardware Utility iLO Integrated Lights-Out iLO 2 Integrated Lights-Out 2 iLO 3 Integrated Lights-Out 3 IP Internet Protocol IPL initial program load IPMI Intelligent Platform Management Interface LO100CFG Lights-Out (100 series) Online Configuration utility LUN logical unit number NIC network interface controller Acronyms and abbreviations 69

  • PAGE 70

    NVRAM non-volatile memory PCI peripheral component interface PSP ProLiant Support Pack PXE Preboot Execution Environment RAID redundant array of inexpensive (or independent) disks RAM random access memory RBSU ROM-Based Setup Utility RIBCL Remote Insight Board Command Language RILOE II Remote Insight Lights-Out Edition II ROM read-only memory SAS serial attached SCSI SATA serial ATA SCSI small computer system interface SP1 Service Pack 1 Acronyms and abbreviations 70

  • PAGE 71

    SSP Selective Storage Presentation STATEMGR State Manager utility USB universal serial bus VPD vital product data WMI Windows Management Instrumentation WOL Wake-on LAN WWID World Wide ID WWN World Wide Name WWPN worldwide port name XML extensible markup language Acronyms and abbreviations 71

  • PAGE 72

    Index A adding drivers 10 advanced topics 13 arguments, CONREP 36 arguments, HPDISCOVERY 31 arguments, HPLPCFG 57 arguments, HPONCFG 59 arguments, HPQLAREP 62 arguments, HWQUERY 34 arguments, IFHW 32 arguments, LO100CFG 64 arguments, RBSURESET 30 arguments, REBOOT 27 arguments, SETBOOTORDER 27, 28 arguments, STATEMGR 29 array configurations, erasing 24 audience assumptions 6 authorized reseller 67 B booting Windows PE from a USB drive key 22 C capturing configurations 11, 41 caution, data loss 6 clearing

  • PAGE 73

    examples 28, 29, 30, 31, 33, 34, 62 expression examples 33 expressions 33 F file contents 37, 60, 65 flashing the ROM 23 H Hardware Query Utility (HWQUERY) 34 HP Array Configuration Utility Scripting (HPACUSCRIPTING) 40 HP Discovery Utility (HPDISCOVERY) 13, 30 HP Emulex FC HBA BIOS Configuration Utility (HPLPCFG) 57 HP Lights-Out Online Configuration Utility (HPONCFG) 11, 12, 60 HP QLogic FC HBA BIOS Configuration Utility (HPQLAREP) 62 HP SmartStart Scripting Toolkit 8 HP SmartStart, deployment 8 HP Soft

  • PAGE 74

    ROM, updating 23 S sample deployment procedure 8 screen output, CONREP 37 serverdetect.cmd 14 SETBOOTORDER utility 28 Setup Manager 14 source server, capturing configuration from 11 startdeploy.