Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Comment: Download attachments reattached

Table of Contents

Introduction

Excerpt Include
YADE Client
YADE Client
nopaneltrue

YADE Command Line Interface

Excerpt Include
YADE Command Line Interface
YADE Command Line Interface
nopaneltrue

Read more ...

YADE API

Excerpt Include
YADE API
YADE API
nopaneltrue

Read more ...

YADE JITL Jobs

Excerpt Include
YADE JITL Jobs
YADE JITL Jobs
nopaneltrue

Read more ...

About these tutorials

Tutorial Scope

Excerpt
  • The YADE tutorials provide a basis for learning how to use the YADE Client via the Command Line Interface mentioned above. They are intended to function as a Getting Started Guide before proceeding to increasingly complex examples.
  • The tutorials describe operation of the YADE Client from the command line, e.g. by using a batch script. The other methods of operating the Client are:

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:
    • 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

The XML Editor should be installed.

Setting up the examples

  • 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:

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

Running the examples

Code Block
languagebash
titleWindows
jade.cmd -settings="%USERPROFILE%\jade_demo\jade_settings.ini" -profile="ftp_server_2_local"
Code Block
languagebash
titleUnix
./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.

 

Display children header