 |
» |
|
|
|
NAMEvseassist — Help Resolve VSE Management Software Configuration Problems SYNOPSISPath: /opt/vse/bin/vseassist vseassist -a [-q] [ -n nodename -g collectionname ]... vseassist { -l -r } [-q] { -n nodename -g collectionname }... DESCRIPTION
The vseassist command performs a number of checks to identify
configuration problems in the Virtual Server Environment (VSE) Management Software.
The VSE Management Software runs under HP Systems Insight Manager (SIM). This
command checks the software configuration on the HP SIM Central Management Server
(CMS), the communication between the CMS and managed systems, and the configuration
of the software on managed systems. A summary of results is displayed, and detailed
results are written to the log file
/var/adm/syslog/vseassist.log, along with recommendations for
resolving any problems found.
You can execute vseassist from the HP SIM graphical user interface, from the
command line on the CMS, or from the command line on a managed system. HP
recommends the following diagnostic procedure:
If you have root access to the CMS, execute the following
command from the command line:
# vseassist -a
This will check the VSE Management Software configuration of the CMS,
communication with all systems in the All VSE Resources
collection, and the VSE Management Software configuration on those systems.
Refer to the summary output and examine the log file for any problems. Follow
the resolution steps in the log file to fix any problems that were found.
Fix problems in the CMS configuration first. You can verify that you have fixed
those problems by executing the following command from the CMS command line:
# vseassist -c
You can also run this command directly from the HP SIM user interface.
From the Diagnose menu, select Troubleshoot VSE
Management, then select Check VSE CMS Configuration.
After you have resolved all problems with the CMS configuration, check to see if
there are any remaining communication issues with the managed systems. From the
CMS command line, specify the HP SIM nodenames or system collection names of
your managed systems using the following command:
# vseassist
-l
{
-n nodename
| -g collectionname
...}
Or, from the HP SIM user interface, select the managed systems, then from the
Diagnose menu, select Troubleshoot VSE
Management, then select Check VSE CMS to Managed Node
Communication.
After you have resolved the communication issues between the CMS and your
managed systems, check the VSE Management Software configuration on those
systems. From the CMS command line, specify the HP SIM nodenames or system
collection names of your managed systems using the following command:
# vseassist
-r
{
-n nodename
| -g collectionname
...}
Or, from the HP SIM user interface, select the managed systems, then from the
Diagnose menu, select Troubleshoot VSE
Management, then select Check VSE Managed Node
Configuration.
If you are unable to resolve issues with one of your managed systems, you can
install or copy vseassist to the managed system
and run it from the command line there. In the following command, replace
cms with the short hostname or fully qualified doman name
of the CMS:
# vseassist -s -h cms
Options
If no options are specified, the command syntax is displayed and the command exits
with return code 3.
The vseassist command recognizes the following options. For each option, a
mnemonic is shown in parentheses to help you remember the option letter.
-
-a
(All) Perform all checks:
Check the VSE Management Software configuration of the CMS (as with the
-c option).
Check the communication between the CMS and the specified managed
systems (as with the -l option). If no managed systems
are specified, then perform this check on all systems in the
All VSE Resources collection.
Check the VSE Management Software configuration of the specified managed
systems (as with the -r option). If no managed systems
are specified, then perform this check on all HP-UX systems in the
All VSE Resources collection.
-
-c
(CMS) Check the VSE Management Software configuration of the CMS.
-
-l
(Link) From the CMS, check the communication between the CMS and the managed
systems specified by the -n and -g options.
Some of the problems detected with this option include expired licenses, no open WBEM
ports, and improperly configured SSH authentication. These checks will
verify if the CMS can communicate with the managed systems in order to
perform VSE management functions.
This option requires one or more -n or -g options.
-
-r
(Remote) From the CMS, check the VSE Management Software configuration of
the HP-UX managed systems specified by the -n and
-g options. This option uses mxexec to
copy the vseassist command to the managed systems, where it is executed
with the -s option.
In order for the -r option to succeed, the CMS must be able
to communicate with the managed systems (as checked by the
-l option).
This option requires one or more -n or -g options.
Note: Remote operation is only possible for
managed systems running HP-UX.
-
-n nodename
(Node) Specifies the name of a VSE managed system, using the node name by which the
system is known to the CMS (as reported by
mxnode(1M)).
Multiple -n and
-g options can be used to specify multiple systems.
Note: This command is not designed to
diagnose problems with non-VSE resources. Specifying non-VSE resources
using -n or -g options will not produce
useful results.
-
-g collectionname
(Group) Specifies the name of a collection of systems known to the CMS. The
specified checks will be performed for each of the managed systems in the
collection. Multiple -n and -g options can
be used to specify multiple systems.
Note: System or collection names that
include spaces must be enclosed in quotes.
Refer to
mxquery(1M)
for more information about collections under HP SIM.
-
-q
(Quiet) No output will be generated on
stdout or
stderr. The results will still be logged to
/var/adm/syslog/vseassist.log.
-
-s
(System) This option is used when running vseassist directly on managed
systems. Some of the problems detected with this option include missing
WBEM providers, stalled WBEM process, and missing required patches.
When you use vseassist with the -r
option on the CMS, mxexec will remotely execute
vseassist on the managed systems using the
-s option.
-
-h cms
(Host) Specifies the short hostname or fully qualified domain name of
the CMS that is managing the system. This option is passed to the remote execution of
vseassist when you use the -r option on the CMS.
Installation
The vseassist 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, vseassist is
installed on the CMS when the VSE Management Software is installed.
RETURN VALUES
- 0
The command completed successfully and no FAIL results were found.
- 1
The command completed successfully and one or more FAIL results were found.
- 2
Warnings, but no FAIL results were found.
- 3
Incorrect options were specified; the command syntax is displayed.
- 4
An unexpected internal error occurred. Contact your HP Support Representative,
your HP Services Representative, or your authorized HP reseller for assistance.
AUTHORS
vseassist was developed by Hewlett-Packard Company.
FILES
- /var/adm/syslog/vseassist.log
Detailed results of the checks performed by vseassist are written to this
log file. Examine the log file for recommended steps to resolve any
problems found. Note: The log file is not
automatically pruned.
SEE ALSO
VSE Management Software online help
VSE Management manuals from http://docs.hp.com/en/vse.html:
VSE Management Software Quick Start Guide Version A.03.00.00, VSE Management Software Installation and Update Guide Version A.03.00.00, VSE Management Suite Troubleshooting Guide
Related manpages:
capcollect(1M), mxexec(1M), mxnode(1M), mxquery(1M), vseinitconfig(1M), vselicense(1M)
|
Printable version
