Henry Schein ONE logo

Dentrix Installation and Migration Tool Quick Start Guide

This Quick Start Guide provides step-by-step instructions for using the Dentrix Installation and Migration Tool, ensuring a smooth installation and migration process. The tool automatically detects your Windows version, system hardware, and Dentrix installation status. Then it will present simplified options that apply to your situation.

The Dentrix Installation and Migration Tool automates several of the processes related to the installation and migration of Dentrix. The Dentrix Installation and Migration Tool simplifies key tasks such as migrating Dentrix to a new server, restoring from a backup, reinstalling or uninstalling a workstation or server, or setting up a new system. No matter your scenario, this tool streamlines the process. During a migration, it transfers your database from the old server to the new one, restores it, and brings over all your essential data, including Document Center files and patient pictures. Even if you only have a backup copy of your Dentrix database, the tool can use it to complete the installation and fully restore your data.


To learn how to use the Dentrix Installation and Migration Tool, click the topics below.

Prerequisites and Download

To successfully use the Dentrix Installation and Migration Tool, make sure you meet the following requirements:


Firewall Information

The Dentrix Installation and Migration Tool automatically configures Windows Firewall as needed. If your office uses a different firewall, ensure the following ports are open:



Download the Dentrix Installation and Migration Tool here:



Server Functions

These functions will be available when the tool is run on a computer running a server version of Windows.

If Dentrix is installed on a server version of Windows, you can Place This Server into Migration Mode using the utility.

Migration Mode is the first step in transferring your Dentrix installation to a new server. The Dentrix Installation and Migration Tool ensures that the correct version of Dentrix is installed and that all data is successfully transferred.

Both the original server and the new server need to be running on the same network to participate in the migration process.

Migration duration depends on data volume. For most practices, including Document Center files, expect a 2-3 hour process.

On the original server, open the tool and select Place This Server Into Migration Mode to Migrate to a Different Server. Then click Continue.

Image of the Dentrix Installation and Migration Tool with Place This Server Into Migration Mode to Migrate to a Different Server selected

Enter your database Passphrase, then click Validate Passphrase.

After a successful validation, select Start Migration Mode.

Image of the Dentrix Installation and Migration Tool with options for the Place This Server Into Migration Mode function

When the current server is successfully in migration mode, move to the new server.

On the New Server, open the Dentrix Installation and Migration Tool and select Migrate Dentrix From an Existing Server.



If Dentrix is installed with a blank database on server version of Windows, you will be able to Migrate From an Existing Server.

This is the second step toward moving your Dentrix installation from one server to another. The Dentrix Installation and Migration Tool ensures that the correct version of Dentrix is installed and that all data is successfully transferred.

Both the original server and the new server are required to be running on the same network to participate in the migration process.

Migration duration depends on data volume. For most practices, including Document Center files, expect a 2-3 hour process.

After placing the original server into migration mode, follow these steps on the new server:

  1. Open the Dentrix Installation and Migration Tool.
  2. Choose Migrate from an Existing Server and click Continue.
  3. Image of the Dentrix Installation and Migration Tool with Migrate from an Existing Server selected
  4. Select Find Original Server.
  5. Image of the Dentrix Installation and Migration Tool with options for the Migrate from an Existing Server function
  6. Use the Locate Original Server tool to search for the server or manually enter its name.
    • If the server is not found, ensure that there is network connectivity between both servers.
    • If the automatic search still cannot find the server, manually enter the original server name.
    Image of the Locate Original Server function
  7. Enter the original server's passphrase when prompted.


If this computer runs a server version of Windows, and Dentrix is not installed, you will be able to choose the Migrate Dentrix From an Existing Server option:

This is the second step toward moving your Dentrix installation from one server to another. The Dentrix Installation and Migration Tool ensures that the correct version of Dentrix is installed and that all data is successfully transferred.

Both the original server and the new server are required to be running on the same network to participate in the migration process.

Migration duration depends on data volume. For most practices, including Document Center files, expect a 2-3 hour process.

After placing the original server into migration mode, follow these steps on the new server:

  1. Open the Dentrix Installation and Migration Tool.
  2. Choose Migrate from an Existing Server and click Continue.
  3. Image of the Dentrix Installation and Migration Tool with Migrate from an Existing Server selected
  4. Select Find Original Server.
  5. Image of the Dentrix Installation and Migration Tool with options for the Migrate from an Existing Server function
  6. Using the Locate Original Server tool, either search for the server or manually enter the server computer's name.
    • If the server is not found, ensure that there is network connectivity between both servers.
    • If the automatic search still cannot find the server, manually enter the original server name.
    Image of the Locate Original Server function
  7. Enter the original server's passphrase when prompted.


If Dentrix is installed on a server version of Windows, you can Reinstall This Server.

During reinstallation, administrators can choose to retain or remove existing settings. The process also includes restoration of Dentrix data.

Important:

Instructions:

  1. Open the Dentrix Installation and Migration Tool on the server.
  2. Select the option Reinstall This Server and click Continue.
  3. Image of the Dentrix Installation and Migration Tool with Reinstall This Server selected
  4. When prompted, choose one of the following:
    • Keep Settings - Retains previous configuration, such as Appointment Book views and Ledger options.
    • Remove Settings - Performs a clean installation, removing all saved workstation settings.
  5. Enter the original server passphrase where prompted.
  6. Click Start Reinstall Process.
    • Dentrix will first uninstall Dentrix, and then immediately begin installing it after.
    • After installation, Dentrix data will be restored based on the preserved settings (if applicable).
    Image of the Dentrix Installation and Migration Tool with options for the Reinstall This Server function


If Dentrix is installed on a server version of Windows, you can Uninstall This Server.

Important: ⚠ This action cannot be undone.

Instructions:

  1. Open the Dentrix Installation and Migration Tool.
  2. Select the option Uninstall Dentrix Server and click Continue.
  3. Image of the Dentrix Installation and Migration Tool with Uninstall This Server selected
  4. Click Uninstall Dentrix Server and follow the prompts.
  5. Image of the Dentrix Installation and Migration Tool with options for the Uninstall This Server function


If this computer runs a server version of Windows, you can use the Restore Data From a Copy of Database option to restore the database from the backup copy. If Dentrix is not already installed on this machine, that will be done as part of the process.

(If the original server is available, consider instead using the instructions outlined above to place the existing server into 'Migration Mode', then migrate Dentrix from the existing server to this one.)

Depending on the amount of data, this process may take several hours. Please allow sufficient time for the operation to complete.

Instructions:

  1. Launch the Dentrix Installation and Migration Tool on the new server.
  2. Choose Restore Data From a Copy of Database.
  3. Image of the Dentrix Installation and Migration Tool with Restore Data From a Copy of Database selected
  4. Click Browse and navigate to the location of the Common folder within the backup.
  5. Click Validate Common Folder to ensure that all required subfolders are present.
  6. After successful validation, click Start Migration to begin the installation and data restoration process.
  7. Image of the Dentrix Installation and Migration Tool with options for the Restore Data From a Copy of Database function


If Dentrix is installed on a server version of Windows, and Dentrix is not installed, you can use the Install Dentrix Server and Restore Data From a Copy of Database option.

This option will install Dentrix and load the database from a backup copy.

  1. With a backup copy of your Dentrix database (such as on a portable hard drive), select Install Dentrix Server and Restore Data From a Copy of Database. After choosing this option, click Continue.
  2. Select Browse and choose the >Common folder within the Dentrix database backup.
  3. Click Validate Common Folder and the tool will check that all essential files are present.
  4. Image of the Dentrix Installation and Migration Tool with options for the Restore Data From a Copy of Database function

    Below is an example of an error that might occur during the file validation check. In this case, an important file from the Installs folder is missing. If possible, obtain another full copy of the “Common” folder from the Dentrix server.

    Image of a possible error message you might see during a database validation
  5. After the validation concludes, press Start Migration to continue. Then follow the prompts presented by the Dentrix installation.


Workstation Functions

These functions are available when the tool is run on a workstation (non-server version of Windows).

If Dentrix installed as a workstation, you can use the Point This Workstation to a Different Server option.

If you have migrated to a new server, use the Point This Workstation to a Different Server option on each workstation to seamlessly update its connection to the new server.

Instructions

  1. Open the Dentrix Installation and Migration Tool on the workstation.
  2. Select Point This Workstation to a Different Server.
  3. Image of the Dentrix Installation and Migration Tool with Point This Workstation to a Different Server selected
  4. In the New Server Name field, enter the name of the new Dentrix server.
  5. Click Point Dentrix to New Server.
  6. Image of the Dentrix Installation and Migration Tool with options for the Point This Workstation to a Different Server function


If Dentrix installed as a workstation, you can use the Reinstall This Workstation option.

This option uninstalls Dentrix and then reinstalls it on the workstation.

Instructions

  1. Launch the Dentrix Installation and Migration Tool on the workstation.
  2. Select Reinstall this Workstation and click Continue.
  3. Image of the Dentrix Installation and Migration Tool with Reinstall This Workstation selected
  4. Choose one of the following:
    • Keep Settings - Retains most workstation-specific configurations (e.g., Appointment Book views, Ledger display settings).
    • Remove Settings - Performs a clean removal of Dentrix without preserving previous configuration data.
  5. Click Reinstall Dentrix Workstation.
    • Dentrix will first uninstall, then automatically begin reinstallation.
    • Once reinstallation is complete, Dentrix will restore settings based on your selected option.
    Image of the Dentrix Installation and Migration Tool with options for the Reinstall This Workstation function


If Dentrix installed as a workstation, you can use the Uninstall This Workstation option.

This will remove Dentrix from a workstation. After uninstallation, Dentrix will no longer be accessible on the workstation unless reinstalled.

Instructions:

  1. Open the Dentrix Installation and Migration Tool on the workstation.
  2. Select Uninstall Dentrix Workstation and press Continue.
  3. Image of the Dentrix Installation and Migration Tool with Reinstall This Workstation selected
  4. Click Uninstall Dentrix Workstation.
  5. Follow the on-screen prompts to complete the uninstallation.


If Dentrix is not installed, and this version of Windows is not a server version, you can use the Install Dentrix as a Workstation option.

Select the Install Dentrix as a Workstation option to set this machine up as a Dentrix workstation on the network.

  1. Review the system requirements, then click Continue.
  2. Image of the Dentrix Installation and Migration Tool with the Install Dentrix as a Workstation function selected
  3. Review the warnings, then select Install Dentrix Workstation to proceed.
  4. Image of the Dentrix Installation and Migration Tool with options for the Install Dentrix as a Workstation function


Related Information

Using the Dentrix Server Administration Utility to export or restore the Dentrix database.

What and How to Backup

Your Dentrix database should be periodically exported—either manually or automatically. This is most commonly done using the Dentrix Server Administration Utility (discussed below).

When exported, all database activity is temporarily paused and a copy of the database is made to this folder: (drive):\Dentrix\Common\

You can then copy of the Common folder (including all subfolders and files) to another drive, either manually or automatically through a backup software. The Common folder contains everything you need to restore the Dentrix database if needed.

When using an automated backup software, be sure that it has administrative rights to access all files and folders within the Common folder.

Periodically check your processes verify that regular backups are taking place as intended.



Export Your Database to Prepare For Backup

To export your database in preparation for backup, use the Dentrix Server Administration Utility.

You can export the database manually or set up an automatic daily export schedule.

Within Dentrix, the Dentrix Server Administration Utility can be accessed in Office Manager > Maintenance > Practice Setup > Server Administration Utility.

You can also access the Dentrix Server Administration Utility outside of Dentrix. In the Windows File Explorer, browse to (drive):\Program Files (x86)\Dentrix\Utilities\ and open the Dentrix Server Administration shortcut file.


The Dentrix Server Administration Utility is divided into four tabs:

Information

The Information tab displays details about your server and database.

It is important to know the Common Folder location, as this is where you will copy your database from.

Image of the Dentrix Server Administration Utility with the Information tab displayed

Export/Restore Database

You can perform several functions in the Export/Restore Database tab.

Image of the Dentrix Server Administration Utility with the Export/Restore Database tab displayed

To export your database immediately, click the Perform Database Export button.

While exporting, Dentrix will temporarily pause all activity. Workstations may appear frozen or unresponsive during this process.

The files are copied to the server computer's (drive):\Dentrix\Common\DBCopyForBackup folder. (You can verify the location on the Information tab of this utility)

Image of the Dentrix Server Administration Utility with the Export function in progress

After the export is completed, Dentrix activity is resumed. You can then make a complete data backup by copying the entire Common folder, including all subfolders and files. Or you can use an automatic backup software to perform the copy.

When using an automated backup software, be sure that it has administrative rights to access all files and folders within the Common folder.


The Perform Database Restore button acts in the reverse of the Perform Database Export function. It will also temporarily pause all activity, then load the files from (drive):\Dentrix\Common\DBCopyForBackup and replace the live database files.

Important: ⚠ Restoring from a backup will erase any data entered after the last export. Additionally, if the last export took place using an earlier version of Dentrix, you may need to uninstall Dentrix on the workstations and reinstall the older program version.

Because of the risk of data loss, before the restore occurs you will be asked to confirm the action by entering a phrase. You must enter the phrase exactly as it is shown (including spelling, capitalization, and punctuation).

Image of the Dentrix Server Administration Utility with the Restore function in progress

The Scheduled Database Exports section allows you to set up automatic exports of your database at the same time on certain days of the week. This allows you to schedule an export to occur after hours. Select Enable Scheduled Exports, set the days of the week and time of day, and click Update Scheduled Status to save the changes.

If you use an automatic backup service to make a copy the (drive):\Dentrix\Common\DBCopyForBackup folder, schedule the database export to occur first, and allow sufficient time for the export to complete before the backup copy commences.

Maintenance Tasks

The Maintenance Tasks tab allows you to manually stop and restart the Dentrix Server process. It also lists the names of all workstations that are currently accessing Dentrix and the application(s) that are open on each.

This is primarily intended to be used by the support team in troubleshooting situations.

Image of the Dentrix Server Administration Utility with the Maintenance Tasks tab displayed and the service running

Image of the Dentrix Server Administration Utility with the Maintenance Tasks tab displayed and the service not running

Backup Help

The Backup Help tab offers explanation and guidance on how to back up the Dentrix database.