Install a new BlackBerry UEM instance

When you run the setup application, use only standard characters to specify values. Unicode characters are not supported. If you want to install the BlackBerry Connectivity Node, see Creating server groups and installing BlackBerry Connectivity Node instances.
  • If you install UEM behind a firewall, it cannot connect to the BlackBerry Infrastructure until you configure the proxy server. UEM prompts you the first time you log in to the UEM management console.
  • Installing UEM to a mapped network drive is not supported.
  • You must perform a new extraction of the UEM software on every server that you are installing or upgrading UEM on. Do not copy already extracted UEM software from another server.
  • If you want to use a group Managed Service Account (gMSA) to install UEM and run the UEM services, you must create and configure the gMSA and verify that it is available on the computer that you will install UEM on. For more information about creating and configuring a gMSA, see Windows Server: Get started with Group Managed Service Accounts.
  1. Log in to the computer that you want to install UEM on using the service account.
  2. Copy the UEM .zip file to the computer and extract the contents to a folder.
    Do not copy used installation files from another computer. You must re-extract the installation files on each computer.
  3. In the UEM installation folder, double-click Setup.exe. If a Windows message appears and requests permission for the setup application to make changes to the computer, click Yes.
  4. In the Language selection dialog box, select your language.
  5. Click OK.
  6. In the UEM setup application screen, click Next.
  7. In the License agreement dialog box, perform the following actions:
    1. Select your country or region.
    2. Read the license agreement. To accept the license agreement, select I accept the terms of the license agreement.
    3. Click Next.
  8. In the Component selection dialog box, check the boxes for the components you want to install on the computer. Click Next.
    For information about the components, see the Planning content. If you want to install the device connectivity components only (also known as the BlackBerry Connectivity Node), see Creating server groups and installing BlackBerry Connectivity Node instances.
  9. In the Installation requirements dialog box, you can check to see if your computer has met the requirements to install UEM. Click Next.
    The setup application may display a warning that indicates that a required version of Microsoft .NET Framework is not installed. You can ignore this warning and proceed with the installation. The setup application will automatically install Microsoft .NET Framework 4.8.1 for you if it is not detected on your computer. If a later version of Microsoft .NET Framework is already installed, the UEM setup application does not install Microsoft .NET Framework 4.8.1. Note that Microsoft .NET Framework 4.8.1 is not supported on Windows Server 2019 or 2016; for these operating systems, you must install Microsoft .NET Framework 4.8 separately before you continue the UEM installation process.
  10. In the Setup type dialog box, select Create a BlackBerry UEM database, and then perform one of the following actions:
    • If you do not have Microsoft SQL Server installed, select the option to install a supported version of Microsoft SQL Server Express.
    • If you already have a supported version of Microsoft SQL Server installed, select Use an existing Microsoft SQL Server instance in your organization's environment.
    You can install the database server on the same computer or use an existing database server in your organization's environment (local or remote).
  11. Click Next.
  12. If you selected Use an existing Microsoft SQL Server instance in your organization's environment, in the BlackBerry UEM database dialog box, do the following:
    1. In the Microsoft SQL Server name field, type the name of the computer that hosts the database server.
      If you are using an AlwaysOn FCI, type the SQL Virtual Server Network Name for the WSFC cluster (for example, CompanySQLCluster). If you are using an AlwaysOn availability group, type the Availability Group Listener Virtual Network Name (for example, CompanyListener).
    2. In the Database name field, type a name for the new database.
    3. If you configured the database server to use static ports, select the Static option. If the static port number is not 1433, in the Port field, type the port number.
    4. By default, the setup application uses Windows authentication to connect to the existing database. If you select Microsoft SQL Server authentication, specify a Windows account that has access to the Microsoft SQL Server.
    5. Click Next.
  13. In the BlackBerry UEM configuration dialog box, click Next to confirm the UEM host and domain names.
  14. In the Folder locations dialog box, perform the following actions:
    1. Specify the location of the installation folder and log file folder.
    2. If you receive a message saying there is not enough space remaining, create extra space to install UEM on your computer.
    3. If you receive a message asking you to create the installation and log file folder locations, click Yes.
  15. Click Next.
  16. In the Service account dialog box, do one of the following:
    • If you want to use a Windows service account, type the Windows password and click Next.
    • If you want to use a gMSA, select the Use managed service account check box. Specify the gMSA username using this format: <domain>\<group_managed_service_account>$. Click Next.

      Note that the gMSA is not validated during the installation process. Verify that you specify the correct gMSA username in the format above.

  17. In the Installation summary dialog box, click Install.
  18. When the installation is complete, click Next.
  19. In the Console addresses dialog box, perform one of the following actions:
    • Click Close if you do not want to export your console addresses to a file.
    • Select the Export the console addresses to a file check box and save the file on your computer. Click Close.
  • For high availability:
  • If you want to configure UEM to use a proxy server, see the Configuration content.
  • Do not create a shared folder within the installation folder after you install UEM. If you reinstall or upgrade UEM, all of the files and folders in the installation folder are deleted, including the shared folder.
  • If an error message for RRAS appears in the Server Manager window, you can disregard it.
  • Do not add any files to the folder that contains the UEM installation files (the default is C:\Program Files\BlackBerry\UEM). During an upgrade, the installer removes the contents of the UEM software directory, including its own installation files.