Blackberry for IBM Lotus Domino

8/12/2019 Blackberry for IBM Lotus Domino

1/77

BlackBerry EnterpriseServer for IBM LotusDominoVersion 4.0

Administration Guide


2/77

BlackBerry Enterprise Server Version 4.0 for IBM Lotus Domino Administration Guide

Last revised: 10 November 2004

Part number: SWD_X_BES(EN)-015.003

At the time of publication, this documentation complies with BlackBerry Enterprise Server Version 4.0 for IBM Lotus Domino

2004 Research In Motion Limited. All rights reserved. The BlackBerry and RIM families of related marks, images and symbols are the exclusive

properties and trademarks of Research In Motion Limited. RIM, Research In Motion, 'Always On, Always Connected' and BlackBerry are registered

with the U.S. Patent and Trademark Office and may be pending or registered in other countries.

The Bluetooth word mark and logos are owned by the Bluetooth SIG, Inc. and any use of such marks by Research In Motion is under license.

Microsoft, Windows, PowerPoint, and Windows NT are registered trademarks of Microsoft Corporation in the United States and/or other countries.

Adobe and Acrobat are registered trademarks of Adobe Systems Incorporated in the United States, and/or other countries. Java and JavaScript are

trademarks or registered trademarks of Sun Microsystems, Inc. in the United States and other countries. Corel and WordPerfect are registered

trademarks of Corel Corporation and/or its subsidiaries in Canada, the United States and/or other countries. IBM, Lotus, Domino, Lotus Notes, and

Web Access (iNotes) are trademarks of International Business Machines Corporation in the United States, other countries, or both. All other brands,

product names, company names, trademarks, and service marks are the properties of their respective owners.

The BlackBerry handheld and/or associated software are protected by copyright, international treaties, and various patents, including one or more ofthe 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 various countries around the world. Visit www.rim.com/patents.shtml for a current listing of applicable patents.

This document is provided as is and Research In Motion Limited (RIM) assumes no responsibility for any typographical, technical, or other

inaccuracies in this document. RIM reserves the right to periodically change information that is contained in this document; however, RIM makes no

commitment to provide any such changes, updates, enhancements, or other additions to this document to you in a timely manner or at all. RIM

MAKES NO REPRESENTATIONS, WARRANTIES, CONDITIONS, OR COVENANTS, EITHER EXPRESS OR IMPLIED (INCLUDING, WITHOUT LIMITATION,

ANY EXPRESS OR IMPLIED WARRANTIES OR CONDITIONS OF FITNESS FOR A PARTICULAR PURPOSE, NON-INFRINGEMENT, MERCHANTABILITY,

DURABILITY, TITLE, OR RELATED TO THE PERFORMANCE OR NON-PERFORMANCE OF ANY SOFTWARE REFERENCED HEREIN, OR PERFORMANCE

OF ANY SERVICES REFERENCED HEREIN). IN CONNECTION WITH YOUR USE OF THIS DOCUMENTATION, NEITHER RIM NOR ITS AFFILIATED

COMPANIES AND THEIR RESPECTIVE DIRECTORS, OFFICERS, EMPLOYEES, OR CONSULTANTS SHALL BE LIABLE TO YOU FOR ANY DAMAGES

WHATSOEVER BE THEY DIRECT, ECONOMIC, COMMERCIAL, SPECIAL, CONSEQUENTIAL, INCIDENTAL, EXEMPLARY, OR INDIRECT DAMAGES,

EVEN IF RIM HAS BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES, INCLUDING, WITHOUT LIMITATION, LOSS OF BUSINESS REVENUE OR

EARNINGS, LOST DATA, DAMAGES CAUSED BY DELAYS, LOST PROFITS, OR A FAILURE TO REALIZE EXPECTED SAVINGS.

This document might contain references to third-party sources of information and/or third-party web sites (Third-Party Information). RIM does not

control, and is not responsible for, any Third-Party Information, including, without limitation, the content, accuracy, copyright compliance, legality,

decency, links, or any other aspect of Third-Party Information. The inclusion of Third-Party Information in this document does not imply endorsement

by RIM of the third party in any way. Any dealings with third parties, including, without limitation, compliance with applicable licenses, and terms

and conditions are solely between you and the third party. RIM shall not be responsible or liable for any part of such dealings.

Certain features outlined in this document require a minimum version of BlackBerry Enterprise Server Software, BlackBerry Desktop Software, and/or

BlackBerry Handheld Software and may require additional development or third-party products and/or services for access to corporate applications.

Prior to subscribing to or implementing any third-party products and services, it is your responsibility to ensure that the airtime service provider you

are working with has agreed to support all of the features of the third-party products and services. Installation and use of third-party products and

services with RIM's products and services may require one or more patent, trademark, or copyright licenses in order to avoid infringement of the

intellectual property rights of others. You are solely responsible for acquiring any such licenses. To the extent that such intellectually property

licenses may be required, RIM expressly recommends that you do not install or use these products until all such applicable licenses have been

acquired by you or on your behalf. Your use of third-party software shall be governed by and subject to you agreeing to the terms of separate

software licenses, if any, for those products or services. Any third-party products and services that are provided with RIM's products and services areprovided "as is." RIM makes no representation, warranty, or guarantee whatsoever in relation to the third-party products or services and RIM

assumes no liability whatsoever in relation to the third-party products and services even if RIM has been advised of the possibility of such damages

or can anticipate such damages.

This product includes software developed by the Apache Software Foundation (http://www.apache.org/) and/or licensed pursuant to Apache

License, Version 2.0 (http://www.apache.org/licenses/). For more information, see the NOTICE.txt file included with the software.
http://www.rim.com/patents.shtmlhttp://www.rim.com/patents.shtml


3/77

Unless required by applicable law or agreed to in writing, software distributed under the License is distr ibuted on an "AS IS" BASIS, WITHOUT

WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and

limitations under the License.

Published in Canada

Research In Motion Limited

295 Phillip Street

Waterloo, ON N2L 3W8Canada

Research In Motion UK Limited

Centrum House, 36 Station Road

Egham, Surrey TW20 9LFUnited Kingdom


4/77

Contents1 Managing the server...................................................................................................................................... 8Getting started tasks........................................................................................................................................................8

Managing BlackBerry Windows services ...................................................................................................................8

Start and stop the Mobile Data Service ............................................................................................................8

Start and stop the BlackBerry Enterprise Server.............................................................................................8

Setting up the BlackBerry Manager............................................................................................................................9

Set the administration email address ................................................................................................................9

Set user and server list display .............................................................................................................................9

Set the time and date format ............................................................................................................................ 10

Set data refresh rates............................................................................................................................................10

Managing the server .....................................................................................................................................................10

Refresh the display ................................................................................................................................................ 10

Set message polling interval .............................................................................................................................. 10Set state database pruning ................................................................................................................................ 11

Export server information to a text file...........................................................................................................11

Managing the BlackBerry Domain ........................................................................................................................... 11

Remove a server from the BlackBerry Domain.............................................................................................11

Add a server by importing a file ....................................................................................................................... 12

Manage a different BlackBerry Domain......................................................................................................... 12

Managing wireless network connection................................................................................................................. 12

Change the SRP address ..................................................................................................................................... 13

Managing licenses .........................................................................................................................................................13

Add a license........................................................................................................................................................... 13

Remove a license ................................................................................................................................................... 14

2 Managing users ............................................................................................................................................16

Managing user accounts ............................................................................................................................................. 16

Add users from local or foreign domains.......................................................................................................16

Find users on all BlackBerry Enterprise Servers in the BlackBerry Domain........................................ 17

Move or remove users .......................................................................................................................................... 17

Managing redirection ...................................................................................................................................................18

Disable or enable redirection.............................................................................................................................18

Set the auto-signature.......................................................................................................................................... 18

Set whether messages sent on the handheld are saved in the Sent view in Lotus Notes ............ 19

Purge pending messages ....................................................................................................................................19

Generate encryption keys.................................................................................................................................... 19

Manage the peer-to-peer encryption key....................................................................................................... 19

Resend service book..............................................................................................................................................20

Notifying users................................................................................................................................................................ 20

Send a message to selected users .................................................................................................................... 20

Send a message to all users ............................................................................................................................... 21


5/77

3 Managing messaging and PIM ..................................................................................................................22

Managing PIM synchronization ................................................................................................................................22

Configure PIM synchronization......................................................................................................................... 22

Disable or enable PIM synchronization ..........................................................................................................23

Define PIM application synchronization settings .......................................................................................24Set conflict resolution........................................................................................................................................... 25

Set wireless backup ............................................................................................................................................... 25

Set address book field mappings ..................................................................................................................... 26

Disabling or enabling wireless email reconciliation on the server ................................................................ 26

Managing redirection filters ....................................................................................................................................... 27

Create a filter ..........................................................................................................................................................27

Change filters .......................................................................................................................................................... 28

Set default forwarding action............................................................................................................................ 29

Setting a disclaimer.......................................................................................................................................................29

Setting Auto BCC........................................................................................................................................................... 29

4 Managing IT policies....................................................................................................................................30

Compatibility ................................................................................................................................................................... 30

Setting your default IT policy..................................................................................................................................... 30

Add rules to your default IT policy ..................................................................................................................30

Creating IT policies........................................................................................................................................................31

Create a new IT policy.......................................................................................................................................... 31

Change a users policy assignment.................................................................................................................. 31

Using IT policy rules...................................................................................................................................................... 32

Change the value of a rule in an existing policy.........................................................................................32

Create custom rules .............................................................................................................................................. 33

Manage custom rules ........................................................................................................................................... 33

Viewing IT policy statistics .......................................................................................................................................... 34Sending IT policies ........................................................................................................................................................34

Resend the existing policy ..................................................................................................................................35

Schedule commands ............................................................................................................................................. 35

Deleting IT policies........................................................................................................................................................ 35

5 Managing attachment viewing .................................................................................................................36

View settings ................................................................................................................................................................... 36

Change connector settings.................................................................................................................................36

Change attachment server settings .................................................................................................................37

Setting supported attachments................................................................................................................................. 38

Supported file formats ......................................................................................................................................... 38

Set distiller ............................................................................................................................................................... 39

Set the maximum file size for a distiller setting ..........................................................................................40

6 Managing HTTP browsing and push.........................................................................................................42

Starting the Mobile Data Service.............................................................................................................................. 42

Start or stop the Mobile Data Service ............................................................................................................. 42

Enable or disable on the server ......................................................................................................................... 42

Enable or disable on user accounts ................................................................................................................. 43


6/77

Managing data connections ...................................................................................................................................... 43

Change Mobile Data Service connection settings ......................................................................................43

Change connection timeouts.............................................................................................................................43

Enable cookie support.......................................................................................................................................... 44

Manage connections through a proxy server ............................................................................................... 44Managing connections to servers ............................................................................................................................. 45

Change LDAP settings ......................................................................................................................................... 45

Change OCSP settings ......................................................................................................................................... 46

Change security settings ..................................................................................................................................... 46

Managing authentication ........................................................................................................................................... 48

Set HTTP authentication .....................................................................................................................................48

Configure network authentication................................................................................................................... 48

Set proxy server authentication ........................................................................................................................ 49

Managing push............................................................................................................................................................... 50

Push service ............................................................................................................................................................. 50

Enable the push server......................................................................................................................................... 50

Store and delete push submissions ................................................................................................................. 50

Create push roles and assign push initiators ............................................................................................... 51

Set push authorization for a specific server .................................................................................................. 52

Managing pull................................................................................................................................................................. 52

Create pull roles and assignments ................................................................................................................... 52

Set pull authorization for a specific server .................................................................................................... 53

7 Managing security........................................................................................................................................54

Change the data encryption type.............................................................................................................................54

Generating encryption keys........................................................................................................................................ 54

Set encryption key generation........................................................................................................................... 54

Appendix A: IT policy.................................... ....................................... .......................................... ..............56

IT policy rules .................................................................................................................................................................. 56

Sample IT policies .......................................................................................................................................................... 75


7/77


8/77

1

Managing the server

Getting started tasks

Managing BlackBerry Windows services

Start and stop the Mobile Data ServiceBy default, the Mobile Data Service is disabled. See "Managing HTTP browsing and push" on page 42for more informationon configuring Mobile Data Service settings.

1. In the BlackBerry Manager, in the left pane, click a server.

2. On the Mobile Data Servicetab, click Common.3. Perform one of the following actions:

Start and stop the BlackBerry Enterprise ServerYou can control the BlackBerry Enterprise Server remotely using the BlackBerry Manager.


Getting started tasks

Managing BlackBerry Windows services

Setting up the BlackBerry Manager

Managing the server

Managing the BlackBerry Domain

Managing wireless network connection

Managing licenses

Action Procedure

Enable the BlackBerry Mobile Data Service on both the server

and on user accounts.

! See Starting the Mobile Data Service on page 42.

Set the BlackBerry Manager administration email address. ! See Set the administration email address on page 9.

Configure the global personal information management (PIM)

synchronization settings.

! See Managing PIM synchronization on page 22.

Note:All other BlackBerry services can be stopped and started using Microsoft Windows services for troubleshooting

purposes only.

Action Procedure

Start the Mobile Data Service. ! Click Start Service.

Stop the Mobile Data Service. ! Click Stop Service.

Restart the Mobile Data Service. ! Click Restart Service.


9/77

9


2. On the Server Configurationtab, click Service Control Customization.3. Perform one of the following actions:

Setting up the BlackBerry ManagerThe BlackBerry Manager is the administration console through which you can manage all BlackBerry

Enterprise Servers in the same BlackBerry Domain. The BlackBerry Manager is installed by default witheach BlackBerry Enterprise Server, but may also be installed remotely. See the BlackBerry EnterpriseServerMaintenance Guidefor more information on restricting the permissions of the BlackBerryManager

Set the administration email addressYou can define the address from which system emails are sent from the BlackBerry Manager. Email thatis sent from the BlackBerry Manager must be in SMTP format.

1. In the BlackBerry Manager, in the left pane, click BlackBerry Domain.2. On the Globaltab, click Edit Properties.3. In the Administrationsection, double-click Email Sender Address.4. Type an email address.

5. Click OK.

Set user and server list display1. Perform one of the following actions:

2. Right-click any column heading.

3. Perform one of the following actions:

Action Procedure

Start the BlackBerry Enterprise Server. ! Click Start BES.

Stop the BlackBerry Enterprise Server. ! Click Stop BES.

Restart the BlackBerry Enterprise Server. ! Click Restart BES.

Action Procedure

Customize the user list. 1. In the BlackBerry Manager, in the left pane, click a server.

2. Click the User Listtab.Customize the server list. 1. In the BlackBerry Manager, in the lef t pane, click BlackBerry Domain.

2. Click the Server Listtab.

Action Procedure

Add columns. ! In the Available columns list, double-click a column.

Remove columns. ! In the Visible columns list, double-click a column.

Make a column first or last in the list. 1. In the Visible columns list, click a column.

2. Click Make Firstor Make Last.Move a column up or down in the list. 1. In the Visible columns list, click a column.

2. Click Move Upor Move Down.


10/77

10

1: Managing the server

4. Click OK.

Set the time and date format1. On the Toolsmenu, click Options.2. Click General.3. In the Date Time Format section, modify the desired values.

4. Click OK.

Set data refresh rates1. On the Toolsmenu, click Options.2. Click General.3. In the Auto Refreshsection, click Refresh Timer.4. From the drop-down list, select a refresh rate.

5. Click OK.

Managing the serverYou can change the configuration settings provided during installation and customize the messagepolling and pruning settings.

Refresh the displayYou can manually synchronize the BlackBerry Manager with the configuration database to see if anychanges have occurred. Data is automatically synchronized every ten minutes. See "Set data refreshrates" on page 10 for more information.

!In the BlackBerry Manager toolbar, click Refresh.

Set message polling intervalYou can edit the time after which a users mailbox is polled for new messages. By default, messagepolling occurs every 20 seconds.


2. On the Server Configurationtab, click Service Control Customization.

Tip: Press CTRL to select multiple columns at the same time.

Option Description

Date Format Defines the date format string.

Time Format Specifies whether to show minutes and seconds in the time string.

Force 24-Hour Format Defines whether to use the 24-hour time format.

No Time Marker Specifies whether to set a time marker.


11/77

11


3. Click Set Polling Interval.4. Type the time, in seconds, after which mailbox polling occurs.

5. Click OK.

Set state database pruningYou can edit the time after which messages are cleared from the state database, and the time when thepruning occurs. By default, messages are retained for 6 months after deletion, and 18 months aftercreation. Pruning occurs daily at 3:00 AM.


2. On the Server Configurationtab, click Service Control Customization.3. Click State Database Pruning.4. Modify the desired values.

5. Click OK.

Export server information to a text file1. In the BlackBerry Manager, in the left pane, click a server.

2. On the Server Configurationtab, click Account.3. Click Export BES.4. Define a location and name for the export file, and click Save.

Managing the BlackBerry DomainA BlackBerry Domain is a collection of BlackBerry Enterprise Servers that share a configuration database.

Remove a server from the BlackBerry DomainRemoving a server from the BlackBerry Domain means all server information is removed from theconfiguration database. If you plan to re-add the server, you should export the server information to a

text file prior to removal. See "Export server information to a text file" on page 11 for more information.


2. On the Server Configurationtab, click Account.3. Click Remove BES.4. Click Yes.

Option Description

Days after deleted Defines the number of days after deletion that a message is retained for.

Days after created Defines the number of days after creation that a message is retained for.

Run daily at Defines the hour at which pruning occurs.

Note:You must move or remove all users before you can remove the server.


12/77

12


Add a server by importing a file1. In the BlackBerry Manager, in the left pane, click BlackBerry Domain.2. Perform one of the following actions:

Manage a different BlackBerry DomainYou manage a different BlackBerry Domain by connecting the BlackBerry Manager to a dif ferent

configuration database.

1. On the Toolsmenu, click Options.2. Click Database.3. In the Databasesection, modify the desired values.

4. Click OK.

Managing wireless network connection


2. On the Server Configurationtab, click Edit Properties.3. On the Generaltab, modify the desired values.

Action Procedure

Add the first server. 1. On the Global tab, click Account.2. Click Import BES.3. Define the location and name for the server information file to import, and then click Open.

Add subsequent servers. 1. On the Server List tab, click Account.2. Click Import BES.3. Define the location and name for the server information file to import, and then click Open.

Option Description

Database Server Name Defines the server on which the configuration database is located.

Database Name Defines the name of the configuration database.

Authentication Specifies whether Microsoft Windows NT or Microsoft SQL Server authentication is used.

Log Database Calls Specifies whether verbose logging is enabled for all calls to the database.

Note:Verbose logging is disabled by default.

Warning:Changing any of the information in theIdentifier,Authentication Key, or Host Routing Informationfields

changes the routing information for all users on the BlackBerry Enterprise Server.

You can only use values from the BlackBerry Enterprise Server installation CD label as valid system information.

Option Description

Identifier Defines the unique identifier by which the BlackBerry Enterprise Server connects to the wireless

network.

Authentication Key Defines the key used to authenticate the identifier when connecting to the wireless network.

SRP Host Defines the name of the server on which the BlackBerry Router is installed.

Note: If the BlackBerry Router is installed on the same server as the BlackBerry Enterprise Server,use localhostin this field.

SRP Port Defines the port on which the BlackBerry Router connects to the wireless network.


13/77

13


4. Click OK.

Change the SRP address1. In the task bar, click Start > Programs > BlackBerry Enterprise Server > BlackBerry ServerConfiguration.2. On the BlackBerry Router tab, in the SRP Addressfield, type the DNS name or IP address of the

wireless network.

3. Click OK.

Managing licensesLicense keys enable the use of client licenses in your organization. For example, if you purchase a licensekey for 20 users, you can install 20 users on the BlackBerry Enterprise Server.

When you exceed the number of permitted users, the BlackBerry Manager informs you that you requiremore licenses.

To add more users to the BlackBerry Enterprise Server, you must purchase a new license key for the

number of extra client licenses that you require and then add the license keys to the BlackBerryEnterprise Server.

Add a license1. In the BlackBerry Manager, in the left pane, click BlackBerry Domain.2. On theGlobaltab, click Account.3. Click License Management.4. Type the new license key information.5. Click Add License.6. Click Close.

Host Routing

Information

Defines optional routing information used to connect to the wireless network.

Warning:Only set values in this field if the installation material contains specific values. If you are

using the default Network Access Node (the SRP Address value that is provided on your installation

CD label), or are uncertain which values to use, leave this field blank. If you define incorrect values

in this field, connection to the wireless network is not possible.

Option Description

Tip: Click Test Network Connectionto confirm that the address is entered correctly.

Warning:If you use a temporary evaluation license key, you cannot reuse the temporary license key after you purchase a

permanent license key.


14/77

14


Remove a licenseIf only one license key is active, the remove option is not available.

1. In the BlackBerry Manager, in the left pane, click BlackBerry Domain.2. On theGlobaltab, click Account.3. Click License Management.4. Right-click the license key to remove, and then click Remove License Key.5. Click Close.


15/77

15



16/77

2

Managing users

Managing user accountsUser accounts are added automatically as part of an upgrade. If you are managing a new BlackBerryEnterprise Server, you must select users from your messaging and collaboration server and add them tothe BlackBerry Enterprise Server.

Add users from local or foreign domainsTo access foreign directory servers, you must establish cross-certification. After you add users fromforeign IBM Lotus Notes domains, they are managed in the same way as users from the local domain.


2. On the Server Configuration tab, click Common.3. Click Add Users.4. Perform one of the following actions:

5. Click a user, and then click Add.6. Click OK.

Import users from a legacy server

You can import users from a legacy server rather than upgrading that server.


2. On the Server Configuration tab, click Account.3. Click Import Users from Legacy Server.

Managing user accounts

Managing redirection

Notifying users

Action Procedure

Connect to the local address book. !

From the Serverdrop-down list, click a server.Connect to a foreign directory

server.

! In the Server drop-down list, type the name of the foreign Directory Server, and clickGo.

Tip:Press CTRL to select multiple users at the same time.

Note:After users are imported, you must activate their handhelds.


17/77

17


4. Complete the import wizard:

Find users on all BlackBerry Enterprise Servers in theBlackBerry Domain1. In the BlackBerry Manager, in the left pane, click BlackBerry Domain.2. Click Common.3. Click Find User.4. From the Serverdrop-down list, select either the local address book or the foreign directory server

from which you added the user.

5. Select a user, and then click OK.

Move or remove usersYou can seamlessly move users from one BlackBerry Enterprise Server in the BlackBerry Domain toanother. A replica of the users BlackBerry state database is created automatically on the destinationBlackBerry Enterprise Server, and new service books are sent to the handheld. See the BlackBerryEnterprise Server Maintenance Guide for more information on using sourceless user moves as part ofdisaster recovery.


2. On the User Listtab, click a user.3. In the lower pane, click Common.4. Perform one of the following actions:

Action Procedure

Select a legacy server. ! From the Server Namedrop-down list, select a server.Select users to import. ! Select the check box to import that user.

Confirm the users to import. ! Review the list of imported users, and then click Finish.

Tip:You can drag and drop users into the destination server.

Action Procedure

Move users to a different server. 1. Click Move User.

2. Select the destination server.

3. Click OK.

Remove users from a server. 1. Click Delete User.

2. Click OK.



18/77

18

2: Managing users

Export users to a legacy server


2. On the User Listtab, click a user.3. In the lower pane, click Account.4. Click Export to legacy server.5. Complete the export wizard:

Managing redirection

Disable or enable redirectionYou can stop message redirection to a handheld without removing the user from the server. For example,if a user is traveling out of a wireless coverage area and does not want messages forwarded to thehandheld during that time, disable message redirection to the handheld. While redirection is disabled,the user can send messages but cannot receive them. The user can re-enable redirection on thehandheld.


2. On the User Listtab, click a user.

3. In the lower pane, click Service Access.4. Perform one of the following actions:

5. Click OK.

Set the auto-signature1. In the BlackBerry Manager, in the left pane, click a server.

2. On the User Listtab, double-click a user.3. In the Signaturefield, type the signature to appear on email messages sent from the users

handheld.

Warnings: Exporting users to a legacy server (version 2.2.x) prevents users from using version 4.0 features. See theBlackBerry Enterprise ServerFeature and Technical Overviewfor more information on supported features.

Before the export, you must assign the necessary permissions to the .id file of the server running BlackBerry Enterprise

Server version 4.0 so that it can create database replicas on the legacy server.

Action Procedure

Select a legacy server. ! Use the drop-down list to select the server

Confirm the users to export. ! Review the list of imported users, and then click Finish.


Action Procedure

Disable redirection. ! Click Disable Redirection.

Enable redirection. ! Click Enable Redirection.


19/77

19


Set whether messages sent on the handheld aresaved in the Sent view in Lotus NotesBy default, messages are saved in the Sent view.


2. On the User Listtab, double-click a user.3. Click Do Not Save Sent Messages.4. Perform one of the following actions:

5. Click OK.

Purge pending messagesPurging pending messages removes them from the queue to the users handheld; however, the messagesstill appear in the users Lotus Notes inbox.



3. In the lower pane, click Service Control and Customization.4. Click Purge Pending Messages.

Generate encryption keysBy default, new encryption keys are generated automatically each time the old key expires, and deliveredwirelessly to the handheld. See "Generating encryption keys" on page 54 for more information.

Manage the peer-to-peer encryption keyPeer-to-peer encryption keys enable users in the same BlackBerry Domain to send PIN messagesbetween handhelds, bypassing the email server.

Set or update the key

If you set or update the peer-to-peer encryption key, you prevent users from sending PIN messages to

external PINs. Users can still receive external PIN messages. Any handheld that is turned off or out of awireless coverage area is unable to receive PIN messages until it reconnects with the wireless network.

1. In the BlackBerry Manager, in the left pane, click BlackBerry Domain.2. On the Globaltab, click Service Control and Customization.3. Click Update Peer-to-Peer Encryption Key.

Action Procedure

Save messages in the Sent view. ! From the drop-down list, select False.

Do not save messages in the Sent view. ! From the drop-down list, selectTrue.



20/77

20

2: Managing users

4. Set the following options:

Resend the key

If you previously updated a peer-to-peer encryption key, you can resend the peer-to-peer encryption keyto the users handheld. By resending the key, handhelds that were turned off or out of a wirelesscoverage area when the original encryption key was sent, receive the key and reconnect with the wirelessnetwork.


2. On the User Listtab, click a user.3. In the lower pane, click IT Admin.4. Click Resend Peer-to-Peer Key.

Resend service book1. In the BlackBerry Manager, in the left pane, click a server.


3. In the lower pane, click IT Admin.4. Click Resend Service Book.

Notifying usersYou use the BlackBerry Manager to send an email or PIN message to users in the BlackBerry Domain.Because the mail server does not process PIN messages, this feature is useful for informing BlackBerryusers about mail server outages. PIN messages that are sent from the BlackBerry Manager are notfiltered using the user's handheld filter configuration. PIN messages appear on the handheld in bold,which indicates a priority message.

Send a message to selected users1. In the BlackBerry Manager, in the left pane, click a server.

Option Description

Set or update the Peer-to-Peer

encryption key for all handhelds

within this organization.

Select this option to generate a new key to send to all handhelds. It is selected by

default.

Note:You must generate a new key if the current key is known to be compromisedby handhelds that are not updated automatically. If you select this option, there will

be a period during which users with the new key cannot exchange PIN messages with

users who do not yet have the new key. This is because handhelds that are

unavailable do not receive the new encryption key immediately.

Retain current Peer-to-Peer on all

handhelds as a "previous" key.

Select this check box to retain the current encryption key on the handheld so that

messages from handhelds that do not have the new key can be decrypted.

Remove the encryption keys used to

encrypt Peer-to-Peer messages from

all handhelds within this

organization

Select this option to remove the encryption keys from all handhelds. Selecting this

option makes the Retain current Peer-to-Peer on all handhelds as a "previous" key

unavailable.



21/77

21



3. In the lower pane, click Account.4. Click Send Message.5. Complete the message wizard.

Send a message to all users1. In the BlackBerry Manager, in the left pane, click a server.

2. On the Server Configuration tab, click Account.3. Click Send Message.4. Complete the message wizard.


Action Procedure

Select a delivery method. ! Select the By Email option to send the message by email or select the By PINoptionto send a PIN message.

Type the message. 1. In the Subjectfield, type a subject for the message.2. In the field, type the message.

3. Click Nextto send the message.

Action Procedure

Select a delivery method. ! Perform one of the following actions:

Select the By Email option to send the message by email. Select the By PINoption to send a PIN message.

Select the users to send the

message to.

! Perform one of the following actions:

Select the Send to all users option to send the message to all users. Select the Send to selected users option to specified users, and then select the checkbox beside the user.

Type the message. 1. In the Subjectfield, type a subject for the message.2. In the field, type the message.

3. Click Nextto send the message.


22/77

3

Managing messaging and

PIM

Managing PIM synchronizationYou synchronize personal information management (PIM) items such as tasks, memos, contacts, andcalendar entries so that the entries on a users handheld and on the server are consistent. You can useglobal synchronization, which applies to all servers and users in the BlackBerry Domain or you can setsynchronization options for a specific user.

Configure PIM synchronizationTo support synchronizing PIM data, the BlackBerry Enterprise Server requires access to PIM databases

that are normally stored on the users local computer. To enable PIM synchronization for BlackBerryusers, perform one of the following actions:

set up users as roaming users (recommended)

manually create replicas on the mail server and configure replication on users computers

set up users as Lotus Domino Web Access (iNotes) users.:

Set up users as roaming users

1. In Lotus Domino Administrator, on the People and Groupstab, select the users to configure for PIMsynchronization.

2. On the Toolspane, expand People.3. Click Roaming.4. In the Assign Roaming Profiles dialog box, define the desired roaming settings.

5. Click OK.6. Perform one of the following actions:

Managing PIM synchronization

Disabling or enabling wireless email reconciliation on the server

Managing redirection filters

Setting a disclaimer

Setting Auto BCC

Note:Roaming functionality requires IBM Lotus Domino R6 or later.

Action Procedure

Activate PIM synchronization for

new BlackBerry users.

! In the BlackBerry Manager, add the users to the BlackBerry Enterprise Server. See

"Add users from local or foreign domains" on page 16 for more information.


23/77

23


Create replicas on the mail server

1. Create replicas of the users local databases (names.nsf and journal.nsf) and place them on asuitable server.

2. For the new replicas, define a replication schedule that enables PIM data to remain current withouttaxing network resources.

3. If the user is a new user, in the BlackBerry Manager, add the user to the BlackBerry Enterprise Server.

4. On the User List tab, double-click the user.5. Click PIM Sync.6. In the Memos and Address Book sections, perform the following actions:

7. Click OK.Set up users as Lotus Domino Web Access (iNotes) users

1. Instruct the users to update their mail templates to the correct iNotes (R5) or Lotus Domino WebAccess (R6) template.

2. Instruct the users to synchronize their Lotus Notes address book and journal with their Lotus DominoWeb Access contacts list and notebook.

3. Perform one if the following actions:

Disable or enable PIM synchronization

PIM synchronization is enabled on the BlackBerry Enterprise Server by default. You can disable or enablePIM synchronization globally for all users in the BlackBerry Domain or for a specific user.


existing BlackBerry users.

! In the BlackBerry Manager, activate the users handhelds. See the BlackBerry

Enterprise Server Handheld Management Guidefor more information.

Action Procedure

Action Procedure

Set the server location. ! Type the canonical name of the server on which the databases reside (for example,CN=/OU=/O=).

Set the relative path to the data

directory.

! Type the path, relative to the data directory, in which the databases reside (for

example, names\cwarren_names.nsf and journal\cwarren_journal.nsf).

Note:The users must synchronize regularly to keep their address and journal data current.

Action Procedure


new BlackBerry users.

! In the BlackBerry Manager, add the users to the BlackBerry Enterprise Server. See

"Add users from local or foreign domains" on page 16 for more information.


existing BlackBerry users.

! In the BlackBerry Manager, activate the users handhelds. See the BlackBerry

Enterprise Server Handheld Management Guidefor more information.

Note:You must configure users in IBM Lotus Domino and enable them on the BlackBerry Enterprise Server for PIM

synchronization to work. See "Configure PIM synchronization" on page 22 for more information.


24/77

24

3: Managing messaging and PIM



3. Click OK.

Define PIM application synchronization settings

You can set the synchronization type for the global synchronization of individual databases across theBlackBerry Domain or for user accounts.


Action Procedure

Set up for synchronization globally. 1. In the BlackBerry Manager, in the left pane, click BlackBerry Domain.2. On the Globaltab, click Edit Properties.3. Click Global PIM Sync.

Set up for synchronization for a

specific user.


2. On the User Listtab, double-click a user.

3. Click PIM Sync.

Action Procedure

Disable or enable all PIM

synchronization.

Note:This action is available only

when you select a single user.

1. Click Wireless Synchronization Enabled.


From the drop-down list, select Falseto disable PIM synchronization. From the drop-down list, selectTrueto enable PIM synchronization.

Disable or enable email filter

synchronization.

1. In the Email Filterssection, click Synchronization enabled.


From the drop-down list, select Falseto disable email filter synchronization. From the drop-down list, selectTrueto enable email filter synchronization.

Disable or enable tasks

synchronization.

1. In theTaskssection, click Synchronization enabled.


From the drop-down list, select Falseto disable tasks synchronization. From the drop-down list, selectTrueto enable tasks synchronization.

Disable or enable email setting

synchronization.

1. In the Email Settingssection, click Synchronization enabled.


From the drop-down list, select Falseto disable email setting synchronization. From the drop-down list, selectTrueto enable email setting synchronization.

Disable or enable memo

synchronization.

1. In the Memossection, click Synchronization enabled.


From the drop-down list, select Falseto disable memo synchronization. From the drop-down list, selectTrueto enable memo synchronization.

Disable or enable address book

synchronization.

1. In theAddress Book section, click Synchronization enabled.


From the drop-down list, select Falseto disable address book synchronization. From the drop-down list, selectTrueto enable address book synchronization.

Action Procedure

Set up for synchronization globally. 1. In the BlackBerry Manager, in the left pane, click BlackBerry Domain.2. On the Globaltab, click Edit Properties.3. Click Global PIM Sync.


25/77

25


2. Locate a PIM application in the list and select one of the following synchronization types:

3. Click OK.

Set conflict resolutionYou set how to resolve conflicts that occur when data conflicts between the server and a users handheld.


2. Locate a PIM application in the list, and then select one of the following conflict resolutions:

3. Click OK.

Set wireless backupUser handheld settings and preferences are backed up automatically to the BlackBerry Enterprise Server.

This feature is enabled by default.1. In the BlackBerry Manager, in the left pane, click a server.

2. On the User Listtab, double-click a user.3. Click PIM Sync.4. Click Automatic Wireless Backup Enabled.

Set up for synchronization for a

specific user.



3. Click PIM Sync.

Action Procedure

Option Description

Bidirectional Synchronizes data from the handheld to the server and from the server to the

handheld.

Handheld To Server Synchronizes data from the handheld to the server only.

Server To Handheld Synchronizes data from the server to the handheld only.

Note: Bidirectional synchronization is the only option available for email filters and email settings.

Action Procedure

Set how to resolve conflicts for all

users.

1. In the BlackBerry Manager, in the left pane, click BlackBerry Domain.2. On the Globaltab, clickEdit Properties.3. Click Global PIM Sync.

Set how to resolve conflicts for a

specific user.



3. Click PIM Sync.

Option Description

Server Wins The server information overrules the handheld information.

Handheld Wins The handheld information overrules the server information.


26/77

26



6. Click OK.

Set address book field mappings1. Perform one of the following actions:

2. In the Desktop Fieldcolumn, click a field.3. In the Device Fieldcolumn, from the drop-down list, select the handheld address book field to map

to the desktop field.

4. Click OK.

Disabling or enabling wireless emailreconciliation on the server

Wireless email reconciliation is enabled on the server by default.


2. On the Server Configuration tab, click Edit Properties.3. Click Email.4. In the Email Optionssection, click Wireless Email Reconciliation Enabled.5. Perform one of the following actions:

6. Click OK.

Action Procedure

Enable automatic wireless backup. ! From the drop-down list, selectTrue.

Disable automatic wireless backup. ! From the drop-down list, select False.

Action Procedure

Set field mappings for all users. 1. In the BlackBerry Manager, in the left pane, click BlackBerry Domain.2. On the Globaltab, click Service Control and Customization.3. Click PIM Sync Global Field Mapping.

Set field mappings for a specific user. 1. In the BlackBerry Manager, in the left pane, click a server.

2. On the User Listtab, click a user.3. In the lower pane, click Service Control and Customization.4. Click PIMSync Field Mapping.

Action Procedure

Disable wireless email reconciliation. ! From the drop-down list, select False.Enable wireless email reconciliation. ! From the drop-down list, selectTrue.


27/77

27


Managing redirection filtersRedirection filters define which messages are redirected to users handhelds. When a user receives anemail message, the BlackBerry Enterprise Server applies filters to determine how to direct the message:

forward, forward with priority, or do not forward to the users handheld. Filters set on the server takeprecedence over the filters that are defined by users. If none of the server filters apply, the users filtersare applied.

Create a filterUse global filters to apply filters to all users on a server and user filters to apply filters to specific users.

1. In the BlackBerry Manager, in the left pane, click a server.2. Perform one of the following actions:

3. Click New.4. In the dialog box, double-click Filter Name.5. Type a name for the new filter.

6. Double-click a condition and perform one of the following actions:

7. In the Action section, click Action.8. Perform one of the following actions:

Note:Users cannot view global filters, so if you define global filters, inform users so that they understand why some of

their filter rules might not be applied.

Note: Global filters take precedence over user filters.

Action Procedure

Create a global filter for all users. 1. On the Server Configurationtab, click Edit Properties.

2. Click Global Filters.

3. Double-click Global Filter Definitions.

Create a fi lter for a specific user. 1. On the User Listtab, double-click a user.

2. Click Filters.

3. Double-click Filter Rules.

Tip:You can use wildcards when you create filter rules; however, if you use wildcards for email addresses, you should

use the correct SMTP format (for example, *@acme.ca).

Specify recipient method. 1. Click Recipient Types.2. Select one, some, or all of Sent Directly, Cc, or Bccfor the filter to detect.

Note:This field only applies to messages that are sent directly to the recipients. Itdoes not apply to distribution lists to which they belong.

Action Procedure

Hold messages to which no filters

apply.

! From the drop-down list, select Hold.


28/77

28


9. Click OK.

Change filters

1. In the BlackBerry Manager, in the left pane, click a server.2. Perform one of the following actions:

3. Perform one of the following tasks:

Forward messages to which no filters

apply.

1. From the drop-down list, select Forward.2. Perform one of the following actions:

Select Heading Onlyto forward only the message header. Select Level1 Notificationto forward messages with Level 1 notif ication

(messages with Level 1 filter notification appear with a bold subject line by default

on the recipients handheld).

Select Heading Onlyand Level1 Notificationto forward the message header ofmessages with Level 1 notification.

Action Procedure

Note:Messages are filtered based on the order in which the filters appear. If the filter that you are adding applies to

messages to which another filter also applies, you must decide which filter should be applied first. See "Change filters"

below for more information.

Action Procedure

Change a global filter. 1. On the Server Configurationtab, click Edit Properties.

2. In the left pane, click Global Filters.

3. Double-click Global Filter Items.

4. In the Filter Name list, click a filter.

Change a filter for a specific user. 1. On the User Listtab, double-click a user.

2. In the left pane, click Filters.

3. Double-click Filter items.

4. In the Filter Name list, click a filter.

Action Procedure

Enable a filter. 1. Click Properties.

2. Click Enabled.

3. From the drop-down list, selectTrue.

Edit a filter. 1. Click Properties.

2. Make the desired changes. See "Set default forwarding action" on page 29 for more information.

3. Click OK.

Disable a filter. 1. Click Properties.

2. Click Enabled.

3. From the drop-down list, select False.Change the order

of filters.

1. Click Move Upor Move Downto move the filter higher or lower in the list.

2. Click OK.

Note:The BlackBerry Enterprise Server applies filters to new messages in the order in which they appear

in the Filters dialog box. Make sure the filters appear from least to most restrictive.

Delete a filter. ! Click Remove.

Note:The BlackBerry Enterprise Server reads global filter changes every 15 minutes, so filter changes might not be applied

to messages immediately.


29/77

29


Set default forwarding actionUse the default action to define whether messages are held or forwarded if no filter rules apply.


2. On the User List tab, double-click a user.3. In the left pane, click Filters.4. In the Default Actionsection, click Forward messages to handheld.5. Perform one of the following actions:

6. Click OK.

Setting a disclaimerSet a disclaimer to add text below user signatures on all messages that are sent from the handheld.


2. On the Server Configurationtab, click Edit Properties.3. Click Email.4. In the Email Optionssection, click Disclaimer Text.5. Type a disclaimer.

6. Click OK.

Setting Auto BCCThe auto blind carbon copy (BCC) feature enables the BlackBerry Enterprise Server to force all emailmessages that are sent from handhelds to be blind carbon copied to a specified recipient. This featuredoes not populate the BCC field of the original email, so the sender is unaware that the message isbeing BCCed.

You can specify multiple recipients to receive the BCCs. These BCC settings apply to all users on thespecified BlackBerry Enterprise Server.


2. On the Server Configurationtab, click Edit Properties.3. Click Email.4. In the Email Optionssection, double-click Auto BCC Addresses.5. Type the email addresses, separated by a semicolon(;).

6. Click OK.

Action Procedure

Forward messages to the handheld. ! From the drop-down list, selectTrue.

Do not forward messages to the handheld. ! From the drop-down list, select False.

Tip: Click Import List to select from the address book.


30/77

4

Managing IT policies

CompatibilityThere are specific handheld and sof tware requirements for each IT policy rule. See "IT policy rules" onpage 56 for more information.

Setting your default IT policyAll new users in a BlackBerry Domain are added to a default policy, which houses a collection of policyrules. Applicable policy rule settings apply immediately to new users.

Add rules to your default IT policy1. In the BlackBerry Manager, in the left pane, click BlackBerry Domain.2. On the Globaltab, click Edit Properties.3. Click IT Policy.4. In the IT Policy Administrationsection, double-click IT Policies.5. In the list of policies, click Default.6. Click Properties.7. Configure the policy rules.

In the left pane, click to select a policy group.

In the right pane, double-click the rule to assign a value or to choose between True or False.

8. Click OK.

Compatibility

Setting your default IT policy

Creating IT policies

Using IT policy rules

Viewing IT policy statistics

Sending IT policies

Deleting IT policies

Note:The default settings for each rule do not display in their respective field. Review the on-screen description fordetails.

Tip: See the lower pane for the rule description, default information, requirements, and interdependences with otherrules.


31/77

31


Creating IT policiesYou create customized IT policies to reflect the needs of different types of users. For example, you mightwant to have a higher level of security on the handhelds of your sales team, who are typically out of the

office. See "Sample IT policies" on page 75 for more information

Create a new IT policy1. In the BlackBerry Manager, in the left pane, click BlackBerry Domain.2. On the Globaltab, click Edit Properties.3. Click IT Policy.4. In the IT Policy Administrationsection, double-click IT Policies.5. Click New.6. Double-click IT Policy Name.7. Type a name for the new policy.

8. Configure the policy rules.

In the left pane, click to select a policy group.

In the right pane, double-click the rule to assign a value or to choose between True or False.

9. Click OK.

Change a users policy assignmentManage the policy-to-user assignment from either the policy or the user account. If you already created anew policy, to which you want to add multiple users, manage the policy assignment in the policy or inselected user accounts. To change only one users policy assignment, manage the policy assignment inthe user account.

Manage assignment in the policy

1. In the BlackBerry Manager, in the left pane, click BlackBerry Domain.2. On the Globaltab, click Edit Properties.3. Click IT Policy.4. In the IT Policy Administrationsection, double-click IT Policy To User Mapping.5. In the left pane, click a user.

6. In the right pane, click a policy.

7. Repeat steps 5 and 6 to move additional users to the policy.

8. Click OK.

Tip: See the lower pane for the rule description, default information, requirements, and interdependences with otherrules.

Note:Users can belong to only one policy.


32/77

32

4: Managing IT policies

Manage assignment in the user account


2. In the User List, double-click a user.3. Click IT Policy.4. Click IT Policy Name.5. From the drop-down list, select a new policy.

6. Click OK.Manage assignment in a selected user account


2. In the User List, click users.

3. Click IT Admin.4. Click Assign IT Policy.5. From the drop-down list, select a new policy.

6. Click OK.

Using IT policy rulesPre-defined policy rules are included with the BlackBerry Enterprise Server. You set the behavior of therule inside each policy using the values permitted by the rule.

You cannot change the way that the rule functions, or add/remove permitted values. You also cannotdelete these rules.

Change the value of a rule in an existing policy1. In the BlackBerry Manager, in the left pane, click BlackBerry Domain.2. On the Globaltab, click Edit Properties.3. Click IT Policy.4. In the IT Policy Administrationsection, double-click IT Policies.5. Click the policy to edit, and then click Properties.6. From the Properties list, choose the rule you want to edit.

7. Make the desired changes.8. Click OK.



33/77

33


Create custom rulesTo control custom applications that your company develops to run in the BlackBerry environment. Forinformation on developing custom applications, create custom rules.

1. In the BlackBerry Manager, in the left pane, click BlackBerry Domain.2. On the Globaltab, click Edit Properties.3. Click IT Policy.4. In the IT Policy Administrationsection, double-click IT Policies.5. Click the policy to add a custom rule to, and then click Properties.6. From the Properties list, select User-Defined Items.7. Double-click IT Policy Template.8. Click New.9. Complete the available fields:

10. Click OK.11. In the Policy Items Settingssection, provide a value for the custom rule in this policy.

Manage custom rulesYou change the value of a custom rule in a policy the same way that you change a pre-defined rule. Youcan also edit and delete custom rules.

When you change a custom rule, all policies that contain the rule are resent to their list of assignedusers.

1. In the BlackBerry Manager, in the left pane, click BlackBerry Domain.2. On the Globaltab, click Edit Properties.3. Click IT Policy.4. In the IT Policy Administrationsection, double-click IT Policies.

Note:Custom rules can be used only in conjunction with your own custom applications.

Action Procedure

Define the rule name. ! Type a name for the custom rule.

Outline how the rule can be

used.

! Type a description for the custom rule.

Identify the type of values

that the rule uses.

! From the drop-down list, select Boolean, Integer, String, Bitmask, or Multiline String.

Identify where the rule will

be enforced.

! From the drop-down list, selectHandheld, Desktop, or Boththe handheld and desktop.Set minimum integer value. ! Specify the minimum value that an integer rule can accept.

Set maximum integer value. ! Specify the maximum value that an integer rule can accept.

Define bitmask data. ! Specify the data that a bitmask rule can accept. Include up to 8 related boolean values. You can

assign a bit option name for 1, some, or all of the 8 bit values.

For example, you might create a bitmask IT policy rule called AllowedFeatures with 3 boolean bit

values where bit 0 is named Phone, bit 1 is named Browser, and bit 2 is named Third Party Apps.

Note:After you create a custom rule, you can assign a value to it in any new or existing policy.


34/77

34

4: Managing IT policies

5. Click the Default policy, and then click Properties.6. From the Properties list, select User-Defined Items.7. Double-click IT Policy Template.8. Perform one of the following actions:

Viewing IT policy statisticsEach users IT policy status displays as part of the user summary. You can include the policy status as a

column in the user list.

Sending IT policiesWhen you add new users, they are added to the default IT policy, which is sent automatically to their

handhelds. If you move users to a new policy, that policy is also sent automatically to their handhelds.

If you move a user from one BlackBerry Enterprise Server to another in the same BlackBerry Domain, thesame policy remains in effect, but is resent automatically by the new BlackBerry Enterprise Server.

If you move a user from one BlackBerry Enterprise Server to another outside the BlackBerry Domain, theuser is treated like a new user and is assigned to the default IT policy, which is sent automatically by thenew BlackBerry Enterprise Server.

Action Procedure

Edit a custom rule. 1. Click the rule to edit, and then click Properties.2. Modify the desired values.

3. Click OK.

Delete a custom rule. 1. Choose the rule to delete, and then click Remove.2. Click OK.

Option Description

Pending Indicates that there is new data waiting to be sent to the users handheld and, or desktop.

Processing Indicates that the BlackBerry Enterprise Server is sending the change to the user. You should not

see this status display for an extended period. If the status does not change within a short time,

the status of the BlackBerry Enterprise Server might have changed while it was processing the

request.

Sent Indicates that the policy change has been sent wirelessly to the users handheld and, or desktop,

but the user has not yet received the change.

Received Indicates that the users handheld and, or desktop has received the IT policy change, but the

BlackBerry Enterprise Server has not received an error or a success message to indicate if the

change has been applied.Applied successfully Indicates that the users handheld and, or desktop received the IT policy change and successfully

applied the change.

Error Indicates that an error occurred while the policy change was being processed, sent, received, or

applied.

Timed out Indicates that the IT policy change request timed out after 7 days. The users handheld might be

turned off or out of a wireless coverage area.

Note:Sending a wireless IT policy creates a security association between the handheld and the BlackBerry Enterprise

Server. After this association is made, the handheld does not accept IT policies from any other BlackBerry Enterprise Server

or from the users computer over the serial or USB port.


35/77

35


Resend the existing policyIf, for any reason, the IT policy is not received by the handheld, you can manually resend the policy.


2. On the User Listtab, click a user.3. Click IT Admin.4. Click Resend IT Policy.

Schedule commandsBy default, automatic resends are turned off. You can configure IT policies to be resent to handhelds onthe BlackBerry Enterprise Server at a scheduled time.


2. On the Server Configurationtab, click Edit Properties.3. In the IT Adminsection, double-click Policy Resend Interval.4. Type the rate, in hours, at which you want the automatic resends to occur.

5. Click OK.

Deleting IT policiesIf you delete a policy to which users are assigned, they are assigned automatically to the default ITpolicy. For this reason, you cannot delete the default IT policy.

1. In the BlackBerry Manager, in the left pane, click BlackBerry Domain.2. On the Globaltab, click Edit Properties.3. Click IT Policy.4. In the IT Policy Administrationsection, double-click IT Policies.5. Click the policy to delete, and then click Remove.6. Click OK.


36/77

5

Managing attachment

viewing

View settings1. On the taskbar, click Start > Programs > BlackBerry Enterprise Server > BlackBerry ServerConfiguration.2. Click the Attachment Servertab.3. In the Configuration Optiondrop-down list, select one of the following:

If the BlackBerry Attachment Service is installed on a remote machine (that is, separate from theBlackBerry Enterprise Server), only certain settings can be configured on each machine. On theAttachment Service machine, the attachment server options are visible. On the BlackBerry EnterpriseServer, the Connector Configuration options are visible.

Change connector settings

1. On the taskbar, click Start > Programs > BlackBerry Enterprise Server > BlackBerry ServerConfiguration.2. On theAttachment Servertab, from the Configuration Optiondrop-down list, select ConnectorConfiguration.3. Modify the desired values.

View settings

Setting supported attachments

Option Description

Connector Configuration Controls the connections between the Messaging Agent and the Attachment Service when

attachments are requested on the handheld.

Attachment Server Controls the retrieval, distillation, and conversion of attachment data, as well as which

attachment types you plan to support in your environment.

Test Attachment Service Provides tools to troubleshoot the Attachment Service. See the BlackBerry Enterprise Server

Troubleshooting Guidefor more information.

Note:You can modify connector configuration settings only on the computer on which the BlackBerry Enterprise Server

with the attachment connector is installed.

Option Description Range

Server Set the server name or IP address of the computer on which the Attachment Service is

installed. If the Attachment Service is installed on the same computer as the BlackBerry

Enterprise Server, this value is set to the localhostname by default.


37/77

37


4. Click OK.5. Restart the BlackBerry Dispatcher.

Change attachment server settings

1. On the taskbar, click Start > Programs > BlackBerry Enterprise Server > BlackBerry ServerConfiguration.2. On theAttachment Servertab, from the Configuration Optiondrop-down list, select AttachmentServer.3. Modify the desired values.

Server Submit

Port

Set the TCP/IP Port number that the attachment connector uses to send the attachment

data requests to the Attachment Service.

Note:The port number for this setting must match the Submit Portfield in the attachment

server configuration options.

1024 to

65,535

Server Result

Port

Set the TCP/IP Port number used to query and retrieve large attachment conversion data

from the Attachment Service.

Note:The port number for this sett ing must match the Result Portfield in the attachmentserver configuration options.

1024 to

65,535

Polling Time

(seconds)

Set the interval, in seconds, used to query the server results time if large attachments are

available for delivery from the Attachment Service.

10 to 300

seconds

Format

Extensions

Specify the list of supported attachment extensions that this BlackBerry Enterprise Server

supports for the attachment viewer.

Warning: If you turn off a distiller, you should also remove the file extension(s) for

documents converted by that distiller from the Format Extensionsfield.

Extended

Logging

Set the extended log to Enabledto enable the Attachment Service to write extended log

information to the log file. See the BlackBerry Enterprise Server Troubleshooting Guidefor

more information.

Note:The Attachment Service logs successful conversions and any failures in the BlackBerry

Messaging Agent log file by default. This setting is used only to enable extended logging

for troubleshooting.

Tip:Click Defaultto return all fields to the original settings.


Note:You can modify attachment server settings only on the computer on which the Attachment Service is installed.


Submit Port Type the TCP/IP port number that the Attachment Service uses to receive document

submissions and for which it returns conversion results.

Note:This port number should be identical to the number in the Server Submit Portfield in

the Connector Configuration options.

1024 to

65,535

Result Port Type the port number that the Attachment Service uses to send large attachment conversion

data when polled from the attachment connector on the BlackBerry Enterprise Server.

Note:The port number for this setting must match the Server Result Port field in the

Connector Configuration options.

1024 to

65,535

Configuration

Port

Type the TCP/IP port number to use for configuration and administrative purposes. 1024 to

65,535

Concurrent

Caching

Specify whether multiple requests for the same attachment can use the first cached copy of

the attachment Document Object Model (DOM) in a conversion process for a new user.


38/77

38

5: Setting supported attachments

4. Click OK.5. Restart the Attachment Service.

Setting supported attachmentsFor an attachment to be viewable on the handheld, the attachment format must be included in the

supported format list, and a distiller for that format must be installed. See the Attachment Distiller API

Reference Guidefor more information on writing custom distillers.

Supported file formatsThe following f ile formats are supported by default :.

Document

Cache Size

(docs)

Specify the maximum number of converted documents that might reside in the document

cache (as DOM) for an individual conversion process.

If the same user retrieves more content from the same document within a few minutes of the

initial request, subsequent requests are served from cache. The cache is maintained for 25

minutes (the default recycle time), or until a new request exceeds the cache limit for thatprocess and the least recently used document in the cache is deleted.

All cached data is kept in memory only and the original document is never cached.

Tip:A larger cache size means that more memory is allocated to each running conversion

process. The maximum file size of the attachments affects the cached memory used. Use the

Max File Size (Kb) setting for individual attachment formats to limit the cache size memory

usage for the running conversion processes.

1 to 128

Conversion

Processes

Set the number of conversion processes that are available to the Attachment Service. A higher

number of conversion processes enables more conversion requests to be handled concurrently.

Every conversion process allocates memory on startup and uses memory on conversion. This

value should be set in relation to available memory and competing services on the computer

running the Attachment Service.

1 to 64

Max. Threads

per Process

Set the maximum number of document conversions per conversion process. The number of

allowed document conversions defines how many concurrent conversions a single conversionprocess accepts. This setting helps to control thread saturation for a high volume BlackBerry

Enterprise Server configuration and is also useful for managing Attachment Service workload

in conjunction with the Busy Threshold (seconds) setting.

2 to 32

Recycle Time

(seconds)

Set the timeout for the BBConvert process recycling to stop any processes consuming CPU that

have not completed or failed processing when the time out occurs.

Tip:Process recycling is also used by the Attachment Service to reclaim space used by theAttachment Service and prevent failed processes from keeping memory allocated.

300

seconds (5

minutes)

to 3600

seconds

(60

minutes)

Busy Threshold

(seconds)

Set the threshold used to determine whether the Attachment Service is busy with conversion

and should not accept new requests. The Attachment Service monitors the running conversions

threads to check whether all conversion processes are busy when a new request arr ives. When

the threshold is reached, a Server Busy, Retry message displays.

60

seconds to

270

seconds

Distiller

Settings

The distiller list displays all installed document-loading distillers for the Attachment Service

along with the associated document extension an

Documents

Blackberry for IBM Lotus Domino