SmartSetup Scripting Toolkit Deployment: HP Integrity Servers with Linux

SmartSetup Scripting Toolkit Deployment
Guide
HP Integrity Servers with Linux
HP Part Number: 5991-6250
Published: July 2010
Edition: 9

Summary of content (84 pages)

AutobootRetry
AutobootRetries
Table 6-4 conrep Return Codes Value Meaning Cause Action 0 conrep executed successfully 1 Permission denied The user is not a system administrator. Log in as root to run conrep. 2 Usage error An error occurred while using conrep for some unexpected reason, such as the wrong parameters. Run conrep -h to get help using conrep.

  • PAGE 52

    cpqacuxe Synopsis • • • Capture: CPQACUXE -C FILENAME [-internal | -external] -E FILENAME Input: CPQACUXE -I FILENAME [-internal | -external] [reset] -E FILENAME Input with reset: CPQACUXE -i-with-reset FILENAME [-internal | -external] [reset] -E FILENAME Description The cpqacuxe utility operates on the configuration of storage array controllers. The cpqacuxe utility enables the array configuration on one server to be replicated on other servers with similar array storage resources.

  • PAGE 53

    Sectors = 32 StripeSize = 256 ArrayAccelerator = Enabled ; HBA SSP Specifications HBA_WW_ID= 10000000C9272B34 ConnectionName= TestConn HostMode= Linux Table 6-5 cpqacuxe Options Option Description -C FILENAME Specifies the capture file. The capture filename is optional. If no capture file is specified, the default capture file is acucapt.ini in the ACU working directory. -E FILENAME Specifies the error file. The error filename is optional.

  • PAGE 54

    These options can be specified in any order, but an option from another category of options cannot occur between any two options from this category. Automatic Script File Format The automatic script is used to apply automatic configuration rules to unconfigured or configured controllers. If the -i-with-reset or –reset command line switch is used, the existing controller configuration is cleared with data loss before the new configuration is applied, effectively making it an unconfigured controller.

  • PAGE 55

    Table 6-6 Automatic Script File Options (continued) Option Value IOCabinet [N], IOBay [N], IOChassis [N],Slot [N], Cabinet [N], Cell [N]: The controller identified by the IPF Slot path information is used. Use of the -internal” and -external command line switches influences what is regarded as the first controller. For example, if the -external switch is used, the first controller is the first external controller discovered, regardless of the number of internal controllers in the host system.

  • PAGE 56

    Table 6-6 Automatic Script File Options (continued) Option Value SurfaceScanDelay Specifies the Surface Scan Delay in seconds. This option is not required. If this option is not specified, the Surface Scan Delay remains unchanged. N: This value is a numeric value between 1 and 30 seconds. OnlineSpare Specifies if Automatic Configuration should attempt to add spares. This option is not required. This option is ignored in Reconfigure mode if there is an existing configuration on the controller.

  • PAGE 57

    Size = [N]|Max Sectors = 32|63 StripeSize = 8|16|32|64|128|256 ArrayAccelerator= Enable|Disable ResourceVolumeOwner= N LogicalDriveSSPState = Enable|Disable SSPAdaptersWithAccess = [N],[N]…|None PreferredPath = 1|2 ; HBA Options ; There can be multiple HBA specifications in the file HBA_WW_ID = WWN ConnectionName = UserDefinedName HostMode = Default|Windows|Windows(degrade |OpenVMS|Tru64|Linux|Solaris|Netware|HP|Windows_SP2_and_ Table 6-7 Custom Script File Options Option Value Action Defines if you are

  • PAGE 58

    Table 6-7 Custom Script File Options (continued) Option Value RAIDArrayID Specifies the RaidArrayID for controllers that support RaidArrayID. This is a user-defined string to identify controllers. Currently, RaidArrayIDs are only supported by Fibre and shared-storage controllers. "XXXXXXXXXXXXXXXXXXXX" Varying length string that can consist of any of the following characters: a-z A-Z 0-9 ! @ # * ( ) , - _ + : . / [space] This string has a maximum length that varies depending on the type of controller.

  • PAGE 59

    Table 6-7 Custom Script File Options (continued) Option Value SSP only remains enabled if the SSPAdaptersWithAccess command specifies an adapter for one or more logical drives. If no adapters with access are specified for any logical drives, the SSP State reverts back to disabled. PreferredPathMode Specifies the preferred path mode when redundant array controllers are in an active-active configuration. This option is only available for certain redundant array controllers.

  • PAGE 60

    Table 6-7 Custom Script File Options (continued) Option Value existing configuration to create a new logical drive. In most cases logical drives must appear in the configuration file in increasing order. RAID Specifies the RAID level for the current logical drive. In Configure mode, the RAID is the RAID for the new logical drive. In Reconfigure mode, if the logical drive already exists and the RAID is different than the existing RAID on the logical drive.

  • PAGE 61

    Table 6-7 Custom Script File Options (continued) Option Value • RAID 5: 8, 16, 32, 64 (default is 16) • RAID ADG: 8, 16, 32, 64 (default is 16) ArrayAccelerator Specifies the Array Accelerator setting for the logical drive. • Enable: Enables the Array Accelerator for the logical drive. This is the default setting for new logical drives. • Disable: Disables the Array Accelerator for the logical drive.

  • PAGE 62

    Table 6-7 Custom Script File Options (continued) Option Value • • • • • • • OpenVMS TRU64 Linux Solaris Netware HP Windows_SP2 Error Reporting When using the cpqacuxe utility, any errors that are encountered are logged to the error.ini file or the specified error file. Error codes are also returned to the calling process, allowing scripting clients to key off the return code instead of having to parse the error file.

  • PAGE 63

    Table 6-8 Error Codes (continued) Code Error Reason 2819 Controller '%s' is invalid The controller specified is not specified correctly. 2820 Could not detect Controller '%s' The controller specified was not detected. 2818 Invalid Method Invalid Method value. 2819 Invalid Controller Invalid Controller value. 2822 Invalid Read Cache/Write Cache Ratio The specified Read Cache/Write Cache Ratio is not supported either by the controller or the current controller configuration.

  • PAGE 64

    Table 6-8 Error Codes (continued) Code Error Reason error does not occur. However, if the controller does not support migration, this error occurs. 64 2834 Invalid Logical Drive The Logical Drive ID is not valid. 2835 Logical Drive not specified The Logical Drive command is missing from the script file. Some commands were found that require a Logical Drive to work on.

  • PAGE 65

    Table 6-8 Error Codes (continued) Code Error Reason 278-282, 2564 Controller is locked by another One or more controllers is locked by another machine or user. machine or user 268 Error saving Controller There was a problem saving one or more controller configurations. 1065-1066 Too many coinciding expansion, migration, or extension operations This error is the “invalid increase/decrease” in logical drive offset error.

  • PAGE 66

    Table 6-8 Error Codes (continued) Code Error Reason 2860 Cannot change Resource Volume Owner The Resource Volume owner cannot be changed if it is a configured logical drive. 2861 Controller does not support redundancy settings The controller is not redundant or does not support redundancy settings. 2864 Invalid Preferred Path Mode The preferred path mode is not a valid preferred path mode or the controller is not available.

  • PAGE 67

    Table 6-9 efibootmgr Options (continued) Options Description -o | --bootorder XXXX,YYYY,ZZZZ,... Explicitly set BootOrder. The values must be in hex. -O | --delete-bootorder Delete BootOrder -t | --timeout seconds Set boot manager timeout waiting for user input. -T | --delete-timeout Delete Timeout. -V | --version Return version and exit. Table 6-10 efibootmgr Commands Commands Description -@ | --@ file Define the file to include more options.

  • PAGE 68

    Table 6-11 efibootmgr Command Line Input (continued) Command Line Input Result • BOOT LOADER: /efi/boot/bootia64.efi • LOAD OPTION: LINUX efibootmgr -c -L "Boot" -l /bootia64.efi --test bootentry.bin Generate a boot entry but do not save it in NVRAM. The boot entry values are: • NAME: Boot • DEVICE: /dev/sda • PARTITION: 1 • BOOT LOADER: /bootia64.efi • LOAD OPTION: none efibootmgr -c -l /bootia64.efi -@ parameter.

  • PAGE 69

    getuuid Synopsis getuuid | -p| -t Description The getuuid utility retrieves the UUID (Universally Unique ID) used for identifying a storage device or a single partition. Table 6-13 getuuid Options Options Description Disk to from which information will be retrieved. -p Partition number. -t Shows GUID of partition type (efi, hpsp, etc).

  • PAGE 70

    Table 6-14 hpacucli Commands (continued) Commands Description delete The delete command deletes part of an existing configuration.

  • PAGE 71

    Example 6-5 Sample hpia64imfo Utility Output Format: 1 MP Version: F.01.55 MP Lan Status: Enabled MP Host Name: superbird MP IP Address: 16.89.144.239 MP Netmask: 255.255.252.0 MP Gateway: 16.89.144.1 MP MAC Address: 00-14-C2-9C-07-6C Asset Tag: hello world BMC Version: 05.07 SFW Version: 01.31 EFI Version: 05.

  • PAGE 72

    Description The hpqlarep utility enables or disable the EFI or BIOS boot setting on QLogic 2G or 4G HBAs. Table 6-16 hpqlarep Options Options Description /s Saves the HBA configuration to . /l Loads the HBA configuration to .

  • PAGE 73

    SSTK-v.3.2# ./hpsetacpi linux ACPI mode was properly set hpsetacpi 89 hpshowdisk Synopsis hpshowdisk -v | -h | -n | -I | -p| -d | -s Description The hpshowdisk utility helps with the identification of the disks recognized by the system. It can be very useful in situations where the system has lots of disks, typically on SAN architectures.

  • PAGE 74

    hwdisc Synopsis hwdisc -f[path]filename Description The hwdisc utility provides an inventory of the server being configured or captured.

  • PAGE 75

    Example hwdisc –f/mnt/data/hwdisc.xml This command generates the file hwdisc.xml in the /mnt/data location. A typical file generated by the hwdisc command is similar to the following: server rx2600 US21729947 1.22 1.53 E.03.

  • PAGE 76

    1 10000030 10001000 /dev/sda 34732 20 2 0 14E41645 103C12A4 E0 1 0 103C1290 103C1291 E0 1 1 103C1048

  • PAGE 77

    Table 6-20 hwquery Options (continued) Command Line Argument Description variable= In this argument, variable is the name of an environment variable and is a PCI device name or the name of an element from the hardware discovery file. Arguments must be in quotes if contains spaces. The name is case-sensitive. ... You can specify multiple variable=arguments. Examples • To produce an hwdisc.

  • PAGE 78

    Table 6-21 ifhw Options Option Description [path]hwdiscfilename This argument specifies the hardware discovery file used to run the query. [path]allboards.xml This argument specifies the allboards.xml PCI device list file, which is used to convert PCI IDs found in hardware discovery into device names, such as "Smart Array 6402 Controller." expression This argument specifies the query expression. Examples The ifhw utility might use XML files as input to query the hardware discovery file.

  • PAGE 79

    Table 6-22 Expressions (continued) Operator or Term Result HWQ:string The hardware discovery file is searched for string, and the corresponding value is the value of this term. string is case-sensitive. string A literal string, used for comparison. number A literal number, used for comparison. parted Synopsis parted [-v | -i | -s | -h]... [DEVICE [COMMAND [PARAMETER]...] ...] Description The parted utility manages disk partitions.

  • PAGE 80

    • To create a partition with a file system: mkpartfs PTYPE FTYPE START END PTYPE is partition type: primary, logical or extended. For GPT partition table only “primary” is used. FTYPE is file system type: fat16, fat32, ext2 and linux-swap.

  • PAGE 81

    A Known Issues This section provides information on the known issues when using SSTK. IMPORTANT: HP recommends that you review the readme file included with SSTK, which may contain late-breaking known issues for this release that could not be included in this document. Pre-OS Linux Prompts Are Not Displayed The pre-OS Linux prompts are visible through the MP LAN connections.

  • PAGE 82

    No MSA Storage Information Displayed by ACU The ACU does not capture configuration information from the Emulex HBA that connects to MSA storage so no information about the storage device is displayed by the ACU. This is a known issue with the ACU. To avoid this issue, configure Emulex boot devices with hplpcfg. Incorrect Logical Disk Drive Size Displayed The logical disk size was not specified with the cfggen utility.

  • PAGE 83

    efibootmgr Utility Issues When using the efibootmgr utility, you should be aware of the following issues: • It is possible to create entries to nonexistent boot loaders. • The EFI interface menu is does not accurately indicate the Active/Inactive flag for the boot entries. • The labels of the boot entries are not updated. SSTK Image Does Not Boot and LSI Driver Loops The LSI controller driver does not respond to hardware failures correctly.

  • PAGE 84

    *5991-6250* Printed in the US