6.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
Make sure you are the root user when uninstalling Performance Management programs.
(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 directories might remain if you uninstall Performance Management programs while other programs or services, or programs that reference Performance Management files are running. In such cases, manually delete all of the directories and files under the installation folder.
-
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 6.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
-
In the initialization file (config.xml), if you have changed the settings for logDir, bookmarkRepository, and processMonitoringTemplatesRepository to directories other than the default directories, the usual uninstallation procedure will not delete those directories. Before you uninstall PFM - Web Console, check config.xml and manually delete the directories.
-
The uninstall log is output to /etc/.hitachi/.uninstall.log.
-
If uninstallation fails, back up the log (/etc/.hitachi/.uninstall.log) output during the uninstallation process, remove the cause of the problem, and then try again. If JP1/PFM - Web Console does not appear in the list of programs you can uninstall, then install it again, and then repeat the uninstallation process.
-
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.
(6) 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 documentation.
-
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 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.