Blackbe;rry Enterprise Server 4.1 User manual

BlackBerry Enterprise Server for
IBM Lotus Domino
Version 4.1 Service Pack 6
Technical Note: Impact of Supporting HTML and Rich-content
Email Messages
©2008 Research In Motion Limited. All rights reserved. www.rim.com

BlackBerry Enterprise Server for IBM Lotus Domino
Technical Note: Impact of Supporting HTML and Rich-content Email Messages 2 of 5
Last saved: 17/07/2008
www.rim.com
Overview
BlackBerry®Enterprise Server version 4.1 SP6 supports users sending and receiving MIME/HTML
and IBM®Lotus Notes®Rich Text email messages using BlackBerry devices that are running
BlackBerry®Device Software version 4.5 or later. By default, support for MIME/HTML and IBM Lotus
Notes Rich Text email messages is turned on. You can turn off this feature using the BlackBerry
Manager.
This document outlines the expected impact of supporting MIME/HTML and IBM Lotus Notes Rich
Text email messages on the BlackBerry Enterprise Server. This feature might cause the BlackBerry
Enterprise Server to use increased amounts of virtual memory and CPU resources. The BlackBerry
Enterprise Server process (nbes.exe) runs as a task on an IBM®Lotus®Domino®server within your
organization’s environment. In a 32-bit operating system, the addressable virtual memory for a
process is limited to 2 GB. If a process tries to reserve memory that exceeds this limit, the process
stops responding.
Load test conditions
Load tests were run to determine the impact of supporting MIME/HTML and IBM Lotus Notes Rich
Text email messages on BlackBerry Enterprise Server version 4.1 SP6. The load tests were
conducted under certain load conditions; the results experienced in your organization’s environment
might be different.
One set of load tests used MIME/HTML email messages only. Another set of load tests used IBM
Lotus Notes Rich Text email messages only. During each load test, messages were sent to 2000
BlackBerry device users.
Percent of
messages (%) Contents Size (KB)
68 HTML table and HTML signature 82
13 HTML table, HTML signature, and small GIF 380
12 HTML link with media content 307
7 HTML table, HTML signature, and large JPEG 3103
The message load included messages with inline embedded images, but the BlackBerry devices did
not request the images.
The message load was applied to an environment that used BlackBerry Enterprise Server version 4.1
SP6 with support for MIME/HTML and IBM Lotus Notes Rich Text email messages turned on. The
same message load was applied to an environment with BlackBerry Enterprise Server version 4.1
SP6 with support for MIME/HTML and IBM Lotus Notes Rich Text email messages turned off, and the
results were compared. The load tests were run for 8 hours. Measurements were taken for the last 4
hours of the load tests.
Results of MIME/HTML load tests
Item Rich content turned off Rich content turned on Change
Message rate
(messages/min) 208 208
—

BlackBerry Enterprise Server for IBM Lotus Domino
Technical Note: Impact of Supporting HTML and Rich-content Email Messages 3 of 5
Last saved: 17/07/2008
www.rim.com
% Processor Time 26 50 92%
Virtual bytes (MB) 1190 1354 14%
Results of IBM Lotus Notes Rich Text load tests
Item Rich content turned off Rich content turned on Change
Message rate
(messages/min) 140 140
—
% Processor Time 17.5 18.7 7%
Virtual bytes (MB) 1133 1187 5%
When MIME/HTML email messages were sent and received, the BlackBerry Enterprise Server
increased its use of virtual memory by 164 MB, and it used 92% more CPU resources.
When IBM Lotus Notes Rich Text email messages were sent and received, the BlackBerry Enterprise
Server increased its use of virtual memory by 54 MB, and it used 7% more CPU resources.
Conclusions
Monitor the virtual memory that the BlackBerry Enterprise Server uses. Use the Windows®
Performance Monitor or other tools to view the counter <server>\Process(NBES)\Virtual Bytes. If your
organization’s environment uses a 32-bit operating system, and the virtual memory use of the NBES
process of the BlackBerry Enterprise Server approaches the 2 GB limit, you should take measures to
reduce the use of this resource.
You can manage the use of virtual memory in your organization’s environment by upgrading the
operating system that the BlackBerry Enterprise Server runs on to a 64-bit operating system. The
BlackBerry Enterprise Server can use up to 4 GB of virtual memory address space instead of the 2
GB that a 32-bit operating system provides. IBM Lotus Domino Version 7.0.2 and later support 64-bit
operating systems.
You can reduce the amount of virtual memory that the BlackBerry Enterprise Server uses by
upgrading the IBM Lotus Domino server that the BlackBerry Enterprise Server runs on to version
8.0.1 or later. IBM supports the use of a mixed-mode environment with IBM Lotus Domino version 8
servers and IBM Lotus Domino version 7 servers running in the same environment.
If the BlackBerry Enterprise Server uses an unacceptable amount of CPU resources and virtual
memory, you can use the BlackBerry Manager to turn off support for inline images in MIME/HTML
email messages and IBM Lotus Notes Rich Text email messages to reduce the amount of resource
consumption. If the BlackBerry Enterprise Server continues to use an unacceptable amount of
resources, you can use the BlackBerry Manager to turn off support for MIME/HTML and IBM Lotus
Notes Rich Text email messages. If you turn off support for this feature, BlackBerry Enterprise Server
version 4.1 SP6 uses a similar amount of CPU resources and virtual memory as BlackBerry
Enterprise Server version 4.1 SP5.
While you evaluate the use of virtual memory in your organization’s environment, note that antivirus
software and nightly state database maintenance activities, while underway, can contribute to higher
virtual memory usage. For more information about memory usage in an IBM Lotus Domino
environment, visit www.ibm.com/support to read article 7008849.

BlackBerry Enterprise Server for IBM Lotus Domino
Technical Note: Impact of Supporting HTML and Rich-content Email Messages 4 of 5
Last saved: 17/07/2008
www.rim.com
©2008 Research In Motion Limited. All rights reserved. BlackBerry®, RIM®, Research In Motion®, SureType®
and related trademarks, names and logos are the property of Research In Motion Limited and are registered
and/or used as trademarks in the U.S., Canada and countries around the world.
IBM, Domino, Lotus, and Lotus Notes are trademarks of International Business Machines Corporation. Windows
is a trademark of Microsoft Corporation. All other trademarks are the properties of their respective owners.
The BlackBerry smartphone and other devices and/or associated software are protected by copyright,
international treaties, and various patents, including one or more of the following U.S. patents: 6,278,442;
6,271,605; 6,219,694; 6,075,470; 6,073,318; D445,428; D433,460; D416,256. Other patents are registered or
pending in the U.S. and in various countries around the world. Visit www.rim.com/patents for a list of RIM (as
hereinafter defined) patents.
This documentation including all documentation incorporated by reference herein such as documentation
provided or made available at www.blackberry.com/go/docs is provided or made accessible "AS IS" and "AS
AVAILABLE" and without condition, endorsement, guarantee, representation, or warranty of any kind by
Research In Motion Limited and its affiliated companies ("RIM") and RIM assumes no responsibility for any
typographical, technical, or other inaccuracies, errors, or omissions in this documentation. In order to protect
RIM proprietary and confidential information and/or trade secrets, this documentation may describe some
aspects of RIM technology in generalized terms. RIM reserves the right to periodically change information that is
contained in this documentation; however, RIM makes no commitment to provide any such changes, updates,
enhancements, or other additions to this documentation to you in a timely manner or at all.
This documentation might contain references to third-party sources of information, hardware or software,
products or services including components and content such as content protected by copyright and/or third-party
web sites (collectively the "Third Party Products and 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 endorsement by RIM of the Third Party Products and Services or the third party in any way.
EXCEPT TO THE EXTENT SPECIFICALLY PROHIBITED BY APPLICABLE LAW IN YOUR JURISDICTION,
ALL CONDITIONS, ENDORSEMENTS, GUARANTEES, REPRESENTATIONS, OR WARRANTIES OF ANY
KIND, EXPRESS OR IMPLIED, INCLUDING WITHOUT LIMITATION, ANY CONDITIONS, ENDORSEMENTS,
GUARANTEES, REPRESENTATIONS OR WARRANTIES OF DURABILITY, FITNESS FOR A PARTICULAR
PURPOSE OR USE, MERCHANTABILITY, MERCHANTABLE QUALITY, NON-INFRINGEMENT,
SATISFACTORY QUALITY, OR TITLE, OR ARISING FROM A STATUTE OR CUSTOM OR A COURSE OF
DEALING OR USAGE OF TRADE, OR RELATED TO THE DOCUMENTATION OR ITS USE, OR
PERFORMANCE OR NON-PERFORMANCE OF ANY SOFTWARE, HARDWARE, SERVICE, OR ANY THIRD
PARTY PRODUCTS AND SERVICES REFERENCED HEREIN, ARE HEREBY EXCLUDED. YOU MAY ALSO
HAVE OTHER RIGHTS THAT VARY BY STATE OR PROVINCE. SOME JURISDICTIONS MAY NOT ALLOW
THE EXCLUSION OR LIMITATION OF IMPLIED WARRANTIES AND CONDITIONS. TO THE EXTENT
PERMITTED BY LAW, ANY IMPLIED WARRANTIES OR CONDITIONS RELATING TO THE
DOCUMENTATION TO THE EXTENT THEY CANNOT BE EXCLUDED AS SET OUT ABOVE, BUT CAN BE
LIMITED, ARE HEREBY LIMITED TO NINETY (90) DAYS FROM THE DATE YOU FIRST ACQUIRED THE
DOCUMENTATION OR THE ITEM THAT IS THE SUBJECT OF THE CLAIM.
TO THE MAXIMUM EXTENT PERMITTED BY APPLICABLE LAW IN YOUR JURISDICTION, IN NO EVENT
SHALL RIM BE LIABLE FOR ANY TYPE OF DAMAGES RELATED TO THIS DOCUMENTATION OR ITS USE,
OR PERFORMANCE OR NON-PERFORMANCE OF ANY SOFTWARE, HARDWARE, SERVICE, OR ANY
THIRD PARTY PRODUCTS AND SERVICES REFERENCED HEREIN INCLUDING WITHOUT LIMITATION
ANY OF THE FOLLOWING DAMAGES: DIRECT, CONSEQUENTIAL, EXEMPLARY, INCIDENTAL, INDIRECT,
SPECIAL, PUNITIVE, OR AGGRAVATED DAMAGES, DAMAGES FOR LOSS OF PROFITS OR REVENUES,
FAILURE TO REALIZE ANY EXPECTED SAVINGS, BUSINESS INTERRUPTION, LOSS OF BUSINESS
INFORMATION, LOSS OF BUSINESS OPPORTUNITY, OR CORRUPTION OR LOSS OF DATA, FAILURES
TO TRANSMIT OR RECEIVE ANY DATA, PROBLEMS ASSOCIATED WITH ANY APPLICATIONS USED IN
CONJUNCTION WITH RIM PRODUCTS OR SERVICES, DOWNTIME COSTS, LOSS OF THE USE OF RIM
PRODUCTS OR SERVICES OR ANY PORTION THEREOF OR OF ANY AIRTIME SERVICES, COST OF
SUBSTITUTE GOODS, COSTS OF COVER, FACILITIES OR SERVICES, COST OF CAPITAL, OR OTHER
SIMILAR PECUNIARY LOSSES, WHETHER OR NOT SUCH DAMAGES WERE FORESEEN OR
UNFORESEEN, AND EVEN IF RIM HAS BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES.

BlackBerry Enterprise Server for IBM Lotus Domino
Technical Note: Impact of Supporting HTML and Rich-content Email Messages 5 of 5
Last saved: 17/07/2008
www.rim.com
TO THE MAXIMUM EXTENT PERMITTED BY APPLICABLE LAW IN YOUR JURISDICTION, RIM SHALL
HAVE NO OTHER OBLIGATION, DUTY, OR LIABILITY WHATSOEVER IN CONTRACT, TORT, OR
OTHERWISE TO YOU INCLUDING ANY LIABILITY FOR NEGLIGENCE OR STRICT LIABILITY.
THE LIMITATIONS, EXCLUSIONS, AND DISCLAIMERS HEREIN SHALL APPLY: (A) IRRESPECTIVE OF THE
NATURE OF THE CAUSE OF ACTION, DEMAND, OR ACTION BY YOU INCLUDING BUT NOT LIMITED TO
BREACH OF CONTRACT, NEGLIGENCE, TORT, STRICT LIABILITY OR ANY OTHER LEGAL THEORY AND
SHALL SURVIVE A FUNDAMENTAL BREACH OR BREACHES OR THE FAILURE OF THE ESSENTIAL
PURPOSE OF THIS AGREEMENT OR OF ANY REMEDY CONTAINED HEREIN; AND (B) TO RIM AND ITS
AFFILIATED COMPANIES, THEIR SUCCESSORS, ASSIGNS, AGENTS, SUPPLIERS (INCLUDING AIRTIME
SERVICE PROVIDERS), AUTHORIZED RIM DISTRIBUTORS (ALSO INCLUDING AIRTIME SERVICE
PROVIDERS) AND THEIR RESPECTIVE DIRECTORS, EMPLOYEES, AND INDEPENDENT CONTRACTORS.
IN ADDITION TO THE LIMITATIONS AND EXCLUSIONS SET OUT ABOVE, IN NO EVENT SHALL ANY
DIRECTOR, 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. Installation or use of Third
Party Products and Services with RIM's products and services may require one or more patent, trademark,
copyright, or other licenses in order to avoid infringement or violation of third party rights. You are solely
responsible for determining whether to use Third Party Products and Services and if any third party licenses are
required to do so. If required you are responsible for acquiring them. You should not install or use Third Party
Products and Services until all necessary licenses have been acquired. Any Third Party Products and Services
that are provided with RIM's products and services are provided as a convenience to you and are provided "AS
IS" with no express or implied conditions, endorsements, guarantees, representations, or warranties of any kind
by RIM and RIM assumes no liability whatsoever, in relation thereto. Your use of Third Party Products and
Services shall be governed by and subject to you agreeing to the terms of separate licenses and other
agreements applicable thereto with third parties, except to the extent expressly covered by a license or other
agreement with RIM.
The terms of use of any RIM product or service are set out in a separate license or other agreement with RIM
applicable thereto. NOTHING IN THIS DOCUMENTATION IS INTENDED TO SUPERSEDE ANY EXPRESS
WRITTEN AGREEMENTS OR WARRANTIES PROVIDED BY RIM FOR PORTIONS OF ANY RIM PRODUCT
OR SERVICE OTHER THAN THIS DOCUMENTATION.
Document ID: 19871250
Last Modified: July 2, 2008