Differences

This shows you the differences between two versions of the page.

--- nas-samba [2022/01/26 02:21] – clarity, grammar, define SMB hogwild
+++ nas-samba [2023/07/01 01:48] (current) – [Additional Share List] -grammar, formatting hogwild
@@ Line 1: / Line 1: @@
-===== File sharing =====
+====== File sharing ======
-The File sharing page allows you to enable and configure Samba filesharing. Samba is a Linux clone/replica of Microsoft's SMB (Server Message Block) fielsharing protocol. Samba allows FreshTomato to "speak" the same language as Windows when it comes to files interchange.
+The File sharing menu allows you to enable and configure Samba filesharing. Samba is a Linux clone/replica of Microsoft's SMB (Server Message Block) filesharing protocol. Samba allows FreshTomato to "speak" the same language as Windows for file sharing between Windows and Linux-based systems (such as FreshTomato). This allows you to use your FreshTomato router as a NAS drive, if you connect USB storage, such as an external hard drive or flash drive.
-Microsoft's SMB protocol has been upgraded in recent years to v3. FreshTomato's implementation supports v1 and v2 only. This is more than adequate for basic filesharing operations.
+Microsoft's SMB protocol was recently upgraded to v3. FreshTomato's implementation supports v1 and v2 only. However, these are more than adequate for basic file sharing operations.
-{{:pasted:20220110-123834.png}}\\  **Enable File Sharing**: No/Yes, no Authentication/Yes Authentication Required - For simple setup you will want Yes no authentication but if additional security is needed Yes, Authentication required will display two additional fields where a single username/password can be defined.\\  {{:pasted:20220110-125127.png}}\\  **Samba protocol version**: SMBv1/SMBv2/SMBv1 + SMBv2 - defined the maximum level of SMB supported. Please note it is good practice to enable both SMB1 and SMB2, imposing a version might be a good idea but could lead into scenarios where clients support only one version. This might generate to unwanted logs e.g. like this:\\  {{:pasted:20220111-092133.png}}\\  **Disable GRO**: GRO stands for Generic Receive Offload it essentially gather together small packets to be then sent as a single large packet. This optimises the network utilisation but involves and extra (sometime unwanted) Reassembly function. The option is enabled by default and essentially disables this feature. This is suggested unless you have specific requirements.\\  **Workgroup Name**: Specify the WORKGROUP name (logical division) where devices are displayed/organised (browsing the network).\\  **Client Codepage**: These code pages are used by DOS and Windows clients to determine rules for mapping lowercase letters to uppercase letters. Undefined by default can be set in case of case sensitivity issue. To verify on what Codepage your systems are (on Windows) run ''cmd.exe'' and type ''chcp'' to see the current code page.\\  \\  **Network Interfaces**: Define to what local interface the samba service should be binded to. This is br0 by default.\\
-{{:pasted:20220110-130832.png}}\\  **Samba Custom Configuration**: Is where you can pass user defined parameters to the samba process (smb.conf), make sure you consult the official samba documentation prior to affect this field.\\  **Auto-share all USB Partitions**: Disabled/Read Only/Read-Write/Hidden Read-Write. As the option suggests this allows you to perform automatic sharing option as soon as a media is plugged into the USB port (assuming it has a compatible filesystem).\\  Read only: can only open files and browse the storage content.\\  Read-Write: has full control on visible content.\\  Hidden Read-Write: Same as above but access to hidden content to e.g. files starting with a dot (.).\\  **Options**: Instruct your Samba server on additional network roles:\\  Master Browser: If enable it participate in the Master Browser election (when WINS is not available/defined).\\  WINS Server: Perform the role of Wins Server on the network. When enable clients will receive this info via DHCP but client with static addressing can point their WINS Server settings to FreshTomato's LAN IP.\\
+===== Samba File Sharing =====
-{{:pasted:20220110-134020.png}}\\  Additional Share List is where you define custom network shares mapping to physical filesystem. Remember this somehow would overlap with the Auto-share all Partition described above.\\  **Share name**: This is the share name appearing under the [[\\WORKGROUP\$routerhostname]].\\  **Directory**: Defines where the share maps in the real filesystem.\\  **Description**: This is a description only and appears when browsing the network. It has no functional role.\\  **Access Level**: This is the network level access right (Read Only / Read-Write). You must not confuse this with the filesystem rights, the two interact in a logical AND way (e.g. write on the filesystem AND write on the share is needed).\\  **Hidden**: Yes/No - If a share is hidden it will not be visible browsing the network but it will be available/usable if called directly.
+ \\
+{{:pasted:20220110-123834.png}}\\  \\
+ **Enable File Sharing**:
+  * No
+  * Yes, (with) no Authentication
+  * Yes Authentication Required
+ \\
+For a basic setup, select //Yes no authentication. //If additional security is needed, it's recommended you select the //Yes, Authentication required// . Doing so will display two additional fields where a single username and password can be entered.
+ \\ {{:pasted:20220110-125127.png}}\\  \\
+**Samba protocol version**:
+  * SMBv1
+  * SMBv2
+  * SMBv1 + SMBv2
+ \\
+This allows you to select the maximum SMB version supported. It is good practice to enable both SMB1 and SMB2. Imposing a specific version could lead to situations in which client devices aren't running a compatible version and so are not supported. This may generate unwanted log errors, such as the one seen below:
+ \\ \\ {{:pasted:20220111-092133.png}}\\  \\
+**Disable GRO:**  GRO (Generic Receive Offload) combines small packets to be sent as a one large packet. This optimizes network utilization, but involves extra reassembly functions. The default, (Enabled) disables the feature. Enabling this is recommended unless you have other requirements.
+**Workgroup Name:**  Here, specify the WORKGROUP name (logical grouping) of PCs for devices to be displayed/organized (for Windows peer-to-peer network browsing). Note that the Windows 10 April 2018 (ver. 1803) update eliminated the use of Windows 10 Homegroups. However, workgroups, still exist in Windows 10/11.
+**Client Codepage:**  DOS and Windows clients use code pages to determine rules for mapping lowercase letters to uppercase letters. Undefined, by default, can be set in scenarios where case sensitivity is an issue. To check what Windows Codepage your systems are on, run ''cmd.exe'' and type ''chcp'' to see the current code page.
+**Network Interfaces:**  In this field, you define to which local interface the samba service will be bound. (Default: br0).\\  \\
+{{:pasted:20220110-130832.png}}
+ \\
+**Samba Custom Configuration:** Here, you can specify user-defined parameters for the samba process (configured in the smb.conf file). Consult samba documentation before using this field: [[https://www.samba.org|https://www.samba.org]]/
+**Auto-share all USB Partitions:  **This lets you configure automatic sharing. As soon as storage with a compatible file system is connected to the USB port, its contents will be shared.
+  * Disabled - Automatic sharing will be disabled.
+  * Read Only - Users can only open files and browse the storage content
+  * Read-Write - Users have full control on visible content.
+  * Hidden Read-Write - While similar to Read-Write, this allows access to hidden content (such as files starting with a period).
+ \\
+**Options:** Configures your Samba server to perform additional network roles:
+  * Master Browser - If enabled, participate in the Master Browser election (when WINS is not available/defined).
+ WINS Server - If enabled, act as WINS server on the network. DHCP clients will receive the data via DHCP. Static clients can be configured with FreshTomato's LAN IP address as their WINS server setting.\\
+===== Additional Share List =====
+In this table, you can define custom network shares that map to physical filesystems. These may overlap, or even conflict with the //Auto-share all Partition //function described above.
+**Share name:**  This is the share name that appears under the [[\\WORKGROUP\$routerhostname]].
+**Directory:**  This defines where the share maps in the real filesystem.
+**Description:**  This is for description only, and appears when browsing the network. It has no functional role other than naming the share.
+**Access Level:**  This specifies the network-level access rights
+  * Read Only
+  * Read-Write
+ \\
+Do not confuse this setting with the filesystem rights. Total security is determined by executing a logical AND operator on the Access Level rights and the filesystem rights.
+**Hidden:**  A hidden share is not visible when browsing the network, but will still be available/usable if called directly (such as by the "net use" command in Windows).
+ \\
+ \\

FreshTomato Wiki

User Tools

Site Tools

Differences

Page Tools