---
title: Starting and stopping ABS
description: Learn how to start and stop ABS.
component: pingintelligence
version: 5.2
page_id: pingintelligence:installing_pingintelligence_for_apis:pingintelligence_start_stop_ase
canonical_url: https://docs.pingidentity.com/pingintelligence/5.2/installing_pingintelligence_for_apis/pingintelligence_start_stop_ase.html
revdate: April 3, 2024
section_ids:
  before-you-begin: Before you begin
  about-this-task: About this task
  steps: Steps
  choose-from: Choose from:
  choose-from-2: Choose from:
---

# Starting and stopping ABS

Learn how to start and stop ABS.

## Before you begin

For ABS to start, the `abs_master.key` must be present in the `/opt/pingidentity/abs/config` directory. If you have moved the master key to a secured location for security reasons, copy it to the `config` directory before starting ABS.

## About this task

You can start ABS in one of the following two ways:

* Using service script available in the `util` directory

* Using the `start.sh` script available in the `bin` directory

## Steps

1. Start ABS.

   ### Choose from:

   * To start ABS as a service:

     1. Navigate to the `util` directory and run the following command to install ABS as a service:

        ```
        #sudo ./install-systemctl-service.sh pi-abs
        ```

     2. Start the service by entering the following command:

        ```
        systemctl start pi-abs.service
        ```

   * To start ABS using the `start.sh` script:

     1. Run the `start.sh` script located in the `/opt/pingidentity/abs/bin` directory.

     2. Change the working directory to `/opt/pingidentity/abs/bin`.

     3. Start ABS by entering the following command:

        ```shell
        $ /opt/pingidentity/abs/bin/start.sh
        Starting API Behavioral Security 4.2...
        please see /opt/pingidentity/abs/logs/abs/abs.log for more details
        ```

     4. To verify ABS has started, change the working directory to the `data` directory and look for two `.pid` files, `abs.pid`, and `stream.pid`. Also check the newly added ABS node is connecting to MongoDB and has a heartbeat.

        ```
        > use abs_metadata
        switched to db abs_metadata
        > db.abs_cluster_info.find().pretty()
         {
         "_id" : ObjectId("58d0c633d78b0f6a26c056ed"),
         "cluster_id" : "c1",
         "nodes" : [
             {
                 "os" : "Red Hat Enterprise Linux Server release 7.6 (Maipo)",
                 "last_updated_at" : "1490088336493",
                 "management_port" : "8080",
                 "log_port" : "9090",
                 "cpu" : "24",
                 "start_time" : "1490077235426",
                 "log_ip" : "2.2.2.2",
                 "uuid" : "8a0e4d4b-3a8f-4df1-bd6d-3aec9b9c25c1",
                 "dashboard_node" : false,
                 "memory" : "62G",
                 "filesystem" : "28%"
         } ] }
        ```

2. Stop ABS.

   ### Choose from:

   * To stop ABS using `stop.sh` script:

     1. Stop ASE (if it is running) or turn off the ABS flag in ASE.

     2. If no machine learning jobs are processing, run the `stop.sh` script available in the `bin` directory.

        ```
        # /opt/pingidentity/abs/bin/stop.sh
        checking API Behavioral Security status
        sending shutdown signal to ABS, please wait...
        API Behavioral Security stopped
        ```

        |   |                                                                                                                      |
        | - | -------------------------------------------------------------------------------------------------------------------- |
        |   | If you have started ABS as a service and try to stop it using the `stop.sh` script, ABS will restart after stopping. |

   * To stop ABS using the service script:

     1. Run the following command:

        ```
        systemctl stop pi-abs.service
        ```