EMS Room Sign App Installation

The EMS Room Sign App was formerly named EMS Glance. Some of the installation files (e.g., API, dll, etc.) will temporarily retain the Glance name. 

In Update 30, the Room Sign App API was moved into the EMS Room Sign application to improve performance. The EMSGlanceAPI.msi file is no longer required for customers running Update 30 or later.

The EMS Room Sign App 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 Room Sign App.

ClosedInstall the EMS Room Sign web application

To install the EMS Room Sign app:

  1. Download the EMSGlance.msi file onto the web server that will be running the EMS Room Sign App web application.

  2. Run EMSGlance.msi.

    The EMS Room Sign App Setup Wizard opens. 

  3. Click Next

    The Destination Folder page opens.

  4. Select the destination folder. 

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

  5. Click Next.

    Do not install the EMS Room Sign App in the same physical directory as other EMS web-based products OR under a site running another version of EMS Room Sign App.

  6. Based on your software version, do the following: 

    • Prior to Update 30

      1. When the EMS Room Sign App API Path page appears, enter the URL of your EMS Room Sign App API Web Service.

        Example: http://[ServerName]/EMSGlanceAPI/service.asmx
        (replace [ServerName] with the name of your web server)

      2. Click Next.

    • Update 30 or Later

      1. When the EMS SQL Server Database Settings page opens, enter your EMS SQL Server name and your EMS Database name in the appropriate fields.

      2. Click Next.

    The Virtual Directory information page opens. The Virtual Directory Name defaults to the destination folder specified in Step 4. 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 (“EMSRoomSignApp” in the example above.) 

  7. Click Next.

    The Ready to install EMS Room Sign App page opens.

  8. Click Install.

    The Completed the EMS Room Sign App Setup Wizard page opens. 

  9. Click Finish

ClosedInstall or upgrade the EMS Room Sign App DLL

To install or upgrade the EMS Room Sign App DLL:

On each client machine that needs access to the EMS Room Sign App Settings area, complete the following based on whether the install is local or web deploy: 

  • Local Install – paste a copy of the EMS.Glance.dll file into the folder that contains your EMS application files (typically C:\Program Files\EMS).

  • Web Deploy Install – enter the EMS.Glance.dll in the following location: 
    C:\Users\<username>\AppData\Roaming\EMS2016\Extensions

Once the EMS.Glance.dll is placed in the correct folder on the client machine (assuming your organization is appropriately licensed for the EMS Room Sign App), the EMS user will see the EMS Glance Settings button on the tool bar within the EMS application.

To update your registration, obtain a new license file and import into the EMS Desktop Client. Select System Administration > Settings Registration.

ClosedSet a launch pin

To set a launch pin:

  1. Open a browser and enter the URL to your EMS Room Sign App web application.

  2. If this is your first time accessing the site, select a profile and room.

    Each individual profile can be protected with a passcode. The first landing page does not have a passcode set by default.

  3. Modify the web.config file to set a Launch Pin.

    Setting this value (which is blank by default), will force users to enter a code the first time they browse to the EMS Room Sign site. To set the Launch Pin key in the web.config file, do the following:

    1. Navigate to the Room Sign App web directory.

    2. Open the web.config file for editing.

    3. In the web.config file, locate key="LaunchPin" and enter a value for the Launch Pin key.

    4. Save the web.config file.

ClosedRegister EMS Room Sign App on your devices

The EMS Room Sign App is ready to use once all of the components have been properly installed and at least one Profile has been configured for use (Refer Configure the EMS Room Sign App).

Each EMS Room Sign device is tied to one specific room in EMS. Therefore, each room you register to a device will count against your available licenses. If you get an error about exceeding your license count, you will need to deregister unused devices to free up licenses.

To register the EMS Room Sign App on your device:

  1. Ensure that you have configured the profile that you want to associate with the device.

  2. On your device, open a browser and enter the URL to your EMS Room Sign App web application:

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

    The first time you access the EMS Room Sign App on your device, the Settings page opens.

  3. In Profile, select the profile .

  4. In Room, select the room .

  5. Click Apply.

Once the EMS Room Sign App is running, to re-access the Settings page for any reason, double-tap the EMS Room Sign App logo.

ClosedDeregister EMS Room Sign App on your devices

Each EMS Room Sign device is tied to one specific room in EMS. Therefore, each room you associate with a device counts against your available licenses. If you get an error about exceeding your license count, you will need to deregister unused devices to free up licenses.

For Update 28 or earlier, you should deregister devices before you delete a profile or before you delete a room from a profile. EMS Desktop Client does not automatically deregister devices when you delete a profile or room. If you have already deleted a profile or room and you did not first deregister the devices, you will not be able to deregister the devices through the Deregister Device window. You will need to access the database to remove the devices and free up licenses.

For Update 29 or later, when you delete a profile, or when you delete a room from a profile, the software automatically deregisters the devices associated with the profiles or rooms.

If you are not using the latest version of EMS Room Sign App, you might need to refer to one of the sections below for additional instructions.

To deregister devices and free up licenses in EMS Desktop Client: 

  1. On the EMS Desktop Client toolbar, click EMS Glance Settings.

  2. In the EMS Glance window, select Deregister Device and click Open.

    The Deregister Device window opens.

  3. In Profile, select the profile associated with the device you want to deregister.

  4. From the list of rooms, select the room associated with the device you want to deregister.

  5. Click Deregister.
  1. In the Deregister Device confirmation window, click Yes.

    A success message appears.

  2. Repeat steps 3 through 6 to deregister additional devices.

  3. Click Close.

ClosedInstall EMS Room Sign App for Update 33

To install EMS Room Sign app for Update 33:

  1. Run the EMSGlance 18.10.24.2.msi setup file.

    The EMS Room Sign App Setup wizard opens.

  2. Click Next.

  3. On the Destination Folder selection window, keep the default selection and click Next.

  4. In the EMS application, click the Configuration menu item.

  5. In Configuration, select Room Sign.

ClosedInstall EMS Room Sign App for Update 32 and older versions

To install or upgrade the EMS Room Sign App:

If you are upgrading to Update 30 or later, make sure you uninstall the API prior to upgrading. In Update 30, the EMS Room Sign API was moved into the application, and you no longer need to install the API separately.

  1. For Update 31 or earlier, install the EMS Room Sign App .sql file.

    If you are on Update 32, do NOT install EMSRoomSignApp.sql. If you do install the .sql file, you will need to re-install the EMS patch.

  2. Copy the EMS Room Sign App .dll file to each user workstation that needs EMS Room Sign App options in EMS Desktop Client.

  3. For Update 29 or earlier, install the new EMS Room Sign App API on the web server that will be running it, and verify the installation.

  4. Install the new EMS Room Sign App web application on the web server that will be hosting it (and connect it to your EMS Room Sign App API, SQL server, and database).

    For Update 30 or later, the EMS Room Sign API has been moved into the application. If you are running Update 30 or later, you will not need to connect the API to the web application.

  5. For Update 31 or earlier, create an Admin User to manage the EMS Room Sign App API web service.

  6. Access your EMS Room Sign application through the web on your device(s).

ClosedInstall or upgrade the database component (Update 31 or earlier)

To install the database component:

  1. Obtain the EMSRoomSignApp.sql file.

  2. Open Microsoft SQL Server Management Studio.

  3. Within Microsoft SQL Server Management Studio, select File > Open > File… and locate EMSRoomSignApp.sql.

  4. Select your EMS Database and execute the query (Query > Execute). 

    When query execution has completed, a success message appears in the Results section.

ClosedCreate an EMS admin user to manage your EMS Room Sign App API web service (Update 31 or earlier)

ClosedInstall or upgrade the EMS Room Sign App API (Update 29 or earlier)

To install the EMS Room Sign App API:

  1. Manually uninstall any previous versions of the API on your web server. 

  2. Download the EMSGlanceAPI.msi file onto the web server that will be running the API.

  3. Run EMSGlanceAPI.msi.

    The EMS Room Sign App API Web Service Setup Wizard opens.

  4. Click Next.

    The Destination Folder opens.

  5. Select the destination folder.

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

  6. Click Next.

    The EMS SQL Server Database Settings information page opens.

    The API should not be installed in the same physical directory as other EMS web-based products OR under a site running another version of the API.

  7. Enter your EMS SQL Server name.

  8. Enter your EMS Database name:

    • EMS Professional customers (typically named “EMSData”).

    • EMS Workplace, EMS Campus, EMS Enterprise, EMS District and EMS Legal customers (typically named “EMS”).

  9. Click Next.

    The Virtual Directory information page appears.

    The Virtual Directory Name will default to the destination folder specified above. It is recommended that you keep the default setting. The installation process will create a virtual directory on your web server based on the virtual directory entered (“EMSRoomSignApp” in the example above.) 

  10. Click Next.

    The Ready to install EMS Room Sign App API Web Service opens. 

  11. Click Install.

    The Completed the EMS Room Sign App API Web Service Setup Wizard opens. 

  12. Click Finish.

ClosedVerify the EMS Room Sign App API installation (Update 29 or earlier)

For Update 30 or later, you do not need to verify the EMS Room Sign API installation because the API has been moved into the EMS Room Sign application and no longer needs to be installed separately.

After following the steps above, verify your API installation by opening a browser and entering the API URL:

Example: http://[ServerName]/EMSGlanceAPI/service.asmx

(replace [ServerName] with the name of your web server)

This URL will be required for the EMS Room Sign App Web Application installation.

ClosedRemove unused devices from the database—Exceeds Licenses error (Update 28 or earlier)

For Update 28 or earlier, if you delete a profile, or rooms from a profile, without first deregistering the devices, you can get an Exceeds Licenses error even though you are not using all your licenses. When you register a device, the software builds an ID based on the profile and room that you associate with the device and stores the ID in the database to track your license use. When you delete profiles or rooms without first deregistering the devices, the IDs are not removed from the database and continue to count against your available licenses.

If you have already deleted a profile or room without first deregistering the devices, you will need to access the database to remove the IDs associated with these devices as follows:

Use the following SQL statement to verify how many registered rooms you have before and after you remove rooms from the database: 

SELECT COUNT(UDID) AS RegisteredRooms FROM sDigitalRoomSignLimit

  1. In the EMS database, access the sDigitalRoomSignLimit table.

  2. Use the Room ID to locate each unused device, and then remove the entire row for each unused device from the table.

For Update 29 or later, when you delete a profile, or when you delete a room from a profile, the software automatically deregisters the devices associated with the profile/rooms and frees up the licenses. You do not need to remove the devices from the database.