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
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
|
.. index::
single: Using ecflow_ui (tutorial)
.. _tutorial-using_ecflowui:
Using ecflow_ui
================
The following diagram shows the typical status changes for a :term:`task`.
.. image:: /_static/tutorial/using_ecflow_ui/image3.png
:width: 6.29167in
:height: 2.125in
The :ref:`ecflow_ui` provides the GUI for ecFlow, which can be launched using to following command:
.. code-block:: shell
ecflow_ui
In order to have an enhanced set of menu options, change the preferences to *Administrator* mode by performing the following steps:
- Open the *Tools* menu.
- Select the *Preferences...* menu option.
- Choose the *Menus* options on the left-hand side of the dialog.
- In the *Menu mode* tab, select *Administrator* in the *Menu mode* drop-down list.
- Press the *OK* button to apply the changes and close the Preferences window.
Once the main :ref:`ecflow_ui` main windows appears, a server can be added by performing the following steps:
- Open the *Servers* menu.
- Select the *Manage Servers...* menu option.
- Select *Add server*, and enter the details in the ECF server dialog.
- Typical values are:
- Name: *MyServer*
- Host: *localhost*
- Port: *3141*
- Protocol: *TCP/IP*
- Add server to current view: *checked*
- Press the *OK* button to close the ECF server dialog.
Add a tree view panel by performing the following steps:
- Open the *Panels* menu.
- Select the *Add tree view panel* menu option.
After adding the server, :ref:`ecflow_ui` should display something similar to the following:
.. image:: /_static/tutorial/using_ecflow_ui/image1.png
:width: 6.64028in
:height: 4.16667in
.. image:: /_static/tutorial/using_ecflow_ui/image2.png
:width: 0.16667in
:height: 0.16667in
The boxes are called nodes, and represent the hierarchy *Server* > *Suite* > *Family* > *Task*.
Nodes can be expanded by clicking on the black triangle on the left-side of the node.
.. note::
:code:`S` - stands for the suite, :code:`F` stands for Family, and :code:`T` - stands for Task
After expanding the nodes, :term:`ecflow_ui` should display something similar to the following:
.. image:: /_static/tutorial/using_ecflow_ui/image22.png
:width: 6.64028in
:height: 4.16667in
Add an info view pannel by performing the following steps:
- Open the *Panels* menu.
- Select the *Add info view panel* menu option.
- n.b. The panels can be moved around by dragging their title bar.
The info panel displays detailed information about the selected node.
For example, selecting a task node will display the task :term:`ecf script`, :term:`job file` and the job output.
Selecting the :term:`node` related to :code:`t1`, and then the *Script* tab in the info panel should display the :term:`ecf script` as follows:
.. image:: /_static/tutorial/using_ecflow_ui/image24.png
:width: 6.64028in
:height: 4.16667in
The :term:`job file` and job output are available on the *Job* and *Output* tabs, respectively.
The tree view panel allows access to a context menu by clicking with the right mouse button on a node, which provides access to a variety of options, including:
#. opening a particular task output in a separate window, via the select the *Output...* menu option.
#. rerunning a task, family or suite, via the select the *Requeue* menu option.
During the execution of the suite, the nodes change colour to reflect the :term:`status` of the nodes.
There can be a long period between the job changing status and that change being
reflected in the :term:`ecflow_ui` (the default update period for UI is set to 60 seconds).
To update the current state more quickly in that window, click the Refresh button in the Toolbar (or press F5).
.. image:: /_static/tutorial/using_ecflow_ui/image25.png
:width: 6.64028in
:height: 4.16667in
Add a table view pannel by performing the following steps:
- Open the *Panels* menu.
- Select the *Add table view panel* menu option.
- Confirm the default options in the Filter dialog box, by pressing *Apply*.
After adding the table view, :term:`ecflow_ui` should display something similar to the following:
.. image:: /_static/tutorial/using_ecflow_ui/image26.png
:width: 6.64028in
:height: 4.16667in
You will notice that selection in the tree view, selects the
corresponding node in the table view.
For reference, the following list indicates the icons that can be displayed in :ref:`ecflow_ui`:
.. image:: /_static/tutorial/using_ecflow_ui/image27.png
:width: 1.875in
:height: 3.52917in
**What to do**
#. Explore :ref:`ecflow_ui`, including adding the tree view, info view and table view panels.
#. Inspect the :term:`ecf script` using the info panel.
#. Requeue the task multiple times, and inspect the output using the info panel.
#. (Optional) Since there can be a long delay (up to 60s) between the job changing status and the change being reflected in the :ref:`ecflow_ui` window, update the current task to change state more or less quickly.
#. (Optional) Explore the Preferences dialog, specifically changing the *Server settings* > *Refresh tab* > *Server refresh period* option to configure :ref:`ecflow_ui` to update the state every second.
|
