Installation Instructions

The installation and updating information in this topic do 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 the 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 contains your reservation data.

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

  1. Verify the prerequisite software is installed.

  2. Secure the EMS.ServerInstall.exe file.

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

  4. In Server, 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 must specify a user name and password.

  7. Click Execute.

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

  9. Click OK when you receive the Database Installed Successfully! message. 
    You can now install the software to client computers.

ClosedCreate an EMS SQL Database User and Connect to Applications

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

  1. Secure the Ems.EnvironmentUtil.App.msi file.

  2. Run Ems.EnvironmentUtil.App.msi as an Administrator.
    The .exe file can be run from any computer that has access to your database server.

  3. From the Installation Directory, run the EmsEnvironmentConfigTool application.

  4. Enter the EMS Database Username and Password.
    The credentials are stored in the System Environment Variables to be used by the applications.

  5. If Create User in Database is selected, enter the SQL server name in Server and EMS database name in Database.
    This only needs to be done once per database.

  6. Select SQL Server Authentication Mode to use a SQL SysAdmin account.

  7. Repeat Steps 1 through 4 for each EMS web server.

ClosedInstall EMS on user computers

After your EMS database is created on your database server, you must install the client software on each computer that accesses your EMS database, using one of the following methods:

ClosedInstall EMS Desktop Client Web Deployment

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

  2. Verify 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.

  5. Click Next

  6. Select the destination folder. 

    The installation process creates a new physical directory on your web server based on the destination folder path entered, for example, EMS Desktop Web Deploy.

  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

    The Virtual Directory Name defaults to the destination folder specified in Step 6. We recommend that you keep the default setting.

  9. Click Next.
    EMS Desktop Client Web Deployment must 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. Click Ready to install to install The EMS Desktop Client Web Deployment.

  11. Click Finish.  

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

    http://[ServerName]/EMSDesktopWebDeploy/
    You must 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 changes the line to <endpoint address="../AppFacadeService.svc" binding="webHttpBinding" bindingConfiguration="webHttpsBinding" contract="EMS.AppFacade.IAppFacadeService" behaviorConfiguration="webBehavior" /> and enables 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)

  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 EMSApplication.exe.

    If it asks for the EMS Web Deploy configuration URL, enter the EMS Desktop Client Web Deployment URL: http://[ServerName]/EMSDesktopWebDeploy/
    You must replace [ServerName] with the name of your web server.

    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.

  4. Click OK

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

    You only need to import your license key one time.

  6. On the EMS sign in page, type admin as both the User ID and the Password.

  7. 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)

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, that is, to the Desktop Client API, or directly to the EMS Database.

  2. Obtain the required MSI file.

  3. Sign in to the EMS Product Portal.

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

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 prompts 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 does not prompt the user for this information again. If upgrading from a previous version, the desktop client searches 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. That is ems.exe. You can use these within a shortcut 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 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

  1. Verify the prerequisite software is installed.

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

  3. Run EMSClient.msi on the client workstation and 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.

  7. Click OK

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

    Your license key only needs to be imported once.

  9. On the EMS sign in page, type admin as both the User ID and the Password.

  10. Click OK.

  11. 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 through 6.

ClosedObtain Installation Files for EMS Desktop Client

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

  1. Sign in to Accruent Access.

  2. Click My Products.

  3. Under EMS, click Downloads.

  4. In the Software Downloads area, click the link for your software version.

  1. Download the following files. These are 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 that is 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 that is an optional system component. See Installing the EMS Campus Auto Sync Service.

 

(missing or bad snippet)