From Fedora Project Wiki

m (Remove last references to allowwireless)
No edit summary
 
(81 intermediate revisions by 17 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
{{autolang|base=yes}}


{{anchor|askmethod}}
Anaconda boot options are [https://anaconda-installer.readthedocs.io/en/latest/boot-options.html described in the official Anaconda documentation on Read the Docs].
;[[#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.


{{anchor|asknetwork}}
The page is generated from the [https://github.com/rhinstaller/anaconda/blob/master/docs/boot-options.rst boot-options.rst] file in the Anaconda source code repository. So if you spot any mistakes or want to improve the boot option documentation just open a pull request for this file.
;[[#asknetwork|<code>asknetwork</code>]]
: Prompt for network configuration in the first stage of installation regardless of installation method.
 
{{anchor|autostep}}
;[[#autostep|<code>autostep</code>]]
: Advance to the next screen automatically.  This is mostly useful for debugging.
 
{{anchor|blacklist}}
;[[#blacklist|<code>blacklist=<module></code>]]
: Do not automatically load module <module>, even if the hardware exists on the system.
 
{{anchor|cmdline}}
;[[#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.
 
{{anchor|dd}}
;[[#dd|<code>dd</code>]]
: Use a driver disk.
 
{{anchor|driverdisk}}
;[[#driverdisk|<code>driverdisk</code>]]
: [[#dd|See ''dd'']]
 
{{anchor|debug}}
;[[#debug|<code>debug=1</code>]]
: Add a debug button to the UI that allows dropping into a python debugger.
 
{{anchor|dhcpclass}}
;[[#dhcpclass|<code>dhcpclass=<class></code>]]
: Sends a custom DHCP vendor class identifier.  ISC's dhcpcd can inspect this value using "option vendor-class-identifier".
 
{{anchor|dhcptimeout}}
;[[#dhcptimeout|<code>dhcptimeout=<sec></code>]]
: Stop attempting to get a DHCP lease after <sec> seconds.
 
{{anchor|display}}
;[[#display|<code>display=<DISPLAY></code>]]
: Sets the $DISPLAY environment variable.
 
{{anchor|dns}}
;[[#dns|<code>dns=<dns></code>]]
: Comma separated list of nameservers to use for a network installation.
 
{{anchor|essid}}
;[[#essid|<code>essid=<essid></code>]]
: Connect to the wireless network given by <essid> for a network installation.
 
{{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|gateway}}
;[[#gateway|<code>gateway=<gw></code>]]
: Gateway to use for a network installation.
 
{{anchor|gdb}}
;[[#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|graphical}}
;[[#graphical|<code>graphical</code>]]
: 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).
 
{{anchor|headless}}
;[[#headless|<code>headless</code>]]
: Specify that the machine being installed onto does not have any display hardware, and that anaconda should not probe for it.
 
{{anchor|ip}}
;[[#ip|<code>ip=<ip></code>]]
: IP to use for a network installation, use 'dhcp' for DHCP.
 
{{anchor|ipv6}}
;[[#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.
 
{{anchor|keymap}}
;[[#keymap|<code>keymap=<keymap></code>]]
: Keyboard layout to use.  Valid values are those which can be used for the <code>keyboard</code> kickstart command.
 
{{anchor|ks}}
;[[#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:
:*<code>ks=cdrom:<device></code>
:*<code>ks=file:<path></code>  (path = 'fd0/ks.cfg', for example)
:*<code><nowiki>ks=ftp://<path></nowiki></code>
:*<code>ks=hd:<dev>:<path></code>  (dev = 'hda1', for example)
:*<code><nowiki>ks=http://<host>/<path></nowiki></code>
:*<code>ks=nfs[:options]:<server>:<path></code>
:*<code>ks=bd:<biosdev>:<path></code>  (biosdev = '80p1', for example, note this does not work for BIOS RAID sets)
 
{{anchor|ksdevice}}
;[[#ksdevice|<code>ksdevice</code>]]
: 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
 
{{anchor|kssendmac}}
;[[#kssendmac|<code>kssendmac</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".
 
{{anchor|kssendsn}}
;[[#kssendsn|<code>kssendsn</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".
 
{{anchor|lang}}
;[[#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.
 
{{anchor|linksleep}}
;[[#linksleep|<code>linksleep=<delay></code>]]
: Check the network device for a link every second for <delay> seconds.
 
{{anchor|loglevel}}
;[[#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.
 
{{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}}
;[[#mediacheck|<code>mediacheck</code>]]
: Activates loader code to give user option of testing integrity of install source (if an ISO-based method).
 
{{anchor|method}}
;[[#method|<code>method=</code>]]
: 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.
 
{{anchor|mtu}}
;[[#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.
 
{{anchor|netmask}}
;[[#netmask|<code>netmask=<nm></code>]]
: Netmask to use for a network installation.
 
{{anchor|nicdelay}}
;[[#nicdelay|<code>nicdelay=<sec></code>]]
: Sleep for <sec> seconds before trying again to bring up the network.
 
{{anchor|nodmraid}}
;[[#nodmraid|<code>nodmraid</code>]]
: Disable support for dmraid.
 
{{anchor|nofirewire}}
;[[#nofirewire|<code>nofirewire</code>]]
: Do not load support for firewire devices.
 
{{anchor|noipv4}}
;[[#noipv4|<code>noipv4</code>]]
: Disable IPv4 networking during installation.
 
{{anchor|noipv6}}
;[[#noipv6|<code>noipv6</code>]]
: Disable IPv6 networking during installation.
 
{{anchor|nokill}}
;[[#nokill|<code>nokill</code>]]
: A debugging option that prevents anaconda from terminating all running programs when a fatal error occurs.
 
{{anchor|nomount}}
;[[#nomount|<code>nomount</code>]]
: Don't automatically mount any installed Linux partitions in rescue mode.
 
{{anchor|nompath}}
;[[#nompath|<code>nompath</code>]]
: Disable support for multipath devices.
 
{{anchor|nopass}}
;[[#nopass|<code>nopass</code>]]
: Don't pass keyboard/mouse info to stage 2 installer, good for testing keyboard and mouse config screens in stage2 installer during network installs.
 
{{anchor|noprobe}}
;[[#noprobe|<code>noprobe</code>]]
: Do not attempt to detect hw, prompts user instead.
 
{{anchor|noselinux}}
;[[#noselinux|<code>noselinux</code>]]
: Disable SELinux on the installed system.
 
{{anchor|noshell}}
;[[#noshell|<code>noshell</code>]]
: Do not put a shell on tty2 during install.
 
{{anchor|nousb}}
;[[#nousb|<code>nousb</code>]]
: 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}}
;[[#proxy|<code>proxy=[protocol://][username[:password]@]host[:port]</code>]]
: Use the given proxy settings when performing an HTTP/HTTPS/FTP installation.
 
{{anchor|repo}}
;[[#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.
 
: The following forms are accepted for repo=:
:* <code>repo=cdrom:<device></code>
:* <code>repo=ftp://[user:password@]<host>/<path></code>
:* <code><nowiki>repo=http://<host>/<path></nowiki></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=.
:* <code>repo=nfs[: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.
 
{{anchor|rescue}}
;[[#rescue|<code>rescue</code>]]
: Run rescue environment.
 
{{anchor|resolution}}
;[[#resolution|<code>resolution=<mode></code>]]
: Run installer in mode specified, '1024x768' for example.
 
{{anchor|selinux[}}
;[[#selinux|<code>selinux[=0]</code>]]
: Disables selinux entirely.  Defaults to on.
 
{{anchor|serial}}
;[[#serial|<code>serial</code>]]
: Turns on serial console support.
 
{{anchor|sshd}}
;[[#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.
 
{{anchor|syslog}}
;[[#syslog|<code>syslog=<host>[:<port>] </code>]]
: 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.
 
{{anchor|text}}
;[[#text|<code>text</code>]]
: 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}}
;[[#updates|<code>updates</code>]]
: Prompt for removable media containing updates (bug fixes).
 
{{anchor|updates}}
;[[#updates|<code>updates=<url></code>]]
: Image containing updates over FTP or HTTP.
 
{{anchor|upgradeany}}
;[[#upgradeany|<code>upgradeany</code>]]
: Don't require an /etc/redhat-release that matches the expected syntax to upgrade.
 
{{anchor|usefbx}}
;[[#usefbx|<code>usefbx</code>]]
: Use the framebuffer X driver instead of attempting to use a hardware-specific one.
 
{{anchor|utf8}}
;[[#utf8|<code>utf8</code>]]
: Set the TERM variable to vt100.
 
{{anchor|virtiolog}}
;[[#virtiolog|<code>virtiolog=<port_name></code>]]
: Forward logs through the character device at /dev/virtio-ports/<port_name>. See also [[Anaconda/Logging]].
 
{{anchor|vnc}}
;[[#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.
 
{{anchor|vncconnect}}
;[[#vncconnect|<code>vncconnect=<host>[:<port>] </code>]]
: Once installation is up and running, connect to the vnc client named <host>, and optionally use port <port>.
 
{{anchor|vncpassword}}
;[[#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.
 
{{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>.
 
{{anchor|xdriver}}
;[[#xdriver|<code>xdriver=<driver></code>]]
: Use <driver> as the X driver to use during installation as well as on the installed system.


----
[[Category:Anaconda]]
[[Category:Anaconda]]

Latest revision as of 12:31, 30 August 2017

Anaconda boot options are described in the official Anaconda documentation on Read the Docs.

The page is generated from the boot-options.rst file in the Anaconda source code repository. So if you spot any mistakes or want to improve the boot option documentation just open a pull request for this file.