3.2.6 Notes about installation and setup in Linux
This subsection provides notes about installing and setting up Performance Management.
- Organization of this subsection
(1) Notes about environment variables
Performance Management uses the JPC_HOSTNAME environment variable. Do not set a user-specific JPC_HOSTNAME environment variable. If such an environment variable is set, Performance Management will not function correctly.
(2) Installing and setting up multiple Performance Management programs on the same host
Performance Management enables you to install PFM - Manager, PFM - Web Console, and PFM - Agent on the same host. This subsection provides notes about such an installation.
-
If you install PFM - Manager and PFM - Agent on the same host, there is no need to install PFM - Base. In this case, PFM - Agent requires PFM - Manager; therefore, install PFM - Manager first, and then install PFM - Agent.
-
PFM - Base and PFM - Manager cannot be installed on the same host. To install PFM - Manager on a host where PFM - Base and PFM - Agent are already installed, uninstall all Performance Management programs (other than PFM - Web Console), and then install PFM - Manager and PFM - Agent in this order. Similarly, to install PFM - Base on a host where PFM - Manager and PFM - Agent are already installed, uninstall all Performance Management programs (other than PFM - Web Console), and then install PFM - Base and PFM - Agent in this order.
-
If you install PFM - Agent on a host where PFM - Manager is already installed, the PFM - Manager on the local host becomes the connection-target PFM - Manager. In such a case, you can no longer change the connection-target PFM - Manager to a PFM - Manager on a remote host. Therefore, if you want to connect to a PFM - Manager on a remote host, make sure that PFM - Manager has not been installed already on the target host.
-
If a PFM - Agent already exists on the host where PFM - Manager is being installed, the local host is redesignated as the connection-target PFM - Manager for that PFM - Agent. The resulting settings are output to the common message log file; check the results.
-
If PFM - Web Console already exists on a host where PFM - Agent is to be installed, close all browser windows before starting installation.
-
When a new Performance Management program is installed, the default is that the status management function is enabled. However, if you upgrade from version 07-00 to 08-00 or later, the settings for the status management function disabled. To change the status management function settings, see the chapter that describes Performance Management failure detection in the JP1/Performance Management User's Guide.
- Tip
-
System performance and reliability are improved by running PFM - Manager, PFM - Web Console, and PFM - Agent on separate hosts.
(3) Upgrading
For details about the precautions to be observed when upgrading from an older version of PFM - Agent, see Appendix H. Migration Steps and Notes on Migration. For details about how to upgrade PFM - Agent, see the relevant appendix in the JP1/Performance Management Planning and Configuration Guide.
(4) Notes about the SAP system employing an ASCS instance configuration
To monitor the SAP system, you need to set up an instance environment for each host that contains a central instance with dialog service (primary application server instance) or a dialog instance (additional application server instance).
(5) Notes on using the remote monitoring function
-
To use remote monitoring, you have to synchronize the system clocks of different hosts by using NTP or different means.
-
If the time zone varies between the host on which PFM - Agent is running and the one on which the monitored SAP system is running, adopt the time zone set for the SAP system by following the steps described in 3.2.5 (11) Setting up a time zone for the SAP system.
(6) Other notes
-
If connection dialogue instance of the SAP system does not have an MTE name for the acquisition, no performance data will be collected from the field of some records because this field does not exist in the connection-target dialog instance. As a result, a warning message (KAVF14173-W) is output to the common message log and Windows event log. This warning message is output regardless of the settings for Log (whether or not the collected performance data is to be recorded in the Store database) in each record.
-
Security monitoring program
Terminate the security monitoring program or change its settings so that installation of the Performance Management programs will not be affected.
-
Virus detection program
Terminate any virus detection program before you install the Performance Management programs.
If a virus detection program is running during installation of a Performance Management program, it might slow down the installation process, the installation might fail, or the program might not install correctly.
-
Process monitoring program
Terminate the process monitoring program or change its settings so that it does not monitor the services and processes of Performance Management or the services and processes of common components.
Installation of a Performance Management program might fail if any of these services or processes is started or stopped by the process monitoring program during the installation process.
-
If you are installing PFM - Agent for Enterprise Applications in an environment in which no Performance Management program has been installed, make sure that there are no files or directories in the installation-target directory.
-
If installation fails with Install failed displayed on the status bar during the installation process, obtain the installation log. It is wise to make a backup of this log file, because it will be overwritten during the next installation. For details about the default file name for the installation log, see 13.4.2(2) Information about Performance Management.
-
If a link is placed in the installation directory to install Performance Management programs, uninstalling all Performance Management programs might not remove all the files and directories from the linked directory. If necessary, manually delete the remaining files and directories. If a Performance Management program is to be installed by linking and the link destination contains a file or directory with the same name, that file or directory will be overwritten when the Performance Management program is installed.