BlackBerry Enterprise Server 4.1 for MDS Applications, 5u

BlackBerry Enterprise Server for MDS Applications
Version: 4.1 | Service Pack: 7
Upgrade Guide
Published: 2009-11-30
SWD-967831-1130114457-001
Contents
1
Choosing a BlackBerry Enterprise Server upgrade option....................................................................................................
Upgrading the BlackBerry Enterprise Server software by overwriting the existing version..................................................
Upgrading the BlackBerry Enterprise Server by using a new computer..................................................................................
Verify the BlackBerry Enterprise Server version from which you are upgrading....................................................................
4
4
4
5
2 System requirements..................................................................................................................................................................
System requirements: BlackBerry Enterprise Server..................................................................................................................
System requirements: BlackBerry Attachment Service..............................................................................................................
System requirements: BlackBerry Manager................................................................................................................................
System requirements: BlackBerry MDS Connection Service.....................................................................................................
System requirements: BlackBerry MDS Integration Service......................................................................................................
System requirements: BlackBerry Router.....................................................................................................................................
System requirements for optional environments and features.................................................................................................
Unsupported environments...........................................................................................................................................................
6
6
7
8
8
9
9
10
10
3 Setting up the database connection........................................................................................................................................
Specifying permissions when connecting to the BlackBerry Configuration Database using Microsoft Windows
authentication.................................................................................................................................................................................
Specifying MSDE 2000 permissions for the Microsoft Windows account......................................................................
Assign Microsoft SQL Server permissions to the Windows account................................................................................
Configuring authentication to the BlackBerry MDS Integration Service database................................................................
11
11
11
11
12
4 Upgrading the BlackBerry Enterprise Server software by overwriting the existing version...........................................
Upgrade the BlackBerry Enterprise Server software..................................................................................................................
Improve the startup performance of the BlackBerry Enterprise Server...................................................................................
13
13
14
5 Upgrading the BlackBerry Enterprise Server by using a new computer............................................................................
Prerequisites: Upgrading the BlackBerry Enterprise Server software......................................................................................
Install BlackBerry Enterprise Server version 4.1 SP7 on the new computer............................................................................
Move user accounts to the new BlackBerry Enterprise Server..................................................................................................
BESMigration tool parameters..............................................................................................................................................
Prevent the old BlackBerry Enterprise Server from connecting to the BlackBerry Infrastructure........................................
Improve the startup performance of the BlackBerry Enterprise Server...................................................................................
Start the new BlackBerry Enterprise Server.................................................................................................................................
15
15
16
16
17
17
18
18
6 Troubleshooting the BlackBerry Enterprise Server upgrade process..................................................................................
A third-party tool did not install and the BlackBerry Enterprise Server setup application closed........................................
Previous version detected but no database available................................................................................................................
You cannot resolve errors that occur when you move users......................................................................................................
You encounter errors when you try to upgrade the BlackBerry Configuration Database......................................................
The setup application prompts you for access to the installation media for Microsoft .NET Framework version 1.1..........
Restore a BlackBerry Configuration Database............................................................................................................................
19
19
19
19
20
20
20
7 Upgrading the BlackBerry Device Software............................................................................................................................
Permitting users to upgrade the BlackBerry Device Software at their computers.................................................................
Upgrading the BlackBerry Device Software at a central computer..........................................................................................
Pushing the BlackBerry Device Software and the BlackBerry Desktop Software to users' computers................................
21
21
21
22
8 Permitting users to upgrade the BlackBerry Device Software at their computers...........................................................
Configure a network drive..............................................................................................................................................................
Save the BlackBerry Device Software installation files to the network drive..........................................................................
Verify the version of the application loader tool.........................................................................................................................
Sending the BlackBerry Desktop Software or BlackBerry Device Manager installation files to users' computers.............
Send the BlackBerry Device Manager installation file to users' computers....................................................................
Send the BlackBerry Desktop Software installation file to users' computers.................................................................
Synchronizing wireless data automatically..................................................................................................................................
Create the BlackBerry Device Software upgrade instructions for BlackBerry device users...................................................
Confirming that the BlackBerry Device Software upgrade process completed successfully................................................
Verify that the upgrade from BlackBerry Device Software Version 4.0 or later completed successfully....................
..................................................................................................................................................................................................
23
23
23
24
24
24
25
25
25
25
25
26
9 Upgrading the BlackBerry Device Software at a central computer....................................................................................
Configure a network drive..............................................................................................................................................................
Save the BlackBerry Device Software installation files to the network drive..........................................................................
Create a software configuration for the BlackBerry Device Software......................................................................................
Assign the software configuration to a user................................................................................................................................
Upgrade the BlackBerry Device Software at a central computer.............................................................................................
Verify that the BlackBerry Device Software upgrade at a central computer completed successfully..................................
27
27
27
28
28
28
29
10 Pushing the BlackBerry Device Software and the BlackBerry Desktop Software to users' computers.........................
Configure a network drive..............................................................................................................................................................
30
30
Install the BlackBerry Device Software on the network drive...................................................................................................
Save the BlackBerry Desktop Software installation file to the network drive.........................................................................
Synchronizing wireless data automatically..................................................................................................................................
Send the installation files for the BlackBerry Desktop Software and the BlackBerry Device Software to users using a
third-party application...................................................................................................................................................................
Confirming that the BlackBerry Device Software upgrade process completed successfully................................................
Verify that the upgrade from BlackBerry Device Software Version 4.0 or later completed successfully....................
..................................................................................................................................................................................................
30
31
31
11 Troubleshooting...........................................................................................................................................................................
When users click the link to the application loader tool in the upgrade instructions, the upgrade process does not start
...........................................................................................................................................................................................................
33
12 Glossary.........................................................................................................................................................................................
34
13 Legal notice..................................................................................................................................................................................
36
31
32
32
32
33
Choosing a BlackBerry Enterprise Server upgrade option
Upgrade Guide
Choosing a BlackBerry Enterprise Server upgrade option
1
Upgrading the BlackBerry Enterprise Server software by overwriting the
existing version
The in-place upgrade process upgrades the BlackBerry® Enterprise Server software by replacing the existing version of the
software.
Advantages
•
•
Disadvantages
You do not require additional computers to perform this •
upgrade.
When the upgrade process completes, user accounts are
active, and no additional administrative action is
•
required.
You cannot remove the BlackBerry Enterprise Server and
return to the earlier version of the software
automatically.
You must turn off the BlackBerry Enterprise Server during
the upgrade process, so the interruption to services for
BlackBerry devices lasts as long as it takes the upgrade
process to complete.
When you use the in-place upgrade process, the following events occur:
•
BlackBerry devices that are running BlackBerry® Device Software Version 4.0 or later receive new service books, and wireless
data synchronization occurs.
•
All BlackBerry devices receive new IT policies.
Upgrading the BlackBerry Enterprise Server by using a new computer
The cutover upgrade process installs the BlackBerry® Enterprise Server on a new computer and moves user accounts and server
information from the old BlackBerry Enterprise Server to the new one.
Advantages
•
•
4
Disadvantages
You can move user accounts back to the old BlackBerry •
Enterprise Server if you encounter any problems with the
new one.
You can use new server hardware and start with a clean
environment.
You require one extra computer.
Upgrade Guide
Advantages
•
Verify the BlackBerry Enterprise Server version from which you are upgrading
Disadvantages
Users experience minimal service interruptions because •
user accounts remain active on the old BlackBerry
Enterprise Server until you start the new one.
If you upgrade from a version earlier than BlackBerry
Enterprise Server Version 4.0, the BlackBerry Enterprise
Server takes longer to start than it did previously because
it sends new service books to all of the BlackBerry devices
that are capable of wireless data synchronization.
This upgrade process uses the same SRP credentials on both the old and the new BlackBerry Enterprise Server instances.
When you use the cutover process, the following events occur:
•
•
BlackBerry devices that are running BlackBerry® Device Software Version 4.0 or later receive new service books, and wireless
data synchronization occurs.
All BlackBerry devices receive new IT policies.
Verify the BlackBerry Enterprise Server version from which you are upgrading
Perform this task to verify the version that you are upgrading from so that you can choose a supported upgrade process.
1.
2.
3.
4.
On the taskbar, click Start > Settings > Control Panel.
Double-click Add/Remove Programs.
Click BlackBerry Enterprise Server.
Click Support Information.
5
System requirements
Upgrade Guide
System requirements
2
For information about calculating hardware requirements, visit www.blackberry.com/go/serverdocs to see the BlackBerry
Enterprise Server Capacity Calculator and BlackBerry Enterprise Server Performance Benchmarking Guide.
System requirements: BlackBerry Enterprise Server
6
Item
Requirement
operating system
Any of the following operating systems:
•
Windows® 2000 SP4 Server or Advanced Server
•
Windows Server® 2003 or later
•
Windows Server 2003 or later (64-bit)
•
Windows Server 2003 R2 SP2
•
Windows Server 2003 R2 SP2 (64-bit)
IMAP transactions
A messaging server with the following conditions:
•
can run an IMAP service
•
can send and receive IMAP transactions (by default, over port 143)
database management system
Any of the following database management systems:
•
MSDE 2000 SP3
•
Microsoft® SQL Server® 2000 SP4
•
Microsoft SQL Server 2005 SP3
•
Microsoft SQL Server 2005 Express SP3
•
Microsoft SQL Server 2005 SP3 (64-bit)
collation setting
For all versions of the Microsoft SQL Server that are earlier than Microsoft SQL
Server 2005 SP3, visit http://technet.microsoft.com to read KB960082 and
Microsoft Security Bulletin MS09-004.
To support Microsoft SQL Server, the following conditions on the database server:
•
collation setting is default case-insensitive
•
BlackBerry Configuration Database collation setting is default caseinsensitive
remote database conditions
named pipes and TCP/IP network protocols turned on
System requirements: BlackBerry Attachment Service
Upgrade Guide
Item
Requirement
data access components
Any of the following data access components on the computers that host the
BlackBerry Enterprise Server or the BlackBerry Configuration Database:
•
MDAC version 2.8 with Security Patch MS04-003 (version 2000.85.1025.00)
•
MDAC version 2.8.2 (version 2000.86.1830.00), included with Windows
Server 2003 SP1
database conditions for the BlackBerry
MDS Integration Service
A database server with the following conditions:
•
host for the BlackBerry Configuration Database
•
support for mixed-mode authentication
Microsoft® .NET Framework
to support languages other than English, localized version of Microsoft .NET
Framework version 1.1 SP1
A firewall or proxy firewall with the following conditions:
•
support for the BlackBerry Enterprise Server to initiate an outgoing, two-way
TCP/IP connection to an external server on port 3101
•
support for the resolution of Internet addresses using DNS
•
transparency of the proxy server for proxy firewalls
firewall
System requirements: BlackBerry Attachment Service
The following system requirements apply when installing the BlackBerry® Attachment Service on a computer separate from the
BlackBerry® Enterprise Server.
Item
Requirement
operating system
Any of the following operating systems:
•
Microsoft® Windows® 2000 SP4 (Server edition or Advanced Server edition)
•
Microsoft® Windows Server® 2003 SP1
•
Microsoft® Windows® XP Professional SP2
media player
web browser
To support audio attachments, Windows Media® Player Version 9 or later
Microsoft® Internet Explorer® with the following settings:
•
Java® or JavaScript® turned on
•
language preferences configured to display encoded web pages
7
System requirements: BlackBerry Manager
Upgrade Guide
System requirements: BlackBerry Manager
The following system requirements apply when installing the BlackBerry® Manager on a computer separate from the BlackBerry®
Enterprise Server.
Item
Requirement
operating system
Any of the following operating systems:
•
Windows® 2000 SP4 (Server, Advanced Server, or Professional)
•
Windows Server® 2003 or later
•
Windows Server 2003 or later (64-bit)
•
Windows Server 2003 R2 SP2
•
Windows Server 2003 R2 SP2 (64-bit)
•
Windows® XP Professional SP2
Microsoft® .NET Framework
To support languages other than English, localized version of Microsoft .NET
Framework version 1.1 SP1
Microsoft® Internet Explorer® with the following settings:
•
Java® or JavaScript® turned on
•
language preferences set to display encoded web pages
browser
data access components
Any of the following data access components:
•
MDAC version 2.8 with Security Patch MS04-003 (version 2000.85.1025.00)
•
MDAC version 2.8 SP2 (version 2000.86.1830.00)
printer and file sharing
USB hub
To support BlackBerry device implementation, printer and file sharing turned on
To support BlackBerry device implementation that uses a hub, a USB driver that
supports USB 1.1-compliant hubs
System requirements: BlackBerry MDS Connection Service
The following system requirements apply when installing the BlackBerry® MDS Connection Service on a computer separate from
the BlackBerry® Enterprise Server.
8
Item
Requirement
operating system
Any of the following operating systems:
System requirements: BlackBerry MDS Integration Service
Upgrade Guide
Item
Requirement
•
•
•
RSA® Authentication Agent
Microsoft® Windows® 2000 SP4 (Server edition, Advanced Server edition, or
Professional edition)
Microsoft® Windows Server® 2003 SP1
Microsoft® Windows® XP Professional SP2
To support enhanced network authentication, RSA Authentication Agent Version
5.0 for Microsoft Windows
System requirements: BlackBerry MDS Integration Service
The following system requirements apply when installing the BlackBerry® MDS Integration Service on a computer separate from
the BlackBerry® Enterprise Server.
Item
Requirement
operating system
Any of the following operating systems:
•
Windows® 2000 SP4 (Server or Advanced Server )
•
Windows Server® 2003 or later
•
Windows Server 2003 or later (64-bit)
•
Windows Server 2003 R2 SP2
•
Windows Server 2003 R2 SP2 (64-bit)
database conditions
A database server that is the host for the BlackBerry Configuration Database.
System requirements: BlackBerry Router
The following system requirements apply when installing the BlackBerry® Router on a computer separate from the BlackBerry®
Enterprise Server.
Item
Requirement
operating system
Any of the following operating systems:
•
Microsoft® Windows® 2000 SP4 (Server edition or Advanced Server edition)
•
Microsoft® Windows Server® 2003 SP1
•
Microsoft® Windows® XP Professional SP2
firewall
A firewall or proxy firewall with the following conditions:
9
System requirements for optional environments and features
Upgrade Guide
Item
Requirement
•
•
•
support for the BlackBerry Router to initiate an outgoing, two-way TCP/IP
connection to an external server on port 3101
support for the resolution of Internet addresses using DNS
transparency of the proxy server for proxy firewalls
System requirements for optional environments and features
Item
Description
virtual environment
The BlackBerry® Enterprise Server and the BlackBerry Enterprise Server
components support the following virtual environments:
•
VMware® ESX Server version 2.5.2 or later
•
VMware ESX Server version 3.0.1
•
VMware ESX Server version 3.5
enhanced network authentication
The BlackBerry Enterprise Server and its components support RSA® Authentication
Agent version 5.0 for Windows®.
The BlackBerry Enterprise Server and its components support the SNMP service.
The BlackBerry Enterprise Server and its components support remote access using
any of the following applications:
•
Terminal Services for use with Windows Server 2000, installed using Remote
Administration mode
•
Microsoft® Remote Desktop Connection for use with Windows Server 2003
SNMP monitoring
remote access
Unsupported environments
Item
Description
DMZ
The BlackBerry® Enterprise Server and the BlackBerry Enterprise Server
components, with the exception of the BlackBerry Router, do not support installation
in a DMZ.
The BlackBerry MDS Integration Service databases do not support the Microsoft
SQL Server 2005 Express database.
Microsoft® SQL Server® 2005 Express
database
10
Upgrade Guide
Setting up the database connection
Setting up the database connection
3
The BlackBerry® Enterprise Server can connect to the BlackBerry Configuration Database on the Microsoft® SQL Server® using
Microsoft® Windows® authentication or database authentication. If you use Microsoft Windows authentication, the BlackBerry
Manager logs in to the BlackBerry Configuration Database using the Microsoft Windows account that you used to complete the
installation process.
If you use database authentication with Microsoft SQL Server, the BlackBerry Manager authenticates to the database using the
database credentials that the administrator provides.
Specifying permissions when connecting to the BlackBerry Configuration
Database using Microsoft Windows authentication
During the BlackBerry® Enterprise Server installation process, if you choose to connect to the BlackBerry Configuration Database
using Microsoft® Windows® authentication, the Microsoft Windows account that you use must have permissions on the database
server. The type of permissions depends on the BlackBerry Enterprise Server setup option that you choose, and on whether you
create the BlackBerry Configuration Database on the same computer as the BlackBerry Enterprise Server or on another database
server.
Specifying MSDE 2000 permissions for the Microsoft Windows account
If you install MSDE 2000 during the BlackBerry® Enterprise Server installation process, you do not need to specify additional
permissions. When you select Microsoft® Windows® authentication during the BlackBerry Enterprise Server installation process,
the setup application automatically assigns the required permissions to the Microsoft Windows account that you are using to
complete the installation.
Assign Microsoft SQL Server permissions to the Windows account
Perform one of the following actions:
• If you create the BlackBerry® Configuration Database on the same computer as the BlackBerry® Enterprise Server, or if
you install the BlackBerry MDS Integration Service, assign the system administrator permission to the Windows® account
that you are using to complete the installation.
• If you create the BlackBerry Configuration Database on another computer, assign server administrator and database
creator permissions to the Windows account that you are using to complete the installation process. If you are using
Microsoft® SQL Server® 2005, assign the system administrator permission to each of the following roles:
SQLAgentUserRole, SQLAgentReaderRole, and SQLAgentOperatorRole.
11
Upgrade Guide
Configuring authentication to the BlackBerry MDS Integration Service database
Configuring authentication to the BlackBerry MDS Integration Service
database
If you install the BlackBerry® MDS Integration Service on a Microsoft® SQL Server®, the setup application uses the same
authentication method and account that you specified for the BlackBerry Configuration Database. The account requires the same
permissions for the BlackBerry MDS Integration Service database as it requires for the BlackBerry Configuration Database.
12
Upgrade Guide
Upgrading the BlackBerry Enterprise Server software by overwriting the existing version
Upgrading the BlackBerry Enterprise Server software by
overwriting the existing version
4
The in-place upgrade process upgrades the BlackBerry® Enterprise Server software by replacing the existing version of the
software.
Advantages
•
•
Disadvantages
You do not require additional computers to perform this •
upgrade.
When the upgrade process completes, user accounts are
active, and no additional administrative action is
•
required.
You cannot remove the BlackBerry Enterprise Server and
return to the earlier version of the software
automatically.
You must turn off the BlackBerry Enterprise Server during
the upgrade process, so the interruption to services for
BlackBerry devices lasts as long as it takes the upgrade
process to complete.
When you use the in-place upgrade process, the following events occur:
•
BlackBerry devices that are running BlackBerry® Device Software Version 4.0 or later receive new service books, and wireless
data synchronization occurs.
•
All BlackBerry devices receive new IT policies.
Upgrade the BlackBerry Enterprise Server software
The upgrade process includes a restart of the computer.
1. Log into the computer using an administrative account with the appropriate database permissions.
2. Double-click setup.exe.
3. Complete the instructions on the screen.
4. When prompted to restart the computer, click Yes.
5. Log in to the computer using the same account that you used in step 1 to start the setup application.
6. Complete the instructions on the screen.
7. In the Microsoft® Windows® Services, start the BlackBerry® Enterprise Server services.
8. In the BlackBerry Manager, specify the proxy settings for the BlackBerry MDS Connection Service instances that you
upgraded from Version 4.1 or Version 4.1 SP1.
13
Upgrade Guide
Improve the startup performance of the BlackBerry Enterprise Server
Improve the startup performance of the BlackBerry Enterprise Server
After an upgrade, the BlackBerry® Enterprise Server might send new service books to every BlackBerry device. If it sends all the
new service books at the same time, the BlackBerry Enterprise Server startup time might be affected. You can improve the startup
performance of the BlackBerry Enterprise Server by configuring how many service books the BlackBerry Enterprise Server sends
each hour.
1.
2.
On the computer that hosts an upgraded BlackBerry Policy Service, open the Registry Editor.
Perform one of the following actions:
• If you are running a 32-bit version of Windows®, navigate to HKEY_LOCAL_MACHINE\Software\Research In Motion
\BlackBerry Enterprise Server\IT Admin Server.
• If you are running a 64-bit version of Windows, navigate to HKEY_LOCAL_MACHINE\Software\WOW6432Node
\Research In Motion\BlackBerry Enterprise Server\IT Admin Server.
3.
Create the following DWORD values:
• SBThrottlingEnabled: Set to 1.
• SBThrottleLimit: Set, in decimal format, the maximum number of service books that you want the BlackBerry Enterprise
Server to send each hour. The default number is .60, which means the BlackBerry Enterprise Server sends 60 new service
books each hour.
14
Upgrading the BlackBerry Enterprise Server by using a new computer
Upgrade Guide
Upgrading the BlackBerry Enterprise Server by using a new
computer
5
The cutover upgrade process installs the BlackBerry® Enterprise Server on a new computer and moves user accounts and server
information from the old BlackBerry Enterprise Server to the new one.
Advantages
•
Disadvantages
You can move user accounts back to the old BlackBerry •
Enterprise Server if you encounter any problems with the •
new one.
You can use new server hardware and start with a clean
environment.
Users experience minimal service interruptions because
user accounts remain active on the old BlackBerry
Enterprise Server until you start the new one.
•
•
You require one extra computer.
If you upgrade from a version earlier than BlackBerry
Enterprise Server Version 4.0, the BlackBerry Enterprise
Server takes longer to start than it did previously because
it sends new service books to all of the BlackBerry devices
that are capable of wireless data synchronization.
This upgrade process uses the same SRP credentials on both the old and the new BlackBerry Enterprise Server instances.
When you use the cutover process, the following events occur:
•
•
BlackBerry devices that are running BlackBerry® Device Software Version 4.0 or later receive new service books, and wireless
data synchronization occurs.
All BlackBerry devices receive new IT policies.
Prerequisites: Upgrading the BlackBerry Enterprise Server software
Item
inactive user accounts
credentials from the BlackBerry
Enterprise Server installation media
installation credentials from your
environment
Requirement
•
•
•
•
CAL key
SRP identifier
SRP key
SRP host
•
unique IMAP account name and password
15
Install BlackBerry Enterprise Server version 4.1 SP7 on the new computer
Upgrade Guide
Item
Requirement
•
•
computer name and port number of the IMAP server that hosts the IMAP
account
computer name and port number of the proxy server (optional)
Install BlackBerry Enterprise Server version 4.1 SP7 on the new computer
Note: To ensure your upgrade process completes successfully, do not upgrade your existing BlackBerry® Configuration Database.
The installation process includes a restart of the computer.
If you use a .pac file to configure the connection to the proxy server, you can specify that file after you complete the installation
process.
1.
2.
3.
4.
Log in to the new computer using an administrative account with the appropriate database permissions.
The setup application adds this account to the security administrator role in the BlackBerry Configuration Database
automatically.
Double-click setup.exe.
Complete the instructions on the screen.
When prompted for the BlackBerry® Enterprise Server and the SRP credentials, perform one of the following actions:
• In a BlackBerry Enterprise Server Version 3.6 environment, use the name and credentials from the primary instance.
• In all other environments, use the same name and the same SRP credentials as one of the BlackBerry Enterprise Server
instances that you want to replace.
5.
6.
7.
8.
9.
When prompted to restart the computer, click Yes.
Log in using the same account that you used for the setup application in step 1.
Create or specify a new BlackBerry Configuration Database during the installation process.
Complete the instructions on the screen.
Before completing the installation process, clear the Start Service(s) option.
Move user accounts to the new BlackBerry Enterprise Server
1.
2.
On the BlackBerry® Enterprise Server that the user accounts are located on, open a command prompt.
Switch to the Tools folder on the BlackBerry Enterprise Server installation media.
If the transfer of user accounts was unsuccessful, check the log file for error messages.
Example
16
Upgrade Guide
Prevent the old BlackBerry Enterprise Server from connecting to the BlackBerry Infrastructure
BESMigration tool parameters
Parameter
Description
-s <MAPI profile><old server><new
server>
This parameter specifies the following MAPI information:
•
<MAPI profile>: The MAPI profile that you want to use when you move
BlackBerry® Enterprise Server and user account information.
•
<old server>: The name of the BlackBerry Enterprise Server or instance that
you are moving user accounts from.
•
<new server>: The name of the BlackBerry Enterprise Server that you are
moving user accounts to.
-d <DB server name> <DB name>
This parameter specifies the computer name and the database name of the
BlackBerry Configuration Database.
This parameter specifies the name of the log file and the path to it.
This parameter specifies the name of the status file and the path to it. The
BESMigration tool uses the status file to track the progress of the transfer of user
information. On subsequent transfer attempts, the tool reads this file to determine
which user records are already located in the BlackBerry Configuration Database.
This parameter writes status and progress information to the registry.
If you are using database authentication, this parameter specifies the database user
name and password.
This parameter runs the tool in preview mode without making any changes to the
BlackBerry Configuration Database.
This parameter runs the tool silently.
This parameter prints user properties that the tool retrieved from the user’s mailbox
to the migration log file, for troubleshooting purposes only.
-l <log file>
-t <status file>
-w
-u <username> <password>
-p
-q
-g
Prevent the old BlackBerry Enterprise Server from connecting to the
BlackBerry Infrastructure
If you try to connect two BlackBerry® Enterprise Server instances to the BlackBerry® Infrastructure using the same SRP credentials,
the BlackBerry Infrastructure deactivates the credentials and wireless traffic cannot occur.
1. In the Microsoft® Windows® Services, stop all BlackBerry Enterprise Server services.
17
Upgrade Guide
2.
Improve the startup performance of the BlackBerry Enterprise Server
Change the startup type for all BlackBerry Enterprise Server services to Disabled.
Improve the startup performance of the BlackBerry Enterprise Server
After an upgrade, the BlackBerry® Enterprise Server might send new service books to every BlackBerry device. If it sends all the
new service books at the same time, the BlackBerry Enterprise Server startup time might be affected. You can improve the startup
performance of the BlackBerry Enterprise Server by configuring how many service books the BlackBerry Enterprise Server sends
each hour.
1.
2.
On the computer that hosts an upgraded BlackBerry Policy Service, open the Registry Editor.
Perform one of the following actions:
• If you are running a 32-bit version of Windows®, navigate to HKEY_LOCAL_MACHINE\Software\Research In Motion
\BlackBerry Enterprise Server\IT Admin Server.
• If you are running a 64-bit version of Windows, navigate to HKEY_LOCAL_MACHINE\Software\WOW6432Node
\Research In Motion\BlackBerry Enterprise Server\IT Admin Server.
3.
Create the following DWORD values:
• SBThrottlingEnabled: Set to 1.
• SBThrottleLimit: Set, in decimal format, the maximum number of service books that you want the BlackBerry Enterprise
Server to send each hour. The default number is .60, which means the BlackBerry Enterprise Server sends 60 new service
books each hour.
Start the new BlackBerry Enterprise Server
1.
In the Windows® Services, start the services for the BlackBerry® Enterprise Server components in the following order:
• BlackBerry Controller
• BlackBerry Router
• BlackBerry Dispatcher
• all remaining services
2.
In the BlackBerry Manager, start the BlackBerry Enterprise Server and other BlackBerry Enterprise Server services.
After you finish: After you complete the upgrade process, if you moved user accounts to a new BlackBerry Domain, users must
reactivate the BlackBerry devices. Instruct users to connect the BlackBerry devices to the BlackBerry® Desktop Manager to receive
the new SRP routing and service name information.
18
Upgrade Guide
Troubleshooting the BlackBerry Enterprise Server upgrade process
Troubleshooting the BlackBerry Enterprise Server upgrade
process
6
A third-party tool did not install and the BlackBerry Enterprise Server setup
application closed
Possible solution
1.
2.
3.
4.
On the BlackBerry® Enterprise Server installation media, open the Tools folder.
Double-click the setup application file for the tool that you want to install.
Complete the instructions on the screen.
Restart the BlackBerry Enterprise Server setup application.
Previous version detected but no database available
This message appears when you start the setup application and the setup application stops responding.
Possible solution
The registry keys that identify your BlackBerry® Configuration Database must exist in the Microsoft® Windows® Registry.
1.
2.
3.
4.
On the computer on which you plan to upgrade the BlackBerry® Enterprise Server, open the Registry Editor.
In the left pane, navigate to HKEY_LOCAL_MACHINE\Research In Motion\BlackBerry Enterprise Server\Database.
Create the following case-sensitive string values (if they do not exist):
•
DatabaseName: Type the name of the BlackBerry Configuration Database.
•
DatabaseServerMachineName: Type the computer name of the database server.
Restart the setup application.
You cannot resolve errors that occur when you move users
Possible solution
1.
2.
3.
Delete the user accounts from the BlackBerry® Enterprise Server before you start the upgrade process.
Add the user accounts to the BlackBerry Enterprise Server when the upgrade process completes.
Activate users’ BlackBerry devices over the wireless network.
19
Upgrade Guide
You encounter errors when you try to upgrade the BlackBerry Configuration Database
You encounter errors when you try to upgrade the BlackBerry Configuration
Database
Possible solution
1.
2.
3.
Navigate to C:\Program Files\Research In Motion\BlackBerry Enterprise Server\Logs\Installer or to the location of the log
files that you specified in the setup application.
Open DB_InstallV<YYMMDDHHMMSS>.log, where <YYMMDDHHMMSS> specifies the date and time, in 24 hour clock
format, that you upgraded the BlackBerry® Configuration Database.
Check the log file for error messages.
The setup application prompts you for access to the installation media for
Microsoft .NET Framework version 1.1
When the BlackBerry® Enterprise Server setup application installs Microsoft® .NET Framework version 1.1 SP1 on a computer that
hosts a previously installed version of Microsoft .NET Framework version 1.1, it prompts you for access to the installation media
for Microsoft .NET Framework version 1.1.
Possible solution
You can access the netfx.msi file that is included with the BlackBerry Enterprise Server installation media.
1.
2.
3.
On the BlackBerry Enterprise Server installation media, open the Tools folder.
Double-click the netfx.msi file.
Complete the instructions on the screen.
Restore a BlackBerry Configuration Database
If you created a copy of the BlackBerry® Configuration Database using the CreateDB tool, you can restore the copy if you determine
that the upgrade process did not complete successfully.
1.
2.
3.
4.
5.
6.
20
In the Windows® Services, stop the BlackBerry® Enterprise Server services.
On the server that hosts the BlackBerry Configuration Database, open a command prompt window.
Change to <extractedfolder>\Tools.
Type BlackBerryDBRestore.exe.
Type the same parameters that you used when you backed up the BlackBerry Configuration Database.
Press ENTER.
Upgrading the BlackBerry Device Software
Upgrade Guide
Upgrading the BlackBerry Device Software
7
If you want to make the new features of the BlackBerry® Enterprise Server available to your users, you can upgrade the BlackBerry®
Device Software when you upgrade the BlackBerry Enterprise Server.
If you want to upgrade the BlackBerry Device Software, you can also choose to upgrade the BlackBerry® Desktop Software.
For more information about BlackBerry Device Software and BlackBerry Desktop Software, visit www.blackberry.com/support.
Permitting users to upgrade the BlackBerry Device Software at their
computers
If you want users to upgrade the BlackBerry® Device Software at their computers, you can install the BlackBerry Device Software
and the application loader tool on a network drive.
Advantages
•
•
Disadvantages
You can automate the process for upgrading the
•
BlackBerry Device Software so that users do not have to
complete any upgrade tasks for BlackBerry devices that •
use a USB connection.
You can upgrade BlackBerry devices remotely.
•
You cannot manage BlackBerry Device Software
upgrades using software configurations.
You cannot make users upgrade the BlackBerry Device
Software.
This upgrade process increases network traffic to the
network drive.
This upgrade process only applies if users have one of the following desktop software versions:
•
BlackBerry® Desktop Software Version 3.6 or later
•
BlackBerry® Handheld Manager Version 3.6 or later
After the upgrade process completes, the application loader tool connects to the messaging server to provision the BlackBerry
devices.
Upgrading the BlackBerry Device Software at a central computer
If you want to upgrade the BlackBerry® Device Software for users, or if you want users to upgrade their BlackBerry devices at a
central computer, you can upgrade the BlackBerry Device Software at the central computer.
21
Upgrade Guide
Pushing the BlackBerry Device Software and the BlackBerry Desktop Software to users' computers
Advantages
•
•
•
•
•
Disadvantages
You can monitor the software upgrade process at the
•
central computer.
You can use software configurations to help control the
software upgrades.
You can upgrade multiple BlackBerry devices at the same
time.
You can upgrade BlackBerry devices for users who do not
have the BlackBerry® Desktop Manager installed on
their computers.
You can share a single software location among multiple
central computers.
You cannot make users upgrade the BlackBerry Device
Software.
Pushing the BlackBerry Device Software and the BlackBerry Desktop
Software to users' computers
You can use third-party applications to create a single upgrade file that contains the BlackBerry® Desktop Software and the
BlackBerry® Device Software, and send the upgrade file to the computers of your BlackBerry device users. The application loader
tool on the computers upgrades the BlackBerry Device Software on the BlackBerry device.
Advantages
Disadvantages
•
•
•
You can install the BlackBerry Device Software and the
BlackBerry Desktop Software on computers
automatically.
You can set an IT policy to make users upgrade the
BlackBerry Device Software.
You must distribute large upgrade packages over your
organization's LAN.
The upgrade file installs the BlackBerry Desktop Software and the BlackBerry Device Software on the computers of your BlackBerry
device users. To upgrade the BlackBerry Device Software on their BlackBerry devices, users can connect their BlackBerry devices
to their computers and start the BlackBerry® Desktop Manager.
This upgrade process applies when you upgrade from BlackBerry Device Software Version 3.5 or earlier.
22
Upgrade Guide
Permitting users to upgrade the BlackBerry Device Software at their computers
Permitting users to upgrade the BlackBerry Device
Software at their computers
8
If you want users to upgrade the BlackBerry® Device Software at their computers, you can install the BlackBerry Device Software
and the application loader tool on a network drive.
Advantages
•
•
Disadvantages
You can automate the process for upgrading the
•
BlackBerry Device Software so that users do not have to
complete any upgrade tasks for BlackBerry devices that •
use a USB connection.
You can upgrade BlackBerry devices remotely.
•
You cannot manage BlackBerry Device Software
upgrades using software configurations.
You cannot make users upgrade the BlackBerry Device
Software.
This upgrade process increases network traffic to the
network drive.
This upgrade process only applies if users have one of the following desktop software versions:
•
BlackBerry® Desktop Software Version 3.6 or later
•
BlackBerry® Handheld Manager Version 3.6 or later
After the upgrade process completes, the application loader tool connects to the messaging server to provision the BlackBerry
devices.
Configure a network drive
1.
2.
3.
Share <drive>:\Program Files\Common Files\Research In Motion with read-only permissions.
Verify that the computers of BlackBerry® device users in your organization can access the network drive.
To decrease bandwidth over your organization's LAN, verify that the network drive is in close proximity to users.
Save the BlackBerry Device Software installation files to the network drive
Before you begin: Your service provider can provide you with the BlackBerry® Device Software installation media.
1.
2.
On the network drive, in the installation directory, create a folder that is named Device.
Save the required BlackBerry Device Software files to the folder.
23
Upgrade Guide
Verify the version of the application loader tool
Verify the version of the application loader tool
Perform this task to ensure that the application loader tool supports the new version of BlackBerry® Device Software.
1.
2.
3.
4.
On the network drive, navigate to <drive>:\Program Files\Common Files\Research In Motion\AppLoader.
Right-click loader.exe.
Click Properties.
On the Version tab, verify that loader.exe is Version 4.1 or later.
If the version number for loader.exe is earlier than Version 4.1, visit www.blackberry.com/support/downloads to download
BlackBerry® Desktop Software Version 4.1 or later.
Sending the BlackBerry Desktop Software or BlackBerry Device Manager
installation files to users' computers
If BlackBerry® device users do not have the BlackBerry® Desktop Software installed on their computers, you can send the
installation files for the BlackBerry Desktop Software or the BlackBerry® Device Manager to their computers.
You can distribute the installation files in one of the following ways:
•
send the .msi file for the BlackBerry Device Manager to users' computers
•
configure and send the BlackBerry Desktop Software installation file to users' computers, which installs the software and
settings on users’ computers automatically
Send the BlackBerry Device Manager installation file to users' computers
You can send the BlackBerry® Device Manager to users so that they can perform actions such as charging their BlackBerry
devices, synchronizing organizer items through the BlackBerry Router, and upgrading the BlackBerry® Device Software at their
computers.
Note: If you send the BlackBerry Device Manager installation file to computers on which the BlackBerry® Desktop Manager is
installed, the BlackBerry Device Manager installation process removes the BlackBerry Desktop Manager automatically.
1. Download the installation file for the BlackBerry Device Manager from www.blackberry.com/support/downloads.
2. Copy the installation file that you downloaded to the shared network drive.
3. Send users an email message that includes the following information:
• location of the installation file on the network drive
• instructions to double-click blackberry device manager v4.1.msi
24
Upgrade Guide
Synchronizing wireless data automatically
Send the BlackBerry Desktop Software installation file to users' computers
You can send users the BlackBerry® Desktop Software so that they can synchronize organizer data items and manage message
forwarding at their computers.
Synchronizing wireless data automatically
When you upgrade the BlackBerry® Enterprise Server, the BlackBerry Synchronization Service sends service books to the
BlackBerry devices that can synchronize data over the wireless network. For more information about which BlackBerry® Device
Software versions cause wireless data synchronization to occur automatically, visit www.blackberry.com/support to read article
KB04295.
Create the BlackBerry Device Software upgrade instructions for BlackBerry
device users
Perform this task so that your users can upgrade the BlackBerry® Device Software.
1. Create an email message that includes the location of the application loader tool and specifies the following loading
commands based on the type of connection that the BlackBerry device uses:
• USB: \\<shared computer name>\Research In Motion\Apploader\loader.exe /defaultUSB /forceload
• Serial: \\<shared computer name>\Research In Motion\Apploader\loader.exe
2.
Consider providing the following instructions in the email message:
• Connect your BlackBerry device to your computer.
• Do not disconnect your BlackBerry device from your computer until the upgrade process completes.
• If prompted, type your BlackBerry device password. Click Next.
• If your BlackBerry device uses a serial connection, complete the instructions on the screen.
Confirming that the BlackBerry Device Software upgrade process completed
successfully
Verify that the upgrade from BlackBerry Device Software Version 4.0 or later completed
successfully
1.
2.
3.
In the BlackBerry® Manager, in the left pane, click a BlackBerry® Enterprise Server.
In the Users list, click a user.
In the lower pane, verify the BlackBerry® Device Software version.
25
Upgrade Guide
Confirming that the BlackBerry Device Software upgrade process completed successfully
When you upgrade the BlackBerry Device Software, the version of the BlackBerry Device Software on the BlackBerry device
does not update immediately in the BlackBerry Manager. You might have to wait for a short period of time while the
BlackBerry Configuration Database synchronizes the version of the BlackBerry Device Software that displays in the
BlackBerry Manager with the version of the BlackBerry Device Software that is installed on the BlackBerry device.
Instruct users to perform the following actions:
• On the BlackBerry® device, in the device options, click About.
• Confirm the version.
26
Upgrading the BlackBerry Device Software at a central computer
Upgrade Guide
Upgrading the BlackBerry Device Software at a central
computer
9
If you want to upgrade the BlackBerry® Device Software for users, or if you want users to upgrade their BlackBerry devices at a
central computer, you can upgrade the BlackBerry Device Software at the central computer.
Advantages
•
•
•
•
•
Disadvantages
You can monitor the software upgrade process at the
•
central computer.
You can use software configurations to help control the
software upgrades.
You can upgrade multiple BlackBerry devices at the same
time.
You can upgrade BlackBerry devices for users who do not
have the BlackBerry® Desktop Manager installed on
their computers.
You can share a single software location among multiple
central computers.
You cannot make users upgrade the BlackBerry Device
Software.
Configure a network drive
1.
2.
3.
Share <drive>:\Program Files\Common Files\Research In Motion with read-only permissions.
Verify that the computers of BlackBerry® device users in your organization can access the network drive.
To decrease bandwidth over your organization's LAN, verify that the network drive is in close proximity to users.
Save the BlackBerry Device Software installation files to the network drive
Before you begin: Your service provider can provide you with the BlackBerry® Device Software installation media.
1.
2.
On the network drive, in the installation directory, create a folder that is named Device.
Save the required BlackBerry Device Software files to the folder.
27
Upgrade Guide
Create a software configuration for the BlackBerry Device Software
Create a software configuration for the BlackBerry Device Software
Perform this task to help control the software upgrade process for each BlackBerry® device at a central computer.
1. In the BlackBerry Manager, in the left pane, click BlackBerry Domain.
2. On the Software Configurations tab, click Add New Configuration.
3. In the Configuration Name field, type a name for the software configuration.
4. In the Device Software Location field, click the Change button.
5. Navigate to the network location where you installed the BlackBerry® Device Software.
6. In the Application Name list, select the check box for the BlackBerry device series that you want to upgrade the BlackBerry
Device Software for.
7. Expand the application tree.
8. Select the check boxes for additional components or applications that you want to install.
9. Click OK.
Assign the software configuration to a user
To monitor whether a user upgrades to BlackBerry® Device Software Version 4.0 or later, assign the user to the software
configuration for the BlackBerry Device Software.
1. In the BlackBerry Manager, in the left pane, click a BlackBerry® Enterprise Server.
2. In the Users list, click the user account that you want to assign the software configuration to.
3. In the lower pane, click Device Management.
4. Click Assign Software Configuration.
5. Click a software configuration.
6. Click OK.
Upgrade the BlackBerry Device Software at a central computer
Before you begin:
•
Verify that the central computer can access the network drive.
•
To decrease bandwidth over your organization's LAN, verify that the network drive is in close proximity to the central
computer.
•
Verify that BlackBerry® Manager is installed on the central computer.
1.
2.
28
Connect the BlackBerry device to the central computer that hosts the BlackBerry Manager.
In the BlackBerry Manager, in the left pane, click Ports.
Upgrade Guide
Verify that the BlackBerry Device Software upgrade at a central computer completed successfully
3.
4.
On the Ports tab, click the BlackBerry device that you want to upgrade the BlackBerry® Device Software for.
Perform one of the following actions:
• To upgrade the BlackBerry Device Software automatically, click Load Handheld.
• To upgrade the BlackBerry Device Software using the application loader tool, click Load Handheld (Interactive).
5.
6.
7.
Click a software configuration.
Click OK.
If you are using the application loader tool, complete the instructions on the screen.
Verify that the BlackBerry Device Software upgrade at a central computer
completed successfully
1.
2.
3.
In the BlackBerry® Manager, in the left pane, click a BlackBerry® Enterprise Server.
In the Users list, click a user.
In the lower pane, check for one of the following status messages:
• Upgrade Required: the BlackBerry device has not yet been upgraded to the BlackBerry® Device Software specified in
the assigned software configuration
• Up to date: the BlackBerry device has been upgraded to the BlackBerry Device Software specified in the software
configuration
When you upgrade the BlackBerry Device Software, the version of the BlackBerry Device Software on the BlackBerry device
does not update immediately in the BlackBerry Manager. You might have to wait for a short period of time while the
BlackBerry Configuration Database synchronizes the version of the BlackBerry Device Software that displays in the
BlackBerry Manager with the version of the BlackBerry Device Software that is installed on the BlackBerry device.
29
Upgrade Guide
Pushing the BlackBerry Device Software and the BlackBerry Desktop Software to users' computers
Pushing the BlackBerry Device Software and the
BlackBerry Desktop Software to users' computers
10
You can use third-party applications to create a single upgrade file that contains the BlackBerry® Desktop Software and the
BlackBerry® Device Software, and send the upgrade file to the computers of your BlackBerry device users. The application loader
tool on the computers upgrades the BlackBerry Device Software on the BlackBerry device.
Advantages
Disadvantages
•
•
•
You can install the BlackBerry Device Software and the
BlackBerry Desktop Software on computers
automatically.
You can set an IT policy to make users upgrade the
BlackBerry Device Software.
You must distribute large upgrade packages over your
organization's LAN.
The upgrade file installs the BlackBerry Desktop Software and the BlackBerry Device Software on the computers of your BlackBerry
device users. To upgrade the BlackBerry Device Software on their BlackBerry devices, users can connect their BlackBerry devices
to their computers and start the BlackBerry® Desktop Manager.
This upgrade process applies when you upgrade from BlackBerry Device Software Version 3.5 or earlier.
Configure a network drive
1.
2.
3.
Share <drive>:\Program Files\Common Files\Research In Motion with read-only permissions.
Verify that the computers of BlackBerry® device users in your organization can access the network drive.
To decrease bandwidth over your organization's LAN, verify that the network drive is in close proximity to users.
Install the BlackBerry Device Software on the network drive
If you want to automate the BlackBerry® Device Software upgrade process and the provisioning process, you can install the
application loader tool. The application loader tool installs as a component of both BlackBerry Device Software Version 4.1 and
BlackBerry® Desktop Software Version 4.1.
Before you begin: Your service provider can provide you with the BlackBerry Device Software installation media.
1.
2.
3.
30
Save the BlackBerry Device Software installation file to the network drive.
On the network drive, double-click the .exe file.
Complete the installation process.
Upgrade Guide
4.
5.
Save the BlackBerry Desktop Software installation file to the network drive
Verify that the files are located at <drive>:\Program Files\Common Files\Research In Motion\Shared\Loader Files.
Save the BlackBerry Device Software installation file to other regional network drives and install it, if applicable, in your
environment.
After you finish: To download BlackBerry Desktop Software Version 4.1, visit www.blackberry.com/support/downloads.
Save the BlackBerry Desktop Software installation file to the network drive
1.
2.
3.
4.
5.
6.
7.
Download the BlackBerry® Desktop Software installation file from www.blackberry.com/support/downloads.
Save the installation file that you downloaded to the network drive.
If necessary, extract the installation files from the .exe file to the network drive.
On the network drive, open setup.ini.
At the bottom of setup.ini, type [INSTALL_OPTIONS].
To add the installation settings, use install.txt, which is included with the BlackBerry Desktop Software installation files.
Save setup.ini.
Synchronizing wireless data automatically
When you upgrade the BlackBerry® Enterprise Server, the BlackBerry Synchronization Service sends service books to the
BlackBerry devices that can synchronize data over the wireless network. For more information about which BlackBerry® Device
Software versions cause wireless data synchronization to occur automatically, visit www.blackberry.com/support to read article
KB04295.
Send the installation files for the BlackBerry Desktop Software and the
BlackBerry Device Software to users using a third-party application
Perform this task so that you can upgrade the BlackBerry® Desktop Software and BlackBerry® Desktop Manager by pushing the
software to user computers using a third-party application.
1. Package the customized BlackBerry Desktop Software and the BlackBerry® Device Software installation files using a thirdparty application for software packaging.
2. Send the installation files using a third-party application for software distribution.
After you finish: If you want to make sure that users upgrade the BlackBerry Device Software, set the Force Load Count IT policy
rule and the Force Load Message IT policy rule. For more information, see the BlackBerry Enterprise Server Policy Reference Guide.
31
Upgrade Guide
Confirming that the BlackBerry Device Software upgrade process completed successfully
Confirming that the BlackBerry Device Software upgrade process completed
successfully
Verify that the upgrade from BlackBerry Device Software Version 4.0 or later completed
successfully
1.
2.
3.
In the BlackBerry® Manager, in the left pane, click a BlackBerry® Enterprise Server.
In the Users list, click a user.
In the lower pane, verify the BlackBerry® Device Software version.
When you upgrade the BlackBerry Device Software, the version of the BlackBerry Device Software on the BlackBerry device
does not update immediately in the BlackBerry Manager. You might have to wait for a short period of time while the
BlackBerry Configuration Database synchronizes the version of the BlackBerry Device Software that displays in the
BlackBerry Manager with the version of the BlackBerry Device Software that is installed on the BlackBerry device.
Instruct users to perform the following actions:
• On the BlackBerry® device, in the device options, click About.
• Confirm the version.
32
Upgrade Guide
Troubleshooting
Troubleshooting
11
When users click the link to the application loader tool in the upgrade
instructions, the upgrade process does not start
Possible cause
The application loader might not be shared.
Possible solution
1.
2.
3.
Connect a BlackBerry® device to a computer on which the BlackBerry Manager is installed.
At the command prompt, type \\<shared network drive>\Research In Motion\Apploader\loader.exe
If the application loader tool starts, the tool is shared successfully.
33
Upgrade Guide
Glossary
Glossary
12
BlackBerry Domain
A BlackBerry Domain consists of the BlackBerry Configuration Database with its users and any BlackBerry® Enterprise Server
instances that connect to it.
BlackBerry MDS
BlackBerry® Mobile Data System
BlackBerry Mobile Data Service
After you upgrade to BlackBerry® Enterprise Server Version 4.1 or later, the BlackBerry® Mobile Data Service name changes
to the BlackBerry MDS Connection Service.
BlackBerry CAL
A BlackBerry® Client Access License (BlackBerry CAL) limits how many users you can add to a BlackBerry® Enterprise Server.
DMZ
A demilitarized zone (DMZ) is a neutral subnetwork outside of an organization's firewall. It exists between the trusted LAN
of the organization and the untrusted external wireless network and public Internet.
DNS
Domain Name System
J2SE
Java® 2 Platform, Standard Edition
JRE
Java® Runtime Environment
LAN
local area network
MDAC
Microsoft® Data Access Components
MSDE
Microsoft® SQL Server® Desktop Engine
SNMP
Simple Network Management Protocol
SQL
Structured Query Language
34
Upgrade Guide
Glossary
SRP
Server Routing Protocol
XML
Extensible Markup Language
USB
Universal Serial Bus
35
Upgrade Guide
Legal notice
Legal notice
13
©2009 Research In Motion Limited. All rights reserved. BlackBerry®, RIM®, Research In Motion®, SureType®, SurePress™ and
related trademarks, names, and logos are the property of Research In Motion Limited and are registered and/or used in the U.S.
and countries around the world.
IBM, Lotus, and Sametime are trademarks of International Business Machines Corporation. Microsoft, Active Directory, Internet
Explorer, SQL Server, Windows, Windows Media, and Windows Server are trademarks of Microsoft Corporation. Novell and
GroupWise are trademarks of Novell, Inc. RSA is a trademark of RSA Security. Java, JavaScript, JRE, and J2SE are trademarks of
Sun Microsystems, Inc. VMware is a trademark of VMware, Inc. All other brands, product names, company names, trademarks,
and service marks are the properties of their respective owners.
The BlackBerry smartphone and other devices and/or associated software are protected by copyright, international treaties, and
various patents, including one or more of the following U.S. patents: 6,278,442; 6,271,605; 6,219,694; 6,075,470; 6,073,318;
D445,428; D433,460; D416,256. Other patents are registered or pending in the U.S. and in various countries around the world.
Visit www.rim.com/patents for a list of RIM (as hereinafter defined) patents.
This documentation including all documentation incorporated by reference herein such as documentation provided or made
available at www.blackberry.com/go/docs is provided or made accessible "AS IS" and "AS AVAILABLE" and without condition,
endorsement, guarantee, representation, or warranty of any kind by Research In Motion Limited and its affiliated companies
("RIM") and RIM assumes no responsibility for any typographical, technical, or other inaccuracies, errors, or omissions in this
documentation. In order to protect RIM proprietary and confidential information and/or trade secrets, this documentation may
describe some aspects of RIM technology in generalized terms. RIM reserves the right to periodically change information that
is contained in this documentation; however, RIM makes no commitment to provide any such changes, updates, enhancements,
or other additions to this documentation to you in a timely manner or at all.
This documentation might contain references to third-party sources of information, hardware or software, products or services
including components and content such as content protected by copyright and/or third-party web sites (collectively the "Third
Party Products and Services"). RIM does not control, and is not responsible for, any Third Party Products and Services including,
without limitation the content, accuracy, copyright compliance, compatibility, performance, trustworthiness, legality, decency,
links, or any other aspect of Third Party Products and Services. The inclusion of a reference to Third Party Products and Services
in this documentation does not imply endorsement by RIM of the Third Party Products and Services or the third party in any way.
EXCEPT TO THE EXTENT SPECIFICALLY PROHIBITED BY APPLICABLE LAW IN YOUR JURISDICTION, ALL CONDITIONS,
ENDORSEMENTS, GUARANTEES, REPRESENTATIONS, OR WARRANTIES OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING
WITHOUT LIMITATION, ANY CONDITIONS, ENDORSEMENTS, GUARANTEES, REPRESENTATIONS OR WARRANTIES OF
DURABILITY, FITNESS FOR A PARTICULAR PURPOSE OR USE, MERCHANTABILITY, MERCHANTABLE QUALITY, NONINFRINGEMENT, SATISFACTORY QUALITY, OR TITLE, OR ARISING FROM A STATUTE OR CUSTOM OR A COURSE OF DEALING
OR USAGE OF TRADE, OR RELATED TO THE DOCUMENTATION OR ITS USE, OR PERFORMANCE OR NON-PERFORMANCE
OF ANY SOFTWARE, HARDWARE, SERVICE, OR ANY THIRD PARTY PRODUCTS AND SERVICES REFERENCED HEREIN, ARE
HEREBY EXCLUDED. YOU MAY ALSO HAVE OTHER RIGHTS THAT VARY BY STATE OR PROVINCE. SOME JURISDICTIONS
MAY NOT ALLOW THE EXCLUSION OR LIMITATION OF IMPLIED WARRANTIES AND CONDITIONS. TO THE EXTENT
36
Upgrade Guide
Legal notice
PERMITTED BY LAW, ANY IMPLIED WARRANTIES OR CONDITIONS RELATING TO THE DOCUMENTATION TO THE EXTENT
THEY CANNOT BE EXCLUDED AS SET OUT ABOVE, BUT CAN BE LIMITED, ARE HEREBY LIMITED TO NINETY (90) DAYS FROM
THE DATE YOU FIRST ACQUIRED THE DOCUMENTATION OR THE ITEM THAT IS THE SUBJECT OF THE CLAIM.
TO THE MAXIMUM EXTENT PERMITTED BY APPLICABLE LAW IN YOUR JURISDICTION, IN NO EVENT SHALL RIM BE LIABLE
FOR ANY TYPE OF DAMAGES RELATED TO THIS DOCUMENTATION OR ITS USE, OR PERFORMANCE OR NONPERFORMANCE OF ANY SOFTWARE, HARDWARE, SERVICE, OR ANY THIRD PARTY PRODUCTS AND SERVICES REFERENCED
HEREIN INCLUDING WITHOUT LIMITATION ANY OF THE FOLLOWING DAMAGES: DIRECT, CONSEQUENTIAL, EXEMPLARY,
INCIDENTAL, INDIRECT, SPECIAL, PUNITIVE, OR AGGRAVATED DAMAGES, DAMAGES FOR LOSS OF PROFITS OR REVENUES,
FAILURE TO REALIZE ANY EXPECTED SAVINGS, BUSINESS INTERRUPTION, LOSS OF BUSINESS INFORMATION, LOSS OF
BUSINESS OPPORTUNITY, OR CORRUPTION OR LOSS OF DATA, FAILURES TO TRANSMIT OR RECEIVE ANY DATA, PROBLEMS
ASSOCIATED WITH ANY APPLICATIONS USED IN CONJUNCTION WITH RIM PRODUCTS OR SERVICES, DOWNTIME COSTS,
LOSS OF THE USE OF RIM PRODUCTS OR SERVICES OR ANY PORTION THEREOF OR OF ANY AIRTIME SERVICES, COST OF
SUBSTITUTE GOODS, COSTS OF COVER, FACILITIES OR SERVICES, COST OF CAPITAL, OR OTHER SIMILAR PECUNIARY
LOSSES, WHETHER OR NOT SUCH DAMAGES WERE FORESEEN OR UNFORESEEN, AND EVEN IF RIM HAS BEEN ADVISED
OF THE POSSIBILITY OF SUCH DAMAGES.
TO THE MAXIMUM EXTENT PERMITTED BY APPLICABLE LAW IN YOUR JURISDICTION, RIM SHALL HAVE NO OTHER
OBLIGATION, DUTY, OR LIABILITY WHATSOEVER IN CONTRACT, TORT, OR OTHERWISE TO YOU INCLUDING ANY LIABILITY
FOR NEGLIGENCE OR STRICT LIABILITY.
THE LIMITATIONS, EXCLUSIONS, AND DISCLAIMERS HEREIN SHALL APPLY: (A) IRRESPECTIVE OF THE NATURE OF THE
CAUSE OF ACTION, DEMAND, OR ACTION BY YOU INCLUDING BUT NOT LIMITED TO BREACH OF CONTRACT, NEGLIGENCE,
TORT, STRICT LIABILITY OR ANY OTHER LEGAL THEORY AND SHALL SURVIVE A FUNDAMENTAL BREACH OR BREACHES
OR THE FAILURE OF THE ESSENTIAL PURPOSE OF THIS AGREEMENT OR OF ANY REMEDY CONTAINED HEREIN; AND (B)
TO RIM AND ITS AFFILIATED COMPANIES, THEIR SUCCESSORS, ASSIGNS, AGENTS, SUPPLIERS (INCLUDING AIRTIME
SERVICE PROVIDERS), AUTHORIZED RIM DISTRIBUTORS (ALSO INCLUDING AIRTIME SERVICE PROVIDERS) AND THEIR
RESPECTIVE DIRECTORS, EMPLOYEES, AND INDEPENDENT CONTRACTORS.
IN ADDITION TO THE LIMITATIONS AND EXCLUSIONS SET OUT ABOVE, IN NO EVENT SHALL ANY DIRECTOR, EMPLOYEE,
AGENT, DISTRIBUTOR, SUPPLIER, INDEPENDENT CONTRACTOR OF RIM OR ANY AFFILIATES OF RIM HAVE ANY LIABILITY
ARISING FROM OR RELATED TO THE DOCUMENTATION.
Prior to subscribing for, installing, or using any Third Party Products and Services, it is your responsibility to ensure that your
airtime service provider has agreed to support all of their features. Some airtime service providers might not offer Internet browsing
functionality with a subscription to the BlackBerry® Internet Service. Check with your service provider for availability, roaming
arrangements, service plans and features. Installation or use of Third Party Products and Services with RIM's products and services
may require one or more patent, trademark, copyright, or other licenses in order to avoid infringement or violation of third party
rights. You are solely responsible for determining whether to use Third Party Products and Services and if any third party licenses
are required to do so. If required you are responsible for acquiring them. You should not install or use Third Party Products and
Services until all necessary licenses have been acquired. Any Third Party Products and Services that are provided with RIM's
products and services are provided as a convenience to you and are provided "AS IS" with no express or implied conditions,
endorsements, guarantees, representations, or warranties of any kind by RIM and RIM assumes no liability whatsoever, in relation
thereto. Your use of Third Party Products and Services shall be governed by and subject to you agreeing to the terms of separate
licenses and other agreements applicable thereto with third parties, except to the extent expressly covered by a license or other
agreement with RIM.
37
Upgrade Guide
Legal notice
Certain features outlined in this documentation require a minimum version of BlackBerry® Enterprise Server, BlackBerry® Desktop
Software, and/or BlackBerry® Device Software.
The terms of use of any RIM product or service are set out in a separate license or other agreement with RIM applicable thereto.
NOTHING IN THIS DOCUMENTATION IS INTENDED TO SUPERSEDE ANY EXPRESS WRITTEN AGREEMENTS OR WARRANTIES
PROVIDED BY RIM FOR PORTIONS OF ANY RIM PRODUCT OR SERVICE OTHER THAN THIS DOCUMENTATION.
Certain features outlined in this documentation might require additional development or Third Party Products and Services for
access to corporate applications.
This product contains a modified version of HTML Tidy. Copyright © 1998-2003 World Wide Web Consortium (Massachusetts
Institute of Technology, European Research Consortium for Informatics and Mathematics, Keio University). All Rights Reserved.
This product includes software developed by the Apache Software Foundation (www.apache.org/) and/or is licensed pursuant
to one of the licenses listed at (www.apache.org/licenses/). For more information, see the NOTICE.txt file included with the
software.
Research In Motion Limited
295 Phillip Street
Waterloo, ON N2L 3W8
Canada
Research In Motion UK Limited
Centrum House
36 Station Road
Egham, Surrey TW20 9LF
United Kingdom
Published in Canada
38