EMS for Google Calendar Installation Guide for on premise deployments

EMS for Google Calendar is a Google Chrome Extension that allows users to view and book spaces in EMS from within Google Calendar’s web interface.

This Installation Guide will provide the following information on installing EMS for Google Calendar. For successful installation, administrators will need to:

Prerequisites and Requirements

Important!

EMS for Google Calendar is managed through EMS Platform Services (Update 31 or later). Additionally, on-premise customers must enable NSQ Messaging Type for EMS Platform Services (Cloud Services will enable NSQ for Cloud customers).

Requirements for EMS Platform Services

Operating System	IIS
Windows Server 2012	8
Windows Server 2012 R2	8.5
.NET Framework	4.6.1
Application Pool	4.0
Prerequisites
ASP.NET Core	See Also: Installing ASP.NET Core.
PowerShell	5+ Version
ASP.NET Version 4.6	Under Web Server (IIS) > Web Server > Application Development: ISAPI Extensions ISAPI Filters .NET Extensibility 4.6 Web Socket Protocol

EMS Web Server Requirements

Operating System	IIS VERSION
Windows Server 2016	10.0
Windows Server 2012	8.0
Windows Server 2012 R2	8.5
Windows Server 2016

Licensing

EMS for Google Calendar license is required. Please contact your EMS Account Representative.

Authorizing domains / URLs for subscribing to events from G Suite

This step will allow EMS Platform Services to use web hooks to subscribe to changes to your Google Calendar room mailboxes without waiting for a polling interval – the user impact is that actions like drag and drop from the users’ calendars or edits from mobile devices will be synchronized back to EMS very quickly, usually within seconds (for meetings reserved using EMS Web App or Mobile app with G Suite integration enabled or EMS for Google Calendar)

To authorize domains/URLs for subscribing to events from G Suite, follow these steps:

Go to the following link: https://console.developers.google.com/apis/credentials/domainverification
Make sure you have your EMS Integration GCP project selected (In the example below 'EMS Develop' is selected)
Click the Add domain button.
Enter your EMS Domain, example: 'my-ems-subdomain.myorganization.com'.
Click ADD DOMAIN.
On the verify ownership dialog, click TAKE ME THERE.
In the domain name provider dropdown menu, choose Other.
Click the Add a CNAME record link.
Use the CNAME Label / Host as well as the CNAME Destination / Target to update your DNS configuration for your EMS domain (example: 'my-ems-subdomain.myorganization.com') – see this link for more information https://support.google.com/a/answer/47283?hl=en
Once the DNS configuration has been updated, you can click the VERIFY button. (Note, if you end up away from this page, you can follow the steps again and it will produce the same records)

Enable G Suite to EMS synchronization

The Integration to Google G Suite parameter should be set to ‘yes’. This can be found by logging in as an administrator to the EMS Desktop Client and navigating to System Administration > Settings > Parameters > Desktop Client tab.

Whitelist the EMS for Google Calendar OAuth Client ID

For some organizations, it may be required to whitelist the OAuth Client ID for your G Suite domain. Please contact your G Suite administrator.

EMS for Google Calendar OAuth Client ID:

317959924954-mels609gce2f9f4onhti7r09gubka3fs.apps.googleusercontent.com

Deploy EMS for Google Calendar

Note that the Platform Services URL must be shared with users for them to add to the extension, and that users must have Chrome sync enabled for their account that corresponds with their EMS Everyday User account (email addresses must match).

Note:

For organizations that restrict access to Chrome Extensions, a G Suite Administrator will need to perform the following steps in the G Suite Admin Console:

Navigate to Devices > Chrome Management > App Management.
Search for EMS for Google Calendar.
Enable Allow Installation so users can perform the installation themselves. (EMS Software recommends this while testing.)

Optionally, choosing Force Installation will enable the Extension for all users in the G Suite environment (once you are ready to enable for production).

To enable EMS for Google Calendar as an individual user, follow these steps:

Navigate to the Chrome Web Store.
Search for EMS for Google Calendar.
Add to your browser.

You will be prompted that the extension will access your account.
Click Allow.
Enter the EMS Platform Services URL.