NAME

      mxagentconfig - configures the agent to work with a CMS

SYNOPSIS

      mxagentconfig [-g]
      mxagentconfig -a ( -n  <hostname> )+ [ -u	 <login> ] -p  <password> ) |
      ( -f  <filespec> ))
      NOT ENABLED - mxagentconfig -r ( -n  <cms_hostname> )+ [-F]
      NOT ENABLED - mxagentconfig -l

DESCRIPTION

      The mxagentconfig Configures SSH on a managed node by pushing the CMS
      public key to a users Each "run-as user" will need to have the CMS
      public key added to their authenticated keys file in order to use the
      Distributed Task Facility (DTF) to executed tasks on the specified
      managed node (including the CMS itself).	Please note that tool
      definitions which do not specify a run-as user will run as the calling
      user.

      The password that is required for this command is the login password
      of the specified user on the managed node.  If the -u option is not
      given then the default values of root, Administrator, and
      <current_user> are attempted with the given password.

      The CLI command can accept multiple hostnames.  The user account and
      password must be the same for all hostnames given with a single
      command.

    OPTIONS
      mxagentconfig recognizes the following options:

	   -g		  Launches the graphical user interface for
			  mxagentconfig.

	   -l		  Lists the servers and agents which are registered
			  on the system.

	   -a		  Directs mxagentconfig to push the CMS public key
			  to a given user on one or more nodes to manage.

	   -r		  Directs mxagentconfig to remove the CMS public key
			  for the given user from one or more managed nodes.

	   -F		  In case the managed node cannot be contacted, this
			  option will removal name of the managed node from
			  a list on the CMS.

	   -n <hostname>  Specifies the hostname of a node to manage.

	   -u <login>	  The user name to enable SSH execution.

	   -p <password>  The password of the given user on the managed
			  node.

	   -f <filespec>  Specify an input file.

RETURN VALUE

      Upon completion, mxagentconfig returns one of the following error
      codes:

	     0	The agent was correctly configured and no errors occurred.
	    >0	An error occured during operation.

AUTHOR

      mxagentconfig was developed by the Hewlett-Packard Company.

FILES

      Server: /etc/opt/mx/config/sshtools/.dtfSshKey.pub Managed Node:
      ~/.ssh/.<cms_name>.dtfSshKey.pub ~/.ssh/authorized_keys2
      ~/.ssh/authorized_keys2.bak

SEE ALSO for HP-UX

      mxexec(1M).

SEE ALSO for Linux

      mxexec(8).