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

Install the
BEMS
 software

  • Make sure that you install
    BEMS
     on an English implementation of the operating system.
  • If your organization uses AlwaysOn support for
    SQL Server
    , make sure you complete the steps in Appendix: AlwaysOn Availability support for SQL Server and that you have the FQDN of the AlwaysOn Listener and name of the database that is added to the AlwaysOn Availability Group available before you install the
    BEMS
     software. For information about supported
    SQL Server
     versions, see the BEMS Compatibility Matrix.
    When you install the
    BEMS
     services on separate computers, all steps will not apply. Complete this task on each computer that you install one or more services on.
  1. Log in to the computer that you want to install
    BEMS
     on using the
    BEMS
     service account.
  2. Copy the installation files to the computer.
  3. Extract the content to a folder on the computer.
  4. In the
    GoodEnterpriseMobilityServer
     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, click
    Next
    .
  6. In the
    License Agreement
     dialog box, select
    I accept the terms of the License Agreement
    . Click
    Next
    .
  7. In the
    Services
     dialog box, select the services you want to install. Click
    Next
    .
    Scroll to the bottom of the page to view all of the service options.
  8. 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 installation and complete the prerequisites before you can start the installation again.
  9. In the
    Host information
     dialog box, verify the
    BEMS
     Hostname and Domain name. If necessary, select
    Modify these values
     and type the new Hostname and Domain.
  10. Click
    Next
    .
  11. In the
    Choose Install Folder
     dialog box, click
    Next
     to accept the default installation folder location.
  12. In the
    Choose Logs Folder
     dialog box, click
    Next
     to accept the default log file folder location.
  13. In the
    Administration Information
     dialog box, select
    This Account (domain/user)
     and type the login credentials for the
    BEMS
     service account you created in Setting up a Windows service account for BEMS. Click
    Next
  14. In the
    Database Information
     dialog box, perform the following actions:
    Task
    Steps
    Specify the
    Microsoft SQL Server
     connection information for the
    BEMS-Core
     service database.
    The information that you provide here prepopulates the BEMS-Core database screen (BEMS System Settings > BEMS Database) in the Dashboard. For more information, see BEMS-Core database.
    1. In the
      Host
       field, type the FQDN and, if applicable, the SQL instance name of your
      SQL Server
      . For example,
      • SQL Express or
        SQL Server
         using a SQL Instance name: <
        server name
        >\<
        database instance name
        >
      • SQL Server
         using the default SQL instance: <
        server name
        >
      • If your environment uses AlwaysOn enter the FQDN of the AlwaysOn Listener.
    2. In the
      Database name
       field, type the name for the
      BEMS-Core
       database (for example, if you install of the
      BEMS
       services on one server, type
      BEMS-Core
      .
      If you install the
      BEMS
       services on separate servers, type one of the following:
      • If you install the
        BlackBerry Push Notifications
         service (
        Mail
         service) on one server, type
        BEMS-Core1
        .
      • If you install on a server that will host the
        Presence
         service, type
        BEMS-Core2
        .
      • If you install on a server that will host only the
        Connect
         service, type
        BEMS-Core3
        .
      • If you install on a server that will host the
        Connect
         service and the
        Presence
         service together, type
        BEMS-Core3
        .
      • If you install on a server that will host only the
        Docs
         service, type
        BEMS-Core4
        .
      If your environment uses AlwaysOn enter the name of the database that is added to the AlwaysOn Availability Group.
    3. In the
      Port
       field, type the port number that connects to the
      SQL Server
      . If the
      SQL Server
       instance is using dynamic ports, leave this field blank. By default, this port is 1433 if a static TCP/IP port is used.
      To use
      SQL Server
       dynamic TCP/IP ports, make sure that the
      SQL Server
       Browser service is running.
    4. Optionally, in the
      Additional Properties
       field, specify any connection properties (for example, name1=value1; name2=value2, and so on). For more information, visit docs.microsoft.com to see Setting the connection properties.
      If your environment uses AlwaysOn with multisubnet deployment, type
      MultiSubnetFailover=true
      .
    5. By default, the setup application uses
      SQL Server
       authentication to connect to the
      BEMS
       database. Select
      Windows Authentication
      . Click
      Next
      .
    Enter the
    BEMS
     service account login credentials under which the
    BEMS
    -
    Connect
    Windows
     service run.
    1. In the
      Login
       field, type the
      BEMS
       service account login information (for example, <
      domain123
      >.example.com\<
      BEMS service account username
      >).
    2. In the
      Password
       field, type the
      BEMS
       service account password.
    3. Click
      Next
      .
    Specify the
    SQL Server
     connection information for the
    BEMS-Connect
     service database.
    1. In the
      Host
       field,  type the FQDN and, if applicable, the SQL instance name of your
      SQL Server
      . For example,
      • SQL Express or
        SQL Server
         using a SQL Instance name: <
        server name
        >\<
        database instance name
        >
      • SQL Server
         using the default SQL instance : <
        server name
        >
      • If your environment uses AlwaysOn enter the FQDN of the AlwaysOn Listener.
    2. In the
      Database name
       field, type the name for the
      BEMS-Connect
       database (for example, if you install the
      BEMS
      -
      Connect
       service on one server or all of the
      BEMS
       services on one server, type
      BEMS-Connect
      .
      If your environment uses AlwaysOn enter the name of the database that is added to the AlwaysOn Availability Group.
    3. In the
      Port
       field, type the port number that connects to the
      SQL Server
      . If the
      SQL Server
       instance is using dynamic ports, leave this field blank. By default, this port is 1433 if a static TCP/IP port is used.
    4. Optionally, in the
      Additional Properties
       field, specify any connection properties (for example, name1=value1; name2=value2, and so on). For more information, visit docs.microsoft.com to see Setting the connection properties.
      If your environment uses AlwaysOn with multi-subnet deployment, type
      MultiSubnetFailover=true
      .
    5. By default, the setup application uses the
      SQL Server
       authentication to connect to the
      BEMS
       database. Select
      Windows Authentication
      . Click
      Next
      .
    Enter the
    BEMS
     service account login credentials under which the
    BEMS
    -
    Presence
    Windows
     service run.
    A database is not required for the
    Presence
     service if all of the
    BEMS
     services are installed on one computer.
    1. In the
      Login
       field, type the
      BEMS
       service account login information (for example, <
      domain123
      >.example.com\<
      BEMS service account username
      >).
    2. In the
      Password
       field, type the
      BEMS
       service account password.
    3. Click
      Next
      .
    Specify the
    SQL Server
     connection information for the
    BEMS-Docs
     service database.
    1. In the
      Host
       field, type the FQDN and, if applicable, the SQL instance name of your
      SQL Server
      . For example,
      • SQL Express or
        SQL Server
         using a SQL Instance name: <
        server name
        >\<
        database instance name
        >
      • SQL Server
         using the default SQL instance : <
        server name
        >
      • If your environment uses AlwaysOn enter the FQDN of the AlwaysOn Listener.
    2. In the
      Database name
       field, type the name for the
      BEMS-Docs
       database. For example,
      BEMS-Docs
      .
      • If you install the
        Docs
         service with all of the
        BEMS
         services on one or on separate computers, type
        BEMS-Docs
        .
      • If your environment uses AlwaysOn enter the name of the database that is added to the AlwaysOn Availability Group.
    3. In the
      Port
       field, type the port number that connects to the
      Microsoft SQL Server
      . If the
      SQL Server
       instance is using dynamic ports, leave this field blank. By default, this port is 1433 if a static TCP/IP port is used.
    4. Optionally, in the
      Additional Properties
       field, specify any connection properties (for example, name1=value1; name2=value2, and so on). For more information, visit docs.microsoft.com to see Setting the connection properties.
      If your environment uses AlwaysOn with multi-subnet deployment, type
      MultiSubnetFailover=true
      .
    5. By default, the setup application uses
      SQL Server
       authentication to connect to the
      BEMS
       database. Select
      Windows Authentication
      .
    6. Click
      Next
      .
  15. In the
    Pre-installation Summary
     dialog box, click
    Install
     to install
    BEMS
    .
  16. In the
    Installing
     dialog box, complete one or more of the following actions
    1. Click
      Next
       when the
      BEMS-Mail
       installation is complete.
    2. Click
      Next
       when the
      BEMS-Connect
       installation is complete.
    3. Click
      Next
       when the
      BEMS-Presence
       installation is complete.
    4. Click
      Next
       when the
      BEMS-Docs
       installation is complete.
  17. Optionally, in the
    Installing, Upload Credentials
     dialog box, you can provide your
    BlackBerry
     Online Portal credentials, cluster name and domain name. You can skip this screen and configure this information later in the
    BEMS
     Dashboard. Click
    Next
    .
    If you skip this step during the installation and do not configure the dashboard, you are prompted for this information each time that you upgrade the
    BEMS
     instance. 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    .
    1. Click
      OK
       to enter your credentials. The credentials prepopulate the 'Upload BEMS statistics' and the 'BlackBerry Online Portal Username field' on the 'Log Upload Credentials' screen in the dashboard. For more information, see 'Log Upload Credentials' in the
      BEMS-Core
       configuration content      .
    2. 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.
  18. In the
    Install Complete
     dialog box, click
    Done
    .
The setup application opens the
BEMS
 Dashboard at https://localhost:8443/dashboard. By default, the
BEMS
 Dashboard locks after 30 minutes of inactivity.
Complete the
BEMS
 configuration in the
BEMS
 dashboard.