Administration Guide

Local Navigation

Changing how a BlackBerry Attachment Service converts attachments

If the BlackBerry® Enterprise Server receives requests from BlackBerry device users to view email message attachments, the BlackBerry Attachment Service converts the attachments into a DOM and caches the DOM locally. The BlackBerry Attachment Service accesses the DOM to process the requests. If users send requests to view the same message attachment again, the BlackBerry Attachment Service accesses the same DOM to process the requests. The BlackBerry Attachment Service keeps all of the cached data in memory only and never caches the original documents.

Each attachment conversion process allocates memory when it starts, uses memory on conversion, and caches the attachment DOM locally on the computer that hosts the BlackBerry Attachment Service. A larger cache size means that more memory is allocated to each running conversion process. The maximum file size of attachments impacts the amount of cached memory that the BlackBerry Attachment Service uses.

By default, the BlackBerry Attachment Service does not limit the file size of an attachment that is embedded in an email message or retrieved using a link. The BlackBerry Enterprise Server sends data to BlackBerry devices over the wireless network in packets that are no larger than 64 KB, and it can send an unlimited number of packets to BlackBerry devices.

You can change how the BlackBerry Attachment Service converts attachments by specifying a maximum file size for attachments that users can receive and controlling how the BlackBerry Attachment Service retrieves, distills, and converts attachment data.

Change how a BlackBerry Attachment Service converts attachments

  1. In the BlackBerry® Administration Service, on the Servers and components menu, expand BlackBerry Solution topology > BlackBerry Domain > Component view > Attachment > Server.
  2. Click the instance that you want to change.
  3. Click Edit instance.
  4. In the General section, configure the BlackBerry Attachment Service optimization settings.
  5. Click Save.

BlackBerry Attachment Service optimization settings

Setting

Description

Range

Submit port

This setting specifies the TCP/IP port number that a BlackBerry® Attachment Service uses to listen for and receive attachment conversion requests in a predefined XML/binary protocol.

The default value is 1900.

Result port

This setting specifies the TCP/IP port number that a BlackBerry Attachment Service returns attachment conversion results to in a predefined XML/binary protocol.

The default value is 2000.

Configuration port

This setting specifies the TCP/IP port number that you can use with an XML protocol to configure or obtain configuration information for a BlackBerry Attachment Service, including version information, the number of conversion processes, and the number of cached documents.

The default value is 1999.

Document cache size

This setting specifies the maximum number of converted documents that can be located in the document cache (as DOM) for a single conversion process.

The default value is 32.

1 through 128

Maximum number of processes

This setting specifies the number of conversion requests that the BlackBerry Attachment Service can process at the same time. When you specify this value, consider the amount of available memory and the competing services on the computer that hosts the BlackBerry Attachment Service.

The default value is 4.

1 through 64

Process recycle time (minutes)

This setting specifies the length of time that an application conversion process can reuse system resources to reclaim space and prevent failed processes from occupying memory resources.

The default value is 25 minutes.

5 to 60 minutes

Maximum conversion threads

This setting specifies the number of documents that the BlackBerry Attachment Service can convert at the same time in a single conversion process. You can use this setting with the Server busy time setting to control thread saturation and manage the BlackBerry Attachment Service workload.

The default value is 4.

2 to 32

Server busy time (seconds)

This setting specifies the threshold at which the BlackBerry Attachment Service does not accept new conversion requests.

The default value is 120 seconds.

60 to 270 seconds

Allow remote services

This setting specifies whether you prevent or permit remote TCP/IP connections to the BlackBerry Attachment Service.

The default value is Yes.

Maximum archive (ZIP) level

This setting specifies how many levels of zipped files that the BlackBerry Attachment Service can process. For example, if you set this field to 2, the BlackBerry Attachment Service processes the .zip files within a .zip file. If you set this field to 1, the BlackBerry Attachment Service only lists the contents of a .zip file.

The default value is 1.

1 to 9

Change the maximum file size for attachments that users can receive

The BlackBerry® Attachment Service uses memory during the attachment conversion process. If users try to open large or complex attachments (for example, .pdf files or ASCII text files that are larger than 2 MB) or multiple attachments at the same time, you might want to limit the file size for attachments.
  1. In the BlackBerry Administration Service, on the Servers and components menu, expand BlackBerry Solution topology > BlackBerry Domain > Component view > Attachment > Server.
  2. Click the instance that you want to change.
  3. Click Edit instance.
  4. In the Distiller section, in the Attachment size (KB) column, type a value, in KB, for the distillers that you want to change. If necessary, configure the settings in the Additional data column.
  5. Click Save.
After you finish: Restart the BlackBerry Attachment Service.

Suggested file sizes for attachments

File format

Suggested size

Adobe® Acrobat® versions 1.1, 1.2, 1.3, and 1.4

less than 2000 KB

ASCII text

less than 100 KB

audio

less than 2000 KB

Corel® WordPerfect® versions 6.0, 7.0, 8.0, 9.0 (2000), and 10.0

less than 2000 KB

HTML

less than 100 KB

images

less than 2000 KB

Microsoft® Excel® versions 97, 2000, 2003, 2007, and XP

less than 2000 KB

Microsoft® PowerPoint® versions 97, 2000, 2003, 2007, and XP

less than 2000 KB

Microsoft® Word versions 97, 2000, 2003, 2007, and XP

less than 2000 KB

MP3

less than 2000 KB

OpenOffice Format version 1.1 - ODP, ODS, ODT

less than 2000 KB

RTF

less than 2000 KB

ZIP archives

less than 2000 KB


Was this information helpful? Send us your comments.