Dean Troyer | f5633dd | 2012-03-28 11:21:40 -0500 | [diff] [blame] | 1 | # 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``. |
| 25 | ADMIN_PASSWORD=nomoresecrete |
| 26 | MYSQL_PASSWORD=stackdb |
| 27 | RABBIT_PASSWORD=stackqueue |
| 28 | SERVICE_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. |
| 35 | HOST_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. |
| 45 | DEST=/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: |
| 68 | SWIFT_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: |
| 72 | SWIFT_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. |
| 77 | SWIFT_DATA_DIR=$DEST/data |