Hitachi

JP1 Version 12 JP1/Performance Management - Remote Monitor for Platform Description, User's Guide and Reference


3.2.1 Issues to consider before installing the UNIX edition

This subsection describes issues to be considered before you install PFM - RM for Platform.

Organization of this subsection

(1) Prerequisite OS

PFM - RM for Platform runs on Linux (except Linux 8).

(2) Setting up a network environment

To use Performance Management to run PFM - RM for Platform, you must set up a network environment, such as IP addresses and port numbers.

(a) Setting IP addresses

You must set up the environment for PFM - RM for Platform in such a manner that an IP address can be determined from the host name. PFM - RM for Platform will not start in an environment in which IP addresses cannot be resolved.

You use one of the following methods to set host names and IP addresses:

  • jpchosts file (Performance Management's host information configuration file)

  • hosts file

  • DNS

For the monitoring host name, use either the real host name or the alias name.

  • Using the real host name

    In a UNIX environment, specify the name in such a manner that the IP address can be resolved from the host name that is obtained from the result of executing the uname -n command. You can also use the host name that is acquired by the hostname command.

    Note that Performance Management supports DNS, but not FQDN. This means that when you set the IP address, you must use the host name obtained by the uname -n command without the domain name.

  • Using an alias name

    Set the environment in such a manner that the IP address can be resolved from the specified alias name.

For details about setting the name of the monitoring host, see the chapter that describes changing the system configuration in the JP1/Performance Management Planning and Configuration Guide.

Note that the IP address specified in the jpchosts file is not used for IP address resolution with the monitored host.

Notes about setting IP addresses
  • If you use Performance Management in multiple LAN environments, use the jpchosts file to set IP addresses. For details about using the jpchosts file to set IP addresses, see the chapter that describes installation and setup in the JP1/Performance Management Planning and Configuration Guide.

  • Performance Management will not run on a host where IP addresses are assigned dynamically by DHCP. You must set fixed IP addresses for all monitoring hosts.

(b) Settings for using IPv6

Performance Management supports both IPv4 and IPv6 network environments. Therefore, you can run Performance Management even in a network environment where IPv4 and IPv6 coexist.

PFM - RM for Platform can use IPv6 to communicate with PFM - Manager. However, this applies only when the OS of the host on which PFM - RM for Platform and PFM - Manager are installed is Windows or Linux. For details about the applicable scope of communication in the IPv4 and IPv6 environments, see M. Communication in IPv4 and IPv6 Environments.

To communicate using IPv6, you must enable the use of IPv6 on both the PFM - Manager host and the PFM - RM host. Before installing PFM - RM for Platform, you must also enable the use of IPv6 on the PFM - RM host. To configure this setting, execute the jpcconf ipv6 enable command. If the use of IPv6 is already enabled, there is no need to configure this setting. To check whether the use of IPv6 is enabled, execute the jpcconf ipv6 display command.

For details about the jpcconf ipv6 enable and jpcconf ipv6 display commands, see the chapter that describes commands in the manual JP1/Performance Management Reference. For details about the conditions and timing for executing the jpcconf ipv6 enable command, see the chapter that describes an example of a network configuration that includes an IPv6 environment in the JP1/Performance Management Planning and Configuration Guide.

When PFM - RM for Platform will use IPv6 to communicate with monitored hosts, specify a monitored host name that can be resolved.

PFM - RM for Platform uses a resolvable IP address to communicate with a monitoring target. When PFM - RM for Platform communicates with a monitoring target in an environment where IPv4 and IPv6 coexist, PFM - RM for Platform will not try to communicate using another IP address if communication using a resolvable IP address fails.

For example, if a connection attempt using IPv4 fails, PFM - RM for Platform will not retry using IPv6. Conversely, if a connection attempt using IPv6 fails, PFM - RM for Platform will not retry using IPv4. Therefore, make sure that connection can be established beforehand.

(c) Setting port numbers

You must assign a port number to each service of the programs used in Performance Management. Set up the network in such a manner that the port numbers assigned to PFM - RM for Platform can be used for communication.

The table below lists and describes the default port numbers assigned to various services. For other services, an unused port number is assigned automatically each time the service starts.

Table 3‒19: Default port numbers for services (for Windows)

No.

Supported function

Service name

Parameter

Port number

Description

1

Service configuration information management function

Name Server

jp1pcnsvr

22285

Port number used by PFM - Manager's Name Server service.

This port number is set at all hosts of Performance Management.

2

Service status management function

Status Server

jp1pcstatsvr

22350

Port number used by the Status Server service of PFM - Manager and PFM - Base.

This port number is set at the host where PFM - Manager and PFM - Base are installed.

3

Monitoring console communication function

View Server

jp1pcvsvr

22286

Port number used by the View Server service of PFM - Manager.

This port number is set at the host where PFM - Manager is installed.

4

Web service function

Web Service

--

20358

Port number used by the Web Service service of PFM - Web Console.

5

Web container function

Web Console

--

20359

20360

Port number used by the Web Console service of PFM - Web Console.

6

JP1/SLM linkage facility

JP1/ITSLM

--

20905

Default port number specified in JP1/SLM.

Legend:

--: Not applicable

When you use Performance Management in an environment that includes a firewall, you must use fixed port numbers. For details about how to use fixed port numbers, see the chapter that describes installation and setup in the JP1/Performance Management Planning and Configuration Guide.

(3) OS user permissions required for installation

When you install PFM - RM for Platform, make sure that you use an account that has Administrator permissions.

(4) Prerequisite programs

This subsection describes the configuration of programs required in order to install PFM - RM for Platform.

There are two major types of program configurations, as described below. Evaluate the program configurations from the perspective of your system environment.

When installing PFM - RM for Platform on the PFM - Manager host

With this program configuration, PFM - RM for Platform is installed on the same host as PFM - Manager. The following figure shows the program configuration.

Figure 3‒10: Program configuration (when PFM - RM for Platform and PFM - Manager are installed on the same host (for UNIX))

[Figure]

When installing PFM - RM for Platform on a host other than the PFM - Manager host

With this program configuration, PFM - RM for Platform is installed on a host other than the PFM - Manager host. If you use this program configuration, you must install PFM - Base on the same host as for PFM - RM for Platform. The following figure shows the program configuration.

Figure 3‒11: Program configuration (when PFM - RM for Platform and PFM - Base are on the same host (for UNIX))

[Figure]

(a) Prerequisite OSs for monitored hosts

A monitored host must be using one of the following OSs:

  • HP-UX

  • Solaris

  • AIX

  • Linux (including Linux 8)

Note that health check monitoring can monitor hosts and hardware equipment, even not running the prerequisite OSs listed above, that support the ICMP protocol (can communicate through ping command).

(b) Prerequisite programs for Performance Management

PFM - Manager or PFM - Base must be available on the host where PFM - RM for Platform is installed.

If you install PFM - RM for Platform on a host where PFM - Manager is available, PFM - Base is not required. If you install multiple PFM - RMs on a host where PFM - Base is available, you need only one PFM - Base.

You also need PFM - Web Console in order to use PFM - RM for Platform to monitor the operation of monitored hosts.

(5) Environment settings required for collecting performance data (for UNIX)

PFM - RM for Platform uses SSH to collect performance data from monitored hosts. Performance data cannot be collected if SSH connection settings have not been specified. Because SSH authentication uses the public key authentication method, you must specify public key authentication settings. You might need to install other appropriate packages because OS commands are used to collect performance data.

The following describes the required SSH settings.

(a) Installing packages

■ RPM packages required for the PFM - RM host

For details about the RPM packages required for the PFM - RM host, see the Release Notes for this product.

■ Packages required for monitored hosts (SSH)

The packages (SSH) required for a monitored host depend on the OS of the monitored host. For details, see the Release Notes for this product.

■ Packages required for monitored hosts (commands)

For details about the packages required for monitored hosts (commands), see 3.1.1(6)(b) Installing software and packages.

(b) SSH connection settings

Specify the SSH connection settings at both the PFM - RM host and the monitored hosts. For details about the SSH connection settings, see 3.2.5 SSH (for UNIX) connection setting method.

(c) User of a monitored host

If the OS of a monitored host is AIX and a user other than root is to collect information, that user must belong to both the adm group and the system group; otherwise, some information will not be collected.

To ensure that the user belongs to both groups (adm and system), execute the following command at the connection-target monitored host:

$ id
uid=xxx(xxx) gid=x(xxx) groups=0(system),4(adm)

For details about the information that will not be collected, see 7. Records. If the OS of the monitored host is not AIX, this user limitation is not applicable.

(6) Environment settings required for monitoring the operating status (when health check monitoring is used)

To use health check monitoring, the health check function must be set up so that it can monitor the operating statuses of monitored hosts. The following describes the required health check monitoring settings.

(a) Setting the connection-target PFM - Manager

The health check function must be enabled on the connection-target PFM - Manager.

For details about the setting method of the health check function, see the chapter that describes the settings of the health check function in the JP1/Performance Management User's Guide.

(b) Setting at the PFM - RM host

The PFM - RM host must have the following settings enabled:

  • Status management function

    For details about the setting method of the status management function, see the chapter that describes the settings of the status management function in the JP1/Performance Management User's Guide.

  • Monitored host polling

    Set the Health Check for Target Hosts property for the Remote Monitor Collector service of PFM - RM for Platform to Yes.

(c) Setting health check monitoring

Set the TargetType property for the PFM - RM for Platform remote agent to icmp. Health check monitoring can monitor the operating statuses of hosts and hardware equipment that support the ICMP protocol (can communicate through ping command).

For details about the settings of health check monitoring, see 3.2.4(4) Setting the monitored host.

(7) Prerequisite when setting the process operation monitoring condition to 4,096 bytes

When using version 10-00 or later of PFM - Manager and PFM - Web Console, you can set the monitoring condition to be used for monitoring performance to a maximum of 4,096 bytes.

When installing PFM - Base or PFM - Manager on the PFM - RM host, use version 10-00 or later.

(8) Preparing to collect information when an error occurs

If a problem occurs, you might have to collect core dump files as information to be used for investigating the problem. Because the output of core dump files depends on the user's environment settings, check the following settings:

Core dump file size setting

The maximum size of core dump files is limited by the root user's core dump file size setting (ulimit -c). Set up a script as follows:

ulimit -c unlimited

If this setting violates the security policy of the machine being used, turn the script setting into a comment line as shown in the following:

# ulimit -c unlimited
Important

When you turn the script setting into a comment, the core dump will not be output when a trigger for outputting a core dump file occurs, such as when a segmentation error or bus error occurs in a process. Consequently, you might not be able to investigate the cause of the error.

Kernel parameter setting related to core dump (Linux only)

If you change the output destination for the core dump files and their file names from the default settings by using Linux kernel parameter (kernel.core_pattern), you might not be able to collect the core dump files. Therefore, we recommend that you do not change the Linux kernel parameter (kernel.core_pattern) settings.