Cleanup sample config

The sample config file had some options that were set rather than
documenting the defaults.

Change-Id: I53abba01b3683f3ad9c81d824ccf0b63c016dc87
Do not call deprecated functions

When getting a token using v3 API, a deprecated warning was logged
because the process wound up calling identity_api.get_domain.

The server shouldn't be using deprecated APIs.

Change-Id: I5b6e1aad6db9677abee04ff88c739722f358e386
Update db.sqlalchemy.session from oslo-incubator 018138

Keystone's db.sqlalchemy.session module was out of date. This
updates Keystone's version to oslo-incubator hash
01813871e2f6b9b01783f7da88998d9bc97d4a8c .

 $ python update.py --nodeps --base keystone \
    --dest-dir ../keystone --modules db.sqlalchemy.session

Among other changes, the newer db.sqlalchemy.session has fixes to
the docstring so there are fewer warnings issued during doc build
and rendering issues.

Change-Id: I70f6727adeb98142f8a9a1cea04c71ade27dfaba
Remove tox locale overrides

* tox.ini: The LANG, LANGUAGE and LC_ALL environment overrides were
introduced originally during the testr migration in an attempt to be
conservative about the possibility that locale settings in the
calling environment could cause consistency problems for test runs.
In actuality, this should be unnecessary and any place where it does
cause issues ought to be considered an actual bug. Also, having
these in the configuration actively causes older pip to have
problems with non-ASCII content in some package metadata files under
Python 3, so drop it now.

Change-Id: Icf41e4e7a869375e9be710f42c7dd05f9daf100b
Closes-Bug: #1277495
Doc - Detailing  objects' attributes available for policy.json

Adding to documentation ("Configuring Keystone" part) details about
target objects attributes, that are available to customize access
policies in the policy.json.

DocImpact
Change-Id: I3799942230062f4feaa9faf59097bf0ef8bc139b
Fixes a misspelling

Change-Id: Iaba5d7dd783a881010c76e83cd356ca084050bc0
Allow specifying region ID when creating region

The documentation for the regions/ resource in the v3 API
specified that the user should be able to create a new region
using PUT /regions/{region_id}, however the original regions
patch forgot to include this functionality.

This patch adds that ability, with a custom mapper route to
keystone.catalog.controllers.RegionsV3.create_region_with_id.
When implementing, I also noticed an issue with an unused
region_id parameter in the driver's create_region() call. This
patch cleans up that unused parameter and ensures the region_ref
parameter always contains an ID key.

Change-Id: I36d14d4136efc165528282f1357a74291924502e
Closes-Bug: #1271235
Merge "Do not call deprecated functions"
Merge "Cleanup sample config"
Merge "Remove tox locale overrides"
Merge "Update db.sqlalchemy.session from oslo-incubator 018138"
Merge "Allow specifying region ID when creating region"
Merge "Fixes a misspelling"
Merge "Doc - Detailing  objects' attributes available for policy.json"