Page History

Introduction

YADE Command Line Interface

Read more ...

YADE API

Read more ...

YADE JITL Jobs

Read more ...

About these tutorials

Tutorial Scope

Operating Environment

• The examples have been written for use on Windows and Unix systems. Settings files for Windows and Unix systems are available for download via the links in the next section.
• The examples presented on this page use demonstration FTP and SFTP servers that we have configured for this purpose on our web site.
  • Both servers have the same address:
    • test.sos-berlin.com
  • A user demo can log on with password demo and download demonstration files. They cannot upload or delete files.

Configuration file Format and Editor

Configurations for the YADE Client up to and including Release 1.10 are saved in text-based  settings.ini files. From Release 1.11 onwards XML configuration will be used, which will significantly reduce the complexity of more extensive configurations.

The SOS GmbH has developed the XML Editor which provides an easy to follow graphical representation of YADE XML configurations and to a large extent allows uses to click together their configurations. The XML Editor saves YADE configurations in the XML format and can generate a working settings.ini configuration file. A comparison of both formats can be found in the YADE User Manual - Configuration Formats & Tools article.

We strongly recommend the use of this editor which uses an XSD schema to validate and should bring a significant reduction in configuration errors and debugging time.

Anchor
usage_cli usage_cli

Using the tutorials with the YADE Client Command Line Interface

The YADE Client should be installed

• You can download the YADE Client from our YADE Download Page or from SourceForge.
• Installation of YADE on Unix systems is covered in the How to install YADE article.

The XML Editor should be installed.

Setting up the examples

• For Windows users:
  
  • Create a jade_demo folder in your user home directory with a and b sub-folders like this:
    • mkdir %USERPROFILE%\jade_demo
mkdir %USERPROFILE%\jade_demo\a
mkdir %USERPROFILE%\jade_demo\b
  • Download the jade_settings_windows.ini file containing the example profiles presented in this article to the %USERPROFILE%/jade_demo folder and rename it to jade_settings.ini
• For Unix users:
  • Create a jade_demo folder in your user home directory with a and b sub-folders like this:

    • mkdir ~/jade_demo
      mkdir ~/jade_demo/a
      mkdir ~/jade_demo/b

  • Download the jade_settings_unix.ini file containing the example profiles presented in this article to the ~/jade_demo folder and rename it to jade_settings.ini

:

• For Windows users the location for the jade.cmd file is:
  • C:\Program Files\sos-berlin.com\jade\client\bin
  • or the location that was specified when installing YADE
• for Unix users the location for the jade.sh file is:
  • ~/sos-berlin.com/jade/client/bin
  • or the location that was specified when installing YADE

Note that comments in the YADE settings profiles are added using double semi-colons (";;").

Running the examples

• Either open the command line interface in the location where you have installed the jade.cmd or jade.sh files or use suitable path name prefixes.
• The command line parameterization is identical for both the Windows and the Unix command line.
• Run the examples by entering the following in the command line, e.g. for the first of the examples listed below:

jade.cmd -settings="%USERPROFILE%\jade_demo\jade_settings.ini" -profile="ftp_server_2_local"

./jade.sh -settings="${HOME}/jade_demo/jade_settings.ini" -profile="ftp_server_2_local"

Results of the first example

Running the first example using the ftp_server_2_local profile listed in the code blocks above will cause six test*.txt files to be downloaded to the a sub-folder of the jade_demo folder created following the instructions in the Setting up the Examples section above.

Note for Unix Users

All other examples in this series of articles list the profile settings and command line call for Windows environments. Unix users will find suitable profile settings in the Unix version of the jade_settings.ini file which was linked above and will be able to adapt the Windows command line calls in the manner shown above.

Using the tutorials with the JobScheduler YADE JITL Job

The YADE JITL job tutorial is available with JobScheduler - Tutorial 5 - The YADE JITL Job - Configuring and running file transfer jobs.