PD-1631 / 25.04 / Pd 1631 add smb limitations to tutorials and UI ref (by micjohnson777) #3425
Conversation
|
|
||
| #### Windows, Linux, and MacOS Client SMB Limitations | ||
| {{< truetable >}} | ||
| | | Windows | Linux (Ext4) | Linux (XFS) | MacOS | |
There was a problem hiding this comment.
Why are different Linux filesystems listed here? This is SMB client, so the filesystem will be SMB.
There was a problem hiding this comment.
Each OS client has different limitations. We have users on Windows, Linux and Mac so this is provided for those individuals to know what the limitations are.
| | Maximum length for path (characters) | 260* | 4096 | 4096 | 255*** | | ||
| | Invalid characters | angle brackets < ><br>colon :<br>asterick *<br>slashes / \<br>pipe | | NULL (?0)<br>slash (/) | NULL (?0)<br>slash (/) | slash /<br>colon :<br> | | ||
| | Case sensitivity | Yes | No | No | Yes | | ||
| | Single file size/write size** | 16 TB | 16 TB | 8 EB | # | |
There was a problem hiding this comment.
I don't know what relevance is here. The single file size is basically determined by the filesystem limitations of the server holding the file. I'm not aware of any SMB client imposing a filesize limitation.
There was a problem hiding this comment.
This was listed as information I should provide. If it is not relevant I can strip this out.
| | Invalid characters | angle brackets < ><br>colon :<br>asterick *<br>slashes / \<br>pipe | | NULL (?0)<br>slash (/) | NULL (?0)<br>slash (/) | slash /<br>colon :<br> | | ||
| | Case sensitivity | Yes | No | No | Yes | | ||
| | Single file size/write size** | 16 TB | 16 TB | 8 EB | # | | ||
| | Maximum volume size | 256 TB | 1 EB | 8 EB | # | |
There was a problem hiding this comment.
What is relevance here? We're talking SMB, not the local filesystem.
There was a problem hiding this comment.
Relevance was what each OS client's capabilities are. If not relevant we can strip out this information.
| | Case sensitivity | Yes | No | No | Yes | | ||
| | Single file size/write size** | 16 TB | 16 TB | 8 EB | # | | ||
| | Maximum volume size | 256 TB | 1 EB | 8 EB | # | | ||
| | Available file descriptors | 1024 | 1024 | 1024 | 256 | |
There was a problem hiding this comment.
Where is this coming from? It's very wrong.
There was a problem hiding this comment.
ChatGPT hallucination most likely. I'll strip this out.
| | Single file size/write size** | 16 TB | 16 TB | 8 EB | # | | ||
| | Maximum volume size | 256 TB | 1 EB | 8 EB | # | | ||
| | Available file descriptors | 1024 | 1024 | 1024 | 256 | | ||
| | File permissions: ACL entries (ACEs) per ACL, per file or directory | 1025 | 32 | 1000+ | 64 | |
There was a problem hiding this comment.
This isn't isn't related to SMB protocol.
There was a problem hiding this comment.
I'll strip out this information.
| | Maximum volume size | 256 TB | 1 EB | 8 EB | # | | ||
| | Available file descriptors | 1024 | 1024 | 1024 | 256 | | ||
| | File permissions: ACL entries (ACEs) per ACL, per file or directory | 1025 | 32 | 1000+ | 64 | | ||
| | Maximum file descriptors simultaneously opened by a process | set limit | 1024+ | 1024+ | 256 | |
There was a problem hiding this comment.
This isn't related to SMB protocol or client.
There was a problem hiding this comment.
I'll strip out this information.
| Change the system limits in Linux <file>limits.conf</file> file to increase the default number of file descriptors allowed. | ||
|
|
||
| #### Samba SMB Limitations | ||
| Samba SMB is not designed to work well in distributed file systems like Ceph or GlusterFS without careful configuration. |
There was a problem hiding this comment.
This is irrelevant. We're not using Ceph or Glusterfs. I don't know where this is coming from, but it's quite wrong.
There was a problem hiding this comment.
I'll strip this out as well. Same source for all this information.
| Samba SMB is not designed to work well in distributed file systems like Ceph or GlusterFS without careful configuration. | ||
|
|
||
| Performance is impacted by single-threaded connections that are handled one at a time. These can become a bottleneck in high-demand environments. | ||
| Samba SMB might not achieve the same raw I/O as native SMB implementations, especially in high-number file access or large file environments. |
There was a problem hiding this comment.
Why are we calling this out? It's not helpful for our users and is incorrect.
| Samba can consume significant amounts of memory when handling many concurrent sessions, large files, or high numbers of shares. | ||
| Higher numbers of clients increase memory requirements exponentially. | ||
|
|
||
| The Samba SMB server might need heavy optimization or to be scaled horizontally to avoid bottlenecks in environments with massive numbers of clients connecting simultaneously. |
There was a problem hiding this comment.
Why are we talking about Samba needing heavy optimization?
| | | SMB1* | SMB2 | SMB3 | | ||
| |--|-------|------|------| | ||
| | Maximum file size/write size | 2 GB | 256 TB | 256 TB | | ||
| | Large file and volume size support | No | 16 EB | 16 EB | |
There was a problem hiding this comment.
Where is this coming from? It's wrong.
|
Significant issues found during SME review. I'm closing this PR and am investigating the original ticket to identify a path forward for this requested content. |
Automatic cherry-pick failed. Please resolve conflicts by running:
If the original PR was merged via a squash, you can just cherry-pick the squashed commit:
This PR creates a snippet with SMB limitations information and issues/limitations related to using third-party file managers.
The snippet is only added to the main SMB tutorial index file.
backport to 25.04, 24.10, and 24.04
Thanks for contributing to TrueNAS documentation! By opening a Pull Request, you're acknowledging that your changes will be distributed under the Creative Commons 4.0 license.
Original PR: #3415
Jira URL: https://ixsystems.atlassian.net/browse/PD-1631