Revise docs to use keystoneclient.middleware.auth_token

Change-Id: Ic6caf991cb3eda359658ea679b0fd2f75180c2a9
V2, V3 token intermix for unscoped tokens (bug 1156913)

Make sure we check for tenant_ref before referencing it.

Change-Id: If7918c0a9b2e99f8555e902e89166c6542105209
Merge "V2, V3 token intermix for unscoped tokens (bug 1156913)"
Merge "Revise docs to use keystoneclient.middleware.auth_token"
Fix live ldap tests

Clean up clear_live_database so that all fixture data is removed. Make sure we
use the configured trees for each ldap object in tests. Ensure all live tests
pass or are skipped where appropriate.

Fixes: bug #1154277

Change-Id: I2eb4efe78e2c9d2a18bce339765b3ab5d20ac8f5