Skip Navigation
  1. BlackBerry Docs
  2. BlackBerry Enterprise Mobility Server 3.6
  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 'Enable upload of BEMS statistics' in the
    BEMS-Core
     configuration content    . 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.  For more information, see 'Log Upload Credentials' in the
      BEMS-Core
       configuration content      . 
    • Click
      Skip
       to continue with the installation. If the
      Allow BEMS to send statistics information to BlackBerry
       check box is selected and you provide the credentials in the 'Log Upload Credentials' in the dashboard, the 'Upload of BEMS statistics' settings 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.