The document provides instructions for monitoring emails sent and received from BlackBerry devices using Pandora FMS and the Exchange monitoring plugin for Outlook. It discusses installing and configuring the BlackBerry monitoring plugin, which returns modules for measuring email latency and checking for mail arrival. System requirements include Pandora FMS agent, Outlook 2010, and ActivePerl. The monitoring works by searching email subjects and bodies for a reference string like "BlackBerry".
4. 2 INTRODUCTION
The main aim of this document is to explain how to monitor the email sending-receiving from
BlackBerry devices using the Exchange monitoring plugin through Outlook.
2.1. Monitoring working
The BlackBerry Monitoring uses the Exchange monitoring plugin through Outlook. To see more
i n f o r m a t i o n a b o u t t h i s p l u g i n p e r f o r m a n c e , y o u c a n c h e c k t h e
document:“Pandora_monitorización_endtoend”
2.1.1. Exception for the BlackBerry monitoring
To monitor the BlackBerry device emails it was impossible to send in the attached a text string with
the date and hour of the message sending, so for this case we get the date of the email text where it
is located.
To use this feature, the string text of reference (needle parameter) should be:
BlackBerry
3 COMPATIBILITY MATRIX
Page 4
5. The plugin compatibility matrix is the following:
Systems where it has been tested
• Windows Server 2008 Server R2
• Outlook 2010
Systems where it should work • Same system or higher.
It is possible that due to changes in the Outlook future versions it would be necessary to do changes
in the plugin.
4 DOCUMENTATION PROVIDED BY THE REQUESTING AREA
The requesting area must send the following information:
• Machine requirements:
Page 5
6. ◦ Pandora FMS agent installed.
◦ Outlook 2010 installed and properly configured with an account hosted in the Exchange
server.
• Information for modules:
◦ User account used to monitor, for example user@company.com.
◦ Folder which has the emails to monitor, for example “Inbox”.
◦ String to search into mail subject.
◦ Type of check: only_check (only check if there is a mail) or interval (checks mail
latency)
5 MODULES PROVIDED BY THE PLUGIN
The plugin returns two types of modules:
• Send-receive latency which returns the email's delay from send to reception.
Page 6
7. • Check mail arrival which checks whether a mail was received or not
6 REQUISITES
The BlackBerry device emails monitoring requires:
• Windows Operative System with Pandora FMS agent installed.
• ActivePerl 5.8.8 or higher.
Page 7
8. • Outlook 2010 installed and configured with the account where the emails to monitor
arrives at. The Outlook program should be executing at any moment.
• Installation and correct configuration of the Exchange plugin for Outlook, see
“Pandora_monitorización_endtoend” document.
Page 8
9. 7 INSTALLING
To install the plugin you can check the document installing section :
“Pandora_monitorización_endtoend”
8 MONITORING CONFIGURATION
Page 9
10. 8.1. Available Parameters
For the BlackBerry monitoring it is only possible to do latency checks of the emails sending-
reception.
8.2. Configuring the BlackBerry control mails
In the rest of the mails the mail sending data is added to the email Subject field. Due to
restrictions previously mentioned, the BlackBerry service doesn't allow to add the date in
the subject.
To solve this problem the date is added in the mail body. The format of the date that is
shown in the body should follow the normal format, for example:
BlackBerry Confrmaton Test 02/14/2012 11:00:00
It is very important to respect the order of each element (date (mm/dd/yyyy).
In any case the needle parameter in this case should have the value:
9 CREATING A MODULE IN THE AGENT
This plugin is used to execute modules in the agent, so the modules should be added to the agent
Page 10
11. configuration file. An example of use to do the BlackBerry check would be the following:
module_begin
module_type generic_data
module_name Latencia BlackBerry
module_exec perl "C:UsersPandoraDesktopcheck_exchange_outlook.pl" "usuario@microrreo.com"
"Bandeja de entrada" "BlackBerry" interval 900
module_end
Page 11