Configuring a GWAVA POA Scanner to delete Viruses from a Post Office

  • 7020271
  • 06-Jun-2017
  • 06-Jun-2017


All Supported Operating Systems


The Post Office has been infected by Viruses and I want to scan the PO for Viruses and delete them.


In order to scan a GroupWise Post Office, there are few things that need to be setup.  Prior to setting up the GWAVA Post Office scanner, IMAP needs be enabled on the Post Office.  This allows access through a Trusted Application key which cannot be done through the IMAP connection on the GWIA.  Follow the steps below to prepare the post office to accept a GWAVA POA Scanner.

In general a Post Office scanner should only be used to search for very specific items where false positives won't happen. A Post Office scanner reads the messages directly in a user's mailbox and will delete the message if the message matches the criteria you specify in your POA scanner configuration. If you are doing anything other than virus scanning you should quarantine the messages just in case to make sure that you don't accidentally remove mail. The best use of a post office scanner is to scan for viruses inside user mailboxes as will be shown in this article.

Prepare the Post Office

1)  Set the IMAP port FIRST.
GroupWise 2014:
Open a browser and log in to the GroupWise Administration Console. Go to Post Office Agents, click on the POA and select the Agent Settings tab.

Scroll down to IMAP. Make sure IMAP is enabled.

Set the IMAP port to something other than 143 (this example uses 144), then click on Save.
This prevents the POA IMAP port from interfering with the GWIA IMAP port if they are on the same server.
If they are set to the same port, the POA will unload.

GroupWise 2012 / 8:
In ConsoleOne, open the properties of the POA (not the post office), and select Network Address, under the GroupWise tab. Set the IMAP port to something other than 143 (this example uses 144), then select Apply, and Close.
This prevents the POA IMAP port from interfering with the GWIA IMAP port if they are on the same server.
If they are set to the same port, the POA will unload.

Next, switch to the Agent Settings section under the GroupWise tab, and enable IMAP on the post office.

3)  Wait one minute. Test the connection via IMAP by using Telnet.
Open a command prompt and type "telnet 144". Insert the appropriate IP address and Port.

If the above is setup correctly, the following response should appear. If it does not, there is a problem with IMAP on the server. Do not proceed with GWAVA POA Scanner setup and configuration if there is a problem with IMAP.

NOTE: For more information on troubleshooting IMAP refer to the following article here. Once you have fixed any issues, please return to this article and set up your POA scanner.

Install a GWAVA POA Scanner

1)  Open a web browser and login to the GWAVA Management Console.

2)  Go to the Install Wizard
On the left side, expand the Server / Interface Management section.Expand the Wizards section, and select Install/create new interface.
3)  Select the GroupWise POA Scheduled Scan Job.  Click Continue.

5)  Read through the prerequisites.  It is not necessary at this point to create the Trusted Application Key.  This will be done shortly.  Click Next.

6)  Create a Trusted Application Key and enter it in the Interface settings.

GroupWise 2012 / 2014:
If you are running GroupWise 2012 or 2014, have a look a following article to create the Trusted App Key:
How to manually create a Trusted Application Key for a GWAVA POA interface

GroupWise 8:
For GroupWise 8 you can either manually create a Trusted App Key as described in the article above or use the generator to create the Trusted App key as described in the following steps.
a)  Click on TRUSTKEY.  This will prompt a download for trustkey.exe.  Save and run the file.  This will install the Trusted Application Key Generator application.  Map a drive to the PRIMARY DOMAIN directory.  Run the Generator.
NOTE:  Do not use any other key generator that may have been obtained from other GWAVA products such as GWAVA Retain. It is a different version and may not be compatible. 
b)  Browse to the PRIMARY DOMAIN directory.  Then click Create Trusted Key.

NOTE: Do not immediately close this dialog. Make sure to copy the key to the clipboard and paste it in the web browser. Once you have continued to the next step, close the key generator application.
c)  Wait at least one minute for the key to filter through the system.  Check the POA log for the trusted application acknowledgement, then test.  If the test is not successful, do not proceed to the next step.

7)  After the Trusted Application Key has been generated and successfully tested,  give the job a name and enter the IP address and port.  If no port is entered, port 143 will be assumed.  If the GWAVA POA Scanner connects to the GWIA rather than the POA, the scan will be unsuccessful because the Trusted Applicaiton Key does not apply at the GWIA level.  To enter a specific port,  use the following context.  192.168.194:144.  Use the appropriate IP address and port for your system.

8)  Click Next if all values are correct.

9)  Create a new policy / scanner configuration.
Select Create a new policy for this interface.

Do not share the policy with a different interface type (e.g SMTP or GWIA).  Doing so will use the configuration for another interface and may cause adverse effects and inadvertent mail deletion during the scanning process.  This example is for scanning the post office for viruses only.

If you have multiple Post Office Agents and also want to use multiple POA interfaces in GWAVA you can share the policy with other POA interfaces.

10)  Verify Stop Viruses is checked.

11)  CRITICAL - Expand advanced settings.
Uncheck to block attachments and fingerprinting.  All four of the lower boxes should be unchecked (highlighted in red).  Leaving these checked will cause the scanner to remove all email in the post office that has attachments that match its presets (there are many types).  In many cases the messages will not be recoverable.

12)  Verify the configuration on the next screen and click Install.

13)  Wait for the install to complete and open the job configuration.

Configuring the GWAVA POA Job

1) Go to Server / Interface Management - [Servername] - Manage Interfaces - [Interface name] - Interface settings.

2)  Enable the job by checking the box next to Enable Job.

3)  Check Scan Users, Scan Resources, Scan Trash, and Expunge purged items.

4)  Set the Job Frequency to Just Once.  Set the date to today, and the time. You could also set the job to be run on a daily or weekly basis.

5)  Set Scan Messages in date range to All days.

6)  Set Scan these users to All users.

7)  Set Scan these folders to All Folders.
8)  Once set, click Save Changes .

Verify Job is running

To check if the GWAVA POA scanner is running successfully there are several ways to check.  The best way is to look at the GWAVAPOA log. The statistics on the Dashboard can also be checked.

1) The GWAVA POA logs can be found in following directory:
C:\Program Files\GWAVA\GWAVA\services\logs\gwavapoa
(may vary depending on the GWAVA installation directory)

Additional Information

This article was originally published in the GWAVA knowledgebase as article ID 1464.