sun.com | docs.sun.com |  | How To Buy | My Sun | Worldwide Sites |

A B C D E F G H I J K L M N O P Q R S T U V W X Y Z

Maintenance Commands | nhpmdadm(1M)

- NAME
- SYNOPSIS
- DESCRIPTION
- OPTIONS
- EXAMPLES
- EXIT STATUS
- MESSAGE LISTS
- CAUTION
- ATTRIBUTES
- SEE ALSO

## NAME

> nhpmdadm - process monitor daemon administration tool

## SYNOPSIS

> `/opt/SUNWcgha/sbin/nhpmdadm [-l nametag ] [-L]`

## DESCRIPTION

> The `nhpmdadm` tool provides the administrative command-line interface to the process monitor daemon, `nhpmd`(1m). See the `nhpmd` man page for more information about this daemon.

> The options with `nhpmdadm` that are available are `-l` and `-L`.

> Note – Do not kill or stop `nhpmdadm -L` or `nhpmdadm -l nametag` commands.

## OPTIONS

> The options -l and -L are supported for troubleshooting purposes. They can be used to get information about monitored processes.

> -l nametag

>   Prints out status information about `nametag`. The output from this command is useful mainly for diagnostic purposes.

> -L

>   Returns a list of all tags currently running that belong to the user that issued the command or, if the user is superuser, all tags running on the server.

>   For a list of the nametags and the daemons to which they correspond, see the `nhpmd`(1M) man page.

## EXAMPLES

> This section provides examples of using the `nhpmdadm` command.

> Example 1. How to use `nhpmdadm`

> > - To get all nametags:

> >   >     # nhpmdadm -L

> >   Result:

> >   >     tags: utmpd sendmail nscd cron syslog nfs.client inetsvc rpc

> > - To get detailed information about a specific nametag, for example, `cron`:

> >   >     # nhpmdadm -l cron

> >   Result:

> >   >     # nhpmdadm -c cron -n 2 -a /etc/opt/SUNWcgha/init.d/cron.HA.fail
> >   >             environment:
> >   >                     PATH=/usr/sbin:/usr/bin
> >   >                     TZ=MET
> >   >     		            ...
> >   >                     _
> >   >             retries: 0
> >   >             owner: root
> >   >             monitor children: all
> >   >             pids: 341

> Example 2. To Verify a Daemon Is Being Monitored

> > - Log in to a node, as superuser.

> > - Select a daemon to investigate.

> > - Confirm that the daemon is running.

> >   >     $ pgrep -x daemon-name

> > - Note the process ID for the daemon.

> > - Find the nametag for the daemon:

> >   >     # /opt/SUNWcgha/sbin/nhpmdadm -L

> >   Alternatively, use the tables in the `nhadm`(1M) man page to find the Daemon Monitor nametag that corresponds to the daemon that you want to investigate.

> > - Using the daemon `nametag`, run:

> >   >     # /opt/SUNWcgha/sbin/nhpmdadm -l nametag

> >   A list of process IDs is displayed for the Daemon Monitor nametag.

> > - Confirm that the process ID entry for this daemon in the list is the same as the process ID returned by the `pgrep` command.

> >   If this is the case, the daemon is being monitored. If not, the daemon is not being monitored.

## EXIT STATUS

> 0

>   The command was completed successfully.

> 1

>   `nametag` doesn't exist, or there was an attempt to create a `nametag` that already exists.

> 2

>   The command timed out.

> >2

>   An error occurred.

## MESSAGE LISTS

> Log file outputs from the `nhpmdadm` tool are made through `stderr`.

> The log files from the Foundation Services daemons are internationalized using the `SOLARIS LC_MESSAGES` database. The message file for the process daemon monitor is in `/opt/SUNWcgha/lib/locale/C/LC_MESSAGES/nhpmd.mo`

> The following is a list of messages that are output to the log files by the `nhpmdadm` daemon.

> - `<tagname> No such <nametag> registered`

>   The specified nametag is not recognized.

> - `Missing command argument`

>   The `nametag` argument is missing from the `-l` option.

> - `Too many command line arguments`

>   There are too many options specified in the command line.

## CAUTION

> The `nhpmdadm` command is a 64-bit application, and cannot be run on a 32-bit kernel.

## ATTRIBUTES

> See `attributes`(5) for descriptions of the following attributes:

> ATTRIBUTE TYPE | ATTRIBUTE VALUE
> --- | ---
> Interface Stability | Evolving
> Availability | SUNWnhpma, SUNWnhpmb, SUNWnhpms

## SEE ALSO

> `nhpmd`(1M)

Netra HAS FS 2.1 | Go To Top | Last Changed September 2004

Company Info | Contact | Copyright 2004 Sun Microsystems, Inc. All rights reserved. Use is subject to license terms.