6.4.5. Additional Region and Zone Tasks


List all available regions with the following command:
# oo-admin-ctl-region -c list
Copy to Clipboard Toggle word wrap
Remove region and zone tags from a node with the following command:
# oo-admin-ctl-district -c unset-region -n district_name -i server_identityoo-admin-ctl-district -c unset-region -n district_name -i server_identityoo-admin-ctl-district -c unset-region -n district_name -i server_identityoo-admin-ctl-district -c unset-region -n district_name -i server_identity
Copy to Clipboard Toggle word wrap
Remove zones from a region with the following command:
# oo-admin-ctl-region -c remove-zone -r region_name -z zone_nameoo-admin-ctl-region -c remove-zone -r region_name -z zone_nameoo-admin-ctl-region -c remove-zone -r region_name -z zone_nameoo-admin-ctl-region -c remove-zone -r region_name -z zone_name
Copy to Clipboard Toggle word wrap
Destroy empty regions with the following command:
# oo-admin-ctl-region -c destroy -r region_nameoo-admin-ctl-region -c destroy -r region_name
Copy to Clipboard Toggle word wrap

Procedure 6.10. To Require New Applications Use Zones:

  1. In the /etc/openshift/plugins.d/openshift-origin-msg-broker-mcollective.conf file on the broker host, set the ZONES_REQUIRE_FOR_APP_CREATE parameter to true to require that new applications only use nodes tagged with a zone. When true, gear placement will fail if there are no zones available with the correct gear profile:
    ZONES_REQUIRE_FOR_APP_CREATE=true
    Copy to Clipboard Toggle word wrap
  2. Restart the broker service:
    # service openshift-broker restart
    Copy to Clipboard Toggle word wrap

Procedure 6.11. To Enforce the Minimum Number of Zones per Gear Group

  1. In the /etc/openshift/plugins.d/openshift-origin-msg-broker-mcollective.conf file on the broker host, set the ZONES_MIN_PER_GEAR_GROUP parameter to the desired minimum number of zones between which gears in application gear groups are distributed:
    ZONES_MIN_PER_GEAR_GROUP=number_of_zones
    Copy to Clipboard Toggle word wrap
  2. Restart the broker service:
    # service openshift-broker restart
    Copy to Clipboard Toggle word wrap
Back to top
Red Hat logoGithubredditYoutubeTwitter

Learn

Try, buy, & sell

Communities

About Red Hat Documentation

We help Red Hat users innovate and achieve their goals with our products and services with content they can trust. Explore our recent updates.

Making open source more inclusive

Red Hat is committed to replacing problematic language in our code, documentation, and web properties. For more details, see the Red Hat Blog.

About Red Hat

We deliver hardened solutions that make it easier for enterprises to work across platforms and environments, from the core datacenter to the network edge.

Theme

© 2025 Red Hat