diff options
author | Chris Lumens <clumens@redhat.com> | 2006-11-14 18:54:00 +0000 |
---|---|---|
committer | Chris Lumens <clumens@redhat.com> | 2006-11-14 18:54:00 +0000 |
commit | 0873d0958f01077c4e1df2f3f3b69db525c28c65 (patch) | |
tree | 4b524b640963aeb41a42f70c8c15a244e6cd075f /docs | |
parent | 41bb9d1d3a9f15dbe47fc73b1a7c5f7794c35f4b (diff) | |
download | anaconda-0873d0958f01077c4e1df2f3f3b69db525c28c65.tar.gz anaconda-0873d0958f01077c4e1df2f3f3b69db525c28c65.tar.xz anaconda-0873d0958f01077c4e1df2f3f3b69db525c28c65.zip |
Update documentation for current options and commands.
Diffstat (limited to 'docs')
-rw-r--r-- | docs/kickstart-docs.txt | 230 |
1 files changed, 184 insertions, 46 deletions
diff --git a/docs/kickstart-docs.txt b/docs/kickstart-docs.txt index 541eb3b0b..db8c6b6f5 100644 --- a/docs/kickstart-docs.txt +++ b/docs/kickstart-docs.txt @@ -133,6 +133,15 @@ Creating the Kickstart File specified after it. In the example commands, options in brackets ([]) are optional arguments for the command. + auth or authconfig (required) + + Sets up the authentication options for the system. This is just a + wrapper around the authconfig program, so all options recognized + by that program are valid for this command. See the manual page for + authconfig for a complete list. + + By default, passwords are normally encrypted and are not shadowed. + autopart (optional) Automatically create partitions -- 1 GB or more root (/) partition, @@ -145,14 +154,11 @@ Creating the Kickstart File Similar to interactive except it goes to the next screen for you. It is used mostly for debugging. - auth or authconfig (required) - - Sets up the authentication options for the system. This is just a - wrapper around the authconfig program, so all options recognized - by that program are valid for this command. See the manual page for - authconfig for a complete list. + --autoscreenshot - By default, passwords are normally encrypted and are not shadowed. + Take a screenshot at every step during installation and copy + the images over to /root/anaconda-screenshots after + installation is complete. This is most useful for documentation. bootloader (required) @@ -268,7 +274,11 @@ Creating the Kickstart File Options to pass to the kernel module. Note that multiple options may be passed if they are put in quotes. For example: - --opts="aic152x=0x340 io=11" + --opts="aic152x=0x340 io=11" + + dmraid (optional) + + dmraid --name= --dev= driverdisk (optional) @@ -367,6 +377,11 @@ Creating the Kickstart File networking configuration options in addition to the default ones. + graphical (optional) + + Perform the kickstart installation in graphical mode. This is the + default. + install (optional) Tells the system to install a fresh system rather than upgrade an @@ -384,6 +399,10 @@ Creating the Kickstart File Install from a Red Hat installation tree on a local drive, which must be either vfat or ext2. + * --biospart= + + BIOS partition to install from (such as 82). + * --partition= Partition to install from (such as, sdb2). @@ -431,6 +450,15 @@ Creating the Kickstart File url --url ftp://<username>:<password>@<server>/<dir> + ignoredisk (optional) + + Used to specify disks that anaconda should not touch when + partitioning, formatting, and clearing. This command has a single + required argument, which takes a comma-separated list of drive + names to ignore. + + ignoredisk --drives=[disk1,disk2,...] + interactive (optional) Uses the information provided in the kickstart file during the @@ -440,6 +468,34 @@ Creating the Kickstart File Either accept the values by clicking Next or change the values and click Next to continue. See also autostep. + iscsi (optional) + + iscsi --ipaddr= [options] + + --target= + + --port= + + --user= + + --password= + + iscsiname (optional) + + key (optional) + + Specify a registration key, which is needed to aid in package + selection and identify your system for support purposes. This + command is RHEL-specific; it has no meaning for Fedora and will + be ignored. + + --skip + + Skip entering a key. Usually if the key command is not given, + anaconda will pause at this step to prompt for a key. This + option allows automated installation to continue if you do not + have a key or do not want to provide one. + keyboard (required) Sets system keyboard type. Here is the list of available keyboards @@ -454,7 +510,7 @@ Creating the Kickstart File speakup-lt, sv-latin1, sg, sg-latin1, sk-querty, slovene, trq, ua, uk, us, us-acentos - The file /usr/lib/python2.2/site-packages/rhpl/keyboard_models.py + The file /usr/lib/python?.?/site-packages/rhpl/keyboard_models.py also contains this list and is part of the rhpl package. lang (required) @@ -470,6 +526,12 @@ Creating the Kickstart File list the valid language codes in the first column of each line and is part of the system-config-languages package. + Certain languages (mainly Chinese, Japanese, Korean, and Indic + languages) are not supported during text mode installation. If + one of these languages is specified using the lang command, + installation will continue in English though the running system + will have the specified langauge by default. + langsupport The langsupport keyword is deprecated and its use will cause an @@ -543,7 +605,40 @@ Creating the Kickstart File volgroup myvg pv.01 logvol / --vgname=myvg --size=2000 --name=rootvol - monitor + logging (optional) + + This command controls the error logging of anaconda during + installation. It has no effect on the installed system. + + --host= + + Send logging information to the given remote host, which must + be running a syslogd process configured to accept remote logging. + + --port= + + If the remote syslogd process uses a port other than the + default, it may be specified with this option. + + --level= + + One of debug, info, warning, error, or critical. + + Specify the minimum level of messages that appear on tty3. All + messages will still be sent to the log file regardless of this + level, however. + + mediacheck (optional) + + If given, this will force anaconda to run mediacheck on the + installation media. This command requires that installs be + attended, so it is disabled by default. + + monitor (optional) + + If the monitor command is not given, anaconda will use X to + automatically detect your monitor settings. Please try this before + manually configuring your monitor. --hsync= @@ -685,6 +780,22 @@ Creating the Kickstart File The DHCP class. + --mtu= + + The MTU of the device. + + --noipv4 + + Disable IPv4 on this device. + + --noipv6 + + Disable IPv6 on this device. + + multipath (optional) + + multipath --name= --device= --rule= + part or partition (required for installs, ignored for upgrades) Creates a partition on the system. @@ -904,7 +1015,11 @@ Creating the Kickstart File Normally, kickstart displays a message and waits for the user to press a key before rebooting. - repo (optional) - EXPERIMENTAL + --eject + + Attempt to eject and CD or DVD media before rebooting. + + repo (optional) Configures additional yum repositories that may be used as sources for package installation. Multiple repo lines may be specified. @@ -1070,12 +1185,39 @@ Creating the Kickstart File Set a password which must be provided to connect to the VNC session. This is optional, but recommended. + volgroup (optional) + + Use to create a Logical Volume Management (LVM) group with the + syntax: + + volgroup <name> <partition> <options> + + The options are as follows: + + --noformat + + Use an existing volume group and do not format it. + + --useexisting + + Use an existing volume group and reformat it. + + --pesize= + + Set the size of the physical extents. + + Create the partition first, create the logical volume group, and + then create the logical volume. For example: + + part pv.01 --size 3000 + volgroup myvg pv.01 + logvol / --vgname=myvg --size=2000 --name=rootvol + xconfig (optional) - Configures the X Window System. If this option is not given, the - user will need to configure X manually during the installation, if - X was installed; this option should not be used if X is not - installed on the final system. + Configures the X Window System. If this option is not given, + anaconda will use X to attempt to automatically configure. Please + try this before manually configuring your system. --driver= @@ -1110,44 +1252,23 @@ Creating the Kickstart File to specify a color depth that is compatible with the video card and monitor. - volgroup (optional) - - Use to create a Logical Volume Management (LVM) group with the - syntax: - - volgroup <name> <partition> <options> - - The options are as follows: - - --noformat - - Use an existing volume group and do not format it. - - --useexisting - - Use an existing volume group and reformat it. - - --pesize= + zerombr (optional) - Set the size of the physical extents. + If zerombr is specified, any invalid partition tables found on + disks are initialized. This will destroy all of the contents of + disks with invalid partition tables. - Create the partition first, create the logical volume group, and - then create the logical volume. For example: + zfcp (optional) - part pv.01 --size 3000 - volgroup myvg pv.01 - logvol / --vgname=myvg --size=2000 --name=rootvol + --devnum= - zerombr (optional) + --fcplun= - If zerombr is specified, and yes is its sole argument, any invalid - partition tables found on disks are initialized. This will destroy - all of the contents of disks with invalid partition tables. This - command should be in the following format: + --scsiid= - zerombr yes + --scsilun= - No other format is effective. + --wwpn= %include @@ -1193,6 +1314,15 @@ Creating the Kickstart File gnome-desktop. Specify individual packages with no additional characters (the dhcp line in the example above is an individual package). + Additionally, individual packages may be specified using globs. For + instance: + + %packages + vim* + kde-i18n-* + + This would install all packages whose names start with vim or kde-i18n. + You can also specify which packages not to install from the default package list: @@ -1243,6 +1373,10 @@ Creating the Kickstart File message will direct you to where the cause of the failure is logged. + --log= + + Log all messages from the script to the given log file. + Example Here is an example %pre section: @@ -1343,6 +1477,10 @@ fi message will direct you to where the cause of the failure is logged. + --log= + + Log all messages from the script to the given log file. + Examples Turn services on and off: |