HSCRIPT-EXECUTOR(8)

NAME
hscript-executor - install a Linux system based on a HorizonScript

SYNOPSIS
hscript-executor

DESCRIPTION
The hscript-executor utility installs a Linux system to /target on the current system, configured as described in a given HorizonScript.

It is assumed that hscript-fetch(8) has been run before hscript-executor, as this utility places the desired HorizonScript in the location where hscript-executor expects it to be.

  Steps
Horizon divides an installation into "steps", which are a grouping of related installation processes. The steps defined in this version of Horizon are:

validate
    The validate step performs validation of the HorizonScript, ensuring that it can be executed on the current system.

disk
    The disk step performs disk initialisation and preparation, including any labeling, partitioning, file system creation, and mounting.

pre-metadata
    The pre-metadata step performs configuration of early system metadata that must be complete before networking is set up. This includes setting the hostname, setting up APK repositories, and (in some cases) setting up initial firmware loads.

net The net step performs all networking configuration. This includes setting up the network in the target system, and (if the network key in the HorizonScript is set to true) configuring the network on the current host.

pkgdb
    The pkgdb step performs initial APK configuration and then installs the desired packages to the target environment.

post-metadata
    The post-metadata step performs configuration of system metadata. This includes setting the root passphrase, the keymap, any user accounts requested, and the system timezone.

FILES
/etc/horizon/installfile
hscript-executor reads /etc/horizon/installfile as the HorizonScript to use for configuring the target system.

EXIT STATUS

EXAMPLES
hscript-executor

DIAGNOSTICS

%dateT%time log %location: %status: %message[: %extra] A message of type %status was logged while processing %location. The log message %message may be followed by additional information or hints in %extra.

%dateT%time step-start %step Denotes that the installation step %step is starting. Steps are described in the Steps section.

%dateT%time step-end %step Denotes that the installation step %step has finished successfully. Steps are described in the Steps section.

SEE ALSO
hscript(5), hscript-fetch(8), hscript-simulate(1), hscript-validate(1).

HISTORY
The hscript-executor command first appeared in Horizon 0.1.

AUTHORS
A. Wilcox <awilfox@adelielinux.org>