cmexec(1m) cmexec(1m)
NAME
cmexec - Execute process on a remote Serviceguard node.
SYNOPSIS
cmexec node_name [-o outfile] [-t timeout]
{[command] | [-k cmd_label]}
DESCRIPTION
cmexec will execute a process on a remote Serviceguard node and return any output or return value.
cmexec is limited in several ways. cmexec is best suited for situations where other remote execution facilities are not available. For a
more full featured tool for remote execution within a cluster, see cexec(1m) provided by Distributed Systems Administration Utilities.
To use this command, the local user must have the root access role on the remote node. For more information on Serviceguard access control
policies, see the manual, Managing Serviceguard.
The command will be executed in an environment which matches the local node. All environment variables defined locally will be available
on the remote node.
Output from stderr and stdout for the remote process will be combined and delivered in one transmission. This command should not be used
for interactive commands or commands which will return large quantities of output.
Input via stdin is not supported.
Killing the cmexec process does not stop the remote execution of the command. cmexec should not be used on any command which may hang
without specifying a timeout value.
Options And Arguments
cmexec supports the following arguments:
-o outfile
Write output to the specified file instead of stdout.
-t timeout
Kill the executed command if it does not exit within the specified timeout (in seconds)
node_name
Serviceguard node to execute command on.
command
Command to execute on remote node. May be quoted.
-k cmd_label
This option is only supported for applications provided by Hewlett-Packard.
RETURN VALUE
cmexec returns the exit value for the remote command or 1 if there was an error communicating with the Serviceguard node.
EXAMPLES
Execute an 'ls' in a remote directory.
cmexec node ls /tmp
AUTHOR
cmexec was developed by HP.
SEE ALSO
rsh(1), ssh(1), cexec(1m), cmcp(1m), cmdo(1m), cmsync(1m), cmquerycl(1m), cmviewcl(1m)
Requires Optional Serviceguard Software cmexec(1m)