3 navsection: installguide
4 title: Multi host Arvados
7 Copyright (C) The Arvados Authors. All rights reserved.
9 SPDX-License-Identifier: CC-BY-SA-3.0
12 # "Install Saltstack":#saltstack
13 # "Install dependencies":#dependencies
14 # "Install Arvados using Saltstack":#saltstack
15 # "DNS configuration":#final_steps
16 # "Initial user and login":#initial_user
18 h2(#saltstack). Install Saltstack
20 If you already have a Saltstack environment you can skip this section.
22 The simplest way to get Salt up and running on a node is to use the bootstrap script they provide:
25 <pre><code>curl -L https://bootstrap.saltstack.com -o /tmp/bootstrap_salt.sh
26 sudo sh /tmp/bootstrap_salt.sh -XUdfP -x python3
30 For more information check "Saltstack's documentation":https://docs.saltstack.com/en/latest/topics/installation/index.html
32 h2(#dependencies). Install dependencies
34 Arvados depends in a few applications and packages (postgresql, nginx+passenger, ruby) that can also be installed using their respective Saltstack formulas.
36 The formulas we use are:
38 * "postgres":https://github.com/saltstack-formulas/postgres-formula.git
39 * "nginx":https://github.com/saltstack-formulas/nginx-formula.git
40 * "docker":https://github.com/saltstack-formulas/docker-formula.git
41 * "locale":https://github.com/saltstack-formulas/locale-formula.git
43 There are example Salt pillar files for each of those formulas in the "test/salt/pillar/examples":https://github.com/saltstack-formulas/arvados-formula/tree/master/test/salt/pillar/examples directory. As they are, they allow you to get all the main Arvados components up and running.
45 h2(#saltstack). Install Arvados using Saltstack
47 This is a source-based installation method. The Salt scripts are available from the "tools/salt-install":https://github.com/arvados/arvados/tree/master/tools/salt-install directory in the Arvados git repository.
49 The Arvados formula we maintain is located in the Saltstack's community repository of formulas:
51 * "arvados-formula":https://github.com/saltstack-formulas/arvados-formula.git
53 The @development@ version lives in our own repository
55 * "arvados-formula development":https://github.com/arvados/arvados-formula.git
57 This last one might break from time to time, as we try and add new features. Use with caution.
59 As much as possible, we try to keep it up to date, with example pillars to help you deploy Arvados.
61 For those familiar with Saltstack, the process to get it deployed is similar to any other formula:
63 1. Fork/copy the formula to your Salt master host.
64 2. Edit the Arvados, nginx, postgres, locale and docker pillars to match your desired configuration.
65 3. Run a @state.apply@ to get it deployed.
67 h2(#final_steps). DNS configuration
69 After the setup is done, you need to set up your DNS to be able to access the cluster.
71 The simplest way to do this is to edit your @/etc/hosts@ file (as root):
74 <pre><code>export CLUSTER="arva2"
75 export DOMAIN="arv.local"
76 export HOST_IP="127.0.0.2" # This is valid either if installing in your computer directly
77 # or in a Vagrant VM. If you're installing it on a remote host
78 # just change the IP to match that of the host.
79 echo "${HOST_IP} api keep keep0 collections download ws workbench workbench2 ${CLUSTER}.${DOMAIN} api.${CLUSTER}.${DOMAIN} keep.${CLUSTER}.${DOMAIN} keep0.${CLUSTER}.${DOMAIN} collections.${CLUSTER}.${DOMAIN} download.${CLUSTER}.${DOMAIN} ws.${CLUSTER}.${DOMAIN} workbench.${CLUSTER}.${DOMAIN} workbench2.${CLUSTER}.${DOMAIN}" >> /etc/hosts
83 h2(#initial_user). Initial user and login
85 At this point you should be able to log into the Arvados cluster.
87 If you did not change the defaults, the initial URL will be:
89 * https://workbench.arva2.arv.local
91 or, in general, the url format will be:
93 * https://workbench.@<cluster>.<domain>@
95 By default, the provision script creates an initial user for testing purposes. This user is configured as administrator of the newly created cluster.
97 Assuming you didn't change the defaults, the initial credentials are:
100 * Password: 'password'
101 * Email: 'admin@arva2.arv.local'