B.2. 用于安装程序配置和流量控制的 Kickstart 命令
这个列表中的 Kickstart 命令可控制安装模式和安装过程,以及最后发生什么。
B.2.1. cdrom
cdrom
Kickstart 命令是可选的。它使用系统上的第一个光驱执行安装。
语法
cdrom
备注
- 这个命令没有选项。
-
要实际运行安装,您必须指定
cdrom
,harddrive
,hmc
,nfs
,liveimg
,ostreesetup
,rhsm
, 或url
,除非内核命令行上指定了inst.repo
选项。
B.2.2. cmdline
cmdline
Kickstart 命令是可选的。它以完全非互动的命令行模式执行安装。任何互动提示都会终止安装。
语法
cmdline
备注
-
对于完全自动安装,您必须在 Kickstart 文件中指定可用模式之一(
图形
、文本
或命令行
),或者必须使用console=
引导选项。如果没有指定模式,系统会尽可能使用图形模式,或者提示您从 VNC 和文本模式中选择。 - 这个命令没有选项。
- 这个模式在带有 x3270 终端的 64 位 IBM Z 系统中很有用。
B.2.3. driverdisk
driverdisk
Kickstart 命令是可选的。使用它为安装程序提供额外的驱动程序。
可在 Kickstart 安装过程中使用驱动程序磁盘提供默认不包括的额外驱动程序。您必须将驱动程序磁盘内容复制到系统的磁盘上分区的根目录中。然后,您必须使用 driverdisk
命令指定安装程序是否应该查找驱动程序磁盘及其位置。
Syntax
driverdisk [partition|--source=url|--biospart=biospart]
选项
您必须以以下一种方式指定驱动程序磁盘的位置:
-
partition - 包含驱动程序磁盘的分区。请注意,该分区必须指定为完整路径(例如
/dev/sdb1
),而不只是分区名称(如sdb1
)。 --source=
- 驱动程序磁盘的 URL。示例包括:driverdisk --source=ftp://path/to/dd.img
driverdisk --source=http://path/to/dd.img
driverdisk --source=nfs:host:/path/to/dd.img
-
--biospart=
- 包含驱动程序磁盘(如82p2
)的 BIOS 分区。
备注
也可以从本地磁盘或类似的设备加载驱动程序磁盘,而不是通过网络或从 initrd
加载。按照以下步骤操作:
- 在磁盘驱动器、USB 或者任何类似的设备上载入驱动程序磁盘。
- 将标签(如 DD )设置为这个设备。
在您的 Kickstart 文件中添加以下行:
driverdisk LABEL=DD:/e1000.rpm
使用特定标签替换 DD,并使用特定名称替换 e1000.rpm。使用 inst.repo
命令支持的任何内容,而不是 LABEL 来指定您的磁盘驱动器。
B.2.4. EULA
eula
Kickstart 命令是可选的。使用这个选项在没有用户互动的情况下接受最终用户许可证协议(End User License Agreement,EULA)。指定这个选项可防止 Initial Setup 在完成安装并第一次重启系统后提示您接受该许可证。
Syntax
eula [--agreed]
选项
-
--agreed
(必需)- 接受 EULA。必须始终使用这个选项,否则eula
命令就无意义。
B.2.5. firstboot
firstboot
Kickstart 命令是可选的。它决定了系统首次启动时 Initial Setup
应用程序是否启动。如果启用,则必须安装 initial-setup 软件包。如果没有指定,这个选项默认是禁用的。
语法
firstboot OPTIONS
选项
-
--enable
或--enabled
- 系统第一次启动时启动 Initial Setup。 -
--disable
或--disabled
- 系统第一次引导时不会启动 Initial Setup。 -
--reconfig
- 以重新配置模式在引导时启用 Initial Setup。这个模式除默认模式外还启用了 root 密码、时间和日期以及网络和主机名配置选项。
B.2.6. 图形化
graphical
Kickstart 命令是可选的。它在图形模式下执行安装。这是默认值。
语法
graphical [--non-interactive]
选项
-
--non-interactive
- 以完全非互动模式执行安装。这个模式将在用户交互需要时终止安装。
备注
-
对于完全自动安装,您必须在 Kickstart 文件中指定可用模式之一(
图形
、文本
或命令行
),或者必须使用console=
引导选项。如果没有指定模式,系统会尽可能使用图形模式,或者提示您从 VNC 和文本模式中选择。
B.2.7. halt
halt
Kickstart 命令是可选的。
在成功完成安装后停止系统。这和手动安装相似,Anaconda 会显示一条信息并等待用户按任意键来重启系统。在 Kickstart 安装过程中,如果没有指定完成方法,将使用这个选项作为默认选项。
语法
halt
备注
-
halt
命令等同于shutdown -H
命令。详情请查看 shutdown(8) man page。 -
有关其他完成方法,请查看
poweroff
、reboot
和shutdown
命令。 - 这个命令没有选项。
B.2.8. harddrive
harddrive
Kickstart 命令是可选的。它使用红帽安装树或者本地驱动器中的完整安装 ISO 镜像执行安装。必须使用安装程序可挂载的文件系统格式化驱动器:ext2
, ext3
, ext4
, vfat
, 或 xfs
。
Syntax
harddrive OPTIONS
选项
-
--partition=
- 要从中安装的分区(如sdb2
)。 -
--dir=
- 包含安装树variant
目录或完整安装 DVD 的 ISO 镜像的目录。
示例
harddrive --partition=hdb2 --dir=/tmp/install-tree
备注
-
在以前的版本中,
harddrive
命令必须与install
命令一同使用。install
命令已弃用,并且可以自行使用harddrive
,因为它表示安装
。 -
要实际运行安装,您必须指定
cdrom
,harddrive
,hmc
,nfs
,liveimg
,ostreesetup
,rhsm
, 或url
,除非内核命令行上指定了inst.repo
选项。
B.2.9. liveimg
liveimg
Kickstart 命令是可选的。它从磁盘镜像而不是软件包执行安装。
语法
liveimg
--url=SOURCE
[OPTIONS]
必填选项
-
--url=
- 从其中安装的位置。支持的协议包括HTTP
、HTTPS
、FTP
和file
。
可选选项
-
--url=
- 从其中安装的位置。支持的协议包括HTTP
、HTTPS
、FTP
和file
。 -
--proxy=
- 指定在执行安装时要使用的HTTP
、HTTPS
或者FTP
代理。 -
--checksum=
- 包含镜像文件的SHA256
校验和的可选参数,用于验证。 -
--noverifyssl
- 连接到HTTPS
服务器时禁用 SSL 验证。
示例
liveimg --url=file:///images/install/squashfs.img --checksum=03825f567f17705100de3308a20354b4d81ac9d8bed4bb4692b2381045e56197 --noverifyssl
备注
-
镜像可以是来自实时 ISO 镜像的
squashfs.img
文件、压缩的 tar 文件(.tar
、.tbz
、.tgz
、.txz
、.tar.bz2
、.tar.gz
或.tar.xz
.),或者安装介质可以挂载的任何文件系统。支持的文件系统有ext2
、ext3
、ext4
、vfat
和xfs
。 -
将
liveimg
安装模式与驱动程序磁盘一起使用时,磁盘中的驱动程序不会自动包含在安装的系统中。如有必要,应手动安装这些驱动程序,或在 kickstart 脚本的%post
部分中安装这些驱动程序。 -
要实际运行安装,您必须指定
cdrom
,harddrive
,hmc
,nfs
,liveimg
,ostreesetup
,rhsm
, 或url
,除非内核命令行上指定了inst.repo
选项。
B.2.10. logging
logging
Kickstart 命令是可选的。它控制在安装过程中 Anaconda 的错误日志。它对安装的系统没有影响。
只支持使用 TCP 记录日志。对于远程日志记录,请确保在远程服务器上打开您在 --port=
选项中指定的端口号。默认端口为 514。
语法
logging OPTIONS
可选选项
-
--host=
- 向给定的远程主机发送日志信息,该主机必须配置有一个 syslogd 进程,以接受远程记录。 -
--port=
- 如果远程 syslogd 进程使用默认端口以外的端口,请使用这个选项进行设置。
B.2.11. mediacheck
mediacheck
Kickstart 命令是可选的。该命令强制安装程序在开始安装前执行介质检查。因为这个命令需要在执行安装时有人工参与,因此它默认被禁用。
语法
mediacheck
备注
-
这个 Kickstart 命令等同于
rd.live.check
引导选项。 - 这个命令没有选项。
B.2.12. nfs
nfs
Kickstart 命令是可选的。它从指定的 NFS 服务器执行安装。
语法
nfs OPTIONS
选项
-
--server=
- 要从中安装的服务器(主机名或 IP)。 -
--dir=
- 包含安装树variant
目录的目录。 -
--opts=
- 用于挂载 NFS 导出的挂载选项(可选)。
示例
nfs --server=nfsserver.example.com --dir=/tmp/install-tree
备注
-
要实际运行安装,您必须指定
cdrom
,harddrive
,hmc
,nfs
,liveimg
,ostreesetup
,rhsm
, 或url
,除非内核命令行上指定了inst.repo
选项。
B.2.13. ostreesetup
ostreesetup
Kickstart 命令是可选的。它被用来设置基于 OStree 的安装。
Syntax
ostreesetup --osname=OSNAME [--remote=REMOTE] --url=URL --ref=REF [--nogpg]
必须的选项
-
--osname=OSNAME
- 用于操作系统安装的管理根. -
--url=URL
- 要从中安装的存储库的 URL。 -
--ref=REF
- 用于安装的软件仓库中的分支名称。
可选选项:
-
--remote=REMOTE
- 远程存储库位置。 -
--nogpg
- 禁用 GPG 密钥验证。
备注
- 有关 OStree 工具的更多信息,请参阅上游文档:https://ostreedev.github.io/ostree/
B.2.14. poweroff
poweroff
Kickstart 命令是可选的。它会在安装成功后关闭系统并关闭电源。通常,在手动安装过程中,Anaconda 会显示一条信息并等待用户按任意键来重新引导系统。
语法
poweroff
备注
-
poweroff
选项等同于shutdown -P
命令。详情请查看 shutdown(8) man page。 -
有关其他完成方法,请查看
halt
、reboot
和shutdown
Kickstart 命令。如果没有在 Kickstart 文件中明确指定其他方法,则halt
选项是默认的完成方法。 -
poweroff
命令高度依赖于所使用的系统硬件。特别是,某些硬件部件如 BIOS、APM(高级电源管理)和 ACPI(高级配置和电源接口)必须能和系统内核交互。有关系统 APM/ACPI 功能的更多信息,请参阅您的硬件文档。 - 这个命令没有选项。
B.2.15. reboot
reboot
Kickstart 命令是可选的。它指示安装程序在安装成功(没有参数)后重启。通常,Kickstart 会显示信息并等待用户按任意键来重新引导系统。
语法
reboot OPTIONS
选项
-
--eject
- 在重新启动前尝试弹出可引导介质(DVD、USB 或其他介质)。 --kexec
- 使用kexec
系统调用而不是执行完全重启,这样可立即将安装的系统加载到内存中,绕过通常由 BIOS 或固件执行的硬件初始化。重要这个选项已弃用,仅作为技术预览使用。有关红帽对技术预览功能支持范围的详情,请查看 技术预览功能支持范围 文档。
使用
kexec
时,设备寄存器(通常会在系统完全重启后清除)可能会继续填写数据,这可能会给某些设备驱动程序造成问题。
备注
-
使用
reboot
选项可能会导致安装无限循环,具体取决于安装介质和方法。 -
reboot
选项等同于shutdown -r
命令。详情请查看 shutdown(8) man page。 -
指定
reboot
,以便在 64 位 IBM Z 中使用命令行模式安装时完全自动安装。 -
有关其他完成方法,请查看
halt
、poweroff
和shutdown
Kickstart 选项。如果没有在 Kickstart 文件中明确指定其他方法,则halt
选项是默认的完成方法。
B.2.16. rhsm
rhsm
Kickstart 命令是可选的。它指示安装程序从 CDN 注册并安装 RHEL。
在注册系统时,rhsm
Kickstart 命令不需要使用自定义 %post
脚本。
选项
-
--orgrganization=
- 使用组织 ID 从 CDN 注册和安装 RHEL。 -
--activation-key=
- 使用激活码从 CDN 注册和安装 RHEL。只要在您的订阅中进行了注册,即可多次使用选项(每次使用一个激活码)。 -
--connect-to-insights
- 将目标系统连接到 Red Hat Insights。 -
--proxy=
- 设置 HTTP 代理。 -
--server-hostname=
- 设置要注册的 Satellite 实例主机名。
要使用
rhsm
Kickstart 命令将安装源存储库切换到 CDN,您必须满足以下条件:-
在内核命令行上,您已使用
inst.stage2=<URL>
来获取安装镜像,但没有使用inst.repo=
指定安装源。 -
在 Kickstart 文件中,您没有使用
url
、cdrom
、harddrive
、liveimg
、nfs
和ostree
设置命令指定安装源。
-
在内核命令行上,您已使用
-
使用引导选项指定或者包含在 Kickstart 文件中的安装源 URL 优先于 CDN,即使 Kickstart 文件包含带有有效凭证的
rhsm
命令。已注册该系统,但会通过 URL 安装源进行安装。这样可保证早期安装进程正常运行。
B.2.17. shutdown
shutdown
Kickstart 命令是可选的。它会在安装成功完成后关闭系统。
语法
shutdown
备注
-
shutdown
Kickstart 选项等同于shutdown
命令。详情请查看 shutdown(8) man page。 -
有关其他完成方法,请查看
halt
、poweroff
和reboot
Kickstart 选项。如果没有在 Kickstart 文件中明确指定其他方法,则halt
选项是默认的完成方法。 - 这个命令没有选项。
B.2.18. sshpw
sshpw
Kickstart 命令是可选的。
在安装过程中,您可以与安装程序交互并通过 SSH
连接监控其进度。使用 sshpw
命令创建登录的临时帐户。该命令的每个实例都会创建一个只存在于安装环境中的单独帐户。这些不会转移到系统里。
Syntax
sshpw --username=name [OPTIONS] password
必填选项
-
--username
=name - 提供用户名称。这个选项是必需的。 - password - 用户要使用的密码。这个选项是必需的。
可选选项
--iscrypted
- 如果给出这个选项,则假设 password 参数已被加密。这个选项与--plaintext
相互排斥。要生成加密的密码,可以使用 Python:$
python3 -c 'import crypt,getpass;pw=getpass.getpass();print(crypt.crypt(pw) if (pw==getpass.getpass("Confirm: ")) else exit())'
这会使用随机 salt 为密码生成 sha512 兼容哈希。
-
--plaintext
- 如果给出这个选项,则假设 password 参数为纯文本。这个选项与--iscrypted
相互排斥 -
--lock
- 如果给出这个选项,则默认锁定这个帐户。这意味着用户无法从控制台登录。 -
--sshKey -
如果给出这个选项,则 <password> 字符串被解释为 ssh 密钥值。
备注
-
默认情况下,
ssh
服务器不会在安装过程中启动。要使ssh
在安装过程中可用,使用内核引导选项inst.sshd
引导系统。 如果要禁用 root
ssh
访问,同时允许其他用户ssh
访问,请使用:sshpw --username=example_username example_password --plaintext
sshpw --username=root example_password --lock
要简单地禁用 root
ssh
访问,请使用:sshpw --username=root example_password --lock
B.2.19. text
text
Kickstart 命令是可选的。它在文本模式下执行 Kickstart 安装。Kickstart 安装默认是以图形模式执行的。
语法
text [--non-interactive]
选项
-
--non-interactive
- 以完全非互动模式执行安装。这个模式将在用户交互需要时终止安装。
备注
-
对于完全自动安装,您必须在 Kickstart 文件中指定可用模式之一(
图形
、文本
或命令行
),或者必须使用console=
引导选项。如果没有指定模式,系统会尽可能使用图形模式,或者提示您从 VNC 和文本模式中选择。
B.2.20. url
url
Kickstart 命令是可选的。它用来使用 FTP、HTTP 或者 HTTPS 协议从远程服务器上的安装树镜像进行安装。您只能指定一个 URL。
您必须指定 --url
、--metalink
或 --mirrorlist
选项之一。
语法
url
--url=FROM
[OPTIONS]
选项
-
--url=FROM
- 指定要从中安装的HTTP
、HTTPS
、FTP
或文件
位置。 -
--mirrorlist=
- 指定要从中安装的镜像 URL。 -
--proxy=
- 指定在安装过程中要使用的HTTP
、HTTPS
或者FTP
代理。 -
--noverifyssl
- 连接到HTTPS
服务器时禁用 SSL 验证。 -
--metalink=URL
- 指定要从中安装的 metalink URL。变量替换用于 URL 中的$releasever
和$basearch
。
示例
从 HTTP 服务器安装:
url --url=http://server/path
从 FTP 服务器安装:
url --url=ftp://username:password@server/path
备注
-
要实际运行安装,您必须指定
cdrom
,harddrive
,hmc
,nfs
,liveimg
,ostreesetup
,rhsm
, 或url
,除非内核命令行上指定了inst.repo
选项。
B.2.21. vnc
vnc
Kickstart 命令是可选的。它允许通过 VNC 远程查看图形安装。
与文本模式相比,这个模式通常是首选模式。因为在文本模式中有某些大小和语言的限制。如果没有附加选项,这个命令将在不需要密码的系统中启动 VNC 服务器,并显示连接它所需要的详情。
Syntax
vnc [--host=host_name] [--port=port] [--password=password]
选项
--host=
- 连接在给定主机名中侦听的 VNC viewer 进程。
--port=
- 提供远程 VNC viewer 进程侦听的端口。如果没有提供,Anaconda 将使用 VNC 默认端口 5900。
--password=
- 设定必须提供用来连接到 VNC 会话的密码。这是可选的,但推荐使用。
其他资源
B.2.22. %include
%include
Kickstart 命令是可选的。
使用 %include
命令,将另一文件的内容包含在 Kickstart 文件中,就好像其内容在 Kickstart 文件中的 %include
命令的位置一样。
它的内容只在 %pre
脚本部分之后评估,因此可用于将脚本生成的文件包含在 %pre
部分中。要在评估 %pre
部分之前包含文件,请使用 %ksappend
命令。
Syntax
%include path/to/file
B.2.23. %ksappend
%ksappend
Kickstart 命令是可选的。
使用 %ksappend
命令将另一个文件的内容包含在 Kickstart 文件中,就好像其内容在 Kickstart 文件中 %ksappend
命令的位置一样。
这个内容在 %pre
脚本部分之前评估,这与 %include
命令包括的内容不同。
Syntax
%ksappend path/to/file