Package Dependencies Required to Build Samba

From SambaWiki
Revision as of 19:38, 11 September 2020 by Abartlet (talk | contribs) (use python3 prefix on python package names)

Operating System-independent Overview

The following is an operating system-independent list of libraries and utilities required to build and install Samba. Depending on your distribution, the name of packages can differ. Usually library packages are named lib*-devel or lib*-dev. For a list of distribution specific package installation commands, see Distribution-specific Packages Required to Build Samba.


Mandatory

Libraries and utilities Required for
python3 Several utilities, such as samba-tool and the build system (Waf), are written in Python 3.x.
perl
Parse::Yapp Used in PIDL, our IDL compiler.
acl Required only on Samba Active Directory domain controllers and member servers using Windows ACLs.
xattr Required only on Samba Active Directory domain controllers and member servers using Windows ACLs.
gnutls >= 3.4.7 Required for cryptography
zlib Provides the crc32 checksum across Samba and compression for DRSUAPI (AD replication)

Optional

Libraries and utilities Required for
krb5-devel and krb5-server MIT Kerberos support (Samba 4.7 and later). Requires MIT Kerberos 1.15.1 or later.
blkid
dbus vfs_snapper
jansson-devel Audit logging (Samba 4.7 and later), Samba AD DC
readline
bsd or setproctitle Process title updating support.
xsltproc or docbook Man pages and other documentation.
pam-devel PAM support. For example, to authenticate domain users using PAM.
cups CUPS printer sharing support.
openldap NT4 Domains support, including the Samba NT4 to AD migration (Classic Upgrade).
python3-markdown For samba-tool domain schemaupgrade
patch For samba-tool domain schemaupgrade
gpgme-devel For reading passwords in samba-tool user passwordsync from encrypted cleartext
python3-gpg or python3-gpgme For storing passwords for samba-tool user passwordsync in encrypted cleartext

Selftest

The following additional packages / utilities are required only for running some tests.

Libraries and utilities Required for
bash Some blackbox tests are bash-specific
python3-iso8601 Used by our selftest and required from the system in samba 4.14 and later.
python3-cryptography Used by our selftest to test Kerberos
python3-asn1 Used by our selftest to test ASN.1 protocols like LDAP and Kerberos

Packages Required to Build Samba

Verified Package Dependencies

These links are to https://git.samba.org and are to our tested package installation scripts. The files are are contained in Samba's official git repository and are subject to Samba's Code Review and testing.

Naturally, you should still check them before running them as root. They may contain more packages than you strictly need, because some items required by Samba's GitLab CI and autobuild tooling are not needed in production.

Distribution Samba master Samba 4.15 Samba 4.14 Samba 4.13 Samba 4.12 Samba 4.11
Debian 9 bootstrap/generated-dists/debian9/bootstrap.sh bootstrap/generated-dists/debian9/bootstrap.sh
Debian 10 bootstrap/generated-dists/debian10/bootstrap.sh bootstrap/generated-dists/debian10/bootstrap.sh bootstrap/generated-dists/debian10/bootstrap.sh bootstrap/generated-dists/debian10/bootstrap.sh bootstrap/generated-dists/debian9/bootstrap.sh
Debian 11 bootstrap/generated-dists/debian10/bootstrap.sh
Ubuntu 16.04 bootstrap/generated-dists/ubuntu1604/bootstrap.sh bootstrap/generated-dists/ubuntu1604/bootstrap.sh
Ubuntu 18.04 bootstrap/generated-dists/ubuntu1804/bootstrap.sh bootstrap/generated-dists/ubuntu1804/bootstrap.sh bootstrap/generated-dists/ubuntu1804/bootstrap.sh bootstrap/generated-dists/ubuntu1804/bootstrap.sh bootstrap/generated-dists/ubuntu1804/bootstrap.sh bootstrap/generated-dists/ubuntu1804/bootstrap.sh
Ubuntu 20.04 bootstrap/generated-dists/ubuntu2004/bootstrap.sh bootstrap/generated-dists/ubuntu2004/bootstrap.sh bootstrap/generated-dists/ubuntu2004/bootstrap.sh bootstrap/generated-dists/ubuntu2004/bootstrap.sh
OpenSuSE 15.0 bootstrap/generated-dists/opensuse150/bootstrap.sh bootstrap/generated-dists/opensuse150/bootstrap.sh bootstrap/generated-dists/opensuse150/bootstrap.sh bootstrap/generated-dists/opensuse150/bootstrap.sh bootstrap/generated-dists/opensuse150/bootstrap.sh bootstrap/generated-dists/opensuse150/bootstrap.sh
OpenSuSE 15.1 bootstrap/generated-dists/opensuse151/bootstrap.sh bootstrap/generated-dists/opensuse151/bootstrap.sh bootstrap/generated-dists/opensuse151/bootstrap.sh bootstrap/generated-dists/opensuse151/bootstrap.sh bootstrap/generated-dists/opensuse151/bootstrap.sh bootstrap/generated-dists/opensuse151/bootstrap.sh
Fedora 29 bootstrap/generated-dists/fedora29/bootstrap.sh bootstrap/generated-dists/fedora29/bootstrap.sh
Fedora 30 bootstrap/generated-dists/fedora30/bootstrap.sh bootstrap/generated-dists/fedora30/bootstrap.sh
Fedora 31 bootstrap/generated-dists/fedora31/bootstrap.sh bootstrap/generated-dists/fedora31/bootstrap.sh
Fedora 32 bootstrap/generated-dists/fedora32/bootstrap.sh bootstrap/generated-dists/fedora32/bootstrap.sh
Fedora 33 bootstrap/generated-dists/fedora33/bootstrap.sh bootstrap/generated-dists/fedora33/bootstrap.sh bootstrap/generated-dists/fedora33/bootstrap.sh bootstrap/generated-dists/fedora33/bootstrap.sh
Fedora 34 bootstrap/generated-dists/fedora34/bootstrap.sh bootstrap/generated-dists/fedora34/bootstrap.sh bootstrap/generated-dists/fedora34/bootstrap.sh bootstrap/generated-dists/fedora34/bootstrap.sh
CentOS 7 bootstrap/generated-dists/centos7/bootstrap.sh bootstrap/generated-dists/centos7/bootstrap.sh bootstrap/generated-dists/centos7/bootstrap.sh bootstrap/generated-dists/centos7/bootstrap.sh bootstrap/generated-dists/centos7/bootstrap.sh
CentOS 8 bootstrap/generated-dists/centos8/bootstrap.sh bootstrap/generated-dists/centos8/bootstrap.sh bootstrap/generated-dists/centos8/bootstrap.sh bootstrap/generated-dists/centos8/bootstrap.sh

Manually maintained Distribution-specific Package lists

This list is for older Samba versions (4.10 and earlier) and distributions not included in the table above


Samba Active Directory Domain Controller

The following installation commands include the BIND DNS server. If you are using the Samba internal DNS server, omit the BIND package(s). However, you require the package containing the nsupdate utility to enable dynamic DNS support.


Debian / Ubuntu

# apt-get install acl attr autoconf bind9utils bison build-essential \
  debhelper dnsutils docbook-xml docbook-xsl flex gdb libjansson-dev krb5-user \
  libacl1-dev libaio-dev libarchive-dev libattr1-dev libblkid-dev libbsd-dev \
  libcap-dev libcups2-dev libgnutls28-dev libgpgme-dev libjson-perl \
  libldap2-dev libncurses5-dev libpam0g-dev libparse-yapp-perl \
  libpopt-dev libreadline-dev nettle-dev perl perl-modules pkg-config \
  python-all-dev python-crypto python-dbg python-dev python-dnspython \
  python3-dnspython python-gpgme python3-gpgme python-markdown python3-markdown \
  python3-dev xsltproc zlib1g-dev liblmdb-dev lmdb-utils

Notes:

  • Before Debian 8 and Ubuntu 14.04, libgnutls28-dev was known as libgnutls-dev.
  • perl-modules was replace by perl-modules-5.24 on Debian 9
  • perl-modules was replace by perl-modules-5.26 on Ubuntu 17.10
  • python-gpgme and python3-gpgme were replaced by python-gpg and python3-gpg on Debian 9 and Ubuntu 17.10
  • If you are building Samba on a system that uses systemd, you will also require the libsystemd-dev package
  • To use a MIT Kerberos KDC, you will need libkrb5-dev and krb5-kdc, version 1.15.1 or greater.


Red Hat Enterprise Linux 8 / CentOS 8

Install the following packages to build Samba as an Active Directory (AD) domain controller (DC) on a minimal Red Hat Enterprise Linux (RHEL) 8 or CentOS 8 installation:

# yum install docbook-style-xsl gcc gdb gnutls-devel gpgme-devel jansson-devel \
      keyutils-libs-devel krb5-workstation libacl-devel libaio-devel \
      libarchive-devel libattr-devel libblkid-devel libtasn1 libtasn1-tools \
      libxml2-devel libxslt lmdb-devel openldap-devel pam-devel perl \
      perl-ExtUtils-MakeMaker perl-Parse-Yapp popt-devel python3-cryptography \
      python3-dns python3-gpg python36-devel readline-devel rpcgen systemd-devel \
      tar zlib-devel

To install all required packages, you must enable the following repositories:

RHEL 8 CentOS 8
Base Base
AppStream AppStream
CodeReady Linux Builder* PowerTools
EPEL** EPEL**

* For further details about the CodeReady Linux Builder repository, see https://access.redhat.com/articles/4348511.

** The Extra Packages for Enterprise Linux (EPEL) repository is not part of the distribution. For further details about EPEL, see https://fedoraproject.org/wiki/EPEL.

For enabling PowerTools repository on CentOS 8, please use following commands:

# yum -y install dnf-plugins-core
# yum config-manager --set-enabled PowerTools

If the DC should act as a print server with CUPS back end, additionally install the following package

# yum install cups-devel

Red Hat Enterprise Linux 7 / CentOS 7 / Scientific Linux 7

Install the following packages to build Samba as an Active Directory (AD) domain controller (DC) on a minimal Red Hat Enterprise Linux 7, CentOS 7, or Scientific Linux 7 installation:

 # yum install attr bind-utils docbook-style-xsl gcc gdb krb5-workstation \
       libsemanage-python libxslt perl perl-ExtUtils-MakeMaker \
       perl-Parse-Yapp perl-Test-Base pkgconfig policycoreutils-python \
       python2-crypto gnutls-devel libattr-devel keyutils-libs-devel \
       libacl-devel libaio-devel libblkid-devel libxml2-devel openldap-devel \
       pam-devel popt-devel python-devel readline-devel zlib-devel systemd-devel \
       lmdb-devel jansson-devel gpgme-devel pygpgme libarchive-devel



If the DC should act as print server (not recommended) with CUPS back end, additionally install:

# yum install cups-devel

Fedora

To install the build dependencies for Samba on Fedora, run the following command:

# dnf builddep libldb samba

openSUSE

# zypper source-install --build-deps-only libldb1 samba

Gentoo

See Building Samba on Gentoo

Samba Domain Member

Red Hat Enterprise Linux 8 / CentOS 8

Install the following packages to build Samba as a domain member on a minimal Red Hat Enterprise Linux (RHEL) 8 or CentOS 8 installation:

# yum install autoconf automake docbook-style-xsl gcc gdb jansson-devel \
      krb5-devel krb5-workstation libacl-devel libarchive-devel \ 
      libattr-devel libtasn1-tools libxslt lmdb-devel make openldap-devel \
      pam-devel python36-devel rpcgen

To install all required packages, you must enable the following repositories:

RHEL 8 CentOS 8
Base Base
AppStream AppStream
CodeReady Linux Builder* PowerTools
EPEL** EPEL**

* For further details about the CodeReady Linux Builder repository, see https://access.redhat.com/articles/4348511.

** The Extra Packages for Enterprise Linux (EPEL) repository is not part of the distribution. For further details about EPEL, see https://fedoraproject.org/wiki/EPEL.

For enabling PowerTools repository on CentOS 8, please use following commands:

# yum -y install dnf-plugins-core
# yum config-manager --set-enabled PowerTools

If the domain member should act as a print server with CUPS back end, additionally install the following package:

# yum install cups-devel

Red Hat Enterprise Linux 7 / CentOS 7 / Scientific Linux 7

# yum install autoconf automake gcc gdb krb5-devel krb5-workstation \
      openldap-devel make pam-devel python-devel docbook-style-xsl \
      libacl-devel libattr-devel libxslt 


Samba NT4 PDC

To be added.