Bug 681788

Summary:	[RHN Satellite 5.4. Reference guide] Monitoring notification redirects section needs updates
Product:	Red Hat Satellite 5	Reporter:	Michael Mráka <mmraka>
Component:	Docs Reference Guide	Assignee:	Lana Brindley <lbrindle>
Status:	CLOSED CURRENTRELEASE	QA Contact:	Pavel Novotny <pnovotny>
Severity:	low	Docs Contact:
Priority:	low
Version:	540	CC:	cperry, mhideo, pnovotny, xdmoon
Target Milestone:	---
Target Release:	---
Hardware:	All
OS:	Linux
Whiteboard:
Fixed In Version:		Doc Type:	Bug Fix
Doc Text:		Story Points:	---
Clone Of:		Environment:
Last Closed:	2011-06-16 22:29:53 UTC	Type:	---
Regression:	---	Mount Type:	---
Documentation:	---	CRM:
Verified Versions:		Category:	---
oVirt Team:	---	RHEL 7.3 requirements from Atomic Host:
Cloudforms Team:	---	Target Upstream Version:
Embargoed:
Bug Depends On:
Bug Blocks:	677505

Description Michael Mráka 2011-03-03 09:09:47 UTC

While investigating bug 493028 there was found inconsistence in Satellite Reference guide.

Current text:

8.4.3. Redirecting Notifications
...
The format of the rule should be filter_type probe_type duration email_address where filter_type indicates one of the previous advanced commands, probe_type indicates probe or system, duration indicates the length of time for the redirect, and email_address indicates the intended recipient. For example: 

ACK METOO system 1h boss

Should be:

... probe_type indicates <code>check<code> or <code>host<code> ...

ACK METOO host 1h boss

Comment 1 Michael Mráka 2011-03-03 09:20:03 UTC

There also should be a notice how to enable redirects:


8.4.3. Redirecting Notifications
Upon receiving a notification, you may redirect it by including advanced notification rules within an acknowledgment email.

Enable email reply redirects by adding following line to /etc/aliases:

rogerthat01:    "| /etc/smrsh/ack_enqueuer.pl"

And then just reply to the notification and include the desired option. These are the possible redirect options, or filter types:
...

Comment 2 Clifford Perry 2011-03-08 01:11:22 UTC

We will address this documentation issue within 5.4.1 doc fixing.

Cliff

Comment 3 Lana Brindley 2011-03-23 22:48:16 UTC

(In reply to comment #0)
> While investigating bug 493028 there was found inconsistence in Satellite
> Reference guide.
> 
> Current text:
> 
> 8.4.3. Redirecting Notifications
> ...
> The format of the rule should be filter_type probe_type duration email_address
> where filter_type indicates one of the previous advanced commands, probe_type
> indicates probe or system, duration indicates the length of time for the
> redirect, and email_address indicates the intended recipient. For example: 
> 
> ACK METOO system 1h boss
> 
> Should be:
> 
> ... probe_type indicates <code>check<code> or <code>host<code> ...
> 
> ACK METOO host 1h boss

<para>
				 The format of the rule should be <replaceable>filter_type probe_type duration email_address</replaceable> where <replaceable>filter_type</replaceable> indicates one of the previous advanced commands, <replaceable>probe_type</replaceable> indicates <code>check</code> or <code>host</code>, <replaceable>duration</replaceable> indicates the length of time for the redirect, and <replaceable>email_address</replaceable> indicates the intended recipient. For example:
			</para>
			 
<screen>
<command> ACK METOO host 1h boss </command></screen>

Comment 4 Lana Brindley 2011-03-23 22:51:29 UTC

(In reply to comment #1)
> There also should be a notice how to enable redirects:
> 
> 
> 8.4.3. Redirecting Notifications
> Upon receiving a notification, you may redirect it by including advanced
> notification rules within an acknowledgment email.
> 
> Enable email reply redirects by adding following line to /etc/aliases:
> 
> rogerthat01:    "| /etc/smrsh/ack_enqueuer.pl"
> 
> And then just reply to the notification and include the desired option. These
> are the possible redirect options, or filter types:
> ...

			 <para>
				 Upon receiving a notification, you may redirect it by including advanced notification rules within an acknowledgment email. Enable email reply redirects by opening <filename>/etc/aliases</filename> and adding the following line:
			 </para>
<programlisting>
rogerthat01:    "| /etc/smrsh/ack_enqueuer.pl"
</programlisting>
			<para>
				Once the parameter has been set, reply to the notification email and include the desired option. These are the possible redirect options, or <firstterm>filter types</firstterm>:
			</para>

LKB

Comment 5 Lana Brindley 2011-03-23 22:52:19 UTC

Updated in revision 1-28, version 5.4.1.

LKB

Comment 6 Pavel Novotny 2011-04-21 12:28:37 UTC

Taking this bug for verification.

Comment 7 Pavel Novotny 2011-04-22 17:04:42 UTC

Verified (fix in comment 3 and comment 4).
Satellite 5.4.1 "Reference Guide", section "8.4.3. Redirecting Notifications".

Comment 8 Lana Brindley 2011-05-06 00:22:20 UTC

This book has now been dropped to translation (RT#75265).
No further updates can be accepted. Please raise a new bug for any changes.
LKB

Comment 9 Lana Brindley 2011-06-16 22:29:53 UTC

5.4.1 Satellite books are now available on docs.redhat.com. Please raise a new bug for any issues.

LKB