From Fedora Project Wiki

No edit summary
(add a link to the Anaconda command line options page)
(69 intermediate revisions by 19 users not shown)
Line 1: Line 1:
For more information on using Anaconda options, refer to "Appendix A. Boot Options" in the ''Fedora Installation Guide''. For example, the {{FedoraVersion|long}} version: http://docs.fedoraproject.org/en-US/Fedora/{{FedoraVersion}}/html/Installation_Guide/ch-Boot-x86.html#s2-x86-starting-bootopts
{{admon/warning|Out-of-date|The information on this page is out-of-date and some parts may be inaccurate for Fedora 17 and later.}}
 
For more information on using Anaconda options, refer to the appropriate Installation Guide for your release. Developer documentation, which may include information about boot options, is available in the docs directory of the Anaconda distribution.
 
For information about options available when running Anaconda from the command line, please visit the [[Anaconda_Command_Line_Options | Anaconda command line options page]].


{{anchor|askmethod}}
{{anchor|askmethod}}
;[[#askmethod|<code>askmethod</code>]]
;[[#askmethod|<code>askmethod</code>]]
: Do not automatically use the CD-ROM as the install source if we detect installation media in your CD-ROM drive.
: '''Fedora 16 and earlier'''
 
: Do not automatically use the CD-ROM as the install source if we detect installation media in your CD-ROM drive: instead prompt for a source during the first stage of installation.
{{anchor|asknetwork}}
: '''Fedora 17 and 18'''
;[[#asknetwork|<code>asknetwork</code>]]
: Has no effect.
: Prompt for network configuration in the first stage of installation regardless of installation method.
: '''Fedora 19 and later'''
: Do not automatically configure the Installation Source spoke, but require the user to enter it and choose an option. If you don't want to wait for the default configuration to be processed before you can enter the spoke and change it, you can pass this option. See [[rhbug:889887|Bug #889887]].


{{anchor|autostep}}
{{anchor|autostep}}
Line 16: Line 21:
;[[#blacklist|<code>blacklist=<module></code>]]
;[[#blacklist|<code>blacklist=<module></code>]]
: Do not automatically load module <module>, even if the hardware exists on the system.
: Do not automatically load module <module>, even if the hardware exists on the system.
{{anchor|bond}}
;[[#bond|<code>bond=<bondname>:<bondslaves>:[:<options>]</code>]]
: Create bonded network interface. This is dracut option, see dracut documentation for details on syntax. Example: <code>bond=bond0:eth0,eth1:mode=active-backup,primary=eth1</code>.
{{admon/warning|Available in Fedora 19 and later|The bond option is supported since Fedora 19.}}


{{anchor|cmdline}}
{{anchor|cmdline}}
;[[#cmdline|<code>cmdline</code>]]
;[[#cmdline|<code>cmdline</code>]]
: Force command line install mode.  This mode simply prints out text and does not allow any interactivity.  All options must be specified either in a kickstart file or on the command line.
: Force command line install mode.  This mode simply prints out text and does not allow any interactivity.  All options must be specified either in a kickstart file or on the command line.
{{anchor|console}}
;[[#console|<code>console=ttyS0</code>]]
: Turn on serial console support and display anaconda on serial console instead of graphical console.  Settings will carry over to the installed system.


{{anchor|dd}}
{{anchor|dd}}
Line 40: Line 55:
;[[#dhcptimeout|<code>dhcptimeout=<sec></code>]]
;[[#dhcptimeout|<code>dhcptimeout=<sec></code>]]
: Stop attempting to get a DHCP lease after <sec> seconds.
: Stop attempting to get a DHCP lease after <sec> seconds.
{{anchor|display}}
;[[#display|<code>display=<DISPLAY></code>]]
: Sets the $DISPLAY environment variable.


{{anchor|dns}}
{{anchor|dns}}
Line 49: Line 60:
: Comma separated list of nameservers to use for a network installation.
: Comma separated list of nameservers to use for a network installation.


{{anchor|dogtail}}
{{admon/warning|Dracut syntax required in Fedora 17 and later|The syntax for specifying network configuration which uses the ''dns'', ''gateway'', ''ip'', ''ipv6'', ''netmask'' and ''mtu'' parameters as described here does not work in Fedora 17. Instead, please use the [[Dracut/Options#Network|Dracut ip<nowiki>=</nowiki>]] syntax.}}
;[[#dogtail|<code>dogtail=<url></code>]]
: Use the dogtail (automated UI testing framework) script found at <url>.  Only makes sense on graphical installs.
 
{{anchor|essid}}
;[[#essid|<code>essid=<essid></code>]]
: Connect to the wireless network given by <essid> for a network installation. Only makes sense with <code>allowwireless</code>.
 
{{anchor|ethtool}}
;[[#ethtool|<code>ethtool=<opts></code>]]
: Specify certain additional network device settings. Valid options are duplex={full,half} and speed={1000,100,10}.  Multiple options may be given as a string separated by spaces and surrounded by double quotes.


{{anchor|ext4migrate}}
{{anchor|extlinux}}
;[[#ext4migrate|<code>ext4migrate</code>]]
;[[#extlinux|<code>extlinux</code>]]
: In Fedora 11 or above, configure the system to mount ext3 partitions as ext4 and enable the extents format among other changes.  
: Use extlinux as the bootloader. Note that there's no attempt to validate that this will work for your platform or anything; it assumes that if you ask for it, you want to try.


{{anchor|gateway}}
{{anchor|gateway}}
Line 69: Line 70:
: Gateway to use for a network installation.
: Gateway to use for a network installation.


{{anchor|gdb}}
{{admon/warning|Dracut syntax required in Fedora 17 and later|The syntax for specifying network configuration which uses the ''dns'', ''gateway'', ''ip'', ''ipv6'', ''netmask'' and ''mtu'' parameters as described here does not work in Fedora 17. Instead, please use the [[Dracut/Options#Network|Dracut ip<nowiki>=</nowiki>]] syntax.}}
;[[#gdb|<code>gdb=IP:PORT</code>]]
 
: Run gdbserver in loader, attached to IP:PORT (eg. gdb=0.0.0.0:2345)
 
: On the host you need the anaconda-debuginfo package's contents to properly debug the binary. Run <code>gdb /path/to/loader.debug</code> and then specify the loader source directory with the <code>dir</code> command. Connect to the remote target with <code>target remote 1.2.3.4:2345</code>.
{{anchor|geoloc}}
;[[#geoloc|<code>geoloc</code>]]
: Configure geolocation usage in Anaconda. Geolocation is used to pre-set language and time zone.
 
: The following arguemtns are supported:
:*<code>geoloc=0</code>  
:: Disables geolocation.
:*<code>geoloc=provider_fedora_geoip</code>  
:: Use the Fedora GeoIP API (default).
:*<code>geoloc=provider_hostip</code>  
:: Use the Hostip.info GeoIP API.
 


{{anchor|graphical}}
{{anchor|graphical}}
Line 85: Line 97:
;[[#ip|<code>ip=<ip></code>]]
;[[#ip|<code>ip=<ip></code>]]
: IP to use for a network installation, use 'dhcp' for DHCP.
: IP to use for a network installation, use 'dhcp' for DHCP.
{{admon/warning|Dracut syntax required in Fedora 17 and later|The syntax for specifying network configuration which uses the ''dns'', ''gateway'', ''ip'', ''ipv6'', ''netmask'' and ''mtu'' parameters as described here does not work in Fedora 17. Instead, please use the [[Dracut/Options#Network|Dracut ip<nowiki>=</nowiki>]] syntax.}}


{{anchor|ipv6}}
{{anchor|ipv6}}
;[[#ipv6|<code>ipv6=<ipv6></code>]]
;[[#ipv6|<code>ipv6=<ipv6></code>]]
: IPv6 IP address to use for a network installation. Use 'auto' for automatic neighbor discovery, 'dhcp' for configuration using DHCPv6.
: IPv6 address to use for a network installation. This can be the static address in form <code><IPv6 address>[/<prefix length>]</code>, e.g. 3ffe:ffff:0:1::1/128 (if prefix is omitted 64 is assumed), "auto" for address assignment based on automatic neighbor discovery, or "dhcp" to use the DHCPv6 protocol.
 
{{admon/warning|Dracut syntax required in Fedora 17 and later|The syntax for specifying network configuration which uses the ''dns'', ''gateway'', ''ip'', ''ipv6'', ''netmask'' and ''mtu'' parameters as described here does not work in Fedora 17. Instead, please use the [[Dracut/Options#Network|Dracut ip<nowiki>=</nowiki>]] syntax.}}


{{anchor|keymap}}
{{anchor|keymap}}
;[[#keymap|<code>keymap=<keymap></code>]]
;[[#keymap|<code>keymap=<keymap></code>]]
: Keyboard layout to use.  Valid values are those which can be used for the <code>keyboard</code> kickstart command.
: Keyboard layout to use.  Valid values are those which can be used for the [[Anaconda/Kickstart#keyboard|<code>keyboard</code> kickstart command]].


{{anchor|ks}}
{{anchor|ks}}
;[[#ks|<code>ks</code>]]
;[[#ks|<code>ks</code>]]
: Gives the location of the kickstart file to be used for installation.  If only <code>ks</code> is given, the file is assumed to be on NFS.  The ks parameter may take these other forms:
: Gives the location of the kickstart file to be used for installation.  If only <code>ks</code> is given, the file is assumed to be on NFS.  The ks parameter may take these other forms:
:*<code>ks=cdrom:<device></code>
:*<code>ks=cdrom:<device>[:<path>]</code>  If no path is given, <code>/ks.cfg</code> is used by default.
:*<code>ks=file:<path></code>  (path = 'fd0/ks.cfg', for example)
:*<code>ks=file:<path></code>  (path = 'fd0/ks.cfg', for example)
:*<code><nowiki>ks=ftp://<path></nowiki></code>
:*<code><nowiki>ks=ftp://<path></nowiki></code>
Line 105: Line 121:
:*<code>ks=bd:<biosdev>:<path></code>  (biosdev = '80p1', for example, note this does not work for BIOS RAID sets)
:*<code>ks=bd:<biosdev>:<path></code>  (biosdev = '80p1', for example, note this does not work for BIOS RAID sets)


{{anchor|ks.device}}
{{anchor|ksdevice}}
{{anchor|ksdevice}}
;[[#ksdevice|<code>ksdevice</code>]]
;[[#ks.device|<code>ks.device</code>]]
: Takes one of 4 types of argument which tells install what network device to use for kickstart from network:
: Takes one of 4 types of argument which tells install what network device to use for kickstart from network:
:* An argument like 'eth0' naming a specific interface
:* An argument like 'eth0' naming a specific interface
Line 114: Line 131:
:* The keyword 'ibft' - use device configured with MAC address in iBFT
:* The keyword 'ibft' - use device configured with MAC address in iBFT


{{admon/warning|Renamed in Fedora 17|This parameter used to be 'ksdevice'. It was renamed in Fedora 17.}}
{{anchor|ks.sendmac}}
{{anchor|kssendmac}}
{{anchor|kssendmac}}
;[[#kssendmac|<code>kssendmac</code>]]
;[[#ks.sendmac|<code>ks.sendmac</code>]]
: Adds HTTP headers to ks=http:// requests that can be helpful for provisioning systems.  Includes MAC address of all network interfaces in HTTP headers of the form "X-RHN-Provisioning-MAC-0: eth0 01:23:45:67:89:ab".
: Adds HTTP headers to ks=http:// requests that can be helpful for provisioning systems.  Includes MAC address of all network interfaces in HTTP headers of the form "X-RHN-Provisioning-MAC-0: eth0 01:23:45:67:89:ab".


{{admon/warning|Renamed in Fedora 17|This parameter used to be 'kssendmac'. It was renamed in Fedora 17.}}
{{anchor|ks.sendsn}}
{{anchor|kssendsn}}
{{anchor|kssendsn}}
;[[#kssendsn|<code>kssendsn</code>]]
;[[#ks.sendsn|<code>ks.sendsn</code>]]
: Adds an HTTP header to ks=http:// requests that can be helpful for provisioning systems.  Includes the system's serial number (according to dmidecode) in an HTTP header of the form "X-System-Serial-Number: 1234567890".
: Adds an HTTP header to ks=http:// requests that can be helpful for provisioning systems.  Includes the system's serial number (according to dmidecode) in an HTTP header of the form "X-System-Serial-Number: 1234567890".
{{admon/warning|Renamed in Fedora 17|This parameter used to be 'kssendsn'. It was renamed in Fedora 17.}}


{{anchor|lang}}
{{anchor|lang}}
;[[#lang|<code>lang=<lang></code>]]
;[[#lang|<code>lang=<lang></code>]]
: Language to use for the installation.  This should be a language which is valid to be used with the <code>lang</code> kickstart command.
: Language to use for the installation.  This should be a language which is valid to be used with the <code>lang</code> kickstart command.
{{anchor|leavebootorder}}
;[[#leavebootorder|<code>leavebootorder</code>]]
: Boot the drives in their existing order, to override the default of booting into the newly installed drive on Power Systems servers and EFI systems. This is useful for systems that, for example, should network boot first before falling back to a local boot.
{{admon/warning|Available in Fedora 18 and later|The leavebootorder option was introduced in Fedora 18.}}


{{anchor|linksleep}}
{{anchor|linksleep}}
Line 133: Line 164:
;[[#loglevel|<code>loglevel=<level></code>]]
;[[#loglevel|<code>loglevel=<level></code>]]
: Set the minimum level required for messages to be logged on a terminal (log files always contain messages of all levels).  Values for <level> are debug, info, warning, error, and critical.  The default value is info.
: Set the minimum level required for messages to be logged on a terminal (log files always contain messages of all levels).  Values for <level> are debug, info, warning, error, and critical.  The default value is info.
{{anchor|lowres}}
;[[#lowres|<code>lowres</code>]]
: In [[Releases/10|Fedora 10]] and earlier, force GUI installer to run at 640x480.  This will not resize the interface, so some UI elements will likely be offscreen (although still active through keyboard navigation).


{{anchor|mediacheck}}
{{anchor|mediacheck}}
Line 149: Line 176:
;[[#mtu|<code>mtu=<num></code>]]
;[[#mtu|<code>mtu=<num></code>]]
: Set the MTU (maximum transmission unit) used during network installs to the given number.  Uses the network stack default if this option is not specified.
: Set the MTU (maximum transmission unit) used during network installs to the given number.  Uses the network stack default if this option is not specified.
{{admon/warning|Dracut syntax required in Fedora 17 and later|The syntax for specifying network configuration which uses the ''dns'', ''gateway'', ''ip'', ''ipv6'', ''netmask'' and ''mtu'' parameters as described here does not work in Fedora 17. Instead, please use the [[Dracut/Options#Network|Dracut ip<nowiki>=</nowiki>]] syntax.}}
{{anchor|multilib}}
;[[#multilib|<code>multilib</code>]]
: Enable yum's multlib_policy of "all" instead of the default of "best".


{{anchor|netmask}}
{{anchor|netmask}}
;[[#netmask|<code>netmask=<nm></code>]]
;[[#netmask|<code>netmask=<nm></code>]]
: Netmask to use for a network installation.
: Netmask to use for a network installation.
{{admon/warning|Dracut syntax required in Fedora 17 and later|The syntax for specifying network configuration which uses the ''dns'', ''gateway'', ''ip'', ''ipv6'', ''netmask'' and ''mtu'' parameters as described here does not work in Fedora 17. Instead, please use the [[Dracut/Options#Network|Dracut ip<nowiki>=</nowiki>]] syntax.}}


{{anchor|nicdelay}}
{{anchor|nicdelay}}
Line 161: Line 196:
;[[#nodmraid|<code>nodmraid</code>]]
;[[#nodmraid|<code>nodmraid</code>]]
: Disable support for dmraid.
: Disable support for dmraid.
{{admon/warning|This option is never a good idea!| If you have a disk that is erroneously identified as part of a firmware RAID array, that means it has some stale RAID metadata on it which must be removed using an appropriate tool (dmraid and/or wipefs).}}


{{anchor|nofirewire}}
{{anchor|nofirewire}}
;[[#nofirewire|<code>nofirewire</code>]]
;[[#nofirewire|<code>nofirewire</code>]]
: Do not load support for firewire devices.
: Do not load support for firewire devices.
{{anchor|nogpt}}
;[[#nogpt|<code>nogpt</code>]]
: Do not create GPT disklabels.


{{anchor|noipv4}}
{{anchor|noipv4}}
;[[#noipv4|<code>noipv4</code>]]
;[[#noipv4|<code>noipv4</code>]]
: Disable IPv4 networking during installation.
: Disable IPv4 networking during installation.
{{anchor|noipv6}}
;[[#noipv6|<code>noipv6</code>]]
: Disable IPv6 networking during installation.


{{anchor|nokill}}
{{anchor|nokill}}
Line 181: Line 218:
;[[#nomount|<code>nomount</code>]]
;[[#nomount|<code>nomount</code>]]
: Don't automatically mount any installed Linux partitions in rescue mode.
: Don't automatically mount any installed Linux partitions in rescue mode.
{{anchor|nomemcheck}}
;[[#nomemcheck|<code>nomemcheck</code>]]
: Since Fedora 17: Disable the check which usually causes anaconda to abort if a safe minimum amount of memory is not found. Of course, any attempt to install with less than the safe minimum amount of memory may fail and is unsupported.


{{anchor|nompath}}
{{anchor|nompath}}
;[[#nompath|<code>nompath</code>]]
;[[#nompath|<code>nompath</code>]]
: Disable support for multipath devices.
: Disable support for multipath devices. This is for systems on which a false-positive is encountered which erroneously identifies a normal block device as a multipath device. There is no other reason to use this option.
 
{{admon/warning|Not for use with actual multipath hardware!|Using this to attempt to install to a single path of a multipath is ill-advised, and not supported.}}


{{anchor|nopass}}
{{anchor|nopass}}
Line 201: Line 244:
;[[#noshell|<code>noshell</code>]]
;[[#noshell|<code>noshell</code>]]
: Do not put a shell on tty2 during install.
: Do not put a shell on tty2 during install.
{{admon/warning|Broken in Fedora 16 and later|The 'noshell' parameter is broken in Fedora releases since Fedora 16. See [[rhbug:807703|Bug #807703]]}}


{{anchor|nousb}}
{{anchor|nousb}}
;[[#nousb|<code>nousb</code>]]
;[[#nousb|<code>nousb</code>]]
: Do not load USB support (helps if install hangs early sometimes).
: Do not load USB support (helps if install hangs early sometimes).
{{anchor|noverifyssl}}
;[[#noverifyssl|<code>noverifyssl</code>]]
: Prevents Anaconda from verifying the ssl certificate for all https connections with an exception of the additional [[Anaconda/Kickstart#repo | kickstart repos]] (where --noverifyssl can be set per repo).


{{anchor|proxy}}
{{anchor|proxy}}
Line 212: Line 260:
{{anchor|repo}}
{{anchor|repo}}
;[[#repo|<code>repo=</code>]]
;[[#repo|<code>repo=</code>]]
: This option tells anaconda where to find the packages for installation.  This option must point to a valid yum repository.  It is analagous to the older method= option, but repo= makes it more clear exactly what is meant.  This option may appear only once on the command line.  It may appear multiple times inside a kickstart file. As of Anaconda 16.12 you can (optionally) add a specific .iso file to the path.
: This option tells anaconda where to find the packages for installation.  This option must point to a valid yum repository (or, for some protocols, a Fedora DVD ISO image).  It is analogous to the older method= option, but repo= makes it more clear exactly what is meant.  This option may appear only once on the command line.  It corresponds to the kickstart command <code>install</code> (whereas kickstart command <code>repo</code> is used for additional repositories). As of Fedora 16, you can (optionally) add a specific .iso file to the path. If no inst.root= or inst.stage2= parameter is passed, this location will also be used as the source for the installer runtime image.


: The following forms are accepted for repo=:
: The following forms are accepted for repo=:
Line 220: Line 268:
:* <code>repo=hd:<device>:/<path></code>
:* <code>repo=hd:<device>:/<path></code>
::Look for ISO images on the hard drive partition given by device (/dev/sda1, for instance).  This may not be a partition that will be formatted during installation later.  These should be ISO images, not an exploded tree on the hard drive.  device can be a device name, LABEL=, or UUID=.
::Look for ISO images on the hard drive partition given by device (/dev/sda1, for instance).  This may not be a partition that will be formatted during installation later.  These should be ISO images, not an exploded tree on the hard drive.  device can be a device name, LABEL=, or UUID=.
:* <code>repo=hd:LABEL=<label>:/<path></code>
:* <code>repo=hd:UUID=<uuid>:/<path></code>
::As <code>repo=hd:<device></code>, but you can specify a partition by label or UUID.
:* <code>repo=nfs[:options]:<server>:/<path></code>
:* <code>repo=nfs[:options]:<server>:/<path></code>
:* <code>repo=nfsiso[:options]:<server>:/<path></code>
:* <code>repo=nfsiso[:options]:<server>:/<path></code>
::Look for ISO images on the NFS volume with the given server and path. These should be ISO images, not loopback mounted.
::Will use either an ISO image or a Fedora tree on the NFS volume with the given server and path as an install repository (in all current supported releases, 'nfs' and 'nfsiso' are synonyms; anaconda will check for either an ISO image or an install tree in the specified location whichever of the two you pass). If an 'inst.root' or 'inst.stage2' parameter is passed - as is the case by default when the installer is booted from the DVD or network install images - the mount will first be tried using the NFSv4 protocol, and if this fails, it will be tried using the NFSv3 protocol. There is a [[rhbug:968023|known bug]] in Fedora 19 Beta which prevents NFSv3 mount attempts from succeeding unless the 'nolock' option is specified. If no 'inst.root' or 'inst.stage2' parameter is passed, and so the NFS repository is being used as the installer runtime image source as well as a package source (which will be the case when booting directly from a kernel pair, for e.g., in a PXE installation, or using virt-install), the NFSv3 protocol only will be used, due to a [[rhbug:811242|known bug]] which affects trying to mount the installation root via the NFSv4 protocol.
 
{{anchor|resolution}}
;[[#resolution|<code>resolution=<mode></code>]]
: Run GUI installer in mode specified, '1024x768' for example.


{{anchor|rescue}}
{{anchor|rescue}}
;[[#rescue|<code>rescue</code>]]
;[[#rescue|<code>rescue</code>]]
: Run rescue environment.
: Run rescue environment.
{{anchor|resolution}}
;[[#resolution|<code>resolution=<mode></code>]]
: Run installer in mode specified, '1024x768' for example.


{{anchor|selinux[}}
{{anchor|selinux[}}
;[[#selinux|<code>selinux[=0]</code>]]
;[[#selinux|<code>selinux[=0]</code>]]
: Disables selinux entirely.  Defaults to on.
: Disables selinux entirely.  Defaults to on.
{{anchor|serial}}
;[[#serial|<code>serial</code>]]
: Turns on serial console support.


{{anchor|sshd}}
{{anchor|sshd}}
;[[#sshd|<code>sshd</code>]]
;[[#sshd|<code>sshd</code>]]
: Starts up sshd during system installation.  You can then ssh in while the installation progresses to debug or monitor.  Passwords are controlled via the kickstart sshpw command.  By default, the root account has a blank password, so if the sshd option is specified, anyone can login as root and have full access to the machine during installation.
: Starts up sshd during system installation.  You can then ssh in while the installation progresses to debug or monitor.  Passwords are controlled via the kickstart sshpw command.  By default, the root account has a blank password, so if the sshd option is specified, anyone can login as root and have full access to the machine during installation.
{{anchor|stage2}}
;[[#stage2|<code>stage2=</code>]]
: Specifies a path to a repository containing a stage2 (squashfs.img) file instead of to an installation source. Follows the same syntax as repo=. If this parameter is provided, it takes precedence over all other methods of finding the install.img. Otherwise, anaconda will attempt to find the install.img first on any existing CD, and then from the location given by repo=.
: If only stage2= is given without repo=, anaconda will use whatever repos the installed system would have enabled by default for installation. For instance, an install of a Fedora release will attempt to use the Fedora mirrorlist given by /etc/yum.repos.d/fedora.repo from that release.


{{anchor|syslog}}
{{anchor|syslog}}
Line 252: Line 305:
: Force text mode install.  This will install only base packages for a minimal system and implies that the installed system will boot up in runlevel 3 instead of to the graphical login screen.
: Force text mode install.  This will install only base packages for a minimal system and implies that the installed system will boot up in runlevel 3 instead of to the graphical login screen.


{{anchor|updates}}
{{anchor|traceback}}
;[[#updates|<code>updates</code>]]
;[[#traceback|<code>traceback</code>]]
: Prompt for removable media containing updates (bug fixes).
: Since Fedora 17. Raise exception in the GUI (for testing purposes). DO NOT USE THIS IF YOU WANT TO INSTALL THE SYSTEM.
{{admon/warning|Deprecated since Fedora 19.}}


{{anchor|updates}}
{{anchor|updates}}
;[[#updates|<code>updates=<url></code>]]
;[[#updates|<code>updates=<url></code>]]
: Image containing updates over FTP or HTTP.
: Image containing updates over FTP or HTTP. See [[Anaconda/Updates]] for more details.
 
: Accepts either <code>updates=<url></code> or <code>updates=<disk>:<path></code> where <code><disk></code> can be one of <code>sdX, /dev/sdX, LABEL=xxx, UUID=xxx</code> and <code><path></code> defaults to <code>/updates.img</code> if missing.
{{anchor|upgradeany}}
;[[#upgradeany|<code>upgradeany</code>]]
: Don't require an /etc/redhat-release that matches the expected syntax to upgrade.


{{anchor|usefbx}}
{{anchor|usefbx}}
Line 268: Line 319:
: Use the framebuffer X driver instead of attempting to use a hardware-specific one.
: Use the framebuffer X driver instead of attempting to use a hardware-specific one.


{{anchor|utf8}}
{{anchor|video}}
;[[#utf8|<code>utf8</code>]]
;[[#video|<code>video=<mode></code>]]
: Set the TERM variable to vt100.
: Run KMS framebuffer in video mode specified, 1152x864 for example.


{{anchor|virtiolog}}
{{anchor|virtiolog}}
;[[#virtiolog|<code>virtiolog=<port_name></code>]]
;[[#virtiolog|<code>virtiolog=<port_name></code>]]
: Forward logs through the character device at /dev/virtio-ports/<port_name>. See also [[Anaconda/Logging]].
: Forward logs through the character device at /dev/virtio-ports/<port_name>. See also [[Anaconda/Logging]].
{{anchor|vlan}}
;[[#vlan|<code>vlan=<vlanname>:<phydevice></code>]]
: Create vlan network interface. This is dracut option, see dracut documentation for details on syntax. Example: <code>vlan=eth0.171:eth0</code>.
{{admon/warning|Available in Fedora 19 and later|The vlan option is supported since Fedora 19.}}


{{anchor|vnc}}
{{anchor|vnc}}
;[[#vnc|<code>vnc</code>]]
;[[#vnc|<code>vnc</code>]]
: Enable vnc-based installation. You will need to connect to the machine using a vnc client application.  A vnc install implies that the installed system will boot up in runlevel 3 instead of to the graphical login screen.
: Enable vnc-based installation. You will need to connect to the machine using a vnc client application.  A vnc install implies that the installed system will boot up in runlevel 3 instead of to the graphical login screen.  The vnc session will be shared.  Consider setting a vnc password.
 
{{anchor|vncport}}
;[[#vnc|<code>vncport=<port></code>]]
: Specify a port for the vnc server to run on.  The default is 5901.


{{anchor|vncconnect}}
{{anchor|vncconnect}}
Line 287: Line 348:
;[[#vncpassword|<code>vncpassword=<password></code>]]
;[[#vncpassword|<code>vncpassword=<password></code>]]
: Enable a password for the vnc connection. This will prevent someone from inadvertently connecting to the vnc-based installation.  Requires <code>vnc</code> option to be specified as well.  If you have specified <code>vncconnect</code> the <password> will not be used unless connection to host is not possible.
: Enable a password for the vnc connection. This will prevent someone from inadvertently connecting to the vnc-based installation.  Requires <code>vnc</code> option to be specified as well.  If you have specified <code>vncconnect</code> the <password> will not be used unless connection to host is not possible.
{{anchor|wepkey}}
;[[#wepkey|<code>wepkey=<key></code>]]
: Use <key> as the wireless key when doing a network installation via a wireless network.  Requires use of <code>essid</code>.  Only makes sense with <code>allowwireless</code>.


{{anchor|xdriver}}
{{anchor|xdriver}}

Revision as of 16:35, 16 April 2014

Warning.png
Out-of-date
The information on this page is out-of-date and some parts may be inaccurate for Fedora 17 and later.

For more information on using Anaconda options, refer to the appropriate Installation Guide for your release. Developer documentation, which may include information about boot options, is available in the docs directory of the Anaconda distribution.

For information about options available when running Anaconda from the command line, please visit the Anaconda command line options page.

askmethod
Fedora 16 and earlier
Do not automatically use the CD-ROM as the install source if we detect installation media in your CD-ROM drive: instead prompt for a source during the first stage of installation.
Fedora 17 and 18
Has no effect.
Fedora 19 and later
Do not automatically configure the Installation Source spoke, but require the user to enter it and choose an option. If you don't want to wait for the default configuration to be processed before you can enter the spoke and change it, you can pass this option. See Bug #889887.

autostep
Advance to the next screen automatically. This is mostly useful for debugging.

blacklist=<module>
Do not automatically load module <module>, even if the hardware exists on the system.

bond=<bondname>:<bondslaves>:[:<options>]
Create bonded network interface. This is dracut option, see dracut documentation for details on syntax. Example: bond=bond0:eth0,eth1:mode=active-backup,primary=eth1.
Warning.png
Available in Fedora 19 and later
The bond option is supported since Fedora 19.

cmdline
Force command line install mode. This mode simply prints out text and does not allow any interactivity. All options must be specified either in a kickstart file or on the command line.

console=ttyS0
Turn on serial console support and display anaconda on serial console instead of graphical console. Settings will carry over to the installed system.

dd
Use a driver disk.

driverdisk
See dd

debug=1
Add a debug button to the UI that allows dropping into a python debugger.

dhcpclass=<class>
Sends a custom DHCP vendor class identifier. ISC's dhcpcd can inspect this value using "option vendor-class-identifier".

dhcptimeout=<sec>
Stop attempting to get a DHCP lease after <sec> seconds.

dns=<dns>
Comma separated list of nameservers to use for a network installation.
Warning.png
Dracut syntax required in Fedora 17 and later
The syntax for specifying network configuration which uses the dns, gateway, ip, ipv6, netmask and mtu parameters as described here does not work in Fedora 17. Instead, please use the Dracut ip= syntax.

extlinux
Use extlinux as the bootloader. Note that there's no attempt to validate that this will work for your platform or anything; it assumes that if you ask for it, you want to try.

gateway=<gw>
Gateway to use for a network installation.
Warning.png
Dracut syntax required in Fedora 17 and later
The syntax for specifying network configuration which uses the dns, gateway, ip, ipv6, netmask and mtu parameters as described here does not work in Fedora 17. Instead, please use the Dracut ip= syntax.


geoloc
Configure geolocation usage in Anaconda. Geolocation is used to pre-set language and time zone.
The following arguemtns are supported:
  • geoloc=0
Disables geolocation.
  • geoloc=provider_fedora_geoip
Use the Fedora GeoIP API (default).
  • geoloc=provider_hostip
Use the Hostip.info GeoIP API.


graphical
Force graphical install. Required to have ftp/http use GUI. A graphical install implies that the installed system will boot up into runlevel 5, using whichever display manager is in use by the default desktop (gdm for GNOME, kdm for KDE).

headless
Specify that the machine being installed onto does not have any display hardware, and that anaconda should not probe for it.

ip=<ip>
IP to use for a network installation, use 'dhcp' for DHCP.
Warning.png
Dracut syntax required in Fedora 17 and later
The syntax for specifying network configuration which uses the dns, gateway, ip, ipv6, netmask and mtu parameters as described here does not work in Fedora 17. Instead, please use the Dracut ip= syntax.

ipv6=<ipv6>
IPv6 address to use for a network installation. This can be the static address in form <IPv6 address>[/<prefix length>], e.g. 3ffe:ffff:0:1::1/128 (if prefix is omitted 64 is assumed), "auto" for address assignment based on automatic neighbor discovery, or "dhcp" to use the DHCPv6 protocol.
Warning.png
Dracut syntax required in Fedora 17 and later
The syntax for specifying network configuration which uses the dns, gateway, ip, ipv6, netmask and mtu parameters as described here does not work in Fedora 17. Instead, please use the Dracut ip= syntax.

keymap=<keymap>
Keyboard layout to use. Valid values are those which can be used for the keyboard kickstart command.

ks
Gives the location of the kickstart file to be used for installation. If only ks is given, the file is assumed to be on NFS. The ks parameter may take these other forms:
  • ks=cdrom:<device>[:<path>] If no path is given, /ks.cfg is used by default.
  • ks=file:<path> (path = 'fd0/ks.cfg', for example)
  • ks=ftp://<path>
  • ks=hd:<dev>:<path> (dev = 'hda1', for example)
  • ks=http://<host>/<path>
  • ks=nfs[:options]:<server>:<path>
  • ks=bd:<biosdev>:<path> (biosdev = '80p1', for example, note this does not work for BIOS RAID sets)

ks.device
Takes one of 4 types of argument which tells install what network device to use for kickstart from network:
  • An argument like 'eth0' naming a specific interface
  • An argument like 00:12:34:56:78:9a indicating the MAC address of a specific interface
  • The keyword 'link' indicating that the first interface with link up
  • The keyword 'bootif' indicating that the MAC address indicated by the BOOTIF command line option will be used to locate the boot interface. BOOTIF is automagically supplied by pxelinux when you include the option 'IPAPPEND 2' in your pxelinux.cfg file
  • The keyword 'ibft' - use device configured with MAC address in iBFT
Warning.png
Renamed in Fedora 17
This parameter used to be 'ksdevice'. It was renamed in Fedora 17.

ks.sendmac
Adds HTTP headers to ks=http:// requests that can be helpful for provisioning systems. Includes MAC address of all network interfaces in HTTP headers of the form "X-RHN-Provisioning-MAC-0: eth0 01:23:45:67:89:ab".
Warning.png
Renamed in Fedora 17
This parameter used to be 'kssendmac'. It was renamed in Fedora 17.

ks.sendsn
Adds an HTTP header to ks=http:// requests that can be helpful for provisioning systems. Includes the system's serial number (according to dmidecode) in an HTTP header of the form "X-System-Serial-Number: 1234567890".
Warning.png
Renamed in Fedora 17
This parameter used to be 'kssendsn'. It was renamed in Fedora 17.

lang=<lang>
Language to use for the installation. This should be a language which is valid to be used with the lang kickstart command.

leavebootorder
Boot the drives in their existing order, to override the default of booting into the newly installed drive on Power Systems servers and EFI systems. This is useful for systems that, for example, should network boot first before falling back to a local boot.
Warning.png
Available in Fedora 18 and later
The leavebootorder option was introduced in Fedora 18.

linksleep=<delay>
Check the network device for a link every second for <delay> seconds.

loglevel=<level>
Set the minimum level required for messages to be logged on a terminal (log files always contain messages of all levels). 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).

method=
This option is deprecated in favor of repo=. For now, it does the same thing as repo= but will be removed at a later date.

mtu=<num>
Set the MTU (maximum transmission unit) used during network installs to the given number. Uses the network stack default if this option is not specified.
Warning.png
Dracut syntax required in Fedora 17 and later
The syntax for specifying network configuration which uses the dns, gateway, ip, ipv6, netmask and mtu parameters as described here does not work in Fedora 17. Instead, please use the Dracut ip= syntax.

multilib
Enable yum's multlib_policy of "all" instead of the default of "best".

netmask=<nm>
Netmask to use for a network installation.
Warning.png
Dracut syntax required in Fedora 17 and later
The syntax for specifying network configuration which uses the dns, gateway, ip, ipv6, netmask and mtu parameters as described here does not work in Fedora 17. Instead, please use the Dracut ip= syntax.

nicdelay=<sec>
Sleep for <sec> seconds before trying again to bring up the network.

nodmraid
Disable support for dmraid.
Warning.png
This option is never a good idea!
If you have a disk that is erroneously identified as part of a firmware RAID array, that means it has some stale RAID metadata on it which must be removed using an appropriate tool (dmraid and/or wipefs).

nofirewire
Do not load support for firewire devices.

nogpt
Do not create GPT disklabels.

noipv4
Disable IPv4 networking during installation.

nokill
A debugging option that prevents anaconda from terminating all running programs when a fatal error occurs.

nomount
Don't automatically mount any installed Linux partitions in rescue mode.

nomemcheck
Since Fedora 17: Disable the check which usually causes anaconda to abort if a safe minimum amount of memory is not found. Of course, any attempt to install with less than the safe minimum amount of memory may fail and is unsupported.

nompath
Disable support for multipath devices. This is for systems on which a false-positive is encountered which erroneously identifies a normal block device as a multipath device. There is no other reason to use this option.
Warning.png
Not for use with actual multipath hardware!
Using this to attempt to install to a single path of a multipath is ill-advised, and not supported.

nopass
Don't pass keyboard/mouse info to stage 2 installer, good for testing keyboard and mouse config screens in stage2 installer during network installs.

noprobe
Do not attempt to detect hw, prompts user instead.

noselinux
Disable SELinux on the installed system.

noshell
Do not put a shell on tty2 during install.
Warning.png
Broken in Fedora 16 and later
The 'noshell' parameter is broken in Fedora releases since Fedora 16. See Bug #807703

nousb
Do not load USB support (helps if install hangs early sometimes).

noverifyssl
Prevents Anaconda from verifying the ssl certificate for all https connections with an exception of the additional kickstart repos (where --noverifyssl can be set per repo).

proxy=[protocol://][username[:password]@]host[:port]
Use the given proxy settings when performing an HTTP/HTTPS/FTP installation.

repo=
This option tells anaconda where to find the packages for installation. This option must point to a valid yum repository (or, for some protocols, a Fedora DVD ISO image). It is analogous to the older method= option, but repo= makes it more clear exactly what is meant. This option may appear only once on the command line. It corresponds to the kickstart command install (whereas kickstart command repo is used for additional repositories). As of Fedora 16, you can (optionally) add a specific .iso file to the path. If no inst.root= or inst.stage2= parameter is passed, this location will also be used as the source for the installer runtime image.
The following forms are accepted for repo=:
  • repo=cdrom:<device>
  • repo=ftp://[user:password@]<host>/<path>
  • repo=http://<host>/<path>
  • repo=hd:<device>:/<path>
Look for ISO images on the hard drive partition given by device (/dev/sda1, for instance). This may not be a partition that will be formatted during installation later. These should be ISO images, not an exploded tree on the hard drive. device can be a device name, LABEL=, or UUID=.
  • repo=hd:LABEL=<label>:/<path>
  • repo=hd:UUID=<uuid>:/<path>
As repo=hd:<device>, but you can specify a partition by label or UUID.
  • repo=nfs[:options]:<server>:/<path>
  • repo=nfsiso[:options]:<server>:/<path>
Will use either an ISO image or a Fedora tree on the NFS volume with the given server and path as an install repository (in all current supported releases, 'nfs' and 'nfsiso' are synonyms; anaconda will check for either an ISO image or an install tree in the specified location whichever of the two you pass). If an 'inst.root' or 'inst.stage2' parameter is passed - as is the case by default when the installer is booted from the DVD or network install images - the mount will first be tried using the NFSv4 protocol, and if this fails, it will be tried using the NFSv3 protocol. There is a known bug in Fedora 19 Beta which prevents NFSv3 mount attempts from succeeding unless the 'nolock' option is specified. If no 'inst.root' or 'inst.stage2' parameter is passed, and so the NFS repository is being used as the installer runtime image source as well as a package source (which will be the case when booting directly from a kernel pair, for e.g., in a PXE installation, or using virt-install), the NFSv3 protocol only will be used, due to a known bug which affects trying to mount the installation root via the NFSv4 protocol.

resolution=<mode>
Run GUI installer in mode specified, '1024x768' for example.

rescue
Run rescue environment.

selinux[=0]
Disables selinux entirely. Defaults to on.

sshd
Starts up sshd during system installation. You can then ssh in while the installation progresses to debug or monitor. Passwords are controlled via the kickstart sshpw command. By default, the root account has a blank password, so if the sshd option is specified, anyone can login as root and have full access to the machine during installation.

stage2=
Specifies a path to a repository containing a stage2 (squashfs.img) file instead of to an installation source. Follows the same syntax as repo=. If this parameter is provided, it takes precedence over all other methods of finding the install.img. Otherwise, anaconda will attempt to find the install.img first on any existing CD, and then from the location given by repo=.
If only stage2= is given without repo=, anaconda will use whatever repos the installed system would have enabled by default for installation. For instance, an install of a Fedora release will attempt to use the Fedora mirrorlist given by /etc/yum.repos.d/fedora.repo from that release.

syslog=<host>[:<port>]
Once installation is up and running, send log messages to the syslog process on <host>, and optionally, on TCP port <port>. Requires the remote syslog process to accept incoming connections.

text
Force text mode install. This will install only base packages for a minimal system and implies that the installed system will boot up in runlevel 3 instead of to the graphical login screen.

traceback
Since Fedora 17. Raise exception in the GUI (for testing purposes). DO NOT USE THIS IF YOU WANT TO INSTALL THE SYSTEM.
Warning.png
Deprecated since Fedora 19.

updates=<url>
Image containing updates over FTP or HTTP. See Anaconda/Updates for more details.
Accepts either updates=<url> or updates=<disk>:<path> where <disk> can be one of sdX, /dev/sdX, LABEL=xxx, UUID=xxx and <path> defaults to /updates.img if missing.

usefbx
Use the framebuffer X driver instead of attempting to use a hardware-specific one.

video=<mode>
Run KMS framebuffer in video mode specified, 1152x864 for example.

virtiolog=<port_name>
Forward logs through the character device at /dev/virtio-ports/<port_name>. See also Anaconda/Logging.

vlan=<vlanname>:<phydevice>
Create vlan network interface. This is dracut option, see dracut documentation for details on syntax. Example: vlan=eth0.171:eth0.
Warning.png
Available in Fedora 19 and later
The vlan option is supported since Fedora 19.

vnc
Enable vnc-based installation. You will need to connect to the machine using a vnc client application. A vnc install implies that the installed system will boot up in runlevel 3 instead of to the graphical login screen. The vnc session will be shared. Consider setting a vnc password.

vncport=<port>
Specify a port for the vnc server to run on. The default is 5901.

vncconnect=<host>[:<port>]
Once installation is up and running, connect to the vnc client named <host>, and optionally use port <port>.

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. If you have specified vncconnect the <password> will not be used unless connection to host is not possible.

xdriver=<driver>
Use <driver> as the X driver to use during installation as well as on the installed system.