Azure SFTP Gateway Update Process · SFTP Gateway Support

Note: This page applies to SFTP Gateway version 2.x. Visit Here for documentation on version 3.x.

BEFORE YOU BEGIN!

There are a couple of things to consider before upgrading your existing SFTP Gateway instance.

Make a snapshot of your existing VM as a backup in the event that something should go wrong during the update process. For more information on creating a snapshot, see this Azure Virtual Machine documentation.
If you have made any modifications to the server, such as the /usr/local/bin/movetos3.sh or the /etc/ssh/sshd_config, make a backup of these files. These backups can be used for reference should these files be modified during the update process.
We recommend that you perform the update process in a test environment to verify continued functionality before applying changes to production environments. This can be done using the snapshot image suggested above.
We recommend backing up your user configurations with the standard backup and recovery solution found on our Backup and Recovery page.

For 2.001.01 and newer

To update SFTP Gateway to version 2.001.01

Connect to the server over SSH with the Linux system admin

ssh -i /path/to/private/key linux_system_admin@ip_address

Run the update command

# To update to the newest version of SFTP Gateway run 
sudo sftpgw update

# To update to a specific version of SFTP Gateway run
sudo UPDATE_TO_VERSION=<version_number> sftpgw update <version_number>

The update package will download and install automatically

Updating from 2.0 to 2.001

Due to the change to CentOS 7 for SFTP Gateway version 2.001.00 on Azure, there is no direct upgrade available. You will need to create a new VM to get version 2.001.00, however, we do have a migration guide with automated scripts that can help transfer your existing users and system configurations over to the new VM. Please see the Azure SFTP Gateway Migration Guide for more information.