Skip Navigation

Preinstallation and preupgrade requirements

Review the following checklists before you begin installing or upgrading
BlackBerry UEM
Hardware requirements
The performance calculator provides minimum recommendations based on the values you enter. If you require additional capacity, redundancy, or room for growth, enter values that reflect these needs to accommodate any near future large app and user deployment projects.
Ensure your environment meets the hardware requirements for your needs.
Ensure that database latency requirements are met.
BlackBerry UEM Core
servers must have less than 5ms latency to the database server.
Third-party software requirements
Verify that your computer is running an operating system that supports BlackBerry UEM.
Verify that you have a supported browser on the computers that host the
BlackBerry UEM
management console.
The browser must support configuration of the following settings:
  • Support for JavaScript
  • Cookies turned on
  • Support for TLS
  • SSL certificate installed to permit trusted connections to the consoles
If you have a requirement to use a proxy server in your organization, verify that you have a supported proxy solution.
Ensure that
is up to date and that you perform any reboot required for the update.
Verify that your computer is running
Windows PowerShell
2.0 or later for the following:
  • RRAS for
    BlackBerry Secure Connect Plus
    setup during the
    BlackBerry UEM
  • Exchange ActiveSync
    gatekeeping (optional)
Verify that you have installed JRE 8 on the servers where you will install BlackBerry UEM. Visit to review article 52117.
For more information about supported JRE versions, see the Compatibility matrix.
Environment configuration requirements
Verify that the BlackBerry UEM listening ports are configured.
Verify that you opened the necessary ports on your organization's firewall. For more information about port and firewall requirements, visit to read article 36470.
BlackBerry UEM
services do not support SSL Termination, SSL Offloading, SSL Packet Inspection or Deep Packet Inspection. Ensure these endpoint services are not enabled on your proxy/firewall.
Verify that the TCP/IP network protocols are turned on for your BlackBerry UEM database.
Verify that you have DNS support for resolving IP addresses into host names.
If you perform the installation or upgrade process on a computer that has more than one NIC, verify that the production NIC is first in the bind order in the Windows network settings.
If a
host operating system is configured in a workgroup instead of a domain, verify that you configured the primary DNS suffix. For information on configuring the primary DNS suffix, visit the
support website.
Ensure that the no count setting for the
Microsoft SQL Server
is disabled.
Verify that the
BlackBerry UEM
service account has local administrator permissions on each computer.
Microsoft SQL Server
account must have dbo as its default schema.
Ensure antivirus exclusions have been made for both the extracted installation files and the target installation and logging directories.
For more information, visit to read article 36596.
If you previously upgraded from a legacy
Good Control
environment and modified the Java Heap value, make note of the existing value. You will need to reapply the change after upgrade. For more information, visit to read article 56641.
Additional considerations
Review all current Critical Issue Advisories. Contact BlackBerry Technical Support if you are unsure whether a particular advisory applies to you.
Review the Release Notes.
Review the information about supported upgrade environments.
If you plan to install BlackBerry UEM in a DMZ, read Installing BlackBerry UEM in a DMZ.
Plan for an appropriate amount of downtime based on the number of servers in your environment.
Upgrading the first server may take 45-60 minutes. Additional servers may take 15-45 minutes depending on which components are installed and whether or not these components can be installed in parallel. Consider adding additional time to account for rolling back servers if troubleshooting is required.
Verify that you have the appropriate licenses.
Visit to read article 38341 about licensing.
Make sure that your perpetual licenses are supported. Visit to read article 36537.
Perpetual licenses are issued for specific versions of
BlackBerry UEM
and are not compatible with later versions. If perpetual licenses are covered by a valid support contract, automatic version updates are supported.
Visit to review article 38980 about upgrades.
If your organization uses a proxy server for Internet access, verify that you have the computer name, port number, and credentials for the proxy server.
If your organization uses
VPP accounts, after the upgrade you must generate a new .vpp token file and edit your
VPP account information at Apps > iOS App licenses.
If you are planning a multistage upgrade, review the upgrade documentation for the versions you are upgrading to.
Decommission surplus nodes, if applicable. For more information, visit to read article 46210 and see the Installation and upgrade content for instructions on how to remove
BlackBerry UEM