== Samba ==
Samba is a free SMB and CIFS client and server and Domain Controller for UNIX and other operating systems.

=== Samba in Storage SIG ===
Samba rpms from Storage SIG are built with internal sources of dependent libraries for ''libtalloc'', ''libtevent'', ''libtdb'' and ''libldb''. Therefore it is expected to not have any dependency on system installed version of those libraries. In case you find such an explicit requirement, feel free to report on [[https://bugs.centos.org/|CentOS Bug Tracker]]

In addition to standard Samba packages, we ship '''samba-vfs-glusterfs''' rpm containing VFS module for GlusterFS integration via ''libgfapi''.

'''Note''':- Packages from Storage SIG does '''not''' contain necessary elements to setup Samba as an AD Domain Controller(DC) and are built with system MIT kerberos requirement for other configurations.

== Installation ==
Following version streams are available for Samba via Storage SIG:

* `centos-release-samba411` on CentOS 7 and 8 for Samba v4.11.x

* `centos-release-samba412` on CentOS 8 for Samba v4.12.x

* `centos-release-samba413` on CentOS 8 Linux and CentOS 8 Stream for Samba v4.13.x

* `centos-release-samba414` on CentOS 8 Linux and CentOS 8 Stream for Samba v4.14.x

Use ''centos-release-samba'' package to set up repositories for fetching Samba packages i.e,
{{{
# yum install centos-release-samba
}}}

Finally install required Samba rpms.
{{{
# yum install samba
# yum install samba-vfs-glusterfs
}}}

== Documentation ==
Refer following sections from [[https://wiki.samba.org/index.php/Main_Page|Samba Wiki]] on various documentation details:

* [[https://wiki.samba.org/index.php/User_Documentation|User Documentation]]

* [[https://wiki.samba.org/index.php/Developer_Documentation|Developer Documentation]]

* [[https://wiki.samba.org/index.php/Contribution_documentation|Contribution]]

=== GlusterFS Integration ===
Refer following links from [[https://docs.gluster.org/en/latest/|Gluster upstream docs]] for details on SMB/CIFS access to GlusterFS volumes:

* [[https://docs.gluster.org/en/latest/Administrator%20Guide/Accessing%20Gluster%20from%20Windows/|GlusterFS integration]]

* [[https://docs.gluster.org/en/latest/Administrator%20Guide/Setting%20Up%20Clients/#cifs-manual|Client access]]

== Testing ==
In general we have Samba's well known selftest configured to be run against each Merge Request at [[https://gitlab.com/samba-team/samba/-/merge_requests|GitLab]]. 

On the other side, we do have nightly CI runs against upstream code base of both Samba and GlusterFS [[https://github.com/gluster/samba-integration|Mainline Samba GlusterFS integration]] with following jobs:

* [[https://ci.centos.org/job/gluster_samba-integration/|gluster_samba-integration]]

* [[https://ci.centos.org/view/Gluster/job/gluster_samba-build-rpms-centos7-master/| CentOS 7 nightly build job]]

* [[https://ci.centos.org/view/Gluster/job/gluster_samba-build-rpms-centos8-master/| CentOS 8 nightly build job]]

* [[https://ci.centos.org/view/Gluster/job/gluster_samba-build-rpms-fedora33-master/| Fedora 33 nightly build job]]

* [[https://ci.centos.org/view/Gluster/job/gluster_samba-build-rpms-fedora34-master/| Fedora 34 nightly build job]]