User Manual

Transfer Device Connector to New Hardware

Updated on

In this article, you will learn

  • which options are available for transferring the Device Connector to new hardware,
  • how a Transfer Package can be used to migrate the existing PrintQueue GUIDs to the new installation, and
  • which adjustments are required after the transfer in the $PRODUCT_NAME_WORKFLOW application.

1. Introduction

If the workstation on which the Device Connector is installed is replaced with new hardware, the existing Device Connector installation must be transferred to the new hardware. Two options are available for the transfer:

  • Transfer using the Transfer Package – the existing installation is transferred to the new hardware using the Transfer Package. The PrintQueue GUIDs are preserved. This option is recommended.
  • Manual transfer – the transfer is performed by copying the Device Connector data folder. This option is used when the migration function cannot be used, for example, if only the files of the old PC are still accessible.

If a Transfer Package is created before the transfer, the existing PrintQueue GUIDs are transferred to the new installation. In this case, the Ergosoft Printer Types do not need to be reassigned in the $PRODUCT_NAME_WORKFLOW application. Without a Transfer Package, the print queues are created as new queues on the new hardware and assigned new GUIDs. The mapping in the $PRODUCT_NAME_WORKFLOW application must then be restored manually.

2. Transfer of the Device Connector

Please note that, regardless of the transfer option selected, adjustments must be made in the $PRODUCT_NAME_WORKFLOW application after the migration. These adjustments are described in Section 3. For a manual transfer, the Printer Type mapping must also be restored as described in Section 4.

2.1. Transfer Using the Transfer Package

The Device Connector Transfer Package is used to migrate an existing installation, including its print environments and associated print queues, to new hardware. The PrintQueue GUIDs are preserved during the transfer, so the Ergosoft Printer Types do not need to be remapped in the $PRODUCT_NAME_WORKFLOW application. This option is recommended, provided that the old workstation is still operational and accessible.

Create a Transfer Package

To create a Transfer Package, proceed as follows:

  1. Open the Device Connector ControlCenter and navigate to the Tools [1] tab.
  2. Open the Maintenance Tool [2] by clicking the corresponding icon.

Figure 1: The Tools tab in the Device Connector ControlCenter

  1. In the ErgoRip Program Maintenance Tool dialog, select Transfer installation to new computer [3].
  2. The Changes to Ergosoft RIP Settings dialog informs you that all dependent processes must be terminated. Click OK to continue.

Figure 2: The ErgoRip Program Maintenance Tool dialog

  1. In the Installation Transfer Utilities dialog, select Phase 1: Prepare Transfer [4].

Figure 3: The Installation Transfer Utilities dialog

  1. In the Prepare Transfer dialog, specify the path [6] where the Transfer Package is to be saved.
  2. Finally, click Save Transfer Package [5].

Figure 4: The Prepare Transfer dialog

Create Transfer Packages Regularly

It is recommended to create a new Transfer Package whenever changes are made to the printer configuration, for example, when adding a new printer, modifying a print queue, or creating a new print environment. This ensures that an up-to-date Transfer Package is always available when needed.

Restore a Transfer Package

To restore a Transfer Package on the new hardware, proceed as follows:

  1. Install the Device Connector on the new hardware. For instructions, refer to the Installing Device Connector article.
  2. Open the Device Connector ControlCenter and navigate to the Tools [1] tab (Figure 1).
  3. Open the Maintenance Tool [2] (Figure 1) by clicking the corresponding icon.
  4. In the ErgoRip Program Maintenance dialog, select Transfer installation to new computer [3] (Figure 2).
  5. The Changes to Ergosoft RIP Settings dialog informs you that all dependent processes must be terminated. Click OK to continue.
  6. In the Installation Transfer Utilities dialog, select Phase 2: Restore on New Computer [7].

Figure 5: The Installation Transfer Utilities dialog

  1. In the Restore Installation dialog, select Import queues and assign them to the new computer [8]. This ensures that all PrintQueue GUIDs are preserved.
  2. Select the path [9] where the Transfer Package is stored.
  3. Finally, click the Execute Transfer command [10] to complete the transfer.

Figure 6: The Restore Installation dialog

Manual Adjustments After the Transfer

Even when using the Transfer Wizard, manual adjustments may be required. These primarily affect spool and output folders if the folder structure on the new hardware differs from the previous setup, as well as ports that use UNC paths. System IDs for USB devices also inevitably change when the hardware is replaced.

2.2. Manual Transfer

If the Ergosoft migration function cannot be used, proceed as follows:

  1. Copy the entire Device Connector data folder from the old workstation to the new one. The data folder is located at: C:\Users\Public\Documents\EsRip\17.
  2. Install the Device Connector on the new hardware. During installation, select the previously copied data folder as the user data folder.
  3. Once the installation is complete, start the JobComposer and assign the ports to their respective print queues.

Installing the Device Connector – Detailed Instructions

For detailed instructions on installing the Device Connector and activating the license, refer to the Installing Device Connector article.

Figure 7: The Device Connector Setup dialog with the User Data dialog for selecting the user data folder

With a manual transfer, the print environments are migrated, but the print queues are recreated on the new hardware. They are assigned new GUIDs, causing the existing mapping in the $PRODUCT_NAME_WORKFLOW application to be lost. The Ergosoft Printer Types must therefore be reassigned.

3. Make Adjustments in the $PRODUCT_NAME_WORKFLOW Application

After the migration, the existing configuration in the $PRODUCT_NAME_WORKFLOW application must be updated to work with the newly configured Device Connector. Proceed as follows:

  1. On the new Device Connector hardware, create a transfer folder in Windows File Explorer to which the print data will be transferred from the $PRODUCT_NAME_WORKFLOW application. If multiple drives are available, it is recommended to create the folder on drive D.
  2. Share the folder on the network.
  3. Ensure that Full Control permissions are granted for the transfer folder. Sufficient access rights are required for the shared folder to function correctly in the $PRODUCT_NAME_WORKFLOW application.

Figure 8: The sharing settings for the transfer folder, showing the Full Control permissions

  1. In the $PRODUCT_NAME_WORKFLOW application, navigate to Administration > File Management and edit the existing Device Connector host.
  2. Enter the IP address of the new workstation. Also update the existing share if its name has changed.
    Important: Modify the existing host and share rather than creating new ones.
  3. Next, edit the existing printer instance and enter the following values:
    • Name – enter the name of the new Device Connector instance.
    • IP – enter the IP address of the new Device Connector instance.
    • Windows path of the Destination Share – enter the local path of the transfer folder on the new hardware.
    • Host – select the host you modified in the previous step from the drop-down menu.
    • Destination – select the destination specified when configuring the share.

Update the Windows Path of the Destination Share

Please note that the Windows path of the destination share must be updated to ensure that the printer instance is registered with the Device Connector again. The Windows path of the destination share must match the settings specified for Host and Destination, as these define the local path on the host and the destination, respectively.

Figure 9: The Edit Printer Instance dialog

4. Reassign the Ergosoft Printer Type

Without a Transfer Package, the print queues are recreated on the new hardware and assigned new GUIDs. As a result, the previously assigned Ergosoft Printer Type no longer exists, and the printer mapping in the $PRODUCT_NAME_WORKFLOW application must be restored.  

Proceed as follows:

  1. Navigate to the Administration > Printer menu item to open the Manage Printer overview.
  2. Open the detail view of the printer for which the mapping needs to be restored.
  3. In the header bar, click Remap Printer Type of Ergosoft Instance [11].

Figure 10: The detail view of a printer

  1. This opens the Remap Printer Type of Ergosoft Instance dialog.
  2. Select the Printer Type to be remapped from the drop-down menu.
  3. Finally, click Save.

When the Function is Available

Reassignment is only available for printers whose previously assigned Ergosoft Printer Type no longer exists. For all other printers, the function is disabled.

Article Update: $PRODUCT_NAME_WORKFLOW 2.3.0 – 10/2026

Previous Article Adding an Additional Print Environment