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

Install the
BEMS
 software

BEMS
 installations are supported only on English implementations of the operating system.
  • If your organization uses AlwaysOn support for
    SQL Server
    , complete the steps in Appendix: AlwaysOn Availability support for SQL Server and verify 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.
  • By default, encrypt=false is prepopulated in the Additional properties, so data between
    BEMS
     and the
    SQL Server
     is not encrypted. 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 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, 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. Click
    Next
    .
  6. Accept the license agreement and click
    Next
    .
  7. In the
    Services
     dialog box, select the services you want to install. Click
    Next
    .
  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 name.
  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 Set an environment variable for the Java location. Click
    Next
    .
  14. In the
    Database Information
     dialog box, perform the following actions:
    1. Specify the
      Microsoft SQL Server
       connection information for the
      BEMS-Core
       service database. This content prepopulates the BEMS-Core database screen (
      BEMS
       System Settings > Database) in the Dashboard. For more information, see BEMS-Core database.
      Field
      Description
      Host
      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 Express or
      SQL Server
       using a SQL Instance name: <
      server name
      >\<
      database instance name
      >.
      If your environment uses AlwaysOn enter the FQDN of the AlwaysOn Listener.
      Database name
      Type the name for the
      BEMS-Core
       database. For information on database names based on the configuration of your environment, see Create the BEMS services databases.
      If your environment uses AlwaysOn enter the name of the database that is added to the AlwaysOn Availability Group
      Port
      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
      Authentication Type
      Specify the
      SQL Server
       connection information for the
      BEMS-Connect
       service database and enter the
      BEMS
       service account login credentials under which the
      BEMS
      -
      Connect
      Windows
       service run.
      Additional Properties
      Optional. 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
      .
    2. Enter the
      BEMS
       service account login credentials under which the
      BEMS-Connect
      Windows
       service will run.
    3. Specify the
      SQL Server
       connection information for the
      BEMS-Connect
       service database.
      Field
      Description
      Host
      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 Express or
      SQL Server
       using a SQL Instance name: <
      server name
      >\<
      database instance name
      >.
      If your environment uses AlwaysOn enter the FQDN of the AlwaysOn Listener.
      Database name
      Type the name for the
      BEMS-Connect
       database. For information on database names based on the configuration of your environment, see Create the BEMS services databases.
      If your environment uses AlwaysOn enter the name of the database that is added to the AlwaysOn Availability Group
      Port
      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.
      Authentication Type
      Specify the
      SQL Server
       connection information for the
      BEMS-Connect
       service database and enter the
      BEMS
       service account login credentials under which the
      BEMS
      -
      Connect
      Windows
       service run.
      Additional Properties
      Optional. 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
      .
    4. Enter the
      BEMS
       service account login credentials under which the
      BEMS-Presence
      Windows
       service run. Note that a database is not required for the Presence service if all of the
      BEMS
       services are installed on one computer. For more information, see Create the BEMS services databases.
    5. Specify the
      SQL Server
       connection information for the
      BEMS-Docs
       service database.
      Field
      Description
      Host
      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 Express or
      SQL Server
       using a SQL Instance name: <
      server name
      >\<
      database instance name
      >.
      If your environment uses AlwaysOn enter the FQDN of the AlwaysOn Listener.
      Database name
      Type the name for the
      BEMS-Docs
       database. For information on database names based on the configuration of your environment, see Create the BEMS services databases.
      If your environment uses AlwaysOn enter the name of the database that is added to the AlwaysOn Availability Group
      Port
      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.
      Authentication Type
      Specify the
      SQL Server
       connection information for the
      BEMS-Docs
       service database and enter the
      BEMS
       service account login credentials under which the
      BEMS
      -
      Connect
      Windows
       service run.
      Additional Properties
      Optional. 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
      .
  15. In the
    Pre-installation Summary
     dialog box, click
    Install
    .
  16. In the
    Installing
     dialog box, click
    Next
     when the installation of a
    BEMS
     service is complete.
  17. In the
    Install Complete
     dialog box, click
    Done
    .
  18. In a browser, open the
    BEMS
     Dashboard at https://localhost:8443/dashboard.
Complete the component configuration in the Dashboard. For information, see Configuring the BEMS services.