Skip to content

Create a runtime

Creating a new NL Flow runtime means installing it somewhere—even on a laptop computer—but here is described the procedure to create a runtime item, which is a prerequisite to the installation of the actual runtime and a requisite for interacting with it through the NL Flow Web application.

A runtime item is a communication interface, like a socket, that allows the actual runtime to connect to the complete NL Flow installation and communicate with it.
It is through this communication channel that users of the NL Flow Web application can interact with the runtime to publish, interactively test and unpublish workflows.
This communication between the runtime and the complete NL Flow installation has nothing to do with programmatic use of workflows published in the runtime, which is achieved via the workflow APIs. The connection may fail—the runtime becomes "disconnected"—and it may still be possible to use workflows via their API, because the client programs will 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, specify 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 display the connection token.
    The connection token contains the information that allows the actual runtime to connect to its runtime item inside the complete installation of NL Flow. It must be put inside the configuration of the actual runtime when this 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 location like a password manager because the connection token is available only when the runtime is created and cannot be displayed in the NL Flow 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 connect to the complete installation of NL Flow. Browse the runtime items to check the connection status of the corresponding runtimes.