** Setup and configure file shares **

===== Introduction =====

Samba allows you, since version 4, to do most share configuration via windows. In particular, the permission management with real Windows ACLs and multiple entries is much easier when done on Windows. The following Howto will give you an overview of how to manage shares.

To use the advanced features of Samba, it has to be compiled with ACL support. Also you need a filesystem that supports the "user" and "system" xattr namespaces. It also needs to have ACL and XATTR support.

You can see [[requeriments#file_system_support|Samba4 File System support]] to complete the requirements.
===== ACL support on member server =====
----

The following is only required on Domain Member Servers and not on Domain Controllers! Add the following to your [global] section of your smb.conf if you don't did this early:
<code>
 vfs objects = acl_xattr
 map acl inherit = Yes
 store dos attributes = Yes
</code>

This options are required on Member Servers, to enable the possibility for real windows ACLs. On Domain Controllers, ACL support is automatically enabled.


===== SeDiskOperatorPrivilege =====
----

To configure share permissions, you need an account with "//SeDiskOperatorPrivilege//". To see existing privileges can be reviewed by:
<code>
 # net rpc rights list accounts -U'YOURDOMAIN\administrator'
</code>

In case the 'administrator' account don't have this privilege, you can grant this privilege, e. g. to the "Domain Admin" group, run the following command on your server:
<code>
 # net rpc rights grant 'YOURDOMAIN\Domain Admins' SeDiskOperatorPrivilege -U'YOURDOMAIN\administrator'
</code>

===== Adding a new share =====
----

  * Create a folder that you want to share
<code>
 # mkdir -p /srv/samba/Demo/
</code>
  * Add a new share to your smb.conf:
<code>
 [Demo]
     path = /srv/samba/Demo/
     read only = no
</code>
  * Reload Samba:
<code>
 # smbcontrol all reload-config
</code>


===== Setup share permissions =====
----

First you need to have access to your domain user administrator (or your currently domain user) in file system:

<code>chown -R administrator:'domain users' /srv/samba/Demo</code>

Then:

  * Log on to a Windows machine using an account, to which the "//SeDiskOperatorPrivilege//" was granted to or an account in a group with granted privilege.
  * Open the Start Menu and search for "Computer Management".
  * In the menu bar go to "Action" -> "Connect to another computer".
  * Enter the name of your Samba server, you've create the new share on.
  * Navigate to "System Tools" -> "Shared Folders" -> "Shares" and select the new added share.
{{:computer_management_shares.png?710|}}
  * Right-click to the share name, choose "Properties".
  * Go to the "Share Permissions" tab. Here you can configure who can access the share and the appropriate permissions.
{{:demo_share_permissions.png|}}
  * Go to the "Security" tab, click the „Edit“ button and configure the file system permissions.
{{:demo_share_security.png|}}
  * Save the changes by closing the windows with "OK".

===== Change permissions on folders of a share =====
----

  * Log on to a Windows machine as //Domain Administrator//.
  * Navigate to the folder of which you want to change the permissions.
  * Right-click to the folder and choose "Properties".
  * Go to the "Security" tab and click the "Edit" button.
  * Change the permissions to your needs.
{{:folder_permissions.png|}}
   * Save the changes by closing the windows with "OK".


===== Managing extended ACLs in Linux =====
----

To see extended ACLs:

<code># cd /srv && getfacl samba/Demo
# file: samba/Demo/
# owner: cbustillo
# group: domain\040users
user::rwx
group::r-x
other::r-x
</code>

To set extended ACLs for others users:
<code># setfacl -R -m default:other::r-x ServicePacks/ </code>

To remove all extended ACLs:
<code># setfacl -b /srv/samba/Demo
# setfacl -b /srv/samba/Demo/*</code>

More info about extended ACLs in:
<code># man setfacl
# man getfacl</code>

===== Troubleshooting =====
----

In certain situations, share configuration parameters which were commonly used with NT-style domains such as "force group" or "force user" may lead to "Access Denied" errors when trying to set permissions on a new share, or other complications, such as losing the ability to even see the Security tab. You may find even after correcting the issues that the problems may persist even after removing and re-adding the share properly. In such cases, it may be helpful to manually wipe out all ACLs on the share and recursively re-grant full control to the Domain Admins group with the setfacl command as follows (may need to run as root):

<code># setfacl -b /path/to/share
# setfacl -b /path/to/share/*
# setfacl -R -m default:group:domain\ admins:rwx /path/to/share</code>
===== Related HowTos =====
----

The following HowTos treat topics, related on setting up file shares with special permissions or purposes:
  * [[setting_up_a_home_share|Setting up a home share]]
  * [[samba_and_windows_profiles|Samba and Windows Profiles]]