summaryrefslogtreecommitdiff
path: root/src/install/5_commit.xml
blob: b43e33332fa8895d75f85c224d057124d2d42f49 (plain) (blame)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
<?xml version="1.0" encoding="utf-8"?>
<chapter label="5" id="commit">
    <title>Installing System Software</title>
    <highlights><para>Now that you have selected the appropriate options for your system, you can proceed with installing Adélie Linux.</para></highlights>
    <section id="ui_runner">
        <title>From Adélie graphical installation media</title>
        <para>If you are using the graphical System Installation wizard from Adélie Linux installation media, choosing "Install" from the last page of System Installation will automatically begin the process of installing Adélie Linux on your computer.</para>
    </section>
    <section id="executor">
        <title>From a command line</title>
        <para>You can use the Horizon Executor from a command line to execute a HorizonScript that you have prepared on another computer.</para>
        <procedure>
            <title>Executing a HorizonScript from the command line</title>
            <step><para>Boot the target computer using Horizon media.  This can be either the normal Full or Live Installation Media, the Network Installation Media, or custom media you have created that contains the Horizon system.</para></step>
            <step><para>Obtain a root command prompt on the target computer.  Typically, this is accomplished by logging in as <literal>root</literal> on the Installation Media.</para></step>
            <step><para>Run <literal><command>hscript-fetch</command> <userinput>url-to-installfile</userinput></literal>, where <userinput>url-to-installfile</userinput> is a fully-qualified URL to the desired installfile.  For example, <literal><command>hscript-fetch</command> https://myserver/my-workstation.installfile</literal> will fetch the HorizonScript at https://myserver/my-workstation.installfile.</para></step>
            <step><para>Optionally, run <literal><command>hscript-validate</command> /etc/horizon/installfile</literal> to validate the HorizonScript.</para></step>
            <step><para>Run <literal><command>hscript-executor</command></literal> to execute the HorizonScript.</para></step>
        </procedure>
    </section>
    <section id="executor_log">
        <title>Reviewing the Executor log file</title>
        <para>When using graphical installation media, the Executor log file is located at <filename>/var/log/horizon/executor.log</filename> in the live environment.  If you choose "Save Installation Data" when completing System Installation, the Executor log file is saved to <filename>executor.log</filename> in the directory you select.</para>
        <para>When running Horizon from the command line, the log is output to <literal>stderr</literal>.</para>
        <section id="log_format">
            <title>Interpreting log messages</title>
            <para>Every log message output by Horizon is in a specific format, designed to be easily readable by system operators and processed by computer programs.</para>
            <para>The format is: <literal>timestamp TAB message-type TAB location: [severity: ] message</literal></para>
        </section>
    </section>
</chapter>