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:
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;
KBArticle11239 - FixDoubleSlashInPathsForFTP
- Allows older SFTP clients to connect (Customer assumes vulnerability
risk if registry modifications are applied)
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
|| 7.0 and 7.1
|| 7.1 and 7.2
|| 7.2 and 7.3
|| 7.3 and 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.
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
(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.
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
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
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.
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
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%
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
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
- Log in to the administration interface. If you are also upgrading
the database files, you will need the ARM database name, username,
- 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.
- Close the administration interface and stop the EFT service.
- Launch the installer. The Choose an installer
- Click EFT or EFT Enterprise.
The installer loads the required components, then the Welcome
- Click Next. The license agreement appears.
- 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.
- Click Upgrade to upgrade the existing configuration
and copy your existing Sites, users, etc. to the new installation.
- Click Next. If a message appears stating that
the SFTPCOMInterface.dll will be upgraded, click OK
to dismiss the message.
- Click Next. The Choose Components
- To upgrade EFT and the Admin Interface,
leave both check boxes selected.
- Click Next. The Choose Install Location
- Keep the default location or click Browse
to specify an alternate location.
- Click Next. The Configuration data
path page appears.
- Keep the default location or click Browse
to specify an alternate location.
- Click Next. The Choose Start Menu
Folder page appears.
- Keep the default location, click an alternate location, or
type a name to create a new folder, then click Next.
- 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.
- Review the information in the dialog box, or click View
to review the information in a text editor.
- If there are any errors to repair, you can repair them on the
database now, and then click Reanalyze to retest.
- 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.)
- The wizard will upgrade the database and the specified EFT
components. On the final page of the wizard, select the check
boxes as needed.
- 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
- Close the interface.
- Execute the following commands in the C:\Program Files\Globalscape\EFT
- Reopen the interface; the message should no longer appear.
Optionally provide private feedback to help us improve this article...
Thank you for your feedback!