Menu

Search

GlobalSCAPE Knowledge Base


Upgrading EFT v7.x and later


GlobalSCAPE 5
EFT Express (SMB) & Enterprise

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

  • EFT v7.4.11 is using a new SFTP library; therefore, for FIPS you will need to have new keys. 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 SFTP FIPS 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

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.

  • Refer to "Upgrading the EFT Database," "Upgrading Large Databases," and "ARM Database Schema Change Tracking" in the help documentation for your version of EFT for important information.

  • 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.

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 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.
    1. Click EFT or EFT Enterprise. The installer loads the required components, then the Welcome page appears.
    2. Click Next. The license agreement appears.
    3. Scroll or page down to review the agreement, then click I Agree to continue. The license agreement is also saved in the EFT installation folder as "license.txt" if you want to read or print it later.
    4. Click Upgrade to upgrade the existing configuration and copy your existing Sites, users, etc. to the new installation.
    5. Click Next. If a message appears stating that the SFTPCOMInterface.dll will be upgraded, click OK to dismiss the message.
    6. Click Next. The Choose Components page appears.
    7. To upgrade EFT and the Admin Interface, leave both check boxes selected.
    8. Click Next. The Choose Install Location page appears.
    9. Keep the default location or click Browse to specify an alternate location.
    10. Click Next. The Configuration data path page appears.
    11. Keep the default location or click Browse to specify an alternate location.
    12. Click Next. The Choose Start Menu Folder page appears.
    13. Keep the default location, click an alternate location, or type a name to create a new folder, then click Next.
    14. If the Secure Ad Hoc Transfer module is installed on the same computer, a message appears stating that IIS needs to be stopped during the upgrade. Click Yes to continue.
    15. Review the information in the dialog box, or click View to review the information in a text editor.
    16. If there are any errors to repair, you can repair them on the database now, and then click Reanalyze to retest.
    17. After all requirements for upgrade have passed, if there are changes to be made to the database, select the check box, then click Install. (If there are no changes to be made to the database, the check box will not appear.)
    18. The wizard will upgrade the database and the specified EFT components. On the final page of the wizard, select the check boxes as needed.
  5. After installation is complete, start the EFT server service, if it's not already, and log in to EFT.

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.

Also In This Category


On a scale of 1-5, please rate the helpfulness of this article


Not Helpful
Very Helpful
Optionally provide private feedback to help us improve this article...

Thank you for your feedback!


Comments require login or registration.

Details
Last Modified: Last Month
Last Modified By: kmarsh
Type: HOWTO
Rated 2 stars based on 47 votes.
Article has been viewed 60K times.
Options
Find Similar