Remote Debugging Session

To remotely debugging software, the CLARAty team is using the "xkibitz" remote access tool. This tool unix-based software (also available for Linux) allows two people (the initiator and the host) at remote sites to share a terminal window. The initiator starts the debugging session on their computer and the host allows access to their computer for the remote shell display. Both initiator and host can type and see textual message on the same terminal window.

Initiator = starting the "xkibitz" shared terminal on their machine
Host = receiving, viewing, and accessing the terminal window

Initiator

Make sure you have "xkibitz" in your path. It is usually under /usr/local/bin/
Start by typing "xkibitz" and hit enter at the shell
```
     xkibitz
```
If you get an error when starting it, type the following at the terminal shell:
```
     unsetenv TCL_LIBRARY
     xkibitz
```
Press ^] sequence (i.e. "Ctrl" and "]" buttons simultaneously)
At the xkibitz prompt "xkibitz>" type the name of the host machine you are trying to share the terminal with and press enter. A shared terminal is now viewable by the host
```
     + <hostname>
```
Type the following and press enter. The shared terminal is now accessible by the host
```
     return 
```

Host (before initiator starts)

At the shell type the following:
```
xhost + <initiator hostname>
```