Installing BlackBerry Enterprise Server (BES) on a Lotus Notes Domino system is relatively straightforward, but you need to pay careful attention to certain configuration issues to avoid availability and performance problems. These eight best practices and maintenance tips will keep BlackBerry Enterprise Server running properly in your Lotus Notes Domino environment.
- Is the Domino server running the BlackBerry Enterprise Server software either in the LocalDomainServers group or a part of the standard server organizational unit (OU)? (Some environments are configured to have all the Lotus Domino servers in their own OU so they can be referenced using "/YourServerOU/YourOrganization") You should add the Lotus Domino server (or the LocalDomainServers group or wild-card reference) to a group called "BlackBerry Admins" (or something similar). This group can then be used for all access control list (database- and server-level) needs.
Related BlackBerry resources for Lotus Notes Domino: Stop spam on BlackBerry mobile devices
- Add BES task to the ServerTasks line in the notes.ini file of the Lotus Domino server running BlackBerry Enterprise Server. As an alternative option, you can also configure Domino to load the BES task using a program document instead of creating a direct reference in notes.ini. If not added to the ServerTasks line or in a program document, the administrator has to launch BES manually from the console each time the server is restarted by using "load BES" at the console.
- In the user-state databases, make certain that the special BlackBerry Admin group you set up is in the ACL with 'Manager' rights. Members of the BlackBerry Admin group need 'Manager' access so they can update the ACL, delete the database should the user be removed from the system, as well as perform any other database maintenance that might be necessary on the state databases.
- If not using roaming profiles, user mail files should be configured using the Domino Web Access mail template in order for Personal Information Management (PIM) synchronization to work properly. (In Lotus Notes Domino 5.x, it's known as the iNotes mail template.)
- If a profile database becomes corrupt, delete the database and restart Domino Server to recreate the profile database from the Microsoft SQL Server information (if using a version of BlackBerry Enterprise Server version 4.1 or later, an IBM DB2 server could also be used).
- Make sure port 3101 (TCP) is open on the firewall for outbound initiated BlackBerry messages. It is a TCP/IP operation that maintains the state relationship for communication.
- On BlackBerry, enable database pruning -- it keeps the size of user state databases in check. When the pruning process runs, it selects 20 users to process (their state database) each night at the designated time. The Domino agent tries to remove documents in the state databases of the 20 users in 20 minutes. If it cannot, the agent terminates. If it completes the initial 20 and has extra time, it will start work on another user outside of the original 20 selected.
About the author: Michael "Mike" Kinder is a senior application developer for a software company in Caribou, Maine, where he both develops in and administers a Lotus Notes Domino environment. Mike has more than 12 years experience with Lotus Notes and Domino and has worked in many different environments. He is currently available for consulting opportunities in both development and administration. To keep sharp, he dabbles in C# .NET, Java, Web technologies, and C++.
With regards to enabling database pruning on BlackBerry, as noted in #8, where exactly is this setting enabled? Is it enabled in Domino, since that's where the state databases are stored, on the BES, or on the BlackBerry device itself?
Based on your question, I'll address where the database pruning setting is maintained on the Blackberry server.
From the BES server software, select the server. You'll see a navigational tool in the lower right-hand pane of the screen. In the "Service Control and Customization" area, select "State Database Pruning." A dialog box will appear with choices. The settings are pretty obvious, but there are some limits. To enable this option, be sure that the checkbox at the top is not checked. Checking this box actually disables the setting.
Michael Kinder, tip author
Do you have comments on this tip? Let us know.
Please let others know how useful this tip is via the rating scale below. Do you have a useful Lotus Notes, Domino, Workplace or WebSphere tip or code snippet to share? Submit it to our tip contest and you could win a prize.
This was first published in August 2007