Jump to content United States-English
HP.com Home Products and Services Support and Drivers Solutions How to Buy
» Contact HP
More options
HP.com home
SmartSetup Scripting Toolkit Deployment Guide: HP Integrity Servers with Linux > Chapter 3 Creating a Server Profile

Unpacking the Toolkit

» 

Technical documentation

Complete book in PDF
» Feedback
Content starts here

 » Table of Contents

The SSTK software package is an archive that is provided in tar gzip file format.

The archive expands into a file structure that also serves as a skeleton for the server profile:

  • Documentation includes this guide and a readme file with any breaking release information.

  • The boot_files directory holds the toolkit environment, which you must copy onto the SSTK boot device. The boot_files\efi\boot\ directory contains the following files:

    bootia64.efi

    The \efi\boot\bootia64.efi script is executed when an HP Integrity Itanium-based server boots. If the server is cell-based, the acpi flag is set to default, and then booted to the SSTK pre-boot environment.

    elilo.conf

    Configuration file for the Linux boot loader for EFI-based systems

    elilo.efi

    Linux boot loader

    linux

    Linux kernel

    rootfs.gz

    Linux root file system in a compressed file

  • The data_files directory is a placeholder that is used to store configuration files and the following SSTK log files:

    NOTE: The data_files/acu.ini array configuration file is created when you execute the readhwconfig utility on a target server with a smart array. The acu.ini file is read when the linux-setup.sh script is executed. This file is not included in the sample file structure.
    acu.ini

    The captured RAID configuration file. This file is created when the readhwconfig option is executed on a target server with a supported RAID controller. The acu.ini file is read and applied before the Linux installation begins. This file is not included in the sample file structure.

    conrep.dat

    The conrep EFI variables output file. This file is created when the readhwconfig option is executed.

    hba-qlogic.ini

    The hpqlarep configuration file is used to enable or disable the EFI boot setting on QLogic Host Bus Adapters (HBAs). This file is also captured when the readhwconfig option is executed and applied before installing Linux.

    hba-emulex.ini

    The hplpgfg configuration file, used to enable or disable the EFI boot setting on Emulex HBAs. This file is also captured when the readhwconfig option is executed and applied before installing Linux.

    log

    This folder stores log files and is created during the SSTK execution.

  • The software directory may contain files, packages, and applications that will be copied or installed on the new system.

    software\[slesversion | rhelversion]

    A placeholder directory (for example, rhel4up4 or sles10sp1) that you can populate with extra packages that you want SSTK to install automatically.

    software/EFI_TOOLS

    A placeholder directory, which you can populate with applications that are copied to the HP Service Partition and is installed after the OS is first loaded. Files placed under software\EFI_TOOLS are automatically copied to the HP Service Partition.

  • The os directory contains unattended configuration files for the Linux distributions. The Linux distribution installation files are also placed in the linux directory as follows:

    |-- os
         |-- linux
         |   |-- rhel4up4
         |   |-- rhel4up5
         |   |-- rhel4up5
         |   |-- rhel5
         |   |-- rhel5up1
         |   |-- sles10sp1
         |   |-- sles9sp3
         |   `-- sles9sp4
         |-- rhel4up4-profile
         |-- rhel4up5-profile
         |-- rhel4up6-profile
         |-- rhel5-profile
         |-- rhel5up1-profile
         |-- sles10sp1-profile
         |-- sles9sp3-profile 
         `-- sles9sp4-profile 
  • The scripts directory contains the following shell scripts. Typically, you cannot edit the first two scripts, capture_linux_image.sh and deploy_linux_image.sh :

    capture_linux_image.sh

    Captures the Linux image of an installed system.

    deploy_hba.sh:

    Automatically configures the SAN environment.

    deploy_linux_image.sh:

    Replicates the captured information from the repository to the target system.

    imgfunctions.sh

    Contains the functions used by the imaging scripts.

    sstk.conf

    This configuration file allows you to set the SSTK variables used by the scripts in the scripts directory. For example, you could set the default action of SSTK, the disk where Linux will be installed, or the name of configuration files.

    raid1-lsi.sh

    Contains the functions for RAID configuration in LSI controllers.

    main_toolkit_launch.sh

    The main script in the toolkit, which sets up the toolkit environment by setting environment variables, creating a RAMdisk, copying scripts and utilities into the RAMdisk, running I/O hardware inventory, and prompting the you to select a deployment task.

    linux-setup.sh

    This script launches Linux installation by creating and formatting disk partitions, specifying the Linux Setup boot option, and rebooting the server.

    rhel-setup.sh

    This script edits the configuration in the RHEL unattended configuration file and copies the RHEL boot image files to the ESP partition.

    sles-setup.sh

    This script edits the configuration in the SLES unattended configuration file, and copies the SLES boot image files to the ESP partition.

  • The utilities directory contains the following files:

    cfggen

    The RAID configuration utility for LSI controllers; it is a counterpart of cpqacuxe. In SSTK it is used for applying RAID 1 in LSI 1068 controllers.

    efivar

    A generic tool used to set EFI variables from the SSTK LinuxPE.

    getuuid

    This utility retrieves the Universally Unique ID (UUID) used to identify a storage device or a single partition.

    hplpcfg

    The HP Emulex HBA configuration utility.

    hpqlarep

    The HP QLogic HBA configuration utility.

    hpshowdisk

    This utility gathers storage device information such as disk size, device node, controller type and target LUN including HBA WWID, and the target port WWN for disks in a SAN environment.

    allboards.xml

    Used by the hwquery and ifhw utilities to convert PCI device IDs found in hardware discovery into device names.

    conrep

    The configuration replication utility, which reads EFI variables from the model server and records them in the conrep.dat file.

    conrep.xml

    A utility that includes a list of EFI variables, which determine what data to retrieve from the server. You can edit this file to control the data collection.

    cpqacuxe

    The array configuration utility, which operates in two modes. In the capture mode, it reads the configuration of a storage array controller and records it in a configuration file. In the input mode, it writes the configuration to the target server. This archive is extracted to /sbin/cpqacuxe and a structure under /opt/compaq/cpqacuxe.

    efibootmgr

    The EFI boot manager utility, which loads EFI applications (such as the OS boot loader) and EFI drivers. The EFI boot manager allows you to control the server's boot environment using variables stored in NVRAM.

    hpia64info

    The hpia64info utility, which displays information about Management Processor and system firmware.

    hwdisc

    The hardware discovery utility, which creates an inventory of the server and writes this data to a file.

    hwquery

    The hardware query utility, which reads the file created by the hardware discovery utility and provides this data in a usable form.

    ifhw

    The if hardware utility, which makes user process decisions based on data from the file created by the hardware discovery utility.

    parted

    The parted utility, which creates, destroys, resizes, checks, and copies partitions.

    hpsetacpi

    The acpi mode configuration tool, used to check and modify the acpi mode on cellular machines.

NOTE: The dumppci and gen-setupldr-options utilities are delivered though are not used by SSTK.
Printable version
Privacy statement Using this site means you accept its terms Feedback to webmaster
© 2007–2008 Hewlett-Packard Development Company, L.P.