Skip Navigation

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 device connectivity components only (also known as 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
    BlackBerry UEM
    software on every server that you are installing or upgrading
    BlackBerry UEM
    on. Do not copy already extracted
    BlackBerry UEM
    software from another server.
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.
  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, type the
    Windows
    password and click
    Next
    .
  17. In the
    Installation summary
    dialog box, click
    Install
    to install
    UEM
    .
  18. In the
    Installing
    dialog box, 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.