localrc is a user-maintained setings file that is
sourced at the end of
stackrc. This gives it the ability
to override any variables set in
stackrc. Also, most of
the settings in
stack.sh are written to only be set if
no value has already been set; this lets anything set in
remain in effect.
localrc, devlife is better when there are a few minimal variables set.
ADMIN_PASSWORD=nomoresecrete MYSQL_PASSWORD=stackdb RABBIT_PASSWORD=stackqueue SERVICE_PASSWORD=$ADMIN_PASSWORD HOST_IP=w.x.y.zIf the
*_PASSWORDvariables are not set here you will be prompted to enter values for them by
HOST_IPis normally detected on the first run of
stack.shbut often is indeterminate on later runs due to the IP being moved from an Ethernet integace to a bridge on the host. Setting it here also makes it available for
HOST_IPis not set by default.
DESTvariable. By setting it early in localrc you can reference it in later variables. The default value is
/opt/stack. It can be useful to set it even though it is not changed from the default value.
stack.shoutput is only to the console where is runs. It can be made to to a file in addition to the console by setting
LOGFILEto the fully-qualified name of the destination log file. A timestamp will be appended to the given filename.
LOGFILEis not set by default.
LOGFILE=stack.sh.logOld log files are cleaned automatically if
LOGDAYSis set to the number of days of old log files to keep.
LOGDAYSdefaults to 7.
LOGDAYS=1The Nova logs will be colorized by default (if
SYSLOGis not set below); this can be turned off by setting
screenwhich is useful for watching log and debug output. However, in automated testing the interactive
screensessions may not be available after the fact; setting
SCREEN_LOGDIRenables logging of the
screensessions in the specified diretory. There will be one file per
screensession named for the session name and a timestamp.
SCREEN_LOGDIRis not set by default.
SCREEN_LOGDIR=$DEST/logs/screenNote the use of
DESTto locate the main install directory; this is why we set it in
True. If the destination log host is not localhost
SYSLOG_PORTcan be used to direct the message stream to the log host. By default
SYSLOGis set to
SYSLOG_HOSTis set to
SYSLOG_PORTis set to
SYSLOG=True SYSLOG_HOST=$HOST_IP SYSLOG_PORT=516
stack.shonly clones the project repos if they do not exist in
stack.shwill freshen each repo on each run if
RECLONEis set to
yes. This avoids having to remove and re-download all of the repo objects from GitHub. By default,
RECLONEis not set.
ENABLED_SERVICES) is enabled, it will NOT run if Swift is enabled. Enable Swift by adding it to
ENABLED_SERVICES+=,swiftSetting Swift's hash value is required and you will be prompted for it if Swift is enabled so just set it to something already:
SWIFT_HASH=66a3d6b56c1f479c8b4e70ab5c2000f5For development purposes the default of 3 replicas is usually not required. Set this to 1 to save some resources:
SWIFT_REPLICAS=1The data for Swift is stored in the source tree by default (
$DEST/swift/data) and can be moved by setting
SWIFT_DATA_DIR. The directory will be created if it does not exist.
templateservice catalog backend. This backend does not support the
endpoint-*commands of the
keystoneCLI. To do so requires the
sqlbackend be enabled:
KEYSTONE_CATALOG_BACKEND=sqlDevStack's default configuration in
sqlmode is set in
disable_service c-api c-sch c-vol cinder enable_service n-volThe volume group used to hold the volumes is set by
VOLUME_GROUP, the logical volume name prefix is set with
VOLUME_NAME_PREFIXand the size of the volume backing file is set with
VOLUME_BACKING_FILE_SIZE. The default values are shown below.
VOLUME_GROUP="stack-volumes" VOLUME_NAME_PREFIX="volume-" VOLUME_BACKING_FILE_SIZE=5130M
localrcfile for each host. The master is the same as a single host installation with code>MULTI_HOST set to
True. The slaves have fewer services enabled and a couple of host variables pointing to the master. By default
is set to
MasterMULTI_HOST=TrueSlaveMYSQL_HOST=w.x.y.z RABBIT_HOST=w.x.y.z GLANCE_HOSTPORT=w.x.y.z:9292 ENABLED_SERVICES=n-vol,n-cpu,n-net,n-api
API_RATE_LIMIT=False. By default
API_RATE_LIMITis set to
© Openstack Foundation 2011-2013 — this is not an official OpenStack project...