Embed Size (px)
DESCRIPTION
This plugin monitors the email sending-receiving from BlackBerry devices using the Exchange monitoring plugin through Outlook. For more information visit the following webpage: http://pandorafms.com/index.php?sec=Library&sec2=repository&lng=en&action=view_PUI&id_PUI=573
Citation preview
Pandora FMSAdministrator Manual
BlackBerry Monitoring
Administrator Manual BlackBerry Monitoring
© Artica Soluciones Tecnológicas 2005-2012
Index1Changelog...........................................................................................................................................32Introduction........................................................................................................................................4
2.1.Monitoring working ..................................................................................................................42.1.1.Exception for the BlackBerry monitoring..........................................................................4
3Compatibility Matrix..........................................................................................................................54Documentation provided by the requesting area................................................................................65Modules provided by the plugin.........................................................................................................76Requisites...........................................................................................................................................87Installing.............................................................................................................................................98Monitoring configuration.................................................................................................................10
8.1.Available Parameters ..............................................................................................................108.2.Configuring the BlackBerry control mails...............................................................................10
9Creating a module in the agent.........................................................................................................11
1 CHANGELOG
Date Author Change Version
15/02/12 Dario First version v1r1
Page 3
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
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
◦ 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 [email protected].
◦ 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
• 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
• 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
7 INSTALLING
To install the plugin you can check the document installing section :
“Pandora_monitorización_endtoend”
8 MONITORING CONFIGURATION
Page 9
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 torestrictions previously mentioned, the BlackBerry service doesn't allow to add the date inthe subject.
To solve this problem the date is added in the mail body. The format of the date that isshown 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
configuration file. An example of use to do the BlackBerry check would be the following:
module_beginmodule_type generic_datamodule_name Latencia BlackBerrymodule_exec perl "C:\Users\Pandora\Desktop\check_exchange_outlook.pl" "[email protected]" "Bandeja de entrada" "BlackBerry" interval 900module_end
Page 11
