AITIA International, Inc.	SgaSFTPManager - File Transfer Utility	SgaSFTPManager

The File Transfer Utility
`("SgaSFTPManager")`

Features

The program can copy/move a single file or the whole content of a specified folder, applying mask on the file names.
Files are copied/moved after a predefined delta time, relative to the file closing time.
File(s) can be moved/copied from local directory to remote directory, or from remote directory to local directory
Authentication (password based, or ssh public/private key-pair based)

Basic operation

SgaSFTPManager is a configurable software to move or copy file(s) from/to a specified directory, using SFTP.
The program cooperates with WinSCP.
The local folder, where the SgaFTPManager exists, must contain the following folders:
- Checkpoints folder: This folder contains temporaly states. The save-state event happens in every 1 hour, or when the operator closed the software.
- Jobs folder: This folder contains the tasks to perform, based on special initialization files. It must contain ini file(s), which define the transfer settings for the software. The name of the job file is case-sensitive.
- Keys folder: This folder contains the user's ssh public key for the authentication procedure.
- Log folder: This folder contains log files for each defined jobs. The folder contains subfolders, which name is equal to the job's name.
The extension of a temporary files is ".filepart". If the connection breaks during upload or download process, the file transfer will be automatically continued, based on the temporary files. Warning: Temporary files are not supported in "ascii" transfer mode, because it writes end-of-line characters during transfer process.

User interface

Counters in misc window

Section	Counter name	Meaning
JobName/[Stats]
	Transfer count	Number of successful/unsuccessful file transfers
	Total transferred	Summarized value of the transferred bytes.

The main menu

Menu	Menuitem	Shortcut(s)	Meaning
[Actions]
	Exit		Close program immediately
[Log]
	Find line containing...	(Ctrl-F)	Finds text in log window
	Find next matching line	(F3)	Finds next occurrence of text in log window
	Details		Detail level of logging (Off, Normal, Detailed, or Debug)
[View]
	Show log	(Ctrl-L)	Show log window
	Show network	(Ctrl-N)	Show network window
	Show miscellaneous	(Ctrl-M)	Show misc window

Configuration (`SgaSFTPManager.ini`) file settings

[Log]

Entry	Example	Meaning

Level	3
Directory	"C:/Log"	Specifies the location of the log file.

Configuration (`WinSCP.ini`) file settings

All default configurations in the WinSCP.ini file should be used, except:

Section	Entry	Example	Meaning
[Configuration\Interface\CopyParam]
	TransferMode	1	Type of transmission. 0 = binary 1 = ascii 2 = automatic
[SshHostKeys]
		rsa2@22:10.0.0.135=0x10001,0xa5a75e...	This is the host authentication key, which must be set for the authentication process.

Configuration (`job.ini`) file settings

Section	Entry	Example	Meaning
[General]
	JobName	"TestJob_0"	Name of the job. If possible, evade the use of whitespaces and characters with accent. Case-sensitive. Do not duplicate the job names!
	Refreshinterval	15	The resolution is second. The file creation list, which is used to mark a file as "ready to transfer", is built with this period (tries to open the files exclusively, to test for ongoing writes)
	FileLifetime	30	The resolution is second. The value is relative to the system time, if a file is older than this, it's marked for transfer.
	ScpTimeout	120	The timeout of the scp transfer process.
	Move_nCopy	0	Move (1) or copy (0) the file(s).
	Temp_rename	1	Direct copy with the original filename (0), temporaly copy and rename after successful operation (1).
	Auth	1	Authentication required (1), or not required (0).
	Pwdauth	0	Password-based authentication (1), no password-based authentication (0). If authentication is used, then Pwdauth or Pkeyauth must be 1. If both fields are 1, then the password field acts as a key-passphrase.
	Pkeyauth	1	Public/private key pair based authentication (1), no public/private key pair based authentication (0). If authentication is used, then Pwdauth or Pkeyauth must be 1, but not at the same time!
	Pkeyfile	"key.ppk"	Path of the user's public ssh key.
	Username	"UserName1"
	Passwd	"12345"	User password for password-based authentication, or passphrase for key autentication.
	Server	"remote_server.hu"	Remote server address (IP address or name).
	Port	22	Remote server ssh port.
	LocalToRemote	1	File transfer direction. Local to Remote (1), or Remote to Local (0)
	LocalDir	"C:\FtpTest"	Path of the local directory to be monitored for the file transfer.
	RemoteDir	"C:\temp"	Path of the destination dorectory of the SFTP copy on the remote host
	RemoteFile	"myfile.txt"*	File name format to be monitored for the file transfer.
	CopyAtUTC	14:52:00	Do transfer at the specified time.
	LocalMoveDir	"C:\SFTPTest"	If specified, copied files will be moved into this directory after successful transfer.

Version history

v1.6

(n) If key authentication is used, the password field acts as a passphrase; auth-required flag: auth-key OR pass-field

v1.5.4

(c) in progress transfers are ignored during directory rescan while move_ncopy = 1

v1.5.3

(c) Priority of "No files transferred..." message is set to detailed log level.

v1.5.2

(c) Duplicated job names are not allowed. The first job will be accepted, and the others will be discarded.

v1.5.1

(n) The directory of the SgaSFTPManager.log file can be specified in the ini file.
(c) Correction in the Remote to Local file transfer log process
(c) Counters correction in the misc view.

v1.5

(n) PSCP/PLINK changed to WinSCP.exe
(c) Correction in the Remote to Local file transfer

v1.4.2

(n) Timeout handling in the Remote to Local file transfer
(c) Applying PLINK for rename tempraly files, insteed of putty

v1.4.1

(n) SCP Copy mode

v1.4

(n) New function: Temp_rename, if =1, during the local to remote file transfer the remote file name is extended with a „.” character, and after successful transmission, the original file name is restored. If =0, the file transfer operates with the original file name.
(n) To allow the Temp_rename feature, the directory of the SgaSFTPManager.ext must contain the putty.exe file

v1.3

(n) New ini file parameter: LocalMoveDir. If =1, after successful file transfer the software moves the files to a predefined directory.
(c) The checkpoint file is deleted after reading. The software writes the transferred file list into a log file in every hour.

Known bugs

No bug is known at present.

Last Updated at 10/06/2015 16:41:00

The File Transfer Utility("SgaSFTPManager")