osinfo-install-script(1)

💖 NAME 💖

okay so bestie, meet osinfo-install-script(1) — a Libosinfo icon whose whole personality is generating a script for automated installation. ✨ It's giving main character energy, lowkey, and it's literally here to let the installer cook but make it scripted.

🦋 SYNOPSIS 🦋

the whole call shape is:

osinfo-install-script [OPTIONS...] MEDIA-FILE|OS-ID

🌸 DESCRIPTION 🌸

okay so this cutie generates a script suitable for performing an automated installation of MEDIA_FILE or OS-ID. 💅

MEDIA_FILE should be a path to an installer or live media (typically an ISO file). No cap. OS-ID should be a URI identifying the operating system, or its short ID. 🫶

By default a script will be generated for a JEOS style install. periodt.

✨ OPTIONS ✨

• --profile=NAME — choose the installation script profile. Defaults to jeos, but can also be desktop, or a site specific profile name. 🎀
• --installation-source=NAME — set the installation source to be used with the installation script. Defaults to media, but can also be network. 🌈
• --config=key=value — set the configuration parameter key to value. 💖
• --config-file=config-file — set the configurations parameters according to the config-file passed. 🧚

🚨 Note that use of --config-file is strongly recommended if the user or admin passwords need to be set. Providing passwords directly using --config= is insecure as the password is visible to all processes and users on the same host. Please don't do the insecure thing, bestie.

🧠 CONFIGURATION KEYS 🧠

The following configuration keys are available:

• hardware-arch — the hardware architecture.
• l10n-timezone — the local timezone.
• l10n-keyboard — the local keyboard layout.
• l10n-language — the local language.
• admin-password — the administrator password. This option has been deprecated, use --config-file for setting the admin password. 🚨
• user-password — the user password. This option has been deprecated, use --config-file for setting the user password. 🚨
• user-login — the user login name.
• user-realname — the user real name.
• user-autologin — whether to automatically login the user.
• user-admin — whether to give the user administrative privileges.
• reg-product-key — the software registration key.
• reg-login — the software registration user login.
• reg-password — the software registration user password.

🎀 CONFIGURATION FILE FORMAT 🎀

okay so the configuration file must consist in a file which contains a install-script group and, under this group, key=value pairs, as shown below: 💅

[install-script]
l10n-timezone=GMT
l10n-keyboard=uk
l10n-language=en_GB
admin-password=123456
user-login=berrange
user-password=123456
user-realname="Daniel P Berrange"

🔥 EXAMPLE USAGE 🔥

The following usages generate a Fedora 30 kickstart script: 🌸

         # osinfo-install-script \
                --profile jeos \
                --config-file /path/to/config/file \
                fedora30

         # osinfo-install-script \
                --profile jeos \
                --config l10n-timezone=GMT \
                --config l10n-keyboard=uk \
                --config l10n-language=en_GB \
                --config admin-password=123456 \
                --config user-login=berrange \
                --config user-password=123456 \
                --config user-realname="Daniel P Berrange" \
                fedora30

💀 EXIT STATUS 💀

vibe check: the exit status will be 0 if an install script is generated, or 1 on error. Slay when it works, sad little error vibe when it doesn't. 🫶

👑 AUTHORS 👑

Daniel P. Berrange <berrange@redhat.com> — iconic author moment. ✨

🌈 COPYRIGHT 🌈

Copyright (C) 2012 Red Hat, Inc. — yes, that's the whole copyright line, bestie. 💜

🍓 LICENSE 🍓

osinfo-install-script is distributed under the terms of the GNU LGPL v2 license. This is free software; see the source for copying conditions. There is NO warranty; not even for MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. Read that last part again: NO warranty, no cap. 😭

---

mwah 💋 — brought to you by libosinfo-1.12.0, dated 2024-12-02, bestie. This has been osinfo-install-script(1), and it's a whole vibe. 🎀✨