32.11. Starting a Kickstart Installation
Important
Firstboot does not run after a system is installed from a Kickstart file unless a desktop and the X Window System were included in the installation and graphical login was enabled. Either specify a user with the
user option in the Kickstart file before installing additional systems from it (refer to Section 32.4, “Kickstart Options” for details) or log into the installed system with a virtual console as root and add users with the adduser command.
To begin a kickstart installation, you must boot the system from boot media you have made or the Red Hat Enterprise Linux DVD, and enter a special boot command at the boot prompt. The installation program looks for a kickstart file if the
ks command line argument is passed to the kernel.
- With Driver Disk
- If you need to use a driver disk with kickstart, specify the
ddoption as well. For example, if installation requires a kickstart file on a local hard drive and also requires a driver disk, boot the system with:linux ks=hd:partition:/path/ks.cfg dd
- Boot CD-ROM
- If the kickstart file is on a boot CD-ROM as described in Section 32.9.1, “Creating Kickstart Boot Media”, insert the CD-ROM into the system, boot the system, and enter the following command at the
boot:prompt (whereks.cfgis the name of the kickstart file):linux ks=cdrom:/ks.cfg
Other options to start a kickstart installation are as follows:
askmethod- Prompt the user to select an installation source, even if a Red Hat Enterprise Linux installation DVD is detected on the system.
asknetwork- Prompt for network configuration in the first stage of installation regardless of installation method.
autostep- Make kickstart non-interactive. Used for debugging and to generate screenshots. This option should not be used when deploying a system because it may disrupt package installation.
debug- Start up pdb immediately.
dd- Use a driver disk.
dhcpclass=<class>- Sends a custom DHCP vendor class identifier. ISC's dhcpcd can inspect this value using "option vendor-class-identifier".
dns=<dns>- Comma separated list of nameservers to use for a network installation.
driverdisk- Same as 'dd'.
expert- Turns on special features:
- allows partitioning of removable media
- prompts for a driver disk
gateway=<gw>- Gateway to use for a network installation.
graphical- Force graphical install. Required to have ftp/http use GUI.
isa- Prompt user for ISA devices configuration.
ip=<ip>- IP to use for a network installation, use 'dhcp' for DHCP.
ipv6=auto,ipv6=dhcp- IPv6 configuration for the device. Use
autofor automatic configuration (SLAAC, SLAAC with DHCPv6), ordhcpfor DHCPv6 only configuration (no router advertisements). keymap=<keymap>- Keyboard layout to use. Valid layouts include:
be-latin1— Belgianbg_bds-utf8— Bulgarianbg_pho-utf8— Bulgarian (Phonetic)br-abnt2— Brazilian (ABNT2)cf— French Canadiancroat— Croatiancz-us-qwertz— Czechcz-lat2— Czech (qwerty)de— Germande-latin1— German (latin1)de-latin1-nodeadkeys— German (latin1 without dead keys)dvorak— Dvorakdk— Danishdk-latin1— Danish (latin1)es— Spanishet— Estonianfi— Finnishfi-latin1— Finnish (latin1)fr— Frenchfr-latin9— French (latin9)fr-latin1— French (latin1)fr-pc— French (pc)fr_CH— Swiss Frenchfr_CH-latin1— Swiss French (latin1)gr— Greekhu— Hungarianhu101— Hungarian (101 key)is-latin1— Icelandicit— Italianit-ibm— Italian (IBM)it2— Italian (it2)jp106— Japaneseko— Koreanla-latin1— Latin Americanmk-utf— Macedoniannl— Dutchno— Norwegianpl2— Polishpt-latin1— Portuguesero— Romanianru— Russiansr-cy— Serbiansr-latin— Serbian (latin)sv-latin1— Swedishsg— Swiss Germansg-latin1— Swiss German (latin1)sk-qwerty— Slovak (qwerty)slovene— Sloveniantrq— Turkishuk— United Kingdomua-utf— Ukrainianus-acentos— U.S. Internationalus— U.S. English
The file/usr/lib/python2.6/site-packages/system_config_keyboard/keyboard_models.pyon 32-bit systems or/usr/lib64/python2.6/site-packages/system_config_keyboard/keyboard_models.pyon 64-bit systems also contains this list and is part of the system-config-keyboard package. ks=nfs:<server>:/<path>- The installation program looks for the kickstart file on the NFS server <server>, as file <path>. The installation program uses DHCP to configure the Ethernet card. For example, if your NFS server is server.example.com and the kickstart file is in the NFS share
/mydir/ks.cfg, the correct boot command would beks=nfs:server.example.com:/mydir/ks.cfg. ks={http|https}://<server>/<path>- The installation program looks for the kickstart file on the HTTP or HTTPS server <server>, as file <path>. The installation program uses DHCP to configure the Ethernet card. For example, if your HTTP server is server.example.com and the kickstart file is in the HTTP directory
/mydir/ks.cfg, the correct boot command would beks=http://server.example.com/mydir/ks.cfg. ks=hd:<device>:/<file>- The installation program mounts the file system on <device> (which must be vfat or ext2), and looks for the kickstart configuration file as <file> in that file system (for example,
ks=hd:sda3:/mydir/ks.cfg). ks=bd:<biosdev>:/<path>- The installation program mounts the file system on the specified partition on the specified BIOS device <biosdev>, and looks for the kickstart configuration file specified in <path> (for example,
ks=bd:80p3:/mydir/ks.cfg). Note this does not work for BIOS RAID sets. ks=file:/<file>- The installation program tries to read the file <file> from the file system; no mounts are done. This is normally used if the kickstart file is already on the
initrdimage. ks=cdrom:/<path>- The installation program looks for the kickstart file on CD-ROM, as file <path>.
ks- If
ksis used alone, the installation program configures the Ethernet card to use DHCP. The kickstart file is read from NFS server specified by DHCP option server-name. The name of the kickstart file is one of the following:- If DHCP is specified and the boot file begins with a
/, the boot file provided by DHCP is looked for on the NFS server. - If DHCP is specified and the boot file begins with something other than a
/, the boot file provided by DHCP is looked for in the/kickstartdirectory on the NFS server. - If DHCP did not specify a boot file, then the installation program tries to read the file
/kickstart/1.2.3.4-kickstart, where 1.2.3.4 is the numeric IP address of the machine being installed.
ksdevice=<device>- The installation program uses this network device to connect to the network. You can specify the device in one of five ways:
- the device name of the interface, for example,
eth0 - the MAC address of the interface, for example,
00:12:34:56:78:9a - the keyword
link, which specifies the first interface with its link in theupstate - the keyword
bootif, which uses the MAC address that pxelinux set in theBOOTIFvariable. SetIPAPPEND 2in yourpxelinux.cfgfile to have pxelinux set theBOOTIFvariable. - the keyword
ibft, which uses the MAC address of the interface specified by iBFT
For example, consider a system connected to an NFS server through the eth1 device. To perform a kickstart installation on this system using a kickstart file from the NFS server, you would use the commandks=nfs:<server>:/<path> ksdevice=eth1at theboot:prompt. kssendmac- Adds HTTP headers to ks=http:// request that can be helpful for provisioning systems. Includes MAC address of all nics in CGI environment variables of the form: "X-RHN-Provisioning-MAC-0: eth0 01:23:45:67:89:ab".
lang=<lang>- Language to use for the installation. This should be a language which is valid to be used with the 'lang' kickstart command.
loglevel=<level>- Set the minimum level required for messages to be logged. Values for <level> are debug, info, warning, error, and critical. The default value is info.
mediacheck- Activates loader code to give user option of testing integrity of install source (if an ISO-based method).
netmask=<nm>- Netmask to use for a network installation.
nofallback- If GUI fails, exit.
nofb- Do not load the VGA16 framebuffer required for doing text-mode installation in some languages.
nofirewire- Do not load support for firewire devices.
noipv4- Disable IPv4 networking on the device specified by the
ksdevice=boot option. noipv6- Disable IPv6 networking on all network devices on the installed system, and during installation.
Important
During installations from a PXE server, IPv6 networking might become active before anaconda processes the Kickstart file. If so, this option will have no effect during installation.Note
To disable IPv6 on the installed system, the--noipv6kickstart option must be used on each network device, in addition to thenoipv6boot option. See the Knowledgebase article at https://access.redhat.com/solutions/1565723 for more information about disabling IPv6 system-wide. nomount- Don't automatically mount any installed Linux partitions in rescue mode.
nonet- Do not auto-probe network devices.
noparport- Do not attempt to load support for parallel ports.
nopass- Do not pass information about the keyboard and mouse from anaconda stage 1 (the loader) to stage 2 (the installer).
nopcmcia- Ignore PCMCIA controllers in the system.
noprobe- Do not automatically probe for hardware; prompt the user to allow anaconda to probe for particular categories of hardware.
noshell- Do not put a shell on tty2 during install.
repo=cdrom- Do a DVD based installation.
repo=ftp://<path>- Use <path> for an FTP installation.
repo=hd:<dev>:<path>- Use <path> on <dev> for a hard drive installation.
repo=http://<path>- Use <path> for an HTTP installation.
repo=https://<path>- Use <path> for an HTTPS installation.
repo=nfs:<path>- Use <path> for an NFS installation.
rescue- Run rescue environment.
resolution=<mode>- Run installer in mode specified, '1024x768' for example.
serial- Turns on serial console support.
skipddc- Do not probe the Data Display Channel (DDC) of the monitor. This option provides a workaround if the DDC probe causes the system to stop responding.
syslog=<host>[:<port>]- Once installation is up and running, send log messages to the syslog process on <host>, and optionally, on port <port>. Requires the remote syslog process to accept connections (the -r option).
text- Force text mode install.
Important
If you select text mode for a kickstart installation, make sure that you specify choices for the partitioning, bootloader, and package selection options. These steps are automated in the text mode, and anaconda cannot prompt you for missing information. If you do not provide choices for these options, anaconda will stop the installation process. updates- Prompt for storage device containing updates (bug fixes).
updates=ftp://<path>- Image containing updates over FTP.
updates=http://<path>- Image containing updates over HTTP.
updates=https://<path>- Image containing updates over HTTPS.
upgradeany- Offer to upgrade any Linux installation detected on the system, regardless of the contents or the existence of the
/etc/redhat-releasefile. vnc- Enable vnc-based installation. You will need to connect to the machine using a vnc client application.
vncconnect=<host>[:<port>]- Connect to the vnc client named <host>, and optionally use port <port>.Requires 'vnc' option to be specified as well.
vncpassword=<password>- Enable a password for the vnc connection. This will prevent someone from inadvertently connecting to the vnc-based installation.Requires 'vnc' option to be specified as well.
