Please read the following information before upgrading. Several of the caveats below could adversely affect the success of your upgrade if not heeded.
When upgrading from versions prior to EFT Server v6.4, if you upgrade the SQL Server ARM database with the installer, the default schema name is changed to dbo.
If you upgrading from Secure FTP Server, refer to Upgrading Secure FTP Server v3.3 to EFT Server v6.x.
If you are also upgrading DMZ Gateway, upgrade DMZ Gateway first, then upgrade EFT Server.
Contact the Sales team to obtain a new registration serial number or to determine your eligibility for an upgrade. If you are moving a Server 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.
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.
If you are upgrading a cluster, refer to Installing or Upgrading EFT Server in a Cluster.
In v6.5 and later, COM API resources including SFTPCOMInterface.DLL and associated files are saved in C:\Program Files\Common Files\Globalscape\SFTPCOMInterface so that they can be shared with other Globalscape applications, such as the Secure Ad Hoc Transfer module and Mail Express, ensuring each application is using the same DLL.
In v6.5 and later, a more sophisticated process is used to upgrade the ARM database. Refer to Upgrading the EFT Server Database for details.
EFT Server 6.5 uses UTF-8 for RADIUS/RSA. When upgrading to v6.5, in cases where ASCII strings with >127 characters were used for RADIUS/RSA in the prior version, there is some risk of loss of fidelity when converting to UTF-8 (depending on the code page) for v6.5. You may need to re-enter valudes, disable and then re-enable RADIUS/RSA, or restart the Site to refresh the values.
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.
If you are upgrading from EFT Server SMB edition to EFT Server Enterprise, you may have to update the path to the .aud file in the Authentication Options dialog box for each Site. Refer to Globalscape Authentication or Changing and Testing LDAP Authentication Options for instructions, depending on the authentication type. When the EFT Server service starts, it looks for a .cfg file. If the .cfg file is not found, corrupted, or not compatible, EFT Server creates a new .cfg file in the default location. If the .cfg file is corrupted or the wrong version, the bad .cfg file is backed up and an error is written to the Event log. The .cfg file points to the Sites' .aud files. EFT Server searches for the .aud file near the ftp.cfg file if the path to the .aud file appears to be incorrect. You cannot edit the .cfg file. (If you have installed the previous version for the sole purpose of upgrading, you must create at least a Server object in the administration interface to create a .cfg file before you can upgrade.)
New functionality has been added to the Web Transfer Client (WTC) and the Plain Text Client (PTC). End users will need to clear their browser cache: refer to KB http://kb.globalscape.com/KnowledgebaseArticle10654.aspx for more information.
The Folder Monitor Event Rule trigger was improved to provide better reliability for the handling of file events. The current Folder Monitor algorithm uses more resources (threads) than the v6.2 algorithm. EFT Servers with more than 250 Folder Monitor Rules should use the v6.2 algorithm, which uses fewer resources. The 6.2 Folder Monitor algorithm can be selected via a registry key .
If a Site uses the LDAP Authentication Manager, and if the users are allowed to change their passwords, LDAP calls are used to make the password changes. In v6.2, Active Directory calls were used to make the password changes. With the switch to LDAP in v6.3 and later, LDAP over SSL should be used to protect the password changes. LDAP over SSL can be difficult to configure, so setting the ChangePassByAD DWORD value to 1 allows you to continue using the Active Directory API for the password changes, which also provides security for the communication path.
32-bit location: HKEY_LOCAL_MACHINE\SOFTWARE\Globalscape Inc.\EFT Server 4.0\
64-bit location: HKEY_LOCAL_MACHINE\SOFTWARE\WOW6432Node\Globalscape Inc.\EFT Server 4.0\
Create DWORD ChangePassByAD
1 = previous AD approach is used
0 or does not exist = LDAP calls are used to change user passwords
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.
Any scripts that use the v6.2 COM API for Timer Events must be updated to the new API.
The IP Access/IP Ban has increased functionality, and the COM interface has been modified to match the new functionality. Any scripts that use the v6.2 COM API for IP Access entries must be updated to the new API.
EFT Server supports PORT mode when using the SOCKS protocol to the outbound gateway/proxy. Event Rules that were configured for SOCKS PORT mode in v6.2, will switch from acting as a PASV mode connection to a PORT mode connection in later versions.
If NTLM v2 proxy authentication support is needed, the default HTTP client must be changed from the Apache HTTP client to the Java JSE HTTP client. The JSE HTTP client does not properly set the Content-Length for files > 2GB, so a custom X-Header is used to communicate the file size. Any HTTP proxy that is in the path between the browser and EFT Server must properly pass the custom X-Header.
FTP requires UPLOAD permission in addition to APPEND to resume a partial file transfer.
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 Variables (List) for more information about the %SOURCE.FILE_NAME% variable.
It is a good idea to read the Release Notes before you begin.
To upgrade the software
Document the administrator user name and password for the existing product. If you are also upgrading the database files, you will need the ARM database name, username, and password.
Close the administration interface and stop the EFT Server service.
As a precaution, back up the existing installation directories and any other files you may have installed elsewhere. If you are upgrading EFT Server Enterprise, run a backup and save that backup file in an easily accessed location or removable media.
Launch the installer. The Choose an installer page appears.
Click EFT Server or EFT Server Enterprise. The installer loads the required components, then the Welcome page appears.
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 Server installation folder as "license.txt" if you want to read or print it later.
The installer will detect the existing installation of EFT Server.
Click Upgrade to upgrade the existing configuration and copy your existing Sites, users, etc. to the new installation. (If you are upgrading a cluster, refer to Installing EFT Server in a Cluster. If this is a new installation, refer to Installing the Server, Administrator, and Modules.)
Click Next. A message appears stating that the SFTPCOMInterface.dll will be upgraded. Click OK to dismiss the message.
Click Next. The Choose Components page appears.
To upgrade EFT Server and the Admin Interface, leave both boxes selected. To upgrade only the Admin Interface (for remote management of the server), clear the EFT Server check box.
Click Next. The Choose Install Location page appears.
Keep the default location or click Browse to specify and 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.
Click Next. The database configuration page appears.
If you do not want to configure auditing and reporting, click Skip auditing and reporting configuration, then click Next and the selected components will be updated.
If you want to configure auditing and reporting, click Configure auditing and reporting, then click Next.
If you are using a local SQL Server Express database, the wizard will find the database and prompt you to upgrade it. When using a SQL Server or Oracle database, a screen appears in which you can provide the database connection information and credentials.
If you choose to upgrade the database, the installer will test the database connection, if configured, then the Confirm Database Upgrade page appears.
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, select the I understand check box and then click Install.
The wizard will upgrade the database and the specified EFT Server components. On the final page of the wizard, select the check boxes as needed:
Start the administration interface - If you do not want to open the interface, clear the check box. You can also open the interface from the Start menu.
Create a desktop shortcut - An administration interface shortcut is created on the desktop by default. If you do not want to create a shortcut, clear the check box.
Show version history - If you want to read the release notes, select the Show Version History check box. If you want to read it later, the file, notes.txt, is stored in the EFT Server installation directory.
Show installation log - If you want to review the installation log now, select the check box. If you want to review it later, it is stored in a temporary folder, C:\Program Files\GlobalSCAPE\EFT Server Enterprise (or EFT Server)\Installer.log.
Start the EFT Server Enterprise Service - Clear the check box if you do not want to start the Service yet. Select the check box if you want to start the service when you click Finish. The service is configured to start automatically when the computer starts. If you do not want the service to start automatically, you will have to configure it in Windows to start manually. The EFT Server service Log On Account is set to "Local System account."
The EFT Server service Log On as account will be set to Local System account by default. If necessary, you can edit this in the service's Properties dialog box, on the Log on tab. (Start > Run > services.msc.)
If you are upgrading from EFT Server basic edition to EFT Server Enterprise
After you have finished installing EFT Server Enterprise, uninstall EFT Server basic edition. 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, then execute the following commands in the C:\Program Files\Globalscape\EFT Enterprise directory:
Reopen the interface and the message should no longer appear.