Sun Microsystems Logo
Products and Services
 
Support and Training
 
 

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 Commandsnhpmdadm(1M)


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 TYPEATTRIBUTE VALUE
Interface StabilityEvolving
AvailabilitySUNWnhpma, SUNWnhpmb, SUNWnhpms

SEE ALSO

nhpmd(1M)


Netra HAS FS 2.1Go To TopLast Changed September 2004