Installation Instructions

The installation and updating information in this topic does not apply to EMS Cloud Services customers. Learn more about the installation and updating of EMS software with Cloud Services.

To install EMS, perform two operations:

  1. Preparation – install server components.   

  2. Install the application on user's computers. 

Learn about EMS Desktop Client Deployment Options.

ClosedInstall EMS Server Components

The server installation process creates two EMS databases on your MS SQL Server: 

  • EMS_Master database that contains licensing information.
  • A separate EMS database that will contain your reservations data.

To execute the database installation process, you must have a Microsoft SQL Server SA level account.

To install EMS server components:

  1. Verify that the prerequisite software has been installed.

  2. Secure the EMS.ServerInstall.exe file.

  3. Run EMS.ServerInstall.exe as an Administrator. (This .exe can be run from any PC that has access to your database server.)

  4. In the Server field, enter the name of the server running MS SQL Server.

  5. In Database, enter your EMS database name. 

    We recommend that you accept the default EMS value.

  6. In the Server Authentication area, specify your MS SQL Server authentication credentials.

    If SQL Server Authentication Mode is selected, you will be required to specify a user name and password.

  7. Click Execute.

    A Create Database dialog opens.

  8. To initiate the EMS database installation process, click Yes.

    The time spent on the “Upgrading database…” phase in the installation process depends on the size of your database.  Please be patient.

  9. Click OK when you receive the Database Installed Successfully! message. 

You have completed installing the server portion of EMS. Next you will install the software to client computers.

ClosedInstall EMS on user computers

After your EMS databases have been created on your database server, you must install the client software on each computer that will access your EMS database, using one of the following methods:

ClosedInstall EMS Desktop Client Web Deployment

To install the EMS Desktop Client web deployment:

  1. Manually uninstall any previous versions of EMS Desktop Client Web Deployment on your web server.  

  2. Verify that the prerequisite software is installed.

  3. Download the EMSDesktopWebDeploySetup.msi file onto the web server that will be running the EMS Desktop Client Web Deployment.

  4. Run EMSDesktopWebDeploySetup.msi as an administrator.

    The first page welcomes you to the EMS Desktop Client Web Deployment Setup wizard. 

  5. Click Next

    The Destination Folder page appears.

  6. Select the destination folder. 

    The installation process will create a new physical directory on your web server based on the destination folder path entered (“EMS Desktop Web Deploy” in the example above.).

  7. Enter your SQL Instance Name.

  8. Enter your Database Name:

    • EMS Professional customers – typically named  “EMSdata”

    • EMS Workplace, EMS Campus, EMS Enterprise, EMS District and EMS Legal customers – typically named  “EMS”

  9. The Virtual Directory Name will default to the destination folder specified in Step 6. We recommend that you keep the default setting.  The installation process will create a virtual directory on your web server based on the virtual directory entered (“EMS Desktop Web Deploy” in the example above.)  Click Next.

    The EMS Desktop Client Web Deployment should not be installed in the same virtual directory as other EMS web-based products OR under a site running another version of the EMS Desktop Client Web Deployment.

  10. The Ready to install the EMS Desktop Client Web Deployment page appears.  Click to install The EMS Desktop Client Web Deployment.

  11. The Completed the EMS Desktop Client Web Deployment Setup Wizard page will appear.  Click Finish.  

  12. To verify your EMS Desktop Client Web Deployment installation, open a browser and enter the address:

    http://[ServerName]/EMSDesktopWebDeploy/ (replace [ServerName] with the name of your web server)

  13. Open the application's web.config file from the installation folder.

  14. In the web.config file, change the bindingConfiguration="webBinding" to bindingConfiguration="webHttpsBinding" in the line <endpoint address="../AppFacadeService.svc" binding="webHttpBinding" bindingConfiguration="webBinding" contract="EMS.AppFacade.IAppFacadeService" behaviorConfiguration="webBehavior"/>

    This edit will change the line to <endpoint address="../AppFacadeService.svc" binding="webHttpBinding" bindingConfiguration="webHttpsBinding" contract="EMS.AppFacade.IAppFacadeService" behaviorConfiguration="webBehavior" /> and thus enable HTTPS.

The first time you launch the EMS Desktop Client Web Deployment, it might take a few extra moments for the website to display. If you encounter issues, contact Customer Support for assistance.

ClosedInstall EMS Desktop Client (Web Deployment Method)

To install the EMS Desktop Client using the web deployment method:

  1. Access the URL from the EMS Desktop Client Web Deployment.

  2. On the EMS Desktop Client Installation Instructions window, click the Download and Install the EMS Desktop Client link.

    If your browser has a pop-up blocker, disable it to download the EMSApplication.exe and configuration files.

  3. Run the EMSApplication.exe.

    This will install the client locally from the service. If it asks for the EMS Web Deploy configuration URL it requires entering the EMS Desktop Client Web Deployment URL:

    http://[ServerName]/EMSDesktopWebDeploy/  (replace [ServerName] with the name of your web server)

  4. The EMS icon gets placed on the users desktop.

    When a user launches the client, it checks the EMS Desktop Client Web Deployment for a new version of the client. Clients installed through the EMS Desktop Client Web Deployment do not require administrative permission to install.

  5. The system displays a message asking you to import your registration information. Click OK

  6. The Registration page opens. 

    To import your EMS license key, follow the instructions on the page.

    You only need to import your license key one time.

  7. At the EMS log in page, type admin as both the User ID and the Password.

  8. Click OK.

    When an EMS Client is installed through the EMS Desktop Client Web Deployment it can only connect to the EMS instance received from the service.

ClosedInstall EMS Desktop Client (Conventional Method)

Follow these instructions to conventionally install the EMS Desktop Client on individual workstations.

Pre-Installation Instructions

  1. Enable the Windows Component .NET 4.5 on the client machine.

    The client must also have access to the EMS Server component (to the Desktop Client API, or directly to the EMS Database).

  2. Obtain the Required MSI file (refer Obtain Installation Files for EMS Desktop Client section below).

  3. Log in to the EMS Product Portal.

  4. Navigate to the Software & Documents LibraryNew Releases and PatchesEMS Desktop Clients (Conventional and Web Deploy).

    The EMS Desktop Clients (Conventional and Web Deploy) page displays.

When you install, the application loads into the "Program Files",  "Program Files (x86)", (or a custom directory that you specify). The first time the application is run by a user it will prompt the user to enter in the Server and Database. These entries are saved in the user's registry. The next time the application is accessed, it will not prompt the user for this information again. If upgrading from a previous version, the desktop client will search for the connection string from the previous version, and update the current version so the user is not prompted to enter that information.

Set the Server Programmatically

Option 1: Set the registry keys for the user

The Server and Database information are stored in Keys in the following location:

32bit Machines: HKEY_CURRENT_USER\Software\EMS Software\Version44.1

There will be two string values—one for the server and one for the database.

Option 2: Use switches in the executable

There are two switches that can be used with the applications executable (ems.exe). You can use these within a shortcut that you give to the user to specify the Server and Database for them.

/s=Servername.domain.local
/d​=DatabaseName

Replace "Servername.domain.local" with the Domain name of your Database Server and DatabaseName with the Database of the Database of EMS that the user needs to connect to.

For Example: C:\Program Files(x86)\EMS\EMS.exe /s=Servername.Domain.local /d=DatabaseName

Establish Network Connections

The conventional EMS Desktop Client connects directly to the database server for all related transactions. The EMS Desktop Client might also need to connect to the following services:

  • EMS Web Server

  • SMTP Server

  • LDAP Server

To establish network connections:

  1. Verify that the prerequisite software has been installed.

  2. Secure the EMSClient.msi. (See Obtain Installation Files for EMS Desktop Client below.)

  3. Run EMSClient.msi on the client workstation. Follow the on-page prompts. We recommend that you accept the defaults.

  4. Start EMS from the shortcut located on your desktop.

  5. In the Provide Server Parameters dialog, enter the name of your EMS Server and Database.

  6. Click OK.

    The system displays a message asking you to import your registration information.

  7. Click OK

    The Registration page opens. 

  8. Follow the instructions outlined on the page to import your EMS license key.

    Your license key only needs to be imported once.

  9. At the EMS login page, type admin as both the User ID and the Password.

  10. Click OK.

  11. You are now ready to begin using the system. You can begin defining your data following the instructions in Setting Up EMS or you can install to additional client computers by repeating steps 1-6 above.

ClosedObtain Installation Files for EMS Desktop Client

Download the latest release of EMS from the online Support Center.

  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 the following files. (Required for both first time installations and upgrades.)

    •  EMS License (License.lic) – License file required to activate your EMS software.

    •  EMS Server Install (EMS.ServerInstall.exe) – File used to install or upgrade the EMS databases on your Microsoft SQL Server.

    •  EMS Client (EMSClient.msi) – File used to install or upgrade the EMS desktop application.

    • EMS Email Notification (EMSEmailNotificationSetup.msi) – File used to install the EMS Email Notification service (an optional system component.) See Installing the EMS Email Notification Service. 

    • EMS Campus Auto Sync Service (EMSCampusAutoSyncSetup.msi) – EMS Campus only. File used to install the optional EMS Campus Auto Sync Service (an optional system component.) See Installing the EMS Campus Auto Sync Service.