--disable

Syntax

kenaflow.exe --disable ["<time-span>"]

< kenaflow 4.0.24

kenaflow.exe --disable "<time-span>"

Description

This can be used to disable the kenaflow engine at all.

If executed from an admin command line ("Run as Administrator") all running processes of the kenaflow instance stop immediately.

The disabled state ends automatically after the time specified in value <time-span>.

Starting with kenaflow 4.0.24 the disabled state can last forever when no <time-span> value was specified with switch --disable.

<time-span> requires a setting in a format that is understood by static method System.TimeSpan.Parse.

Examples:

  • 1.0:0:0 => 1 Day
  • 1:0 => 1 Hour
  • 0:10 => 10 Minutes

This command creates a file named .disabled in the kenaflow program folder. The file contains the date and time until kenaflow is disabled. Format of the string is: yyyy-MM-dd-HH-mm-ss. Just 1 line. No characters before or after the datetime string.

Starting with kenaflow 4.0.24 the file can be empty with exactly 0 by length. (Be aware of "BOM" for UTF-8 files!) IF the file hat zero bytes the disabled state lasts forever.

You can create the .disabled file manually, for example as part of your automated system patch mechanism. Before patching OS or, for example, SharePoint, you could create the file and remove it after you are finished.

When you watch the processes on the kenaflow server you will see kenaflow starting regulary (- as long as you use the Windows scheduled task to run kenaflow and did not disable it). "DISABLE" does not mean that there is absolutely activity from kenaflow. It just means that no workflows are executed. In fact kenaflow does check the existence of the .disabled file very early, tries to read its content, and disables without further delay if the time for re-enabling has not come. If kenaflow recognizes that the date/time in .disabled has come the .disabled file gets deleted and the engine runs the workflows.

_kenaflow can be enabled with --enable.

This command line switch must be run "as administrator" (high priviledges).