local.conf is a user-maintained setings file that is
stackrc. It contains a section that replaces
localrc file. See
the description of local.conf for
more details about the mechanics of the file. Here we are concerned
localrc section of
localrcsection, 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 the
localrcsection 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
enable_service 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
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
localrcsection for each host. The master is the same as a single host installation with
True. The slaves have fewer services enabled and a couple of host variables pointing to the master. By default
MULTI_HOSTis set to
MYSQL_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