19215: Incorporate many details into install doc
[arvados.git] / doc / _includes / _download_installer.liquid
index 5dfcd089e726e161f2df68973465ab967e358064..10909088b33f8ce50b67f69e0ed190b14d7cc0cb 100644 (file)
@@ -6,8 +6,6 @@ SPDX-License-Identifier: CC-BY-SA-3.0
 
 {% include 'branchname' %}
 
-This procedure will install all the main Arvados components to get you up and running in a single host.
-
 This is a package-based installation method, however the installation script is currently distributed in source form via @git@. We recommend checking out the git tree on your local workstation, not directly on the target(s) where you want to install and run Arvados.
 
 <notextile>
@@ -17,4 +15,16 @@ cd arvados/tools/salt-install
 </code></pre>
 </notextile>
 
-The @provision.sh@ script will help you deploy Arvados by preparing your environment to be able to run the installer, then running it. The actual installer is located in the "arvados-formula git repository":https://git.arvados.org/arvados-formula.git/tree/refs/heads/{{ branchname }} and will be cloned during the running of the @provision.sh@ script.  The installer is built using "Saltstack":https://saltproject.io/ and @provision.sh@ performs the install using master-less mode.
+The @install.sh@ and @provision.sh@ scripts will help you deploy Arvados by preparing your environment to be able to run the installer, then running it. The actual installer is located in the "arvados-formula git repository":https://git.arvados.org/arvados-formula.git/tree/refs/heads/{{ branchname }} and will be cloned during the running of the @provision.sh@ script.  The installer is built using "Saltstack":https://saltproject.io/ and @provision.sh@ performs the install using masterless mode.
+
+h2(#copy_config). Initialize the installer
+
+<notextile>
+<pre><code>./installer.sh initialize ~/setup-arvados-xarv1 {{local_params_src}} {{config_examples_src}}
+cd ~/setup-arvados-xarv1
+</code></pre>
+</notextile>
+
+This creates a git repository in @~/setup-arvados-xarv1@.  The @installer.sh@ will record all the configuration changes you make, as well as using @git push@ to synchronize configuration edits across all the nodes.
+
+Important!  All further commands must be run in the @~/setup-arvados-xarv1@