blob: 4fb093dc16dda78ea946182bfdd1cc37af5e4c29 [file] [log] [blame]
Dean Troyerf5633dd2012-03-28 11:21:40 -05001# Sample ``localrc`` for user-configurable variables in ``stack.sh``
2
3# NOTE: Copy this file to the root ``devstack`` directory for it to work properly.
4
5# ``localrc`` is a user-maintained setings file that is sourced at the end of
6# ``stackrc``. This gives it the ability to override any variables set in ``stackrc``.
7# Also, most of the settings in ``stack.sh`` are written to only be set if no
8# value has already been set; this lets ``localrc`` effectively override the
9# 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
13# in http://devstack.org/localrc.html
14# These should be considered as samples and are unsupported DevStack code.
15
16
17# Minimal Contents
18# ----------------
19
20# While ``stack.sh`` is happy to run without ``localrc``, devlife is better when
21# there are a few minimal variables set:
22
23# If the ``*_PASSWORD`` variables are not set here you will be prompted to enter
24# values for them by ``stack.sh``.
25ADMIN_PASSWORD=nomoresecrete
26MYSQL_PASSWORD=stackdb
27RABBIT_PASSWORD=stackqueue
28SERVICE_PASSWORD=$ADMIN_PASSWORD
29
30# HOST_IP should be set manually for best results. It is auto-detected during the
31# first run of ``stack.sh`` but often is indeterminate on later runs due to the IP
32# being moved from an Ethernet interface to a bridge on the host. Setting it here
33# also makes it available for ``openrc`` to include when setting ``OS_AUTH_URL``.
34# ``HOST_IP`` is not set by default.
35HOST_IP=w.x.y.z
36
37
38# Set DevStack Install Directory
39# ------------------------------
40
41# The DevStack install directory is set by the ``DEST`` variable. By setting it
42# early in ``localrc`` you can reference it in later variables. The default value
43# is ``/opt/stack``. It can be useful to set it even though it is not changed from
44# the default value.
45DEST=/opt/stack
46
47
48# Using milestone-proposed branches
49# ---------------------------------
50
51# Uncomment these to grab the milestone-proposed branches from the repos:
52#GLANCE_BRANCH=milestone-proposed
53#HORIZON_BRANCH=milestone-proposed
54#KEYSTONE_BRANCH=milestone-proposed
55#KEYSTONECLIENT_BRANCH=milestone-proposed
56#NOVA_BRANCH=milestone-proposed
57#NOVACLIENT_BRANCH=milestone-proposed
58#SWIFT_BRANCH=milestone-proposed
59
60
61# Swift
62# -----
63
64# Swift is now used as the back-end for the S3-like object store. If Nova's
65# objectstore (``n-obj`` in ``ENABLED_SERVICES``) is enabled, it will NOT
66# run if Swift is enabled. Setting the hash value is required and you will
67# be prompted for it if Swift is enabled so just set it to something already:
68SWIFT_HASH=66a3d6b56c1f479c8b4e70ab5c2000f5
69
70# For development purposes the default of 3 replicas is usually not required.
71# Set this to 1 to save some resources:
72SWIFT_REPLICAS=1
73
74# The data for Swift is stored in the source tree by default (``$DEST/swift/data``)
75# and can be moved by setting ``SWIFT_DATA_DIR``. The directory will be created
76# if it does not exist.
77SWIFT_DATA_DIR=$DEST/data