 |
» |
|
|
|
|  | |
The SSTK environment starts forming when the EFI boot loader launches the Linux boot loader (elilo). The Linux boot loader reads the elilo.conf configuration file and loads the kernel and root file system based on these configuration parameters. This process is no different than booting up to the Linux OS, but you can use the elilo.conf file to do much more. The SSTK uses the elilo.conf file to run the bootstrap script in the root file system, mounts the repository file system, and launches the main_toolkit_launch.sh script residing in the repository. Then, the main_toolkit_launch.sh script prompts you to select one of three tasks: start a bash shell, read the hardware configuration of the server, or write to the hardware configuration and install the operating system, drivers, and applications. The elilo.conf configuration file is an ASCII (not a UNICODE) file that controls the behavior of the Linux boot loader. The configuration file follows the LILO/x86 syntax. The configuration options are divided into the following three groups: The global options, which are listed first, affect the behavior of elilo and apply to all images, and then affect the list of images and options for each of them, if necessary. It is possible to have an empty list of global options. Table 4-3 Global Options Global Option | Description |
|---|
default=value | Specifies the names of the default image to boot. If not defined, elilo boots the first defined image. | timeout=number | Specifies the number of tenths of seconds to wait while in interactive mode before autobooting default kernel. Default is infinity. | delay=number | Specifies the number of tenths of seconds to wait before autobooting when not in interactive mode. Default is 0. | prompt | Forces interactive mode. | verbose=number | Sets level of verbosity [0–5]. Default is 0 (no verbosity). | root=filename | Sets global root filesystem for Linux/ia64. | read-only | Forces root filesystem to be mounted read-only. | append=string | Appends a string of options to kernel command line. | initrd=filename | Specifies the name of the initrd file. | image=filename | Defines a new image. | chooser=name | Specifies the kernel chooser to use simple or textmenu. | message=filename | Specifies a message to be printed on the main screen (if this functionality is supported by the chooser). | fX=filename | Specifies that the contents of a file be displayed when a certain function key, X, is pressed (if this functionality is supported by the chooser). X can vary from 1–12 to cover function keys F1 to F12. | noedd30 | When FALSE, specifies that the EDD30 EFI variable not be forced to TRUE. In other words, the EDD30 mode is not forced if this option is not set. | quiet | Limits the onscreen output messages during the preboot image loading process. |
The image options are specific to a particular kernel image. Each kernel image must be identified with a logical name called a label. At least one image must be defined. Table 4-4 Image Options Image Option | Description |
|---|
root=filename | Sets the root file system for kernel | read-only | Forces the root file system to be mounted read-only | append=string | Appends a string of options to kernel command line | initrd=filename | Specifies the name of the initrd file | label=string | Specifies the logical name of image (used in interactive mode) | description=string | Specifies the one-line text description of the image |
The SSTK command-line options for the Linux kernel, which are specified as a string of values to the image “append” option, bring up the toolkit environment. Table 4-5 SSTK Command Line Options SSTK Option | Description |
|---|
ssstk_init=filename | Specifies the name of the script on the root file system that initializes the SSTK environment by copying the repository into the RAMdisk workspace. This script is named bootstrap. This does not need to change. | ssstk_mount_type=string | Specifies the file system type of your repository. Specify nfs for a Linux workstation (or repository server). | ssstk_mount=filename | Specifies the network share or device that hosts the repository: nfs—[hostname|IP]:/directory USB—/dev/devicename | ssstk_mount_options=string | Passes extra parameters to the mount command. | ssstk_script=filename | Specifies the name of main launch script. | ssstk_action=string | Specifies the default response to the toolkit launch script prompt (readhwconfig, bash, capture, deploy, or linux). | idebus=xx | Reports the VESA/PCI bus speed in MHz to the IDE driver, where xx is between 20 and 66 inclusive. It is used when tuning chipset PIO modes. For a PCI bus, 25 is used for P75 system, 30 is used for P90, P120, P180 systems, and 33 is used for P100, P133, P166 systems. If in doubt, use idebus=33 for PCI. |
Edit the sample elilo.conf file included in the SSTK software package to match your deployment. Here is an annotated example of a working elilo.conf file: The prompt forces interactive mode and the timeout waits for 30 seconds. The first (default) entry boots the server to Linux and opens a console (label=linux). To change the default elilo boot configuration, insert at the top the option default=LABEL. For example, default=nfs-sample. image=linux
label=linux
initrd=rootfs.gz
root=/dev/ram
append=”rw ramdisk_size=524288 idebus=33” |
The following entry boots the main toolkit launch script by getting it from a local partition. The script then read the hardware configuration and writes it to the repository. image=linux
label=readhw-linux
initrd=rootfs.gz
root=/dev/ram
append="rw randisk_size=524288 ssstk_init=/bootstrap
ssstk_mount=/dev/sda1
ssstk_scritp=scripts/main_toolkit_launch.sh
ssstk_action=readhwconfig" |
This entry gets the main script from a repository located on an NFS share. image=linux
label=nfs
initrd=rootfs.gz
root=/dev/ram
append="rw ramdisk_size=524288 ssstk_init=/bootstrap
ssstk_mount_type=nfs ssstk_mount=repositoryserver:/nfsshare
ssstk_script=scripts/main_toolkit_launch.sh" |
The following entry mounts the repository located on a USB storage device and executes the main script with the directive to configure the hardware and install Linux. image=linux
label=usb
initrd=rootfs.gz
root=/dev/ram
append="rw ramdisk_size=524288
ssstk_init=/bootstrap ssstk_mount=/dev/sda1
ssstk_script=scripts/main_toolkit_launch.sh ssstk_action=linux" |
| | | |  | NOTE: During the pre-boot portion of the Linux booting sequence, you may encounter a syntax error in each line of the script, which may indicate that there are extra line-feed characters in the boot loader file. If you modify the elilo.conf file using a Windows-based text editors, you must ensure that the modified script files are UNIX file format by using a utility to convert the script files to UNIX format (such as dos2unix) or by saving the file in UNIX file format. | | | | |
|
Printable version
