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

Upgrade 
BEMS

When you upgrade 
BEMS
, 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.
  • Make sure you log in with the 
    BEMS
     service account you created to install 
    BEMS
    .
  • Verify that you have the password for the 
    BEMS
     service account.
  • Stop the 
    Good Technology Common Services
     on each computer in the cluster that hosts 
    BEMS
    .
  • If you upgrade 
    BEMS
     in a cluster environment, back up the 
    BEMS
     cluster database.
  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
     installation folder, complete one of the following tasks:  
    • If you use an OpenJDK JRE, double-click 
      InstallBEMS.bat
      .
    • If you use 
      Oracle
      's 
      Java
      , double-click 
      GoodEnterpriseMobilityServer.<
      version number
      >.exe
      .  
    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 that you are installing 
    BEMS
     or the JAVA_HOME system variable isn't specified correctly, the error message 
    Could not find a valid Java virtual machine to load. You may need to reinstall a supported java virtual machine
    . For more information on prerequisite requirements, see the Preinstallation checklists. For instructions on setting the JAVA_HOME system variable, see Configure the Java Runtime Environment.
  5. In the 
    BlackBerry Enterprise Mobility Server v<
    version number
    > setup
     screen, in the 
    Introduction
     dialog box, select 
    Upgrade
    . Click 
    Next
    . 
  6. In the 
    License Agreement
     dialog box, select 
    I accept the terms of the License Agreement
    . 
  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.
  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
    . 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, verifiy the 
    BEMS-Connect
     database information to connect to the 
    Microsoft SQL Server
    . 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
    . 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, complete the following actions:
    1. Click 
      Next
       when the 
      BEMS-Mail
       upgrade is complete.
    2. Click 
      Next
       when the 
      BEMS-Connect
       upgrade is complete.
    3. Click 
      Next
       when the 
      BEMS-Presence
       upgrade is complete.
    4. Click 
      Next
       when the 
      BEMS-Docs
       upgrade is complete.
  23. If you upgraded from a version of 
    BEMS
     earlier than 2.10 and didn't specify the upload credentials during a previous installation or in the Dashboard, you are prompted in the 
    Installing, Upload Credentials
     dialog box to provide your 
    BlackBerry
     Online Portal credentials, cluster name and domain name. Click 
    Next
    .
    Providing this information allows 
    BlackBerry
     to collect statistical information (for example, the version of 
    BEMS
     that is installed) and makes uploading the 
    BEMS
     logs to 
    BlackBerry Technical Support Services
     easy. For more information about 
    BEMS
     statistics, see . Complete one of the following steps:
    • Click 
      OK
       to enter your credentials. The credentials prepopulate the Upload BEMS Statistics and Log Upload Credentials in the dashboard.  
    • Click 
      Skip
       to continue with the installation. If the 
      Allow BEMS to send statistics information to BlackBerry
       check box is selected and you configure the  in the dashboard, the  are configured automatically.  
  24. 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
      .
  25. Click 
    Done
    .
Configure 
BEMS
. The 
BEMS
 Dashboard opens at https://localhost:8443/dashboard.