2.2.2 Procedure for canceling setup
This subsection describes how to cancel setup of PFM - Agent for Microsoft SQL Server.
- Organization of this subsection
(1) Canceling setup of an instance environment
Canceling setup of an instance environment involves the tasks listed below. To cancel setup of multiple instance environments, you must repeat the procedure for each environment.
-
Deleting an instance environment
To cancel the setup of an instance environment:
(a) Delete an instance environment
Check the instance name and delete the instance environment. Delete an instance environment on the PFM - Agent host.
To check the instance name, use the jpcconf inst list command. To delete an instance environment that has been created, use the jpcconf inst unsetup command.
To delete an instance environment:
-
Check the instance name.
Execute the jpcconf inst list command specified with the service key that indicates PFM - Agent for Microsoft SQL Server.
jpcconf inst list -key SQL
For example, if the instance name is SQL1, the command displays SQL1.
-
Stop all active PFM - Agent for Microsoft SQL Server services in the instance environment.
For details about how to stop services, see the chapter on starting and stopping Performance Management in the JP1/Performance Management User's Guide.
-
Delete the instance environment.
Execute the jpcconf inst unsetup command specified with the service key that indicates PFM - Agent for Microsoft SQL Server and the instance name.
For example, if the instance name is SQL1, use the following command line:
jpcconf inst unsetup -key SQL -inst SQL1
When the jpcconf inst unsetup command terminates successfully, the folders created as the instance environment are deleted, as well as the service IDs and Windows services.
If you specify default for the instance-name, the instance environment for monitoring the default Microsoft SQL Server instance will be deleted.
- Note:
-
Canceling setup of an instance environment does not delete the service information that is displayed with the jpctool service list command. Use the jpctool service delete command to delete service information, and then restart PFM - Manager.
If you want to update the PFM - Web Console host to reflect the deletion of instance environment, you need to execute the jpctool service sync command to synchronize the agent information of the PFM - Manager host and that of the PFM - Web Console host.
-
Instance name: SQL1
-
Host name: host1
-
Service ID of the Agent Collector service: QA1SQL1[host1]
-
Service ID of the Agent Store service: QS1SQL1[host1]
jpctool service delete -id Q?1SQL1[host01] -host host01
-
For details about the command, see the chapter on commands in the manual JP1/Performance Management Reference.