Upgrade the BEMS software

When you perform an in-place upgrade of the BEMS instance, you upgrade the existing services only. During the upgrade process you cannot add, change, or remove services. During the upgrade process, notifications are suspended. The BEMS log files, Windows event logs, and the database record the upgrade as BEMS being in maintenance mode. After the upgrade is complete, the log files, event logs, and database show BEMS as being in upgraded mode. A restart of the computer might be required.

If you installed the BEMS services on separate computers, complete this task on each computer that you installed a service on. Depending on the services that you install on the computer, some steps might not apply.

Note: When you upgrade to JRE 17, it is a best practice to uninstall JRE 8 after the upgrade is complete, to allow for potential rollback if necessary.
The BEMS instance must be fully functional, and the Good Technology Common Services service must be running to perform an in-place upgrade of the BEMS software.
  • Make sure you log in with the BEMS service account you created to install BEMS.
  • Verify that you completed the prerequisites and preinstallation and tasks.
  • Verify that the BEMS debug logging level is not set to Debug or Trace, or the upgrade or repair of the BEMS instance fails. For more information, visit KB 42408.
  • Verify that you have the password for the BEMS service account.
  • If you upgrade BEMS in a cluster environment, back up the BEMS cluster database.
  • By default, encrypt=false is prepopulated in the Additional properties, so data between BEMS and the SQL Server is not encrypted. Existing properties that you have configured are retained. If your environment requires data to be encrypted, and requires verification of the TLS certificate, you must change the encrypt option in the Additional properties to true and add trustServerCertificate=false separated by a semicolon (no space before or after the semicolon) during the installation or after in the Dashboard. Make sure that you first import the CA certificate that is signing your SQL Server certificate into the Java certificate store before you change the properties, or BEMS will be unable to connect to the SQL Server database. For more information, see Import the CA certificate into the Java certificate store.
    Note: If you enable encryption for all data that is sent between BEMS and the SQL Server, it may cause higher than normal CPU usage.
  1. Log in to the computer that hosts BEMS using your BEMS service account.
  2. Copy the installation files to the computer.
  3. Extract the contents to a folder on the computer.
  4. In the GoodEnterpriseMobilityServer installation folder, double-click InstallBEMS.bat. If you double-click GoodEnterpriseMobilityServer.<version number>.exe, the installer fails, and the following error message appears: "Could not find a valid Java machine to load."
    If a Windows message appears and requests permission for GoodEnterpriseMobilityServer.<version number>.exe to make changes to the computer, click Yes. If a supported version of Java isn't installed on the computer or the JAVA_HOME system variable isn't specified correctly, an error message indicates that a supported version of Java is required. For more information, see Set an environment variable for the Java location.
  5. In the BlackBerry Enterprise Mobility Server v<version number> setup screen, in the Introduction dialog box, select Upgrade. Click Next.
  6. Accept the license agreement and click Next.
  7. Click Next.
  8. In the Services dialog box, click Next
  9. In the Prerequisite dialog box, click Next.
    If the Prerequisite dialog box displays a warning that a prerequisite is not met, you must cancel the upgrade and complete the prerequisites before you can continue with the upgrade
  10. In the Host information dialog box, complete one of the following actions:
    • Select Use previously installed certificate to accept the default values and keep the existing certificate.
    • Select Accept these values for Hostname and Domain, to create the certificate for BEMS.
    • Select Modify these values and enter the new hostname and domain name.
  11. Click Next.
  12. In the Choose Install Folder dialog box, click Next to accept the default installation folder location.
  13. In the Choose Logs Folder dialog box, click Next to accept the default log file folder location.
  14. In the Administration Information dialog box, type the password for the BEMS service account. Click Next.
  15. In the AD User Credentials dialog box, enter the existing BEMS service account login credentials to access the BEMS Dashboard. Click Next.
  16. In the Database Information dialog box, verify the BEMS-Core service database information to connect to the Microsoft SQL Server and enter the BEMS service account password. Click Next.
  17. In the Connect Administrator Information dialog box, enter the BEMS-Connect service account password. Click Next.
  18. In the Connect Database Information dialog box, verify the BEMS-Connect database information to connect to the Microsoft SQL Server and enter the BEMS service account password. Click Next.
  19. In the Presence Administrator Information dialog box, enter the BEMS-Presence service account password. Click Next.
  20. In the Docs Database Information dialog box, verify the BEMS-Docs database information to connect to the Microsoft SQL Server and enter the BEMS service account password. Click Next.
    If your environment uses AlwaysOn with multi-subnet deployment, in the Additional Properties field, type MultiSubnetFailover=true.
  21. In the Pre-installation Summary dialog box, click Install to install BEMS.
  22. In the Upgrade Complete dialog box, click Next when the upgrade of the BEMS service is complete.
  23. In the Upgrade Complete dialog box, complete the following steps:
    1. Verify that the Start BEMS services checkbox is selected. If you clear the Start BEMS services checkbox, the BEMS installer stops the Good Technology Common Services.
    2. If you are prompted to restart the computer. Select Yes, restart my system or No, I will restart my system myself.
  24. Click Done.