File: MirrorAttr.rst

package info (click to toggle)
ecflow 5.15.2-2
  • links: PTS, VCS
  • area: main
  • in suites: forky, sid
  • size: 51,868 kB
  • sloc: cpp: 269,341; python: 22,756; sh: 3,609; perl: 770; xml: 333; f90: 204; ansic: 141; makefile: 70
file content (80 lines) | stat: -rw-r--r-- 2,400 bytes parent folder | download | duplicates (2)
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
80
ecflow.MirrorAttr
/////////////////


.. py:class:: MirrorAttr
   :module: ecflow

   Bases: :py:class:`~Boost.Python.instance`

A :term:`mirror` attribute, assigned to a :term:`node`, enables establishing an external link and locally replicate the state of a node executing on a remote ecFlow server.

Although :term:`mirror` attributes can be set at any level (Suite, Family, Task), it only makes sense to assign mirror attributes to Tasks, and only one mirror attribute per node is allowed.


Constructor::

   MirrorAttr(name, remote_path, ...)
      string name: The Mirror attribute name
      string remote_path: The path on the remote ecFlow server to the node being replicated
      string remote_host: The host of the remote ecFlow server
      string remote_port: The port of the remote ecFlow server
      string polling: The polling interval used to contact the remote ecFlow server
      Bool ssl: `true`, when using SSL to contact the remote ecFlow server; `false`, otherwise
      string auth: The path to the Mirror Authentication credentials


Usage:

.. code-block:: python

   t1 = Task('t1',
             MirrorAttr('name', '/remote/task', 'remote-ecflow', '3141', '60', True, '/path/to/auth'))

   t2 = Task('t2')
   t2.add_aviso('name', '/remote/task', 'remote-ecflow', '3141', '60', True, '/path/to/auth')

The parameters `remote_host`, `remote_port`, `polling`, `ssl`, and `auth` are optional


.. py:method:: MirrorAttr.auth( (MirrorAttr)arg1) -> str :
   :module: ecflow

Returns the path to Authentication credentials used to contact the remote ecFlow server


.. py:method:: MirrorAttr.name( (MirrorAttr)arg1) -> str :
   :module: ecflow

Returns the name of the Mirror attribute


.. py:method:: MirrorAttr.polling( (MirrorAttr)arg1) -> str :
   :module: ecflow

Returns the polling interval used to contact the remove ecFlow server


.. py:method:: MirrorAttr.remote_host( (MirrorAttr)arg1) -> str :
   :module: ecflow

Returns the host of the remote ecFlow server


.. py:method:: MirrorAttr.remote_path( (MirrorAttr)arg1) -> str :
   :module: ecflow

Returns the path on the remote ecFlow server


.. py:method:: MirrorAttr.remote_port( (MirrorAttr)arg1) -> str :
   :module: ecflow

Returns the port of the remote ecFlow server


.. py:method:: MirrorAttr.ssl( (MirrorAttr)arg1) -> bool :
   :module: ecflow

Returns a boolean, where true means that SSL is enabled