[ZBX-23174] Frontend maintenance configuration does not follow documentation Created: 2023 Jul 30  Updated: 2024 Nov 19  Resolved: 2024 Nov 07

Status: Closed
Project: ZABBIX BUGS AND ISSUES
Component/s: Frontend (F)
Affects Version/s: 5.0.36
Fix Version/s: 6.0.34rc1, 7.0.4rc1, 7.2.0alpha1

Type: Problem report Priority: Major
Reporter: Khatsayuk Alexander Assignee: Andrejs Griščenko
Resolution: Fixed Votes: 0
Labels: configuration, maintenance
Remaining Estimate: 0h
Time Spent: 2.5h
Original Estimate: 0.5h

Issue Links:
Duplicate
Team: Team A
Sprint: Sprint candidates, S24-W34/35
Story Points: 0.125

 Description   

Hi, Zabbix team.

I've created the issue to pay your attention to ZBX-9138.

Zabbix docs doesn't suit with reality. Briefly:

  • ZBX_DENY_GUI_ACCESS enables maintenance mode whatever it set.
  • ZBX_GUI_ACCESS_MESSAGE isn't work, still need to use $_REQUEST

 Comments   
Comment by dimir [ 2023 Aug 01 ]

I guess you're talking about incorrect instructions on how to disable GUI on:

https://www.zabbix.com/documentation/current/en/manual/web_interface/maintenance_mode

?

Comment by Khatsayuk Alexander [ 2023 Aug 02 ]

 dimir yeap, that's right.

Comment by dimir [ 2023 Aug 02 ]

So, as I understand, the following changes should be made in the Frontend code:

  1. ZBX_DENY_GUI_ACCESS must enable maintenance mode only if it is defined and is set to 1. In all other cases maintenance mode should be disabled.
  2. Add functionality to use the $ZBX_GUI_ACCESS_MESSAGE variable (this variable is currently unused) so that users don't have to use $_REQUEST directly.

The documentation seems to be already according to the above statements.

Is that correct?

Comment by Khatsayuk Alexander [ 2023 Aug 02 ]

dimir yes, thanks.

Comment by Dmitrijs Fofanovs [ 2024 Aug 13 ]
  • ZBX_DENY_GUI_ACCESS won't be changed (maintenance mode will be enabled, if it was defined with any value) and only the documentation will be updated. To turn off maintenance mode, the line "define('ZBX_DENY_GUI_ACCESS', 1)" should be removed or commented out.
  • ZBX_GUI_ACCESS_MESSAGE will be fixed according to the documentation, but with a small improvement:
    • if it is not defined, but frontend maintenance is turned on, a default message will used: 'Zabbix is under maintenance.'. The default message won't be translatable.
Comment by Andrejs Griščenko [ 2024 Aug 22 ]

Available in versions:

Comment by Marina Generalova [ 2024 Oct 30 ]

Updated Frontend maintenance mode page in the documentation for 6.0, 7.0, 7.2

Generated at Thu Jun 26 08:08:33 EEST 2025 using Jira 9.12.4#9120004-sha1:625303b708afdb767e17cb2838290c41888e9ff0.