doc/install/config.html.textile.liquid

   1 ---
   2 layout: default
   3 navsection: installguide
   4 title: Configuration files
   5 ...
   6 {% comment %}
   7 Copyright (C) The Arvados Authors. All rights reserved.
   8
   9 SPDX-License-Identifier: CC-BY-SA-3.0
  10 {% endcomment %}
  11
  12 h2. Arados /etc/arvados/config.yml
  13
  14 The configuration file is normally found at @/etc/arvados/config.yml@ and will be referred to as just @config.yml@ in this guide.  This configuration file should be kept in sync across every node in the cluster, except compute nodes (which usually do not require config.yml).  We recommend using a devops configuration management tool such as "Puppet":https://puppet.com/open-source/ to synchronize the config file.
  15
  16 h3. Syntax
  17
  18 The configuration file is in "YAML":https://yaml.org/ format.  This is a block syntax where indentation is significant (similar to Python).  By convention we use two space indent.  The first line of the file is always "Clusters:", underneath it at the first indent level is the Cluster ID.  All the actual cluster configuration come under the Cluster ID.  This means all configuration parameters are indented by at least two levels (four spaces).  Comments start with @#@ .
  19
  20 We recommend a YAML-syntax plugin for your favorite text editor, such as @yaml-mode@ (Emacs) or @yaml-vim@.
  21
  22 Example file:
  23
  24 <pre>
  25 Clusters:                         # Clusters block, everything else is listed under this
  26   abcde:                          # Cluster ID, everything under it is configuration for this cluster
  27     ExampleConfigKey: "fghijk"    # An example configuration key
  28     ExampleConfigGroup:           # A group of keys
  29       ExampleDurationConfig: 12s  # Example duration
  30       ExampleSizeConfig: 99KiB    # Example with a size suffix
  31 </pre>
  32
  33 Each configuration group may only appear once.  When a configuration key is within a config group, it will be written with the group name leading, for example @ExampleConfigGroup.ExampleSizeConfig@.
  34
  35 Duration suffixes are s=seconds, m=minutes or h=hours.
  36
  37 Size suffixes are K=10 ^3^, Ki=2 ^10^ , M=10 ^6^, Mi=2 ^20^, G=10 ^9^, Gi=2 ^30^, T=10 ^12^, Ti=2 ^40^, P=10 ^15^, Pi=2 ^50^, E=10 ^18^, Ei=2 ^60^.  You can optionally follow with a "B" (eg "MB" or "MiB") for readability (it does not affect the units.)
  38
  39 h3(#empty). Create empty configuration file
  40
  41 <pre>
  42 export ClusterID=xxxxx
  43 mkdir -p /etc/arvados
  44 cat > /etc/arvados/config.yml <<EOF
  45 Clusters:
  46   ${ClusterID}:
  47 EOF
  48 </pre>
  49
  50 h2. Nginx configuration
  51
  52 This guide will also cover setting up "Nginx":https://www.nginx.com/ as a reverse proxy for Arvados services.  Nginx performs two main functions: TLS termination and virtual host routing.  The virtual host configuration for each component will go in its own file in @/etc/nginx/conf.d/@.