Building Graphite Carbon - linux-on-ibm-z/docs GitHub Wiki

Building Graphite Carbon

Below versions of Carbon are available in respective distributions at the time of creation of these build instructions:

  • Ubuntu 18.04 has 1.0.2-1
  • Ubuntu 20.04 has 1.1.4-2
  • Ubuntu 22.04 has 1.1.7-1

The instructions provided below specify the steps to build and install Carbon version 1.1.10 on Linux on IBM Z for following distributions:

  • RHEL (7.8, 7.9, 8.4, 8.6)
  • SLES (12 SP5, 15 SP3)
  • Ubuntu (18.04, 20.04, 22.04)

General Notes:

  • When following the steps below please use a standard permission user unless otherwise specified.
  • A directory /<source_root>/ will be referred to in these instructions, this is a temporary writable directory anywhere you'd like to place it.

Step 1: Install dependencies

  • RHEL (7.8, 7.9)

    sudo yum install -y libffi-devel wget gcc curl make tar bzip2-devel openssl-devel

  • RHEL (8.4, 8.6)

    sudo yum install -y libffi-devel wget gcc curl make tar bzip2-devel openssl-devel python3 python3-pip python3-devel

  • SLES 12 SP5

    sudo zypper install -y gcc curl libffi48-devel

  • SLES 15 SP3

    sudo zypper install -y python39-devel python39-pip gcc curl libffi-devel python3-xml
sudo ln -s /usr/bin/python3.9 /usr/bin/python
sudo ln -s /usr/bin/pip3.9 /usr/bin/pip3

  • Ubuntu 18.04

    sudo apt-get update
sudo apt-get install -y python3-dev python3-pip python3-cairocffi python3-cairo gcc curl
sudo ln -s /usr/bin/python3 /usr/bin/python
export LC_ALL=C.UTF-8

  • Ubuntu (20.04, 22.04)

    sudo apt-get update
sudo apt-get install -y python3-dev python3-pip python3-cairocffi python3-cairo gcc curl python3-testresources
sudo ln -s /usr/bin/python3 /usr/bin/python
export LC_ALL=C.UTF-8

  • Build Python 3.10.x ( Only for SLES 12 SP5 and RHEL7.x) -- Instructions for building Python 3.10.x can be found here

Step 2: Install Carbon

export PYTHONPATH="/opt/graphite/lib/:/opt/graphite/webapp/"
sudo pip3 install --upgrade pip   
sudo pip3 install -U setuptools
sudo pip3 install wheel # Only for RHEL and SLES 
sudo pip3 install --no-binary=:all: https://github.com/graphite-project/whisper/tarball/1.1.10
sudo pip3 install --no-binary=:all: https://github.com/graphite-project/carbon/tarball/1.1.10
sudo pip3 install --no-binary=:all: https://github.com/graphite-project/graphite-web/tarball/1.1.10

Note:

  • If your version of pip is < 7.0.0 then no need to use --no-binary=:all: parameter
  • In case of an error sudo: pip3: command not found. Run above commands as sudo env PATH=$PATH pip3 install

Step 3: Configure and Start Carbon

Please refer to the documentation for instructions.

References: