Starting, stopping, and checking the status of server components

Use the commands for checking the status or for starting, stopping, and recycling the Performance Management server components when necessary for maintenance and troubleshooting tasks.

As the root user, complete any of these steps:

• To list the available commands and see the syntax, enter the following command:

  apm --help

• To start all, stop all, or recycle all server components, enter one of the following commands:

  apm start_all

  apm stop_all

  apm restart_all

  Short commands: sta, spa, and rta
• To check whether an IBM® Performance Management service is running or stopped, enter the following command:

  apm status service_name

  where service_name is one of the following services. Do not enter a service name if you want to find the status of all services.

  Option	Description
  apmui	Performance Management console component that handles incoming user interface requests.
  db2	DB2® server that is used to persist monitoring data and applications that are displayed in the Performance Management console. This service is only used if you install a local DB2 server when you install the Performance Management server.
  kafka	Message bus component for internal communication between components.
  ksy	Summarization and Pruning Agent for maintaining database partitions and pruning monitoring data in the DB2 server.
  min	Monitoring Infrastructure Node component that maintains the list of connected agents, advanced configuration data, and threshold events. The min component is also the agent interface component that includes the agent REST interface and central configuration services HTTP server. The REST interface is used by agents to send monitoring data that is persisted in the DB2 server and threshold events. The central configuration service HTTP server handles requests from agents for their configuration files, for example, threshold definitions.
  mongodb	MongoDB NoSQL open-source database that stores data for threshold events and for the transaction tracking functionality that is available with the Application Performance Management offering. This service is only used if you install a local MongoDB database when you install the Performance Management server.
  oidc	OpenID Connect (OIDC) is a simple identity protocol over OAuth 2.0. The OIDC provider in Liberty Profile is implemented as an OAuth 2.0 extension.
  oslc	Open Services for Lifecycle Collaboration service provider that registers the computer system, software server, and application resources that are monitored by agents in the service component registry.
  scr	Service Component Registry that persists application definitions and their relationships to agent resources in the DB2 server.
  server1	Performance Management console backend component that retrieves monitoring data and applications from the DB2 server and persists threshold definitions, resource group definitions, and role-based access control definitions. Be aware that if you restart server1, you must also restart the apmui service after restarting the server1 service.
  soagent	Agent that aggregates transaction data from multiple playback agents and generates events according to threshold definitions. Be aware that if you stop this service, the agent cannot generate events. This service is only used if you have the Application Performance Management Advanced or Application Performance Management offering.
  spark	Service that controls the spark infrastructure and the applications such as the AAR Aggregator and Instance Analyzer that run on it. If you stop this service, you will lose functionality. This service is only used if you have the Application Performance Management Advanced or Application Performance Management offering.
  txagent	Transactions Event agent, which sets the thresholds that are used to classify middleware transactions. If you stop this service, you will lose functionality. This service is only used if you have the Application Performance Management Advanced or Application Performance Management offering.

  Short command: ss
• If you were directed by IBM Support or a Knowledge Center topic to start, stop, or restart a particular service, enter the command using the following syntax:

  apm command service_name

  where command is one of the following apm commands:

  Option	Description
  start	Start the specified service_name. Short command: st
  stop	Stop the specified service_name. To do a force stop, insert -f or --force between apm and stop. For example, apm -f stop apmui, stops the Performance Management console immediately. Short command: sp
  restart	Restart the running service_name. Be aware that after restarting the server1 service, you must also restart the apmui service. Short command: rt

  and service_name is one of the services that are listed in the previous step (apmui, biagent, db2, dqe, kafka, ksy, min, mongodb, oidc, oslc, scr, server1, soagent, spark, or txagent).
  Note: If the following message is displayed after you are start or stop a service:

  This process currently executes start/stop operations of component
  service_name: process_ID. Wait for it to complete then retry the
  operation.

  It means that the specific service is already being started or stopped by the apm command that is running under the process ID displayed. To check the status of this service, run the

  apm status service_name

  command. If the service is still running from the other apm command, wait a few minutes for it to complete, and retry the operation again.
  Note: If a service does not stop when you use the apm stop service_name, apm stop_all, or apm restart_all commands, do not use the Linux kill command to stop the process. Instead, use the -f or --force option with the apm stop service_name command to stop the process. The -f or --force option must be used only when you cannot stop the process without forcing it to stop.