JADE Parameter Reference - General

• Schema: SystemPropertyFiles
• Mapping:
  • system_property_files
• Release:
  • YADE-400 Availability starting with 1.11.

YADE allows to specify Java property files at a global level and individually per transfer fragment.

• Properties from Java property files are applied as system properties by YADE.
• Java property files are processed in the specified sequence. Properties that have previously been set will be overwritten by subsquent Java property files.
• First the global Java property files are applied, next the Java property files specified for a transfer fragment are applied.

• Schema: SystemPropertyFile, SystemPropertyFile

Properties from Java property files are applied as system properties by YADE.

• Schema: Logging, Logging

YADE uses the log4j framework for logging and makes use of the following loggers:

• rootLogger
• reportLogger

These loggers are configured by a log4j configuration file which determines that the

• rootLogger logs to stdout.
• reportLogger optionally logs to a file.

If the log4j configuration file is not found then a log4j base configuration is used which logs to stdout.

• Schema: LogFile
• Mapping:
  • log_filename

YADE makes use of the following log4j loggers:

• rootLogger which logs to stdout
• reportLogger which logs to a file

This parameter specifies the location of the file to which the log output of the reportLogger will be written. Should the file not exist then it will be created. If the file already exists then all log output will be appended.

Without specifying this parameter all log output of the reportLogger will be written to

• JobScheduler releases starting from 1.13.3
  • JobScheduler Master / Agent
    • ${scheduler_data}/logs/YADE.log
  • YADE Client
    • Windows - ${java.io.tmpdir}/YADE.log
    • Unix - ${java.io.tmpdir}/${user.name}/YADE.log
• JobScheduler releases before 1.13.3
  • Windows - ${java.io.tmpdir}/Jade-client.log
  • Unix - ${java.io.tmpdir}/${user.name}/Jade-client.log

• Schema: Log4JPropertyFile
• Mapping:
  • log4jPropertyFileName

This parameter specifies the location of a log4j configuration file. Without this parameter the following configuration is used:

• JobScheduler releases starting from 1.13.3 (Log4j 2)
  • JobScheduler Master / Agent
    • JadeReportLog logger in the ${scheduler_install}/lib/log4j2.xml configuration file.
  • YADE Client
    • JadeReportLog logger in the <yade client>/bin/log4j2.xml configuration file.

• JobScheduler releases before 1.13.3 (Log4j)
  • log4j.rootLogger=info, stdout
    log4j.logger.JadeReportLog=info, JadeReportLog
    log4j.logger.JadeReportLog.SOSVfsReportLog=info, JadeReportLog
    #log4j.logger.JadeReportLog=info, JadeReportLog, JadeReportLogHTML
    #log4j.logger.JadeReportLog.SOSVfsReportLog=info, JadeReportLog, JadeReportLogHTML
    log4j.additivity.JadeReportLog = false
    log4j.additivity.JadeReportLog.SOSVfsReportLog = false
    
    log4j.appender.stdout=org.apache.log4j.ConsoleAppender
    log4j.appender.stdout.layout=org.apache.log4j.PatternLayout
    log4j.appender.stdout.layout.ConversionPattern=%t %-5p %-14d{HH:mm:ss,SSS} (%F:%L) ::%M %m %n
    
    # Configuration of JadeHTMLReportLog
    log4j.appender.JadeReportLogHTML=org.apache.log4j.FileAppender
    log4j.appender.JadeReportLogHTML.layout=com.sos.JSHelper.Logging.SOSHtmlLayout
    log4j.appender.JadeReportLogHTML.File=${java.io.tmpdir}/Jade-client.html
    log4j.appender.JadeReportLogHTML.Append=false
    log4j.appender.JadeReportLogHTML.layout.Title=YADE Report Log
    
    # Configuration of JadeReportLog
    log4j.appender.JadeReportLog=org.apache.log4j.RollingFileAppender
    log4j.appender.JadeReportLog.File=${java.io.tmpdir}/Jade-client.log
    log4j.appender.JadeReportLog.MaxFileSize=5000KB
    log4j.appender.JadeReportLog.MaxBackupIndex=30
    log4j.appender.JadeReportLog.layout=org.apache.log4j.PatternLayout
    log4j.appender.JadeReportLog.layout.ConversionPattern=%-21d{HH:mm:ss,SSS}%m %n

• Schema: DebugLevel
• Mapping:
  • verbose

YADE makes use of the following log4j loggers:

• rootLogger which logs to stdout
• reportLogger which logs to a file

The debug level specifies the verbosity of the rootLogger log entries. A value between 1 and 9 can be specified. Higher values cause more detailed information to be logged.

• Schema: ProtocolCommandListener
• Mapping:
  • protocol_command_listener
  • ProtocolCommandListener

YADE makes use of the following log4j loggers:

• rootLogger which logs to stdout
• reportLogger which logs to a file

This parameter activates the logging of the Apache Commons FTP Client. All output will be written by the rootLogger to stdout.

• Schema: Notifications, Notifications

Notifications can be sent by e-mail or by use of the YADE Background Service. The Notifications element allows included elements to reference NotificationFragments such as a MailServerFragment or a BackgroundServiceFragment.

Notifications can be added either at Profile level or at General level:

• Profile: a specific mail server or Background Service is used for notifications of file transfers from this profile.
• General: one mail server or Background Service is used for notifications from all Profiles.

• Schema: MailServerFragmentRef, MailServerFragmentRef

This element references the fragment that is used for mail servers in case of notification of a file transfer operation.

Any number of reusable MailServerFragment elements can be configured and are distinguished by YADE based on their name attribute.

The reference to a fragment is based on the value of the ref attribute of this element to the corresponding name attribute of the MailServerFragment element.

• Schema: Assertions, Assertions

This element does not specify parameters for file transfers but assertions regarding the performance of file transfers. Assertions specify performance indicators that can be checked by a test suite.

This element does not specify a parameter for file transfer operations but an Assertion regarding the expected performance of file transfers. Assertions specify performance indicators that can be checked by a test suite.

The ReturnCode assertion specifies the exit code that is expected as the result of a file transfer. The ReturnCode is a numeric value between 0 and 255.

For YADE a ReturnCode value 0 signals a successful transfer, other values signal a failed transfer.

This element does not specify a parameter for file transfer operation but an Assertion regarding the expected performance of file transfers. Assertions specify performance indicators that can be checked by a test suite.

The Timeout assertion specifies the max. duration of a file transfer that is expected. The Timeout is specified in seconds.

• Schema: Documentation, Documentation

A Documentation can be added to a file transfer configuration that includes a description and a number of links.

The Documentation can be added either at Profile level or at General level:

• Profile: a specific documentation is used for file transfers from this profile.
• General: a general documentation is used for file transfers from all Profiles.

A Description can be added to a Documentation that explains the use of the file transfer configuration.

Descriptions include plain text, i.e. no formatting is applied.

A number of Links can be added to a Documentation that explains the use of the file transfer configuration.

• Schema: RetryOnConnectionError, RetryOnConnectionError
• Release:
  • YADE-556 Availability starting with 1.12.13, 1.13.4.

To control reconnect behavior, the YADE has two options:

• RetryCountMax - number of reconnection attempts (for each single file transfer) if there is a connection failure
• RetryInterval - the wait interval between attempts

• Schema: RetryCountMax
• Mapping:
  • connection_error_retry_count_max
• Release:
  • YADE-556 Availability starting with 1.12.13, 1.13.4.

Sets for each single file transfer the number of reconnection attempts if there is a connection failure.

• Schema: RetryInterval
• Mapping:
  • connection_error_retry_interval
• Release:
  • YADE-556 Availability starting with 1.12.13, 1.13.4.

This option specifies the wait interval between attempts.

Possible values:

• <n> - duration in seconds, e.g.: 3s
• <n>m - duration in minutes, e.g.: 2m
• <n>h - duration in hours, e.g.: 1h

Combined values (with blank as separator):

• e.g.: 1m 30s