This program is used as a standalone, synchroneous File Transfer client application.

Features supported by this job are:

• Send and receive files by FTP to/from some host.
• Send and receive files by SFTP to/from some target host.
• Send and receive files by FTPS to/from some target host.
• Polling the source server for incoming files.
• Server to Server transfer without touchdown. Different protocols can be used for transfer between the hosts., e.g. FTP to SFTP.
• Execute commands by SSH on some host.
• Both password and public key authentication are supported for SFTP.
• The parameterization is effected by command line parameters and/or by configuration files. Mixed usage of parameters from the command line and from a configuration file is supported, command line parameters have precedence.
• Logging and error handling are provided, errors are detected and reported on a per file basis.
• Transfer of partially matched files Alternatively to transferring individual files, you could transfer multiple files by use of regular expressions.
• Recursive transfer of files in directories Files from arbitrarily nested subdirectories can be selected for transfer by regular expressions. Subdirectories will be created in the target file system, if required.
• Atomic Transfer Files can be renamed during transfer in order to make them appear atomically in a target directory. This is relevant e.g. should target directories be monitored for incoming files. This feature guarantees that incoming files are completely transferred before they appear in a directory.
• Check transferred data for completeness Checking completeness is done by comparing the size of incoming files with the number of transferred bytes. Moreover, files can be transferred repeatedly in order to verify that the files have not been changed on the FTP server during the transfer period.
• Handling of zero-byte (empty) files There are multiple options to handle empty files: Exclude empty files from transfer, include particular empty files, notification by e-mail in case of transfer of empty files.
• Renaming of files Files can be renamed after transfer by regular expressions.
• Use of alternative access data and credentials Should a connection or the login to an FTP server fail then alternative access data and credentials can be used, e.g. to connect to a backup FTP server in case of failure. Primary and alternative access parameters are handled additively, i.e. only those alternative parameters have to be specified that differ from the primary access parameters.
• Support for UNC paths in target directories Files can be directly transferred from an FTP/SFTP server to a target server system.
• Track record of file transfers Optionally a history file keeps track of every transfer that has been effected. History entries are optionally transferred to a JobScheduler instance (background service) that adds them to a central database. As an alternative the transfer history can be stored directly into the database of the background service.
• File compression using gzip or zip.

Features of former SOSFtp, which are actually not supported by JADE

• jump host
  
  Send files by FTP or SFTP to a "jump host" and forward them by FTP or SFTP to a target host. Different transfer protocols can be used between local host and "jump_host" and between "jump_host" and target host.

• file_spec2

• $ppid

• current_pid

System Requirements

• Java Runtime Environment JRE 1.6 and above.

Start Script

• Windows: jade.cmd
  

                                  set CLASSPATH_BASE=.
                                  java -classpath
                                  "%CLASSPATH_BASE%/commons-net-1.2.2.jar;%CLASSPATH_BASE%/sos.net.jar;
                                  %CLASSPATH_BASE%/sos.settings.jar;%CLASSPATH_BASE%/sos.util.jar;
                                  %CLASSPATH_BASE%/trilead-ssh2-build211.jar"
                                  com.sos.jade.SOSJadeEngineMain
                                  %*
                              

• Unix: jade.sh
  

                                  CLASSPATH_BASE=.
                                  JAVA_BIN="java"
                                  "$JAVA_BIN" -classpath
                                  "$CLASSPATH_BASE/commons-net-1.2.2.jar:$CLASSPATH_BASE/sos.net.jar:
                                  $CLASSPATH_BASE/sos.settings.jar:$CLASSPATH_BASE/sos.util.jar:
                                  $CLASSPATH_BASE/trilead-ssh2-build211.jar"
                                  com.sos.jade.SOSJadeEngineMain $*
                              

Command line parameters

• General
  

                                  Usage: com.sos.jade.SOSJadeEngineMain -
                                  
   →operation
  
                                  = -
                                  
   →settings
  
                                  = -
                                  
   →profile
  
                                  =
                                  -verbose=
                                  -
                                  
   →operation
  
                                  =[send|receive] FTP/SFTP operation
                                  -
                                  
   →settings
  
                                  =[file] Configuration file
                                  -
                                  
   →profile
  
                                  =[profile] Section/Profile for FTP/SFTP settings
  
                                  in configuration file
  
                                  -verbose=[1..9] Verbosity level
                              

• Command line parameters and Configuration Files

  This program can receive parameters directly from the command line and from a configuration file. if specified at the command line then a hyphen must be added in front of each parameter name:

  jade.sh -  →operation =send -  →protocol =ftp -  →host =localhost -  →port =21 -  →local_dir =/tmp ...

  If a configuration file is used then profiles can be added as sections in this file and individual parameters can be specified as pairs of names and values, e.g. for a file settings.ini :

  [sample_transfer]
 →protocol = ftp
 →host = localhost
 →port = 21
 →local_dir = /tmp
...

  At the command line the name of the configuration file and the profile are specified like this:

  jade.sh -  →operation =send -  →settings =settings.ini -  →profile =sample_transfer ...

  Mixed usage of parameters from the command line and from a configuration file is supported, command line parameters have precedence.