- Getting Started with GroupWise Mobility Service 2.0
- Preparing the GroupWise System
- Preparing the SUSE Linux Enterprise Server
- Installing GroupWise Mobility Service
- Upgrading GroupWise Mobility Service
- Administering GroupWise Mobility Service
In this chapter, we’ll go over the new GroupWise Mobility Service Dashboard, and various monitoring functions. It’s important to note that we listed the Administrative functions of GroupWise Mobility Service in the previous chapter. While there is a plethora of information contained in the GMS Dashboard, this is not a location where you can “fix” things. This information is read-only, and you will need to either revisit the Users or Service Configuration options from the Navigation bar at the top in order to make any changes that might be necessitated by viewing the Dashboard information.
To get to the new Monitoring Dashboard, simply click the “Dashboard” icon from any location in the Web Console.
The Navigation Bar showing the Dashboard Icon
You will see a screen like in Figure 7-2.
The GroupWise Mobility Service Dashboard
This is really your “system at a glance” section, and can provide you with useful information on the health of your system overall. Green is great; yellow is cautionary; and red means you need to go do some immediate checking!
This screen is broken down into three sections. We will go through them all in detail. For now, let’s just look at the general use of these three sections.
Agents: In the left section of the Dashboard, you can see information on the Sync Agents (GroupWise and Device), the System Monitor and Alerts
Details: The Details section in the middle of the Dashboard has information on users, devices, POAs, and your LDAP and database connections for GroupWise Mobility Service.
Performance Information: The right-hand side of the Dashboard gives you information on the overall performance of your GroupWise Mobility Service.
As you start clicking on items in the dashboard, you will eventually open up to three different sections of information. See Figure 7-3 below.
The Full GroupWise Mobility Service Dashboard
The middle and bottom sections both have an in the upper right of the section, allowing you to close these sections and return to the image in Figure 7-2 when you choose.
While we will attempt to move through the Dashboard with some logical path in mind, as you will see, almost every entry in the Dashboard is clickable. This is fantastic in practice, as it allows you to move through the system quickly to find a particular bit of information, or ferret out a problem. As a systematic view of the Dashboard though, you will see that it becomes rather easy to get sidetracked, like starting on one article in Wikipedia™, and after clicking a few links suddenly wondering how you ended up on the specific article you are reading a few minutes later! In other words, forgive us if we start jumping around a bit!
The Agents Monitor
Prior to GroupWise Mobility Service 2.0, we talked about connectors and engines a lot. GMS 2.0 has changed much of the terminology, and we are now concerned with Agents. This mirrors the terminology of the GroupWise system itself (Post Office Agent and Internet Agent, for example). In the left-hand third of the Dashboard, you will see the section called Agents.
The Agents Overview
In this section we get an overivew of the status, uptime and last refresh of our two agents, as well as a section for alerts.
GroupWise Sync Agent Statistics
Clicking on the words “GroupWise Sync” will open a new window below that has information on various sync statistics.
GroupWise Sync Agent statistics
The first thing to point out here is that is more than meets the eye on this screen. The size of this screen is not long enough to show all of the entries (even on a single Post Office system), and on some browsers you do not see a scroll bar here. But indeed, if you “scroll” through this window you will see more information, and if you have multiple Post Affices that your system contacts you will see connection information for each POA that has been contacted for user information.
There is a lot of information for this screen in the contextual help for the page, so we will not just reiterate it all here. It is important to note though that each of these mini graphs to the right is clickable, and will bring up a window like that shown in
An Expanded Item Graph
The important elements of this window are the graph itself of course, as well as a date picker calendar, a legend that explains the graph, and a clear and export button. The date picker is especially useful in generating views that can be enlightening.
Notice that in Figure 7-7 we have chosen two specific dates in the date picker to the right. This allows us to compare activity from a range of dates or two distant dates for activity. Click on dates to add them to the graph, or click again to remove them. In our testing, there did not seem to be a way to do something like a Shift-Click, for example, to select a large range. Rather we had to click each date to add a range of dates to the graph. That said, clicking the month name will select the entire month for inclusion in the graph.
A month at a glance.
Device Sync Agent Statistics
This screen is very similar to the GroupWise Sync Agent Statistics screen. Here you can see information on various device sync functions, such as failed attachments, oversized attachment statistics, and connection information to the database.
In the System Statistics you can get some very useful server stats. A nice place to see whether you are running low on disk space, or how CPU utilization is doing. As with all other sections of the Dashboard, clicking any of these mini graphs will open a large view for your inspection.
Perhaps one of the most important sections of the Dashboard for most administrators is the Alerts section. Here is where we can see what critical errors might be occurring, what possible actions can be performed to remedy a problem, and where additional resources might be needed in the future, as some of the Caution alerts below can be used to forewarn of pending issues. Figure 7-10 shows the Alerts screen.
Back on Figure 7-4, you see the “Agent Alerts section in red at the bottom. There are three sets of numbers there. These represent yellow-caution/orange-warning/red-critical. This order is reversed in the expanded list, showing critical alerts at the top by default. You can lick the little arrow to the left of the “Last Received” column to reverse the order of display.
Critical: These alerts typically involve a down agent, either in GroupWise Mobility Service itself, or the POA or LDAP server.
Warning: These alerts are typically related to slow downs or device/mailbox issues. Generally they require some kind of administrator intervention.
Caution: These are typically “watch out” types of entries that can alert you to potential issues before they become big problems.
After you have read an alert, click the to delete it.
Most of these alerts link back to another screen that can give more detail. This is accomplished by clicking the entry in the “Location” column for the alert.
For example, Figure 7-10 shows that “danita” is a problem user (okay, no snide comments please!). If you click on the user name in this alerts section, you see the information in Figure 7-11 for the user in question.
Further clicking on the User Alerts in the bottom middle of this screen will show you specific alert information for that user, as shown in Figure 7-12.
Problem User Alerts
You will typically also see a possible solution for the error if there is a maintenance procedure that can be done to deal with the problem. It’s important to understand though that the Dashboard is a “view only” section of GroupWise Mobility Service. If you need to re-initialize a user, for example, you will need to click on the Users navigation icon at the top (leaving the Dashboard), and perform the maintenance as described in “Administering GroupWise Mobility Service”.
The Details Monitor
It seems a bit odd to call this section the “Details Monitor”, but “Details” is indeed how the middle section of the Dashboard is labeled.
The Details section of the Dashboard
In a perfect world, all of the objects in this section of the Dashboard would be green, and connections would all show Active. Of course, that is not always the case, as even exhibited in our own screenshot in Figure 7-13. If anything is not green in any part of your Dashboard, there is a possible issue to be resolved. Here in the Details we have access to the following objects:
We’ll look at the information you can find in each of these sections below.
Clicking on Users in Figure 7-13 will show you a scrolling list of users in you system.
Users in the Dashboard
Here we see the users in our system, and their status. We should point out that if you have “Disabled” users, you will most likely actually see a user name! This figure came from an issue we had during beta, and while it should not happen to you, it is a nice figure to point out that “things sometimes go wrong”. Note that in this figure we see the users and how many devices are configured for each user. There are also mini graphs here as well that can be expanded.
Clicking on a user here will bring up a window with user details. This is usually the ‘middle” block of data (see Figure 7-3), and if that window is already open, you might not readily see that it has changed. You will see information that is listed below.
Here you get information on the user’s Post Office, general sync status, alerts and devices. Again, green is good. You can click on any of the headings to see more detail. This screen has a lot of “context help” by clicking the question marks. We’ll only go over a few specific items here.
In the right-hand block you will see the devices that are configured for the user in question. There is a triangle at the far right of each device, which will show you more detail at a glance.
Here we see the stats for one of Danita’s devices. This device is mostly up to date (Danita gets a lot of mail!), and you can scroll through this list to see more folders.
Large Pending Items
In Figure 7-17 there are a large number of pending items. This shows the possible consequence of allowing users to synchronize a greater date range of information. In this particular image, a user with a large amount of data was re-initialized. This caused what can only be considered an expected result: big backlog of data to synchronize!
If you click on the Devices link under “Details” you will see a scrolling list of the configured devices on your system.
List of Devices
You can see the status, last synced time and type of device here. Notice near the top right there is a magnifying glass icon. If you click in that box, you can search for names of users, or device types. This magnifying glass appears on various windows in the Dashboard, and can be used to limit the number of users or items you are looking at on any given window.
Clicking the POAs link in the Details will show you all of your contacted Post Office Agents, and the status of each.
List of Post Office Agents
Clicking on the Users column for the POA will show you a list of users on that Post Office. Clicking on the mini graphs will expand the graphs for further scrutiny.
While this is labeled LDAP Connection, it really represents the “Directory” connection, whether that be LDAP or GroupWise. The LDAP Connection information is not clickable. This is for information only.
The DB Connection verifies that Postgres is running and that GroupWise Mobility Service can access the database.
The final portion of the Dashboard is the Performance Indicators, to the top right of the Dashboard screen (See Figure 7-2).
You will find information on:
Event Timing: Are there slowdowns in events from the GroupWise Sync Agent or Device Agent? Here you see a snapshot of information. Clicking on Event Timing will open a new window of more detailed statistics.
Event Processing: Event Processing means actual items that are sent/received/discarded, etc. Clicking the Event Processing link will show you more details on events that have been sent, are waiting, failed, etc.
Attachment Sync: Clicking this link will show you not only general statistics for the
As you can see, on paper it is very difficult to sufficiently describe the wealth of information that is available in the new Dashboard. So happy clicking!