PingIntelligence

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:

        $ /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