Install the BEMS software Skip Navigation

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.