Skip to content

Instances

During the build process it will be necessary to modify and diagnose problems with created process instances.

View instances

View instances in the Process Library Status viewer at the top of the screen. The viewer contains a list of all the workflows, instances and tasks in the system.

Screenshot

To work with two previously created instances (dhtDMServer and dhtTP), first filter the list; entering dht at the top of the Instance column in the viewer will filter the list.

Screenshot

Next, start the instances: right-click on each instance and select Run from the context menu. Instances can also be started from the process instance editor using the Start button.

Screenshot

Look at the log file: right-click the running dhtTP instance and select the Show partial log menu item. This will open the log for the currently running process.

Screenshot

A log pane will open with information similar to the log below. These logs are used extensively to diagnosis problems with the configuration.

Screenshot

Old log files can be viewed even if the process is not running. In the History tab, right-click on an older process (e.g. one that has finished) and select Show Partial Log.

Screenshot

Inspect Instances

Kx Control comes with an interactive development environment (IDE) called Kx Analyst. Kx Analyst can be used to inspect processes, modify processes and develop programs. To open the IDE, right-click on the dhtTP instance in the Process Library Status viewer and select Connect from the context menu.

Kx Analyst (IDE Lite Version) will open in a separate tab in local view.

Screenshot

The (Global) list contains the global functions, tables, lists, etc that are running in the process.

By default, a Scratchpad should be available in which code snippets may be evaluated.

Type tables[] into the pad.

Screenshot

Right-click on the tables[] and select Display from the context menu.

Screenshot

The tables will appear in the Console pane below.

Screenshot

The IDE provides a range of code-development options. See the Kx Analyst documentation for details.

Change instances

Changes to the system will not generally take effect until the affected process is restarted. There are some exceptions:

  • Analytic changes can be pushed to running processes via a manual process
  • Some configuration parameter changes are automatically pushed to running processes
  • Entitlement changes are automatically pushed to running processes

Shut down instances

Process instances can be shut down from the Process Library Status viewer, the process context menu in the tree, or the entity editor. In the Process Library Status viewer or the tree, right-click on the instance and select Stop > Shut Down Q Process. In the process editor, click the Stop button.

Kill instances

Process instances can be killed rather than shut down gracefully. In the Process Library Status viewer or the tree, right-click on the instance and select Stop > Kill-9. If automated restarts are set up upon failure, then the process will restart automatically. A message will appear in the status bar.

Revert instances

Occasionally a change made to a process can cause that process to fail. If the process was previously in a working state, reverting to a previous version may fix it.

Open an entity and select the Revision History subtab.

Screenshot

Right-click on the appropriate version row and select Revert to this version

Screenshot

Changes will take effect on running processes after they are restarted.

Revert the system

The Kx Control process can be accessed directly to view logs, or set and revert to checkpoints.

  • Select Tools > Connect to Control to view the process, open the IDE, etc.
  • Select Tools > Open Viewer > DC Checkpoint to set a checkpoint
  • Select Tools > Open Viewer > DC Checkpoint to revert to a specific checkpoint
  • A checkpoint can be set up automatically on a schedule using the dc_housekeeping_dc_checkpoint process

Screenshot