Frequently asked questions about the BlackBerry State Database
Summary
The BlackBerry State Database creates an instance for each BlackBerry handheld
user. It is the repository used by the BlackBerry Enterprise Server to store information about messages sent to and from BlackBerry handhelds.
When a message arrives at a BlackBerry handheld user’s Lotus Notes Inbox, the
BlackBerry Enterprise Server software detects that a new message has been received, and processes it. In doing so, it writes a new entry to the user’s BlackBerry State Database, establishing a correlation between the original message
in the user’s Inbox, and the same message on the user’s BlackBerry handheld.
BlackBerry State Databases are critical to the operation of the BlackBerry Enterprise Server. The information stored in these databases supports email functionality, such as forwarding, filing, reconciling, and replying to messages.
The BlackBerry State Database also enables Lotus Notes users to use the BlackBerry Desktop Manager for email reconciliation with a local replica (even while disconnected), provided that they have a local replica of both their mail file and the BlackBerry State Database.
Frequently asked questions
1. Where is the BlackBerry State Database located?
One BlackBerry State Database exists for each user. Each database is stored in the same folder on the server, in the \state subfolder in the main BES folder. As native Lotus Notes databases, the .nsf files are based on the BBSD.NTF
template in the Domino\Data folder. When a user is added to the BlackBerry Enterprise Server using the
BESAdmin application, a BlackBerry State Database is automatically created for the user. The name of the database file is a random number, and that name and path are written to the user’s Profile document in the
BlackBerryProfiles.nsf database. By opening the Profile document for a user, an administrator or the user can
click the BlackBerry State Database link to open the BlackBerry State Database.
2. What is stored in each BlackBerry State Database?
Each time the BlackBerry Enterprise Server encounters a message in the mail file that is a candidate for redirection,
an associated document is created in the BlackBerry State Database. These documents contain sufficient
information to correlate the original document in the mail file with the document that was sent to the handheld. This
correlation data is used by the BlackBerry Desktop Software for email reconciliation purposes, as well as by the
BlackBerry Enterprise Server, if the user forwards or replies-with-text to a message on the handheld. Correlation
data for filtered messages is also populated into this database to prevent its reprocessing.
The BlackBerry State Database also creates a special document for each user that contains a mapping of the Lotus
Notes Folder IDs and the Folder IDs on the handheld. If this database is replicated on the user’s local computer,
Frequently asked questions about the BlackBerry
State Database
© 2001 Research In Motion Limited www.blackberry.net Page 2 of 3
offline synchronization can occur, since the elements required for offline synchronization exist locally on the user’s
computer.
3. What access control list (ACL) rights are required on the BlackBerry State Database?
When the BlackBerry Enterprise Server creates the BlackBerry State Database, it sets a default ACL. The default
ACL is programmatically created based on the ACL settings of the BlackBerryProfiles.nsf database.
Additionally, the BlackBerry Enterprise Server sets the owner, or the user for whom this database is being created,
as a Person/ Manager so that the user can access the database for replication purposes. Normally, the default ACL
does not need to be changed.
4. How large is each BlackBerry State Database?
Upon creation, the initial database is just under 200 KB. As documents are added to the BlackBerry State Database,
it grows less than 100 bytes per document. Therefore, the size of each database is directly correlated to the mail
volume managed by the BlackBerry Enterprise Server. Even heavy mail users should find that their BlackBerry
State Database remains in the 1 to 15-MB range.
5. Should BlackBerry handheld users replicate their BlackBerry State Database locally?
The BlackBerry Desktop Manager supports email reconciliation with a local replica (even while disconnected), if
the user has a local replica of both the mail file and the BlackBerry State Database. This requires BlackBerry
Desktop Software version 2.1 Service Pack 2 or later.
To create a local replica of the BlackBerry State Database, open the BES\BlackBerryProfiles.nsf database on
the BlackBerry Enterprise Server. Open the account document, and click BlackBerry State Database. When the
database opens, on the File menu, select Replica > New Replica to create a local replica on your computer. You
should configure the replication of your BlackBerry State Database so that it replicates on the same frequency as
your mail file.
6. When I remove a user from the BlackBerry Enterprise Server, what happens to the BlackBerry State Database?
After 24 hours, the BlackBerry State Database is programmatically deleted. When a user is removed from the BlackBerry Enterprise Server, th is removes the link between the user’s BlackBerry State Database Profile document
and the BlackBerry State Database. If the user is re-added to the BlackBerry Enterprise Server, they will not be able
to forward or reply-with-text to any messages that were on their device prior to being removed from the server.
7. In the past, we removed users from the BlackBerry Enterprise Server and re-added them to resolve technical issues; is this procedure correct?
No. When a user is removed from the BlackBerry Enterprise Server, this removes the link between the user’s BlackBerry State Database Profile document and the BlackBerry State Database. A warning is displayed that must be confirmed before this action can proceed.
Thursday, April 10, 2008
How To - Load applications onto a BlackBerry device
Description
You can load applications on a BlackBerry device in the following ways:
with BlackBerry Desktop Manager
wirelessly using a browser on the BlackBerry device
with the JavaLoader.exe utility
For each method you must specify the location of the COD application file(s) to be loaded. For more information on using the BlackBerry Desktop Manager and JavaLoader.exe to load applications, see the BlackBerry JDE Developer Guide.
Loading Applications with BlackBerry Desktop Manager
Loading applications using BlackBerry Desktop Manager is the preferred method and requires an ALX loading configuration file.
Loading Applications Wirelessly
Applications can be loaded wirelessly using the BlackBerry Browser, Internet Browser, or Wireless Application Protocol (WAP) Browser. For descriptions of these browsers, see KB03892.
1. Put the JAD file and required COD files on a web server.
2. Access the JAD file using one of the BlackBerry device browsers.
Note: Some service providers restrict the sizes of files that can be downloaded using their WAP Browser.
Loading applications with JavaLoader.exe
For development and testing purposes, applications can be loaded directly on the BlackBerry device using the JavaLoader.exe utility provided with the BlackBerry JDE.
You can load applications on a BlackBerry device in the following ways:
with BlackBerry Desktop Manager
wirelessly using a browser on the BlackBerry device
with the JavaLoader.exe utility
For each method you must specify the location of the COD application file(s) to be loaded. For more information on using the BlackBerry Desktop Manager and JavaLoader.exe to load applications, see the BlackBerry JDE Developer Guide.
Loading Applications with BlackBerry Desktop Manager
Loading applications using BlackBerry Desktop Manager is the preferred method and requires an ALX loading configuration file.
Loading Applications Wirelessly
Applications can be loaded wirelessly using the BlackBerry Browser, Internet Browser, or Wireless Application Protocol (WAP) Browser. For descriptions of these browsers, see KB03892.
1. Put the JAD file and required COD files on a web server.
2. Access the JAD file using one of the BlackBerry device browsers.
Note: Some service providers restrict the sizes of files that can be downloaded using their WAP Browser.
Loading applications with JavaLoader.exe
For development and testing purposes, applications can be loaded directly on the BlackBerry device using the JavaLoader.exe utility provided with the BlackBerry JDE.
With the BlackBerry handheld, how do I wirelessly add or remove applications?
With BlackBerry handheld software version 3.6 or later, you can wirelessly download third-party Java applications using the BlackBerry Browser. You can then manage, run, and delete these applications using the handheld application manager.
Two files are required to wirelessly download an application to the BlackBerry handheld:
.jad file: An application descriptor that provides information about the application and the location of .cod files
.cod file: Compiled and packaged application code, in a BlackBerry-specific format
The BlackBerry browser uses the .jad file to discover applications for download. This .jad file provides a URL to the .cod files for the application. The .jad file is required. Application .cod files cannot be downloaded directly if a .jad is unavailable.
Adding applications
To add applications with the BlackBerry handheld, follow the directions below:
1. Use the browser on the BlackBerry handheld to locate applications for download. Applications for the BlackBerry handheld are available at: http://mobile.blackberry.com/MBC/
2. In the browser, find the link to an application (.jad file). Select the link to start the download and installation process.
3. The browser will download the .jad file, and will display a dialog box with information about the application (e.g., name, vendor, version, and size). Click Cancel to cancel the installation process or Download to continue.
The application manager will verify that there is enough space on the handheld to install the program. If there is insufficient space, the installation will stop; otherwise, the handheld will display a message when the installation is complete.
4. On the handheld Home screen, an icon for the application will appear. Click the icon to start the application.
Removing applications
To delete third-party applications from the handheld, follow the directions below:
1. In the Options application, to view the list of all applications installed on the handheld, click Applications.
2. Click the trackwheel and select Properties.
3. Click Delete, and then confirm the deletion.
Note: Only optional and third-party applications offer a Delete option. You cannot delete required BlackBerry applications from this screen.
Two files are required to wirelessly download an application to the BlackBerry handheld:
.jad file: An application descriptor that provides information about the application and the location of .cod files
.cod file: Compiled and packaged application code, in a BlackBerry-specific format
The BlackBerry browser uses the .jad file to discover applications for download. This .jad file provides a URL to the .cod files for the application. The .jad file is required. Application .cod files cannot be downloaded directly if a .jad is unavailable.
Adding applications
To add applications with the BlackBerry handheld, follow the directions below:
1. Use the browser on the BlackBerry handheld to locate applications for download. Applications for the BlackBerry handheld are available at: http://mobile.blackberry.com/MBC/
2. In the browser, find the link to an application (.jad file). Select the link to start the download and installation process.
3. The browser will download the .jad file, and will display a dialog box with information about the application (e.g., name, vendor, version, and size). Click Cancel to cancel the installation process or Download to continue.
The application manager will verify that there is enough space on the handheld to install the program. If there is insufficient space, the installation will stop; otherwise, the handheld will display a message when the installation is complete.
4. On the handheld Home screen, an icon for the application will appear. Click the icon to start the application.
Removing applications
To delete third-party applications from the handheld, follow the directions below:
1. In the Options application, to view the list of all applications installed on the handheld, click Applications.
2. Click the trackwheel and select Properties.
3. Click Delete, and then confirm the deletion.
Note: Only optional and third-party applications offer a Delete option. You cannot delete required BlackBerry applications from this screen.
Wireless synchronization option is missing for Address Book, MemoPad, Tasks, or Calendar
Problem
The Wireless Synchronization option is missing from the Address Book, MemoPad, Tasks, or Calendar.
Cause
The Service Book information is incorrect or has been corrupted.
Resolution
Complete one of the following options to regenerate the required Service Book information.
Resolution 1
Regenerate the Desktop[Sync] service book for Address Book, MemoPad and Tasks by completing the following steps:
For BlackBerry® Device Software 4.0.x
1. Go to Options > Service Book.
2. Click Desktop[Sync].
3. Display the menu and select Delete.
4. Display the menu again and select Undelete.
For BlackBerry Device Software 4.1.x or later
1. Go to Options > Advanced Options > Service Book.
2. Click Desktop[Sync].
3. Display the menu and select Delete.
4. Display the menu again and select Undelete.
Resolution 2
Regenerate the Desktop[CICAL] service book for the Calendar by completing the following steps:
For BlackBerry Device Software 4.0.x
1. Go to Options > Service Book.
2. Click Desktop[CICAL].
3. Display the menu and select Delete.
4. Display the menu again and select Undelete.
For BlackBerry Device Software 4.1.x or higher
1. Go to Options > Advanced Options > Service Book.
2. Click Desktop[CICAL].
3. Display the menu and select Delete.
4. Display the menu again and select Undelete.
Resolution 3
Regenerate all Desktop service books by completing the following steps:
For BlackBerry Device Software 4.0.x
1. Go to Options > Service Book.
2. Delete all the Service Books starting with the word Desktop (default setting).
3. Contact your BlackBerry Enterprise Server administrator and request that service books be resent. For instructions, see Resolution 4.
For BlackBerry Device Software 4.1.x
1. Go to Options > Advanced Options > Service Book.
2. Delete all the Service Books starting with the word Desktop (default setting).
3. Contact your BlackBerry Enterprise Server administrator and request that service books be resent. For instructions, see Resolution 4.
Resolution 4
1. Clear the service book database using BlackBerry® Desktop Manager. For instructions, see KB05010.
2. Resend the service books using BlackBerry Desktop Manager or the BlackBerry Enterprise Server.
Using BlackBerry Desktop Manager
Service books are sent after a new encryption key is generated. See KB02740 for instructions on how to generate a new encryption key with BlackBerry Desktop Manager.
Note: To resend service books wirelessly, see KB04310.
Using BlackBerry Enterprise Server
1. Open BlackBerry Manager and select the BlackBerry smartphone user account.
2. In the tasks list, select IT Admin and click Resend Service Book.
Resolution 5
Resend service books from BlackBerry Enterprise Server:
For BlackBerry Device Software 4.1.x or later
1. Go to Options > Advanced Options > Service Book.
2. Click Desktop[Sync].
3. Open the menu and select Delete.
4. Resend service books from the BlackBerry Enterprise Server. For instructions, see Resolution 4.
The Wireless Synchronization option is missing from the Address Book, MemoPad, Tasks, or Calendar.
Cause
The Service Book information is incorrect or has been corrupted.
Resolution
Complete one of the following options to regenerate the required Service Book information.
Resolution 1
Regenerate the Desktop[Sync] service book for Address Book, MemoPad and Tasks by completing the following steps:
For BlackBerry® Device Software 4.0.x
1. Go to Options > Service Book.
2. Click Desktop[Sync].
3. Display the menu and select Delete.
4. Display the menu again and select Undelete.
For BlackBerry Device Software 4.1.x or later
1. Go to Options > Advanced Options > Service Book.
2. Click Desktop[Sync].
3. Display the menu and select Delete.
4. Display the menu again and select Undelete.
Resolution 2
Regenerate the Desktop[CICAL] service book for the Calendar by completing the following steps:
For BlackBerry Device Software 4.0.x
1. Go to Options > Service Book.
2. Click Desktop[CICAL].
3. Display the menu and select Delete.
4. Display the menu again and select Undelete.
For BlackBerry Device Software 4.1.x or higher
1. Go to Options > Advanced Options > Service Book.
2. Click Desktop[CICAL].
3. Display the menu and select Delete.
4. Display the menu again and select Undelete.
Resolution 3
Regenerate all Desktop service books by completing the following steps:
For BlackBerry Device Software 4.0.x
1. Go to Options > Service Book.
2. Delete all the Service Books starting with the word Desktop (default setting).
3. Contact your BlackBerry Enterprise Server administrator and request that service books be resent. For instructions, see Resolution 4.
For BlackBerry Device Software 4.1.x
1. Go to Options > Advanced Options > Service Book.
2. Delete all the Service Books starting with the word Desktop (default setting).
3. Contact your BlackBerry Enterprise Server administrator and request that service books be resent. For instructions, see Resolution 4.
Resolution 4
1. Clear the service book database using BlackBerry® Desktop Manager. For instructions, see KB05010.
2. Resend the service books using BlackBerry Desktop Manager or the BlackBerry Enterprise Server.
Using BlackBerry Desktop Manager
Service books are sent after a new encryption key is generated. See KB02740 for instructions on how to generate a new encryption key with BlackBerry Desktop Manager.
Note: To resend service books wirelessly, see KB04310.
Using BlackBerry Enterprise Server
1. Open BlackBerry Manager and select the BlackBerry smartphone user account.
2. In the tasks list, select IT Admin and click Resend Service Book.
Resolution 5
Resend service books from BlackBerry Enterprise Server:
For BlackBerry Device Software 4.1.x or later
1. Go to Options > Advanced Options > Service Book.
2. Click Desktop[Sync].
3. Open the menu and select Delete.
4. Resend service books from the BlackBerry Enterprise Server. For instructions, see Resolution 4.
Clear the service book or service book database
Procedures
If a service book is corrupt on the BlackBerry device, you may experience problems sending and receiving messages. To fix this problem, you must clear the Service Book database, then restore the service books on the BlackBerry device.
When clearing the Service Book database, if you are on a BlackBerry Enterprise Server, you will either have to generate a new key or receive a new key from the BlackBerry Enterprise Server.
If you are a BlackBerry Internet Service user, you will have to re-send the service books from your BlackBerry Internet Service account.
Important: If you are running BlackBerry Device Software 4.0 or later, complete all of the tasks below. If you are running BlackBerry Device Software 3.8 or earlier, complete tasks 2 and 3.
Task 1 - Delete the Desktop [SYNC] service book
If you are running BlackBerry Device Software 4.0 or later, you cannot clear the Service Book database unless you delete the Desktop [SYNC] service book first. To delete the service book, complete the following steps on the BlackBerry device:
1. Connect your BlackBerry device to your computer.
2. From the Home screen, click Options.
Note: Depending on the theme running on your device, you may need to click Settings, then Options.
3. If you are running BlackBerry Device Software 4.1 or later, click Advanced Options, then Service Book.
OR
If you are running BlackBerry Device Software 4.0 or earlier, click Service Book.
4. Click the Desktop [SYNC] service book and select Delete.
5. In the Are You Sure? dialog box, click Delete.
Note: The above steps will also take affect when trying to delete the Desktop [Sync] and/or Desktop [Cical] service book to restore the address book, memo pad, calendar and tasks from a backup file.
Task 2 - Clear the Service Book database
Complete the following steps:
1. Make sure your BlackBerry device is connected to your computer.
2. Open BlackBerry Desktop Manager and double-click Backup and Restore.
3. On the Backup and Restore window, click Advanced. The Backup/Restore window appears.
4. In the list of BlackBerry device databases, select Service Book, then click Clear.
Note: If you are running BlackBerry Device Software 4.0 or later, and you do not delete the Desktop [SYNC] service book, the Service Book database will not be accessible.
5. Click OK in the Warning window.
6. Click Close.
Task 3 - Restore the Service Book database
To restore the Service Book database on your BlackBerry device, disconnect your BlackBerry device from your computer, wait 5 seconds, then reconnect the BlackBerry device. If you have a BlackBerry Internet Service account, see KB-02830 for instructions on how to resend the service book for the BlackBerry Internet Service.
Note: If you experience problems receiving messages on the BlackBerry device, perform a hard reset. For instructions, see KB-02141.
If a service book is corrupt on the BlackBerry device, you may experience problems sending and receiving messages. To fix this problem, you must clear the Service Book database, then restore the service books on the BlackBerry device.
When clearing the Service Book database, if you are on a BlackBerry Enterprise Server, you will either have to generate a new key or receive a new key from the BlackBerry Enterprise Server.
If you are a BlackBerry Internet Service user, you will have to re-send the service books from your BlackBerry Internet Service account.
Important: If you are running BlackBerry Device Software 4.0 or later, complete all of the tasks below. If you are running BlackBerry Device Software 3.8 or earlier, complete tasks 2 and 3.
Task 1 - Delete the Desktop [SYNC] service book
If you are running BlackBerry Device Software 4.0 or later, you cannot clear the Service Book database unless you delete the Desktop [SYNC] service book first. To delete the service book, complete the following steps on the BlackBerry device:
1. Connect your BlackBerry device to your computer.
2. From the Home screen, click Options.
Note: Depending on the theme running on your device, you may need to click Settings, then Options.
3. If you are running BlackBerry Device Software 4.1 or later, click Advanced Options, then Service Book.
OR
If you are running BlackBerry Device Software 4.0 or earlier, click Service Book.
4. Click the Desktop [SYNC] service book and select Delete.
5. In the Are You Sure? dialog box, click Delete.
Note: The above steps will also take affect when trying to delete the Desktop [Sync] and/or Desktop [Cical] service book to restore the address book, memo pad, calendar and tasks from a backup file.
Task 2 - Clear the Service Book database
Complete the following steps:
1. Make sure your BlackBerry device is connected to your computer.
2. Open BlackBerry Desktop Manager and double-click Backup and Restore.
3. On the Backup and Restore window, click Advanced. The Backup/Restore window appears.
4. In the list of BlackBerry device databases, select Service Book, then click Clear.
Note: If you are running BlackBerry Device Software 4.0 or later, and you do not delete the Desktop [SYNC] service book, the Service Book database will not be accessible.
5. Click OK in the Warning window.
6. Click Close.
Task 3 - Restore the Service Book database
To restore the Service Book database on your BlackBerry device, disconnect your BlackBerry device from your computer, wait 5 seconds, then reconnect the BlackBerry device. If you have a BlackBerry Internet Service account, see KB-02830 for instructions on how to resend the service book for the BlackBerry Internet Service.
Note: If you experience problems receiving messages on the BlackBerry device, perform a hard reset. For instructions, see KB-02141.
Generate a new encryption key
Procedure
A new encryption key can be generated with the BlackBerry device, BlackBerry Desktop Manager, or the BlackBerry Enterprise Server.
To generate a new encryption key with a BlackBerry device
Note: The following procedure requires BlackBerry Enterprise Server software version 4.0 or later and BlackBerry Device Software 4.0 or later.
1. From the Home screen, click Options or click Settings, then Options (depending on the theme you have running on your BlackBerry device).
2. If you are running BlackBerry Device Software 4.0, click Security.
If you are running BlackBerry Device Software 4.1 or later, click Security Options, then General Settings.
3. In the Service section, click to open the menu.
4. Select Regenerate Encryption Key.
5. When the message The key for service has been updated appears, click OK.
To generate a new encryption key with BlackBerry Desktop Manager
1. Connect the BlackBerry device to the computer.
2. In BlackBerry Desktop Manager, double-click Redirector Settings.
3. In the Redirector Settings window, click the Security tab.
4. Select Generate keys manually, then click Generate. The Generating New Key window appears.
5. Move the mouse around until the Generating New Key window closes. A new encryption key has been generated.
6. If you want to be prompted to generate a new encryption key every 31 days, select Generate keys automatically.
7. Click Apply, then click OK.
To generate a new encryption key with BlackBerry Enterprise Server software version 4.0 for Microsoft® Exchange
1. Connect the BlackBerry device to the computer on which the BlackBerry Enterprise Server is installed.
2. Select BlackBerry Manager.
3. Right-click and choose Properties from the menu.
4. Click the Port tab and select COM or USB.
OR
To find the BlackBerry device connection automatically, click Detect.
5. Click OK in the dialog box asking you to ensure that the BlackBerry device is connected.
A new window appears notifying you that the BlackBerry device has been found. It also displays the BlackBerry device user’s personal identification number (PIN).
6. Click OK.
7. Select the BlackBerry device user’s account.
8. Right-click and select Properties.
9. Click the Security tab and select Generate keys manually.
10. Click Generate and move the mouse around.
11. Click Apply to change the Status from Pending update to Up to date, then click OK.
To generate a new encryption key with BlackBerry Enterprise Server software version 4.1 and later
1. Connect the BlackBerry device to the computer on which the BlackBerry Enterprise Server is installed.
2. Open BlackBerry Manager.
3. Select Local Ports (Device Management) and ensure that the BlackBerry device has been detected.
4. Choose the Server Name and select the Users tab.
5. Highlight the user that you would like to assign the BlackBerry device to.
6. Expand the Device Management menu.
7. Click Assign Device.
8. Select the connected BlackBerry device to assign to the user.
9. Click OK to assign the BlackBerry device.
A new encryption key can be generated with the BlackBerry device, BlackBerry Desktop Manager, or the BlackBerry Enterprise Server.
To generate a new encryption key with a BlackBerry device
Note: The following procedure requires BlackBerry Enterprise Server software version 4.0 or later and BlackBerry Device Software 4.0 or later.
1. From the Home screen, click Options or click Settings, then Options (depending on the theme you have running on your BlackBerry device).
2. If you are running BlackBerry Device Software 4.0, click Security.
If you are running BlackBerry Device Software 4.1 or later, click Security Options, then General Settings.
3. In the Service section, click to open the menu.
4. Select Regenerate Encryption Key.
5. When the message The key for service
To generate a new encryption key with BlackBerry Desktop Manager
1. Connect the BlackBerry device to the computer.
2. In BlackBerry Desktop Manager, double-click Redirector Settings.
3. In the Redirector Settings window, click the Security tab.
4. Select Generate keys manually, then click Generate. The Generating New Key window appears.
5. Move the mouse around until the Generating New Key window closes. A new encryption key has been generated.
6. If you want to be prompted to generate a new encryption key every 31 days, select Generate keys automatically.
7. Click Apply, then click OK.
To generate a new encryption key with BlackBerry Enterprise Server software version 4.0 for Microsoft® Exchange
1. Connect the BlackBerry device to the computer on which the BlackBerry Enterprise Server is installed.
2. Select BlackBerry Manager.
3. Right-click and choose Properties from the menu.
4. Click the Port tab and select COM or USB.
OR
To find the BlackBerry device connection automatically, click Detect.
5. Click OK in the dialog box asking you to ensure that the BlackBerry device is connected.
A new window appears notifying you that the BlackBerry device has been found. It also displays the BlackBerry device user’s personal identification number (PIN).
6. Click OK.
7. Select the BlackBerry device user’s account.
8. Right-click and select Properties.
9. Click the Security tab and select Generate keys manually.
10. Click Generate and move the mouse around.
11. Click Apply to change the Status from Pending update to Up to date, then click OK.
To generate a new encryption key with BlackBerry Enterprise Server software version 4.1 and later
1. Connect the BlackBerry device to the computer on which the BlackBerry Enterprise Server is installed.
2. Open BlackBerry Manager.
3. Select Local Ports (Device Management) and ensure that the BlackBerry device has been detected.
4. Choose the Server Name and select the Users tab.
5. Highlight the user that you would like to assign the BlackBerry device to.
6. Expand the Device Management menu.
7. Click Assign Device.
8. Select the connected BlackBerry device to assign to the user.
9. Click OK to assign the BlackBerry device.
Receive missing desktop service books wirelessly
Procedure
To receive missing desktop service books wirelessly, complete the following steps:
Note: The BlackBerry device must be activated on the BlackBerry Enterprise Server and have at least one desktop service book.
1. Open Options.
2. Click Security Options.
3. Click General Settings.
4. Highlight an entry in the Services field.
5. Display the menu and select Regenerate Encryption Key. When the BlackBerry device has regenerated the encryption key, any missing desktop service books will be sent to the service book database.
To receive missing desktop service books wirelessly, complete the following steps:
Note: The BlackBerry device must be activated on the BlackBerry Enterprise Server and have at least one desktop service book.
1. Open Options.
2. Click Security Options.
3. Click General Settings.
4. Highlight an entry in the Services field.
5. Display the menu and select Regenerate Encryption Key. When the BlackBerry device has regenerated the encryption key, any missing desktop service books will be sent to the service book database.
No option to enable wireless email reconciliation on the BlackBerry smartphone
Problem
There is no option to enable wireless email reconciliation on the BlackBerry smartphone.
Cause
The service book information is corrupt.
Resolution
Regenerate a new service book. To perform this, complete the following steps:
1. Verify the wireless option is turned on and the BlackBerry smartphone is receiving General Packet Radio Service (GPRS), 1X, or NXTL with a strong signal (4 or 5 bars).
2. Open BlackBerry Desktop Manager and connect the BlackBerry smartphone to the computer.
3. Open Backup and Restore and click Advanced.
4. In the Databases section, select the Service Book database and click Clear.
5. Disconnect the BlackBerry smartphone from the computer and perform a hard reset. For instructions, see KB02141.
6. Connect the BlackBerry smartphone to the computer.
7. Resend the service book.
Delete and undelete the Desktop [CMIME] service book from the BlackBerry smartphone. To perform this, complete the following steps:
1. On the Home screen, click Options.
Note: Depending on the theme on the BlackBerry smartphone, it may be necessary to click Settings, then Options.
2. If BlackBerry Device Software 4.1 or later is being used, click Advanced Options, then Service Book.
If BlackBerry Device Software 4.0 or earlier is being used, click Service Book.
3. Click Desktop [CMIME] and select Delete.
4. When prompted to confirm, click Delete.
5. Open the menu and select Undelete.
If the issue is not resolved, complete steps 1 to 7 above and proceed to complete the following from the BlackBerry Enterprise Server:
1. In BlackBerry Manager, clear the BlackBerry smartphone personal identification number (PIN). For instructions on changing BlackBerry smartphone user statistics, please see the appropriate Administration Guide for the version of BlackBerry Enterprise Server that is installed.
2. Connect the BlackBerry smartphone to the computer.
3. Resend the service book.
There is no option to enable wireless email reconciliation on the BlackBerry smartphone.
Cause
The service book information is corrupt.
Resolution
Regenerate a new service book. To perform this, complete the following steps:
1. Verify the wireless option is turned on and the BlackBerry smartphone is receiving General Packet Radio Service (GPRS), 1X, or NXTL with a strong signal (4 or 5 bars).
2. Open BlackBerry Desktop Manager and connect the BlackBerry smartphone to the computer.
3. Open Backup and Restore and click Advanced.
4. In the Databases section, select the Service Book database and click Clear.
5. Disconnect the BlackBerry smartphone from the computer and perform a hard reset. For instructions, see KB02141.
6. Connect the BlackBerry smartphone to the computer.
7. Resend the service book.
Delete and undelete the Desktop [CMIME] service book from the BlackBerry smartphone. To perform this, complete the following steps:
1. On the Home screen, click Options.
Note: Depending on the theme on the BlackBerry smartphone, it may be necessary to click Settings, then Options.
2. If BlackBerry Device Software 4.1 or later is being used, click Advanced Options, then Service Book.
If BlackBerry Device Software 4.0 or earlier is being used, click Service Book.
3. Click Desktop [CMIME] and select Delete.
4. When prompted to confirm, click Delete.
5. Open the menu and select Undelete.
If the issue is not resolved, complete steps 1 to 7 above and proceed to complete the following from the BlackBerry Enterprise Server:
1. In BlackBerry Manager, clear the BlackBerry smartphone personal identification number (PIN). For instructions on changing BlackBerry smartphone user statistics, please see the appropriate Administration Guide for the version of BlackBerry Enterprise Server that is installed.
2. Connect the BlackBerry smartphone to the computer.
3. Resend the service book.
Cannot use the Set password and lock handheld command from BlackBerry Manager
Problem
A BlackBerry device user forgets the password to unlock a BlackBerry device. The system administrator tries to unlock the BlackBerry device using the Set password and lock handheld command in BlackBerry Manager.
If the BlackBerry device user remembers the password, then the command will work as expected; however, the BlackBerry device user must type the old password first, then type the new password that was set by the system administrator. If the BlackBerry device user does not know the old password, then after typing the password incorrectly 10 times, all data on the BlackBerry device will be erased.
If the BlackBerry device does not have content protection enabled, but content protection was enabled previously (while the BlackBerry device was activated on the BlackBerry Enterprise Server), the command will not work. If content protection was disabled while the BlackBerry device was activated on the BlackBerry Enterprise Server, all data on the BlackBerry device must be erased and the BlackBerry device must be activated on the BlackBerry Enterprise Server again. The system administrator will then be able to use the Set password and lock handheld command.
Cause
The BlackBerry device still has encrypted data even after content protection is disabled; therefore, the Set password and lock handheld command prompts the BlackBerry device user to type the old password first, then accept and type the new password set by the system administrator.
Resolution
Erase all data on the BlackBerry device, then reactivate the BlackBerry device on the BlackBerry Enterprise Server.
A BlackBerry device user forgets the password to unlock a BlackBerry device. The system administrator tries to unlock the BlackBerry device using the Set password and lock handheld command in BlackBerry Manager.
If the BlackBerry device user remembers the password, then the command will work as expected; however, the BlackBerry device user must type the old password first, then type the new password that was set by the system administrator. If the BlackBerry device user does not know the old password, then after typing the password incorrectly 10 times, all data on the BlackBerry device will be erased.
If the BlackBerry device does not have content protection enabled, but content protection was enabled previously (while the BlackBerry device was activated on the BlackBerry Enterprise Server), the command will not work. If content protection was disabled while the BlackBerry device was activated on the BlackBerry Enterprise Server, all data on the BlackBerry device must be erased and the BlackBerry device must be activated on the BlackBerry Enterprise Server again. The system administrator will then be able to use the Set password and lock handheld command.
Cause
The BlackBerry device still has encrypted data even after content protection is disabled; therefore, the Set password and lock handheld command prompts the BlackBerry device user to type the old password first, then accept and type the new password set by the system administrator.
Resolution
Erase all data on the BlackBerry device, then reactivate the BlackBerry device on the BlackBerry Enterprise Server.
Unable to write to database because database would exceed its disk quota
Problem
The BlackBerry Enterprise Server displays the following error:
Unable to write to database because database would exceed its disk quota.
Cause
This problem has multiple causes.
Cause 1
The BlackBerry Enterprise Server sends an all points bulletin (APB) for an email message that is not delivered to the BlackBerry smartphone of the BlackBerry smartphone user whose IBM Lotus Domino mail file is exceeding the quota limit. The APB includes the following error message:
unable to process message
The email message may be in Multipurpose Internet Mail Extensions (MIME) format and include attachments. The BlackBerry Enterprise Server makes a request to open the message document and if the message document is not in Rich Text Format, the BlackBerry Enterprise Server makes a request for the IBM Lotus Domino messaging server to convert the email message to Rich Text Format (generally from MIME format). When the IBM Lotus Domino messaging server converts a message to Rich Text Format, it needs sufficient free space in the mail file to expand the email message. When the IBM Lotus Domino messaging server reports that it is not able to process the request, the BlackBerry Enterprise Server reports the Unable to write to database because database would exceed its disk quota error.
Cause 2
The BlackBerry Enterprise Server attempts to save a copy of an outgoing email message from the BlackBerry smartphone for the BlackBerry smartphone user whose IBM Lotus Domino mail file is exceeding the quota limit.
For example, an email message is sent from the BlackBerry smartphone and the Save Copy of Sent Folders setting is set to True on the BlackBerry Enterprise Server for the BlackBerry smartphone user. The BlackBerry Enterprise Server will send the outgoing email message using the mail.box of the IBM Lotus Domino server that is running the BlackBerry Enterprise Server task. The BlackBerry Enterprise Server also attempts to save a copy of the outgoing email message in the BlackBerry smartphone user's mail file. Since the mail file size has exceeded its quota, the IBM Lotus Domino mail server is not able to save the copy of the outgoing email message and the BlackBerry Enterprise Server reports the Unable to write to database because database would exceed its disk quota error.
Resolution
Decrease the mail file size so that it is below the quota limit. Compacting the mail file may release any white space and decrease the mail file size. For steps on compacting, see KB02207.
It is also possible to remove the quota limit on the mail file.
Workaround
For Cause 1
Setting the Preference for Incoming Message setting on the affected BlackBerry smartphone user's Person document to Prefer Notes rich text format may mitigate the error until one of the resolutions can be applied. Please consult IBM support for more details on the Preference for Incoming Message option.
The BlackBerry Enterprise Server displays the following error:
Unable to write to database because database would exceed its disk quota.
Cause
This problem has multiple causes.
Cause 1
The BlackBerry Enterprise Server sends an all points bulletin (APB) for an email message that is not delivered to the BlackBerry smartphone of the BlackBerry smartphone user whose IBM Lotus Domino mail file is exceeding the quota limit. The APB includes the following error message:
unable to process message
The email message may be in Multipurpose Internet Mail Extensions (MIME) format and include attachments. The BlackBerry Enterprise Server makes a request to open the message document and if the message document is not in Rich Text Format, the BlackBerry Enterprise Server makes a request for the IBM Lotus Domino messaging server to convert the email message to Rich Text Format (generally from MIME format). When the IBM Lotus Domino messaging server converts a message to Rich Text Format, it needs sufficient free space in the mail file to expand the email message. When the IBM Lotus Domino messaging server reports that it is not able to process the request, the BlackBerry Enterprise Server reports the Unable to write to database because database would exceed its disk quota error.
Cause 2
The BlackBerry Enterprise Server attempts to save a copy of an outgoing email message from the BlackBerry smartphone for the BlackBerry smartphone user whose IBM Lotus Domino mail file is exceeding the quota limit.
For example, an email message is sent from the BlackBerry smartphone and the Save Copy of Sent Folders setting is set to True on the BlackBerry Enterprise Server for the BlackBerry smartphone user. The BlackBerry Enterprise Server will send the outgoing email message using the mail.box of the IBM Lotus Domino server that is running the BlackBerry Enterprise Server task. The BlackBerry Enterprise Server also attempts to save a copy of the outgoing email message in the BlackBerry smartphone user's mail file. Since the mail file size has exceeded its quota, the IBM Lotus Domino mail server is not able to save the copy of the outgoing email message and the BlackBerry Enterprise Server reports the Unable to write to database because database would exceed its disk quota error.
Resolution
Decrease the mail file size so that it is below the quota limit. Compacting the mail file may release any white space and decrease the mail file size. For steps on compacting, see KB02207.
It is also possible to remove the quota limit on the mail file.
Workaround
For Cause 1
Setting the Preference for Incoming Message setting on the affected BlackBerry smartphone user's Person document to Prefer Notes rich text format may mitigate the error until one of the resolutions can be applied. Please consult IBM support for more details on the Preference for Incoming Message option.
jlcommander to wipe the handheld
Jl Commander is a good tool to wipe Handheld from your Machine.
Its like a low level format that can be done on this devices.
Its like a low level format that can be done on this devices.
Automatic wireless backup
Details
Automatic wireless backup copies BlackBerry user settings and data to the BlackBerry Enterprise Server automatically. These settings and data are restored to the BlackBerry device during wireless enterprise activation process. Automatic wireless backup is enabled on the BlackBerry Enterprise Server by default and it allows settings and data that are not already stored in the mail system to be backed up to the server. Automatic wireless back up also allows system administrators to wirelessly restore settings and data if the BlackBerry user experiences a problem.
You can back up the following BlackBerry device settings and data using automatic wireless backup:
Application Settings
BlackBerry Browser Bookmarks
Folders
Channels
Browser options
BlackBerry device options AutoText entries
Font settings
Help options
Default service selector
Profiles
BlackBerry device agent
Home screen display options
Firewall options
WAP push options
messaging Attachment viewer options
Searches
Filters
Settings
Message list options
Phone Recently called list
Phone options
Phone call logs
PIM Address book options
MemoPad options
Calendar options
Task list options
Categories
Additional Information
To enable automatic wireless backup:
1. In the left pane of BlackBerry Manager, click a BlackBerry Enterprise Server.
2. On the Users tab, double-click a user account.
3. Click PIM Sync
4. Click Automatic Wireless Backup Enabled.
5. In the drop-down list, click True.
6. Click OK.
Automatic wireless backup copies BlackBerry user settings and data to the BlackBerry Enterprise Server automatically. These settings and data are restored to the BlackBerry device during wireless enterprise activation process. Automatic wireless backup is enabled on the BlackBerry Enterprise Server by default and it allows settings and data that are not already stored in the mail system to be backed up to the server. Automatic wireless back up also allows system administrators to wirelessly restore settings and data if the BlackBerry user experiences a problem.
You can back up the following BlackBerry device settings and data using automatic wireless backup:
Application Settings
BlackBerry Browser Bookmarks
Folders
Channels
Browser options
BlackBerry device options AutoText entries
Font settings
Help options
Default service selector
Profiles
BlackBerry device agent
Home screen display options
Firewall options
WAP push options
messaging Attachment viewer options
Searches
Filters
Settings
Message list options
Phone Recently called list
Phone options
Phone call logs
PIM Address book options
MemoPad options
Calendar options
Task list options
Categories
Additional Information
To enable automatic wireless backup:
1. In the left pane of BlackBerry Manager, click a BlackBerry Enterprise Server.
2. On the Users tab, double-click a user account.
3. Click PIM Sync
4. Click Automatic Wireless Backup Enabled.
5. In the drop-down list, click True.
6. Click OK.
Restore data or databases to a BlackBerry device from a backup file
Procedure
To restore all the data in the backup file to your BlackBerry device, complete the following steps:
1. Connect the BlackBerry device to your computer.
2. Open the BlackBerry® Desktop Manager.
3. Double-click Backup and Restore.
4. Click Restore.
5. Double-click the backup (.ipd) file.
To restore specific databases in the backup file to your BlackBerry device, complete the following steps:
1. Connect the BlackBerry device to your computer.
2. Open the BlackBerry® Desktop Manager.
3. Click Backup and Restore.
4. Click Advanced.
5. On the File menu, click Open.
6. Double-click the backup (.ipd) file.
7. In the Desktop File Databases section, select the database(s) to restore.
8. Click the right arrow button.
Note: If the right arrow button is unavailable, see the Additional Information section in this article.
9. Click Yes.
Additional Info
If your BlackBerry device is associated with a BlackBerry Enterprise Server software version 4.0 or later, and your BlackBerry device user account is set for automatic wireless backup, the right arrow button will appear unavailable when you attempt to manually restore most databases. To restore these databases manually, complete the following steps:
1. Delete the Desktop [SYNC] service book from your BlackBerry device.
1. On your BlackBerry device, click Options.
2. Click Advanced Options.
3. Click Service Book.
4. Highlight Desktop [SYNC].
5. Display the menu and click Delete.
2. Connect the BlackBerry device to the computer.
3. Restore the databases using steps 1 to 9 in the procedure above.
4. When the database(s) are restored, open the Service Book screen on the BlackBerry device.
5. Display the menu and click Undelete. The Desktop [SYNC] service book is restored.
To restore all the data in the backup file to your BlackBerry device, complete the following steps:
1. Connect the BlackBerry device to your computer.
2. Open the BlackBerry® Desktop Manager.
3. Double-click Backup and Restore.
4. Click Restore.
5. Double-click the backup (.ipd) file.
To restore specific databases in the backup file to your BlackBerry device, complete the following steps:
1. Connect the BlackBerry device to your computer.
2. Open the BlackBerry® Desktop Manager.
3. Click Backup and Restore.
4. Click Advanced.
5. On the File menu, click Open.
6. Double-click the backup (.ipd) file.
7. In the Desktop File Databases section, select the database(s) to restore.
8. Click the right arrow button.
Note: If the right arrow button is unavailable, see the Additional Information section in this article.
9. Click Yes.
Additional Info
If your BlackBerry device is associated with a BlackBerry Enterprise Server software version 4.0 or later, and your BlackBerry device user account is set for automatic wireless backup, the right arrow button will appear unavailable when you attempt to manually restore most databases. To restore these databases manually, complete the following steps:
1. Delete the Desktop [SYNC] service book from your BlackBerry device.
1. On your BlackBerry device, click Options.
2. Click Advanced Options.
3. Click Service Book.
4. Highlight Desktop [SYNC].
5. Display the menu and click Delete.
2. Connect the BlackBerry device to the computer.
3. Restore the databases using steps 1 to 9 in the procedure above.
4. When the database(s) are restored, open the Service Book screen on the BlackBerry device.
5. Display the menu and click Undelete. The Desktop [SYNC] service book is restored.
Why is my BlackBerry losing its call logs or message logs?
Having a large amount of images, ringtones and or games stored in the device may reduce available free memory. If the BlackBerry Pearl's memory is at or near capacity the handheld will begin to delete the oldest Call Log and Text Message (SMS) entries in an effort to free up memory space. In order to prevent this, free memory must be increased. NOTE: Saved messages will not be deleted.
(Thanks to BobRoss @ BlackBerryForums.com for collecting this information)
Determine the Amount of Free Memory on the BlackBerry
On your BlackBerry, go to Options > Status. That will show your amount of free memory.
If the amount of free memory available on the handheld is 0, the amount of free memory must be increased to prevent the handheld from auto deleting call log entries and messages.
Suggested Ways to Increase Free Memory
Reduce Allocated Media Memory
1. Scroll to and select the Media icon.
2. Select the Pictures icon.
3. Select the Device Memory icon.
4. Press the Menu key, select Options.
5. Change the Device Memory Limit to 12MB.
6. Press the Menu key, select Save.
7. Hard Reset the BlackBerry.
Reduce Calendar Keep Appointments to 60 days or less
1. Scroll to and select the Calendar icon.
2. Press the Menu key, select Options.
3. Scroll to and select Keep Appointments.
4. Select the desired amount of time to keep appointments.
5. Press the Menu key, select Save.
6. Hard Reset the BlackBerry.
Reduce the amount of time Messages are kept on the handheld.
1. Scroll to and select the Messages icon.
2. Press the Menu key, select Options.
3. Select General Options.
4. Scroll to and select Keep Messages.
5. Select the desired amount of time to keep appointments.
6. Press the Menu key, select Save.
7. Hard Reset the BlackBerry.
Clear Cache and Cookies
1. Scroll to and select the Browser or Media Net icon.
2. Press the Menu key.
3. Select Options.
4. Select Cache Operations.
5. Select Clear History.
6. Note: Clear History will no longer appear once it has been selected.
7. Hard Reset the BlackBerry.
Delete Unused Languages
Note: If deleting both the unused languages and the sample video wait to restart the device until both processes have been completed
1. Scroll to and select the Settings icon.
2. Select the Options icon.
3. Select Advanced Options.
4. Select Applications.
5. Scroll to and highlight each of the unused languages under the Input Support and Language and Input Support subheadings.
6. Press the Menu key.
7. Select Delete.
8. Select Delete.
9. When prompted to Restart select No until all unused languages are deleted.
10. NOTE:Repeat steps 4-8 until all unused languages are deleted then select Yes when prompted to restart.
11. Hard Reset the BlackBerry.
Delete Sample Video
Note: If deleting both the unused languages and the sample video wait to restart the device until both processes have been completed. The sample video is the pre-installed video for the blackberry and is ~2.2MB in size.
1. Scroll to and select the Settings icon.
2. Select the Options icon.
3. Select Advanced Options.
4. Select Applications.
5. Scroll to and highlight "Blackberry Sample Video".
6. Press the Menu key.
7. Select Delete.
8. Select Delete.
9. When prompted to Restart select Yes.
10. Hard Reset the BlackBerry.
Change Call Log Options
1. Scroll to and select the Phone icon.
2. Press the Menu key.
3. Select Options.
4. Select Call Logging.
5. Select either Missed Calls or None.
6. Hard Reset the BlackBerry.
(Thanks to BobRoss @ BlackBerryForums.com for collecting this information)
Determine the Amount of Free Memory on the BlackBerry
On your BlackBerry, go to Options > Status. That will show your amount of free memory.
If the amount of free memory available on the handheld is 0, the amount of free memory must be increased to prevent the handheld from auto deleting call log entries and messages.
Suggested Ways to Increase Free Memory
Reduce Allocated Media Memory
1. Scroll to and select the Media icon.
2. Select the Pictures icon.
3. Select the Device Memory icon.
4. Press the Menu key, select Options.
5. Change the Device Memory Limit to 12MB.
6. Press the Menu key, select Save.
7. Hard Reset the BlackBerry.
Reduce Calendar Keep Appointments to 60 days or less
1. Scroll to and select the Calendar icon.
2. Press the Menu key, select Options.
3. Scroll to and select Keep Appointments.
4. Select the desired amount of time to keep appointments.
5. Press the Menu key, select Save.
6. Hard Reset the BlackBerry.
Reduce the amount of time Messages are kept on the handheld.
1. Scroll to and select the Messages icon.
2. Press the Menu key, select Options.
3. Select General Options.
4. Scroll to and select Keep Messages.
5. Select the desired amount of time to keep appointments.
6. Press the Menu key, select Save.
7. Hard Reset the BlackBerry.
Clear Cache and Cookies
1. Scroll to and select the Browser or Media Net icon.
2. Press the Menu key.
3. Select Options.
4. Select Cache Operations.
5. Select Clear History.
6. Note: Clear History will no longer appear once it has been selected.
7. Hard Reset the BlackBerry.
Delete Unused Languages
Note: If deleting both the unused languages and the sample video wait to restart the device until both processes have been completed
1. Scroll to and select the Settings icon.
2. Select the Options icon.
3. Select Advanced Options.
4. Select Applications.
5. Scroll to and highlight each of the unused languages under the Input Support and Language and Input Support subheadings.
6. Press the Menu key.
7. Select Delete.
8. Select Delete.
9. When prompted to Restart select No until all unused languages are deleted.
10. NOTE:Repeat steps 4-8 until all unused languages are deleted then select Yes when prompted to restart.
11. Hard Reset the BlackBerry.
Delete Sample Video
Note: If deleting both the unused languages and the sample video wait to restart the device until both processes have been completed. The sample video is the pre-installed video for the blackberry and is ~2.2MB in size.
1. Scroll to and select the Settings icon.
2. Select the Options icon.
3. Select Advanced Options.
4. Select Applications.
5. Scroll to and highlight "Blackberry Sample Video".
6. Press the Menu key.
7. Select Delete.
8. Select Delete.
9. When prompted to Restart select Yes.
10. Hard Reset the BlackBerry.
Change Call Log Options
1. Scroll to and select the Phone icon.
2. Press the Menu key.
3. Select Options.
4. Select Call Logging.
5. Select either Missed Calls or None.
6. Hard Reset the BlackBerry.
Turn on wireless and wired message reconciliation
Procedure
To turn on wireless message reconciliation, you must have a BlackBerry Enterprise Server account or a BlackBerry Internet Service account.
BlackBerry Enterprise Server
To reconcile messages between the inbox and deleted items folders on both the BlackBerry device and the email client, complete the following steps on the BlackBerry device:
1. Verify that you have a BlackBerry Enterprise Server account.
2. On the BlackBerry device Home screen, click Messages.
3. Open Options and select Email Reconciliation.
4. In the Delete On field, select Handheld, Mailbox & Handheld, or Prompt.
5. In the Wireless Reconcile field, select On.
6. In the On Conflicts field, select Handheld Wins or Mailbox Wins.
7. Save your changes.
BlackBerry Internet Service
BlackBerry Internet Service 2.0 supports one-way synchronization from the BlackBerry device to the source messaging and collaboration server, as shown below.
Source Wireless deletes Save Sent Items Wireless read/unread status
Microsoft® Outlook® Web Access Yes Yes Yes
Microsoft Exchange Yes Yes Yes
IBM® Lotus® Domino® Yes Yes Yes
Microsoft MSN® Hotmail® (HTTP) Yes Yes Yes
CS2000 (AOL® software) Yes Yes Yes
POP3 Yes No N/A
IMAP4 Yes In some cases Yes
Wired Message Reconciliation
To turn on wired message reconciliation, you must have a BlackBerry Enterprise Server account or a BlackBerry® Desktop Redirector account.
BlackBerry® Desktop Manager
To reconcile messages between the inbox, deleted items, and personal folders on both the BlackBerry device and the email client, complete the following steps:
1. In BlackBerry Desktop Manager, open Intellisync®.
2. Click Configure reconciliation.
3. Select the Synchronize moves and deletes option.
4. Select the Mailbox wins or Device wins option.
5. If you use a personal folder, select the appropriate one in the Personal Folder drop-down list.
6. Click OK, and then click Synchronize now.
To turn on wireless message reconciliation, you must have a BlackBerry Enterprise Server account or a BlackBerry Internet Service account.
BlackBerry Enterprise Server
To reconcile messages between the inbox and deleted items folders on both the BlackBerry device and the email client, complete the following steps on the BlackBerry device:
1. Verify that you have a BlackBerry Enterprise Server account.
2. On the BlackBerry device Home screen, click Messages.
3. Open Options and select Email Reconciliation.
4. In the Delete On field, select Handheld, Mailbox & Handheld, or Prompt.
5. In the Wireless Reconcile field, select On.
6. In the On Conflicts field, select Handheld Wins or Mailbox Wins.
7. Save your changes.
BlackBerry Internet Service
BlackBerry Internet Service 2.0 supports one-way synchronization from the BlackBerry device to the source messaging and collaboration server, as shown below.
Source Wireless deletes Save Sent Items Wireless read/unread status
Microsoft® Outlook® Web Access Yes Yes Yes
Microsoft Exchange Yes Yes Yes
IBM® Lotus® Domino® Yes Yes Yes
Microsoft MSN® Hotmail® (HTTP) Yes Yes Yes
CS2000 (AOL® software) Yes Yes Yes
POP3 Yes No N/A
IMAP4 Yes In some cases Yes
Wired Message Reconciliation
To turn on wired message reconciliation, you must have a BlackBerry Enterprise Server account or a BlackBerry® Desktop Redirector account.
BlackBerry® Desktop Manager
To reconcile messages between the inbox, deleted items, and personal folders on both the BlackBerry device and the email client, complete the following steps:
1. In BlackBerry Desktop Manager, open Intellisync®.
2. Click Configure reconciliation.
3. Select the Synchronize moves and deletes option.
4. Select the Mailbox wins or Device wins option.
5. If you use a personal folder, select the appropriate one in the Personal Folder drop-down list.
6. Click OK, and then click Synchronize now.
Email messages are removed from the BlackBerry smartphone after restoring the Messages database
Problem
The BlackBerry smartphone user has been removed and then added to the BlackBerry Enterprise Server. After restoring the Messages database, the email messages are removed from the BlackBerry device.
Cause
After the Messages database has been restored and email reconciliation occurs, the State Database is accessed to verify the RefID of the email messages. The RefIDs cannot be found because a new State Database was created after removing and adding the BlackBerry smartphone user to the BlackBerry Enterprise Server and the email messages are removed from the BlackBerry smartphone.
Resolution
The BlackBerry smartphone user should not be removed from the BlackBerry Enterprise Server in order to maintain the consistency of the State Database.
The BlackBerry smartphone user has been removed and then added to the BlackBerry Enterprise Server. After restoring the Messages database, the email messages are removed from the BlackBerry device.
Cause
After the Messages database has been restored and email reconciliation occurs, the State Database is accessed to verify the RefID of the email messages. The RefIDs cannot be found because a new State Database was created after removing and adding the BlackBerry smartphone user to the BlackBerry Enterprise Server and the email messages are removed from the BlackBerry smartphone.
Resolution
The BlackBerry smartphone user should not be removed from the BlackBerry Enterprise Server in order to maintain the consistency of the State Database.
Wednesday, April 9, 2008
How to perform BlackBerry Manager pre-installation tasks on a remote computer for administration of the BlackBerry Enterprise Server in an IBM Lotus D
Procedure
Before installing BlackBerry Manager on a remote computer for administration of the BlackBerry Enterprise Server, complete the pre-installation tasks listed below.
Note: To determine the system requirements, see the BlackBerry Enterprise Server: Installation Guide and the BlackBerry Enterprise Server: Administration Guide.
Task 1
Verify that one of the following operating systems is installed on the remote computer:
Microsoft Windows® 2000 Service Pack 4
Microsoft Windows 2003 Service Pack 1 or later
Microsoft Windows XP Professional Service Pack 2 or later
Task 2
Verify that the following software is installed on the remote computer:
Note: To determine what software is installed, view the list in the Add or Remove Programs function of the Control Panel.
IBM Lotus Notes® 5.0 or later
Microsoft XML Parser 4.0 Service Pack 2 or later
Microsoft .NET Framework 1.1 Service Pack 1 or later
Note: For more information on the .NET framework, go to the MSDN Download Center.
Microsoft Data Access Components (MDAC) 2.8 Service Pack 1 or later
Note: MDAC is required on any computer where BlackBerry Manager is installed. For more information, see KB03412.
Task 3
Enable Named Pipes and TCP/IP network protocols for the remote MSDE or Microsoft SQL Server. For more information, see article KB04147.
Task 4
Verify that the Windows service account used for the installation has the following permissions:
System Administrator permission on the computer hosting the BlackBerry Enterprise Server.
System Administrator and Database Creator permissions on the Microsoft SQL Server.
Task 5
Enable printer and file sharing in Windows in order to enable the BlackBerry devices.
Additional Info
Use one of the following methods to verify access to the remote MSDE or Microsoft SQL Server that hosts the BlackBerry Configuration Database:
From a command prompt, type telnet 1433 and press ENTER. If a connection is established, a blinking cursor will appear at the top left corner of the screen.
From a command prompt, go to C:\, type the following commands in the specified order, and press ENTER after each line:
Note: The output should be identical to that shown below.
osql -E -S
1> use
2>
To test the Windows network level access, share a folder on the BlackBerry Enterprise Server, then try to access the UNC path \\ using Windows Explorer to determine if a server connection can be established.
Before installing BlackBerry Manager on a remote computer for administration of the BlackBerry Enterprise Server, complete the pre-installation tasks listed below.
Note: To determine the system requirements, see the BlackBerry Enterprise Server: Installation Guide and the BlackBerry Enterprise Server: Administration Guide.
Task 1
Verify that one of the following operating systems is installed on the remote computer:
Microsoft Windows® 2000 Service Pack 4
Microsoft Windows 2003 Service Pack 1 or later
Microsoft Windows XP Professional Service Pack 2 or later
Task 2
Verify that the following software is installed on the remote computer:
Note: To determine what software is installed, view the list in the Add or Remove Programs function of the Control Panel.
IBM Lotus Notes® 5.0 or later
Microsoft XML Parser 4.0 Service Pack 2 or later
Microsoft .NET Framework 1.1 Service Pack 1 or later
Note: For more information on the .NET framework, go to the MSDN Download Center.
Microsoft Data Access Components (MDAC) 2.8 Service Pack 1 or later
Note: MDAC is required on any computer where BlackBerry Manager is installed. For more information, see KB03412.
Task 3
Enable Named Pipes and TCP/IP network protocols for the remote MSDE or Microsoft SQL Server. For more information, see article KB04147.
Task 4
Verify that the Windows service account used for the installation has the following permissions:
System Administrator permission on the computer hosting the BlackBerry Enterprise Server.
System Administrator and Database Creator permissions on the Microsoft SQL Server.
Task 5
Enable printer and file sharing in Windows in order to enable the BlackBerry devices.
Additional Info
Use one of the following methods to verify access to the remote MSDE or Microsoft SQL Server that hosts the BlackBerry Configuration Database:
From a command prompt, type telnet
From a command prompt, go to C:\, type the following commands in the specified order, and press ENTER after each line:
Note: The output should be identical to that shown below.
osql -E -S
1> use
2>
To test the Windows network level access, share a folder on the BlackBerry Enterprise Server, then try to access the UNC path \\
Enable Folder Redirection with Inbox subfolders
Procedure
The Inbox and Sent Items folders are set to forward email messages to the BlackBerry device by default in BlackBerry Enterprise Server software version 4.0. However, only the Inbox is set to forward email messages to the BlackBerry device by default in BlackBerry Enterprise Server software version 3.6.
To set up the Inbox subfolders to receive redirected email messages, use the steps for the appropriate option from the following list. Folder redirection can be configured from BlackBerry Desktop Manager or from the BlackBerry device.
Note: The settings only apply to messages received after the Folder redirection changes have been saved.
Option 1: Set up from the BlackBerry device
To set folder redirection on the BlackBerry device, the BlackBerry Device Software must be version 4.0 or later.
1. From the Home screen, go to Messages.
2. Display the menu and select Options > Email Settings.
3. Display the menu and select Folder Redirection.
4. In the Folder Redirection menu, expand the Mailbox by highlighting it, displaying the menu and selecting Expand.
5. Under the Mailbox, expand the Inbox by highlighting it, displaying the menu and selecting Expand.
6. Highlight the folder for which you want to enable redirection. Display the menu and select Change Option.
Note: If you are unable to select Expand for any of the folders, or if the Change Option menu option is unavailable, try turning Wireless Reconcile on the BlackBerry device off and then on again. You can find Wireless Reconcile in Messages > Options > Email Reconciliation.
7. Display the menu and select Save to save your changes. New email messages that are filtered to the subfolder will now appear on the BlackBerry device in a subfolder of the same name. Existing email messages from the subfolder will not reconcile and synchronize to the BlackBerry device subfolder.
Option 2a: Set up from BlackBerry Desktop Manager 4.0 and 4.1
1. Open BlackBerry Desktop Manager and double-click Redirector Settings.
2. Select the Advanced tab. In the Folder redirection section, select the Selected folders option. Click the Choose Folders button (see the following image).
3. Expand the Inbox in the Choose Folders window.
4. Select the Inbox and any additional folders for which you want to enable redirection. Click OK to close the open windows.
Option 2b: Set up from BlackBerry Desktop Manager 4.2 or higher
1. Open BlackBerry Desktop Manager. Double-click Email Settings.
2. Select the Advanced tab. In the Folder redirection section, select the Selected folders option. Click the Choose Folders button.
3. Expand the Inbox in the Choose Folders window.
4. Select the Inbox and any additional folders for which you want to enable redirection. Click OK to close the open windows.
Option 3a: Set up from BlackBerry Enterprise Server software version 4.0
1. In BlackBerry Manager, right-click on a BlackBerry device user's name, then click Properties.
2. Select the Redirection tab.
3. Select the Selected Folders option, then click Choose Folders.
4. Expand the Inbox in the Choose Folders window.
5. Select the Inbox and any additional folders for which you want to enable redirection.
6. Click OK to close the Choose Folders window.
7. Click OK again.
Option 3b: Set up from BlackBerry Enterprise Server software version 4.1
1. In BlackBerry Manager, click on a BlackBerry device user's name, then expand Service Access in the bottom pane.
2. Click Choose Folders for Redirection.
3. Place a check mark by the appropriate folders for which you want to enable redirection.
4. Click OK.
The Inbox and Sent Items folders are set to forward email messages to the BlackBerry device by default in BlackBerry Enterprise Server software version 4.0. However, only the Inbox is set to forward email messages to the BlackBerry device by default in BlackBerry Enterprise Server software version 3.6.
To set up the Inbox subfolders to receive redirected email messages, use the steps for the appropriate option from the following list. Folder redirection can be configured from BlackBerry Desktop Manager or from the BlackBerry device.
Note: The settings only apply to messages received after the Folder redirection changes have been saved.
Option 1: Set up from the BlackBerry device
To set folder redirection on the BlackBerry device, the BlackBerry Device Software must be version 4.0 or later.
1. From the Home screen, go to Messages.
2. Display the menu and select Options > Email Settings.
3. Display the menu and select Folder Redirection.
4. In the Folder Redirection menu, expand the Mailbox by highlighting it, displaying the menu and selecting Expand.
5. Under the Mailbox, expand the Inbox by highlighting it, displaying the menu and selecting Expand.
6. Highlight the folder for which you want to enable redirection. Display the menu and select Change Option.
Note: If you are unable to select Expand for any of the folders, or if the Change Option menu option is unavailable, try turning Wireless Reconcile on the BlackBerry device off and then on again. You can find Wireless Reconcile in Messages > Options > Email Reconciliation.
7. Display the menu and select Save to save your changes. New email messages that are filtered to the subfolder will now appear on the BlackBerry device in a subfolder of the same name. Existing email messages from the subfolder will not reconcile and synchronize to the BlackBerry device subfolder.
Option 2a: Set up from BlackBerry Desktop Manager 4.0 and 4.1
1. Open BlackBerry Desktop Manager and double-click Redirector Settings.
2. Select the Advanced tab. In the Folder redirection section, select the Selected folders option. Click the Choose Folders button (see the following image).
3. Expand the Inbox in the Choose Folders window.
4. Select the Inbox and any additional folders for which you want to enable redirection. Click OK to close the open windows.
Option 2b: Set up from BlackBerry Desktop Manager 4.2 or higher
1. Open BlackBerry Desktop Manager. Double-click Email Settings.
2. Select the Advanced tab. In the Folder redirection section, select the Selected folders option. Click the Choose Folders button.
3. Expand the Inbox in the Choose Folders window.
4. Select the Inbox and any additional folders for which you want to enable redirection. Click OK to close the open windows.
Option 3a: Set up from BlackBerry Enterprise Server software version 4.0
1. In BlackBerry Manager, right-click on a BlackBerry device user's name, then click Properties.
2. Select the Redirection tab.
3. Select the Selected Folders option, then click Choose Folders.
4. Expand the Inbox in the Choose Folders window.
5. Select the Inbox and any additional folders for which you want to enable redirection.
6. Click OK to close the Choose Folders window.
7. Click OK again.
Option 3b: Set up from BlackBerry Enterprise Server software version 4.1
1. In BlackBerry Manager, click on a BlackBerry device user's name, then expand Service Access in the bottom pane.
2. Click Choose Folders for Redirection.
3. Place a check mark by the appropriate folders for which you want to enable redirection.
4. Click OK.
Send an SMS message to multiple contacts
Procedure
For BlackBerry Device Software 4.1 and earlier:
1. Compose an SMS message by opening the Messages folder, clicking the trackwheel, and selecting Compose SMS.
2. Select a recipient from the list and click the trackwheel.
3. Click the trackwheel again and select Add Recipient.
4. Select a recipient from the list and click the trackwheel.
For BlackBerry Device Software 4.2 and later:
1. Create a group on the BlackBerry device by opening the Address Book, clicking the trackwheel, and selecting New Group.
2. Add the necessary contacts to the group by clicking the trackwheel and selecting Add Member.
3. Save the group by clicking the trackwheel and selecting Save Group.
4. Compose an SMS message by opening the Messages folder, clicking the trackwheel, and selecting the created group.
For BlackBerry Device Software 4.1 and earlier:
1. Compose an SMS message by opening the Messages folder, clicking the trackwheel, and selecting Compose SMS.
2. Select a recipient from the list and click the trackwheel.
3. Click the trackwheel again and select Add Recipient.
4. Select a recipient from the list and click the trackwheel.
For BlackBerry Device Software 4.2 and later:
1. Create a group on the BlackBerry device by opening the Address Book, clicking the trackwheel, and selecting New Group.
2. Add the necessary contacts to the group by clicking the trackwheel and selecting Add Member.
3. Save the group by clicking the trackwheel and selecting Save Group.
4. Compose an SMS message by opening the Messages folder, clicking the trackwheel, and selecting the created group.
How to prepare the BlackBerry Enterprise Server for IBM Lotus Domino to support DST changes in 2008
Procedure
Daylight Saving Time (DST) will change for the following time zones:
Country Time Zone DST Start DST End
Adelaide
Canberra, Sydney
Australia Hobart 1st Sunday in October at 2:00 AM 1st Sunday in April at 3:00 AM
Brazil
- States of Mato Grosso do Sul and Mato Grosso only Manaus 2nd Sunday in October at 12:00 AM 3rd Sunday of February at 12:00 AM
Israel no change 1st Sunday of October at 2:00 AM
Argentina Buenos_Aires 1st Sunday in October at 1:00 AM 3rd Sunday in March at 12:00 AM
Note: Guyana's time zone of Buenos_Aires has been renamed Georgetown.
Complete the following to support the DST 2008 changes to the BlackBerry Enterprise Server for IBM Lotus Domino.
BlackBerry Enterprise Server for IBM Lotus Domino
1. To support the time zone changes, the Windows® operating system needs to have a time zone update applied. If the Windows time zone update is not applied, the TimeZoneUpdate20080207.zip script will not function as intended. For more information, search for article 942763 on the Microsoft Support web site.
2. Review the documention for your time zone by searching the IBM Lotus Domino Support web site for your time zone.
3. If you are running BlackBerry Enterprise Server software version 4.0 and later, upgrade to BlackBerry Enterprise Server software version 4.0 Service Pack 7 Maintenance Release 1.
OR
If you are running BlackBerry Enterprise Server software version 4.1 and later, upgrade to BlackBerry Enterprise Server software version 4.1 Service Pack 4 and later.
4. Download and run the attached script, TimeZoneUpdate20080207.zip, on the BlackBerry Enterprise Server. For instructions, see the Additional Info section in this document.
BlackBerry smartphones
Warning: If you apply the DST 2008 time zone change below to a BlackBerry smartphone that is already patched, or activate a new BlackBerry smartphone with the correct DST values against a BlackBerry Enterprise Server that does not have the newest time zone table, the BlackBerry Enterprise Server will override the values on the BlackBerry smartphone.
The 4.1MR4+_Patch.zip and 4.2+_Patch.zip patches resolve the DST 2008 issue if you are running one of the following BlackBerry® Device Software versions:
BlackBerry Device Software 4.1.0.344 through 4.1.0.365, (except for BlackBerry Device Software 4.1.0.347)
BlackBerry Device Software 4.1.0.379 through 4.1.0.381
BlackBerry Device Software 4.1.0.383 through 4.1.0.385
For BlackBerry smartphones running BlackBerry Device Software 4.1.0, download the 4.1MR4+_Patch.zip. There are two ways to download the patch:
For administrators, or for installing the patch using the Application Loader in BlackBerry® Desktop Manager, to download the 4.1MR4+_Patch.zip, click here. For instructions on installing the patch using the application loader tool, see KB15172.
To download the patch wirelessly from a BlackBerry smartphone, click here.
For BlackBerry smartphones running BlackBerry Device Software 4.2 or later, download the 4.2+_Patch.zip. There are two ways to download the patch:
For administrators or for installing the patch using the Application Loader in BlackBerry Desktop Manager, to download the 4.2+_Patch.zip, click here. For instructions on installing the patch using the Application Loader, see KB15172.
To download the patch wirelessly from a BlackBerry smartphone, click here.
The patch can also be deployed to BlackBerry smartphones from the BlackBerry Enterprise Server. see KB03748 for detailed instructions on preparing a software configuration for wireless deployment.
Additional Info
Running the Script against the BlackBerry Configuration Database
When running the LoadSyncDeviceConfig.sql script (located in the attached TimeZoneUpdate20080207.zip), you can customize how the LoadSyncDeviceConfig.sql script is executed by using various switches. The following tables list the required and optional switches to run the LoadSyncDeviceConfig.sql script.
Required Switches
Switches Description
-db Use this switch to specify the BlackBerry Configuration Database name. The default name is BESMgmt.
-n Use this switch to specify the location of the Microsoft® SQL Server™ or IBM® DB2® Universal Database.
-input Specifies which LoadSyncDeviceConfig.sql script to run. The BlackBerry Configuration Database is compatible with both Microsoft SQL Server and IBM DB2 Universal Database. The attached TimeZoneUpdate20080207.zip contains two scripts, one for Microsoft SQL Server and one for IBM DB2 Universal Database.
Optional Switches
Switches Description
-dbms Use this switch to specify if you are using a Microsoft SQL Server or IBM DB2 Universal Database to host the BlackBerry Configuration Database. The default option is SQL.
-dbauth Use this switch to enable IBM DB2 Universal Database or Microsoft SQL Server authentication. If this switch is not used, Windows authentication is used.
-dbuser Use this switch to specify the user name to be used with the IBM DB2 Universal Database or Microsoft SQL Server authentication. This switch is required if the -dbauth switch is used.
-dbpass Use this switch to specify the password to be used with the IBM DB2 Universal Database or Microsoft SQL Server authentication. This switch is required if the -dbauth switch is used.
Running the TimeZoneUpdate20080207.zip Update
Warning: Modifying databases used by the BlackBerry Enterprise Server can cause irreparable damage, resulting in unexpected server behavior or service failure. Back up the databases prior to implementing any changes.
1. Download the attached TimeZoneUpdate20080207.zip and extract it on the BlackBerry Enterprise Server.
Important: Do not modify the file structure if the TimeZoneUpdate20080207.zip.
2. On the BlackBerry Enterprise Server, open a command prompt and navigate into the root folder where the LoadSyncDeviceConfig.sql script is contained. Enter the appropriate command for your environment. The following is a example command if you are using a default database name and a remote Microsoft SQL Server:
BBDBUpdate.exe –db BESMgmt -n SQL.domain.com -input .\SQLServer\LoadSyncDeviceConfig.sql
The full command syntax is as follows:
BBDBUpdate.exe –db -dbms -n -dbauth –dbuser -dbpass -input <.\SQLServer\LoadSyncDeviceConfig.sql|.\DS2\LoadSyncDeviceConfig.sql>
Variable Description
Database Name The name of the BlackBerry Configuration Database
SQL
OR
DB2 SQL, if you are running a Microsoft SQL Server in your environment
DB2, if you are running IBM DB2 Universal Database in your environment
SQL Server Name
OR
Schema Name Microsoft SQL Server name, if you are using Microsoft SQL Server
Schema name, if you are using IBM DB2 Universal Database
User Name Appropriate user name for Microsoft SQL Server or IBM DB2 Universal Database authentication
Password Appropriate password for Microsoft SQL Server or IBM DB2 Universal Database authentication
.\SQLServer\LoadSyncDeviceConfig.sql
OR
.\DB2\LoadSyncDeviceConfig.sql The location of the LoadSyncDeviceConfig.sql script, if you are using Microsoft SQL Server
The location of the LoadSyncDeviceConfig.sql script, if you are using IBM DB2 Universal Database
Daylight Saving Time (DST) will change for the following time zones:
Country Time Zone DST Start DST End
Adelaide
Canberra, Sydney
Australia Hobart 1st Sunday in October at 2:00 AM 1st Sunday in April at 3:00 AM
Brazil
- States of Mato Grosso do Sul and Mato Grosso only Manaus 2nd Sunday in October at 12:00 AM 3rd Sunday of February at 12:00 AM
Israel no change 1st Sunday of October at 2:00 AM
Argentina Buenos_Aires 1st Sunday in October at 1:00 AM 3rd Sunday in March at 12:00 AM
Note: Guyana's time zone of Buenos_Aires has been renamed Georgetown.
Complete the following to support the DST 2008 changes to the BlackBerry Enterprise Server for IBM Lotus Domino.
BlackBerry Enterprise Server for IBM Lotus Domino
1. To support the time zone changes, the Windows® operating system needs to have a time zone update applied. If the Windows time zone update is not applied, the TimeZoneUpdate20080207.zip script will not function as intended. For more information, search for article 942763 on the Microsoft Support web site.
2. Review the documention for your time zone by searching the IBM Lotus Domino Support web site for your time zone.
3. If you are running BlackBerry Enterprise Server software version 4.0 and later, upgrade to BlackBerry Enterprise Server software version 4.0 Service Pack 7 Maintenance Release 1.
OR
If you are running BlackBerry Enterprise Server software version 4.1 and later, upgrade to BlackBerry Enterprise Server software version 4.1 Service Pack 4 and later.
4. Download and run the attached script, TimeZoneUpdate20080207.zip, on the BlackBerry Enterprise Server. For instructions, see the Additional Info section in this document.
BlackBerry smartphones
Warning: If you apply the DST 2008 time zone change below to a BlackBerry smartphone that is already patched, or activate a new BlackBerry smartphone with the correct DST values against a BlackBerry Enterprise Server that does not have the newest time zone table, the BlackBerry Enterprise Server will override the values on the BlackBerry smartphone.
The 4.1MR4+_Patch.zip and 4.2+_Patch.zip patches resolve the DST 2008 issue if you are running one of the following BlackBerry® Device Software versions:
BlackBerry Device Software 4.1.0.344 through 4.1.0.365, (except for BlackBerry Device Software 4.1.0.347)
BlackBerry Device Software 4.1.0.379 through 4.1.0.381
BlackBerry Device Software 4.1.0.383 through 4.1.0.385
For BlackBerry smartphones running BlackBerry Device Software 4.1.0, download the 4.1MR4+_Patch.zip. There are two ways to download the patch:
For administrators, or for installing the patch using the Application Loader in BlackBerry® Desktop Manager, to download the 4.1MR4+_Patch.zip, click here. For instructions on installing the patch using the application loader tool, see KB15172.
To download the patch wirelessly from a BlackBerry smartphone, click here.
For BlackBerry smartphones running BlackBerry Device Software 4.2 or later, download the 4.2+_Patch.zip. There are two ways to download the patch:
For administrators or for installing the patch using the Application Loader in BlackBerry Desktop Manager, to download the 4.2+_Patch.zip, click here. For instructions on installing the patch using the Application Loader, see KB15172.
To download the patch wirelessly from a BlackBerry smartphone, click here.
The patch can also be deployed to BlackBerry smartphones from the BlackBerry Enterprise Server. see KB03748 for detailed instructions on preparing a software configuration for wireless deployment.
Additional Info
Running the Script against the BlackBerry Configuration Database
When running the LoadSyncDeviceConfig.sql script (located in the attached TimeZoneUpdate20080207.zip), you can customize how the LoadSyncDeviceConfig.sql script is executed by using various switches. The following tables list the required and optional switches to run the LoadSyncDeviceConfig.sql script.
Required Switches
Switches Description
-db Use this switch to specify the BlackBerry Configuration Database name. The default name is BESMgmt.
-n Use this switch to specify the location of the Microsoft® SQL Server™ or IBM® DB2® Universal Database.
-input Specifies which LoadSyncDeviceConfig.sql script to run. The BlackBerry Configuration Database is compatible with both Microsoft SQL Server and IBM DB2 Universal Database. The attached TimeZoneUpdate20080207.zip contains two scripts, one for Microsoft SQL Server and one for IBM DB2 Universal Database.
Optional Switches
Switches Description
-dbms Use this switch to specify if you are using a Microsoft SQL Server or IBM DB2 Universal Database to host the BlackBerry Configuration Database. The default option is SQL.
-dbauth Use this switch to enable IBM DB2 Universal Database or Microsoft SQL Server authentication. If this switch is not used, Windows authentication is used.
-dbuser Use this switch to specify the user name to be used with the IBM DB2 Universal Database or Microsoft SQL Server authentication. This switch is required if the -dbauth switch is used.
-dbpass Use this switch to specify the password to be used with the IBM DB2 Universal Database or Microsoft SQL Server authentication. This switch is required if the -dbauth switch is used.
Running the TimeZoneUpdate20080207.zip Update
Warning: Modifying databases used by the BlackBerry Enterprise Server can cause irreparable damage, resulting in unexpected server behavior or service failure. Back up the databases prior to implementing any changes.
1. Download the attached TimeZoneUpdate20080207.zip and extract it on the BlackBerry Enterprise Server.
Important: Do not modify the file structure if the TimeZoneUpdate20080207.zip.
2. On the BlackBerry Enterprise Server, open a command prompt and navigate into the root folder where the LoadSyncDeviceConfig.sql script is contained. Enter the appropriate command for your environment. The following is a example command if you are using a default database name and a remote Microsoft SQL Server:
BBDBUpdate.exe –db BESMgmt -n SQL.domain.com -input .\SQLServer\LoadSyncDeviceConfig.sql
The full command syntax is as follows:
BBDBUpdate.exe –db
Variable Description
Database Name The name of the BlackBerry Configuration Database
SQL
OR
DB2 SQL, if you are running a Microsoft SQL Server in your environment
DB2, if you are running IBM DB2 Universal Database in your environment
SQL Server Name
OR
Schema Name Microsoft SQL Server name, if you are using Microsoft SQL Server
Schema name, if you are using IBM DB2 Universal Database
User Name Appropriate user name for Microsoft SQL Server or IBM DB2 Universal Database authentication
Password Appropriate password for Microsoft SQL Server or IBM DB2 Universal Database authentication
.\SQLServer\LoadSyncDeviceConfig.sql
OR
.\DB2\LoadSyncDeviceConfig.sql The location of the LoadSyncDeviceConfig.sql script, if you are using Microsoft SQL Server
The location of the LoadSyncDeviceConfig.sql script, if you are using IBM DB2 Universal Database
How to wirelessly deploy third-party applications to BlackBerry smartphones
Procedure
The following procedure outlines the tasks needed for the wireless deployment of third-party applications to BlackBerry smartphones.
Task 1 - Create and share the application folder
1. From the BlackBerry Enterprise Server, go to:\Program Files\Common Files\Research In Motion.
2. Right-click the Research In Motion folder and select Properties.
3. Select the Sharing tab.
4. Select the Share this folder option.
5. Click Permissions.
6. Clear all the selections except Allow for Read, and then close the Permissions window.
Note: If you do not want to share a directory on the BlackBerry Enterprise Server, you can install the latest BlackBerry Device Software on a workstation and then share the:\Program Files\Common Files\Research In Motion folder here.
Task 2 - Index the third-party application
1. On the host computer, go to C:\Program Files\Common Files\Research In Motion and create a folder called Shared.
2. In the Shared folder, create an Applications folder.
3. In the Applications folder, create a folder for the third-party application you want to deploy to the BlackBerry smartphone users.
4. Copy the third-party application files (such as ALX and COD files) into the folder you created in the prior step.
5. From a command prompt, go to:\Program Files\Common Files\Research in Motion\Apploader.
6. Run the command loader /index.
7. Go to the Applications\ folder created in step 2 and confirm that the pkgdbcache.xml and specification.pkg files exist.
When indexing the files, it is important that you maintain correct directory structure as expected by the ALX file. Here is an excerpt from an ALX file for Cognos® 8 Go! Mobile software:
Cognos 8 Go! Mobile (Name as it will appear in software configuration)
4.0.2
The above directory structure indicates that Cognos software for BlackBerry Device Software versions 4.02 and 4.1.0 is located in the 4.0.2 directory.
On running loader/index, the loader.exe utility will go to folder structure ..\shared\applications\cognos client\ and look for COD files under the 4.0.2 folder. If this folder is not found, application software in software configuration will not include the Cognos software.
Cognos application software was being extracted to ..\shared\applications\Cognos client\Client\rim\4.0.2. If you want the software configuration to work, the COD files should be extracted in ..\shared\applications\Cognos client\4.0.2.
-or-
Modify the ALX file to change the directory path to something like the following:
client/rim/4.0.2
If the tags do not exist in the ALX file, the COD files can be extracted to any folder under :\program files\common files\research in motion\shared\applications.
Task 3 - Create a Software Configuration
1. For BlackBerry Enterprise Server software version 4.0, launch BlackBerry Handheld Configuration Tool. For BlackBerry Enterprise Server software version 4.1, launch BlackBerry Manager and select BlackBerry Domain on the left.
2. Select the Software Configurations (or Configurations) tab.
3. Click Add New Configuration.
4. Type a name for the software configuration.
5. Click the Change button next to Device Software Location.
6. Type \\\Research in Motion. The BlackBerry Device Software and the Applications folder should appear in the list.
7. Change the Delivery field to wireless instead of wireless only for the software package to be pushed out wirelessly.
Task 4 - Create or Assign an Application Control Policy
In the Software Configurations window, with the application highlighted, select the Application Control Policy to be assigned to the third-party software from the Policy drop-down list.
-or-
Create a new Application Control Policy by completing the following steps:
1. Select the Software Configurations (or Configurations) tab.
2. Click Manage Application Policies.
3. Click New and type a name for the policy in the Name field.
4. Select the Disposition field and specify the setting Required.
5. Click OK, and then OK again.
6. Back in the Software Configurations (or Configurations) tab, select the application.
7. Select the Application Control Policy from the Policy drop-down list.
Task 5 - Assign the Software Configuration to a BlackBerry smartphone user/group
For BlackBerry Enterprise Server software version 4.0, complete the following:
1. Select the Handhelds tab.
2. Select the BlackBerry smartphone user.
3. Click Assign Software Configuration and select the software configuration from the list.
For BlackBerry Enterprise Server software version 4.1, complete the following:
1. In the left-pane, select BlackBerry Domain.
2. Select the All Users or User Groups List tab.
3. Select a BlackBerry smartphone user or group from the list. (Note: BlackBerry smartphone users can also be selected from the BlackBerry Enterprise Server Users tab).
4. In the Tasks pane, expand Device Management.
5. Select Assign Software Configuration.
6. Select the software configuration from the list.
Note: The application will be wirelessly pushed to BlackBerry smartphone within four hours.
The following procedure outlines the tasks needed for the wireless deployment of third-party applications to BlackBerry smartphones.
Task 1 - Create and share the application folder
1. From the BlackBerry Enterprise Server, go to
2. Right-click the Research In Motion folder and select Properties.
3. Select the Sharing tab.
4. Select the Share this folder option.
5. Click Permissions.
6. Clear all the selections except Allow for Read, and then close the Permissions window.
Note: If you do not want to share a directory on the BlackBerry Enterprise Server, you can install the latest BlackBerry Device Software on a workstation and then share the
Task 2 - Index the third-party application
1. On the host computer, go to C:\Program Files\Common Files\Research In Motion and create a folder called Shared.
2. In the Shared folder, create an Applications folder.
3. In the Applications folder, create a folder for the third-party application you want to deploy to the BlackBerry smartphone users.
4. Copy the third-party application files (such as ALX and COD files) into the folder you created in the prior step.
5. From a command prompt, go to
6. Run the command loader /index.
7. Go to the Applications\
When indexing the files, it is important that you maintain correct directory structure as expected by the ALX file. Here is an excerpt from an ALX file for Cognos® 8 Go! Mobile software:
The above directory structure indicates that Cognos software for BlackBerry Device Software versions 4.02 and 4.1.0 is located in the 4.0.2 directory.
On running loader/index, the loader.exe utility will go to folder structure ..\shared\applications\cognos client\ and look for COD files under the 4.0.2 folder. If this folder is not found, application software in software configuration will not include the Cognos software.
Cognos application software was being extracted to ..\shared\applications\Cognos client\Client\rim\4.0.2. If you want the software configuration to work, the COD files should be extracted in ..\shared\applications\Cognos client\4.0.2.
-or-
Modify the ALX file to change the directory path to something like the following:
If the
Task 3 - Create a Software Configuration
1. For BlackBerry Enterprise Server software version 4.0, launch BlackBerry Handheld Configuration Tool. For BlackBerry Enterprise Server software version 4.1, launch BlackBerry Manager and select BlackBerry Domain on the left.
2. Select the Software Configurations (or Configurations) tab.
3. Click Add New Configuration.
4. Type a name for the software configuration.
5. Click the Change button next to Device Software Location.
6. Type \\
7. Change the Delivery field to wireless instead of wireless only for the software package to be pushed out wirelessly.
Task 4 - Create or Assign an Application Control Policy
In the Software Configurations window, with the application highlighted, select the Application Control Policy to be assigned to the third-party software from the Policy drop-down list.
-or-
Create a new Application Control Policy by completing the following steps:
1. Select the Software Configurations (or Configurations) tab.
2. Click Manage Application Policies.
3. Click New and type a name for the policy in the Name field.
4. Select the Disposition field and specify the setting Required.
5. Click OK, and then OK again.
6. Back in the Software Configurations (or Configurations) tab, select the application.
7. Select the Application Control Policy from the Policy drop-down list.
Task 5 - Assign the Software Configuration to a BlackBerry smartphone user/group
For BlackBerry Enterprise Server software version 4.0, complete the following:
1. Select the Handhelds tab.
2. Select the BlackBerry smartphone user.
3. Click Assign Software Configuration and select the software configuration from the list.
For BlackBerry Enterprise Server software version 4.1, complete the following:
1. In the left-pane, select BlackBerry Domain.
2. Select the All Users or User Groups List tab.
3. Select a BlackBerry smartphone user or group from the list. (Note: BlackBerry smartphone users can also be selected from the BlackBerry Enterprise Server Users tab).
4. In the Tasks pane, expand Device Management.
5. Select Assign Software Configuration.
6. Select the software configuration from the list.
Note: The application will be wirelessly pushed to BlackBerry smartphone within four hours.
Subscribe to:
Posts (Atom)