Blackberry PRD-07630-011 - Enterprise Server - PC, Manual

Page 1: ...BlackBerry Enterprise Server Version 5 0 Service Pack 3 Monitoring Guide ...

Page 2: ...Published 2011 03 07 SWD 1398426 0307061008 001 ...

Page 3: ...erry Configuration Database 13 Monitor the BlackBerry Configuration Database 13 Data attributes of the BlackBerry Configuration Database connections 13 Monitor connections to the BlackBerry Configuration Database 14 Monitoring BlackBerry Enterprise Server components that you configured for high availability 14 Status of BlackBerry Enterprise Server components in the BlackBerry Monitoring Service c...

Page 4: ...the alarm panel 29 Sort thresholds in the alarm panel 29 Suspend and resume alarms 30 Delete alarms 30 6 Configuring notification messages 31 Configuring how the BlackBerry Monitoring Service sends notification messages 31 Configure the BlackBerry Monitoring Service to send notification messages to email addresses through a messaging server in your organization s environment 31 Configure the Black...

Page 5: ...mport a new SSL certificate for the BlackBerry Monitoring Service 43 10 BlackBerry Monitoring Service log files 45 Changing how BlackBerry Monitoring Service components create log files 45 Change the maximum size of the log file for a BlackBerry Monitoring Service component 45 Change the logging level for a BlackBerry Monitoring Service component 45 Create a new log file for a BlackBerry Monitorin...

Page 6: ...rise Server supports 57 MIBs for the BlackBerry Enterprise Server 58 Configuring SNMP monitoring 58 System requirements SNMP monitoring software and settings for the SNMP service 58 Verifying the SNMP agent settings in the Registry Editor 59 Compile the MIB for a BlackBerry Enterprise Server and configure the SNMP management tool to receive SNMP data 59 Configuring SNMP traps 60 Configure the SNMP...

Page 7: ...sole provides configuration settings and statistics that you can use to review BlackBerry Enterprise Server activity BlackBerry device dashboard You can use the BlackBerry device dashboard to access the BlackBerry Monitoring Service from BlackBerry devices You can view alarms messages and the monitoring status of BlackBerry Enterprise Server instances and BlackBerry Enterprise Server components Th...

Page 8: ... that the BlackBerry Monitoring Service monitors reaches a threshold the BlackBerry Monitoring Service displays an alarm in the BlackBerry Monitoring Service console and sends notification messages to specific contacts notification messages You can configure the BlackBerry Monitoring Service to send notification messages to one or more recipients by creating a contact A contact can include one or ...

Page 9: ...e on the taskbar click Start All Programs BlackBerry Enterprise Sever BlackBerry Monitoring Service Roles and permissions for the BlackBerry Monitoring Service console To access the BlackBerry Monitoring Service console you can use a valid Microsoft Active Directory account a valid Novell GroupWise messaging server account the administrator account that you created when you installed the BlackBerr...

Page 10: ...hes for BlackBerry device user accounts views statistics for BlackBerry device user accounts generates reports creates charts views alarms in the alarm panel views messages in the messages area cannot perform the following actions start or stop monitoring a server create or change thresholds save or delete reports clear suspend or resume alarms delete messages from the messages area create or chan...

Page 11: ...terprise Server Administration Guide Overview of the BlackBerry Monitoring Service console The BlackBerry Monitoring Service console is a web based administration tool that you can use to monitor BlackBerry Enterprise Server components and BlackBerry device users The BlackBerry Enterprise Server installation process provides you with the web address that you can use to access the BlackBerry Monito...

Page 12: ...se Server components The BlackBerry device dashboard is available for BlackBerry devices that are running BlackBerry Device Software version 4 5 or later To access the BlackBerry device dashboard you must configure your BlackBerry device to use a direct TLS connection In the BlackBerry device options on the Security Options menu on the TLS screen you must configure the TLS Default setting to Handh...

Page 13: ...ction in the appropriate fields type the SNMP port number and community name for the computer that hosts the BlackBerry Enterprise Server The community name is case sensitive 5 Select the Turn on monitoring check box 6 Click Save Turn on monitoring for a non SNMP server If you turn on monitoring for a non SNMP server the BlackBerry Monitoring Service retrieves data about the BlackBerryConfiguratio...

Page 14: ...menu expand BlackBerry solution topology BlackBerry domain Components 2 Expand a BlackBerry Enterprise Server component 3 Click an instance of the component 4 On the appropriate tab locate the configuration settings or data attributes that you want to view Related topics Create a threshold that you can use to monitor a BlackBerry Enterprise Server component 23 Generate a graph that shows data for ...

Page 15: ...lackBerry Configuration Database in the BlackBerry Monitoring Service console 1 In the BlackBerry Monitoring Service console on the Monitoring menu expand BlackBerry solution topology BlackBerry domain Components Database 2 Click an instance of the BlackBerry Configuration Database 3 Perform one of the following actions to locate the data attribute that you want to monitor On the Configuration tab...

Page 16: ...le on the Monitoring menu expand BlackBerry solution topology BlackBerry domain Components 2 Expand a component 3 Click an instance of the component 4 On the Database connection tab view the connection data attributes Monitoring BlackBerry Enterprise Server components that you configured for high availability If you create thresholds to monitor data attributes of BlackBerry Enterprise Server compo...

Page 17: ...e console BlackBerry Attachment Service load balanced pool primary no change BlackBerry Messaging Agent failover standby BlackBerry Controller failover standby BlackBerry Dispatcher failover standby BlackBerry Collaboration Service failover standby BlackBerry MDS Connection Service failover standby BlackBerry Policy Service failover not displayed BlackBerry Router load balanced pool primary no cha...

Page 18: ... is b In the less than drop down list click greater than c In the first field from the left type 0 d In the second field from the left type 10 e In the minute drop down list click minute f In the warning drop down list click the alarm severity for the rule If you changed the registry settings for the number of times that the BlackBerry Messaging Agent sends SNMP trap messages when the BlackBerry M...

Page 19: ...e uses the SNMP data to monitor the components in the BlackBerry Monitoring Service console A BlackBerry Router or BlackBerry Controller that is located on a computer that is separate from the computer that hosts the BlackBerry Enterprise Server does not send SNMP data to the BlackBerry Monitoring Service Monitoring Guide BlackBerry Enterprise Server components that the BlackBerry Monitoring Servi...

Page 20: ...n view the configuration settings to identify information such as the BlackBerry device PIN or the IT policies that you applied to the BlackBerry device user You can view a data attribute to identify the currentactivity level orstatusoftheBlackBerrydeviceuser andyoucandefinethresholds thatyoucanusetomonitor a data attribute of a BlackBerry device user You cannot define thresholds to monitor config...

Page 21: ...ialized user accounts click the display name for a user account The reason that the device is not initialized is displayed in red font near the top of the window Related topics Generate and view a default report about BlackBerry device users 37 BlackBerry device diagnostic test The BlackBerry device diagnostic test in the BlackBerry Monitoring Service console uses the diagnostic tool client that i...

Page 22: ...ximately 40 minutes on the Device Diagnostics statistics tab in the Configuration section check the Time stamp value to determine whether the diagnostic test results are current If the diagnostic test results are not current the BlackBerry Monitoring Service console displays the results of a previous diagnostic test Run a diagnostic test for a BlackBerry device from the BlackBerry device The Black...

Page 23: ...y device and to determine the response time of the BlackBerry device in seconds 1 In the BlackBerry Monitoring Service console on the Monitoring menu expand Users 2 Click Monitor users 3 Search for a user account 4 Click the display name for the user account 5 Click Run ping test Monitoring Guide Ping a BlackBerry device 21 ...

Page 24: ...or the threshold the BlackBerry Monitoring Service generates a notification message and displays an alarm in the BlackBerry Monitoring Service console Thresholds and rules can have one of the following alarm states fail state of error fail state of warning fail state of critical pass state not configured For example if you create a rule with an alarm severity of critical any activity of the data a...

Page 25: ...In the Rule section click Add rule 6 In the Rule section select the Active check box 7 Use the drop down lists to specify the conditions of the rule 8 For BlackBerry Enterprise Server components that you configured for high availability in the Scope section in the High Availability Scope drop down list click one of the following options To continue monitoring a component after a failover occurs cl...

Page 26: ...Save Example Monitoring how often an encryption key is generated for a BlackBerry device If you want to monitor how often an encryption key is generated for a BlackBerry device and you want to create multiple alarm severities you can create a threshold for the data attribute that is named Last generation time for the encryption key if you define multiple time based rules for the threshold The orde...

Page 27: ...onitor Users c Search for a user account d Click the display name for the user account 2 On the tab for the data attribute you want to change a rule for click the data attribute 3 In the Rule section in the Actions column click the wrench icon for the rule that you want to change 4 In the Rule section change the conditions of the rule 5 Click Save 6 Click Save Delete a rule 1 Perform one of the fo...

Page 28: ...vice console and the BlackBerry Monitoring Service generates a warning alarm If you create a second rule for a threshold with an alarm severity of critical the BlackBerry Monitoring Service maintains the alarm severity of warning for the threshold To update the threshold with the alarm severity of critical a red icon you can reorder the rules manually so that the BlackBerry Monitoring Service proc...

Page 29: ...In the BlackBerry Monitoring Service console on the Monitoring menu expand BlackBerry solution topology BlackBerry domain Components b Expand a component c Click an instance of a component Locate a threshold for a data attribute of a BlackBerry device user a In the BlackBerry Monitoring Service console on the Monitoring menu expand Users b Click Monitor Users c Search for a user account d Click th...

Page 30: ...m severity for the rule When the activity of the data attribute that you created a threshold for meets the conditions of a rule the threshold goes into a fail state When thethresholdgoesintoafailstate thealarmpanelintheBlackBerryMonitoringServiceconsoledisplaysthethreshold with the following information date and time that the threshold went into a fail state alarm severity critical error or warnin...

Page 31: ...for a component a In the BlackBerry Monitoring Service console on the Monitoring menu expand BlackBerry solution topology BlackBerry domain Components b Expand a component c Click an instance of the component Check for alarms for a BlackBerry device user a In the BlackBerry Monitoring Service console on the Monitoring menu expand Users b Click Monitor Users c Search for a user account d Click the ...

Page 32: ... one of the following actions To suspend one alarm click Suspend beside the appropriate alarm To suspend all alarms click Suspend all After you finish To re activate one or more of the alarms perform one of the following actions To re activate one alarm click Resume beside the appropriate alarm To re activate all alarms click Resume all Delete alarms 1 In the BlackBerry Monitoring Service console ...

Page 33: ...ssaging server 5 To test the SMTP settings send a test email message a In the Test address field type your email address b Click Test email c Check the inbox of your email account to confirm that the BlackBerry Monitoring Service sent the test email message 6 Click Save Configure the BlackBerry Monitoring Service to send SMS text messages To send notification messages as SMS text messages from the...

Page 34: ...or more intended recipients using email addresses PINs phone numbers that support SMS text messages or IP addresses that can receive SNMP trap messages If a threshold goes into a pass state or fail state the BlackBerry Monitoring Service sends notification messages to recipients that you specified in the BlackBerry Monitoring Service console when you created the contacts Beforeyoucancreatecontacts...

Page 35: ...number and SNMP community name of the computer in the Address field after the IP address type the SNMP port number and SNMP community name using the following format ip_address port_number community 7 Click Save Add contact information for a BlackBerry device user in your organization s BlackBerry Domain You can add the email address PIN or phone number of BlackBerry device users that are part of ...

Page 36: ...t when the BlackBerry Monitoring Service receives an SNMP trap message select the Notify on event check box 8 To add addresses to the contact in the Available addresses list select the addresses and click Add 9 To specify the BlackBerry Enterprise Server components that have thresholds that you want to notify the contact about perform the following actions a In the Available servers list select th...

Page 37: ...eceive SNMP trap messages Do not install a third party SNMP trap viewer on the computer that hosts the BlackBerry Monitoring Service because the BlackBerry Monitoring Service might not receive or display the SNMP trap messages Receive SNMP trap messages from BlackBerry Enterprise Server instances Before you begin You must configure the computers that host the BlackBerry Enterprise Server instances...

Page 38: ...lackBerry Enterprise Server instance fails over Each message in the messages area includes the date time and a short description of the event that occurred View messages 1 In the BlackBerry Monitoring Service console on the Monitoring menu click Messages 2 Click the envelope icon beside the appropriate message Delete messages 1 In the BlackBerry Monitoring Service console on the Monitoring menu cl...

Page 39: ...or a custom report and generate a new report using the same settings the next time that you log in to the BlackBerry Monitoring Service console Each time you generate a custom report using saved settings the report contains current data Generate and view a default report about BlackBerry device users You can generate default reports to view data about all of the BlackBerry device users in your org...

Page 40: ...ection select the format for the custom report 11 To limit the number of records that the BlackBerry Monitoring Service returns in the custom report perform the following actions Clear the All check box In the Show rows field type the number of records 12 To save the report settings so that you can generate a new report using the same settings later select the Save report configuration check box 1...

Page 41: ...ce console on the Monitoring menu expand Reporting 2 Click View generated reports 3 Click the trash can icon beside the appropriate report 4 Click OK Monitoring Guide Generating reports about BlackBerry device users and BlackBerry Enterprise Server components 39 ...

Page 42: ...ce window for the computer that hosts the component to run at different times the BlackBerry Monitoring Service suspends monitoring of the threshold for the entire time that the threshold maintenance window and server maintenance window are running Specify maintenance windows 1 In the BlackBerry Monitoring Service console on the Configuration menu expand Servers 2 Click Manage servers 3 Click the ...

Page 43: ... the BlackBerry Monitoring Service console on the Configuration menu expand Servers 2 Click Manage servers 3 Click the wrench icon beside the server that hosts the BlackBerry Enterprise Server component 4 Click Test configuration settings Change SNMP port numbers and community names If you change the SNMP port number and community name of a computer that hosts a BlackBerry Enterprise Server compon...

Page 44: ...ervice uses for SSL encryption you must change the password in the BlackBerry Server Configuration dialog box and run the WebGenKey bat file in a command prompt window The key store password must contain a minimum of six characters in alphanumeric format 1 OnthecomputerthathoststheBlackBerryMonitoringService clickStart AllPrograms BlackBerryEnterprise Server BlackBerry Server Configuration 2 On th...

Page 45: ... the certification authority to the computer that hosts the BlackBerry Monitoring Service 1 On a computer that hosts the BlackBerry Monitoring Service in drive Program Files Research In Motion BlackBerry Enterprise Server Monitoring Service bin web keystore back up the web keystore file 2 Open a command prompt window 3 Use the Java keytool in drive Program Files Java JRE_version bin to generate a ...

Page 46: ... and save it with a cer file extension 8 Use the Java keytool to import the certificate to the web keystore file by typing keytool importcert alias alias_name keypass password storepass keystore password keystore drive Program Files Research In Motion BlackBerry Enterprise Server Monitoring Service bin web keystore file certificate_filename cer where alias_name is the alias that you created in ste...

Page 47: ...he Windows Services restart the BlackBerry Monitoring Service services Change the logging level for a BlackBerry Monitoring Service component You can change the logging level for a BlackBerry Monitoring Service component so that you can specify how much information the BlackBerry Monitoring Service saves in the log files 1 On the computer that hosts the BlackBerry Monitoring Service on the taskbar...

Page 48: ...g Service component ThenameofthelogfileforaBlackBerry MonitoringServicecomponentcontainsanidentifiersothatyoucanidentify the BlackBerry Monitoring Service component that logs information in the log file For example a log file that you name BBServer01_BBMS APP _01_20080120_001 txt uses BBMS APP as the default identifier for the BlackBerry Monitoring Service Application Core component 1 On the compu...

Page 49: ...cter encoding of the log file for a BlackBerry Monitoring Service component You can change the character encoding of the log files for a BlackBerry Monitoring Service component so that the encoding supports the tools that you use to parse and examine the log files You can specify a different character encoding for each BlackBerry Monitoring Service component You can use the ANSI UTF 8 and UTF 16LE...

Page 50: ...u can create a configuration file to change the settings that the tool uses to create appropriate thresholds If you use the default settings the tool creates thresholds that have the following rules alarm severity of warning for low activity levels alarm severity of warning for high activity levels You can change the settings in the configuration file so that the tool creates thresholds that have ...

Page 51: ...s avgrsptime Messaging Agent Database connections Errors DCS_besagent_databaseconn_connectionstats errs Controller Attachment Service connection Restarts DCS_controller_attachmentsconn_stats numrestart Controller Messaging Agent connection Restarts DCS_controller_mailagentsconn_stats numrestart Controller Synchronization Service connection Restarts DCS_controller_syncsconn_stats numrestart Control...

Page 52: ...m_imstats imkbytes MDS Connection Service Statistics Processing queue length DCS_mdscs_stats procqlen MDS Connection Service Statistics Push connections packets DCS_mdscs_mdsstatsfrom pushconnectionspacketcount MDS Connection Service Statistics Active push connections DCS_mdscs_mdsstatsto mthconnectionsinmemory MDS Connection Service Statistics Truncated connections DCS_mdscs_mdssummary truncatedc...

Page 53: ...y Threshold Analysis Tool creates thresholds You can save the configuration file on the computer that hosts the BlackBerry Monitoring Service in the folder where the thresholdtool exe file is located By default the location of the thresholdtool exe file is drive Program Files Research In Motion BlackBerry Enterprise Server Monitoring Service tools The configuration file must be a txt file and use ...

Page 54: ...ool deactivates but does not delete rules that it created prior to when you run the tool and the tool adds Historical to the notes section for the rule in the BlackBerry Monitoring Service console for each rule that it created prior to when you run the tool The default value is auto number of days to maintain historical proposed rules 0 to 30 This parameter specifies the number of days that the to...

Page 55: ...tribute to create two rules with alarm severities of warning For example if you configure 0 8 as the value for the warning trigger parameter the tool uses the lowest and highest values that total 0 8 of the total activity of the data attribute If you do not specify the critical trigger or error trigger parameter the default value is 0 8 If you specify the critical trigger or error trigger paramete...

Page 56: ...og files on the computer that hosts the BlackBerry Monitoring Service in drive Program Files Research In Motion BlackBerry Enterprise Server Logs Run the BlackBerry Threshold Analysis Tool Before you begin On the computer that hosts the BlackBerry Monitoring Service in the Windows Services stop the BlackBerry Monitoring Service Application Core service 1 On the computer that hosts the BlackBerry M...

Page 57: ...it createsintheBlackBerryMonitoring Service console and does not store the rules in the BlackBerry Monitoring Service database You can specify this parameter if you want to test the settings in a configuration file that you created or to preview the rules that the tool creates in the command prompt window or log file yes if you do not specify the update h or parameter i file_name_of_configuration_...

Page 58: ... in the BlackBerry Monitoring Service console To prevent the tool from overwriting a rule that you changed in the BlackBerry Monitoring Service console in the notes section for a rule delete Proposed rule When you delete Proposed rule the tool does not identify that the tool created the rule and does not overwrite the rule with a new rule when you run the tool Monitoring Guide Running the BlackBer...

Page 59: ...anagement tool By default the SNMP management tool displays the OID of a condition An OID is a sequenceofintegersthatidentifiesaclassvaluewithinaclasshierarchy AllSNMPOIDsandSNMPtrapsforBlackBerry Enterprise Server version 5 0 begin with the class value 1 3 6 1 4 1 3530 6 To uniquely identify a class value within a class each OID value is distinguished by a suffix for example 25 1 1 The BlackBerry...

Page 60: ...o maintain compatibility with the current monitoring system when you upgrade your organization s environment to the latest BlackBerry Enterprise Server version Configuring SNMP monitoring Systemrequirements SNMPmonitoringsoftwareandsettingsfortheSNMP service Item Requirement SNMP monitoring software SNMP service that includes an SNMP agent on the computer that hosts the BlackBerry Enterprise Serve...

Page 61: ...Y_LOCAL_MACHINE SOFTWARE Research In Motion BlackBerry Enterprise Server Monitoring Service SNMPAgent CurrentVersion PathName C Program Files Research In Motion BlackBerry Enterprise Server Monitoring Service dll BMSI_SNMP_Agent dll HKEY_LOCAL_MACHINE SYSTEM CurrentControlSet Services SNMP Parameters ExtensionAgents RIM SNMPAgent SOFTWARE Research In Motion BlackBerry Enterprise Server Monitoring ...

Page 62: ...uter that is separate from the computer that hosts the BlackBerry Enterprise Server you must specify where the SNMP trap service can send SNMP trap messages to Before you begin Verify that you installed the SNMP service on the computer that hosts the BlackBerry Enterprise Server and that SNMP service is running On the computer that hosts the BlackBerry Enterprise Server in the Windows Services cha...

Page 63: ...gate port to use a specific port number and open the port on the firewall by performing the following actions 1 On the computer that hosts a BlackBerry Administration Service instance navigate to drive Program Files Research In Motion BlackBerry Enterprise Server BAS server default conf 2 In a text editor open service port bindings xml 3 Intheparagraphcluster service xml uncommenttheline attribute...

Page 64: ... is an identification number that each computer or mobile device uses when it sends or receives information over a network such as the Internet This identification number identifies the specific computer or mobile device on the network JNDI Java Naming and Directory Interface messaging server A messaging server sends and processes messages and provides collaboration services such as updating and c...

Page 65: ...imple Network Management Protocol SRP Server Routing Protocol SSL Secure Sockets Layer TLS Transport Layer Security UCS Universal Content Stream UTF UCS Transformation Format Monitoring Guide Glossary 63 ...

Page 66: ...Provide feedback 15 To provide feedback on this deliverable visit www blackberry com docsfeedback Monitoring Guide Provide feedback 64 ...

Page 67: ...nd Services RIM does not control and is not responsible for any Third Party Products and Services including without limitation the content accuracy copyright compliance compatibility performance trustworthiness legality decency links or any other aspect of Third Party Products and Services The inclusion of a reference to Third Party Products and Services in this documentation does not imply endors...

Page 68: ...NSSETOUTABOVE INNOEVENTSHALLANYDIRECTOR EMPLOYEE AGENT DISTRIBUTOR SUPPLIER INDEPENDENT CONTRACTOR OF RIM OR ANY AFFILIATES OF RIM HAVE ANY LIABILITY ARISING FROM OR RELATED TO THE DOCUMENTATION Prior to subscribing for installing or using any Third Party Products and Services it is your responsibility to ensure that your airtime service provider has agreed to support all of their features Some ai...

Page 69: ...DE ANY EXPRESS WRITTEN AGREEMENTS OR WARRANTIES PROVIDED BY RIM FOR PORTIONS OF ANY RIM PRODUCT OR SERVICE OTHER THAN THIS DOCUMENTATION Research In Motion Limited 295 Phillip Street Waterloo ON N2L 3W8 Canada Research In Motion UK Limited Centrum House 36 Station Road Egham Surrey TW20 9LF United Kingdom Published in Canada Monitoring Guide Legal notice 67 ...