6.3. Managing Districts

MCollective is responsible for communication between the broker and node hosts. This communication can fail unless the MCollective plug-in on the broker host is configured to enable districts.

The following parameters in the /etc/openshift/plugins.d/openshift-origin-msg-broker-mcollective.conf file on the broker host enable and enforce district use, all of which are set to true by default:

The default value of true for the DISTRICTS_REQUIRE_FOR_APP_CREATE parameter prevents gear placement if no district exists with capacity for the chosen gear profile, therefore preventing the use of node hosts that are outside of districts. Setting the value to false and restarting the openshift-broker service enables immediate use of node hosts without having to understand or implement districts. While this immediate usage may be helpful in an evaluation setting, it is neither desirable nor recommended in a production setting where districts are used to place gears on a node host before being placed in a district. This is because nodes cannot be placed in a district after they are hosting gears.