An all-powerful toolset for Absolute.
Sentinel is an autonomous agent for persisting, processing and automating Absolute governance objects and tasks, and for expanded functions in the upcoming Absolute releases.
Sentinel is implemented as a Python application that binds to a local Absoluted instance on each Absolute Masternode.
This guide covers installing Sentinel onto an existing V14.0.x Masternode in Ubuntu 18.04 / 20.04.
Installation #
1. Install Prerequisites #
Make sure Python version 2.7.x or above is installed:
python --version
Update system packages and ensure virtualenv is installed:
sudo apt-get update
sudo apt install virtualenv
Go to your prefered installation folder. Generally /home/user/ or /root/ if your are root.
2. Install Sentinel #
Clone the Sentinel repo and install Python dependencies.
cd $HOME/.absolutecore
git clone https://github.com/absolute-community/sentinel.git && cd sentinel && virtualenv ./venv && ./venv/bin/pip install -r requirements.txt
3. Set up Cron #
Set up a crontab entry to call Sentinel every minute:
crontab -e
In the crontab editor, add the lines below, replacing ‘/path-to-sentinel/’ to the path where you cloned sentinel to:
* * * * * cd $HOME/.absolutecore/sentinel && ./venv/bin/python bin/sentinel.py >/dev/null 2>&1
If you want to print the current path use pwd command.
4. Test the Configuration #
Test the config by runnings all tests from the sentinel folder you cloned into
cd $HOME/.absolutecore/sentinel
./venv/bin/py.test ./test
With all tests passing and crontab setup, Sentinel will stay in sync with absoluted and the installation is complete
Configuration #
An alternative (non-default) path to the absolute.conf file can be specified in sentinel.conf; remove the 1st char # and replace /alternativepath/ there:
absolute_conf=/alternativepath/absolute.conf
Troubleshooting #
To view debug output, set the SENTINEL_DEBUG environment variable to anything non-zero, then run the script manually:
cd $HOME/.absolutecore/sentinel
SENTINEL_DEBUG=1 ./venv/bin/python bin/sentinel.py
