Licensing error for v3.2.1 · SFTP Gateway Support

Overview

Note: This article is for SFTP Gateway on Azure. If this is not your cloud provider, click on the following links:

For SFTP Gateway version 3.2.1, there is a critical issue where Java will no longer start. This is due to a license expiration in one of our software dependencies.

To resolve this issue, you will need to perform an in-place upgrade to version 3.3.2.

How to find out if you have this issue

You may encounter an issue where the SFTP service stops working, and the web admin portal waits indefinitely for the backend Java service to come up:

Please wait while SFTP Gateway finishes setting up and try again in a minute...
Meanwhile, take a moment to view our documentation for setting up 
SFTP Gateway version 3.2.1.

This happens after a recent reboot, or a restart of the Java service.

When you check the application log, you will see these error messages:

Caused by: com.sshtools.synergy.nio.LicenseException: Your support and maintenance has expired! You should either downgrade to a version your license supports, or purchase a new maintenance package.
    at com.sshtools.synergy.nio.SshEngine.startup(SshEngine.java:201)
    at com.sshtools.synergy.nio.SshEngine.startup(SshEngine.java:180)
    at com.sshtools.server.AbstractSshServer.start(AbstractSshServer.java:136)

org.springframework.beans.factory.BeanCreationException: Error creating bean with name 
'embeddedSftpServer': Invocation of init method failed; nested exception is 
java.lang.IllegalStateException: com.sshtools.synergy.nio.LicenseException: 
Your support and maintenance has expired! You should either downgrade to a 
version your license supports, or purchase a new maintenance package.

When restarting the Java service (service sftpgw-admin-api restart), Java fails to start.

Note: This bug only applies to SFTP Gateway version 3.2.1.

Upgrade to version 3.3.2

The current solution is to perform an in-place upgrade to version 3.3.2.

You won't be able to perform an upgrade using our migration article, because you won't be able to export your users and settings when the web admin portal is down.