OpenStack DevStack Configuration localrc local.conf Tutorial
9 likes18,923 views
This document provides instructions on configuring DevStack using the local.conf file. It describes how local.conf has replaced the deprecated localrc file, and discusses settings that can be configured in local.conf such as passwords, network ranges, logging options, and enabling reinstallation of OpenStack components each time stack.sh is run. Examples of local.conf configuration are provided.
![local.conf
A specific meta-section local|localrc is used to
provide a default localrc file.
This allows all custom settings for DevStack to be
contained in a single file.If localrc exists it will be
used instead to preserve backward-compatibility.
Example:
[[local|localrc]]
ADMIN_PASSWORD=secrete
DATABASE_PASSWORD=secrete](https://image.slidesharecdn.com/openstackdevstackconfigurationlocalrclocal-150204134836-conversion-gate02/85/OpenStack-DevStack-Configuration-localrc-local-conf-Tutorial-8-320.jpg)
![local.conf Configuration
1) pre-set the passwords to prevent interactive
prompts
Example:
[[local|localrc]]
ADMIN_PASSWORD=secrete
DATABASE_PASSWORD=secrete
RABBIT_PASSWORD=secrete
SERVICE_PASSWORD=secrete
SERVICE_TOKEN=tokentoken
If the *_PASSWORD variables are not set here you will be prompted to enter values for
them by stack.sh.](https://image.slidesharecdn.com/openstackdevstackconfigurationlocalrclocal-150204134836-conversion-gate02/85/OpenStack-DevStack-Configuration-localrc-local-conf-Tutorial-9-320.jpg)
![local.conf Configuration
2) Move network ranges away from the local
network
Example:
[[local|localrc]]
FIXED_RANGE=172.31.1.0/24
FLOATING_RANGE=192.168.56.0/25
The network ranges must not overlap with any networks in use on the host.](https://image.slidesharecdn.com/openstackdevstackconfigurationlocalrclocal-150204134836-conversion-gate02/85/OpenStack-DevStack-Configuration-localrc-local-conf-Tutorial-10-320.jpg)
![local.conf Configuration
3) Set the host IP if detection is unreliable
Example:
[[local|localrc]]
HOST_IP=192.168.56.104
HOST_IP is normally detected on the first run of stack.sh but often is indeterminate on
later runs due to the IP being moved from an Ethernet interface to a bridge on the host.
Setting it here also makes it available for openrc to set OS_AUTH_URL. HOST_IP is not
set by default.](https://image.slidesharecdn.com/openstackdevstackconfigurationlocalrclocal-150204134836-conversion-gate02/85/OpenStack-DevStack-Configuration-localrc-local-conf-Tutorial-11-320.jpg)
![local.conf Configuration
4) Change Installation Directory
Example:
[[local|localrc]]
DEST=/opt/stack
Default: “DEST=/opt/stack”](https://image.slidesharecdn.com/openstackdevstackconfigurationlocalrclocal-150204134836-conversion-gate02/85/OpenStack-DevStack-Configuration-localrc-local-conf-Tutorial-12-320.jpg)
![local.conf Configuration
5) Specify the libraries to be installed from Git
Example:
[[local|localrc]]
LIBS_FROM_GIT=python-keystoneclient,oslo.config
Default: LIBS_FROM_GIT=”“
By default devstack installs OpenStack server components from git, however it installs
client libraries from released versions on pypi. This is appropriate if you are working on
server development, but if you want to see how an unreleased version of the client affects
the system you can have devstack install it from upstream, or from local git trees.
Multiple libraries can be specified as a comma separated list.](https://image.slidesharecdn.com/openstackdevstackconfigurationlocalrclocal-150204134836-conversion-gate02/85/OpenStack-DevStack-Configuration-localrc-local-conf-Tutorial-13-320.jpg)
![local.conf Configuration
6) Enable Logging
Example:
[[local|localrc]]
LOGFILE=$DEST/logs/stack.sh.log
By default stack.sh output is only written to the console where is runs. It can be sent to a
file in addition to the console by setting LOGFILE to the fully-qualified name of the
destination log file. A timestamp will be appended to the given filename for each run of
stack.sh.](https://image.slidesharecdn.com/openstackdevstackconfigurationlocalrclocal-150204134836-conversion-gate02/85/OpenStack-DevStack-Configuration-localrc-local-conf-Tutorial-14-320.jpg)
![local.conf Configuration
7) Enable Syslog
Example:
[[local|localrc]]
SYSLOG=True
SYSLOG_HOST=$HOST_IP
SYSLOG_PORT=516
Logging all services to a single syslog can be convenient. Enable syslogging by setting
SYSLOG to True. If the destination log host is not localhost SYSLOG_HOST and
SYSLOG_PORT can be used to direct the message stream to the log host.](https://image.slidesharecdn.com/openstackdevstackconfigurationlocalrclocal-150204134836-conversion-gate02/85/OpenStack-DevStack-Configuration-localrc-local-conf-Tutorial-15-320.jpg)
![local.conf Configuration
8) A clean installation of OpenStack every time
you run stack.sh
Example:
[[local|localrc]]
RECLONE=yes
By default stack.sh only clones the project repos if they do not exist in $DEST. stack.sh
will freshen each repo on each run if RECLONE is set to yes.](https://image.slidesharecdn.com/openstackdevstackconfigurationlocalrclocal-150204134836-conversion-gate02/85/OpenStack-DevStack-Configuration-localrc-local-conf-Tutorial-16-320.jpg)
![local.conf Configuration
9) Sample local.conf with screen logging
enabled
Example:
[[local|localrc]]
FIXED_RANGE=10.254.1.0/24
NETWORK_GATEWAY=10.254.1.1
FLOATING_RANGE=192.168.56.0/25
LOGFILE=$DEST/logs/stack.sh.log
ADMIN_PASSWORD=secret
DATABASE_PASSWORD=secret
RABBIT_PASSWORD=secret
SERVICE_PASSWORD=secret
SERVICE_TOKEN=tokentoken
HOST_IP=192.168.56.104](https://image.slidesharecdn.com/openstackdevstackconfigurationlocalrclocal-150204134836-conversion-gate02/85/OpenStack-DevStack-Configuration-localrc-local-conf-Tutorial-17-320.jpg)
OpenStack DevStack Configuration localrc local.conf Tutorial
- 1. OpenStack DevStack Configuration Tutorial ● localrc ● local.conf
- 3. localrc localrc is the old file used to configure DevStack. It is deprecated and has been replaced by local.conf. DevStack will continue to use localrc if it is present and ignore the localrc section in local.conf. Remove localrc to switch to using the new file.
- 4. OpenStack Training Videos Play Training Videos https://www.youtube.com/user/sajuptpm/videos
- 6. local.conf local.conf is a user-maintained setings file that is sourced in stackrc. It contains a section that replaces the historical localrc file.
- 7. local.conf local.conf resides in the root DevStack directory like the old localrc file. It is a modified INI format file that introduces a meta-section header to carry additional information regarding the configuration files to be changed. Read More: http://docs.openstack.org/developer/devstack/configu
- 8. local.conf A specific meta-section local|localrc is used to provide a default localrc file. This allows all custom settings for DevStack to be contained in a single file.If localrc exists it will be used instead to preserve backward-compatibility. Example: [[local|localrc]] ADMIN_PASSWORD=secrete DATABASE_PASSWORD=secrete
- 9. local.conf Configuration 1) pre-set the passwords to prevent interactive prompts Example: [[local|localrc]] ADMIN_PASSWORD=secrete DATABASE_PASSWORD=secrete RABBIT_PASSWORD=secrete SERVICE_PASSWORD=secrete SERVICE_TOKEN=tokentoken If the *_PASSWORD variables are not set here you will be prompted to enter values for them by stack.sh.
- 10. local.conf Configuration 2) Move network ranges away from the local network Example: [[local|localrc]] FIXED_RANGE=172.31.1.0/24 FLOATING_RANGE=192.168.56.0/25 The network ranges must not overlap with any networks in use on the host.
- 11. local.conf Configuration 3) Set the host IP if detection is unreliable Example: [[local|localrc]] HOST_IP=192.168.56.104 HOST_IP is normally detected on the first run of stack.sh but often is indeterminate on later runs due to the IP being moved from an Ethernet interface to a bridge on the host. Setting it here also makes it available for openrc to set OS_AUTH_URL. HOST_IP is not set by default.
- 12. local.conf Configuration 4) Change Installation Directory Example: [[local|localrc]] DEST=/opt/stack Default: “DEST=/opt/stack”
- 13. local.conf Configuration 5) Specify the libraries to be installed from Git Example: [[local|localrc]] LIBS_FROM_GIT=python-keystoneclient,oslo.config Default: LIBS_FROM_GIT=”“ By default devstack installs OpenStack server components from git, however it installs client libraries from released versions on pypi. This is appropriate if you are working on server development, but if you want to see how an unreleased version of the client affects the system you can have devstack install it from upstream, or from local git trees. Multiple libraries can be specified as a comma separated list.
- 14. local.conf Configuration 6) Enable Logging Example: [[local|localrc]] LOGFILE=$DEST/logs/stack.sh.log By default stack.sh output is only written to the console where is runs. It can be sent to a file in addition to the console by setting LOGFILE to the fully-qualified name of the destination log file. A timestamp will be appended to the given filename for each run of stack.sh.
- 15. local.conf Configuration 7) Enable Syslog Example: [[local|localrc]] SYSLOG=True SYSLOG_HOST=$HOST_IP SYSLOG_PORT=516 Logging all services to a single syslog can be convenient. Enable syslogging by setting SYSLOG to True. If the destination log host is not localhost SYSLOG_HOST and SYSLOG_PORT can be used to direct the message stream to the log host.
- 16. local.conf Configuration 8) A clean installation of OpenStack every time you run stack.sh Example: [[local|localrc]] RECLONE=yes By default stack.sh only clones the project repos if they do not exist in $DEST. stack.sh will freshen each repo on each run if RECLONE is set to yes.
- 17. local.conf Configuration 9) Sample local.conf with screen logging enabled Example: [[local|localrc]] FIXED_RANGE=10.254.1.0/24 NETWORK_GATEWAY=10.254.1.1 FLOATING_RANGE=192.168.56.0/25 LOGFILE=$DEST/logs/stack.sh.log ADMIN_PASSWORD=secret DATABASE_PASSWORD=secret RABBIT_PASSWORD=secret SERVICE_PASSWORD=secret SERVICE_TOKEN=tokentoken HOST_IP=192.168.56.104
- 18. Thanks ● Email: [email protected] ● Training Videos: https://www.youtube.com/user/sajuptpm/videos ● WebSite: http://fosshelp.blogspot.in ● IRC: saju_m ● Skype: sajuptpm