1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
|
.. _archive_cli:
archive
*******
.. rubric:: Output of :code:`--help=archive`
The following help text is generated by :code:`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.
|
