Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

A workflow is loaded and started on an EC group according to configured distribution criteria. For example, distribution of the workflow based on machine load, or explicitly specifying the EC groups where the workflow should run. 

...

Code Block
mzsh topo set topo://container:<container name>/pico:<ec name>/obj:settings pico-groups:["<EC Group Name>"]


Note
titleNote!

To run a workflow on a specific EC, an EC group needs to be created. Multiple ECs can be included in an EC group to serve a workflow. There are multiple ways of adding EC groups to the system. Refer to EC Groups for additional information.

If only one EC

should

is to be included in the EC Group, you must:

  1. Create the EC group with the same name as the EC from the UI

  2. Restart EC

If multiple

EC should

ECs are to be included in one EC Group, you must:

  1. Add the property pico.groups to all ECs that should be included by using this command:

    Code Block
    mzsh topo set topo://container:main1/pico:ec1/val:config.properties.pico.groups "myEcGroup"


  2. Restart the ECs. 

Execution Tab in Batch Workflow

...

ItemDescription

Execution Settings

Select Enable to enable setup of the execution parameters.

Distribution

A workflow executes on an EC group. You can specify these EC groups, or the  system can select them automatically. 

Note
titleNote!

EC groups will only be used if you have selected them, the reason for this is to avoid the execution of undesired workflows.

The following options exist:

Sequential - Starts the workflow on the first EC group in the list, if you choose the sequential option and only configure one EC group then the workflow will not run if the EC group is not available. If this EC group is not available, it proceeds with the next in line.

Workflow Count - Starts the workflow on the EC group running with the fewest number of workflows.

Machine Load - Starts the workflow on the EC group with the lowest machine load. 

Round Robin - Starts the workflow on the available EC groups in turn, but not necessarily in a sequential order. If ecg1, ecg2 and ecg3 are defined, the workflow may first attempt to start on ecg2. The next time it may start on ecg3 and then finally on ecg1. This order is then repeated. If an EC group is not available, the workflow will be started on any of the other listed EC groups.

Debug Type

Select Event to enable debug output, such as output from a debug call in the APL code, to appear in the Workflow Monitor .

Select File to save debug results in $MZ_HOME/tmp/debug. The file name is made up of the names of the workflow template and of the workflow itself, for example: MZ_HOME/tmp/debug/Default.radius_wf.workflow_2. Only debug events are written to the file. To save to file all the events that are shown when you select to monitor events in the Workflow Monitor, you must add an event notifier to the relevant Agent Message Event with file output. For further information, see Event Notifications.

If you save debug results in a file, and you restart the workflow, this file gets overwritten by the debug information that is generated by the second execution. To avoid losing debug data of earlier executions, set Number of Files to Keep to a number that is higher than 0 (zero).

Number of Files to Keep : Enter the number of debug output files that you want to save. When this limit is reached, the oldest file is overwritten. If you set this limit to 0 (zero), the log file is overwritten every time the workflow starts.


Info
titleExample - Debug output

The workflow configuration Default.radius_wf includes a workflow that is called workflow_2. Number of Files to Keep is set to 10.

The debug output folder contains the following files:

Code Block
languagetext
themeEclipse
Default.radius_wf.workflow_2    (current debug file)
Default.radius_wf.workflow_2.1  (newest rotated file)
Default.radius_wf.workflow_2.2
Default.radius_wf.workflow_2.3
Default.radius_wf.workflow_2.4
Default.radius_wf.workflow_2.5
Default.radius_wf.workflow_2.6
Default.radius_wf.workflow_2.7
Default.radius_wf.workflow_2.8
Default.radius_wf.workflow_2.9
Default.radius_wf.workflow_2.10 (oldest rotated file)

According to this example there are totally 11 files that are being overwritten one-by-one and the rotation order is:

Code Block
languagetext
themeEclipse
Default.radius_wf.workflow_2
             |
             V
Default.radius_wf.workflow_2.1
             |
             V
Default.radius_wf.workflow_2.2
             |
             V
             :
             :
             |
             V
Default.radius_wf.workflow_2.n
             |
             V
          Deleted



Info
titleExample - Using the option Always Create a New Log File

If you have a workflow named Default.radius_wf with an instance called workflow_2 and you create new debug output files every time the workflow executes, the debug output folder contains files like the following:

Code Block
languagetext
themeEclipse
Default.radius_wf.workflow_2.1279102896375
Default.radius_wf.workflow_2.1279102902908
Default.radius_wf.workflow_2.1279102907149



Note
titleNote!

will not manage the debug output files when this option is used. It is up to the user to make sure that the disk does not fill up.


Anchor
Throughput Calculation
Throughput Calculation
Throughput Calculation

contains an algorithm to calculate the throughput of a running workflow. It locates the first agent in the workflow configuration that delivers UDRs, usually the decoder and counts the number of passed UDRs per second. If no UDRs are passing through the workflow, the first agent delivering raw data will be used. The statistics can be viewed in the System Statistics.

If a MIM value other than the default is preferred for calculating the throughput, the User Defined check box is selected. From the browser button, a MIM Browser dialog is opened and available MIM values for the workflow configuration is shown and a new calculation point can be selected.

Since the MIM value shall represent the amount of data entered into the workflow since the start (for batch workflows from the start of the current transaction), the MIM value must be of a dynamic numeric type, as it will change as the workflow is running.

...