amgr_remote_config(1M)

NAME

amgr_remote_config — Access HP Application Discovery Certificates Remotely from the Central Management Server (CMS)

SYNOPSIS

Path: /opt/amgr/bin/amgr_remote_config

amgr_remote_config -a [-mx] [-n hostname] [-u login] [-dir directory]

amgr_remote_config -c [-mx] [-n hostname] [-u login]

amgr_remote_config -r [-mx] [-n hostname] [-u login]

amgr_remote_config -start [-mx] [-n hostname] [-u login]

amgr_remote_config -stop [-mx] [-n hostname] [-u login]

DESCRIPTION

From the central management server, the amgr_remote_config command allows you to interact with an Application Discovery agent on a managed node to print its certificate or to remove a counterpart CMS certificate, and to check the status of the agent on that node.

You can execute amgr_remote_config from the HP System Insight Manager graphical user interface or from the command line on the central management system. You will need root access to use this command.

Options

If no options are specified, the usage string is printed and the command exits.

The amgr_remote_config command recognizes the following options.

-a: Exchange certificates between the central management server and the managed node.
-c: Check agent state on a managed node. Agent state is printed.
-dir path: Designate the path to the directory where the certificates are located. The default location for certificates is /var/opt/amgr/ssl.
-mx: Use HP Systems Insight Manager's CMS credential to invoke the remote Application Discovery agent configuration program. Note: -u and -dir are ignored when -mx is specified.
-n hostname: Name of system where task is to be done.
-r: Remove the target CMS certificate from a managed node.
-start: Start the agent as a daemon on a managed node and enable restart on reboot.
-stop: Stop the agent on a managed node and prevent restart on reboot.
-u login_info: User login information for entry on the managed node. This option is necessary when *not* using -mx, and user must be root or similarly privileged.

Installation

The amgr_remote_config command can be installed from a depot available on the HP VSE Managed Node Software Update Web site. For installation instructions, please visit the VSE Management Web site at the following URL:

http://docs.hp.com/en/vsemgmt/agents.html

Beginning with VSE Management Software Version A.03.00.00, amgr_remote_config is installed on the CMS when the VSE Management Software is installed.

RETURN VALUES

0: The command completed successfully; no errors were detected.
1: SSH command shell itself returned with error.
2: An error occurred and the command did not complete successfully.
3: Unrecognized command parameters are detected.
4: Missing post-install configuration of AD agent is detected.
5: Missing post-install configuration of AD CMS is detected.
6: Specified host name contains invalid characters.

EXAMPLES

Exchange certificates between HP Application Discovery CMS and managed node foo.hp.com using HP System Insight Manager mxexec:

# amgr_remote_config -a -mx -n foo.hp.com

Exchange certificates between HP Application Discovery CMS and managed node foo.hp.com without using -mxexec.

For example, aduser has login access on a managed node with root privileges. CMS certificates are copied into /var/opt/amgr/ssl on the managed node:

# amgr_remote_config -a -n foo.hp.com -u aduser -dir /var/opt/amgr/ssl

Check the state of HP Application Discovery agent on managed node foo.hp.com using HP System Insight Manager mxexec:

# amgr_remote_config -c -mx -n foo.hp.com

AUTHORS

amgr_remote_config was developed by Hewlett-Packard Company.

FILES

/opt/amgr/bin/amgr_remote_config: Remote Application Discovery agent configuration program
/opt/amgr/lib/AmgrRemoteConfig.jar: Helper Java program for amgr_remote_config
/var/opt/amgr/ssl/cms.host: CMS host name
/var/opt/amgr/ssl/cms_cert.pem: Application Discovery CMS certificate
/var/opt/amgr/ssl/tempcerts/: Application Discovery temporary certificate directory

amgr_remote_config(1M)

Technical documentation

» Table of Contents

» Glossary

» Index