Updating Open Dental Versions
Be sure to update regularly. You can install an update from any computer
on the network, but we recommend running it from the server because of possible network permission issues. Updates require a valid registration key.
- Before updating, the Open Dental program must be shutdown
on all computers. This process can be completed automatically using the Shutdown tool that opens when you click Install.
- If using replication, see Replication: Updating Open Dental Versions for update instructions.
- To prevent accidental updates when you have multiple locations that potentially run different Open Dental versions, set an Update Server Name (also known as Middle Tier Server Name) in Miscellaneous Setup.
Note: If you experience an error message when updating, you may need to disable your antivirus software.
- In the Main Menu, click Help, Update. Using Version shows your current version of Open Dental.
Setup: Enter your registration keys. Usually you will only do this when you first install the full version of Open Dental. See Update Setup below.
- Click Check for Updates to check for eligible updates. A list of available downloads will list.
- Click Install next to the version you want to install.
New build for current version: A minor build update for the currently installed version. Includes all of the latest bug fixes for the version.
New stable version: This version has gone through the 'beta' testing phase and is considered 'stable'. It will contain new and enhanced features. See Versions for a list of new features by version. If you have already installed the latest stable version, this option will not be available.
New beta version: This version will contain the newest features, but will likely have some bugs. It is available to all practices, but should only be installed if you are willing to take a small risk. We recommend updating to the newest build regularly if you choose this option. If you have already installed the latest beta version, this option will not be available.
For users with an active registration key, the most recent versions are always available for install. If you do not have an active registration key (no longer on support), you can only install versions that were available as of the date the key became inactive.
- Any announcements associated with the update will show. Read carefully before proceeding.
- Once you install and run the update, all
other computers will automatically update when the program is first opened so you can easily keep all your computers updated.
- If you update from a computer that is running a higher version of Open Dental than the database (server) it connects to, the server will also update and other workstations connected to the server will update the next time they start Open Dental.
- Usually Open Dental will automatically backup the database during an update as a preventive measure. Large enterprise organizations that update often and have a comprehensive backup strategy can contact Open Dental technical support to disable this process.
Update in Progress
If anyone attempts to launch Open Dental during an update, they will receive a notification that an update is in progress. Typically the user should wait a few minutes, then click Try Again.
An Override button will be visible on the computer that started the update
or on admin computers listed in FreeDentalConfig.xml. Click to stop the update and launch Open Dental.
View a History of Updates
To view a historical list of version updates (16.1 and greater), click Show
Previous Versions on the Update window.
Usually you will only access the Setup area when you first install the full version of Open Dental. At the top of the Update window, click Setup.
Most of these values will not change.
Registration Key: Click Change to enter a valid registration key supplied by Open Dental (usually in your welcome email.)
Simultaneously update other databases: Only for offices that always run multiple databases. For example, multiple dental offices are consolidated in one physical location with a common reception area. In these situations:
- Pick one "main" database from which you will always perform updates.
- In that database, open the Update Setup window, and enter the names of all the other databases.
- Follow this sequence to perform an update:
- Use the Shutdown Tool on all databases other than the main database.
- Update the main database. This locks users out of all databases at once.
- Open up each of the other databases. Users will be locked out until this is done.
Show buttons for MSI: Enterprise users may want to use an OpenDental.msi instead of OpenDental.exe. Check this box to show buttons for msi. When you return to the main Update window, you will see the option to download the msi instead of the exe.
Update Notification Time: Start a countdown to an update that shows on all workstations.
- Click Change.
- Select the date.
- Select the estimated update time.
- Click OK.
The time remaining until the update will show in the title bar of all workstions and will update every 5 seconds.
The install and download msi buttons will also be disabled. Once the date/time has passed, the countdown will no longer show and buttons will enable again. Note: The update will not automatically occur once the countdown ends. It must still be manually started.
Recopy: Click to update the UpdateFiles folder in the A to Z folder with files from the most currently installed version.
Updates for Enterprise Users
who do not allow ‘normal’ users to have administrative privileges and prefer to centrally manage all software updates can use the standard Windows solution for pushing updates. Use a Group Policy to enable per machine software assignment. For a tutorial, see the Advanced Installer User Guide. Updates are covered in step 6, "Redeploy an MSI package".
Updates for Foreign (Non-U.S.) Users
Foreign releases of beta versions require additional time for bug testing, so users outside the U.S. may note a delay.
Problem: When I run Setup.exe, the first screen gives three options of Modify, Repair, and Uninstall instead of notifiying me it is updating (e.g. from 22.214.171.124 to 126.96.36.199).
Solution: Click cancel and try the download again. It is just trying to reinstall the version you already have installed. You will run into issues like this if you take a copy of your database home. When you run Setup.exe on your home computer, it will try to update the program, but might not have access to the most recent download. If you switch databases (Choose
Database window), it may not be able to locate the Setup.exe depending on Data Paths setup. If you install the update from a disk, you won't even use the window above.
Problem: When updating a second computer, I receive the message “The expected version information was not found in this file “\OpenDentImages\UpdateFiles\Manifest.txt. There is probably a permission issue on that folder which should be fixed.”
Solution: On the first computer (where the update did work), right click on the Open Dental icon and Run as Administrator. Click Help, Update, then click Setup in the upper left. On the Update Setup window, click Recopy. Return to the second computer and try the update again.
Problem: When updating, I receive the message "The remote server returned an error: (403) Forbidden."
Solution: Update the Website Path for Updates field to point to http://www.opendental.com/updates/ Update Error 403 Forbidden
Problem: Update fails and the database becomes corrupt.
Solution: Revert back to an older version. Older version setup.exe files are usually located in the OpenDentImages\SetupFiles folder. Follow these steps.
- Log every workstation out of Open Dental.
- Stop the MySQL service.
- Rename the corrupted database (include the version number in the name).
- Locate the backup made during the update and make a copy of it. Rename the copy with the same name as the original database.
If you have trouble renaming the database, you may need to pause or stop backups or antivirus software.
- Move the renamed database to the original database path.
- Restart the MySQL service.
- Uninstall Open Dental.
- Run the Open Dental setup.exe file for older version.
- Verify everything is working on server.
- Log into every workstation. The Open Dental version on the workstation should still be the 'old' version. If not, then repeat steps 7 and 8 on the workstation.
See Update Technical for technical information about how this page works.