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)