1.3.1 Stopping monitoring manager and monitoring agent services

Organization of this subsection

(1) Stopping services manually
(2) Stopping services automatically

(1) Stopping services manually

(a) Stopping services by using a command

Use the jpcspm stop command to manually stop monitoring manager or the monitoring agent services. With the jpcspm stop command, you can stop the services only on the host to which you have logged on. You cannot stop the Performance Management program services on a remote host. When the health check function is enabled, the health check agent stops when PFM - Manager stops.

Use the jpctool service list command to check the status of service operations on the host before stopping services manually.

Log on to the host for which you want to stop services.

Log on to the monitoring manager to stop PFM - Manager services. Log on to the monitoring agent to stop the services of PFM-Base and either PFM - Agent or PFM - RM.
Execute the jpctool service list command.

Execute the jpctool service list command to check the status of service operations.

For example, specify as follows to check the status of all service operations throughout the entire Performance Management system operating on the local host:
```
jpctool service list -key all
```
For details on the information which you can display by executing the jpctool service list command, see 1.6.1 Checking the operating status of services by using a command.
Execute the jpcspm stop command.

Specify the service key indicating the service you want to stop, and execute the jpcspm stop command. Service keys that the jpcspm stop command can specify are as follows:
- jp1pc: All of the PFM - Manager, PFM - Base, PFM - Agent, and PFM - RM services on the host
- Manager or mgr: PFM - Manager services on the host
- AH or act: Action Handler services on the host
For details on the service keys to stop a specific PFM - Agent or PFM - RM service on the host, see the sections that describe the naming rules for services in an appendix of the manual Job Management Partner 1/Performance Management Planning and Configuration Guide.

For example, to start all of the PFM - Manager, PFM - Base, PFM - Agent, and PFM - RM services on the local host, specify as follows:
```
jpcspm stop -key jp1pc
```
Specify the instance name to stop, separately instance by instance, a PFM - Agent or PFM - RM that runs in the instance environment.

For example, to stop the service that has the instance name oracleA in the PFM - Agent for Oracle, specify as follows:
```
jpcspm stop -key Oracle -inst oracleA
```

Reference note:

If you want to stop a specific service of the Performance Management program, first refer to the Host Name, ServiceID, and Service Name that are output by the jpctool service list command. From these, you can determine which service indicated below is operating on the local machine and specify an appropriate service key.

PFM - Manager service
PFM - Agent or PFM - RM service

(b) Stopping services from the Web browser

Note:: Administrator user permissions are necessary to stop services from the Web browser.

From the monitoring console Web browser, log on to PFM - Web Console.

Log on to a user account that has administrator user permissions.
In the navigation frame of the main window, choose the Services tab.
In the navigation frame of the Services window, choose the service to be stopped.

The navigation frame displays the following two folders under the root System:

Machines folder

This folder contains folders with the same names as the hosts where the Performance Management services are installed. The Machines folder manages the PFM - Agent or PFM - RM services for each host.

PFM-Manager folder

This folder manages the PFM - Manager services.

The selected service is marked with a checkmark.
In the method frame of the Services window, choose the Stop service method.
In the confirmation message box that appears, click OK.

The selected service stops.

When the service stops successfully, the status message The service stopped. appears in the information frame of the Services window.

Note:: You cannot start services from the Web browser. To restart the services that you stopped, execute the jpcspm start command on the host that has the relevant services installed.

To Page Top

(2) Stopping services automatically

(a) In Windows

PFM services stop automatically when the system is stopped. However, in this case, the system might be stopped even though PFM services stop abnormally and it might cause file corruption. Therefore, we recommend that you stop PFM services before the system is stopped by using the jpcspm stop command.

(b) In UNIX

To automatically stop services at the system stop, use the service automatic stop script file for the Performance Management system. If you are using AIX, also use the automatic start script file for AIX.

Log on to the host to be set for the automatic starting of the services.

Log on to the monitoring manager if you are going to operate PFM - Manager services. Log on to the monitoring agent if you are going to operate the services of PFM-Base and either PFM - Agent or PFM - RM.
Execute the following command to move to the /opt/jp1pc directory:
```
cd /opt/jp1pc
```
Set the service automatic stop script file for the Performance Management system.
- Name of the .model file of the service automatic stop script: jpc_stop.model
- Name of the service automatic stop script file: jpc_stop
Copy the .model file of the service automatic stop script to the service automatic stop script file to add execution permission. Execute the command as follows:
```
cp -p jpc_stop.model jpc_stop
chmod 555 jpc_stop
```
Specify the automatic stop script file for AIX. (For AIX only)

Register the service automatic stop script file for the Performance Management system set in step 3 into the automatic stop script file for AIX.
- Name of the automatic stop script file: /etc/rc.shutdown
Add the following lines to the automatic stop script file. You do not need to take the sequence into consideration when stopping services.
```
if [ -x /opt/jp1pc/jpc_stop ]; then
        /opt/jp1pc/jpc_stop
fi
```
Create a new file if there is no /etc/rc.shutdown file. After that, set the attributes of the file as follows:
```
chmod 550 /etc/rc.shutdown
chown root /etc/rc.shutdown
chgrp shutdown /etc/rc.shutdown
```
The added lines and the /etc/rc.shutdown file are not deleted upon uninstallation. Delete the added lines, if necessary, when performing uninstallation.

To Page Top