| Dean Troyer | f5633dd | 2012-03-28 11:21:40 -0500 | [diff] [blame] | 1 | # Sample ``localrc`` for user-configurable variables in ``stack.sh`` | 
 | 2 |  | 
| Dean Troyer | 5547baa | 2012-08-31 10:55:36 -0500 | [diff] [blame] | 3 | # NOTE: Copy this file to the root ``devstack`` directory for it to | 
 | 4 | # work properly. | 
| Dean Troyer | f5633dd | 2012-03-28 11:21:40 -0500 | [diff] [blame] | 5 |  | 
| Dean Troyer | 5547baa | 2012-08-31 10:55:36 -0500 | [diff] [blame] | 6 | # ``localrc`` is a user-maintained setings file that is sourced from ``stackrc``. | 
 | 7 | # This gives it the ability to override any variables set in ``stackrc``. | 
| Dean Troyer | f5633dd | 2012-03-28 11:21:40 -0500 | [diff] [blame] | 8 | # Also, most of the settings in ``stack.sh`` are written to only be set if no | 
 | 9 | # value has already been set; this lets ``localrc`` effectively override the | 
 | 10 | # default values. | 
 | 11 |  | 
 | 12 | # This is a collection of some of the settings we have found to be useful | 
 | 13 | # in our DevStack development environments. Additional settings are described | 
 | 14 | # in http://devstack.org/localrc.html | 
 | 15 | # These should be considered as samples and are unsupported DevStack code. | 
 | 16 |  | 
 | 17 |  | 
 | 18 | # Minimal Contents | 
 | 19 | # ---------------- | 
 | 20 |  | 
 | 21 | # While ``stack.sh`` is happy to run without ``localrc``, devlife is better when | 
 | 22 | # there are a few minimal variables set: | 
 | 23 |  | 
 | 24 | # If the ``*_PASSWORD`` variables are not set here you will be prompted to enter | 
| Dean Troyer | 5547baa | 2012-08-31 10:55:36 -0500 | [diff] [blame] | 25 | # values for them by ``stack.sh`` and they will be added to ``localrc``. | 
| Dean Troyer | f5633dd | 2012-03-28 11:21:40 -0500 | [diff] [blame] | 26 | ADMIN_PASSWORD=nomoresecrete | 
 | 27 | MYSQL_PASSWORD=stackdb | 
 | 28 | RABBIT_PASSWORD=stackqueue | 
 | 29 | SERVICE_PASSWORD=$ADMIN_PASSWORD | 
 | 30 |  | 
| Dean Troyer | 5547baa | 2012-08-31 10:55:36 -0500 | [diff] [blame] | 31 | # ``HOST_IP`` should be set manually for best results if the NIC configuration | 
 | 32 | # of the host is unusual, i.e. ``eth1`` has the default route but ``eth0`` is the | 
 | 33 | # public interface.  It is auto-detected in ``stack.sh`` but often is indeterminate | 
 | 34 | # on later runs due to the IP moving from an Ethernet interface to a bridge on | 
 | 35 | # the host. Setting it here also makes it available for ``openrc`` to include | 
 | 36 | # when setting ``OS_AUTH_URL``. | 
| Dean Troyer | f5633dd | 2012-03-28 11:21:40 -0500 | [diff] [blame] | 37 | # ``HOST_IP`` is not set by default. | 
| Dean Troyer | 5547baa | 2012-08-31 10:55:36 -0500 | [diff] [blame] | 38 | #HOST_IP=w.x.y.z | 
| Dean Troyer | f5633dd | 2012-03-28 11:21:40 -0500 | [diff] [blame] | 39 |  | 
 | 40 |  | 
| Dean Troyer | 5547baa | 2012-08-31 10:55:36 -0500 | [diff] [blame] | 41 | # Logging | 
 | 42 | # ------- | 
| Dean Troyer | f5633dd | 2012-03-28 11:21:40 -0500 | [diff] [blame] | 43 |  | 
| Dean Troyer | 5547baa | 2012-08-31 10:55:36 -0500 | [diff] [blame] | 44 | # By default ``stack.sh`` output only goes to the terminal where it runs.  It can | 
 | 45 | # be configured to additionally log to a file by setting ``LOGFILE`` to the full | 
 | 46 | # path of the destination log file.  A timestamp will be appended to the given name. | 
 | 47 | LOGFILE=$DEST/logs/stack.sh.log | 
 | 48 |  | 
 | 49 | # Old log files are automatically removed after 7 days to keep things neat.  Change | 
 | 50 | # the number of days by setting ``LOGDAYS``. | 
 | 51 | LOGDAYS=2 | 
 | 52 |  | 
 | 53 | # Nova logs will be colorized if ``SYSLOG`` is not set; turn this off by setting | 
 | 54 | # ``LOG_COLOR`` false. | 
 | 55 | #LOG_COLOR=False | 
| Dean Troyer | f5633dd | 2012-03-28 11:21:40 -0500 | [diff] [blame] | 56 |  | 
 | 57 |  | 
 | 58 | # Using milestone-proposed branches | 
 | 59 | # --------------------------------- | 
 | 60 |  | 
 | 61 | # Uncomment these to grab the milestone-proposed branches from the repos: | 
| Dean Troyer | 5547baa | 2012-08-31 10:55:36 -0500 | [diff] [blame] | 62 | #CINDER_BRANCH=milestone-proposed | 
| Dean Troyer | f5633dd | 2012-03-28 11:21:40 -0500 | [diff] [blame] | 63 | #GLANCE_BRANCH=milestone-proposed | 
 | 64 | #HORIZON_BRANCH=milestone-proposed | 
 | 65 | #KEYSTONE_BRANCH=milestone-proposed | 
 | 66 | #KEYSTONECLIENT_BRANCH=milestone-proposed | 
 | 67 | #NOVA_BRANCH=milestone-proposed | 
 | 68 | #NOVACLIENT_BRANCH=milestone-proposed | 
| Mark McClain | b05c876 | 2013-07-06 23:29:39 -0400 | [diff] [blame] | 69 | #NEUTRON_BRANCH=milestone-proposed | 
| Dean Troyer | f5633dd | 2012-03-28 11:21:40 -0500 | [diff] [blame] | 70 | #SWIFT_BRANCH=milestone-proposed | 
 | 71 |  | 
 | 72 |  | 
 | 73 | # Swift | 
 | 74 | # ----- | 
 | 75 |  | 
 | 76 | # Swift is now used as the back-end for the S3-like object store. If Nova's | 
 | 77 | # objectstore (``n-obj`` in ``ENABLED_SERVICES``) is enabled, it will NOT | 
 | 78 | # run if Swift is enabled. Setting the hash value is required and you will | 
 | 79 | # be prompted for it if Swift is enabled so just set it to something already: | 
 | 80 | SWIFT_HASH=66a3d6b56c1f479c8b4e70ab5c2000f5 | 
 | 81 |  | 
 | 82 | # For development purposes the default of 3 replicas is usually not required. | 
 | 83 | # Set this to 1 to save some resources: | 
 | 84 | SWIFT_REPLICAS=1 | 
 | 85 |  | 
| Florent Flament | d5644f8 | 2013-10-11 15:39:09 +0200 | [diff] [blame] | 86 | # The data for Swift is stored by default in (``$DEST/data/swift``), | 
 | 87 | # or (``$DATA_DIR/swift``) if ``DATA_DIR`` has been set, and can be | 
 | 88 | # moved by setting ``SWIFT_DATA_DIR``. The directory will be created | 
| Dean Troyer | f5633dd | 2012-03-28 11:21:40 -0500 | [diff] [blame] | 89 | # if it does not exist. | 
 | 90 | SWIFT_DATA_DIR=$DEST/data |