Home User Manual Discussion Forum Search

Service Manager

The Service Manager is a tool included in the Open Dental application folder to manage installation of Open Dental Services. 

Open Service Manager
In the main menu, click Tools, Misc Tools, Service Manager.

All installed Open Dental Services will list. Each service must have a unique service name and the name must begin with 'OpenDent'. 

Note: In version 16.2 and earlier, follow the steps to open Service Manager.

  1. Locate the Open Dental application folder. Depending on how Open Dental was installed, this may be C:\Program Files (x86)\Open Dental or C:\Open Dental. 
  2. Double click on ServiceManager.exe to open.

Add/Edit a Service

  1. To install a new Open Dental service, click Add. To modify an existing installed service, double click it.

In the example above, OpenDentalHL7_DatabaseA is paired with the name of the corresponding database. 

  1. Enter or choose the Service Name. It must begin with OpenDent (e.g. OpenDentalCustListener). The service name cannot have spaces.
  2. Click Browse and select a supported service executable. Typically the files are located in the folders below:
    • \Program Files (x86)\Open Dental\OpenDentalEConnector\OpenDentalEConnector.exe
    • \Program Files (x86)\Open Dental\OpenDentalService\OpenDentalService.exe
    • \Program Files (x86)\Open Dental\OpenDentHL7.exe
    • \Program Files (x86)\Open Dental\OpenDentalCustListener\OpenDentalCustListener.exe
  3. Click Install. If the installation is successful the status will change from 'Not installed' to 'Installed, Stopped'.  
  4. Click Start to start the service. The status will change to 'Installed, Running'.

OpenDentHL7 Service Rules: As of version 12.4, multiple OpenDentalHL7 services can run on the same server to allow one server to host multiple customer databases. In order for each service to process messages for the correct database, a copy of the Open Dental application folder has to be made and uniquely named. In the example above, three such folders were created in the following locations.

Each folder has the exact contents of the Open Dental application folder with a unique FreeDentalConfig.xml file. FreeDentalConfig.xml file is how each service determines which database it is processing messages for. See Generic HL7 for information about how a connection to the database is established using this configuration file.

OpenDentalCustListener Service Rules: Only one OpenDentalCustListener can be installed per database. The OpenDentalWebConfig.xml file is how each service determines which database it is processing messages for. See the Listener Service Setup.

Updating Open Dental Versions: Before you Update, all Open Dental Services must be stopped on the computer starting the update, then restarted once the update is complete. See Stop a Service.

If the service does not start as expected, see the Troubleshooting section on Generic HL7, eClinicalWorks HL7, or eServices Troubleshooting.

Problem: Receive Windows security errors when trying to install Open Dental services.
Solution: Contact Open Dental support and we can install them for you.


Open Dental Software 1-503-363-5432