Unity UAI Server Installation and Configuration

From Galen Healthcare Solutions - Allscripts TouchWorks EHR Wiki
Jump to navigation Jump to search


Allscripts provides a mechanism known as "Unity" or "UAI" for external products and devices, such as Allscripts Remote and vital signs monitors, to connect to an Enterprise EHR environment. This document covers the installation and configuration of the server-side components of Unity/UAI.

Target Audience: Systems and Network Administrators of Enterprise EHR servers

This is advanced technical documentation. Do not perform these steps on production servers during business hours. Always evaluate server changes in a test environment prior to making changes to production servers. Contact your Allscripts support representative or Galen technician if you are uncomfortable with this material.


There are 2 necessary components for Unity/UAI:

  • Server installer, which is run on the Enterprise EHR web server(s)
  • Client installer, also known as UAI DesktopAgent, which is installed on end user PCs or terminal servers
    • Alternative clients: Allscripts Wand (iPad), Allscripts Remote (iPhone/Android), Unity or UAI compliant third party applications

Allscripts provides access to Unity installers and documentation at https://clientconnect.allscripts.com. Please create a ClientConnect account if you have not already.


Installation of the Unity server components is straightforward. The Unity server installer will need to be run on each web server in an Enterprise EHR environment.

The Unity server installer can be downloaded from: https://clientconnect.allscripts.com/docs/DOC-9978

To install the Unity server components, follow the Allscripts documentation at: https://clientconnect.allscripts.com/docs/DOC-9979


In most situations, the Unity server installer will handle all necessary configuration. However, in some instances it has been found necessary to review and correct the IIS (Internet Information Services) settings on the web servers, particularly if the web servers have been cloned. The detailed IIS settings can be found below.

Ensure that you have thoroughly tested all functionality of the external applications which are using Unity/UAI, especially after Unity/UAI server updates have been applied, and also during Enterprise EHR upgrade projects. Successfully completing the above installation documentation does not guarantee that all aspects of the external application will properly function.

The below IIS configuration was written for IIS 7/Server 2008, however it should also apply for IIS 6/Server 2003.

  1. IIS Manager > Default Web Site > Authentication Settings
    • Make sure that Anonymous Authentication is enabled and NOT using a named service account
    • Make sure that all other authentication methods are Disabled
  2. IIS Manager > Default Web Site > UAIWebService > Authentication Settings
    • Enable ASP.NET Impersonation
    • Under ASP.NET Impersonation, choose specific user, and enter service account credentials
  3. IIS Manager > Default Web Site > UAIWebService > Application Settings
    • Make sure CEDURL is pointing to your local web server not to a load balancer.
    • Make sure Connection string has the correct DB server and username, password and DB are correct
    • Make sure that ScanSQLConn is pointed to the right DB server, Catalog and has correct username and password
    • Check to make sure the C:\temp\UAI exists on that server, create it if it does not exist.
  4. IIS Manager > Default Web Site > UAIWebService > v2.0 > Application Settings
    • Repeat above steps
    • Note, you may have issues as there often is a malformed line in web.config. In those cases just go to the web.config file at C:\Program Files\Allscripts Healthcare Solutions\UAI\UAIWebService\v2.0\ to check for ced, db and scansql settings
  5. IIS Manager > Application Pools
    • Restart the UAI application pool