4.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 PFM - Agent or PFM - RM is installed on the same machine as PFM - Web Console, you have to uninstall PFM - Agent or PFM - RM and delete the folders for products# other than PFM - Base before uninstalling PFM - Base.
Additionally, if PFM - Agent or PFM - RM is installed on the same machine as PFM - Manager, you have to uninstall PFM - Agent or PFM - RM and delete the folders for products# other than PFM - Manager before uninstalling PFM - Manager.
- #
-
agt? (where ?=1-9 or a-z)
(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 4.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
-
If uninstallation is performed under the following conditions, some files or folders may remain. If such is the case, delete all the files and folders contained in the installation destination folder. If PFM - Web Console is used on a logical host environment, delete all the files and folders contained in the environment directory (folder) on the shared disk as well.
-
The programs or services for PFM - Web Console are running.
-
A file or folder within the installation destination folder are referenced.
-
-
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 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.
(7) 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/SLM, the monitoring targets can no longer be checked in JP1/SLM's Troubleshoot window. Therefore, before you uninstall PFM - Manager or PFM - Base, release the linkage between Performance Management and JP1/SLM. For details about how to release the linkage, see the chapter in the JP1/Performance Management User's Guide that describes monitoring with a service-level management product (JP1/SLM) linked.
-
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 JP1/Performance Management User's Guide that describes monitoring of agents. For details about how to delete alarm definition information, see the chapter in the JP1/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 JP1/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.
-
If you want to perform unsetup of PFM - Agent or PFM - RM for which auto alarm table bind is enabled, and if you have no intention of using auto alarm bind with these products in the future, disable auto alarm table bind set for these products before performing the unsetup procedure. For details about how to specify the auto alarm table bind setting, see the section providing the procedure for auto alarm bind in the JP1/Performance Management User's Guide.
-
If you want to hide product information on the Alarms page and Reports page of PFM - Web Console, unregister the product information by using the jpcconf agent setup -unregister command. For details, see the section describing the jpcconf agent setup -unregister command in the manual JP1/Performance Management Reference.
-
When you uninstall the Performance Management program version 11-50 or later, the path to which to store commands that has been added to the system environment variable PATH during installation gets deleted. If an attempt to delete the path fails, a message dialog box appears, but the uninstallation of the Performance Management program ends successfully.