1.3.1 Stopping services on monitoring managers and monitoring agents

Organization of this subsection

(1) Manually stopping services on monitoring managers and monitoring agents
(2) Enabling or disabling the automatic service stop feature for monitoring managers and monitoring agents (Windows)
(3) Enabling or disabling the automatic service stop feature for monitoring managers and monitoring agents (UNIX)

(1) Manually stopping services on monitoring managers and monitoring agents

(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 services 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 the services.

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 about the information that you can display by executing the jpctool service list command, see 1.6.1 Checking the 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 JP1/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) Enabling or disabling the automatic service stop feature for monitoring managers and monitoring agents (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.

To Page Top

(3) Enabling or disabling the automatic service stop feature for monitoring managers and monitoring agents (UNIX)

With the default installation settings, services are not set to stop automatically when the system shuts down.

To set services other than PFM - Web Console to stop automatically at system shutdown, store in the installation folder for the Performance Management system the script file for stopping services automatically (jpc_stop). To disable the automatic service stop feature, delete the jpc_stop file.

The procedure for enabling the automatic service stop feature is described below.

Important

In the following environment you cannot configure the automatic service stop feature independently. If you enable automatic service stop, you must also enable automatic service start. Similarly, you disable automatic service start, you must also disable automatic service stop.

- CentOS 7 or later

- Linux 7 or later

- Oracle Linux 7 or later

- SUSE Linux 12 or later
When the automatic service start and stop features are enabled in the following environment and the jpcspm start command is used to start services, the services will not stop automatically when the OS shuts down.

- CentOS 7 or later

- Linux 7 or later

- Oracle Linux 7 or later

- SUSE Linux 12 or later

If you want the services to stop automatically, use the systemctl command to restart all Performance Management services. Alternatively, use the jpcspm stop command to manually stop the services that were started by the jpcspm start command.

The following example uses the systemctl command to restart the services:

> systemctl stop jp1_pc

> systemctl start jp1_pc

Log on to the host on which the automatic service stop feature is to be enabled.
Execute the following command to move to the /opt/jp1pc directory:
```
cd /opt/jp1pc
```
Set the script file for stopping services automatically for the Performance Management system.
- Name of the .model file of the service automatic stop script: jpc_stop.model
- Name of the script file for stopping services automatically: jpc_stop
Copy the .model file of the service automatic stop script to the script file for stopping services automatically to add execution permission. Execute the command as follows:
```
cp -p jpc_stop.model jpc_stop
chmod 555 jpc_stop
```
Register the automatic stop script file for AIX. (For AIX only)

Register the script file for stopping services automatically for the Performance Management system set in step 3 into the automatic stop script file for AIX.

Note

Assume that automatic stop has been enabled in your environment and that you disable automatic stop and then want to go back to enabling it again. In this case, if the automatic service stop script file for the Performance Management system is already registered in the automatic stop script file for AIX in your environment, you do not need to register it again.
- 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.
Enable automatic service start.

In the following environment only, enable automatic service start by following the procedure described in 1.2.1(3) Enabling or disabling the automatic service start feature for monitoring managers and monitoring agents (UNIX).
- CentOS 7 or later
- Linux 7 or later
- Oracle Linux 7 or later
- SUSE Linux 12 or later
Start the Performance Management services other than PFM - Web Console.

In the following environment only, after you enable automatic service stop, to ensure that the services can stop automatically on the next immediate OS shutdown, start the Performance Management services other than PFM - Web Console by using one of the following methods depending on whether the services are running.
- CentOS 7 or later
- Linux 7 or later
- Oracle Linux 7 or later
- SUSE Linux 12 or later
- When the Performance Management services are stopped

Use the systemctl command to start the services.
```
systemctl start jp1_pc
```
- When the Performance Management services are running

When automatic service start is disabled, use the jpcspm command to stop the services and then use the systemctl command to start the services.
```
jpcspm stop -key all
systemctl start jp1_pc
```
When automatic service start is enabled, you do not need to run any commands.

To disable automatic stop of services, perform the procedure below.

Important: Assume that automatic stop has been enabled in your environment and that you disable automatic stop and then want to go back to enabling it again. In this case, you have to carry out the automatic service stop setup procedure.

Delete the jpc_stop file that was stored when the automatic service stop feature was set.

To Page Top