1. Installing Turtles๏ƒ

1.1. Turtles Prerequisites๏ƒ

Turtles 0.7.0 requires Python 3.10 or greater.

Turtles Installation is typically done with pipx, which you may need to install [1]:

  • Debian, Fedora, Ubuntu: pipx OS package

  • AlmaLinux OS, CentOS Stream, Red Hat Enterprise Linux (RHEL), Rocky Linux: pipx EPEL package

  • Oracle Linux: pipx Oracle Linux EPEL package

  • Arch Linux: python-pipx OS package

  • OpenSUSE, SUSE Linux Enterprise Server (SLES): python313-pipx, python312-pipx or python311-pipx OS package (depending on the system version of Python)

Maven Plugin Set Builder Prerequisites

The Maven Plugin Set Builder is the most common plugin set builder type, likely needed by any Turtles application.

The Maven Plugin Set Builder has these additional prerequisites:

Other Turtles Prerequisites

Legacy Ant Plugin Set Builder Prerequisites

The Legacy Ant Plugin Set Builder (now deprecated), if in use, has these additional prerequisites:

  • Java Development Kit (JDK) 8

  • Apache Ant

  • The JAVA_HOME environment variable must be set.

RCS Plugin Registry Layout Prerequisites

The RCS Plugin Registry Layout, if in use, has these additional prerequisites:

1.2. Turtles Installation๏ƒ

Turtles is available from the Python Package Index (PyPI) as lockss-turtles (https://pypi.org/project/lockss-turtles).

To install Turtles, we recommend using pipx version 1.5.0 or greater [1]. Run this command as root:

pipx install --global lockss-turtles

Tip

If you are running an older version of pipx [1], each user needing to run Turtles will have to install it individually by running this non-root command:

pipx install lockss-turtles

The installation process adds a turtles command line tool and a lockss.turtles Python library. You can check at the command line that the installation is functional by running turtles version or turtles --help.

Footnotes