Backing Up or Restoring Server Configuration

When migrating from a development, staging, or test computer to another computer, you cannot simply copy over EFT Server's configuration files to the new host. In EFT Server Enterprise edition, you can use the Migration wizard to gather each of the necessary files, then package them into one easy-to-transport file. The Migration wizard can recreate the entire folder structure and settings automatically or you can run it in manual mode and verify every setting as you step through the wizard. (Physical folders under the VFS are not recreated when the configuration is restored; however, IF those physical folders are present at the time of restoration, then any VFS permissions assigned to the folders are retained.)

The Migration wizard is not available in EFT Server "SMB" edition. Refer to Copying Server Configuration to Several Computers to backup EFT Server configuration manually.

The Migration wizard is an interactive tool designed to assist you in the following situations:

The migration fails if there is a mismatch/discrepancy in listening IP addresses, VFS root or structure, Authentication Manager settings, DMZ Gateway settings, or database connectivity.

The Migration wizard backs up the entire EFT Server configuration in an archive file at a path that is accessible to the EFT Server service.

The following items are backed up:

The wizard can be initiated manually in the EFT Server administration interface from the File menu or automatically in Event Rules. In EFT Server Enterprise, when you create your first Site, a Timer Rule is created that runs the Backup Server Configuration Action once a day at midnight, using all defaults for naming and backup location (\backup\Server Configuration Backup [Month] [Day] [Year].bak). The Rule includes a Cleanup Action to delete backup files (*.bak) older than 30 days in that same folder. This Backup and Cleanup Rule is enabled by default, but you can disable it and edit it as necessary.

It is a good idea to save the backup on a drive other than on the one on which the EFT Server is installed. If EFT Server's hard drive fails, you will want to use the backup to restore configuration. Refer to Backup Server Configuration Action for details of editing the Backup and Cleanup Rule.

To manually back up Server configuration

  1. On the main menu, click File > Backup Server Configuration. The standard Save As dialog box for your operating system appears.

  2. Specify the location in which to save the backup, then click Open. Save the backup on a drive other than on the one on which the EFT Server is installed. The configuration is saved and is named Server Configuration Backup [Month] [Day] [Year] with a .bak extension.

  3. One of the following occurs:

Any configuration changes made since the backup are, obviously, not included in the restore. For example, if you have deleted or added users since the last backup, those users will have to be deleted or added again after you restore.


Backups from IPv4-only EFT Server versions will listen only on IPv4 addresses; if all listeners selected for administrative connections are unavailable, then switch to listening on localhost.

To restore Server configuration

  1. Install and activate the product on the target system, if restoring to a different computer.

  2. After installation is complete, the New Administrator Connection wizard appears. You must configure the local connection (create the LocalHost Server object in the tree) before you can restore from backup.

  3. In the Connection wizard, leave This computer selected, and specify the Label for the local connection. By default, the label is LocalHost. Because LocalHost is a very common label, it is a good idea to change the label to something that is easily identifiable in error logs, reports, and remote connections. For example, GS_EFTS. You can label EFT Server anything you want; the EFT Server name is not dependent upon the computer name.

  4. After you are logged in to EFT Server, do one of the following:

    The Migration Wizard appears.

  5. Click the folder icon to specify the .bak file to use for restoring Server configuration.

  6. Click Next. The EFT Server Migration Wizard appears.

  7. Provide the administrator login credentials for the configuration being restored, then click OK. (You can use the EFT Server administrator credentials, Windows Authentication, or the currently logged on user's credentials.) The path to the backup file appears in the Backup file location box. The Selected Archive Details area displays the date the backup was made and the username that created the backup, if it was a manual backup, or "Automatic Recurring Backup" if it was an Event Rule-created backup.

  8. Click Next. The Restore Options page appears.

  9. Click either Automatic Restore or Manual Restore:

    Automatic Restore—Automatic Restore prompts only when the wizard encounters discrepancies or problems with restoring. Automatic Restore is the default setting. In automatic mode, you are not prompted to verify settings or allowed to change them.

    1. Click Automatic Restore. The Recreate the entire folder structure check box is selected by default. Clear this check box if you do not want to recreate the VFS folder structure.

      If your EFT Server folder structure includes user folders (e.g., C:\Inetpub\EFTRoot\MySite\Usr\<username>), if you clear the Recreate the entire folder structure check box and do not recreate these folders manually, the users will not be able to access their folders.

    2. Click Next. The Ready to Restore page appears. Read the information on the page, then click Restore.

    3. After the Server is restored, restart EFT Server and log in to the administration interface. A log appears describing the restore process, including file names and paths, and contains any errors encountered during restore.

    Manual Restore—Manual Restore allows you to verify and make changes to settings, as needed.

    1. Click Manual Restore, then click Next. The Sites to Restore page appears.

    2. Select the check boxes of the Site(s) whose settings you want to import and clear the check boxes of the Site(s) whose settings you do not want to import, then click Next. The Site Listening IP Address Assignment page appears.

    3. Review the IP address for each Site. If you are restoring a Site to a different IP address, click to edit the IP address in the New IP Address Assignment list. The Listening IP Address Assignment dialog box appears.

    4. In the New IP Configuration box (right pane), select the check box of one or more the IP addresses to use, then click OK.

    5. Click Next. The Site Authentication Manager Settings page appears.

    6. The authentication database for each Site to be restored appears in the list. In the Settings column, click View/Modify if you want to view or change the path where EFT Server will store the user database. (You cannot change the type of authentication.)

      • If EFT Server cannot connect to the Site's authentication provider, an error message appears.

      • Click OK to continue as is or click Cancel to modify the authentication provider settings.

    7. Click Next. The Site Root Folder page appears.

    8. Review the root folder location for each Site that you are restoring. If necessary, click the folder icon to specify a different location, then click Next.

    9. If the DMZ Gateway is defined and configured in EFT Server that you are restoring, the DMZ Gateway page appears. If not, skip this step.

      1. Review the IP address(es) and port(s) for the DMZ Gateway. Click to edit the IP address or port, if different.

      2. Click Next. EFT Server will test the DMZ Gateway connection and, if successful, the wizard proceeds to the next page.

      • If a failure occurs, the wizard displays a warning prompt indicating failure to connect to the DMZ Gateway and allowing you to either fix the problem (go back to the previous page to verify the IP address and port) or proceed anyway (if the IP address and port are correct, but the DMZ is not communicating).

    10. If the Auditing and Reporting module is defined and configured in EFT Server that you are restoring, the Auditing Database Connectivity page appears. If not, skip this step.

      • Click Test to verify connectivity to Auditing and Reporting Module queue and, if successful, send an asynchronous test message to the database. If a connection to the database cannot be made within 5 seconds, a warning prompt appears. (Verify that the database is available.)

    11. Click Next. Database connectivity is again verified and the Ready to Restore page appears.

    12. Read the information on the page, then click Restore.

    13. After the restore is complete, restart the EFT Server service. After you restart the Server service and log back in via the administration interface, the restore log appears in the default text editor.

    14. Review the log in case errors were encountered during restore.