Azure General Troubleshooting
Note: This page applies to SFTP Gateway version 2.x. Visit Here for documentation on version 3.x.
Note: This page applies to version
for the documentation on version
SFTP Gateway is built from the CentOS 7 image, and uses the default OpenSSH implementation. This article covers some general troubleshooting that you can do.
SFTP Gateway stores its application-specific logs in the following location:
Here are a few log files of interest located in this folder:
- movetos3.log: Logs file events and file copies to Blob.
(Ignore the use of
s3in the name.) Use this to troubleshoot stuck files in the
- sftpgw-admin-api.log: Logs events of the Admin API Java backend.
Check this log if the
sftpgw.shCLI or web admin interface are producing errors.
- s3sync.log: Logs events related to AzCopy sync operations for the
- usersetup.log: Logs events related to user login.
Another useful log is:
This log contains events related to user authentication and SFTP audit logging.
It's often useful to
tail a log while an issue is happening. For example, you can run the command:
tail -f /var/log/secure
Hit enter a few times, and then try logging in via SFTP. You should see events specifically related to your login attempt.
There are two main services used in SFTP Gateway:
- sftpgw-admin-api: This is the Java backend that supports the web admin backend and the SFTP Gateway CLI.
- incron: This is a file event service that SFTP Gateway uses to detect when a file is ready to upload to Blob.
To check on the
status of a service, run the command:
systemctl status sftpgw-admin-api
If a service is down, you can
systemctl restart sftpgw-admin-api
General server health
You can check the remaining disk space with this command:
You will see the following output (there is 27 GB available):
Filesystem Size Used Avail Use% Mounted on /dev/sda1 29G 2.8G 27G 10% /