Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

Info
titlepage under construction

This article makes use of deprecated configuration items and has to be re-worked

Specifying log files

  • JADE YADE can write a separate log file for each transfer it carries out.
  • It can do this when the file transfer is started from the console and when it is started from the chrontab. There are two stages to doing this:
    • specifying the global log file name and
    • specifying the log file name for each transfer.

Specifying the global log file name

  • The log file to be used for a particular transfer is defined in the log4j.properties file.
    • A "rollingFileAppender" is used to configure the "global" log, which is not transfer-specific.
  • The log4j.properties file can be located in the same folder as the settings file. The parameter defining the location of log4j does not have to be explicitly set in the profil.

...

  • the default value for stdout is set by the operating system and
  • the default location for the JADE log file is:
    • /var/opt/sosftp/log/sosdex.log
  • JADE YADE will overwrite the default file name with values set in the log_filename parameter.

...

  • the working directory for chron is not ./jade/bin, where the log4j.properties file is to be found.
  • this means that when starting chron:
    • use cd to navigate to the home directory
    • start jade.sh
    • start runner-script.sh, which switches the working directory to the bin directory
    • the name of the log4j.properties file can then be set with a parameter.

A typical JADE YADE settings file with profiles would look like:

Code Block
languagetext
[FTP_123]
protocol = ftps
#port = 49159
host = myHost
user = ftpUser
password = ***********
log4j_Property_FileName = /opt/sosftp/sosdex_client.1.3.12.2032/profile/log4j.properties

[TEST_FTP_REC_new]
include = FTP_123
port = 49157
log_filename = /var/opt/sosftp/log/my_logfile_name.log
#verbose = 9
history = /var/opt/sosftp/log/history_TEST_FTP_REC_new.csv
file_spec = .*\.txt
force_files = false
remove_files = true
transactional = true
atomic_suffix = .tmp
local_dir = /var/data/input/ftpReceive/
remote_dir = ./

Specifying the log file name for each transfer

The log4.jproperties file is universal. The name specified with the log_filename parameter is extended using the extension ".html" and used for log4j. The trick here is that the definitions in the property file are dynamically modified. This results in two files:

...

The transfer-specific log file is configured in the HTML appender shown in the listing above. The file name in the file is just a placeholder. JADE YADE modifies this to "log_filename".html

Note that at the time of writing in the current (1.5.4014) JADE YADE version a standard and relatively simple log4j layout is used. A modified layout, that includes line breaks, is being tested.

...