Install the BEMS software

BEMS installations are supported only on English implementations of the operating system.
  • Verify that you completed the preinstallation and prerequisite requirements.
  • 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.
    Note: 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 Setting up a Windows service account for BEMS. 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 the Microsoft resource 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 the Microsoft resource 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 the Microsoft resource 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 Next steps to configure BEMS.