5.2.1 Before uninstallation and unsetup
The following gives cautionary notes on uninstalling and performing unsetup of Performance Management:
- Organization of this subsection
(1) Notes on the OS user permission required for uninstallation
When you uninstall Performance Management programs, always use an account that has Administrators permissions.
(2) Notes on the network
Even though Performance Management programs are uninstalled, the port numbers defined in the services file are not deleted.
(3) Notes on programs
-
Files or folders might remain if you uninstall Performance Management programs while other programs or services, or programs that reference Performance Management files (such as Windows Event Viewer) are running. In such cases, manually delete all of the folders and files in the installation folder.
-
A message that prompts you to restart the system might be displayed if you uninstall a program while other Performance Management programs or services, or programs that reference Performance Management files (such as Windows Event Viewer) are running. In such cases, restart the system and complete the uninstallation.
-
If a host has PFM - Base and either PFM - Agent or PFM - RM installed, you have to uninstall PFM - Agent or PFM - RM first in order to uninstall PFM - Base. In such cases, uninstall PFM - Agent or PFM - RM, and then uninstall PFM - Base. Additionally, if a host has PFM - Manager and either PFM - Agent or PFM - RM installed, you have to uninstall PFM - Agent or PFM - RM first to uninstall PFM - Manager. In such cases, uninstall PFM - Agent or PFM - RM, and then uninstall PFM - Manager.
(4) Notes on services
-
Stop all Performance Management programs and services in the entire Performance Management system before you uninstall PFM - Manager.
-
Uninstalling only PFM - Agent or PFM - RM does not delete the service information that can be displayed by using the jpctool service list command or the jpctool monitor list command. In such cases, use the jpctool service delete command to delete the service information. For details about how to delete the service information, see 5.2.3 Deleting service information.
-
If you uninstall PFM - Manager and then re-install it on the same machine, two Trap Generator services might be displayed when the jpctool service list command is executed. In such cases, start the PFM - Manager service and use the jpctool service delete command to delete the Trap Generator that is Inactive.
(5) Notes on PFM - Web Console
-
The value of the %TEMP% environmental variable is referenced as the log output folder during the uninstallation of the program. If the %TEMP%% environment variable has not been defined, the log file is not output.
-
In the initialization file (config.xml), if you have changed the settings for logDir, bookmarkRepository, and processMonitoringTemplatesRepository to folders other than the default folders, the usual uninstallation procedure will not delete those folders. Before you uninstall PFM - Web Console, check config.xml and manually delete the folders.
-
If the uninstallation fails, back up the log (%TEMP%\pfmwebconuninst.log) that was created during the uninstallation, remove the cause of the problem, and then uninstall the program again. If uninstalled programs do not include Performance Management - Web Console, install it and then uninstall it.
-
If you uninstall while a list of services is displayed by selecting the Services applet (by choosing Control Panel, Administrative Tools, and then Services or by choosing Control Panel, Administrative Tools, Computer Management, Services and Applications, and then Services), it is possible that the name of PFM - Web Service or PFM - Web Console might not be deleted. Close such windows before the uninstallation.
-
If you uninstall PFM - Web Console while a list of services is displayed in the Services window, the name PFM - Web Service or PFM - Web Console might not be deleted. Close the window before the uninstallation.
-
When you uninstall Performance Management programs from a host that has PFM - Web Console installed, first close all Web browser windows that are logged in to PFM - Web Console and then uninstall the programs.
-
When the uninstallation of PFM - Web Console has finished, you must restart the system to disable the PFM - Web Console settings.
(6) Notes on uninstalling Performance Management in a Windows Server 2008 or Windows Server 2012 environment
If the OS's user account control (UAC) function is enabled, a UAC dialog box might be displayed during uninstallation. If this dialog box is displayed, click the Continue button to continue the uninstallation processing. If you click the Cancel button, the uninstallation processing will be cancelled.
(7) Notes on unsetup of remote agents of PFM - RM
After the unsetup procedure has been performed on the remote agents of PFM - RM (after the jpcconf target unsetup command has been executed), there is no need to execute the jpctool service delete command because the service information is deleted automatically.
However, for the new information to be applied to PFM - Web Console after the unsetup procedure, you must execute the jpctool service sync command.
Service information is deleted at the following time.
-
If PFM - Manager and the PFM - RM service subject to deletion are running
When the jpcconf target unsetup command is executed, a service information deletion request is sent from PFM - RM to PFM - Manager and the service information is then deleted by PFM - Manager.
-
If PFM - Manager or the PFM - RM service subject to deletion is stopped
When the jpcconf target unsetup command is executed, the service information is deleted by PFM - Manager the next time the PFM - RM service is started and connected to PFM - Manager.
(8) Other related notes
-
If an instance environment is set in PFM - Agent or PFM - RM, perform unsetup of the instance environment before uninstalling PFM - Agent or PFM - RM. For details about the unsetup procedure, see the chapters describing installation and setup in the appropriate PFM - Agent or PFM - RM manual.
-
If PFM - Manager or PFM - Base is uninstalled while Performance Management is linked with JP1/ITSLM, the monitoring targets can no longer be checked in JP1/ITSLM's Troubleshoot window. Therefore, before you uninstall PFM - Manager or PFM - Base, release the linkage between Performance Management and JP1/ITSLM. For details about how to release the linkage, see the chapter in the Job Management Partner 1/Performance Management User's Guide that describes monitoring with a service level management product (JP1/ITSLM) linked.
-
If the NNM linkage facility is used, perform unsetup of the facility before uninstalling PFM - Manager or PFM - Base. For details about the unsetup procedure, see the chapter that describes the linkage with Network Node Manager (NNM) for operation monitoring in the Job Management Partner 1/Performance Management User's Guide.
-
If you uninstall or unsetup a PFM - Agent or PFM - RM to which alarm tables have been bound, use PFM - Web Console or the jpctool alarm unbind command to unbound all alarm tables before you start the uninstallation or unsetup procedure.
-
If you have uninstalled or performed the unsetup procedure on PFM - Agent or PFM - RM, delete the agents, if necessary, that are no longer needed from the tree that is displayed when User Agents is selected from the Agents tree in PFM - Web Console. Also, delete any unneeded alarm and report definition information, if necessary. For details about how to delete agents from the Agents tree, see the chapter in the Job Management Partner 1/Performance Management User's Guide that describes monitoring of agents. For details about how to delete alarm definition information, see the chapter in the Job Management Partner 1/Performance Management User's Guide that describes operation monitoring by using alarms. For details about how to delete report definition information, see the chapter in the Job Management Partner 1/Performance Management User's Guide that describes the creation of reports for operation analyses.
-
If the Store database is not located in the default directory, uninstalling the Performance Management programs will not delete the files in the Store database storage directory. In such a case, manually delete all files and subdirectories under the Store database storage directory.