The eConnector is used by, and required for all eServices to facilitate communication between Open Dental's secure servers and your office.
In eServices Setup, click eConnector Service.
The eConnector only needs to be installed once. Use this window to determine the current status of your eConnector.
- If you see a status of working, the eConnector is already installed.
- If the Current eConnector Service Status shows as None, the eConnector is not installed.
- If you are unable to connect or receive an error, the eConnector may not be installed.
Current eConnector Service Status: Displays the current status of the eConnector service.
- Start: If the status shows Stopped, click to attempt to start the service.
- Install: If not currently installed, click to attempt installation. See below for more details on this process.
eConnector History: Lists a status of eConnector events recording heartbeats, errors, and other status changes.
- Refresh: Click to update the eConnector status history.
- Ack: Acknowledge an error showing in the service status.
Send emails with a different process on the eConnector: Check to use a seperate process for email transmission. Intended for use of large offices experiencing email timeout errors.
Stop Monitoring: Click to terminate monitoring after eConnector has been uninstalled.
Delete logs older than: Sets to 30 by default. Deletes eConnector logs older than the set value. Enter 0 to disable the feature and never delete old logs.
For more technical guidance see the related links below.
Install the eConnector on the Server
See our video: eConnector Installation.
- Only install the eConnector on one machine (typically the server).
- In Miscellaneous Setup, set the eConnector machine as the Update Server Name.
- The server should always be on and awake. If turned off, hibernating, or in sleep mode, eServices will not work until the computer wakes up.
- Update to the most recent stable version.
- Run Open Dental as an administrator.
- In the Main Menu, click eServices, eConnector Service.
- Click Install.
- If you are prompted to allow the eConnector to begin listening for requests, click Yes.
- If you are prompted to set your computer as the Update Server, click Yes.
- When installation is complete, click OK.
If you receive an error indicating a need for manual installation, see Alternate / Manual Installation below.
Install the eConnector on a Workstation
Installing the eConnector on a workstation is only used when the server is not a viable option.
First follow the same steps as installing on a server, then configure the eConnector service to run using administrator credentials. This requires technical knowledge and you may wish to contact your IT specialist.
- Click Windows Start and open Services.
- Right-click the eConnector service, and open Properties.
- Click the Log On tab.
- Select This Account.
- Enter your administrator login credentials.
- Click OK.
Alternate / Manual Installation
Sometimes the eConnector must be installed manually due to permission restrictions on the server or workstation.
- Open the Service Manager by running as administrator.
Note: You do not need to uninstall the current Listener Service (OpenDentCustListener).
- Click Add.
- Enter or choose the Service Name. It must begin with OpenDent (e.g. OpenDentalEConnector).
- Click Browse and select the OpenDentalEConnector.exe.
Typically it is located in \Program Files (x86)\Open Dental\OpenDentalEConnector\.
- Click Install.
- Enter your configuration settings.
- Server: Name of server hosting the Open Dental database.
- Database: Name of the database (typically opendental).
- User: Name of the MySQL user (typically root).
- Password: Enter the MySQL password.
- Click OK to close the configuration settings window.
- If this installation is successful, the status will change from Not installed to Installed, Stopped.
- Click Start to start the eConnector service. The status will change to Installed, Running.
Error when installing the eConnector
Solution: Because the eConnector is a service, you may need to log in to Windows as a user with Administrative privileges and run Open Dental as an admin (right click, run as administrator).
Error: Installer doesn't have access to the registry
Solution: Login to Windows as a user with higher privileges (e.g. administrator) or manually install the eConnector (see below).
Error: Failed upgrading to the eConnector service: Unable to install the service
Solution: Run the setup.exe file on the host computer and try installing again.
Antivirus software is restricting the eConnector
Allow the eConnector through the Windows firewall.
Error: An unexpected error has occurred: The program version linked to this EServiceAccount is invalid. Please start the EConnector and try again.
- Allow a firewall port for the OpenDentalEConnector.exe.
- Manually install the eConnector.
- If your network requires ports and IP addresses to be white listed, see Ports and IP Addresses for eServices.