auto_configs.md

linux_install (auto profile)

This project has auto mode. It is named "auto profile", because all automation is being written in profile file. Also "live auto profile" determines automatic profile, used in live installer. It can be generated using profile_gen.sh, then edited in text editor, then used for automatic installation.

Common information

• For now, there is no check for correct options in profile.
• Steps of live auto profile mode described in section steps for live auto profile section.
• Also, the are some internal variables and functions. See them in installer variables and installer functions sections.
• These profile are bash scripts, so they fully support all bash syntax and binaries (like wget, grep, etc).
• To build your own live auto profile, see building live auto profile section.

Steps of live auto profile

• Setup network for getting packages.
• Do partition, format and mount them.
• Install system with defined options (add_var).
• (If exists) Copy files from custom rootfs and execute custom_script.sh.
• Execute profile_end_action.

Installer functions

• check_online - Return if host is online (does NOT check internet connection, only local network). Returns 0 if host is online, and 1 if not.
• interface_setup_dhcp - Setup DHCP on chosen interface. Example: interface_setup_dhcp eth0.
• interface_setup_static - Setup static address on chosen interface. Example: interface_setup_static eth0 ip_client ip_mask gateway ip_dns.
• interface_con_wlan - Setup network interface using chosen method. Example: interface_con_wlan wlan0 SSID SSID_PASS dhcp OR interface_con_wlan wlan0 SSID SSID_PASS static ip_client ip_mask gateway ip_dns.
• partition_auto - Auto partition disk, then set and print PART_BOOT and PART_ROOT (uefi - UEFI (2 parts), bios - BIOS (1 part)). It will destroy all data on it. Example: partition_auto bios sda.
• format_and_mount - Format and mount chosen disk (uefi - UEFI, bios - BIOS). For BIOS, it will set bootloader_bios_place. Example: format_and_mount uefi /dev/sda2 /dev/sda1.
• do_end_action - Do end action. Used at the end of work (0 - reboot, 1 - poweroff, 2 - fall to console). Example: do_end_action 0.

Installer variables

• BOOTLOADER_TYPE_DEFAULT - Determines default bootloader type. Sets automatically to uefi or bios, depending on system.
• END_ACTION - Points to end action. Options: 0 (will reboot) OR 1 (will power off) OR 3 (will fall to console). Default: 3.

Notes

• It is strongly recommended to see example auto live profile: ./auto_configs/live/example_auto_profile.sh.
• Keep in mind that install_sys.sh by default installs only rootfs. It does not do partition or mount filesystems, but makes system bootable.

Building live auto profile

• Generate profile using profile_gen.sh.
• Determine how you will connect network on a client machine and where system will be installed.
• Using previous section, add necessary lines (See Notes) to your generated profile.
• Do not forget to write profile_end_action function in profile.