4.2.8 Points to note before installing PFM - Agent for Platform
Note the following points when installing and setting up Performance Management.
- Organization of this subsection
(1) Notes on the registry
PFM - Agent for Platform can only be run on environments set up using the standard method provided by the OS. Despite the information provided by Microsoft technical support, if the OS environment is customized such as by using a registry editor to directly edit registry information, performance data might no longer be collected properly.
(2) Notes on environment variables
Because Performance Management uses JPC_HOSTNAME as an environment variable, do not set it as a user-specific environment variable, as this will prevent Performance Management from operating properly.
(3) Notes on installing and setting up multiple Performance Management programs on the same host
With Performance Management, you can install PFM - Manager, PFM - Web Console, and PFM - Agent on the same host. When doing so, note the following points:
-
If you are installing PFM - Manager and PFM - Agent on the same host, you do not need PFM - Base. In this case, because the prerequisite program for PFM - Agent is PFM - Manager, install PFM - Manager first, and then install PFM - Agent.
-
You cannot install PFM - Base and PFM - Manager on the same host. To install PFM - Manager on the host on which PFM - Base and PFM - Agent are installed, first uninstall all Performance Management programs except PFM - Web Console, and then install PFM - Manager, followed by PFM - Agent. To install PFM - Base on the host on which PFM - Manager and PFM - Agent are installed, first uninstall all Performance Management programs except PFM - Web Console, and then install PFM - Base, followed by PFM - Agent.
-
When you install PFM - Agent on a host on which PFM - Manager is installed, PFM - Manager of the local host becomes PFM - Manager for the connection destination. In this case, you cannot change PFM - Manager for the connection destination to PFM - Manager of a remote host. To connect to PFM - Manager of a remote host, make sure that PFM - Manager is not installed on the host on which you want to install PFM - Agent.
-
Before installing PFM - Agent on a host on which PFM - Web Console is installed, close all browser windows.
-
When a Performance Management program is newly installed, the status management function is enabled as the default. However, if you upgrade from version 07-00 to 08-00 or newer, the settings for the status management function remain the same as they were in the older version. For details about how to change the settings for the status management function, see the chapter explaining error detection in Performance Management in the JP1/Performance Management User's Guide.
- Tip
-
To improve system performance and reliability, we recommend running PFM - Manager, PFM - Web Console, and PFM - Agent on separate hosts.
(4) Notes on version upgrade
For notes about upgrading the Performance Management programs, see the section that presents notes about upgrading in the chapter describing installation and setup in the JP1/Performance Management Planning and Configuration Guide.
For notes about upgrading PFM - Agent for Platform, see Appendix G. Upgrade Procedure and Notes on Upgrading.
For details about upgrading, see the appendix in the JP1/Performance Management Planning and Configuration Guide.
(5) Other notes
-
If you install PFM - Agent for Platform while another Performance Management program or service is running, or while another program (such as Windows Event Viewer) that might reference Performance Management files is running, a message prompting a system restart might be displayed. In this case, follow the message and restart the system to complete the installation.
-
If you install PFM - Agent for Platform while another Performance Management program or service is running, while another program (such as Windows Event Viewer) that might reference Performance Management files is running, while there is insufficient disk space, or while a folder permission is not valid, file expansion might fail. If any Performance Management programs or services are running, or if any other programs that reference Performance Management files are running, stop all these programs first, and then re-install PFM - Agent for Platform. If disk space shortage or invalid folder permission is a problem, resolve these issues first, and then reinstall.
-
When installing the Performance Management program, check whether any of the following security-related programs are installed. If they are installed, perform the measures explained.
-
Security monitoring programs
Stop or change the settings for security monitoring programs so that installation of the Performance Management program is not prevented.
-
Virus detection programs
Stop any virus detection programs before you install the Performance Management program.
If a virus detection program is running during installation of the Performance Management program, the installation speed might suffer, and installation might not be executed, might not be performed correctly.
-
Process monitoring programs
Stop or change the settings for any process monitoring programs, so that monitoring is not performed for Performance Management services or processes, and Common Component services or processes.
If a process monitoring program starts or stops these services or processes during installation of the Performance Management program, installation might fail.
-