anaconda/anaconda-40.22.3.13/docs/boot-options.rst

1098 lines
28 KiB
ReStructuredText
Raw Normal View History

2024-11-14 21:39:56 -08:00
Anaconda Boot Options
=====================
:Authors:
Anaconda Developers <anaconda-devel@lists.fedoraproject.org>
Will Woods <wwoods@redhat.com>
Anne Mulhern <amulhern@redhat.com>
.. |dracutkernel| replace:: dracut.kernel(7)
.. _dracutkernel: http://www.kernel.org/pub/linux/utils/boot/dracut/dracut.html#dracutcmdline7
.. |dracutnet| replace:: the "Network" section of |dracutkernel|_
.. _dracutnet: http://www.kernel.org/pub/linux/utils/boot/dracut/dracut.html#_network
.. |dracutdebug| replace:: dracut "Troubleshooting" guide
.. _dracutdebug: http://www.kernel.org/pub/linux/utils/boot/dracut/dracut.html#_troubleshooting
.. |anacondawiki| replace:: Anaconda wiki
.. _anacondawiki: https://fedoraproject.org/wiki/Anaconda
.. |anacondalogging| replace:: Anaconda wiki logging page
.. _anacondalogging: https://fedoraproject.org/wiki/Anaconda/Logging
These are the boot options that are useful when starting Anaconda. For more
information refer to the appropriate Installation Guide for your release and
to the |anacondawiki|_.
Anaconda bootup is handled by dracut, so most of the kernel arguments handled
by dracut are also valid. See |dracutkernel|_ for details on those options.
Throughout this guide, installer-specific options are prefixed with
``inst`` (e.g. ``inst.ks``).
.. _repo:
Installation Source
-------------------
.. NOTE::
An *installable tree* is a directory structure containing installer
images, packages, and repodata. [#tree]_
Usually this is either a copy of the DVD media (or loopback-mounted DVD
image), or the ``<arch>/os/`` directory on the Fedora mirrors.
.. [#tree] an installable tree must contain a valid `.treeinfo` file
for ``inst.repo`` or ``inst.stage2`` to work.
.. _inst.repo:
inst.repo
^^^^^^^^^
This gives the location of the *Install Source* - that is, the place where the
installer can find its images and packages. It can be specified in a few
different ways:
``inst.repo=cdrom``
Search the system's CDROM drives for installer media. This is the default.
``inst.repo=cdrom:<device>``
Look for installer media in the specified disk device.
``inst.repo=hd:<device>:<path>``
Mount the given disk partition and install from ISO file on the given path.
This installation method requires ISO file, which contains an installable tree.
``inst.repo=[http,https,ftp]://<host>/<path>``
Look for an installable tree at the given URL.
``inst.repo=nfs:[<options>:]<server>:/<path>``
Mount the given NFS server and path. Uses NFS version **3** by default.
You can specify what version of the NFS protocol to use by adding ``nfsvers=X``
to the `options`.
This accepts not just an installable tree directory in the ``<path>`` element,
but you can also specify an ``.iso`` file. That ISO file is then mounted and
used as the installation tree. This is often used for simulating a standard
DVD installation using a remote ``DVD.iso`` image.
.. _diskdev:
.. NOTE::
Disk devices may be specified with any of the following forms:
Kernel Device Name
``/dev/sda1``, ``sdb2``
Filesystem Label
``LABEL=FLASH``, ``LABEL=Fedora``, ``CDLABEL=Fedora\x2023\x20x86_64``
Filesystem UUID
``UUID=8176c7bf-04ff-403a-a832-9557f94e61db``
Non-alphanumeric characters should be escaped with ``\xNN``, where
'NN' is the hexidecimal representation of the character (e.g. ``\x20`` for
the space character (' ').
.. inst.addrepo:
inst.addrepo
^^^^^^^^^^^^
Add additional repository which can be used as another *Installation Source*
next to the main repository (see `inst.repo`_). This option can be used multiple
times during one boot. This can be specified in a few different ways:
``inst.addrepo=REPO_NAME,[http,https,ftp]://<host>/<path>``
Look for the installable tree at the given URL.
``inst.addrepo=REPO_NAME,nfs://<server>:/<path>``
Look for the installable tree at the given nfs path. Note that there is a
colon after the host. Anaconda passes everything after “nfs:// ” directly
to the mount command instead of parsing URLs according to RFC 2224.
``inst.addrepo=REPO_NAME,file://<path>``
Look for the installable tree at the given location in the installation
environment. Beware, to be able to use this variant the repo needs to
be mounted before Anaconda tries to use it (load available software groups).
The main usage for this command is having multiple repositories on one
bootable ISO and install both the main repo and additional repositories from
this ISO. The path to the additional repositories will be then
`/run/install/source/REPO_ISO_PATH`. Another solution can be to mount this repo
directory in the `%pre` section in the kickstart file.
NOTE: The path must be absolute and start with `/` so the final url starts
with `file:///...`.
``inst.addrepo=REPO_NAME,hd:<device>:<path>``
Mount the given `<device>` partition and install from ISO specified by the `<path>`.
If the `<path>` is not specified Anaconda will look for the valid installation ISO
on the `<device>`. This installation method requires ISO with a valid installable tree.
For more detail how to specify `<device>` argument part please see `diskdev`_.
The `REPO_NAME` is name of the repository and it is a required part. The name will be
used in the installation process. These repositories will be used only during the
installation but they **will not** be installed to the installed system.
.. inst.noverifyssl:
inst.noverifyssl
^^^^^^^^^^^^^^^^
Prevents Anaconda from verifying the ssl certificate for all HTTPS connections
with an exception of the additional repositories added by kickstart (where
--noverifyssl can be set per repo). Newly created additional repositories will honor
this option.
.. inst.proxy:
inst.proxy
^^^^^^^^^^
``inst.proxy=PROXY_URL``
Use the given proxy settings when performing an installation from a
HTTP/HTTPS/FTP source. The ``PROXY_URL`` can be specified like this:
``[PROTOCOL://][USERNAME[:PASSWORD]@]HOST[:PORT]``.
.. inst.stage2:
inst.stage2
^^^^^^^^^^^
This specifies the location to fetch only the installer runtime image;
packages will be ignored. Otherwise the same as `inst.repo`_.
.. inst.stage2.all:
inst.stage2.all
^^^^^^^^^^^^^^^
All locations of type http, https or ftp specified with inst.stage2 will
be used sequentially one by one until the image is fetched. Other locations
will be ignored.
In the following example, Anaconda will try to fetch the image at first from
``http://a``, then from ``http://b`` and finally from ``http://c``.
::
inst.stage2=http://a inst.stage2=http://b inst.stage2=http://c inst.stage2.all
Without the boot option ``inst.stage2.all``, Anaconda will try to fetch the
image only from ``http://c``, as usual.
::
inst.stage2=http://a inst.stage2=http://b inst.stage2=http://c
inst.dd
^^^^^^^
This specifies the location for driver rpms. May be specified multiple times.
Locations may be specified using any of the formats allowed for
`inst.repo`_.
inst.multilib
^^^^^^^^^^^^^
This sets dnf's multilib_policy to "all" (as opposed to "best").
.. kickstart:
Kickstart
---------
.. inst.ks:
inst.ks
^^^^^^^
Give the location of a kickstart file to be used to automate the install.
Locations may be specified using any of the formats allowed for `inst.repo`_.
For any format the ``<path>`` component defaults to ``/ks.cfg`` if it is omitted.
For NFS kickstarts, if the ``<path>`` ends in ``/``, ``<ip>-kickstart`` is added.
If ``inst.ks`` is used without a value, the installer will look for
``nfs:<next_server>:/<filename>``
* ``<next_server>`` is the DHCP "next-server" option, or the IP of the DHCP server itself
* ``<filename>`` is the DHCP "filename" option, or ``/kickstart/``, and
if the filename given ends in ``/``, ``<ip>-kickstart`` is added (as above)
For example:
* DHCP server: ``192.168.122.1``
* client address: ``192.168.122.100``
* kickstart file: ``nfs:192.168.122.1:/kickstart/192.168.122.100-kickstart``
.. inst.ks.all:
inst.ks.all
^^^^^^^^^^^
Use all locations of type ``http``, ``https`` or ``ftp`` specified with
multiple ``inst.ks`` sequentially one by one until kickstart file is fetched.
Locations of other types (eg. ``nfs``) will be ignored.
Without this option, only last location specified by ``inst.ks`` is used.
In the following example, Anaconda will try to fetch the kickstart file at
first from ``http://a/a.ks``, then from ``http://b/b.ks`` and finally from
``http://c/c.ks``.
::
inst.ks=http://a/a.ks inst.ks=http://b/b.ks inst.ks=http://c/c.ks inst.ks.all
Without the boot option ``inst.ks.all``, Anaconda will try to fetch the
kickstart file only from ``http://c/c.ks``, as usual.
::
inst.ks=http://a/a.ks inst.ks=http://b/b.ks inst.ks=http://c/c.ks
.. inst.ks.sendmac:
inst.ks.sendmac
^^^^^^^^^^^^^^^
Add headers to outgoing HTTP requests which include the MAC addresses of all
network interfaces. The header is of the form:
* ``X-RHN-Provisioning-MAC-0: eth0 01:23:45:67:89:ab``
This is helpful when using ``inst.ks=http...`` to provision systems.
.. inst.ks.sendsn:
inst.ks.sendsn
^^^^^^^^^^^^^^
Add a header to outgoing HTTP requests which includes the system's serial
number. [#serial]_
The header is of the form:
* ``X-System-Serial-Number: <serial>``
.. [#serial] as read from ``/sys/class/dmi/id/product_serial``
.. inst.ksstrict:
inst.ksstrict
^^^^^^^^^^^^^^
With this option, all warnings from reading the kickstart file will be
treated as errors. They will be printed on the output and the installation
will terminate immediately.
By default, the warnings are printed to logs and the installation
continues.
Network Options
---------------
Initial network setup is handled by dracut. For detailed information consult
|dracutnet|.
The most common dracut network options are covered here, along with some
installer-specific options.
.. ip:
ip
^^
Configure one (or more) network interfaces. You can use multiple ``ip``
arguments to configure multiple interfaces, but if you do you must specify an
interface for every ``ip=`` argument, and you must specify which interface
is the primary boot interface with `bootdev`_.
Accepts a few different forms; the most common are:
.. ip=ibft:
``ip=<dhcp|dhcp6|auto6|ibft>``
Try to bring up every interface using the given autoconf method. Defaults
to ``ip=dhcp`` if network is required by ``inst.repo``, ``inst.ks``, ``inst.updates``,
etc.
``ip=<interface>:<autoconf>``
Bring up only one interface using the given autoconf method, e.g.
``ip=eth0:dhcp``.
``ip=<ip>::<gateway>:<netmask>:<hostname>:<interface>:none``
Bring up the given interface with a static network config, where:
``<ip>``
The client IP address. IPv6 addresses may be specified by putting
them in square brackets, like so: ``[2001:DB8::1]``.
``<gateway>``
The default gateway. IPv6 addresses are accepted here too.
``<netmask>``
The netmask (e.g. ``255.255.255.0``) or prefix (e.g. ``64``).
``<hostname>``
Hostname for the client machine. This component is optional.
``ip=<ip>::<gateway>:<netmask>:<hostname>:<interface>:<autoconf>:<mtu>``
Bring up the given interface with the given autoconf method, but override the
automatically obtained IP/gateway/etc. with the provided values.
Technically all of the items are optional, so if you want to use dhcp but also
set a hostname you can use ``ip=::::<hostname>::dhcp``.
.. nameserver:
nameserver
^^^^^^^^^^
Specify the address of a nameserver to use. May be used multiple times.
.. bootdev:
bootdev
^^^^^^^
Specify which interface is the boot device. Required if multiple ``ip=``
options are used.
.. ifname:
ifname
^^^^^^
``ifname=<interface>:<MAC>``
Assign the given interface name to the network device with the given MAC. May
be used multiple times.
.. NOTE::
Dracut applies ifname option (which might involve renaming the device with
given MAC) in initramfs only if the device is activated in initramfs stage
(based on ip= option). If it is not the case, installer still binds the
current device name to the MAC by adding HWADDR setting to the ifcfg file of
the device.
.. inst.dhcpclass:
inst.dhcpclass
^^^^^^^^^^^^^^
Set the DHCP vendor class identifier [#dhcpd]_. Defaults to ``anaconda-$(uname -srm)``.
.. [#dhcpd] ISC ``dhcpd`` will see this value as "option vendor-class-identifier".
.. inst.waitfornet:
inst.waitfornet
^^^^^^^^^^^^^^^
``inst.waitfornet=<TIMEOUT_IN_SECONDS>``
Wait for network connectivity at the beginning of the second stage of
installation (after switchroot from early initramfs stage when the installer
process is run).
.. inst.net.noautodefault
inst.net.noautodefault
^^^^^^^^^^^^^^^^^^^^^^
Configures NetworkManager so that it does not create default automatic
connections, which are the wired connections created and activated for any
Ethernet device that does not have a connection configured. These connections
are created in installer environment by NetworkManager during its start in post
switch-root stage of installation and are passed also to installed system.
Console / Display Options
-------------------------
.. console:
console
^^^^^^^
This is a kernel option that specifies what device to use as the primary
console. For example, if your console should be on the first serial port, use
``console=ttyS0``.
You can use multiple ``console=`` options; boot messages will be displayed on
all consoles, but anaconda will put its display on the last console listed.
Implies `inst.text`_.
.. inst.lang:
inst.lang
^^^^^^^^^
Set the language to be used during installation. The language specified must
be valid for the ``lang`` kickstart command.
.. inst.geoloc:
inst.geoloc
^^^^^^^^^^^
Configure geolocation usage in Anaconda. Geolocation is used to pre-set
language and time zone.
``inst.geoloc=0``
Disables geolocation.
``inst.geoloc=provider_fedora_geoip``
Use the Fedora GeoIP API (default).
``inst.geoloc=provider_hostip``
Use the Hostip.info GeoIP API.
.. inst.geoloc-use-with-ks
inst.geoloc-use-with-ks
^^^^^^^^^^^^^^^^^^^^^^^
Enable geolocation even during a kickstart installation (both partial and fully automatic).
Otherwise geolocation is only enabled during a fully interactive installation.
.. inst.keymap:
inst.keymap
^^^^^^^^^^^
Set the keyboard layout to use. The layout specified must be valid for use with
the ``keyboard`` kickstart command.
.. inst.cmdline:
inst.cmdline
^^^^^^^^^^^^
Run the installer in command-line mode. This mode does not
allow any interaction; all options must be specified in a kickstart file or
on the command line.
.. inst.graphical:
inst.graphical
^^^^^^^^^^^^^^
Run the installer in graphical mode. This is the default.
.. inst.text:
inst.text
^^^^^^^^^
Run the installer using a limited text-based UI. Unless you're using a
kickstart file this probably isn't a good idea; you should use VNC instead.
.. inst.noninteractive
inst.noninteractive
^^^^^^^^^^^^^^^^^^^
Run the installer in a non-interactive mode. This mode does not allow any
user interaction and can be used with graphical or text mode. With text
mode it behaves the same as the ``inst.cmdline`` mode.
.. inst.resolution:
inst.resolution
^^^^^^^^^^^^^^^
Specify screen size for the installer. Use format nxm, where n is the
number of horizontal pixels, m the number of vertical pixels. The lowest
supported resolution is 800x600.
.. inst.rdp:
inst.rdp
^^^^^^^^
Enable Remote Desktop Protocol-controlled installation. You will need to connect to
the machine using an RDP client application. An RDP install implies that the installed
system will boot up in in multiuser.target instead of to the graphical login screen.
Multiple RDP clients can connect.
When using ``inst.rdp``, you also need to set RDP username and password using the
``inst.rdp.username`` and ``inst.rdp.password`` boot options.
.. inst.rdp.username:
inst.rdp.username
^^^^^^^^^^^^^^^^^
Set username for the RDP session. To enable RDP access, also use the
``inst.rdp`` and ``inst.rdp.password`` boot options.
.. inst.rdp.password:
inst.rdp.password
^^^^^^^^^^^^^^^^^
Set password for the RDP session. To enable RDP access, also use the
``inst.rdp`` and ``inst.rdp.username`` boot options.
.. inst.vnc:
inst.vnc
^^^^^^^^
Run the installer GUI in a VNC session. You will need a VNC client application
to interact with the installer. VNC sharing is enabled, so multiple clients
may connect.
A system installed with VNC will start in text mode (runlevel 3).
This option is deprecated and will be removed in future releases.
Use ``inst.rdp`` instead.
.. inst.vncpassword:
inst.vncpassword
^^^^^^^^^^^^^^^^
Set a password on the VNC server used by the installer.
This option is deprecated and will be removed in future releases.
Use ``inst.rdp.password`` and related boot options instead.
.. inst.vncconnect:
inst.vncconnect
^^^^^^^^^^^^^^^
``inst.vncconnect=<host>[:<port>]``
Once the install starts, connect to a listening VNC client at the given host.
Default port is 5900.
Use with ``vncviewer -listen``.
This option is deprecated and will be removed in future releases.
.. inst.xdriver:
inst.xdriver
^^^^^^^^^^^^
Specify the X driver that should be used during installation and on the
installed system.
This boot options is deprecated and has no effect.
.. inst.usefbx
inst.usefbx
^^^^^^^^^^^
Use the framebuffer X driver (``fbdev``) rather than a hardware-specific driver.
Equivalent to ``inst.xdriver=fbdev``.
This boot options is deprecated and has no effect.
.. inst.xtimeout:
inst.xtimeout
^^^^^^^^^^^^^
Specify the timeout in seconds for starting X server.
.. inst.sshd:
inst.sshd
^^^^^^^^^
Start up ``sshd`` during system installation. You can then ssh in while the
installation progresses to debug or monitor its progress.
.. CAUTION::
The ``root`` account has no password by default. You can set one using
the ``sshpw`` kickstart command.
Debugging and Troubleshooting
-----------------------------
.. inst.debug:
inst.debug
^^^^^^^^^^
Run the installer in the debugging mode.
.. inst.rescue:
inst.rescue
^^^^^^^^^^^
Run the rescue environment. This is useful for trying to diagnose and fix
broken systems.
.. inst.updates:
inst.updates
^^^^^^^^^^^^
Give the location of an ``updates.img`` to be applied to the installer runtime.
Locations may be specified using any of the formats allowed for ``inst.repo``.
For any format the ``<path>`` component defaults to ``/updates.img`` if it is
omitted.
.. inst.nokill:
inst.nokill
^^^^^^^^^^^
A debugging option that prevents anaconda from and rebooting when a fatal error
occurs or at the end of the installation process.
.. inst.noshell:
inst.noshell
^^^^^^^^^^^^
Do not put a shell on tty2 during install.
.. inst.notmux:
inst.notmux
^^^^^^^^^^^
Do not use tmux during install. This allows for output to get generated without
terminal control characters and is really meant for non-interactive uses.
.. inst.syslog:
inst.syslog
^^^^^^^^^^^
``inst.syslog=<host>[:<port>]``
Once installation is running, send log messages to the syslog process on
the given host. The default port is 514 (UDP).
Requires the remote syslog process to accept incoming connections.
.. inst.virtiolog:
inst.virtiolog
^^^^^^^^^^^^^^
Forward logs through the named virtio port (a character device at
``/dev/virtio-ports/<name>``).
If not provided, a port named ``org.fedoraproject.anaconda.log.0``
will be used by default, if found.
See the |anacondalogging|_ for more info on setting up logging via virtio.
.. inst.wait_for_disks:
inst.wait_for_disks
^^^^^^^^^^^^^^^^^^^
Because disks can take some time to appear, an additional delay of 5 seconds
has been added. This can be overridden by boot argument
`inst.wait_for_disks=<value>` to let dracut wait up to <value> additional
seconds (0 turns the feature off, causing dracut to only wait up to 500ms).
Alternatively, if the `OEMDRV` device is known to be present but too slow to be
autodetected, the user can boot with an argument like `inst.dd=hd:LABEL=OEMDRV`
to indicate that dracut should expect an `OEMDRV` device and not start the
installer until it appears.
This functionality could be used to load kickstart and driverdisks.
Boot loader options
-------------------
.. inst.extlinux:
inst.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.
.. inst.sdboot:
inst.sdboot
^^^^^^^^^^^^^
Use systemd-boot 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.
Note that this works only for package-based installations, where the bootloader can be chosen at
install time. For live images, this can work only if the live image was built with systemd-boot
instead of grub.
.. inst.leavebootorder:
inst.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.
Storage options
---------------
.. inst.disklabel:
inst.disklabel
^^^^^^^^^^^^^^
Prefer creation of the specified disk label type. Specify ``gpt`` to prefer creation of GPT disk
labels. Specify ``mbr`` to prefer creation of MBR disk labels if supported.
.. inst.gpt:
inst.gpt
^^^^^^^^
Prefer creation of GPT disk labels. This option is deprecated and will be removed in future
releases. Use ``inst.disklabel=gpt`` instead.
Other options
-------------
.. inst.selinux:
inst.selinux
^^^^^^^^^^^^
Enable SELinux usage in the installed system (default). Note that when used as a
boot option, "selinux" and "inst.selinux" are not the same. The "selinux" option
is picked up by both the kernel and Anaconda, but "inst.selinux" is processed
only by Anaconda. So when "selinux=0" is used, SELinux will be disabled both in
the installation environment and in the installed system, but when
"inst.selinux=0" is used SELinux will only be disabled in the installation environment.
Also note that while SELinux is running in the installation environment by
default, it is running in permissive mode so disabling it there does not make
much sense.
.. inst.nosave
inst.nosave
^^^^^^^^^^^
Controls what installation results should not be saved to the installed system,
valid values are: "input_ks", "output_ks", "all_ks", "logs" and "all".
``input_ks``
Disables saving of the input kickstart (if any).
``output_ks``
Disables saving of the output kickstart generated by Anaconda.
``all_ks``
Disables saving of both input and output kickstarts.
``logs``
Disables saving of all installation logs.
``all``
Disables saving of all kickstarts and all logs.
Multiple values can be combined as a comma separated list, for example: ``input_ks,logs``
.. NOTE::
The nosave option is meant for excluding files from the installed system that *can't*
be removed by a kickstart %post script, such as logs and input/output kickstarts.
.. inst.nonibftiscsiboot
inst.nonibftiscsiboot
^^^^^^^^^^^^^^^^^^^^^
Allows to place boot loader on iSCSI devices which were not configured in iBFT.
Profile options
^^^^^^^^^^^^^^^
Use the ``inst.profile`` option to specify a configuration profile. The installer will be
customized based on configuration files from ``/etc/anaconda/profile.d`` that are specific
for this profile.
.. inst.profile:
inst.profile
++++++++++++
Specify a profile id of a configuration profile. The id should match the ``profile_id`` option
of a configuration file in ``/etc/anaconda/profile.d``.
For example: ``inst.profile=fedora-server``
Third-party options
^^^^^^^^^^^^^^^^^^^
Since Fedora 19 the Anaconda installer supports third-party extensions called
*addons*. The *addons* can support their own set of boot options which should be
documented in their documentation or submitted here.
.. inst.kdump_addon:
inst.kdump_addon
++++++++++++++++
``inst.kdump_addon=on/off``
Enable kdump anaconda addon to setup the kdump service.
Deprecated Options
------------------
These options should still be accepted by the installer, but they are
deprecated and may be removed soon.
.. method:
method
^^^^^^
This is an alias for `inst.repo`_.
.. dns:
dns
^^^
Use `nameserver`_ instead. Note that ``nameserver`` does not
accept comma-separated lists; use multiple ``nameserver`` options instead.
.. netmask:
.. gateway:
.. hostname:
netmask, gateway, hostname
^^^^^^^^^^^^^^^^^^^^^^^^^^
These can be provided as part of the `ip`_ option.
ip=bootif
^^^^^^^^^
A PXE-supplied BOOTIF option will be used automatically, so there's no need
.. ksdevice:
ksdevice
^^^^^^^^
*Not present*
The first device with a usable link is used
``ksdevice=link``
Ignored (this is the same as the default behavior)
``ksdevice=bootif``
Ignored (this is the default if ``BOOTIF=`` is present)
``ksdevice=ibft``
Replaced with ``ip=ibft``. See `ip`_
``ksdevice=<MAC>``
Replaced with ``BOOTIF=${MAC/:/-}``
``ksdevice=<DEV>``
Replaced with `bootdev`_
Removed Options
---------------
These options are obsolete and have been removed.
.. askmethod:
.. asknetwork:
askmethod, asknetwork
^^^^^^^^^^^^^^^^^^^^^
Anaconda's initramfs is now is completely non-interactive, so these have been
removed.
Instead, use `inst.repo`_ or specify appropriate `Network Options`_.
.. serial:
.. blacklist:
.. nofirewire:
blacklist, nofirewire
^^^^^^^^^^^^^^^^^^^^^
``modprobe`` handles adding kernel modules to a denylist on its own; try
``modprobe.blacklist=<mod1>,<mod2>...``
You can add the firewire module to a denylist with ``modprobe.blacklist=firewire_ohci``.
serial
^^^^^^
This option was never intended for public use; it was supposed to be used to
force anaconda to use ``/dev/ttyS0`` as its console when testing it on a live
machine.
Use ``console=ttyS0`` or similar instead. See `console`_ for details.
.. updates:
updates
^^^^^^^
Use `inst.updates`_ instead.
.. essid:
.. wepkey:
.. wpakey:
essid, wepkey, wpakey
^^^^^^^^^^^^^^^^^^^^^
Dracut doesn't support wireless networking, so these don't do anything.
.. ethtool:
ethtool
^^^^^^^
Who needs to force half-duplex 10-base-T anymore?
.. gdb:
gdb
^^^
This was used to debug ``loader``, so it has been removed. There are plenty of
options for debugging dracut-based initramfs - see the |dracutdebug|.
.. inst.loglevel:
inst.loglevel
^^^^^^^^^^^^^
The log level is always set to ``debug``.
.. inst.mediacheck:
inst.mediacheck
^^^^^^^^^^^^^^^
Use the dracut option rd.live.check instead.
ks=floppy
^^^^^^^^^
We no longer support floppy drives. Try ``inst.ks=hd:<device>`` instead.
.. inst.display:
display
^^^^^^^
For remote display of the UI, use `inst.vnc`_.
.. utf8:
utf8
^^^^
All this option actually did was set ``TERM=vt100``. The default ``TERM`` setting
works fine these days, so this was no longer necessary.
.. noipv6:
noipv6
^^^^^^
ipv6 is built into the kernel and can't be removed by anaconda.
You can disable ipv6 with ``ipv6.disable=1``. This setting will be carried onto
the installed system.
.. upgradeany:
upgradeany
^^^^^^^^^^
Anaconda doesn't handle upgrades anymore.
.. inst.repo for installable tree:
inst.repo=hd:<device>:<path> for installable tree
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Anaconda can't use this option with installable tree but only with an ISO file.
.. inst.zram:
inst.zram
^^^^^^^^^
Anaconda doesn't run ``zram.service`` anymore. See ``zram-generator`` for more information.
.. inst.singlelang:
inst.singlelang
^^^^^^^^^^^^^^^
Anaconda does not support single language mode anymore.
repo=nfsiso:...
^^^^^^^^^^^^^^^
Anaconda no longer needs explicit specification that an NFS location is an ISO image.
The difference between an installable tree and a dir with an ``.iso`` file is now
automatically detected, so this is the same as ``inst.repo=nfs:``...
.. inst.nodmraid:
inst.nodmraid
^^^^^^^^^^^^^
Anaconda no longer supports dmraid, BIOS/Firmware RAID devices are now handled by
``mdadm``.
.. inst.nompath:
inst.nompath
^^^^^^^^^^^^
This was used to disable support for multipath devices. Anaconda did not
support proper multipath disabling for a long time, the only thing this did
was disable parts of GUI.
.. inst.product:
inst.product
^^^^^^^^^^^^
Use the ``inst.profile`` option instead.
.. inst.variant:
inst.variant
^^^^^^^^^^^^
Use the ``inst.profile`` option instead.