Skip to content

Create a runtime

Creating a runtime means installing it somewhere, even on a laptop computer. Here is described the procedure to create a runtime item, which is a prerequisite to the installation of the actual runtime. The item represents the runtime in EI-Flow and allows the runtime to exchange commands and data with NL FLow.
As described in the introduction, the communication between a runtime and the reference installation of EI-Flow is mono-directional, it always originates at the runtime: the runtime periodically provides information about itself, and this information is stored in the corresponding runtime item. This is how EI-Flow users know about the runtime, its status and its capabilities. When they want to interact with a runtime to publish, interactively test or unpublish workflows, they indeed "leave their orders" inside the runtime item, where the runtime picks them up the first time it connects to NL FLow again.

The above communication has nothing to do with programmatic use of workflows published in the runtime, which is achieved via the workflow APIs. A runtime may not connect to EI-Flow, yet it may be possible to use published workflows via their API, because client programs connect directly to the runtime.

To create a runtime item, go to the Runtimes view of the dashboard and:

  1. Select Create: a dialog appears.
  2. Choose an identifying color, enter the name and, if you want, a description for the new runtime item.
  3. If your user belongs to the Owner role, choose between Public and Private. If your user belongs to another role, there will be no choice and the runtime item will be created as private.
    A private runtime item is initially visible and manageable only by its creator, who is also its initial owner, but the owner can share the item with others and even give away his ownership. If a user belongs to the Owner role he can edit the properties of a private runtime item and make it public or vice versa, that is make a public item private.
  4. Select Create: a dialog appears to confirm the creation of the runtime item and it displays the connection token.
    The connection token contains the information that allows the actual runtime to connect to its runtime item inside the EI-Flow. It must be put inside the configuration of the actual runtime when that is installed.
  5. Select Copy to clipboard to copy the connection token to the clipboard.
  6. Paste the content of the clipboard in a safe place because the connection token is available only when the runtime is created and cannot be displayed in the EI-Flow designer Web application anymore, even if it can be regenerated.
  7. Select Close.

Now you can give the connection token to the responsible for the installation of the actual runtime, which will put it inside the runtime configuration.
Once the runtime has been installed and started, it should automatically start connecting regularly to EI-Flow. Browse the runtime items to check the connection status of the corresponding runtimes.