2.9. Enabling Maintenance Mode

The broker can be put into maintenance mode, in which it is running and responding, but developer requests are refused with a predefined notification message. This is useful for keeping developers informed while you perform maintenance on the OpenShift Enterprise deployment, rather than refusing the connections entirely.

Procedure 2.6. To Enable Maintenance Mode:

  1. Enable maintenance mode using the ENABLE_MAINTENANCE_MODE setting in the /etc/openshift/broker.conf file on the broker host: 
    ENABLE_MAINTENANCE_MODE="true"
  2. Define the location of the notification message using the MAINTENANCE_NOTIFICATION_FILE setting: 
    MAINTENANCE_NOTIFICATION_FILE="/etc/openshift/outage_notification.txt"
  3. Create or edit the file defined in the MAINTENANCE_NOTIFICATION_FILE setting to contain the desired notification message seen by developers while the broker is in maintenance mode.
  4. Restart the broker service: 
    # service openshift-broker restart