The Xentara Debugger

Table of Contents

• Connecting to a Xentara Instance
• Interacting with Xentara Using the Debugger
• Connecting multiple Debuggers to the same Xentara instance.

The Xentara debugger is an interactive terminal application that can be used to interact with a running instance of Xentara.

Connecting to a Xentara Instance

Under Linux, the Xentara debugger is called xentara-debugger and is located under /usr/bin. Under Windows, the Xentara debugger is called XentaraDebugger.exe and is located under App in the installation directory.

To start debugging a running xentara instance, simply start the debugger application. If there is a running instance of Xentara, the debugger will automatically connect to it. If there is more than one instance running, the debugger will ask you to select which instance to connect to.

The Xentara debugger can only connect to local Xentara instances, running on the same computer as the debugger. If you want to debug a Xentara instance running on a different host, You must use ssh, or a similar remote connection mechanism, to connect to the Xentara host, and start the debugger from within a remote shell.

Regular users can only connect to Xentara instances running and under the same user. Only the root user (Linux) or an Adminitrator (Windows) can connect to Xentara instances running under a different user.

Interacting with Xentara Using the Debugger

The debugger allows you to perform a variety of actions on the Xentara instance it is connected to by typing commands at the debugger prompt. The following actions are supported:

• Explore the Xentara model tree
• Read and write data points and I/O points
• Get and set the value of arbitrary attributes of Xentara elements
• Get the current operational stage of Xentara
• Suspend and resume Xentara
• Shut down Xentara

The debugger has an extensive built-in help system. Just type help at the debugger command prompt to get help.

Connecting multiple Debuggers to the same Xentara instance.

Xentara is not restricted to a single debugger session. You can connect multiple debuggers to the same Xentara instance, and control Xentare from both of them simultaneously.