Boot options
Agama Live ISO behavior can be altered using the kernel command line at boot time. For those
architectures that support Grub, you need to modify the agama-installer
entry adding the boot
options at the end of the linux
line.
We must admit that it is not as convenient as it was when using Linuxrc and YaST. However, we rely on dracut now that it is easier to extend.
-
agama.auto
: Tells the installer to use the profile in the given URL to start an unattended installation.agama.auto=http://mydomain.org/tumbleweed.jsonnet
-
agama.config_url
: it uses the file at the given URL as the new Agama configuration. Please, do not confuse this file with an unattended installation profile. See URL handling in the installer to find more details about the supported URLs.agama.config_url=http://192.168.122.1/my-agama.yaml
agama.config_url=usb:///agama.yaml -
agama.install_url
Override the defaultinstallation_url
set in the product files here by passing theagama.install_url
parameter as a boot option in the bootloader. This is particularly useful for any pre-production testing in openQA.agama.install_url=https://myrepo,https://myrepo2
warningSetting this variable will impact all products.
-
live.password
andlive.password_hash
Set theroot
password of the live system.live.password
accepts a plain text password, whilelive.password_hash
is expected to receive a hashed password, which is more secure. The disadvantage of a hashed password is that it is quite long and is not easy to type it into the boot prompt manually. It makes sense in environments where you can prepare the boot parameters in advance like in PXE boot or some virtual machines.live.password=nots3cr3t
Setting a password enables SSHThe SSH service is not started unless a password is provided using any of the available options (
live.password
,live.password_hash
,live.password_dialog
, orlive.password_systemd
). This avoids accidentally using the default password from the medium. -
live.password_dialog
Start an interactive dialog during the boot process. This uses a nice dialog for entering and confirming the password. However, in some situations the full screen dialog might not be displayed correctly or some messages might be displayed over it. In that case you might use theCtrl+L
key shortcut to refresh the screen. If it still does not work then try using the other option below.live.password_dialog
live.password_dialog=1 -
live.password_systemd
Ask for a password using a simple prompt. This is similar to the option above, but the advantage is that this solution does not use a full screen dialog but a single line prompt so it should work better in special environments like a serial console.live.password_systemd
live.password_systemd=1 -
proxy
: sets up a network proxy. The supported proxy URL format isprotocol://[user[:password]@]host[:port]
.proxy=http://192.168.122.1:3128
When the installation system boots, the agama-proxy-setup service will read the proxy URL to be used from the kernel command line options or through the dracut ask prompt configuration file writing it to the /etc/sysconfig/proxy. After that the microOS Tools setup-systemd-proxy-env systemd service will make the proxy variables from that file available to all the systemd units writing a systemd config file with all the variables as Environment ones.