Problem

A BoKS process needs to be restarted on a remote host but you don't have access to log in to the host.

Solution

BoKS has the ability to remotely debug certain BoKS processes. When a BoKS process is put into debug mode - whether locally or remotely - it must be restarted.

You can make use of the remote debug facility to restart single BoKS processes. For example, if you needed to restart clntd on hostx, you could issue the following command from the Master:


BoKS# rbdebug -h hostx -x0 clntd

By using -x0, you force a process restart without having to actually turn on debugging.

Processes that can be remotely restarted are the ones managed by the boks_init process. These processes are all listed in the $BOKS_etc/boksinit.[replica | client] file. By using the following command, they can be listed:

BoKS # grep ":respawn:" /etc/opt/boksm/boksinit.client | cut -d ':' -f 1

clntd
bridge_clntd_r
bridge_servc_s
udsqd
ifmon
bkstd
bksd
xd
ftcd
cached
sshd
comstated
cron
rolesetcheckd
kslogcleanupd

Note that the sshd entry represents the boks_sshd program. This program cannot be debugged using bdebug or rbdebug, but it is possible to restart the process using the following command:

BoKS# rbdebug -x 0 -h sshd

Also note that some of the listed processes are started only if enabled using a local ENV variable. These can be seen by omitting "| cut -d ':' -f1" in the example above.


Still have questions? We can help. Submit a case to Technical Support.

Last Modified On: May 25, 2018