Table of Contents |
---|
Introduction
Use of the JADE Client will be significantly changed with the introduction of an XSD schema and XML configuration files with version 1.11. The use of the schema is intended to simplify file transfer configuration for the Client - particularly for complex file transfer situations.
File transfer configurations specified for Client versions up to 1.10.x will need to be modified before they can be run with versions 1.11 onwards.
The schema takes account of interdependencies and incompatibilities between parameters and therefore significantly reduces the chances for configuration errors.
The schema uses a standardized parameter syntax and the majority of parameter names will be changed to a greater or lesser degree with its introduction.
A free graphical editor is available for Windows systems. This can be used to generate and validate XML file transfer configuration files for the JADE Client.
A parameter mapping is available for users wishing to compare settings file and XML file transfer configurations or refer to settings file parameters in the XML parameter reference.
settings.ini
file transfer configuration up to Version 1.10.x
File transfer configurations are stored in a settings.ini file.
Individual parameters are grouped together in profiles that can be reused and allow a 'single point of definition' approach to be followed.
Parameters that can be defined separately for the source and target parts of the transfer - for example, the host name and port number - are set with the source_ and target_ prefixes.
This is illustrated in the following example profile:
Code Block | ||
---|---|---|
| ||
[ftp_server_2_local]
;;
operation = copy
;;
source_host = test.sos-berlin.com
source_protocol = ftp
source_port = 21
source_user = demo
source_password = demo
source_dir = /
;;
target_host = localhost
target_protocol = local
target_dir = ${USERPROFILE}\jade_demo\a
|
Running a file transfer profile
A file transfer is started by specifying a settings.ini file and the profile in that file that is to be used.
For example, the profile listed above is called using:
Code Block | ||
---|---|---|
| ||
jade.cmd -settings="%USERPROFILE%\jade_demo\jade_settings.ini" -profile="ftp_server_2_local" |
Code Block | ||
---|---|---|
| ||
./jade.sh -settings="${HOME}/jade_demo/jade_settings.ini" -profile="ftp_server_2_local" |
Limitations of the settings.ini
file approach
Whilst this approach is relatively straightforward to understand when used with simple file transfer situations:
- it is prone to configuration errors and
- becomes difficult to understand and therefore maintain when advanced and complex file transfer configurations are implemented.
More Information
- Detailed descriptions of the parameter configuration and the use of profiles is available in our JADE Tutorials. These include examples that can be tested using our demonstration FTP and SFTP servers. A download containing a configuration file for the tutorial examples is also available.
- A Parameter Reference and a Parameter Mapping table are also available
XML-based file transfer configuration from Version 1.11 onwards
...
Although longer and seemingly more complex than the settings file configuration version shown above, the XML code for this example was produced using the graphical editor and therefore has been validated against the JADE Client XSD Schema. It is error and conflict free and dependencies are correctly specified.
Running a file transfer profile
A file transfer is started by specifying an XML configuration file and the profile in that file that is to be used.
...
- Settings file configuration
Parameters such as host, protocol, user, password and dir (directory) are usually grouped separately in the settings file configuration according to whether they apply to the transfer source or target. This usually has no functional meaning (the files are processed from top to bottom) and is partly simply for convenience (grouping parameters together makes them easier to find) and partly to allow their reuse in the form of so-called profile fragments if required. - XML configuration
- Parameters are divided up between profile and fragment branches. (Note that these expressions are defined differently to elements in the settings file configuration with the same names.)
- authentication and connection parameters (Account & Password and Hostname & Port respectively) and the protocol (defined through the use of FTP) are part of the Fragments branch of the configuration.
- the operation (copy) and the source and target file paths (FilePath and LocalTarget respectively) are specified in the Profiles branch.
- the CopySourceFragmentRef element refers to the FTPFragment specified in the Fragments branch
- The division between Fragments and Profiles branches allows the reuse of elements whilst working within the strict hierarchical structure of XML.
- The use of a reference in the Profiles branch (in the example, using the CopySourceFragmentRef element) to specify the authentication and connection parameters in the Profiles branch allows any number of Profiles elements to be defined and specified as required.
- Parameters are divided up between profile and fragment branches. (Note that these expressions are defined differently to elements in the settings file configuration with the same names.)
More Information
See JADE User Manual - XSD Schema article for more detailed information about the XML configuration.
...