Skip to main content

Shoal Agent README

Version: v1.0.1

Important to know about the configuration

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.

Included in frontier-squid, used by WLCG

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).

Basic Commands

With the basic shoal_agent init script you can do the following:

service shoal-agent start
service shoal-agent stop
service shoal-agent restart

Installation

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).

Recommended Method: Use pip (est. ~5 min)

  1. Login as root or become root via sudo su -
  2. Install shoal-agent using pip/pip3, e.g. pip3 install shoal-agent
  3. Run the installation script, shoal-agent-installation.sh, to setup your configuration

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

shoal-agent-1.0.2.tar.gz (12.4 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

shoal_agent-1.0.2-py3-none-any.whl (15.2 kB view details)

Uploaded Python 3

File details

Details for the file shoal-agent-1.0.2.tar.gz.

File metadata

  • Download URL: shoal-agent-1.0.2.tar.gz
  • Upload date:
  • Size: 12.4 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/3.8.0 pkginfo/1.9.6 readme-renderer/34.0 requests/2.27.1 requests-toolbelt/1.0.0 urllib3/1.26.14 tqdm/4.64.1 importlib-metadata/4.8.3 keyring/23.4.1 rfc3986/1.5.0 colorama/0.4.5 CPython/3.6.8

File hashes

Hashes for shoal-agent-1.0.2.tar.gz
Algorithm Hash digest
SHA256 451cbd5e8bb084be7c89e48fd0c2904cd2720e4f725be07402f1596ca80abcee
MD5 0334c4a957300caa9667fa0600780d91
BLAKE2b-256 c21b7a721a9c84f77c1279b80a97f9f9b4ccac5ad318dffe90b45fb904e66697

See more details on using hashes here.

File details

Details for the file shoal_agent-1.0.2-py3-none-any.whl.

File metadata

  • Download URL: shoal_agent-1.0.2-py3-none-any.whl
  • Upload date:
  • Size: 15.2 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/3.8.0 pkginfo/1.9.6 readme-renderer/34.0 requests/2.27.1 requests-toolbelt/1.0.0 urllib3/1.26.14 tqdm/4.64.1 importlib-metadata/4.8.3 keyring/23.4.1 rfc3986/1.5.0 colorama/0.4.5 CPython/3.6.8

File hashes

Hashes for shoal_agent-1.0.2-py3-none-any.whl
Algorithm Hash digest
SHA256 af44c5e12ea731a2142a50eb203ab5ec753d8ef63b3532bac9c7301393a697f2
MD5 c2f405831d99579268722059d9578cbf
BLAKE2b-256 595a345b1668d71aeb2d9bb71a4fe63183b5b92ef002af6a182bf2673b73a5e0

See more details on using hashes here.

Release history Release notifications | RSS feed

This release

1.0.2 This release

2 files

1.0.1

2 files

1.0.0

2 files

0.9.9

1 file

0.9.8

1 file

0.9.7

1 file

0.9.5

1 file

0.9.3

1 file

0.9.2

0.9.1

1 file

0.9.0

1 file

0.7.0

1 file

0.6.0

1 file

0.5.3

1 file

0.5.2

1 file

0.5.1

1 file

0.5.0

1 file

0.4.1

1 file

0.4.0

1 file

0.3.2

1 file

0.3.1

1 file

0.2.1

1 file

0.2

1 file

0.1

1 file

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page