
              !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
              !!! Please read before runing any tools !!!
              !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!

Documentation
=============

    o https://wiki.samba.org/index.php/Samba4/HOWTO

    o https://wiki.samba.org/index.php/Samba_AD_DC_HOWTO

    o https://wiki.samba.org/index.php/Samba4/samba-tool/domain/classicupgrade/HOWTO

FreeBSD specific information
============================

* Your configuration is in: /usr/local/etc/smb4.conf

* All the logs are under: /var/log/samba4

* All the relevant databases are under: /var/db/samba4

* Provisioning script is: /usr/local/bin/samba-tool

Samba4 provisioning requires file system(s) with POSIX ACLs support. At
the moment that is UFS2 only. You have to add 'acls' option to the mount
flags to get things working.

It is known that ZFS-only installations don't work out of the box with
Samba4. In partucular, s3fs service requires POSIX ACLs during provi-
sioning. It is possible to work around that requirement by specifying:

    # samba-tool domain provision --interactive --use-xattrs=no --use-ntvfs

And removing later in 'smb4.conf' options like:

    'server services', 'dcerpc endpoint servers', 'posix:eadb'

and adding 'vfs objects = zfsacl' as well. Still this isn't supported
and tested configuration, so use it at your own risk.

You may find this tutorial useful, if you happen to run Samba4 on
ZFS-root:

    o http://glsan.com/community/samba4

To run this port you need to perform the following steps:
---------------------------------------------------------

0. If you had Samba3 port installed before, please, *take backups* of
all the relevant files. That includes 'smb.conf' file and all the
content of the '/var/db/samba/' directory.

If you had Samba4-devel installation before to my knowledge the best
option would be to start from scratch.

1a. Create new '/usr/local/etc/smb4.conf' file by running:

    # samba-tool domain provision

1b. Or upgrade from the Samba3 'smb.conf' file by running:

    # samba-tool domain classicupgrade

1c. You will need to specify location of the 'nsupdate' command in the
'smb4.conf' file:

      nsupdate command = /usr/local/bin/samba-nsupdate -g

2. Put string 'samba4_enable="YES"' into your /etc/rc.conf.

3. Make sure that your server doesn't run Samba3, OpenLDAP and named.
Stop them, if necessary.

4. Run '/usr/local/etc/rc.d/samba4 start' or reboot.

WARNING! This port is still experimental and if you need any asistance,
please, check archives of samba@lists.samba.org and ask there for help.

    https://lists.samba.org/archive/samba/

In case you found a bug which is clearly not related to the port build
process itself, plese file a bug report at:

    https://bugzilla.samba.org/

And add me to CC list.

You may find those tools helpful:
---------------------------------

Microsoft Remote Server Administration Tools (RSAT) for:

* Vista: http://www.microsoft.com/en-us/download/details.aspx?id=21090
* Windows 7: http://www.microsoft.com/en-us/download/details.aspx?id=7887


FreeBSD Samba4 port maintainer: Timur I. Bakeyev <timur@FreeBSD.org>
