Installing the Compute Endpoint

The Globus Compute Endpoint is available as a PyPI package or as a native system package (DEB and RPM).

Operating System Support

Currently, the Globus Compute Endpoint is only supported on Linux. While some have reported success running Compute endpoints on macOS, we do not currently support it. If running on a non-Linux host OS is necessary, consider doing so in a container running Linux.

Note

Though the Compute Endpoint is only supported on Linux, the Globus Compute SDK is supported on other operating systems.

Installing Directly via PyPI

If the site administrator has not already installed the Globus Compute Endpoint software, users typically install it from PyPI. We strongly recommend installing the Globus Compute endpoint into an isolated virtual environment (e.g., venv, virtualenv. We recommend use of pipx for library isolation:

$ python3 -m pipx install globus-compute-endpoint

Repository-Based Installation

The globus-compute-endpoint project is available on PyPI, and is also available in Globus’ repositories as native DEB and RPM packages. The repository package is globus-compute-agent.

Prerequisites

  1. Supported Linux Distributions

    Where feasible, Globus Compute supports the same Linux distributions as does Globus Connect Server.

  2. Administrator Privileges

    Per usual semantics, installing the DEB or RPM packages will require administrative access on the target host.

  3. TCP Ports

    • Port 443, outbound to compute.api.globus.org

    • Port 443, outbound to compute.amqps.globus.org

    Note

    We do not offer a range of specific IP addresses for firewall blocking rules.

What is Installed

The Globus Compute Endpoint software will be installed in /opt/globus-compute-agent/ and a shell-script wrapper will be installed to /usr/sbin/globus-compute-endpoint.

The packages also rely on Globus’ supplied Python. As of this writing, that is Python3.9, and is installed to /opt/globus-python/. While Globus Compute is supported on any Python version that is not EOL, the Compute agent packages are built against Globus’ Python. As the Python version has implications for function and data serialization consistency, administrators may want to consider supporting multiple Python versions in the configuration template.

RPM Installation

# install Globus' public key
dnf install https://downloads.globus.org/globus-connect-server/stable/installers/repo/rpm/globus-repo-latest.noarch.rpm

# install the Globus Compute Agent package
dnf install globus-compute-agent

DEB Installation

# install Globus' public key
curl -LOs https://downloads.globus.org/globus-connect-server/stable/installers/repo/deb/globus-repo_latest_all.deb
dpkg -i globus-repo_latest_all.deb
apt-key add /usr/share/globus-repo/RPM-GPG-KEY-Globus

# install the Globus Compute Agent package
apt update
apt install globus-compute-agent

SUSE Installation

# install Globus' public key
rpm --import https://downloads.globus.org/globus-connect-server/stable/installers/keys/GPG-KEY-Globus
zypper install https://downloads.globus.org/globus-connect-server/stable/installers/repo/rpm/globus-repo-latest.noarch.rpm

# install the Globus Compute Agent package
zypper install globus-compute-agent