Introduction
Welcome to Datavant Site Connect's step-by-step guide on how to install the connection Agent for on-premise Electronic Health Records (EHR) and Practice Management (PM) systems. On average, when all of the required information and access rights are provided, installation should take from 5 to 15 minutes.
The connection agent installation is a two-part process consisting of :
Agent installer download.
Agent application installation.
Note: Prior to the installation of a new agent, a connection license will be required to initiate the web activation process. For more details, see Creating a connection License.
Before getting on the call with the practice, it is important to understand the agent and connection requirements. The practice administrator or technical liaison should have the following :
-
Access to the database server of the EHR / PM system, or
Access to a server within the same subdomain of the EHR / PM database server.
Web access to successfully run the installer and connect to the Datavant Site Connect API servers.
Installation rights to the target server.
Minimal read-only credentials to the EHR / PM database.
If all of this information has been provided and you have the generated connection license, you are ready for the connection setup. Let's get connected!
Phase 1 - Agent Installer Download
If the agent is being installed for a new connection license, open a browser and navigate to https://activate.healthjump.com/wizard to activate the connection license key and download agent installer through the wizard.
If the agent is being installed for an existing, already activated connection license, download agent installer from https://healthjump-public.s3.us-west-2.amazonaws.com/agent_install/JumpAgent.zip.
Phase 2 - jumpstart.exe Setup
Installation
Once the agent is downloaded, it can be unzipped.
From the unzipped folder, the IT specialist should right-click on the JumpAgent.msi file and select "Install".
Setup
- An icon (Green Cog) on the desktop should now be present. Double Clicking on this file will prompt the user to enter the secret key generated at the end of Phase 1.
Note: If you having issues executing the app from the desktop icon, you can also obtain the shortcut link and execute the file from the "Program Files (x86)" folder.
After hitting save, the agent GUI will open up with the connection data provided during Phase 1. Once again, you will want to validate the information being displayed. When ready, hit the Test Connection button.
- If the information provided was correct, you will see a "Connection Successfully Established" message.
Note: If the connection fails there are a couple of common issues you can change to fix this.
- Wrong IP Address/Server Name - This can oftentimes be solved by replacing the server name with the IP Address or vice versa.
- Wrong Database Credentials - Credentials should be tested prior to installation to ensure connectivity to the specified database.
- If the failed connection error persists despite these changes, please contact a Datavant Site Connect support technician at support.healthjump.com.
Once you have a successful connection you have officially completed the install phase and are to move to the final phase, starting the jumpStart agent.
Services
Open services (services.msc) and find jumpAgent.
Note: Along with JumpAgent you should see two other services, JumpAgentMonitor and JumpAgentRestart. JumpAgentMonitor & JumpAgentRestart should already be running. The JumpAgentMonitor is monitoring the behavior of the JumpAgent service and JumpAgentRestart is used by Datavant Site Connect to restart and upgrade the JumpAgent service remotely.
JumpAgent.exe should be started.
Windows Authentication
If you are utilizing windows authentication for the database credentials, you will need to update the service credentials to use those same credentials provided for access to the database.
If the agent service is running, stop it.
Right-click on the JumpAgent service and open the properties.
Under the 'Log On' tab select 'This account',
Browse for and select the Windows user entered in the GUI
Enter the password and apply.
- restart the service.
- Retest the connection in the GUI to validate the agent can authenticate
Once the connection has been successfully connected, the installation process is complete. The Datavant Site Connect agent will begin the extraction process the same evening of the receipt of a successful connection Heartbeat.