Install EMS Platform Services

Important!

As of Update 28, deploy EMS Platform Services with ASP.NET Handler, instead of HTTP Platform Handler.

Learn more about:

ClosedInstall Platform Services

Verify the System Requirements and install the Prerequisites prior to installing EMS Platform Services.

To install platform services:

  1. Log into Accruent Access.

  2. Click My Products.

  3. Under EMS, click Downloads.

  4. In the Software Downloads area, click the link for your software version, for example, V44.1 Releases & Patches.

  1. Download EMSPlatformServices.msi. (Required for all installations.) 

    The EMS Platform Services Setup Wizard appears.

  2. Click Next.
  3. Select a default folder. By default, the Platform installer installs in the Programs folder. You can change the path to wwwroot folder. The typical install path is C:\Program Files\EMS Software, LLC\EmsPlatformApi\.

  4. Click Next
  5. Enter the SQL server and EMS database, configured to allow external connections. Make a note of the database name. 

    To use an Active Directory account instead of the EMS User for database authentication, select Use Windows Authentication for Database Connection.

    If you are unsure of the SQL server and EMS database name, you can find the SQL server and EMS database name in the EMS Web App (Admin Functions > Connection String values under the version number heading) or EMS Desktop Client (File > Change Database > Provide Server Parameters dialog). You can also contact your company's IT group to locate the information.

  6. Enter a Virtual Directory Name.

  7. To enable NTLM authentication for Everyday User Authentication for the Platform Services Admin Portal and Integration Clients, select Enable NTLM For EMS Everyday User Authentication

    To use NTLM authentication when logging into the EMS Platform Services Admin Portal, you must select the Enable NTLM For EMS Everyday User Authentication box. If you complete the installation process without selecting the Enable NTLM For EMS Everyday User Authentication box and you want to use NTLM authentication, you will need to re-install the EMS Platform Services software and select the checkbox during install.

  8. To complete the installation, click Install.

    An installation complete prompt appears.

  9. Click Finish

  10. If you enabled NTLM authentication through the Enable NTLM For EMS Everyday User Authentication box during installation, verify the NTLM authentication.

ClosedInstall a Multiple Instance of EMS Platform Services in the IIS

Before you install a multiple instance, first install one instance of EMS Platform services.

To install a multiple instance of EMS Platform Services:

  1. Copy the installed directory for each additional instance of EMS Platform Services.

    Copy of Installed Directory of EMS Platform Services

  2. From your Internet Information Services (IIS) Manager, right-click and select Add Application.

    In the Add Application dialog, in Alias, choose a unique name. In Physical Path, include the path of the copied folder.

    Adding a Multiple Instance of EMS Platform Services in IIS

  3. Click OK.

  4. Navigate to your default.json file (or web.config override file). Edit the urlPrefix setting to match the unique name of the instance in the IIS.

    Editing the urlPrefix in the default.json File of the Multiple Instance

  5. Reset the IIS.

ClosedVerify Installation Status

  1. Access your URL for Platform Services (e.g., https://yourcompany.com/EMSPlatform).

  2. To verify the status of your installation navigate to https://yourcompany.com/EMSPlatform/status.

    Status Screen for EMS Platform Services

ClosedVerify NTLM Authentication

To use NTLM authentication when logging into the EMS Platform Services Admin Portal, you need to have selected the Enable NTLM For EMS Everyday User Authentication checkbox during the installation process.

If you completed the installation process without selecting the Enable NTLM For EMS Everyday User Authentication box and you want to use NTLM authentication, you will need to re-install the EMS Platform Services software and select the checkbox during install.

  1. Verify that Windows Authentication is enabled from your Internet Information Services (IIS) Manager.

    Windows Authentication Enabled in IIS Manager

  2. Navigate to the EMS Platform Services Admin Portal (e.g., https://yourcompany.com/EMSPlatform/admin).

  3. Verify that the Windows Security dialog appears.

    Verifying Windows Security Screen When Logging into the Admin Portal

  4. Enter the Everyday User's username and password.

ClosedUpgrade EMS Platform Services Software

Before you upgrade EMS Platform Services, you must uninstall it.

To upgrade EMS Platform Services: 

  1. To uninstall EMS Platform Services, navigate to Windows Control Panel > Programs > Uninstall a Program.

  2. To download the latest EMS Platform Services release, go to Accruent Access > My Products > EMS Downloads > (Release) Releases & Patches.

  3. To reinstall EMS Platform services, complete the steps in Install Platform Services.

    If multiple instances of the EMS Platform Services software exist in IIS, delete the instances from the Windows directory and from IIS. Install the multiple instances again after you upgrade the EMS Platform Services software.