Quick Start Guide


  • Download and install JSAGA.
  • As a start, you can try the command line interfaces provided with JSAGA (see examples below). Please note that these commands are intended to check your configuration and are provided as examples only. We do not recommend to use them in production.
  • If you install and use several adaptors, default configurations may overlap and you will have to configure adaptors (see configuration examples of plug-ins).
  • Use the SAGA API in your Java code (see code examples).

Security context

  • List supported security context types (with attributes to be set):
    examples/jsaga-help.sh -s missing
  • Example: create a VOMS proxy
    examples/jsaga-context-init VOMS

Data management

  • List supported data management protocols (with supported contexts):
    examples/jsaga-help.sh -d context
  • Example: list entries of local root directory
    examples/jsaga-ls.sh -l $URL

Execution management

  • List supported execution management technologies (with supported contexts):
    examples/jsaga-help.sh -j context
  • Example: get the coordinated universal time on standard output
    examples/jsaga-job-run.sh -Executable /bin/date -Arguments --utc -r $URL
  • Example: get the woker node host name in output file
    # don't forget to escape special characters to prevent them from being interpreted by your shell
    examples/jsaga-job-run -Executable /bin/hostname -Output output.txt -FileTransfer 'result.txt\<output.txt'
    # or create a job description file
    cat << EOF > job.txt
    Executable /bin/hostname
    Output output.txt
    FileTransfer result.txt<output.txt
    examples/jsaga-job-run.sh -f job.txt -r $URL