Building Graphite Carbon

Building Graphite Carbon

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

• Ubuntu 20.04 has 1.1.4-2
• Ubuntu (22.04, 24.04) have 1.1.7-1
• Ubuntu 24.10 has 1.1.10-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 (8.8, 8.10, 9.2, 9.4, 9.5)
• SLES 15 SP6
• Ubuntu (20.04, 22.04, 24.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.

1. Install dependencies

• RHEL (8.8, 8.10)

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

• RHEL (9.2, 9.4, 9.5)

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

• SLES 15 SP6

  sudo zypper install -y python311-devel python311-pip gcc curl libffi-devel python3-xml
  sudo ln -s /usr/bin/python3.11 /usr/bin/python
  

• 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
  

• Ubuntu 24.04

  sudo apt-get update
  sudo apt-get install -y gcc curl wget pipx pkg-config openssl libssl-dev
  
  

2. Build Python 3.10.x ( Only for Ubuntu 24.04 )

 ```
 wget -q https://raw.githubusercontent.com/linux-on-ibm-z/scripts/master/Python3/3.10.0/build_python3.sh
 sed -i 's/20.04/24.04/g' build_python3.sh
 bash build_python3.sh -y
 python3 -V
 ```

3. Install Carbon

# For All Distros except RHEL 8.x
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

# For RHEL 8.x
export PYTHONPATH="/opt/graphite/lib/:/opt/graphite/webapp/"
sudo python3.9 -m pip install --upgrade pip   
sudo python3.9 -m pip install -U setuptools
sudo python3.9 -m pip install wheel
sudo python3.9 -m pip install --no-binary=:all: https://github.com/graphite-project/whisper/tarball/1.1.10
sudo python3.9 -m pip install --no-binary=:all: https://github.com/graphite-project/carbon/tarball/1.1.10
sudo python3.9 -m pip 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

4. Configure and Start Carbon

Please refer to the documentation for instructions.

References:

• https://github.com/graphite-project/carbon

• https://graphite.readthedocs.io/en/latest/