Hitachi

JP1 Version 12 JP1/Performance Management Reference


jpcconf mgrhost define

Organization of this page

Format

Format 1

jpcconf mgrhost define    -host host-name[,host-name]|-localhost
                         [-lhost logical-host-name]
                         [-noquery]

Format 2

jpcconf mgrhost define -shift
                             [-lhost logical-host-name]

Function

The jpcconf mgrhost define command sets and changes the host name of the PFM - Manager host for the connection destination (Name Server service).

Execute this command in the following cases:

Format 1

When setting or changing the host name of the PFM - Manager host for the connection destination

Format 2

When switching the PFM - Manager host for the connection destination between the primary and secondary hosts for multiple monitoring

To set or change the PFM - Manager host for the connection destination in a logical host environment, you must specify the -lhost option.

To set the host name of the PFM - Manager host for the connection destination for multiple monitoring, you must specify the two hosts in the -host option in Format 1.

To switch the PFM - Manager host for the connection destination between the primary and secondary hosts, for multiple monitoring, you must specify the -shift option as shown in Format 2.

Hosts that can execute the command

Execution permission

To only display the host name of the PFM - Manager host for the connection destination (Name Server service), no execution permission is required.

Only the following users can set or change (with an argument specified) the PFM - Manager host:

In Windows:

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

In UNIX:

User with root user permissions

Installation directory

In Windows:
installation-folder\tools\
In UNIX:
/opt/jp1pc/tools/

Arguments

-host host-name

Specifies the host name of the PFM - Manager host that is to be set as the connection destination. For host-name, specify a string of 1 to 32 bytes, consisting of alphanumeric characters. An IP address cannot be specified.

To set the host name of the PFM - Manager host for the connection destination for multiple monitoring, you must specify two hosts by separating them by a comma (,). Specify two host names so that the host name before the comma indicates the primary host.

When two hosts are specified as described above, the status management function must be enabled. If the status management function is disabled, an error message will be output when the command is executed.

This argument can be executed on the PFM - Base, PFM - Agent, or PFM - RM host. Also, a command with this argument can be executed even if that PFM - Agent or PFM - RM is installed on a physical host and PFM - Manager is installed on a logical host. In this configuration, however, only the PFM - Manager host that is on a logical host can be specified as the connection destination.

If PFM - Manager is installed on the local host, specifying this option results in an error. If PFM - Manager is installed on the PFM - Agent or PFM - RM host, the PFM - Manager for the connection destination is the PFM - Manager of the local host. You cannot specify a PFM - Manager on the remote host as the PFM - Manager host for the connection destination.

If two or more host names are set for the PFM - Manager host, the name to be specified as the connection-destination PFM - Manager host name differs depending on the situation, as shown below:

  • If an actual host name is used as the PFM - Manager monitoring host name:

    In Windows, specify the host name displayed by the hostname command. In UNIX, specify the host name displayed by the uname -n command.

  • If an alias is used as the PFM - Manager monitoring host name:

    Specify the alias.

If the execution host is a PFM - Manager host, the PFM - Manager host for the connection destination can be changed only when the following three conditions are met:

  • The status management function is enabled.

  • Two host names are specified.

  • One of the specified hosts is localhost.

-localhost

Specifies that the local host is to be set for the connection destination.

-lhost logical-host-name

Specifies the host name in the logical host environment for which the PFM - Manager for the connection destination host is to be set or changed.

For logical-host-name, specify a string of 1 to 32 bytes, consisting of alphanumeric characters with no space characters and no periods (.).

For logical-host-name, you cannot specify localhost, an IP address, or a host name beginning with a hyphen (-).

-noquery

If this option is specified, the command does not output any query messages that interrupt command execution, making it unnecessary for the user to respond. Specify this option if you want the command to run in non-interactive mode.

Note, however, that if there are Performance Management services that are running, command execution is interrupted with a KAVE05143-E message. If this message is output, stop all Performance Management services that are running on the local host, and then re-execute the command.

-shift

Switches the primary and secondary hosts to reverse their roles.

This option registers the host name of the current primary host as that of the secondary host and the host name of the current secondary host as that of the primary host.

If two PFM - Manager hosts for the connection destinations have not been registered, an error message will be output when the command is executed.

Notes

Notes on command execution using Format 1

Note on command execution using Format 2

Return values

0

The command terminated normally. (When only one PFM - Manager host for the connection destination is registered)

1

An argument specification is invalid.

2

The user does not have execution permission for the command.

4

Services have not been stopped at the executing host.

10

The command is executing in another session.

11

The user canceled the processing (by entering N at the prompt).

12

The status management function is disabled.

Two hosts have not been registered for PFM - Manager hosts for the connection destinations.

100

The Performance Management environment is invalid.

101

Acquisition of a port number failed.

102

The specified logical host name has not been set up.

200

A memory shortage occurred.

210

A disk space shortage occurred.

211

A file or directory cannot be accessed.

222

A communication error occurred (IP address could not be acquired).

230

Execution of an internal command failed.

255

An unexpected error occurred.

Usage example 1

This example changes the PFM - Manager host for the connection destination to hostmgr:

jpcconf mgrhost define -host hostmgr

Usage example 2

This example changes the PFM - Manager host for the connection destination from a logical host (host name: jp1-ha1) to hostmgr:

jpcconf mgrhost define -host hostmgr -lhost jp1-ha1

Usage example 3

This is an example of executing the command in a multiple-monitoring environment when the execution host is a PFM - Manager host.

Examples of command setting assuming that the primary host is Hostname1 and the secondary host is Hostname2:

Usage example 4

This example changes the destination connection PFM - Manager hosts to Hostname1 and Hostname2 in a multiple-monitoring environment when the execution host is not a PFM - Manager host.

jpcconf mgrhost define -host Hostname1,Hostname2

Usage example 5

This example switches the primary host and secondary host, reversing roles, in a multiple-monitoring environment.

jpcconf mgrhost define -shift