Obtaining Samba: Difference between revisions
Mmuehlfeld (talk | contribs) m (Add whitelines for better readability. Adapt version in example to the latest current stable tree.) |
Mmuehlfeld (talk | contribs) (Rewrote "Obtaining Samba".) |
||
Line 1: | Line 1: | ||
= Stable |
= Stable Version (recommended) = |
||
Always download the Samba sources from [https://www.samba.org/ https://www.samba.org/]. |
|||
Samba always maintains three release series: |
|||
It is always recommended that you install the latest version of the [[Samba_Release_Planning#Current_Stable_Release|current stable release]]. If you need to use a previous series, always choose the last version from the [[Samba_Release_Planning#Maintenance_Mode|Maintainance Mode series]] or at least from the [[Samba_Release_Planning#Security_Fixes_Only_Mode|Security Fixes Only Mode]]. Older version may not contain all improvements, bug and security fixes. If you find that you require help and ask e. g. on the [https://lists.samba.org/mailman/listinfo/samba Samba Mailing List], you will typically be told to try a recent version, to ensure that the problem isn't fixed in the meantime. |
|||
* [[Samba_Release_Planning#Current_Stable_Release|current stable]] |
|||
* [[Samba_Release_Planning#Maintenance_Mode|maintenance mode]] |
|||
* [[Samba_Release_Planning#Security_Fixes_Only_Mode|security fixes only mode]] |
|||
The Samba team recommends that you always install the latest version of a [[Samba_Release_Planning|supported release]]. This guarantees that your installation contains all available security fixes. |
|||
⚫ | |||
In case you discover any problem, please update your installation to the latest version of the [[Samba_Release_Planning#Current_Stable_Release|current stable]] release before. This ensures that the problem has not been fixed in the meanti |
|||
me and reduces duplicate bug reports and unnecessary questions on the [https://lists.samba.org/mailman/listinfo/samba Samba Mailing List]. |
|||
⚫ | |||
⚫ | |||
== samba-master == |
|||
⚫ | |||
⚫ | |||
⚫ | |||
⚫ | |||
'''NOTE: Only do this if you want to test the very latest development Samba branch, do not not use packages from git in production!''' |
|||
To download the latest samba-master repository, run |
|||
== The samba-master Branch == |
|||
⚫ | |||
⚫ | |||
⚫ | |||
⚫ | |||
The following example demonstrates the checkout of the latest sources of Samba 4.2, scheduled for the next 4.2.x release: |
|||
⚫ | |||
⚫ | |||
⚫ | |||
alternatively: |
|||
For example, to clone the latest development branch for Samba 4.5 using the git protocol, run: |
|||
⚫ | |||
$ git clone -b v4-5-test git://git.samba.org/samba.git samba-v4-5-test |
|||
To clone the same branch using the http protocol, run: |
|||
⚫ | |||
⚫ | |||
If you already have downloaded a development source tree via „git“ and want to update it to the latest version, run the following command out of your corresponding git source directory: |
|||
⚫ | |||
⚫ | |||
If you receive the following error |
|||
To update a local cloned repository, run from in the source directory: |
|||
fatal: Unable to create '[...]/.git/index.lock': File exists. |
|||
⚫ | |||
run |
|||
$ git clean -x -f -d |
|||
to reset your tree. |
Revision as of 14:36, 19 August 2016
Stable Version (recommended)
Always download the Samba sources from https://www.samba.org/.
Samba always maintains three release series:
The Samba team recommends that you always install the latest version of a supported release. This guarantees that your installation contains all available security fixes.
In case you discover any problem, please update your installation to the latest version of the current stable release before. This ensures that the problem has not been fixed in the meanti me and reduces duplicate bug reports and unnecessary questions on the Samba Mailing List.
For further information about the release planning and the Samba life cycle, see Samba Release Planning.
Development Versions
Warning: Never install a development version in a production environment. It can contain untested features, cause damages and data! Use development version only for testing purposes!
The samba-master Branch
The "samba-master" branch contains the source code of the next release series. To download, run:
$ git clone git://git.samba.org/samba.git samba-master
Development Version of a Specific Branch
The "v*-test" branches contain the latest fixes and enhancements since the last release of the version source tree.
For example, to clone the latest development branch for Samba 4.5 using the git protocol, run:
$ git clone -b v4-5-test git://git.samba.org/samba.git samba-v4-5-test
To clone the same branch using the http protocol, run:
$ git clone -b v4-5-test http://git.samba.org/samba.git samba-v4-5-test
Updating a Local Git Repository
To update a local cloned repository, run from in the source directory:
$ git pull