The configuration has been simplified compared to previous versions and most settings are automatically configured at runtime. There is also a setup script which should be run right after the pip install which will help to set the right options for the shoal-agent. The config file is placed in /etc/shoal/shoal_agent.conf by the setup script and can be edited manually later on too. The new shoal-agent is compatible with python3 as well as python2. It is recommended to use the python3 version.
The frontier-squid rpm distribution of squid (provided by the Worldwide LHC Computing Grid, WLCG) includes shoal-agent which can be enabled in its configuration. It uses the same default shoal server. The WLCG also includes shoal-tracked squids in its Web Proxy Auto Discovery service (see above configuration link).
With the basic shoal_agent
init script you can do the following:
service shoal-agent start
service shoal-agent stop
service shoal-agent restart
The recommended way to install is with pip.
Although, the Shoal agent does not require root privilege to run; by default the shoal
user and group is used; it should be installed as root.
If the shoal user and group do not exist then the install script will create the entries in the system.
Note: Requires you have Python 3.6+, and the pika, netifaces python module (available from EPEL).
- Login as root or become root via
sudo su -
- Install shoal-agent using pip/pip3, e.g.
pip3 install shoal-agent
- Run the installation script,
shoal-agent-installation.sh
, to setup your configuration