Site Maintenance Mode¶
Introduction¶
All our django sites that are configured using salt can be set to maintenance mode. A page called maintenance.html in the root directory of the site is displayed to a site user when the site is in maintenance mode.
The salt configuration provides a sample maintenance page this can be customised as required for the site. Salt will not overwrite the customised maintenance page.
A script enables and disables maintenance mode.
Enable and disable maintenance mode¶
The maintenance mode script is used as follow:
maintenance-mode <domain> on | off
e.g to enable maintenance mode for hatherleigh.info:
maintenance-mode hatherleigh.info on
To disable maintenance mode for hatherleigh.info:
maintenance-mode hatherleigh.info off
Create a customised maintenance page¶
If you have not created a maintenance page the first time you try to enter maintenance mode the script will ask if you wish to clone the sample page.
Answer “y” to create a the maintenance page. Modify this as appropriate for the site and run the command again to enter maintenance mode.