You are here:

Table of Contents

Scope/Description

This article covers the process of creating and managing SMB shares (Samba/Server Message Block) within the Houston UI management interface.

Prerequisites

In Houston UI, navigate to the File Sharing tab. you can begin configuring your SMB Shares.

- Navigate to the section for the Global SMB configuration.
- Here you can change the Server Description, Workgroup, and Log Level.
- Add any additional parameters to the SMB configuration in the Advanced Settings box by enabling Global MacOS Shares

Example: Parameters to help with MacOS performance on an SMB share may be added here.

Configure the following settings:

SMB Share Name
Description:
Path to be shared out (The path can be created here instead of in ZFS).
- Choose Create ZFS Dataset.
Optionally select to use Windows ACLs if the system is domain-joined.
- This option is not going to be available for a non Active Directory Joined Server )
Specify any Valid Users and Valid Groups.
Choose to allow Guest Access.
Set the share to be Read Only or Browsable.

Add any additional options specific to the share in the Advanced Settings box via the drop-down arrow.

Example: Entering “inherit permissions = yes”.

There are preselected options that can be easily added by selecting one of the buttons below the box: Shadow Copy, MacOS Share, or Audit Logs.

For macOS Time Machine backups, you must add these options:

vfs objects = shadow_copy2 catia fruit streams_xattr

fruit:encoding = native

fruit:metadata = stream

fruit:zero_file_id = yes

fruit:nfs_aces = no

Hit Apply
Confirm that it also created the ZFS dataset ( This is important to have especially in setting up snapshots )

To verify that your share has been created and configured correctly, You will see it listed under Share Configuration.

Run testparm -s on the command line. You should see your samba share added and configured in its own section.

Attempt to connect to the SMB share from client machines.