archive

Output of --help=archive

The following help text is generated by ecflow_client --help=archive

archive
-------

Archives suite or family nodes *IF* they have child nodes(otherwise does nothing).
Saves the suite/family nodes to disk, and then removes the child nodes from the definition.
This saves memory in the server, when dealing with huge definitions that are not needed.
It improves time taken to checkpoint and reduces network bandwidth.
If the node is re-queued or begun, the child nodes are automatically restored.
Use --restore to reload the archived nodes manually
Care must be taken if you have trigger reference to the archived nodes
The nodes are saved to the file ECF_HOME/<hostname>.<port>.<ECF_NAME>.check,
where '/' has been replaced with ':' in ECF_NAME

Nodes like (family and suites) can also to automatically archived by using,
the 'autoarchive' attribute. The attribute is only applied once the node is complete

suite autoarchive
 family f1
    autoarchive +01:00 # archive one hour after complete
    task t1
 endfamily
 family f2
     autoarchive 01:00 # archive at 1 am in morning after complete
    task t1
 endfamily
 family f3
    autoarchive 10     # archive 10 days after complete
    task t1
 endfamily
 family f4
    autoarchive 0      # archive immediately (upto 60s) after complete
    task t1
  endfamily
endsuite

Usage::
   --archive=/s1           # archive suite s1
   --archive=/s1/f1 /s2    # archive family /s1/f1 and suite /s2
   --archive=force /s1 /s2 # archive suites /s1,/s2 even if they have active tasks

The client considers, for both user and child commands, the following environment variables:

  ECF_HOST <string> [mandatory*]
    The main server hostname; default value is 'localhost'
  ECF_PORT <int> [mandatory*]
    The main server port; default value is '3141'
  ECF_SSL <any> [optional*]
    Enable secure communication between client and server.
  ECF_HOSTFILE <string> [optional]
    File that lists alternate hosts to try, if connection to main host fails
  ECF_HOSTFILE_POLICY <string> [optional]
    The policy ('task' or 'all') to define which commands consider using alternate hosts.

The options marked with (*) must be specified in order for the client to communicate
with the server, either by setting the environment variables or by specifying the
command line options.