Help Center


Knowledge Base


[DOC:Netmail Documentation]

Documentation for Netmail Secure 5.4.
Documentation for [Netmail Secure 5.3] and [earlier versions of Netmail] is also available.

Skip to end of metadata
Go to start of metadata


The Netmail Diagnostics tab provides administrators with a quick overview of the health and stability of their Netmail system. Information is collected via SNMP across all nodes in system. The information is polled periodically in the background, and selecting the Diagnostics tab will display the more recent readings. The display does not automatically update as new values are read so the tab must be re-selected to refresh the information. As such, Netmail Diagnostics is not intended to be used as a monitoring tool but rather as a troubleshooting starting point.

 

On this page:

Connectivity status of the Platform with...

The Connectivity status of the Platform with... section on the Diagnostics tab contains key indicators for the connectivity status of the major components of your email system with the Netmail Platform. Each key indicator also has sub-indicators.

Every indicator and sub-indicator can have a status color of grey, green, yellow, or red. If the color of any single sub-indicator changes, the color of its corresponding key indicator changes accordingly. To obtain more information about a key indicator and its sub-indicators, simply click the key indicator. A lightbox appears, showing all the sub-indicators for that key indicator. In the sample screenshot below, details about the Configuration Repository key indicator are shown.

It is also possible to click a sub-indicator (or the graph icon) to get more information about it. A simple time chart showing how that particular indicator has changed over the last day, week, month, or year is displayed. In the screenshot below, details about Exchange Connectivity over the course of the last day are shown.

The the rest of this section explains in more detail what the green-, yellow-, and red-colored indicators mean and what the graphs show, with regard to the connectivity status of the Netmail Platform with GroupWise, Exchange, and the Email System.

GroupWise

The Netmail and GroupWise IP addresses are shown.

GroupWise Connectivity

Test: Connect to each PO, using the both OAPI & SOAP (on default ports). Redirects are followed.

  • Green: Indicates that the connectivity to all Post Offices is good.
  • Red: Indicates that there is no connectivity to some or all of the Post Offices.

The graphs displayed when you click on a sub-indicator show connection details per Post Office, and historical data.

 Troubleshooting connectivity status of the Netmail Platform with GroupWise

GroupWise Connectivity

  • Verify that Netmail is properly configured with GroupWise IP addresses, credentials, etc. (Address Book Sync and well as the PO tabs in the Netmail console)
  • Make sure that the mail servers are reachable and their services are up/available.

Exchange

The Netmail and Exchange IP addresses are shown.

Exchange Connectivity

Test: Bind to the service account's inbox using EWS. Autodiscover is used.

  • Green: Indicates that EWS connectivity between Netmail and Exchange is good.
  • Red: Indicates that there is no EWS connectivity between Netmail and Exchange, or the service mailbox cannot be opened.

The graphs displayed when you click on a sub-indicator show historical data.

PowerShell Connectivity

Test: Creates a powershell runspace to Exchange. Autodiscovery is used.

  • Green: Indicates that Powershell connectivity between Netmail and Exchange is good.
  • Red: Indicates that there is no Powershell connectivity to Exchange (eg. powershell runspaces are exhausted, incorrect credentials, etc..)

The graphs displayed when you click on a sub-indicator show historical data.

 Troubleshooting connectivity status of the Netmail Platform with Exchange

Exchange Connectivity

  • Verify that Netmail is properly configured with Exchange URL and credentials on the Address Book Sync tab in the Netmail console
  • Make sure that the mail servers are reachable and their services are up/available.

Mail System

The IP address displayed is that of the Netmail Secure system.

Mail Routes

Test: Tries to connect to the port.

  • Delivery Route General Status:
    • Green: All Delivery Routes present a 90% success rate.
    • Yellow: One or more Delivery Routes present a success rate between 80% and 90%.
    • Red: One or more Delivery Routes present a success rate of 80% or less.

The graphs displayed when you click on a sub-indicator show the connection success rate per Mail Route, and historical data.

 Troubleshooting Mail Routes

Mail Routes

Test the route using the Test button in the route editor (click on the route to bring up the editor).

Route Type

SMTP:

  • Test the route by clicking the Test button in the route editor (click on the route to bring up the editor).
  • Check to see if the mail server is up and that mail service is running.
  • Verify that the server accepts mail from the Netmail Secure server for the domains routed.

MX:

  • Test the route by clicking the Test button in the route editor (click on the route to bring up the editor).
  • Check to see if the MX record resolves properly from the Netmail Secure server.
  • Test the connectivity between the Netmail Secure node and the server(s) that the MX points to.

Route:

  • Test the route by clicking the Test button in the route editor (click on the route to bring up the editor)
  • Use another route; verify that this route is good, according to the type.

Local Delivery:

  • Local Delivery is not supported.

Configuration Repository

eDirectory Connectivity (Netmail Archive)

The IP address displayed is that of the Netmail system.

Test: LDAP connection to the local eDirectory.

  • Green: Indicates that the eDirectory connectivity is successful.
  • Red: Indicates that there is no connectivity.

The graphs displayed when you click on a sub-indicator show historical data.

eDirectory Connectivity (Netmail Secure)

The IP address displayed is that of the Netmail system.

Test: Tries to connect to the local eDirectory port.

  • Green: Indicates a connectivity success rate of over 90%.
  • Yellow: Indicates a connectivity success rate between 80% and 90%.
  • Red: Indicates a connectivity success rate of 80% or less.

The graphs displayed when you click on a sub-indicator show historical data.

 Troubleshooting the Configuration Repository

eDirectory Connectivity (Netmail Archive)

  • Verify that the eDirectory service is started and that the connection details in clusterconfig.xml are correct.

eDirectory Connectivity (Netmail Secure)

  • eDirectory is always local on Netmail Secure.
  • Make sure that the NDSD daemon is running on the node and that it is responsive.

Authentication Source

eDirectory Connectivity from Archive System

The IP address displayed is that of the Netmail Archive system.

Test: Tries to connect to the configured port.

  • Green: Indicates that the connectivity is good.
  • Red: Indicates that there is no connectivity.

The graphs displayed when you click on a sub-indicator show historical data.

Authentication Sources

The IP address displayed is that of the Netmail Secure system.

Test: Tries to connect to the local eDirectory port.

  • Authentication Sources General Status:
    • Green: All Authentication Sources present a 90% success rate.
    • Yellow: One or more Authentication Sources present a success rate between 80% and 90%.
    • Red: One or more Authentication Sources present a success rate of 80% or less.

The graphs displayed when you click on a sub-indicator show the connection success rate per Authentication Source, and historical data.

 Troubleshooting Authentication Sources

Authentication Source (Netmail Archive)

  • eDirectory connectivity from Archive system
  • Verify that that the local replica and the master eDirectory server are running and are responsive

Authentication Sources (Netmail Secure)

Route Type:

SMTP:

  • Test the route using the Test button in the route editor (click on the route to bring up the editor)
  • Check to see if the mail server is up and that mail service is running.
  • Test the connectivity of the Netmail server.
  • Verify that the server can authenticate users for the domains routed.

MX:

  • Test the route by clicking the Test button in the route editor (click on the route to bring up the editor).
  • Check to see if the MX record resolves properly from the Netmail Secure server.
  • Test the connectivity between the Netmail Secure node and the server(s) that the MX points to.

Route:

  • Test the route clicking the Test button in the route editor (click on the route to bring up the editor).
  • Use another route to authenticate; verify that this route is good, according to the type.

Novell GroupWise 6/7(LDAP) or GroupWise 8 (LDAP):

  • Test the route by clicking the Test button in the route editor (click on the route to bring up the editor).
  • Verify the connectivity between Netmail Secure and eDirectory.
  • Make sure eDirectory services are running.

Microsoft Exchange (LDAP):

  • Test the route by clicking the Test button in the route editor (click on the route to bring up the editor)
  • Verify the connectivity of the Netmail Secure server to your Active Directory server

LDAP (manual):

  • Test the route by clicking the Test button in the route editor (click on the route to bring up the editor).

Local Authentication:

  • Local Authentication is not supported.

Platform Status

The Platform Status section on the Diagnostics tab contains key indicators for the current overall health and operational status of the Netmail Platform. Each key indicator also has sub-indicators.

Every indicator and sub-indicator can have a status color of grey, green, yellow, or red. If the color of any single sub-indicator changes, the color of its corresponding key indicator changes accordingly. To obtain more information about a key indicator and its sub-indicators, simply click the key indicator. A lightbox appears, showing all the sub-indicators for that key indicator.

It is also possible to click a sub-indicator to get more information about it. A simple time chart showing how that particular indicator has changed over the last day, week, month, or year is displayed. In the screenshot below, details about Exchange Connectivity over the course of the last week are shown.

The the rest of this section explains in more detail what the green-, yellow-, and red-colored indicators mean and what the graphs show, with regard to the status of the Netmail Platform components.

Note: A grey status indicates that the platform component has not been deployed or that there is no SNMP data available for that component.

Netmail Archive

The IP address of the Master node is displayed, followed by that of the Worker node (if applicable).

Node Status

Test: Receive HTTP response from the node (on port 8585).

Node Status:

  • Green: The node is operational.
  • Red: The node is not operational.

The graphs displayed when you click on a sub-indicator show historical data.

Location Connectivity

Test: Connects to paths of all Archive storage locations.

  • Green: Indicates that the connectivity to all locations is good.
  • Yellow: Indicates that there is no connectivity to some of the locations.
  • Red: Indicates that there is no connectivity to any of the locations.

The graphs displayed when you click on a sub-indicator show historical data.

Device Connectivity

Test: Connects to paths in all Archive storage devices.

  • Green: Indicates that the connectivity to all devices is good.
  • Yellow: Indicates that there is no connectivity to some of the devices.
  • Red: Indicates that there is no connectivity to any devices.

The graphs displayed when you click on a sub-indicator show historical data.

Logging Connectivity

Test: Connects to the database using the connection string specified in Archive->Cluster->Configuration Tab -> Default Log Settings.

  • Green: Indicates that the connectivity to database is good.
  • Red: Indicates that there is no connectivity to the database.

The graphs displayed when you click on a sub-indicator show historical data.

Free Temp Space

Test: Obtains amount of free space remaining on volume hosting the TEMP directory.

  • Green: Indicates that the volume is > 50% available.
  • Yellow: Indicates that the volume is between 25% - 50% available.
  • Red: Indicates that the volume is < 25% available.

The graphs displayed when you click on a sub-indicator show historical data.

 Troubleshooting Netmail Archive

The IP address of the Archive Master node is displayed, followed by that of the Worker node (if applicable).

Operation

  • Node Status
  • Make sure the node is up and that Netmail Services are running.

Cluster Connectivity

  • Check that all nodes are up and that Netmail Services are running on the node.
  • Check the connectivity to the Master Archive node.

Storage Connectivity

  • Go to the Storage tab in Cluster settings;
  • Click the Test button to test and find the problem.

Netmail Store

  • Try connecting to the Netmail Store node through a browser (you should get a blank page).
  • Check the connectivity from the node to Netmail Store.

Local Path

  • Make sure the path exists on the node.

Network Share

  • Verify that the server which has the share on it is up and that the share can be accessed using the credentials defined in the settings.

NetApp

  • Make sure that the Netmail Archive node has access to the NetApp File and that the share can be accessed using the credentials defined in the settings.

Logging Connectivity

  • Check the Default Log Settings on the Configuration tab of Archive Cluster.
  • Test the connectivity to the Logging Server by clicking the Test button.
  • Check if the data service is running and is responsive on the server in the Logging Server Connection String.

Free Temp Space

  • Clear some space.
  • Make the disk bigger in VMware if you are running out of free space often.

Netmail Secure

Spools

Test: Tests messages spooled for each agent on the node as reported by Netmail Secure.

  • Green: Indicates that less than 50 messages were spooled.
  • Yellow: Indicates that 50 to 74 messages were spooled.
  • Red: Indicates that 75 or more message were spooled.

The graphs displayed when you click on a sub-indicator show historical data.    

SMTP Modules

The status is always good.

Logging Connectivity

Test: Tests connectivity from the Secure Node to the PostgreSQL logging database.

  • Green: Indicates that the connectivity to PostgreSQL is good.
  • Red: Indicates that there is no connectivity to the PostgreSQL database.

The graphs displayed when you click on a sub-indicator show historical data.

 Troubleshooting Netmail Secure

Spools

  • Problems may be caused by a surge in mail traffic.
  • Stop accepting messages, and monitor the queue using the graph, bin/stats or SNMP.
  • If the number of queued messages does not go down, restart the services.
  • If, after restarting the services, the number of queued messages is still not declining, consider changing the ordering of the agents using limits, lists, or adding nodes to the cluster.

SMTP Modules

  • Monitoring not implemented.

Logging Connectivity

  • Check that the PostgreSQL service is running and responsive on the node.

Netmail Store

The IP address of the Archive node is shown.

Netmail Store Connectivity (Archive)

Test: Receives response to HTTP request, from each Netmail Store device in the console.

  • Green: Indicates that the connectivity with all Netmail Store nodes is good.
  • Yellow: Indicates that the connectivity to some Netmail Store nodes is good.
  • Red: Indicates that there is no connectivity to Netmail Store.

The graphs displayed when you click on a sub-indicator show historical data.

Netmail Store Connectivity (Secure)

The IP address of the Secure node is shown.

Test: Tries to connect to the Netmail Store port.

  • Green: Indicates that the connectivity to Netmail Store is good.
  • Red: Indicates that there is no connectivity to Netmail Store.
  • Gray: Indicates that the component has not been configured or that there is no SNMP data available for that component.

The graphs displayed when you click on a sub-indicator show historical data.

Netmail Store Proxy Connectivity (Secure)

The IP address of the Secure node is shown.

Test: Tries to connect to the Netmail Store Proxy URI.

  • Green: Indicates that the connectivity to the Netmail Store Proxy is good.
  • Red: Indicates that there is no connectivity to the Netmail Store Proxy.
  • Gray: Indicates that the component has not been configured or that the status is unknown.

The graphs displayed when you click on a sub-indicator show historical data.

 

 Troubleshooting Netmail Store

Netmail Store Connectivity (Archive)

The IP address of the Archive node is displayed.

  • Try connecting to the Netmail Store node through a browser (you should get a blank page).
  • Check the connectivity between the node and Netmail Store.

Netmail Store Connectivity (Secure)

The IP address of the Secure node is displayed.

  • Try connecting to the Netmail Store node with a browser (you should get a blank page).
  • Check the connectivity between the node and Netmail Store.

Netmail Store Proxy Connectivity (Archive)

The IP address of the Archive node is displayed.

  • Try connecting to the Netmail Store Proxy node with a browser (you should get a blank page).
  • Check the connectivity between the node and the Netmail Store Proxy.

Netmail Store Proxy Connectivity (Secure)

The IP address of the Secure node is displayed.

  • Try connecting to the Netmail Store Proxy node with a browser (you should get a blank page).
  • Check the connectivity between the node and the Netmail Store Proxy.

Index Servers

Connectivity to Index (Archive)

Test: Connect to the Master Index Server admin port

  • Green: Indicates that the connectivity to the Master Index Server admin port is good.
  • Red: Indicates that there is no connectivity to the Master Index Server admin port.

The graphs displayed when you click on a sub-indicator show historical data.

Connectivity to Index (for Search)

Test: Connect to the Master Index Server Search port

  • Green: Indicates that the connectivity to the Master Index Server Search port is good.
  • Red: Indicates that there is no connectivity to the Master Index Server Search port.

The graphs displayed when you click on a sub-indicator show historical data.

Index BuildGroup

Test: Connect to the Master Index Server port for the BuildGroup.

  • Green: Indicates that the connectivity to the Master Index Server port for the BuildGroup is good.
  • Red: Indicates that there is no connectivity to the Master Index Server port for the BuildGroup.

The graphs displayed when you click on a sub-indicator show historical data.

 Troubleshooting Index Servers

Connectivity to Index

  • Try to connect to the Index administration with a browser (redirect to the Worker).
  • Make sure the Netmail Indexing Service is running on the Master Index server.
  • Check the connectivity between the node and the Master Index server.   

Index BuildGroup (could connect to build group)

  • Make sure that the Netmail Indexing Service is running on the Worker node for the the build group.
  • Make sure that the Netmail Indexing Service is running on the Master Index server.
  • Verify the connectivity between the Master Index server and the Worker node.

Netmail Search

User Authentication  

Test: Tries to authenticate to the Auth provider for users (eDirectory, Active Directory)

  • Green: Indicates that user Authentication is working.
  • Red: Indicates that user Authentication is not working.

The graphs displayed when you click on a sub-indicator show historical data.

Stub Resolution

Test: Tests if stubs can be resolved.

  • Green: Indicates that all stub resolution subsystems are working.
  • Red: Indicates that stubs cannot be resolved.

The graphs displayed when you click on a sub-indicator show historical data.

 

 Troubleshooting Netmail Search

User Authentication

GroupWise mail system:

  • Verify the connectivity from the Remote Provider to eDirectory.

Exchange mail System:

  • Verify the connectivity from the Remote Provider to Active Directory.

Stub Resolution

  • Make sure that the Netmail Remote Provider service is running on the remote Provider server.
  • Make sure that the Index Server is up and running (Netmail Indexing Service).
  • Make sure that the Remote Provider can connect to the Index Server.

Netmail Search Server(s)

This section allows you to see the state of Netmail Search. The IP address shown in red is that of Netmail Search. Click the IP address to open Netmail Search in a new window.

The following other options are available to you:

  • Enable debug log: Select this option if you want to enable logging for all the Remote Provider nodes.
  • Disable user access: Select this option if you want to temporarily disable end-user access to Netmail Search. If users try to log in during the time user access is disabled, they will see a message notifying them that the system is undergoing maintenance and that they should try to log in again later. This functionality is applied across the entire system.

The List Sessions button produces a report containing the list of all the user names of users who are currently accessing Netmail Search. Information about the users is displayed in a table with the following columns: User Name, Email Address, User Type (Regular User, Case Manager, Auditor), Remote provider, Session Duration. The table can be downloaded in CSV format.

Netmail Secure Diagnostic

This section allows you to test your Netmail Secure system to verify that it is handling mail correctly, as per the policies you have defined.

After the initial setup of Netmail Secure, select the Trial of functionality option, enter an email address (mailbox) that you want to use for the test, and then click Test. Netmail Secure will create the user and then apply all the policies you have created to the email address you have specified. This version of the diagnostic test was built mainly for prospective customers who wish to have an overview of the capabilities of Netmail Secure. The Basic diagnostic option performs essentially the same test as the Trial of functionality option, except that the user is not created; you need to use a real user of your email system. This version of the diagnostic test can verify that all expected policies are in effect.

Once you have launched the test, a Job Status window opens, displaying the test progress and results.

Once the test is complete, you can log in to the test user's mailbox and quarantine to view the results. You (the administrator) should also receive a Quarantine Report, an Executive Report, and an email with information about your Netmail Secure system.

  • No labels
Write a comment…