2.2.1 Before uninstallation and unsetup
Note the following points before you perform uninstallation and unsetup of PFM - RM for Virtual Machine.
- Organization of this subsection
(1) Note about the OS user permissions required for uninstallation
-
To uninstall PFM - RM for Virtual Machine, you must perform the procedure as a user with Administrator permissions.
(2) Note about the network
-
Even when you uninstall Performance Management programs, the port numbers defined in the services file are not deleted.
(3) Notes about programs
-
If you uninstall a Performance Management program while another program (e.g., Windows Event Viewer) that references a Performance Management program, service, or file is running, files or folders might remain. In this case, manually delete all the files and folders under the installation folder.
-
If you uninstall a Performance Management program while another program (e.g., Windows Event Viewer) that references a Performance Management program, service, or file is running, a message asking the user to restart the system may be displayed. In this case, restart the system as instructed by the message, and then complete the uninstallation process.
-
If both PFM - Base and PFM - RM for Virtual Machine have been installed on a host, you must first uninstall PFM - RM for Virtual Machine before you can uninstall PFM - Base. In this case, uninstall PFM - RM for Virtual Machine first, followed by PFM - Base. Likewise, if both PFM - Manager and PFM - RM for Virtual Machine have been installed on a host, you must first uninstall PFM - RM for Virtual Machine before you can uninstall PFM - Manager. In this case, uninstall PFM - RM for Virtual Machine first, followed by PFM - Manager.
(4) Note about services
Uninstalling PFM - RM for Virtual Machine alone does not delete the service information that can be displayed using the jpctool service list command. In this case, use the jpctool service delete command to delete the service information.
To get the PFM - Web Console host to recognize that an instance environment has been deleted, execute the jpctool service sync command. This synchronizes the agent information on the PFM - Manager host and the PFM - Web Console host.
For details, see the section about deleting services in the chapter that explains installation and setup in the JP1/Performance Management Planning and Configuration Guide.
(5) Other notes
-
To uninstall Performance Management programs from a host on which PFM - Web Console has been installed, close all browser windows before you perform uninstallation.
-
If message "KAVE05085-E The instance environment could not be deleted." is displayed, Delete instance of logical partitioning feature, KVM or Podman environment after executing following steps.
-
Log in to the PFM - RM for Virtual Machine host with Administrators permissions.
-
Input the following command to command prompt.
- In logical partitioning feature
tasklist | find "HvmSh.exe"
- In KVM or Podman environment
When putty is specified for SSH_Type
tasklist | find "plink.exe"
When windows is specified for SSH_Type
tasklist | find "ssh.exe"
(Note to case sensitive.)
-
If the following message is displayed, input the command same as the step 2 more than 30 seconds later.
- In logical partitioning feature
HvmSh.exe 5120 Services 0 112K
- In KVM or Podman environment
When putty is specified for SSH_Type
plink.exe 5120 Services 0 112K
When windows is specified for SSH_Type
ssh.exe 5120 Services 0 112K
-
If the outputs step 2 and 3 displayed process "HvmSh.exe", "plink.exe", or "ssh.exe" which have same process ID, take note the process ID of incomplete HvmSh.exe process, plink.exe process, or ssh.exe process (Process ID is in 2nd column. In above example, "5120"is process ID.)
-
Terminate the HvmSh.exe process by input the following message to command prompt with specifying the process ID noted in step 4.
taskkill /F /PID <process ID>
-
Execute the command of step 2 and make sure that message of step 3 is not displayed.
-