Do the link cleanups and update a handful of things that were out of date. Change-Id: I758027bf3577c66cfb13df963516823a5c247080
		
			
				
	
	
		
			67 lines
		
	
	
		
			2.2 KiB
		
	
	
	
		
			ReStructuredText
		
	
	
	
	
	
			
		
		
	
	
			67 lines
		
	
	
		
			2.2 KiB
		
	
	
	
		
			ReStructuredText
		
	
	
	
	
	
===========================
 | 
						|
stackrc - DevStack Settings
 | 
						|
===========================
 | 
						|
 | 
						|
``stackrc`` is the primary configuration file for DevStack. It contains
 | 
						|
all of the settings that control the services started and the
 | 
						|
repositories used to download the source for those services. ``stackrc``
 | 
						|
sources the ``localrc`` section of ``local.conf`` to perform the default
 | 
						|
overrides.
 | 
						|
 | 
						|
DATABASE\_TYPE
 | 
						|
    Select the database backend to use. The default is ``mysql``,
 | 
						|
    ``postgresql`` is also available.
 | 
						|
ENABLED\_SERVICES
 | 
						|
    Specify which services to launch. These generally correspond to
 | 
						|
    screen tabs. The default includes: Glance (API and Registry),
 | 
						|
    Keystone, Nova (API, Certificate, Object Store, Compute, Network,
 | 
						|
    Scheduler, Certificate Authentication), Cinder
 | 
						|
    (Scheduler, API, Volume), Horizon, MySQL, RabbitMQ, Tempest.
 | 
						|
 | 
						|
    ::
 | 
						|
 | 
						|
        ENABLED_SERVICES=g-api,g-reg,key,n-api,n-crt,n-obj,n-cpu,n-net,n-cond,c-sch,c-api,c-vol,n-sch,n-cauth,horizon,rabbit,tempest,$DATABASE_TYPE
 | 
						|
 | 
						|
    Other services that are not enabled by default can be enabled in
 | 
						|
    ``localrc``. For example, to add Swift, use the following service
 | 
						|
    names:
 | 
						|
 | 
						|
    ::
 | 
						|
 | 
						|
        enable_service s-proxy s-object s-container s-account
 | 
						|
 | 
						|
    A service can similarly be disabled:
 | 
						|
 | 
						|
    ::
 | 
						|
 | 
						|
        disable_service horizon
 | 
						|
 | 
						|
Service Repos
 | 
						|
    The Git repositories used to check out the source for each service
 | 
						|
    are controlled by a pair of variables set for each service.
 | 
						|
    ``*_REPO`` points to the repository and ``*_BRANCH`` selects which
 | 
						|
    branch to check out. These may be overridden in ``local.conf`` to
 | 
						|
    pull source from a different repo for testing, such as a Gerrit
 | 
						|
    branch proposal. ``GIT_BASE`` points to the primary repository
 | 
						|
    server.
 | 
						|
 | 
						|
    ::
 | 
						|
 | 
						|
        NOVA_REPO=$GIT_BASE/openstack/nova.git
 | 
						|
        NOVA_BRANCH=master
 | 
						|
 | 
						|
    To pull a branch directly from Gerrit, get the repo and branch from
 | 
						|
    the Gerrit review page:
 | 
						|
 | 
						|
    ::
 | 
						|
 | 
						|
        git fetch https://review.openstack.org/p/openstack/nova refs/changes/50/5050/1 && git checkout FETCH_HEAD
 | 
						|
 | 
						|
    The repo is the stanza following ``fetch`` and the branch is the
 | 
						|
    stanza following that:
 | 
						|
 | 
						|
    ::
 | 
						|
 | 
						|
        NOVA_REPO=https://review.openstack.org/p/openstack/nova
 | 
						|
        NOVA_BRANCH=refs/changes/50/5050/1
 |