From 235024a6e845b5e2fe9d8935336fc528f97a3406 Mon Sep 17 00:00:00 2001 From: "A. Wilcox" Date: Tue, 14 Jul 2020 21:20:04 -0500 Subject: install: Write some of chapter 5 --- src/install/4_options.xml | 4 ++-- src/install/5_commit.xml | 29 ++++++++++++++++++++++++++--- src/install/7_scripts.xml | 4 ++-- 3 files changed, 30 insertions(+), 7 deletions(-) diff --git a/src/install/4_options.xml b/src/install/4_options.xml index 213ab34..528c56d 100644 --- a/src/install/4_options.xml +++ b/src/install/4_options.xml @@ -1,9 +1,9 @@ Selecting System Options - You use the Adélie Linux System Installation software to configure your new environment. + You use the Adélie Linux System Installation software to configure your new environment. This chapter introduces you to System Installation, and provides detailed information about your available options on each screen. - For more information about how to use and navigate System Installation, see . + For more information about how to use and navigate System Installation, see .
Overview The System Installation software asks you a series of questions about the desired configuration for your computer. diff --git a/src/install/5_commit.xml b/src/install/5_commit.xml index 91d4edf..b43e333 100644 --- a/src/install/5_commit.xml +++ b/src/install/5_commit.xml @@ -1,8 +1,31 @@ Installing System Software -
- - <para/> + <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 + 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. +
+
+ From a command line + You can use the Horizon Executor from a command line to execute a HorizonScript that you have prepared on another computer. + + Executing a HorizonScript from the command line + 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. + Obtain a root command prompt on the target computer. Typically, this is accomplished by logging in as root on the Installation Media. + Run hscript-fetch url-to-installfile, where url-to-installfile is a fully-qualified URL to the desired installfile. For example, hscript-fetch https://myserver/my-workstation.installfile will fetch the HorizonScript at https://myserver/my-workstation.installfile. + Optionally, run hscript-validate /etc/horizon/installfile to validate the HorizonScript. + Run hscript-executor to execute the HorizonScript. + +
+
+ Reviewing the Executor log file + When using graphical installation media, the Executor log file is located at /var/log/horizon/executor.log in the live environment. If you choose "Save Installation Data" when completing System Installation, the Executor log file is saved to executor.log in the directory you select. + When running Horizon from the command line, the log is output to stderr. +
+ Interpreting log messages + Every log message output by Horizon is in a specific format, designed to be easily readable by system operators and processed by computer programs. + The format is: timestamp TAB message-type TAB location: [severity: ] message +
diff --git a/src/install/7_scripts.xml b/src/install/7_scripts.xml index 3ea0550..c21855a 100644 --- a/src/install/7_scripts.xml +++ b/src/install/7_scripts.xml @@ -111,7 +111,7 @@ inherit cad.installfile Open a Terminal window. Run hscript-validate /path/to/installfile, where /path/to/installfile is the path to your HorizonScript. - The HorizonScript Validation Utility outputs log messages in the same format as the Horizon Executor. For more information on interpreting log messages from the HorizonScript Validation Utility, refer to . + The HorizonScript Validation Utility outputs log messages in the same format as the Horizon Executor. For more information on interpreting log messages from the HorizonScript Validation Utility, refer to . If you believe your HorizonScript may have multiple errors, you can use the flag (which stands for "Keep going") to have the Validation Utility run through the entire script instead of stopping at the first error.
@@ -123,7 +123,7 @@ inherit cad.installfile Open a Terminal window. Run hscript-simulate /path/to/installfile, where /path/to/installfile is the path to your HorizonScript. - The HorizonScript Simulation Utility outputs log messages in the same format as the Horizon Executor. For more information on interpreting log messages from the HorizonScript Simulation Utility, refer to . + The HorizonScript Simulation Utility outputs log messages in the same format as the Horizon Executor. For more information on interpreting log messages from the HorizonScript Simulation Utility, refer to . The HorizonScript Simulation Utility writes log messages to stderr, and the equivalent shell commands to stdout. If you want to read the log messages and discard the shell commands, you may run the hscript-simulate command with stdout redirected to /dev/null, as in hscript-simulate /path/to/installfile >/dev/null. Similarly, if you want to save the shell commands to a file, you may redirect stdout to a file, as in hscript-simulate /path/to/installfile >myscript.sh.
-- cgit v1.2.3-60-g2f50