User's Guide

CareFit Pro Imprivata Agent Software
for CareFit Pro Monitor Cart, Powered

For the latest User Installation Guide please visit: www.ergotron.com

www.ergotron.com | USA: 1-800-888-8458 | Europe: +31 (0)33-45 45 600 | China: 400-120-3051 | Japan: japansupport@ergotron.com
888-98-194-G-00 rev. A • 04/21

www.ergotron.com

www.ergotron.com

www.ergotron.com

1 of 16

Table of Contents

1 Overview.................................................................................................................3
1.1 Components.....................................................................................................3
1.2 Supported Operating Systems.........................................................................3
1.3 Requirements...................................................................................................32 Installation..............................................................................................................32.1 Installation Files................................................................................................32.2 Agent Installation..............................................................................................32.3 Installed Components.......................................................................................73 Configuration..........................................................................................................83.1 Agent Configuration..........................................................................................83.2 Imprivata Configuration....................................................................................93.3 Active Directory Configuration..........................................................................93.4 Virtual Desktop Configuration.........................................................................103.5 Citrix Configuration.........................................................................................104 Instructions for Use.............................................................................................104.1 Initial Setup.....................................................................................................104.2 Unlocking the Cart..........................................................................................114.3 Locking the Cart.............................................................................................115 Troubleshooting...................................................................................................125.1 Error Messages..............................................................................................125.2 Log Files.........................................................................................................126 IGEL Installation...................................................................................................13
6.1 Installation Package.......................................................................................136.2 IGEL UMS Configuration................................................................................136.3 Assign Files to IGEL Thin Clients...................................................................14
6.4 Add Custom Command..................................................................................156.5 Assign Profile to Thin Clients.........................................................................157 IGEL Removal.......................................................................................................16
7.1 Automatic Removal........................................................................................167.2 Manual Removal............................................................................................16
8 IGEL Virtual Channel Configuration...................................................................16

2 of 16888-98-194-G-00 rev. A • 04/21

1 OVERVIEWThis product is designed to allow Imprivata authentication and authorized access to Ergotron CareFit Pro Medical Carts
with drawers.

1.1 Components• ECartAgent.exe – the agent is installed on endpoints and in virtual desktops to communicate to the cart via a USB
interface cable.

1.2 Supported Operating Systems• Windows 10, Server 2012, Server 2016 – 64bit, IGEL OS 11 (see pg. 13).

1.3 Requirements• Imprivata ConfirmID version 5.1 or later.
• CareFit Pro firmware version 5.0086 or later.

2 INSTALLATION
2.1 Installation Files
ECartAgent.exe

2.2 Agent Installation

888-98-194-G-00 rev. A • 04/21

3 of 16

• Select “Single User Computer” for normal installation onto the local machine.
• Select “Shared Kiosk Workstation” to install the Citrix Virtual Channel driver onto the endpoint.
•.Select “Citrix or Terminal Server” if the Agent will be run in a virtual environment. See section 3.4 for more details.
Select the option to include admin tools with installation to install the configuration tool which can be used to change thedefault settings of the Agent. See section 3.1 for more detail.

4 of 16888-98-194-G-00 rev. A • 04/21

To continue with the installation the AD (Active Directory) group(s) which will have access to the cart must be added.
The group(s) can also be modified later with the configuration tool.
• Only users within the group(s) will have access to the cart.
• The Administrators group is selected by default.
Select “Add” to type in the group manually or use the “Advanced” option to query the AD directory.

888-98-194-G-00 rev. A • 04/21

5 of 16

6 of 16888-98-194-G-00 rev. A • 04/21

Select Install to continue. The installation directory is C:\Program Files\Ergotron\CareFitPro\Imprivata Agent

2.3 Installed Components
ECartAgent.exe will run automatically at startup, it will show up in the system tray as shown.

888-98-194-G-00 rev. A • 04/21

7 of 16

3 CONFIGURATION
3.1 Agent Configuration
If the option was selected at time of install, the configuration tool ECartAgentConfig.exe will be installed in the same
directory as the Agent (C:\Program Files\Ergotron\CareFitPro\Imprivata Agent). In order to make configuration changes,
it must be run as an Administrator.

• Allow Agent Exit (Y/N). If set to yes, user can right click on the Ergotron System tray icon and select exit to terminate
the program. If Ergotron Commissioning Tool is also installed this option should be selected because the Agent cannot run concurrently.
• Bypass AD Security Check (Y/N). If set to yes, AD security group checks are bypassed. Set to yes if there is no needto limit access to the cart to select groups. All Imprivata users will have access to all carts.
• Imprivata Timeout (seconds). Number of seconds authentication dialog is displayed. Default is 15s, configurable up to99s.
• Lock Cart Text. Text to display in the right click menu of the agent.
• Lock Storage and Workstation (Y/N). If set to yes, when the workstation is locked or logged out the cart will also lock.
• Logging Level (Critical, Error, Warning, Information, Verbose). Default setting logs errors.
• Number of days to keep logs. Default is 30 days.
• On Login prompt for unlock (Y/N). If set to yes, when user logs into workstation they are automatically prompted tobadge tap a second time to unlock the cart.
• Unlock Cart Text. Text to display in the right click menu of the agent.
The configuration settings for the agent are stored in an XML file named ECartAgent.exe.config. This file can be edited
and deployed to other computers by storing it in the same directory (C:\ProgramData\Ergotron\CareFitPro\ImprivataAgent).
8 of 16888-98-194-G-00 rev. A • 04/21

3.2 Imprivata Configuration
ConfirmID workflow needs to be configured.

Under the Clinical Workflow policy assign a user policy or policies to non-regulated user verification then add users tothat policy.

3.3 Active Directory Configuration
By default, for a user to access the cart they must be a member of the group which was added in the cart configurationor during the initial install. It is recommended that specific cart access groups are set up such that cart access can belimited to only those users within the group.
This allows IT personnel to prevent users who may be authenticated by Imprivata from accessing a cart for which theyshould not have access. This can be bypassed with the agent setting ‘Bypass AD Security Check’.
Users with cart access are usually in a group or can be added to a new group which meets the hospitals cart accessrequirements. For example, if carts are deployed to different sections in the hospital such as ICU & Pharmacy, then two
AD groups could be created to limit access to the carts in those areas.
• The “ICU” AD group would be added to the endpoints attached to the carts in the ICU ward. Only ICU personnel in theICU AD group would have access to those carts.
• Similarly, the “Pharmacy” AD group would be added to the endpoints attached to the carts in the Pharmacy ward. Onlypersonnel in the Pharmacy AD group would have access to those carts.
• It is possible for a user to exist in multiple AD groups and have access to all carts.

888-98-194-G-00 rev. A • 04/21

9 of 16

3.4 Virtual Desktop Configuration
The required Citrix Virtual Channel driver is installed on the endpoint by selecting the “Shared Kiosk Workstation” optionduring install. The agent is installed in the PD/XD virtual desktop by selecting the “Citrix or Terminal Server” option during install. Citrix device mapping is used to map communication from the virtual desktop to the physical device.

3.5 Citrix Configuration
Citrix Client USB device redirection rules need to be configured to allow passthrough of the physical cart device into thevirtual environment. The VID is 1B14, PID is 06B9 (values are in hexadecimal).

4 INSTRUCTIONS FOR USE
4.1 Initial Setup
The first time the CareFit Pro Imprivata Agent is installed onto a computer and connected to a cart, the computer namemust be bound to the cart. To bind the computer name to the cart, a user with Administrator privileges must be authenticated in the ConfirmID window. The below prompt should appear.

Press Yes to confirm the operation before the window times out.

10 of 16888-98-194-G-00 rev. A • 04/21

4.2 Unlocking the Cart
• If the user clicks on Agent icon or presses the “Drawers” button on the cart display, the Imprivata ConfirmID window
shall appear on the computer ready for a badge tap authentication.

• The user must tap their badge while the ConfirmID window is still active. If the ConfirmID window has been closed or
has timed out, the badge tap will log out the user. When the user presses the drawer button, the RFID icon on the cart
display will be shown to indicate when a badge tap is available.

• If the user is authenticated and authorized for use in the AD directory, the drawers on the cart will become accessible.

4.3 Locking the Cart
• Normally the user will use the interface on the cart display to lock the drawers on the cart.
• By default, the drawers will also be locked if the user logs out of the computer. See configuration section to disable.
• The drawers must be locked before a new authentication event can begin.

888-98-194-G-00 rev. A • 04/21

11 of 16

5 TROUBLESHOOTING
5.1 Error Messages
If the Agent is not successfully connected to the cart it will indicate a warning as shown below. Ensure the cart ispowered ON and the USB cable is connected.

If the computer name is not stored in the cart, the below message will be shown. See section 4.1

If the user cannot be found in the AD group that is configured, the below message will be shown. See section 3.3

5.2 Log Files
Log files are stored in C:\ProgramData\Ergotron\CareFitPro\Imprivata Agent\Logs. The default log level is errors and tokeep log files for 30 days.

12 of 16888-98-194-G-00 rev. A • 04/21

6 IGEL INSTALLATION
6.1 Installation Package
The IGEL installation package includes the following files:• ECartVC.dll• ECartVC.dll.config• ECartVCConfig

6.2 IGEL UMS Configuration
Create files in UMS for “ECartVCConfig”, “ECartVC.dll”, “ECartVC.dll.config” by right clicking on
Files and selecting “New File”

888-98-194-G-00 rev. A • 04/21

13 of 16

Browse to file “config” then enter Thin Client file location of “/wfs/coretek/CTSVDES/bin/config”. Note: Make sure Owner
READ/WRITE/EXECUTE Access rights checked

Repeat for “ECartVC.dll” and “ECartVC.dll.config” with a Thin Client file location of “/wfs/Erogotron/CareFitPro/Imprivata
Agent”. Note: Make sure Owner has READ/WRITE/EXECUTE Access rights checked

6.3 Assign Files to IGEL Thin Clients
Assign the newly created files to Thin clients either directly or through a profile. Note: recommended procedure is to usea profile as show below.

14 of 16888-98-194-G-00 rev. A • 04/21

6.4 Add Custom CommandEdit the profile created in 1.3 or the host configuration directly.

Under Configuration/System/Firmware Customization/Custom Commands/Base, enter “/wfs/coretek/CTSVDES/bin/config” under Final Initialization Command (note: click the yellow triangle to allow editing) then enter the path to theVCConfig executable. Specify the following arguments: -i ECartVC.dll -c ECartVC.dll.config

6.5 Assign Profile to Thin Clients
Assign the profile to the appropriate thin clients and then reboot the thin clients to complete the installation.

888-98-194-G-00 rev. A • 04/21

15 of 16

7 IGEL REMOVAL
7.1 Automatic Removal
IGels reset after every reboot. Simply remove the device from the Cart Integration profile and reboot. The cart integration citrix virtual channel will no longer be loaded.

7.2 Manual Removal
Run ECartVCConfig -r ECartVC.dll from a terminal window and the virtual channel driver will be removed immediately.

8 VIRTUAL CHANNEL CONFIGURATION
Settings for virtual channel are stored in ECartVC.dll.config. The Agent configuration tool can be used to edit the values
or any text/xml editor can be used.
• BypassADSecurityCheck – bypasses AD Security checking. Acceptable values are 0 (default) for don’t bypass and
1 for bypassing.
• DaysToKeepLogFiles – number of days log files are retained. Default is 30. Log Files are stored either in /var/log/
Ergotron/CareFitPro/Imprivata Agent if user running virtual channel has access otherwise logs are stored in ~/Ergotron/CareFitPro/Imprivata Agent• LockStorageAndWrks – locked the cart when IGEL detects a disconnect from the citrix session. Default is 1 (On).
• LogLevel – level of logging. Acceptable values
o 0: No Logging
o 1: Critical messages onlyo 2: Include Error messages (default)o 3: Include Warning messageso 4: Include Informational messageso 5: Verbose – maximum logging of all messages.
• SecurityGroups – AD security groups that are authorized to access the carts. Imprivata provides identity authentication. The format is a semi-colon list of DOMAIN\GroupName’s. The Agent config tool is the easiest way to assign avalue to this setting.

For Warranty visit: www.ergotron.com/warranty
For Service visit: www.ergotron.com
For local customer care phone numbers visit: http://contact.ergotron.com

www.ergotron.com | USA: 1-800-888-8458 | Europe: +31 (0)33-45 45 600 | China: 400-120-3051 | Japan: japansupport@ergotron.com© 2021 Ergotron, Inc. All rights reserved.

www.ergotron.com
USA: 1-800-888-8458
Europe: +31 (0)33-45 45 600
China: 400-120-3051

16 of 16

Japan: japansupport@ergotron.com

www.ergotron.com
USA: 1-800-888-8458
Europe: +31 (0)33-45 45 600
China: 400-120-3051
Japan: japansupport@ergotron.com

www.ergotron.com
USA: 1-800-888-8458
Europe: +31 (0)33-45 45 600
China: 400-120-3051

888-98-194-G-00 rev. A • 04/21

Japan: japansupport@ergotron.com