Skip Navigation
  1. BlackBerry Docs
  2. BlackBerry Enterprise Mobility Server 3.8
  3. BEMS Installation Guide
  4. Installing or upgrading the BEMS software
  5. Upgrade the BEMS software

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. For more information, see Standard InstallAnywhere Variables.
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.
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 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.
    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
    .