Upgrading EFT v7.x and later


Please read ALL of the information below before upgrading. Several of the caveats below could adversely affect the success of your upgrade if not heeded. If you have any questions or concerns about your upgrade, please consult with Customer Support before continuing.

THE INFORMATION IN THIS ARTICLE APPLIES TO:

NOTES

  • IMPORTANT:  EFT v7.4.11 and later use a new SFTP library; therefore, before upgrading, export and convert your SFTP keys. The new version only creates RSA keys in OpenSSH new format. (You can't generate DSS keys and save keys in SSH.com format.) Refer to https://help.globalscape.com/help/eft7-4/#t=mergedProjects%2Fsftp%2FSFTP_FIPS.htm in the help documentation for more information. 

  • Registry modification to support known issues after upgrading:

    • KBArticle10492 - Force “ClientFTP.DLL” to retain logs after completed file transfers

    • KBArticle11189 - Support older SFTP clients Keyboard Interactive Authentication

    • KBArticle11200 - ReplaceBackslashWithSlashInPathsForSFTP; ReplaceBackslashWithSlashInPathsForFTP

    • KBArticle11239 - FixDoubleSlashInPathsForFTP

    • KBArticle11266 - Allows older SFTP clients to connect (Customer assumes vulnerability risk if registry modifications are applied)

DISCUSSION

Please note that, per Globalscape policy for liability reasons, Support does not upgrade or migrate the servers of our clients, but provides instructions or guidance for accomplishing the process. It is possible to acquire an upgrade package from our Professional Services team to have them personally handle the process.

If you are upgrading between versions that are more than 2 versions apart, you will need to complete more than one upgrade. (e.g., from 7.0 to 7.2, then from 7.2 to 7.4) After each upgrade, you will need to restart the EFT server service and log in to the administration interface before you start the next upgrade. If you don't follow the upgrade path, a message similar to the one below appears:

You are able to upgrade to any version of EFT, including the latest, if the following upgrade paths are followed:

  • EFT SMB v7.0.x or v7.1.x to EFT SMB v7.2.x

  • EFT SMB v7.1.x or v7.2.x to EFT SMB v7.3.x

  • EFT SMB v7.2.x or v7.3.x to EFT SMB/Express v7.4.x (In v7.4.7, EFT SMB was renamed EFT Express.)

  • EFT Enterprise v7.0.x or v7.1.x to EFT Enterprise v7.2.x

  • EFT Enterprise v7.1.x or v7.2.x to EFT Enterprise v7.3.x

  • EFT Enterprise v7.2.x or v7.3.x to EFT Enterprise v7.4.x

This version: Can be directly upgraded only to these versions:
 6.5  7.0 and 7.1
 7.0  7.1 and 7.2
 7.1  7.2 and 7.3
 7.2  7.3 and 7.4
 7.3  7.4

You can upgrade from EFT SMB to EFT Enterprise within the same version (requires purchase of Enterprise license). Then you can upgrade further from there.
  • EFT SMB v7.0 to EFT Enterprise v7.0

  • EFT SMB v7.1 to EFT Enterprise v7.1 

  • EFT SMB v7.2 to EFT Enterprise v7.2 

  • EFT SMB v7.3 to EFT Enterprise v7.3 

  • EFT SMB/Express v7.4 to EFT Enterprise v7.4 (In v7.4.7, EFT SMB was renamed EFT Express.)

KBArticle11266 - Allows older SFTP clients to connect (Customer assumes vulnerability risk if registry modifications are applied)

If you are upgrading from EFT SMB/Express edition to EFT Enterprise, if you are adding any modules, you may receive a new activation serial number. If so, then it may be necessary to activate the software when you start it for the first time.

Contact Support to obtain a new registration serial number or to determine your eligibility for an upgrade. If you are moving an EFT from one computer to another, contact the Globalscape customer service team or your account manager so that we can adjust your account on our activation and registration server. Activation on the new computer will not be possible until the adjustment is made. If you want to test or verify an update prior to introduction into your production environment, do not use your production serial number for testing purposes.

Do not use this procedure to upgrade EFT that is in a cluster. If you are upgrading a cluster, refer to Installing or Upgrading EFT in a Cluster

If you are upgrading from Secure FTP Server, refer to: Upgrading Secure FTP Server v3.3 to EFT Server v6.x

AWE:

  • In EFT v7.4.7, the Advanced Workflow Engine was updated. When you upgrade from an earlier EFT version to version 7.4.7 or later, a message will appear stating that "Old format Advanced Workflow (AWE) tasks detected!" The old tasks will be backed up and then converted to the new format. The converted task will not be compatible with older EFT versions. Select the "I understand..." check box, then click Next to proceed. In Silent installations or after importing older versions of AWE tasks, the AWE task will not be updated until you open it in the Task Builder.

DMZ Gateway:

  • If you are also upgrading DMZ Gateway, upgrade DMZ Gateway first, then upgrade EFT.

ARM:

  • (If you are using ARM, Insight, and AWE) Before upgrading to EFT v7.4.7, upgrade EFT Insight to v1.0.5 so that the Advanced Workflow Engine tables will be available when upgrading ARM. AWE v8 tasks will be updated to AWE v10 tasks upon upgrade. If you later import AWE v8 tasks, those tasks will not be upgraded.

  • During updates or upgrades, EFT needs full DB Owner access to update the schema. Once it is set up, EFT Server only needs to be able to read, write, and execute stored procedures. Refer to the Knowledgebase article Configuring EFT Server Permissions in SQL Server for more information.

  • If you are using an ODBC database, run the SQLServerODBCUpgrade.sql script found in C:\ProgramData\Globalscape\EFT Server Enterprise\SQL Server. Also refer to Creating Tables for Your ODBC Data Source.

  • Refer to Upgrading the EFT Database and Upgrading Large Databases in your version of EFT help for important information.

API:

WTC:

  • If you are upgrading to EFT v7.3.2, the WTC licensing has changed from concurrent to CAL. Refer to https://kb.globalscape.com/KnowledgebaseArticle11311.aspx for details. 

  • If you are upgrading to EFT 7.4.2 or later, the WTC no longer requires a licenses; it is included in Enterprise and in the HTTP/S module in SMB.

  • (Java-enabled version) When upgrading the WTC, workstations might receive a Java error, but then the WTC will load and be functional. Refer to KB article#10654 for details.

  • When upgrading, the \web\custom\ and \web\public\ folders are backed up and renamed with the date and time (e.g., \customBackup_9-28-2010_16-18\ and \publicBackup_9-28-2010_16-18\). The new versions of the files may have some updated content, so rather than overwriting the new files with your old files, you should manually copy your customizations to the new files after upgrading. This applies to any edits for the per-Site and per-Server login pages, Web Transfer Client (WTC) interface, Account Management interface, and AS2 Management interface.

  • End users will need to clear their browser cache: refer to KB https://kb.globalscape.com/KnowledgebaseArticle10654.aspx for more information.

  • FTP requires UPLOAD permission in addition to APPEND to resume a partial file transfer.

  • In v7 and later, the WTC no longer logs you out when you refresh or close the browser; the session still times out as normal.

Event Rules:

  • The Event Rule file Copy/Move wizard provides control for overwrite options. The overwrite options were set in earlier versions using registry keys. Any associated registry keys will now be ignored and you should update your Event Rule Actions with the desired overwrite option.

  • During the upgrade, if a non file-trigger rule contains an %FS.FILE_NAME% variable, it will be converted to %SOURCE.FILE_NAME% and a WARNING will record the change in the EFT.log. Refer to the Variables (List) in the help documentation for more information about the %SOURCE.FILE_NAME% variable.

  • By default, IP Access-related Event Rules are limited to 1000 rules. If you upgrade with more than 1000 denied IP addresses, the rule count overflows and you cannot create new rules. Refer to Knowledgebase article "Cannot create new Event Rules after upgrading" for a registry fix.

As always, it is a good idea to read the Release Notes/Change Log before you begin.

To upgrade the software 

  1. Log in to the administration interface. If you are also upgrading the database files, you will need the ARM database name, username, and password.
  2. Back up the existing installation directories and any other files you may have installed elsewhere. If you are upgrading EFT Enterprise, you can run an automatic backup and save that backup file in an easily accessed location or removable media.
  3. Close the administration interface and stop the EFT service.
  4. Launch the installer. The Choose an installer page appears.
  5. Click EFT or EFT Enterprise. The installer loads the required components, then the Welcome page appears.
  6. Click Next. The license agreement appears.
  7. Scroll or page down to review the agreement, then click I Agree to continue.
  8. Click Upgrade to upgrade the existing configuration and copy your existing Sites, users, etc. to the new installation.
  9. Click Next. If a message appears stating that the SFTPCOMInterface.dll will be upgraded, click OK to dismiss the message.
  10. Click Next. The Choose Components page appears.
  11. Leave both the EFT and the Admin Interface check boxes selected, then click Next. The Choose Install Location page appears.
  12. Keep the default location or click Browse to specify an alternate location, then click Next. The Configuration data path page appears.
  13. Keep the default location or click Browse to specify an alternate location, then click Next. The Choose Start Menu Folder page appears.
  14. Keep the default location, click an alternate location, or type a name to create a new folder, then click Next. The ARM page appears.
  15. Choose whether to configure ARM now or Skip it, then click Next.
  16. Choose the database type (SQL or Oracle) that contains your EFT data, then click Next.
  17. Choose whether to create a new database or upgrade the existing database, then click Next.
  18. Specify the database connection information, then click Next.
  19. On the Confirm Database Upgrade page, if there are updates to the database, review the warning message, click I understand, then click Install. (If there are no changes to be made to the database, the check box will not appear.)
    • If there are any errors to repair, you can repair them on the database now, and then click Reanalyze to retest.
  20. The wizard will upgrade the database (if needed) and the specified EFT components. On the final page of the wizard, select the check boxes, as needed, then click Finish.
  21. After installation is complete, log in to EFT. If the server service has not started, a message will ask you to start it.
  22. Review the EFT help in the administration interface or online to read about changes in this version.

If you are upgrading from EFT SMB/Express to EFT Enterprise

After you have finished installing EFT Enterprise, uninstall EFT SMB/Express. When you launch the administrator interface, the following error message might appear:
“Cannot find report definition file. File Missing....”
and lists several files.

To resolve the issue

  1. Close the interface.
  2. Execute the following commands in the C:\Program Files\Globalscape\EFT Enterprise directory:
  3. Regsvr32.exe vsflex8l.ocx

    Regsvr32.exe vsprint8.ocx

    Regsvr32.exe vsrpt8.ocx

  4. Reopen the interface; the message should no longer appear.