Difference between revisions of "GWVRELAY"

Latest revision as of 15:28, 14 June 2013

This is the page for GWVRELAY.

[edit] Level 1

GWVRELAY is a program that is designed to get released messages and notifications to end users or the administrator. Messages can be released from the Quarantine system, alerts about various programs,reports, and many notifications.

[edit] Level 2

The GWVRELAY program is a module that uses the SMTP protocol deliver messages the users and the Administrator. These messages can come from GWAVAMAN, GWAVA, GWAVA Quarantine, and if configured GWVSMTP. GWVRELAY uses the recipient address to determine if the message should be delivered externally or to internal recipients. GWVRELAY constantly monitors a specific directory to determine if there are messages that are to be delivered. This directory is located in "../gwava/services/smtp_mailer/outbound/"

How are files structured in this directory? For every message that gwvrelay will try and deliver, 2 files are necessary, an xml and msg file. For a given message, left left part of the filename will always be the same. The xml file contains the sender and recipient for the message. The mesg file is that actual message that will be used for the DATA portion of the SMTP conversation. Other file extensions will occasionally show up if there are issues delivering the messages. These extensions can be err, req, or prc. The err file is the errors that occurred when trying to deliver the message. The req tells gwvrelay to wait and try the message again later. The prc file is the msgfile that has been renamed. This is because all the retry attempts have been exhausted and the message could not be delivered.

If the message was successfully delivered, then the message and xml file will be deleted. There are minimal configuration options that can be configured for GWVRELAY. These options are on the Configure Server Page in the GWAVAMAN UI. These options allow the administrator to control the following:

SMTP outbound queue directory Mail relay SMTP greeting Mail relay authentication method Mail relay maximum send threads Mail relay retry interval Mail relay retry Maximum count.

The settings are better explained here: Link to Configure Server Page.

[edit] Hands On:

There are a couple easy tests to show how this program works.

1) Stop gwvrelay. Linux: rcgwavaman stop gwvrelay Windows: Open the Windows Services and stop the GWVRELAY service.

2) Create a filter that will send a particular message to the Quarantine System.

3) Send a message that will qualify with that filter.

4) Verify that the message was delivered to the Quarantine system.

5) Release the message from the Quarantine system.

6) Browse to the SMTP outboud queue directory. By default, this is in ../gwava/services/smtp_mailer/outbound/

7) You should see 2 files in this directory, an xml and msg file. If you open the xml file, you will see the sender and recipient. The msg file is the body of the email message.

8) Start gwvrelay. Linux: rcgwavaman start gwvrelay Windows: Open the Windows Services and start the GWVRELAY service.

9) You should notice that those files get removed. To verify that they were delivered to the recipient, you can check that users mailbox or verify in the logs that gwvrelay delivered the message to the gateway. You will have to verify this through the gwvrelay/support logs.

Lets take a look at GWAVAUPD