引导选项参考

本部分包含有关某些引导选项的信息，这些选项可用于修改安装程序的默认行为。有关 Kickstart 和高级引导选项，请参阅高级安装文档的参考部分。

安装源引导选项

本部分包含有关各种安装源引导选项的信息。

inst.repo=

inst.repo= 引导选项指定安装源，即提供软件包仓库的位置和描述这些仓库的有效 .treeinfo 文件。例如：inst.repo=cdrom。 inst.repo= 选项的目标必须是以下安装介质之一：

  • 安装树，其目录结构包含该安装程序映像、软件包和仓库数据以及可用的`.treeinfo` 文件。

  • DVD（系统 DVD 驱动器中的物理磁盘）。

  • 完整 Circle Linux 8 安装 DVD 的ISO映像，保存在硬盘中或者安装系统可以访问的网络位置。

    您可以使用 inst.repo= 引导选项使用不同的格式配置不同的安装方法。下表包含 inst.repo= 引导选项语法的详细信息：

    表 1. inst.repo= 安装源引导选项
    源类型 引导选项格式 源格式

    CD/DVD 驱动器

    inst.repo=cdrom[:device]

    将DVD安装为物理磁盘。 [1]

    安装树

    inst.repo=hd:device:/path

    安装DVD的映像文件或安装树，它是安装 DVD 上目录和文件的完整副本。

    NFS 服务器

    inst.repo=nfs:[options:]server:/path

    安装 DVD 的映像文件。 [2]

    HTTP 服务器

    inst.repo=http://host/path

    安装树，它是安装 DVD 上目录和文件的完整副本。

    HTTPS 服务器

    inst.repo=https://host/path

    FTP 服务器

    inst.repo=ftp://username:password@host/path

    HMC

    inst.repo=hmc

    您可以使用以下格式设置磁盘设备名称：

  • 内核设备名称，例如： /dev/sda1 or sdb2

  • 文件系统标签，例如： LABEL=Flash 或 LABEL=CENTOS8

  • 文件系统 UUID，例如： UUID=8176c7bf-04ff-403a-a832-9557f94e61db

    非字母数字字符必须以 \xNN 形式显示，其中 NN 是使用十六进制代表的字符。例如：\x20 为空格`(" ")`。

inst.addrepo=

使用 inst.addrepo= 引导选项添加一个附加的仓库，该仓库可以与主仓库(inst.repo=)一起用作另一个安装源。您可以在一次引导期间多次使用 inst.addrepo= 引导选项。下表包含 inst.addrepo= 引导选项语法的详细信息。

REPO_NAME 是仓库的名称，在安装过程中是必需的。这些仓库仅在安装过程中使用。它们未安装在已安装的系统上。
表 2. inst.addrepo 安装源引导选项
安装源 引导选项格式 附加信息

URL 上的可安装树

inst.addrepo=REPO_NAME,[http,https,ftp]://<host>/<path>

在给定的URL中查找可安装树。

NFS 路径上的可安装树

inst.addrepo=REPO_NAME,nfs://<server>:/<path>

在给定的 NFS 路径中查找可安装树。主机后面需要冒号。安装程序将 nfs:// 之后的所有内容直接传递给 mount 命令，而不是根据 RFC 2224 解析 URL。

安装环境中的可安装树

inst.addrepo=REPO_NAME,file://<path>

在安装环境中的给定位置查找可安装树。要使用此选项，在安装程序尝试加载可用软件组之前，必须先挂载仓库。此选项的好处是，您可以在一个可引导的 ISO 上拥有多个仓库，并且可以从 ISO 安装主仓库和附加仓库。附加仓库的路径是 /run/install/source/REPO_ISO_PATH。另外，您可以在 Kickstart 文件的 %pre 部分中挂载仓库目录。路径必须是绝对路径并以 / 开头，例如 inst.addrepo=REPO_NAME,file:///<path>

硬盘驱动器

inst.addrepo=REPO_NAME,hd:<device>:<path>

挂载给定的 <device> 分区，并从 <path> 指定的 ISO 安装。如果未指定 <path>，则安装程序将在 <device> 上查找有效的安装 ISO。此安装方法需要具有有效可安装树的 ISO。
inst.noverifyssl=

noverifyssl= 引导选项阻止安装程序验证除附加 Kickstart 仓库之外的所有 HTTPS 连接的 SSL 证书，其中---noverifyssl 可以针对每个仓库进行设置。

inst.stage2=

使用 inst.stage2= 引导选项指定安装程序运行时映像的位置。此选项需要指向包含有效 .treeinfo 文件的目录的路径。运行时映像的位置从 .treeinfo 文件中读取。如果 .treeinfo 文件不可用，安装程序会尝试从 LiveOS/squashfs.img 加载映像。

如果未指定 inst.stage2 选项，安装程序将尝试使用 inst.repo 选项指定的位置。

您应该仅为 PXE 引导指定此选项。安装 DVD 和 Boot ISO 已包含正确的 inst.stage2 选项，可从其自身引导安装程序。

默认情况下， inst.stage2= 引导选项在安装介质上使用，并设置为特定标签，例如`inst.stage2=hd:LABEL=Circle Linux-8.4-BaseOS-x86_64`。如果您修改包含运行时映像的文件系统的默认标签，或者使用自定义过程来引导安装系统，则必须验证 inst.stage2= 选项设置为正确的值。
inst.stage2.all

inst.stage2.all 引导选项用于指定多个 HTTP、HTTPS 或 FTP 源。您可以将 inst.stage2= 引导选项与 inst.stage2.all 选项一起使用多次，以从源顺序获取映像，直到成功为止。 例如：

inst.stage2.all
inst.stage2=http://hostname1/path_to_install_tree/
inst.stage2=http://hostname2/path_to_install_tree/
inst.stage2=http://hostname3/path_to_install_tree/
inst.dd=

inst.dd= 引导选项用于在安装过程中执行驱动程序更新。有关在安装过程中如何更新驱动程序的信息，请参阅高级安装文档。

inst.repo=hmc

从 DVD1 引导时，安装程序会提示您输入其他内核参数。要将 DVD 设置为安装源，请将 inst.repo=hmc 附加到内核参数中。然后，安装程序将启用 SE 和 HMC 文件访问，从 DVD 中获取 stage2 的映像，并提供对 DVD 上软件包的访问以进行软件选择。此选项消除了对外部网络设置的需求，并扩展了安装选项。

inst.proxy

当从 HTTP、HTTPS、FTP 源执行安装时，使用 inst.proxy 引导选项。例如：

[PROTOCOL://][USERNAME[:PASSWORD]@]HOST[:PORT]
inst.nosave

使用 inst.nosave 选项控制是否将安装日志和相关文件保存到安装的系统中，例如输入 input_ks、 output_ks、all_ks、logs 和 all。多个值可以组合为逗号分隔的列表，例如：input_ks,logs。

inst.nosave 选项用于从已安装的系统中排除 Kickstart %post 脚本无法删除的文件，例如日志和输入/输出 Kickstart 结果。
表 3. inst.nosave 引导选项
选项 描述

input_ks

禁用保存输入 Kickstart 结果的功能。

output_ks

禁用保存由安装程序生成的输出 Kickstart 结果的功能。

all_ks

禁用保存输入和输出 Kickstart 结果的功能。

logs

禁用保存所有安装日志的功能。

all

禁用保存所有 Kickstart 结果和所有日志的功能。
inst.multilib

使用 inst.multilib 引导选项将 DNF 的 multilib_policy 设置为 all，而不是 best。

memcheck

memcheck 引导选项执行检查以验证系统是否有足够的 RAM 来完成安装。如果没有足够的 RAM，则会停止安装过程。系统检查是粗略的，安装期间的内存使用情况取决于软件包的选择，用户界面（例如图形或文本）以及其他参数。

nomemcheck

nomemcheck 引导选项不执行检查以验证系统是否有足够的 RAM 来完成安装。不支持使用小于建议的最小内存量执行安装的任何尝试，这可能会导致安装过程失败。

网络引导选项

本部分包含有关常用网络引导选项的信息。

初始网络初始化由 dracut 处理。有关完整列表，请参阅 dracut.cmdline(7) 手册页。
ip=

使用 ip= 引导选项配置一个或多个网络接口。要配置多个接口，可以多次使用 ip 选项，每个接口一次；要执行此操作，必须使用 rd.neednet=1 选项，并且必须使用 bootdev 选项指定主引导接口。或者，您可以使用一次 ip 选项，然后使用 Kickstart 设置更多接口。此选项接受几种不同的格式。下表包含有关最常见选项的信息。

在下表中：

  • ip 参数指定客户端IP地址。您可以在方括号中指定 IPv6 地址，例如 [2001:DB8::1]。

  • gateway 参数是默认网关。也接受IPv6地址。

  • netmask 参数是要使用的网络掩码。它可以是完整的网络掩码（例如255.255.255.0）或前缀（例如 64）。

  • hostname 参数是客户端系统的主机名。此参数是可选的。
表 4. 网络接口配置引导选项格式
配置方法 引导选项格式

自动配置任何接口

ip=method

自动配置特定接口

ip=interface:method

静态配置

ip=ip::gateway:netmask:hostname:interface:none

使用覆盖自动配置特定接口

ip=ip::gateway:netmask:hostname:interface:method:mtu

使用覆盖自动配置特定接口的 method 使用自动配置的特定 method（例如dhcp）调出接口，但是覆盖自动获取的 IP 地址、网关、网络掩码、主机名或其他指定参数。所有参数都是可选的，因此仅指定要覆盖的参数。

method 参数可以是以下任意一个：

表 5. 自动接口配置方法
自动配置 method 值

DHCP

dhcp

IPv6 DHCP

dhcp6

IPv6 自动配置

auto6

iSCSI 引导固件表 (iBFT)

ibft

  • 如果您使用需要网络访问权限的引导选项（例如 inst.ks=http://host:/path），而未指定 ip 选项，则安装程序将使用 ip=dhcp。

  • 要自动连接到 iSCSI 目标，必须激活网络设备才能访问该目标。建议的激活网络的方法是使用 ip=ibft 引导选项。
nameserver=

nameserver= 选项指定名称服务器的地址。您可以多次使用此选项。

bootdev=

bootdev= 选项指定引导接口。如果您使用多个 ip 选项，则此选项是必需的。

ifname=

ifname= 选项将接口名称分配给具有给定 MAC 地址的网络设备。您可以多次使用此选项。语法为 ifname=interface:MAC。例如：

ifname=eth0:01:23:45:67:89:ab

ifname= 选项是在安装过程中设置自定义网络接口名称的唯一受支持的方法。
inst.dhcpclass=

inst.dhcpclass= 选项指定 DHCP 供应商类别标识符。dhcpd 服务将该值视为供应商类别标识符。默认值为 anaconda-$(uname -srm)。

inst.waitfornet=

使用 inst.waitfornet=SECONDS 引导选项会使安装系统在安装前等待网络连接。SECONDS 参数中给出的值指定在超时并继续安装过程(即使网络连接不存在)之前等待网络连接的最长时间。

控制台引导选项

本部分包含有关配置控制台、显示器和键盘的引导选项的信息。

console=

使用 console= 选项指定要用作主控制台的设备。例如，要在第一个串行端口上使用控制台，请使用 console=ttyS0。将此选项与 inst.text 选项一起使用。 您可以多次使用 console= 选项。如果这样做，则引导消息将显示在所有指定的控制台上，但安装程序仅使用最后一个。例如，如果指定 console=ttyS0 console=ttyS1，则安装程序将使用 ttyS1。

inst.lang=

使用 inst.lang= 选项设置安装期间要使用的语言。locale -a | grep _ 或 localectl list-locales | grep _ 选项返回区域设置列表。

inst.singlelang

使用 inst.singlelang 选项以单一语言模式安装，这将导致安装语言和语言支持配置没有可用的交互式选项。如果使用 inst.lang 引导选项或 lang Kickstart 命令指定了一种语言，则将使用该语言。如果未指定语言，则安装程序默认为 en_US.UTF-8。

inst.geoloc=

使用 inst.geoloc= 选项在安装程序中配置地理位置使用。地理位置用于预设语言和时区，并使用以下语法： inst.geoloc=value。value 可以是以下任何参数：

表 6. inst.geoloc 引导选项的值
值 引导选项格式

禁用地理位置

inst.geoloc=0

使用 Fedora GeoIP API

inst.geoloc=provider_fedora_geoip

使用 Hostip.info GeoIP API

inst.geoloc=provider_hostip

如果未指定 inst.geoloc= 选项，则安装程序将使用 provider_fedora_geoip。

inst.keymap=

使用 inst.keymap= 选项可以指定要用于安装的键盘布局。

inst.cmdline

使用 inst.cmdline 选项强制安装程序在命令行模式下运行。此模式不允许任何交互，并且您必须在 Kickstart 文件或命令行中指定所有选项。

inst.graphical

使用 inst.graphical 选项可以强制安装程序以图形方式运行。此模式是默认模式。

inst.text

使用 inst.text 选项强制安装程序以文本模式而不是图形模式运行。

inst.noninteractive

使用 inst.noninteractive 引导选项以非交互方式运行安装程序。在非交互模式下不允许用户交互，并且 inst.noninteractive 可以与图形或文本安装一起使用。在文本模式下使用 inst.noninteractive 选项时，其行为与 inst.cmdline 选项相同。

inst.resolution=

使用 inst.resolution= 选项在图形模式下指定屏幕分辨率。格式为 NxM，其中 N 是屏幕宽度， M 是屏幕高度（以像素为单位）。支持的最低分辨率为 1024x768。

inst.vnc=

使用 inst.vnc= 选项运行使用 VNC 的图形安装。您必须使用 VNC 客户端应用程序与安装程序交互。启用 VNC 共享后，多个客户端可以连接。使用 VNC 安装的系统以文本模式启动。

inst.vncpassword=

使用 inst.vncpassword= 选项在安装程序使用的 VNC 服务器上设置密码。

inst.vncconnect=

使用 inst.vncconnect= 选项连接到给定主机位置上的监听 VNC 客户端。例如，inst.vncconnect=<host>[:<port>]，默认端口为 5900。此选项可与 vncviewer -listen 一起使用。

inst.xdriver=

使用 inst.xdriver= 选项可以指定要在安装过程中以及在已安装的系统上使用的 X 驱动程序的名称。

inst.usefbx=

使用 inst.usefbx 选项提示安装程序使用帧缓冲区 X 驱动程序，而不是特定于硬件的驱动程序。此选项相当于 inst.xdriver=fbdev。

modprobe.blacklist=

使用 modprobe.blacklist= 选项将一个或多个驱动程序列入黑名单或完全禁用。使用此选项禁用的驱动程序(mod)在安装开始时无法加载，安装完成后，安装的系统将保留这些设置。您可以在 /etc/modprobe.d/ 目录中找到列入黑名单的驱动程序列表。使用逗号分隔的列表禁用多个驱动程序。例如：

modprobe.blacklist=ahci,firewire_ohci
inst.xtimeout=

使用 inst.xtimeout= 选项指定启动X服务器的超时时间(以秒为单位)。

inst.sshd

在安装过程中使用 inst.sshd 选项启动 sshd 服务，以便您可以在安装过程中使用 SSH 连接到系统，并监控安装进度。有关 SSH 的更多信息，请参见 ssh(1) 手册页。默认情况下，除非您使用 inst.sshd 选项，否则不会启动`sshd`。

在安装过程中，默认情况下 root 帐户没有密码。您可以在安装期间使用 sshpw kickstart 命令设置 root 密码。
inst.kdump_addon=

使用 inst.kdump_addon= 选项在安装程序中启用或禁用 kdump 配置屏幕(附加组件)。默认情况下，屏幕处于启用状态；使用 inst.kdump_addon=off 将其禁用。禁用附加组件会禁用图形和基于文本的界面中的 kdump 屏幕以及 %addon com_redhat_kdump kickstart命令。

调试引导选项

本部分包含有关调试问题时可以使用的选项的信息。

inst.rescue=

使用 inst.rescue= 选项来运行救援环境。该选项对于尝试诊断和修复系统非常有用。

inst.updates=

使用 inst.updates= 选项指定要在安装期间应用的 updates.img 文件的位置。更新源有很多。

表 7. inst.updates= 源更新
源 描述 示例

来自网络的更新

使用 inst.updates= 的最简单方法是指定 updates.img 的网络位置。这不需要对安装树进行任何修改。要使用此方法，请编辑内核命令行以包含 inst.updates。

inst.updates=http://some.website.com/path/to/updates.img。

来自磁盘映像的更新

将 updates.img 保存在软盘驱动器或 USB 闪存盘上。这只能使用 ext2 文件系统类型的 `updates.img`来完成。要将映像的内容保存在软盘驱动器中，请插入软盘并运行命令。

dd if=updates.img of=/dev/fd0 bs=72k count=20。要使用 USB 闪存盘或闪存介质，请将 /dev/fd0 替换为您的 USB 闪存盘的设备名称。

来自安装树的更新

如果使用 CD、硬盘、HTTP 或 FTP 安装，则可以将`updates.img` 保存在安装树中，以便所有安装都可以检测到 .img 文件。将文件保存在 images/ 目录中。文件名必须为 updates.img。

对于 NFS 安装，有两个选项：可以将映像保存在 images/ 目录中，也可以保存在安装树的 RHupdates/ 目录中。
inst.loglevel=

使用 inst.loglevel= 选项指定记录在终端上的最低消息级别。这只涉及终端日志记录；日志文件始终包含所有级别的消息。此选项从最低级别到最高级别的可能值为： debug、 info、 warning、 error 和 critical。默认值为 info，这意味着在默认情况下，日志记录终端显示的消息范围从 info 到 critical。

inst.syslog=

安装开始时， inst.syslog= 选项会将日志消息发送到指定主机上的 syslog 进程。远程 syslog 进程必须配置为接受传入连接。

inst.virtiolog=

使用 inst.virtiolog= 选项指定要用于转发日志的 virtio 端口(位于 /dev/virtio-ports/name 的字符设备)。默认值为 org.fedoraproject.anaconda.log.0；如果存在此端口，则使用该端口。

inst.zram

inst.zram 选项控制安装期间 zRAM 交换的使用。该选件在系统 RAM 内创建压缩块设备，并将其用于交换空间，而不是硬盘驱动器。这使得安装程序运行时使用的可用内存比没有压缩时要少，而且还可能使安装速度更快。默认情况下，在 RAM 不超过 2 GiB 的系统上启用 zRAM 交换，在内存超过 2 GiB 的系统上禁用 zRAM 交换。您可以使用此选项更改此行为；在内存超过 2 GiB 的系统上，使用 inst.zram=1 启用该功能；在内存为 2 GiB 或更少的系统上，使用 inst.zram=0 禁用该功能。

rd.live.ram

如果指定了`rd.live.ram` 选项，则 stage 2 映像将复制到 RAM 中。当 stage 2 映像位于 NFS 服务器上时，使用此选项可将映像大小所需的最小内存增加约 500 MiB。

inst.nokill

inst.nokill 选项是一个调试选项，用于在发生致命错误或安装过程结束时阻止安装程序重新启动。使用 inst.nokill 选项捕获重新启动时丢失的安装日志。

inst.noshell

如果在安装过程中不想在终端会话 2（tty2）上使用 shell，请使用 inst.noshell 选项。

inst.notmux

如果不想在安装期间使用 tmux，请使用 inst.notmux 选项。生成的输出没有终端控制字符，用于非交互用途。

remotelog

使用 remotelog 选项通过 TCP 连接将所有日志发送到远程 host:port。如果没有监听程序，连接将失效，安装将照常进行。

存储引导选项

inst.nodmraid=

使用 inst.nodmraid= 选项禁用 dmraid 支持。

请谨慎使用此选项。如果您的磁盘被错误地标识为固件 RAID 阵列的一部分，则该磁盘上可能有一些陈旧的 RAID 元数据，必须使用适当的工具(例如 dmraid 或 wipefs)删除这些元数据。
inst.nompath=

使用 inst.nompath= 选项禁用对多路径设备的支持。此选项可用于遇到误报的系统，将正常块设备标识为多路径设备。没有其他理由使用此选项。

请谨慎使用此选项。不应将此选项用于多路径硬件。不支持使用此选项尝试安装到多路径的单个路径。
inst.gpt

inst.gpt 引导选项强制安装程序将分区信息安装到 GUID 分区表(GPT)，而不是主引导记录(MBR)。此选项在基于 UEFI 的系统上无效，除非它们处于 BIOS 兼容模式。通常，处于 BIOS 兼容模式的基于 BIOS 的系统和基于 UEFI 的系统会尝试使用 MBR 模式来存储分区信息，除非磁盘大小为 232 个扇区或更大。磁盘扇区的大小通常为 512 字节，这意味着通常相当于 2 TiB。使用 inst.gpt 引导选项可以更改此行为，允许将 GPT 写入较小的磁盘。

不推荐使用的引导选项

本部分包含有关不推荐使用的引导选项的信息。安装程序仍然接受这些选项，但不推荐使用，并计划在 Circle Linux 的未来版本中删除。

method

method 选项是 inst.repo 的别名。

repo=nfsiso

repo=nfsiso: 选项与 inst.repo=nfs: 相同。

dns

使用 nameserver 而不是 dns。请注意，nameserver 不接受逗号分隔的列表；请改用多个名称服务器选项。

netmask, gateway, hostname

netmask、 gateway 和 hostname 选项作为 ip 选项的一部分提供。

ip=bootif

自动使用 PXE 提供的 BOOTIF 选项，因此不需要使用 ip=bootif。

ksdevice
表 8. ksdevice 引导选项的值
值 信息

Not present

N/A

ksdevice=link

忽略，因为此选项与默认行为相同

ksdevice=bootif

忽略，因为如果 BOOTIF= 存在，则此选项是默认选项

ksdevice=ibft

替换为 ip=ibft。详见 ip

ksdevice=<MAC>

替换为 BOOTIF=${MAC/:/-}

ksdevice=<DEV>

替换为 bootdev

已删除的引导选项

本部分包含已从 Circle Linux 中删除的引导选项。

dracut 提供高级引导选项。有关 dracut 的更多信息，请参见 dracut.cmdline(7) 手册页。
askmethod, asknetwork

initramfs 是完全非交互式的，因此删除了 askmethod 和 asknetwork 选项。相反，可以使用 inst.repo 或指定适当的网络选项。

blacklist, nofirewire

modprobe 选项处理列入黑名单的内核模块；使用 modprobe.blacklist=<mod1>,<mod2>。您可以使用 modprobe.blacklist=firewire_ohci 将 firewire 模块列入黑名单。

inst.headless=

headless= 选项指定要安装的系统没有任何显示硬件，并且安装程序不需要查找任何显示硬件。

inst.decorated

inst.decorated 选项用于指定装饰窗口中的图形安装。默认情况下，窗口没有装饰，因此它没有标题栏、调整大小等控件。不再需要此选项。

serial

使用 console=ttyS0 选项。

updates

使用 inst.updates 选项。

essid, wepkey, wpakey

Dracut 不支持无线网络。

ethtool

不再需要此选项。

gdb

此选项已删除，因为有许多选项可用于调试基于 dracut 的 initramfs。

inst.mediacheck

使用 dracut option rd.live.check 选项。

ks=floppy

使用 inst.ks=hd:<device> 选项。

display

要远程显示 UI，请使用 inst.vnc 选项。

utf8

由于默认 TERM 设置的行为符合预期，因此不再需要此选项。

noipv6

ipv6 内置于内核中，安装程序无法将其删除。您可以使用 ipv6.disable=1 禁用 IPv6。此设置由已安装的系统使用。

upgradeany

安装程序不再处理升级，因此不再需要此选项。

1. 如果遗漏了 device ，安装程序会自动搜索包含安装 DVD 的驱动器。
2. NFS 服务器选项默认使用 NFS 协议版本 3。要使用其他版本 X，请在 options 中添加 +nfsvers=X。