Phanousk at 14:39, 16 July 2019

2019-07-16T14:39:48Z

← Older revision		Revision as of 10:39, 16 July 2019
Line 16:		Line 16:

	To enable this, make the following changes:		To enable this, make the following changes:
			<source lang="perl">
			<pre>
			# create the directory <rt-root>/local/html/NoAuth, if needed
			# create the file <rt-root>/local/html/NoAuth/Maintenance with the contents shown below
			# copy the file <rt-root>/share/html/autohandler to <rt-root>/local/html, if needed
			# add the following line to the top of your local autohandler, just under <%INIT> (be sure to change /opt/rt3 to whatever your RT root is):

	~~# create the directory <rt-root>/local/html/NoAuth, if needed~~		$m->comp("/NoAuth/Maintenance", FName => "/opt/rt3/.maintenance") if (-f "/opt/rt3/.maintenance");
	~~# create the file <rt-root>/local/html/NoAuth/Maintenance with the contents shown below~~		</pre>
	~~# copy the file <rt-root>/share/html/autohandler to <rt-root>/local/html, if needed~~		</source>
	~~# add the following line to the top of your local autohandler, just under <%INIT> (be sure to change /opt/rt3 to whatever your RT root is):~~

	$m-~~>~~comp("/NoAuth/Maintenance", FName =~~>~~ "/opt/rt3/.maintenance") if (-f "/opt/rt3/.maintenance");


	Clear the Mason cache after doing this to see the effects of the changes (see [[CleanMasonCache]] for how to do that). Run the touch command as above to put your site into maintenance mode.		Clear the Mason cache after doing this to see the effects of the changes (see [[CleanMasonCache]] for how to do that). Run the touch command as above to put your site into maintenance mode.

	== ~~<~~rt-root~~>~~/local/html/NoAuth/Maintenance ==		== <rt-root>/local/html/NoAuth/Maintenance ==
			<source lang="perl">
	~~<~~html~~>~~		<pre>
	~~<~~head~~><~~title~~><~~% $title %~~><~~/title~~><~~/head~~>~~		<html>
	~~<~~body~~>~~		<head><title><% $title %></title></head>
	~~<~~div id="header"~~>~~		<body>
			<div id="header">
	% if ($html) {		% if ($html) {
	~~<~~% $maintmsg\|n %~~>~~		<% $maintmsg\|n %>
	% } else {		% } else {
	~~<~~h1~~><~~% $maintmsg %~~><~~/h1~~>~~		<h1><% $maintmsg %></h1>
	% }		% }
	~~<~~/div~~>~~		</div>
	~~<~~/body~~>~~		</body>
	%$m-~~>~~flush_buffer();		%$m->flush_buffer();
	%$m-~~>~~abort();		%$m->abort();

	~~<~~%args~~>~~		<%args>
	$DefMsg =~~>~~ "The system is down for maintenance. Please check back in a couple of minutes."		$DefMsg => "The system is down for maintenance. Please check back in a couple of minutes."
	$DefTitle =~~>~~ "RT Maintenance"		$DefTitle => "RT Maintenance"
	~~<~~/%args~~>~~		</%args>

	~~<~~%INIT~~>~~		<%INIT>
	$m-~~>~~clear_buffer();		$m->clear_buffer();

	my($rc) = open(IN, "~~<~~$FName");		my($rc) = open(IN, "<$FName");
	if (! $rc) {		if (! $rc) {
	my($errmsg) = qq([Maintenance] Cannot open "$FName" for input - $!);		my($errmsg) = qq([Maintenance] Cannot open "$FName" for input - $!);
	$RT::Logger-~~>~~crit($errmsg);		$RT::Logger->crit($errmsg);
	$m-~~>~~print("~~<~~strong~~>~~$DefMsg~~<~~/strong~~><~~br/ ~~><~~br/ ~~>~~");		$m->print("<strong>$DefMsg</strong><br/ ><br/ >");
	$m-~~>~~print($errmsg);		$m->print($errmsg);
	$m-~~>~~abort();		$m->abort();
	}		}

Line 66:		Line 69:
	{		{
	local $/;		local $/;
	$maintmsg = ~~<~~IN~~>~~;		$maintmsg = <IN>;
	}		}

Line 83:		Line 86:
	$maintmsg \|\|= $DefMsg;		$maintmsg \|\|= $DefMsg;
	$title \|\|= $DefTitle;		$title \|\|= $DefTitle;
	~~<~~/%INIT~~>~~		</%INIT>

	~~<~~%ARGS~~>~~		<%ARGS>
	$FName		$FName
	~~<~~/%ARGS~~>~~		</%ARGS>
			</pre>
			</source>

	The actual message to be displayed will be taken from the contents of the .maintenance file itself. If the file is empty, it will use the default message. You can also customize the HTML Title shown, by putting "[TITLE Some Different Title Here]" in the .maintenance file. This will be stripped out before the main message is displayed. Finally, if the message in the .maintenance file contains HTML, you can have it pass through as-is by putting "[[HTML]]" in the .maintenance file (again, it will be stripped out before the message is displayed). For example:		The actual message to be displayed will be taken from the contents of the .maintenance file itself. If the file is empty, it will use the default message. You can also customize the HTML Title shown, by putting "[TITLE Some Different Title Here]" in the .maintenance file. This will be stripped out before the main message is displayed. Finally, if the message in the .maintenance file contains HTML, you can have it pass through as-is by putting "[[HTML]]" in the .maintenance file (again, it will be stripped out before the message is displayed). For example:

	[TITLE Emergency Maintenance]		[TITLE Emergency Maintenance]
	The RT site will be down for emergency maintenance ~~<~~em~~>~~for the next 15 hours!~~<~~/em~~>~~		The RT site will be down for emergency maintenance <em>for the next 15 hours!</em>
	If this is an emergency, please open up a ticket with a Priority of 99.		If this is an emergency, please open up a ticket with a Priority of 99.
	[HTML]		[HTML]


	This was tested on RT 3.6.3; let me know if you have any problems. -- [[JoeCasadonte]]		This was tested on RT 3.6.3; let me know if you have any problems. -- [[JoeCasadonte]]

	Note: reports are that this does not work under 3.4.6		Note: reports are that this does not work under 3.4.6

Admin: 2 revisions imported

2016-04-06T20:14:21Z

2 revisions imported

New page

Here's a quick and dirty Maintenance Mode. If you need to block access to the web site for any length of time (to back up the database, for example) this lets you block access to the site without needing to bring the site down or clear out the Mason cache. And it's as simple to unblock the site, too.

When the new code is in place, you can place the site into maintenance mode simply by creating a file called ".maintenance" in the root of the RT install:

<nowiki># touch /opt/rt3/.maintenance

</nowiki>

and taking it out of maintenance mode is as simple as removing the file:

<nowiki># rm /opt/rt3/.maintenance

</nowiki>

The effect is instantaneous in both cases. See below for how to customize the message.

To enable this, make the following changes:

# create the directory <rt-root>/local/html/NoAuth, if needed
# create the file <rt-root>/local/html/NoAuth/Maintenance with the contents shown below
# copy the file <rt-root>/share/html/autohandler to <rt-root>/local/html, if needed
# add the following line to the top of your local autohandler, just under <%INIT> (be sure to change /opt/rt3 to whatever your RT root is):

$m->comp("/NoAuth/Maintenance", FName => "/opt/rt3/.maintenance") if (-f "/opt/rt3/.maintenance");

Clear the Mason cache after doing this to see the effects of the changes (see [[CleanMasonCache]] for how to do that). Run the touch command as above to put your site into maintenance mode.

== <rt-root>/local/html/NoAuth/Maintenance ==

<html>
<head><title><% $title %></title></head>
<body>
<div id="header">
% if ($html) {
<% $maintmsg|n %>
% } else {
<h1><% $maintmsg %></h1>
% }
</div>
</body>
%$m->flush_buffer();
%$m->abort();

<%args>
$DefMsg => "The system is down for maintenance. Please check back in a couple of minutes."
$DefTitle => "RT Maintenance"
</%args>

<%INIT>
$m->clear_buffer();

my($rc) = open(IN, "<$FName");
if (! $rc) {
my($errmsg) = qq([Maintenance] Cannot open "$FName" for input - $!);
$RT::Logger->crit($errmsg);
$m->print("<strong>$DefMsg</strong><br/ ><br/ >");
$m->print($errmsg);
$m->abort();
}

my($maintmsg) = "";
my($title) = "";
my($html) = 0;

{
local $/;
$maintmsg = <IN>;
}

close IN;

if ($maintmsg =~ m{\[HTML\]}) {
$html = !0;
$maintmsg =~ s{\[HTML\]}{};
}

if ($maintmsg =~ m{\[TITLE ([^]]+)\]}) {
$title = $1;
$maintmsg =~ s{\[TITLE ([^]]+)\]}{};
}

$maintmsg ||= $DefMsg;
$title ||= $DefTitle;
</%INIT>

<%ARGS>
$FName
</%ARGS>

The actual message to be displayed will be taken from the contents of the .maintenance file itself. If the file is empty, it will use the default message. You can also customize the HTML Title shown, by putting "[TITLE Some Different Title Here]" in the .maintenance file. This will be stripped out before the main message is displayed. Finally, if the message in the .maintenance file contains HTML, you can have it pass through as-is by putting "[[HTML]]" in the .maintenance file (again, it will be stripped out before the message is displayed). For example:

[TITLE Emergency Maintenance]
The RT site will be down for emergency maintenance <em>for the next 15 hours!</em>
If this is an emergency, please open up a ticket with a Priority of 99.
[HTML]

This was tested on RT 3.6.3; let me know if you have any problems. -- [[JoeCasadonte]]

Note: reports are that this does not work under 3.4.6

MaintenanceMode - Revision history

Phanousk at 14:39, 16 July 2019

Admin: 2 revisions imported