Versions Compared

Key

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

...

  • Modify the resource configuration for an EC pod
  • Modify or add specific add Image Added specific EC properties or Java related properties for an EC pod
  • Modify or enable the criteria for scaling the EC pod
  • Add new Dynamic Real-Time workflows 
  • Remove existing Dynamic Real-Time workflows
  • Add Batch workflow groups to your EC Deployment
  • Remove existing Batch workflow groups.
  • Modify or add services for your EC Deployment
  • Select the Enable on Schedule option
  • Add or update Annotations, Labels and Patches to your EC pod or services.

...

Ui tabs


Ui tab
titleEdit EC

Execution Context

All properties for Execution Context can be edited.

Memory Configuration

You can tweak the JVM Xms and Xmx value of your EC. 

ec_edit memory config

CPU Configuration

You can set the CPU request and limit values for the EC.

ec_edit cpu

Advanced Settings

Under Advanced Settings, there are additional options that will allow you to further customize the EC.

ec_advanced settings

PropertiesDescription
Node Host

Node Host will allow you to choose a node from your Kubernetes cluster to deploy the EC Deployment. Leaving this field empty will allow to allow  to choose from any available nodes.

JVM Arguments

You can add additional JVM arguments for the EC's in your EC Deployment.

Example!

Use this format to add into the insert value window for JVM Arguments



System Properties

System properties for your EC can also be added. For a list of available system properties that you can configure for your EC, see .

Example!

Use this format to add into the insert value window for System Properties



Persistent Storage

Select a Kubernetes PersistentVolumeClaim to have your EC Deployment store its runtime data in a permanent storage option. This keeps the runtime data intact in case the EC Deployment faces an issue that requires it to be recreated. The data will be stored in the /opt/mz/runtime/persistent directory.

Rolling Update

Enabling Automatic Rolling Update will allow to allow  to automatically update the EC pods in an EC Deployment whenever the Platform image is updated.

Rolling update will also help redeploy any dynamic Real Time workflow templates that are in the EC Deployment.

Note!

The workflow template will only be redeployed when you have added a new 'Per Workflow' configurable field to it or when you removed a 'Per Workflow' configurable field.

When you have disabled Automatic Rolling Update, you will still be able to update the EC Deployment by using the Upgrade button in the individual EC Deployment cards from the EC Deployment Overview page. The button will only be visible when the EC Deployment has detected a change in the image version or on the dynamic Real-Time workflow template.

Automatic Rolling Update is enabled by default when creating a new EC Deployment.

Enable on Schedule

If you select this option, the ECD will automatically be enabled according to the schedule of any workflow groups inside the ECD. This option is only available for batch workflows, and once the workflows finish running, the ECD will be disabled until the next run of the workflow group.

If there is a workflow group in the ECD with workflows running in sequence, the ECD will not start and stop between them.

This will allow you to save resources, since you can ensure that ECDs will not run when not needed, without requiring manual operations.

Additional ValuesAdditional options to apply Kubernetes annotations, labels and patches to your EC. Refer to  for more information.

Enabling Auto Scaling

Enabling auto scaling will deploy a Kubernetes Horizontal Pod Autoscaler (HPA) on your EC Deployment. Auto scaling will tell your EC Deployment to create more EC pods, when the current EC Deployment has reached the threshold set by the metrics that are defined in this section.

ec_edit auto scaling

To enable auto scaling, tick the Enable checkbox and fill in values for the following properties:

PropertiesDescription
Min Replicas

This value will indicate the minimum amount of EC pods that will be replicated for the initial set up. 

Max Replicas

This value will indicate the maximum amount of EC pods that can be replicated for the EC Deployment.

Add/Edit Metrics

This button allows you to create or update a threshold for autoscaling. These thresholds are based on metrics values that are exposed by the Prometheus adapter. Once the threshold is reached, the EC Deployment will then create more EC pods to scale with the threshold.

By default, CPU Utilization is used but you can create your own custom metrics to be used instead. You can read more about what the Prometheus adapter does and how metrics are used from

Additional ValuesAdditional options to apply Kubernetes annotations, labels and patches to your EC. Refer to  for more information.



Ui tab
titleEdit Workflow

Edit Workflow

You can edit or delete dynamic Real-Time workflows and Batch workflow groups added to the selected EC Deployment in this section.

Besides editing, you can also add new workflows for Real-Time or Batch workflow group.

Editing Real-Time Workflows

Real-Time Workflows Table Actions

These are the actions you can take for each dynamic Real-Time workflow templates that are added to the table.

Action

Description

EditOpens theEditing Workflow Template side panel and allows you to add more workflows to the workflow template. You will not be able to change the workflow package or the workflow template.
ViewOpens a side panel that allows you to view the workflow template.
DeleteRemoves the workflow template and all the number of workflows that are configured to it.

Editing a Workflow Template

All configurable fields can be edited. While information such as Workflow Package, Workflow Template are disabled from editing.

Editing a Dynamic Workflow

All configurable fields can be edited except the Workflow Name. If you would like to add new dynamic workflow, click on the icon in the Editing workflow template. This will open another panel where you can add dynamic Real-Time workflows to your workflow template.

ec_edit dynamic wf

Fill in the required fields and click on the Save button to update the workflow.

PropertiesDescription
Workflow Name

Name for the dynamic Real-Time workflow. This field cannot be changed when editing a dynamic workflow.

Configurable Fields

If there are any Export Aliases that you have configured in the Workflow Table when creating the dynamic Real-Time workflow template, those fields will appear here and you can customize the values for the fields. These fields can also be configured using External References.

Once you have edited all the necessary fields, click on the Apply button and your changes will now be reflected.

Editing Workflow Groups

ec_edit wf group

Workflow Group (Batch) Table Actions

These are the actions you can take for each workflow group that is added to the table.

Action

Description

EditOpens the dialog window for editing the workflow group, allowing you to add or remove members or edit the workflow group's configuration. 
DeleteRemoves the workflow group. If you have created a dynamic workflow with this workflow group, it will also be removed.

Edit a Workflow Group

By clicking the Edit button opens up a dialog where you will go through steps to change the configuration of the workflow group. These steps are similar to the steps when you create a workflow group.

small


Define

Step 1 allows you to define the properties of the workflow groups. The field in the Define step will be described in the following table. All fields are mandatory in this step:

FieldDescription
FolderEnter the name of the folder that you want your workflow group to sit in. If the folder you have entered does not exist, a new folder with the name will be created.
NameThe name of the workflow group. Only alphanumeric values, dashes and underscores are allowed in the name.
Group Type

Batch & Task - Select this type if your workflow group is comprised primarily of Batch or Task type workflows or workflow groups.

Real-Time - This option is disabled for EC Deployment. Use the Real-Time Workflows option above to create workflows for your Real-Time workflow templates.



Create Workflows

Step 2 allows you to create and edit a new dynamic workflow for the EC Deployment. The workflow templates listed in the table here indicates that all the workflows in the workflow templates are created for this EC Deployment.

This is an optional step and can be skipped.

To start adding Workflows, click on the icon. This will open a side panel where you can select your workflow template.

PropertiesDescription
Workflow Package

A drop down list that presents you with any workflow packages that are in your your  . You can refer to  for more information regarding workflow packages.

Workflow Template

A drop down list that presents you with workflow templates in your or your  or from the selected workflow package.

View TemplateAllows you to view the workflow template.

Adding A Batch Workflow

Clicking on the icon in the Select a workflow template panel will open another panel where you can add Workflows to your workflow template.

Fill in the required fields and click on the Add Workflow button to add the Workflow into the list.

The workflow will only be created upon successfully updating the EC Deployment.

PropertiesDescription
Workflow Name

Name for the workflow. The name must be unique for the chosen Workflow template.

Configurable Fields

If there are any Export Aliases that you have configured in the Workflow Table when creating the workflow template, those fields will appear here and you can customize the values for the fields. These fields can also be configured using External References.



Members

Step 3 allows you to select any existing workflows, workflow templates or workflow groups that will be part of the new workflow group.

What can be constituted as a member is as follows:

  • A workflow, workflow template or workflow group of the same Group Type can be included in the workflow group, even if they are already part of another group.
  • Static and dynamic workflows can be added into the same group.
  • For Dynamic workflows, you can add the workflow template or any workflows that are already part of the template.
  • A workflow , workflow template or workflow group from a workflow package.
  • A workflow template or workflow belonging to the workflow template can be added into the same workflow group. However when setting the prerequisite, you will have to arrange the workflow above the workflow template and the workflow template must set the workflow above it as the prerequisite.
Note!

Workflows that you have created in the Step 2 are included as members by default and cannot be de-selected. These workflows will appear with the naming format of <workflow name>-<ecd name>.


Info!

Workflows and Workflow Groups that were created from a different EC Deployment cannot be selected and will be greyed out.


Info!

When editing, for Workflows created in Step 2, if you do not want them to be part of the workflow group when selecting members, you can return to Step 2 and remove the workflow. However, the removed workflows will remain in Step 3 as greyed out and not selected. It will be removed entirely once the EC Deployment is updated.

You must have at least one member in your workflow group to proceed to the next step.


Order and Prerequisite

Step 4 allows you to arrange the members in a certain order and select any prerequisites for executing the member workflows.

For members with prerequisites, the members will only be executed once the prerequisites have successfully executed. Dynamic workflow templates cannot be assigned as prerequisites for other members, but templates can have prerequisite member workflows.



Schedule

Step 5 allows you to add the schedule for the workflow group. Adding a schedule rule here is the same as adding a Day Plan Schedule in the workflow group on the Desktop.

The following table describes the fields found when adding a new schedule. This step is optional and a workflow group can be created first without any schedule. For dynamic workflow templates, all generated workflows by the workflow template will follow the schedule set by the workflow groups that the dynamic workflow template is grouped into.

Note!

Two scheduled rules should not contradict each another. An example of an invalid configuration: Rule A is set to Tuesdays Off, while Rule B is set to Every 5 minutes between 15:00:00 and 15:05:00 on Tuesdays.


Entry

Description

Schedule type

Execution plan - Select this to set up a normal Day Plan schedule for executing the workflow group.

Day off plan - Select this to set up a time for when the workflow group will suspend its execution. You can only set up a day off plan when there is already an execution plan configured in the workflow group.

Choose Frequency

Select the frequency in which the workflow group will execute.

For Execution plans, you will have the options for Day, Week or Month, where you will be able to set up frequencies like:

  • Every day

  • A specific weekday

  • A specific day of the month (1-31)

  • The last day of the month

For Day off plans, you will only be able to select Week or Month, where you will be able to set up frequencies like:

  • Days off for up to 6 days a week
  • A specific day or days in a week
  • A day in a month
  • Several days in a month

Execution Interval

This option is only available when setting an Execution plan.

Once - Select this if you want the workflow group to execute its members only once during the selected frequency.

Repeatedly - Select this if you want the workflow group to execute and stop its members within a certain time frame of the selected frequency.

Start Time

This option is only available when setting an Execution plan.

Enter a start time for the first execution.

Stop Time

This option is only available when setting an Execution plan.

Enter the time for when execution should stop.

Repeat Every

Enter the interval between execution start time in seconds, minutes, or hours.

Note!

If a member in a group is delayed for some reason, and not finished at the time the execution is set to be repeated, all members in the group will have to wait until the next repeat time. To override this behavior, you can use the Continuous execution on scheduled time setting.


Select DaysThis option appears when you have selected the Day off plan. This option will set the interval of the day(s) off for the week or month.



Execution

Step 6 allows you to set the execution strategy for the members within the workflow group.

The following table describes the fields found in the execution step:

Note!

Execution settings that you configure here, will only apply for workflow members that have not been configured with any execution settings in the workflow properties. Any execution settings configured in the workflow properties will take priority over the ones configured in the workflow group.


Entry

Description

Max Simultaneous Running Workflows

No limit - There will be as many simultaneously running workflows in the workflow group as determined by your specific work environment and equipment.

Specify the Limit - Enter the maximum number of workflows you want to be able to run concurrently.

Note!

This value applies only to the workflow group that you are defining and will not affect members that are workflow groups.


Startup Delay

If Max Simultaneous Running Workflows is set to a value larger than 1, enter the delay (in seconds) of the execution start for each of the workflows that may run simultaneously.

Note!
  • If no value is entered, a short delay will be applied by the system.
  • You can assign a Startup Delay regardless of the members status. Once the delay is up, if the member in turn is disabled, the Workflow group will attempt to execute the next member.


Continuous execution on scheduled time

Select this check box if you want to allow members in scheduled workflow groups to execute on schedule even though all workflow members in the group have not finished execution.

This may be useful in case one member is delayed for some reason, whereby preventing the remaining workflow members from executing on schedule. 

Note!

This feature is not supported for nested group members, only workflow members.

For a workflow group with a member that is delayed over the next scheduled time, this setting will make the member execute immediately when it is finished. The workflow group will be in a continuous Running state, not switching to Idle in between executions as is the default behavior.

This needs to be considered when making configurations based on workflow group states.  


Workflow group specific execution settingsThis check box is enabled to allow distribution rules to be configured by the EC Deployment.
Specify EC Groups
For EC Deployment, an EC Group with the EC Deployment name will be created and this field will display that EC Group. Only one EC Group for one EC Deployment will exist at any one time.
Any new EC pods created by the EC Deployment as a result of auto scaling will be automatically included in the EC Group for this EC Deployment.
You will not be able to edit this field.
Distribution rules

The Distribution rules are applied to all included group members, such as workflows and workflow group configurations. When there are conflicting settings, the members that are lowest in the workflow group hierarchy have precedence.

When the Distribution rules of the workflow group configurations are set on the same level in the hierarchy, they do not conflict with each other.

If an EC Deployment has multiple EC pods, the selected distribution rule will be applied on the EC pods within the EC Group for the EC Deployment. 

Sequential - Starts the workflow on the first EC pod in the EC Group. If this EC pod is not available, it will proceed with the next in line.

Workflow Count - Starts the workflow on the EC pod in the EC Group running the fewest number of workflows.

Machine Load - Starts the workflow on the EC pod in the EC Group with the lowest machine load. Which EC pod to select is based on information from the System Statistics sub-system.

Round Robin - Starts the workflow on the available EC pods in the EC Group in turn, but not necessarily in a sequential order. This is the default option for Distribution rules.

Continue

Enabling this option will cause the workflow group to continue to run until all its members are fully executed or all are aborted.

Note!

This means that groups with real-time workflow members will continue to run until all the members are aborted or stopped manually.


Stop

Enabling this option will cause the workflow group to stop when a member aborts. A batch Workflow member will finish the current batch and then stop, while a real-time workflow will de-initialize and then stop.

Stop Immediately

Select this option to have the workflow group stop immediately when a member aborts. A batch workflow will stop even in the middle of processing a batch.



Changes to the workflow group when editing will be reflected once the EC Deployment is updated.

You can view the workflow group and its members in the Workflow Group Web Interface when the EC Deployment is successfully updated. However, EC Deployment created workflow groups, including any new workflows created under Step 2 will be read only on the Workflow Group Web Interface and will have to be edited or removed on the EC Deployment that it was created from.


Ui tab
titleEdit Network

Edit Network Service

ec_edit network service

To edit a network service, click the Edit button of the selected network. You can edit the properties based on the network type that you have perviously configured when setting up your EC Deployment, as well as adding additional network service(s) to the deployment by clicking the icon.

Ingress

The following are the properties that you can edit for an ingress. 

PropertiesDescription
Name

The name of your ingress. The suggested naming convention will have the ECD name followed by a -ingress at the end, like so <ECDname>-ingress.

You need not follow the suggested name and you can choose to name your service according to your own conventions. However, the name must start with a letter and not end with a dash "-".

TLS Secret Name

The name of the Kubernetes secret that you have created for your ingress.

Host Name

The hostname that has been set for the CN in the TLS certificate used to create the Kubernetes secret.

Port NameThe name of the port for your Ingress Rule.
PathThe HTTP path being used by the HTTP2 Server agent in the dynamic workflow that you have added into your EC Deployment.
PortThe port being used by the HTTP2 Server agent in the workflow that you have added into your EC Deployment.

Cluster IP

The following are the properties that you can edit for a cluster IP:

PropertiesDescription
Service Name

The name of your Cluster IP service. The suggested naming convention will have the ECD name followed by a -clusterip and a sequence number at the end, like so <ECDname>-clusterip-<sequence number>. The sequence number will increase in sequence as you add more service of the same type.

You need not follow the suggested name and you can choose to name your service according to your own conventions. However, the name must start with a letter and not end with a dash "-".

Port NameThe name of the port for your Cluster IP.
Port

The port number used by the service in within the EC Deployment that you will want to expose to the environmentthe  environment.

ProtocolChoose the protocol used by the port, either TCP or UDP.

Load Balancer

The following are the properties that you can edit for a load balancer:

PropertiesDescription
Service Name

The name of your Load Balancer service. The suggested naming convention will have the ECD name followed by a -loadbalancer at the end, like so  <ECDname>-loadbalancer-<sequence number>. The sequence number will increase in sequence as you add more service of the same type.

You need not follow the suggested name and you can choose to name your service according to your own conventions. However, the name must start with a letter and not end with a dash "-".

ProtocolChoose the protocol used by the port, either TCP or UDP.
Port NameThe name of the port for your Load Balancer.
Port

The port number to be used by the collection agents in the Dynamic workflow.

NodePort

The following are the properties that you can edit for a NodePort:

PropertiesDescription
Service Name

The name of your NodePort service. The suggested naming convention will have the ECD name followed by a -nodeport at the end, like so <ECDname>-nodeport-<sequence number>. The sequence number will increase in sequence as you add more service of the same type.

You need not follow the suggested name and you can choose to name your service according to your own conventions. However, the name must start with a letter and not end with a dash "-".

Port NameThe name of the port for your NodePort.
Port

The port number used by the service in within the EC Deployment that you will want to expose to the environmentthe  environment.

ProtocolChoose the protocol used by the port, either TCP or UDP.
External Traffic PolicyYou can set the NodePort to either have cluster or local policy.

Additional Values

You can also apply Kubernetes annotations, labels and patches to the network services. Refer to  for more information.


Ui tab
titleSummary

Summary

Before applying the changes to your EC Deployment, you can review the changes you have made in the Summary page. You can return to any of the previous pages to make additional amendments if required. 

 You can download the yaml file of the EC Deployment for you to customize or to kubectl apply to any other envirother  environment.

ec_summary


You can also switch to Yaml View to inspect the yaml syntax for the provisioning of the EC Deployment itself. However, you will not be able to edit the yaml syntax.

ec_yaml

Clicking on the Done button will redirect you to the EC Deployment Overview page.



...