Pattoo Web API Daemon

pattoo_apid serves pattoo agent data from the database via a web API.

Installation

Follow these steps.

  1. Follow the installation steps in the Basic Installation file.
  2. Configure the main section of the configuration file following the steps in Configuration Guide file.
  3. Start the desired daemons using the commands below. You may want to make these systemd daemons, if so follow the steps in the Basic Installation file.

Usage

pattoo_apid has a simple command structure.

The daemon will require a configuration file in the etc/ directory. See the configuration section for details.

$ bin/pattoo_apid.py --help
usage: pattoo_apid.py [-h] [--start] [--stop] [--status] [--restart]
                         [--force]

optional arguments:
  -h, --help  show this help message and exit
  --start     Start the agent daemon.
  --stop      Stop the agent daemon.
  --status    Get daemon daemon status.
  --restart   Restart the agent daemon.
  --force     Stops or restarts the agent daemon ungracefully when used with --stop or
              --restart.
$

Configuration

No additional configuration steps beyond that in the Configuration Guide file are required.

Testing

There are a number of steps you can take to make sure everything is OK.

  1. If you have setup the daemon for systemd then you can use the systemctl command to get the status of the daemon.
  2. The daemon should be running on the port configured with the ip_bind_port parameter. Use the netstat command to verify this.
  3. Visit the URL http://localhost:20202/pattoo/api/v1/web/status to get the status page.
  4. Use the Performance and Troubleshooting for further steps to take

Making pattoo_apid Start Automatically After Reboot

The easiest way to do this is to consider Configuring systemd Daemons. Otherwise you will need to manually restart the daemon after a reboot.