Hitachi

JP1 Version 11 JP1/Performance Management Reference


jpcnodecount

Organization of this page

Format

jpcnodecount    [-h logical-host-name][-i instance-name] | [-m]
                -p service-key

Function

The jpcnodecount command counts the number of nodes managed by PFM - Manager or PFM - RM, and then outputs the number of nodes to the standard output.

Hosts that can execute the command

Execution permission

In Windows:

User with Administrators permissions (executed from the administrator console when Windows UAC functionality is enabled)

In UNIX:

User with root user permissions (user with uid = 0)

Installation directory

In Windows:

installation-folder\tools\

In UNIX:

/opt/jp1pc/tools/

Arguments

-h logical-host-name

Specifies the name of the logical host that manages the nodes to be counted. The command outputs the number of nodes managed by each logical host that is specified here. If this option is not specified, the command outputs the number of nodes managed by each physical host.

Note that this option cannot be specified together with the -m option.

Specifying this option on a standby node generates an error.

-i instance-name

Specifies the name of the instance that manages the nodes is to be counted. If this option is omitted, the command targets all instances.

Note that this option cannot be specified together with the -m option.

-m

  • If you specify this option when executing the command in PFM - Manager, the command outputs the total number of nodes managed by PFM - Manager on physical or logical hosts.

    If the command is executed on the active node when PFM - Manager is running in a cluster system:

    The command outputs the total number of nodes managed by PFM - Manager on physical or logical hosts.

    If the command is executed on the standby node when PFM - Manager is running in a cluster system:

    The command outputs the total number of nodes managed by PFM - Manager on physical hosts.

  • If you execute the command in PFM - RM with this option specified, the command outputs the total number of nodes managed by PFM - RM on all logical and physical hosts under the OS on which the command is executed.

Note that this option cannot be specified together with the -h or -i option.

-p service-key

Specifies the key of the service for which the number of nodes is to be counted. If the product name display functionality is enabled, you can also specify product names. The following are examples of service keys that can be specified:

mgr or Manager: PFM - Manager service

For details about service keys of PFM - Agent or PFM - RM services, see the section that explains naming rules in appendixes in the JP1/Performance Management Planning and Configuration Guide.

Notes

Note the following when specifying PFM - Manager services in the -p option:

Target nodes that are counted

The nodes counted by the jpcnodecount command differ depending on the host on which the command is executed.

Nodes that are counted when the jpcnodecount command is executed in PFM - Manager:
  • The jpcnodecount command counts the number of agents (on the host basis) where the PFM - Manager host on which the command is executed is specified as the connection destination PFM - Manager host.

    Even if multiple applicable agents are installed on a single host, the number of nodes is counted as one.

  • If the local host is specified as the connection destination PFM - Manager host, the number of nodes is counted as one.

  • If an agent is installed on a primary host and a secondary host in a multiple-monitoring environment, the local host is counted as one, and the primary or secondary host is counted as one.

    [Figure]

Nodes that are counted when the jpcnodecount command is executed in PFM - RM:

If the jpcnodecount command is executed in PFM - RM, the monitoring targets specified in PFM - RM are counted. In this case, the monitoring targets refer to those specified in an instance of PFM - RM.

[Figure]

Return values

0

The command terminated normally.

4

The user canceled the processing.

43

The command is now running.

84

There are invalid command arguments.

85

The user does not have execution permission for the command.

86

The command cannot connect to PFM - Manager or PFM - RM.

The specified logical host name has not been set up.

A physical host is specified in PFM - Manager on a logical host.

The specified instance has not been set up.

The specified service key was not found.

The command cannot access the shared disk of the cluster system (when the command is executed on a standby node).

127

Internal error

The Performance Management environment is invalid.

A memory shortage occurred.

A disk space shortage occurred.

A file or directory cannot be accessed.

Usage example 1

This example counts the number of nodes managed by PFM - Manager.

> jpcnodecount -p mgr
10

Usage example 2

This example counts the number of nodes managed by PFM - RM for Platform.

> jpcnodecount -p agt7
250

Usage example 3

This example counts the number of nodes managed by PFM - RM for Platform (instance name: inst01).

> jpcnodecount -i inst01 -p agt7
50

Usage example 4

This example counts the number of nodes managed by PFM - RM for Platform (logical host name: lhost01).

> jpcnodecount -h lhost01 -p agt7
100

Usage example 5

This example counts the number of nodes managed by PFM - RM for Platform (on both physical and logical hosts).

> jpcnodecount -m -p agt7
500

Usage example 6

This example counts only the number of nodes managed by logical host instance linst01 in a PFM - RM for Platform environment (physical host instance: inst01, logical host: lhost01, logical host instance: linst01).

> jpcnodecount -h lhost01 -i linst01 -p agt7
500