---
title: Start and Stop ABS
description: 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.
component: pingintelligence
version: 5.1
page_id: pingintelligence:pingintelligence_production_deployment:pingintelligence_start_stop_ase
canonical_url: https://docs.pingidentity.com/pingintelligence/5.1/pingintelligence_production_deployment/pingintelligence_start_stop_ase.html
revdate: April 3, 2024
section_ids:
  start-abs-as-a-service: Start ABS as a service
  start-abs-using-start-sh-script: Start ABS using start.sh script
  stop-abs-using-stop-sh-script: Stop ABS using stop.sh script
  stop-abs-using-service-script: Stop ABS using service script
---

# Start and Stop ABS

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.

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

* Using service script available in the `util` directory, or

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

## Start ABS as a service

Complete the following steps 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
   ```

## Start ABS using start.sh script

To start ABS, run the `start.sh` script located in the `/opt/pingidentity/abs/bin` directory. Change working directory to `/opt/pingidentity/abs/bin`. Then start ABS by typing 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
```

To verify ABS has started, change working directory to `data` directory and look for two `.pid` files, `abs.pid` and `stream.pid`. 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%"
 } ] }
```

## Stop ABS using stop.sh script

To stop ABS, first stop API Security Enforcer (if it is running) or turn OFF the ABS flag in API Security Enforcer. 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 using the `stop.sh` script, ABS would restart after stopping. |

## Stop ABS using service script

Run the following command to stop the ABS service: c

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