How To Monitor GroupWise
Diethmar Rimser
Austria
October 2, 2006
Introduction
1
Who am I?
Diethmar Rimser, Austria
•
•
•
[email protected]
owner of GroupWise.at
responsible for the Austrian branch of GroupWise & Friends
I started with Novell in 1985!
CNI since 1994
In 1996 GroupWise (5) has touched me –
since that milestone in my life my business is
GroupWise.
3
© Novell Inc, Confidential & Proprietary
Agenda
General Considerations
Overview
Installation, Features and Best Practices
Conclusion
4
© Novell Inc, Confidential & Proprietary
2
General Considerations
Why Monitoring?
• How do you get the information if one of your
agents is down? By your users?
• Do you know how many messages are
(concurrently) passing the MTA?
• Do you know how many messages are waiting for
being sent to the internet?
• Do you know how many people will concurrently
use WebAccess?
• How do you know where that mail stucks in your
system?
• Did you ever make some trend analysis?
6
© Novell Inc, Confidential & Proprietary
3
Why Monitoring?
Reactive Management
•
•
•
Troubles will be „announced“
Be prepared if troubles occur!
Be well informed if troubles occur!
Proactive Management
•
•
Measure your system (performance, load, characteristics, …)
Find out your „favorite“ troublemakers
A monitoring tool is powerful helper to find out more
about the characteristics and bottlenecks of your
system. This utility should help you the avoid troubles
and to react faster if you are in trouble.
7
© Novell Inc, Confidential & Proprietary
Overview
4
GroupWise Monitor Overview
Watch the agents
•
•
•
via HTTP or SNMP
General properties – server/agent up or down
Specific surveillance – thresholds
Group your agents
Check the link configuration
•
•
•
Link trace
Link verification
Performance testing
Reports
•
•
•
9
Environment
User, Link traffic
Message tracking
© Novell Inc, Confidential & Proprietary
GroupWise 7 – what‘s new?
•
•
•
10
IPV6 Support
The Monitor Agent supports the IPV6 protocol when it is
available on the server. If it is available, the Monitor Agent
detects it and supports IPV6 by default, along with IPV4.
IPV6 support is available on Linux and Windows.
New Monitor Web Console URL
http://Web_server_address/gw/gwmonitor
Monitor Agent Web Console Emphasized
The Monitor Agent Web console includes functionality that the
Monitor Web console does not.
http://Web_server_address:8200
© Novell Inc, Confidential & Proprietary
5
GroupWise 7 – what‘s interesting?
Enhanced Reports
•
Preparation: monitor domain=external domain(+ link configuration),
monitor post office=external post office, external user to represent
the Monitor Agent; forward all gateway accounting messages to that
user. Configure the Monitor Agent to communicate with the selected
MTA.
•
Accounting Reports:
In the Monitor Agent Web console, click Reports > Gateway
Accounting to view the accounting files.
Trend Reports
The Trends report presents graphs of agent MIB variables as
sampled over time. Click Reports > Trends.
Downtime Report: Reports > Downtime.
Image Map: visual picture of your GroupWise system,
•
•
•
11
© Novell Inc, Confidential & Proprietary
Installation, Features and Best Practices
6
GroupWise Monitor Agenda
Preparation, requirements
Installation
Maintaining the monitor agent
•
•
Configuration
Thresholds and Notifications
Troubleshooting
Using message tracking
Monitoring through a web browser
13
© Novell Inc, Confidential & Proprietary
GroupWise Monitor Prerequisites
Setting up the GroupWise agents for
Monitoring
•
14
Enable Message Logging on all MTA’s
© Novell Inc, Confidential & Proprietary
7
Configuring GroupWise agents…
Define the following settings on each MTA,
POA, GWIA, and WebAccess agent:
•
•
•
HTTP Port
HTTP User
HTTP Password
Use ConsoleOne to define these settings,
rather than the agent startup files.
15
© Novell Inc, Confidential & Proprietary
Accessing the HTTP Ports of Agents
HTTP Port of a GroupWise 7 post office agent
16
© Novell Inc, Confidential & Proprietary
8
Installing GroupWise Monitor Agent
•
The Monitor Agent will run on Linux or Windows
•
Identify what domain the Monitor Agent will read when loading.
•
Install the Monitor Agent on any NT/Linux Class PC. Can be a
Workstation or Server. Does not need to be a high end box.
•
Launch the monitor agent
– by running GWMON.EXE from the install directory or
– Change to cd /opt/novell/groupwise/agents/bin
and start the monitor with
./gwmon --home /domain_directory &
--ipa IP_address --ipp port_number &
17
© Novell Inc, Confidential & Proprietary
GroupWise Monitor Communication
Monitor communicates with the agents in one
of two ways
•
•
XML over HTTP (primary and preferred method)
SNMP (secondary method)
– GroupWise 5.5 and earlier versions of the agents
– Gateways
18
© Novell Inc, Confidential & Proprietary
9
GroupWise Monitor Communication
(cont.)
19
© Novell Inc, Confidential & Proprietary
Defining a domain for monitor agent
•
•
•
21
The monitor agent is pointing to a GroupWise domain
database (WPDOMAIN.DB) in order to read the GroupWise
system configuration.
Consider creating a secondary domain on the monitor
machine.
If using Windows install the agents as services to run against
this particular secondary domain.
© Novell Inc, Confidential & Proprietary
10
Introduction to Monitor
Reading the main screen
Agent details
•
•
•
•
22
Address
Exceeded thresholds
MIB values
Notes
© Novell Inc, Confidential & Proprietary
Viewing Agent Console
The agent console dialog looks like the NT
agents, no agent console for Linux
MTA’s “Queue Watch” allows you to see
•
•
•
•
•
23
All of the domains and post offices to which that MTA directly
connects
The state of the link
The state of the queues
Agent settings
Configuration status
© Novell Inc, Confidential & Proprietary
11
Configuration Menu Items
HTTP
•
•
•
•
Set the poll time
Set the rate at which the browser pages refresh
Set the password used when accessed by a browser
Set the port monitor listens on for HTTP requests
SNMP
•
Set retries, timeouts, and community strings
Filter
•
24
Lets you filter which agents you want to monitor
© Novell Inc, Confidential & Proprietary
Notification
SMTP
•
Notification is done directly from the monitor so that we don't
get messages backed up in the GroupWise system that could
be having a problem
SNMP traps
•
•
Can send traps to an SNMP management system
Can receive traps from GroupWise agents
Sounds
•
25
Sounds can be defined that will play when various events
occur
© Novell Inc, Confidential & Proprietary
12
Thresholds
Thresholds
•
•
•
•
26
Lets you set thresholds on any of the variables exported by the
agents
You pick the state the agent will be in if the threshold is
exceeded
To give more granularity you can define your own state
This allows you to have a states called “MTA backed up” or
“POA overloaded”
© Novell Inc, Confidential & Proprietary
Log Menu
Log Settings
•
Lets you determine the path for the log file, how old they can
be, and how much disk space they can take
View Log Files
•
Lets you view the event log files
View History Files
•
27
Lets you view the history log files
© Novell Inc, Confidential & Proprietary
13
Adding Other Agents
Discover Machine
•
Type in the IP address of a machine, (DNS names work as
well), and the monitor will discover all the agents that are
running on that machine
Discover Network
•
Type in a subnet, and it will find all the agents on that subnet
Add Agent
•
28
Lets you add a single agent to the list of agent that are
monitored
© Novell Inc, Confidential & Proprietary
Configuring the Monitor Agent
•
Create folders to organize agents into groups
Can drag any agent into appropriate folder
•
•
29
Monitor agent provides hierarchal management of agents via
various groups.
“Parent” group settings can be applied to “child” groups
© Novell Inc, Confidential & Proprietary
14
Configuring the Monitor Agent (cont.)
May want to configure NT Box to send SNMP
traps if desired. Accessed under Services |
SNMP Service
•
Can define community strings, and destination SNMP
Management tool to send traps too.
Enable HTTP User and password protection
on Monitor Agent.
•
30
consider enabling intruder detection.
© Novell Inc, Confidential & Proprietary
Domain Threshold Best Practices
Suggested Domain Thresholds
31
© Novell Inc, Confidential & Proprietary
15
Post Office Threshold Best Practices
Suggested Post Office Thresholds
32
© Novell Inc, Confidential & Proprietary
GWIA Threshold Best Practices
Suggested GWIA Thresholds
33
© Novell Inc, Confidential & Proprietary
16
WebAccess Threshold Best Practices
Suggested WebAccess Thresholds
34
© Novell Inc, Confidential & Proprietary
Configuration Conclusion
A lot of settings, a lot of work (especially
thresholds)
But only one file is holding all the information!
Monitor.xml
Save this file!
35
© Novell Inc, Confidential & Proprietary
17
Troubleshooting Tools
Link Trace
•
•
Allows you to trace the links from one domain to another
You see all the intermediate MTAs as well as the state of the
next link (open, blocked, etc.) and how many messages are
backed up going to the next link
Link Verification
•
•
36
Lets you see how a domain connects to all other domains
This will flag problems with the configuration, such as a loop in
the system
© Novell Inc, Confidential & Proprietary
Performance Testing
Monitor
Corporate
MTA
Utah
Colorado
MTA
MTA
Provo
Denver
Post Office
Agent
Post Office
Agent
37
© Novell Inc, Confidential & Proprietary
18
Reports
Environment
•
•
Shows the platform information for each of the agents you are
filtering on
This includes OS version, CLIB version, DS, and TCP/IP
Novell NetWare Loadable Module™ (NLM™) version, number
of packet receive buffers, etc.,
– This list could be mailed directly to support
User traffic
•
•
38
Lets you see how much traffic a user has sent through a
particular MTA
Requires message logging be active on the MTA in question
© Novell Inc, Confidential & Proprietary
Reports (cont.)
Link traffic
•
•
•
Lets you see how much traffic an MTA has sent over its links
This report and the user traffic report can be saved and pulled
up into a spreadsheet for graphing or other analysis
Requires message logging be active on the MTA in question
Message tracking
•
•
•
39
Tracks a message through the system
This allows the administrator to quickly find a message a user
sent that has not yet been delivered
Requires message logging be active on the MTA in question
© Novell Inc, Confidential & Proprietary
19
New Reports for GroupWise 7
Enhanced Reports
•
Preparation: monitor domain=external domain(+ link configuration),
monitor post office=external post office, external user to represent the
Monitor Agent; forward all gateway accounting messages to that user
Configure the Monitor Agent to communicate with the selected MTA.
•
Available via Monitor Agent:port (f.e. 8200)
•
Accounting Reports:
In the Monitor Agent Web console, click Reports > Gateway Accounting
to view the accounting files.
Trend Reports
The Trends report presents graphs of agent MIB variables as sampled
over time. Click Reports > Trends.
Downtime Report: Reports > Downtime.
Image Map: visual picture of your GroupWise system
•
•
•
40
© Novell Inc, Confidential & Proprietary
Conclusion
20
Watch Your System
It's so easy to watch your system
•
•
•
•
Software for monitoring is included
Use it proactive!
Use it to get the right hints if your GroupWise is in trouble!
Use it to work out how important this GroupWise is for your
company (=trends)!
You need more?
44
© Novell Inc, Confidential & Proprietary
Third Party Products
Control from IntelliReach
Redline from GWAVA
45
© Novell Inc, Confidential & Proprietary
21
Unpublished Work of Novell, Inc. All Rights Reserved.
This work is an unpublished work and contains confidential, proprietary, and trade secret information of Novell,
Inc. Access to this work is restricted to Novell employees who have a need to know to perform tasks within the scope
of their assignments. No part of this work may be practiced, performed, copied, distributed, revised, modified,
translated, abridged, condensed, expanded, collected, or adapted without the prior written consent of Novell, Inc. Any
use or exploitation of this work without authorization could subject the perpetrator to criminal and civil liability.
General Disclaimer
This document is not to be construed as a promise by any participating company to develop, deliver, or market a
product. Novell, Inc., makes no representations or warranties with respect to the contents of this document, and
specifically disclaims any express or implied warranties of merchantability or fitness for any particular purpose. Further,
Novell, Inc., reserves the right to revise this document and to make changes to its content, at any time, without
obligation to notify any person or entity of such revisions or changes. All Novell marks referenced in this presentation
are trademarks or registered trademarks of Novell, Inc. in the United States and other countries. All third-party
trademarks are the property of their respective owners.
22