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.
  • Verify that you have completed all of the required preinstallation or preupgrade tasks.
  • 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.
  1. Log in to the computer that you want to host the UEM software as a domain administrator with permissions to install software. If you want to use an Administrator service account to run the UEM services, you can log in to the computer using that 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, do the following:
    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 UEM Planning Guide. 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, verify that your computer meets the requirements to install UEM. Click Next.
  10. In the Setup type dialog box, select Create a new BlackBerry UEM database, and do one of the following:
    • To use the Microsoft SQL Server instance that is already installed on the computer where you are installing UEM, select Use Microsoft SQL Server installed on this computer.
    • To use a Microsoft SQL Server instance that is hosted on another computer, select Use an existing Microsoft SQL Server instance in your organization's environment.
  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, do the following:
    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 an Administrator service account or a restricted service account to run the UEM services, in the Windows username and Windows password fields, specify the service account username and password. 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.
    • If you want to use a built-in service account, select the Use built-in service account check box. Specify the built-in Windows service account that you want to use. By default, the setup application will use NT AUTHORITY\NETWORK SERVICE with a blank password. Click Next.
  17. In the Installation summary dialog box, click Install.
  18. When the installation is complete, click Next.
  19. In the Console addresses dialog box, do the following:
    • 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 UEM Configuration Guide.
  • 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.