blob: ce7007391d2d2bc618f41d430bc529dad3f1dad2 [file] [log] [blame]
Dean Troyer38e38fb2014-01-10 12:05:51 -06001# Sample ``local.conf`` for user-configurable variables in ``stack.sh``
Dean Troyerf5633dd2012-03-28 11:21:40 -05002
Dean Troyerdc97cb72015-03-28 08:20:50 -05003# NOTE: Copy this file to the root DevStack directory for it to work properly.
Dean Troyerf5633dd2012-03-28 11:21:40 -05004
Baohua Yang82450a52015-03-05 17:14:06 +08005# ``local.conf`` is a user-maintained settings file that is sourced from ``stackrc``.
Dean Troyer5547baa2012-08-31 10:55:36 -05006# This gives it the ability to override any variables set in ``stackrc``.
Dean Troyerf5633dd2012-03-28 11:21:40 -05007# Also, most of the settings in ``stack.sh`` are written to only be set if no
Dean Troyer38e38fb2014-01-10 12:05:51 -06008# value has already been set; this lets ``local.conf`` effectively override the
Dean Troyerf5633dd2012-03-28 11:21:40 -05009# default values.
10
11# This is a collection of some of the settings we have found to be useful
12# in our DevStack development environments. Additional settings are described
Dean Troyer38e38fb2014-01-10 12:05:51 -060013# in http://devstack.org/local.conf.html
Dean Troyerf5633dd2012-03-28 11:21:40 -050014# These should be considered as samples and are unsupported DevStack code.
15
Dean Troyer38e38fb2014-01-10 12:05:51 -060016# The ``localrc`` section replaces the old ``localrc`` configuration file.
17# Note that if ``localrc`` is present it will be used in favor of this section.
18[[local|localrc]]
Dean Troyerf5633dd2012-03-28 11:21:40 -050019
20# Minimal Contents
21# ----------------
22
23# While ``stack.sh`` is happy to run without ``localrc``, devlife is better when
24# there are a few minimal variables set:
25
Georges Dubus5753eb82014-07-22 09:45:03 +000026# If the ``SERVICE_TOKEN`` and ``*_PASSWORD`` variables are not set
27# here you will be prompted to enter values for them by ``stack.sh``
28# and they will be added to ``local.conf``.
29SERVICE_TOKEN=azertytoken
Dean Troyerf5633dd2012-03-28 11:21:40 -050030ADMIN_PASSWORD=nomoresecrete
31MYSQL_PASSWORD=stackdb
32RABBIT_PASSWORD=stackqueue
33SERVICE_PASSWORD=$ADMIN_PASSWORD
34
Brian Haley180f5eb2015-06-16 13:14:31 -040035# ``HOST_IP`` and ``HOST_IPV6`` should be set manually for best results if
36# the NIC configuration of the host is unusual, i.e. ``eth1`` has the default
37# route but ``eth0`` is the public interface. They are auto-detected in
38# ``stack.sh`` but often is indeterminate on later runs due to the IP moving
39# from an Ethernet interface to a bridge on the host. Setting it here also
40# makes it available for ``openrc`` to include when setting ``OS_AUTH_URL``.
41# Neither is set by default.
Dean Troyer5547baa2012-08-31 10:55:36 -050042#HOST_IP=w.x.y.z
Brian Haley180f5eb2015-06-16 13:14:31 -040043#HOST_IPV6=2001:db8::7
Dean Troyerf5633dd2012-03-28 11:21:40 -050044
45
Dean Troyer5547baa2012-08-31 10:55:36 -050046# Logging
47# -------
Dean Troyerf5633dd2012-03-28 11:21:40 -050048
Dean Troyer5547baa2012-08-31 10:55:36 -050049# By default ``stack.sh`` output only goes to the terminal where it runs. It can
50# be configured to additionally log to a file by setting ``LOGFILE`` to the full
51# path of the destination log file. A timestamp will be appended to the given name.
52LOGFILE=$DEST/logs/stack.sh.log
53
54# Old log files are automatically removed after 7 days to keep things neat. Change
55# the number of days by setting ``LOGDAYS``.
56LOGDAYS=2
57
58# Nova logs will be colorized if ``SYSLOG`` is not set; turn this off by setting
59# ``LOG_COLOR`` false.
60#LOG_COLOR=False
Dean Troyerf5633dd2012-03-28 11:21:40 -050061
62
63# Using milestone-proposed branches
64# ---------------------------------
65
66# Uncomment these to grab the milestone-proposed branches from the repos:
Dean Troyer5547baa2012-08-31 10:55:36 -050067#CINDER_BRANCH=milestone-proposed
Dean Troyerf5633dd2012-03-28 11:21:40 -050068#GLANCE_BRANCH=milestone-proposed
69#HORIZON_BRANCH=milestone-proposed
70#KEYSTONE_BRANCH=milestone-proposed
71#KEYSTONECLIENT_BRANCH=milestone-proposed
72#NOVA_BRANCH=milestone-proposed
73#NOVACLIENT_BRANCH=milestone-proposed
Mark McClainb05c8762013-07-06 23:29:39 -040074#NEUTRON_BRANCH=milestone-proposed
Dean Troyerf5633dd2012-03-28 11:21:40 -050075#SWIFT_BRANCH=milestone-proposed
76
77
78# Swift
79# -----
80
81# Swift is now used as the back-end for the S3-like object store. If Nova's
82# objectstore (``n-obj`` in ``ENABLED_SERVICES``) is enabled, it will NOT
83# run if Swift is enabled. Setting the hash value is required and you will
84# be prompted for it if Swift is enabled so just set it to something already:
85SWIFT_HASH=66a3d6b56c1f479c8b4e70ab5c2000f5
86
87# For development purposes the default of 3 replicas is usually not required.
88# Set this to 1 to save some resources:
89SWIFT_REPLICAS=1
90
Florent Flamentd5644f82013-10-11 15:39:09 +020091# The data for Swift is stored by default in (``$DEST/data/swift``),
92# or (``$DATA_DIR/swift``) if ``DATA_DIR`` has been set, and can be
93# moved by setting ``SWIFT_DATA_DIR``. The directory will be created
Dean Troyerf5633dd2012-03-28 11:21:40 -050094# if it does not exist.
95SWIFT_DATA_DIR=$DEST/data
Emily Hugenbruchfb3ce0b2014-11-21 22:15:08 +000096
97# Tempest
98# -------
99
100# Install the tempest test suite
Jordan Pittier1331a822015-03-16 10:27:47 +0100101enable_service tempest