Skip Navigation
  1. BlackBerry Docs
  2. BlackBerry UEM 12.21
  3. BlackBerry UEM Installation and Upgrade
  4. Installing or upgrading the BlackBerry UEM software
  5. Install a new BlackBerry UEM instance

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 Setup.exe 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
    Microsoft .NET Framework
     4.8 is not installed. You can ignore this warning and proceed with the installation. The setup application will automatically install
    Microsoft .NET Framework
     4.8 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.
  10. In the
    Setup type
     dialog box, select
    Create a BlackBerry UEM database
    , and then perform one of the following actions:
    • Select
      Install and use Microsoft SQL Server 2017 Express SP1 on this computer
       if you do not have
      Microsoft SQL Server
       installed.
    • 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, fill out the fields:
    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
     to install
    UEM
    .
  18. Click
    Next
     when the installation is complete.
  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,
  • 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.