6.3.3. Viewing District Information

This section describes how to view information about a district on your system. Note that the resulting output is in JSON format.
View all available districts with the oo-admin-ctl-district command, or use the -n option with the district's name to view a single district.

Example 6.5. Viewing All Districts

# oo-admin-ctl-district

{ ...
"uuid"=>"7521a7801686477f8409e74f67b693f4",
...}

Example 6.6. Viewing a Single District

# oo-admin-ctl-district -n small_district
District Representation on the Broker

During district creation, the broker creates a new document in its MongoDB database. Run the following command to view these documents inside of the openshift_broker database, replacing the login credentials from the /etc/openshift/broker.conf file, if needed:

# mongo -u openshift -p password openshift_broker
From the mongo shell, you can perform commands against the broker database. Run the following command to list all of the available collections in the openshift_broker database:
> db.getCollectionNames()
Observe the collections returned, noting the districts collection:
  [ "applications", "auth_user", "cloud_users", "districts", "domains", "locks", "system.indexes", "system.users", "usage", "usage_records" ]
Query the districts collection to verify the creation of your districts. District information is output in JSON format:
> db.districts.find()
Exit the mongo shell using the exit command:
> exit