7.6. Configuring Suggestions

The System Overview front page of the Administration Console provides a visual and numeric summary of the capacity and usage of the entire OpenShift Enterprise deployment. You can configure it to provide suggestions for when the capacity may have to be adjusted. Because OpenShift Enterprise environments vary, thresholds are not set by default, and thus capacity suggestions are initially absent. Settings for capacity planning are configured in the Administration Console configuration file, located at /etc/openshift/plugins.d/openshift-origin-admin-console.conf, to enable suggestions that warn of current or impending capacity problems. For example, the Administration Console can suggest where to add nodes to ensure a particular profile can continue to create gears, or where capacity is poorly utilized.

Note

See Section 6.2, “Capacity Planning and Districts” for more information on capacity planning in OpenShift Enterprise to better understand the information that is displayed by the Administration Console and the importance of the suggestion settings.
Both the configuration file settings and the existing capacity data determine the suggestions for adding and removing capacity, which are conservative in terms of placing nodes in districts. For example, when calculating district size suggestions, the Administration Console uses the observed gear percentage if that percentage is lower than expected; if all nodes do not have the same max_active_gears limit, it uses the largest.
The STATS_CACHE_TIMEOUT parameter in the configuration file, set by default to one hour, determines how long to keep capacity and suggestions statistics cached. If you do not immediately see changes that you expect in the Administration Console, refresh the data by clicking the refresh icon near the upper right of any page.