Name

ovstatus — report status of NNM managed processes

SYNOPSIS

ovstatus [ [-c] [-d] [-v] [managed_process_names...]]

DESCRIPTION

ovstatus reports the current status of the NNM managed processes. ovstatus sends a status request (OVS_REQ_STATUS) to the process management process (UNIX operating system) or service (Windows operating system), ovspmd. If called with one or more managed_process_name arguments, it reports the status for the designated managed processes. If called with no arguments, it reports the status of all managed processes that have been added to the NNM startup file (SUF), including ovspmd itself.

Unlike ovstart, ovstatus does not start ovspmd if it is not already running.

The managed processes are configured by ovaddobj from information in Local Registration Files (see lrf(4)). A managed process is named by the first field in the LRF describing it.

Parameters

ovstatus recognizes the option described below. The first argument that is not an option, and any succeeding arguments, are interpreted as names of managed processes for which to report status, and are passed to ovspmd in the status request.

-c

Output one status line for each managed process.

-d

Report the important stages in its processing, including contacting and sending the status request to ovspmd, and closing the communication channel.

-v

Print verbose messages from managed processes. In particular, this option displays the verbose message from ovuispmd describing all current ovw sessions.

RETURN VALUE

ovstatus normally exits with the status 0 (zero). It returns a non-zero status only if there is a system problem, such as ovspmd not running.

DIAGNOSTICS

ovstatus reports certain command-line errors (in particular, too many arguments) and system errors. The messages are prefixed with ovstatus:, and are intended to be self-explanatory. ovstatus also outputs error messages received from ovspmd. These messages are prefixed with ovspmd:. ovstatus ignores unrecognized options.

ovstatus reports the known state of all OVs_WELL_BEHAVED and OVs_NON_WELL_BEHAVED processes. OVs_DAEMON processes run outside of ovspmd control. They report a PID, a state of unknown, and a final message of Does not communicate with ovspmd , as ovspmd cannot track these processes.

Note that ovspmd can process multiple requests (ovstart, ovstop, or ovstatus) at a time. If any of these commands is being handled, the new request will be queued by type until the previous command has completed.

AUTHOR

ovstatus was developed by the Hewlett Packard Enterprise.

FILES

The environment variables below represent universal pathnames that are established according to your shell and platform requirements. See the nnm.envvars reference page (or the UNIX manpage) for information about using environment variables for the following files:

Windows: %NNM_BIN%\ovstatus

Windows: %NNM_BIN%\ovspmd

UNIX: $NNM_BIN/ovstatus

UNIX: $NNM_BIN/ovspmd

EXTERNAL INFLUENCES

Environmental Variables

$LANG provides a default value if the internationalization variables, LC_ALL, LC_CTYPE, and LC_MESSAGES are unset, null, or invalid.

If $LANG is unset, null, or invalid, the default value of C (or English_UnitedStates.1252 on Windows) is used.

LC_ALL (or $LANG) determines the locale of all other processes started by ovspmd .

LC_CTYPE determines the interpretation of text as single and/or multi-byte characters, the classification of characters as printable, and the characters matched by character class expressions in regular expressions.

LC_MESSAGES determines the language in which messages are displayed.

SEE ALSO

ovstart(1M), ovstop(1M), ovaddobj(1M), ovdelobj(1M), ovspmd(1M), nnmcluster(1M).

Return to Reference Pages Index