Project

General

Profile

Feature #38275

Improve Path and Name Lengths section of Guide

Added by Timur Bakeyev over 2 years ago. Updated about 2 years ago.

Status:
Done
Priority:
No priority
Assignee:
Timothy Moore II
Category:
Documentation
Target version:
Estimated time:
Severity:
Medium
Reason for Closing:
Reason for Blocked:
Needs QA:
No
Needs Doc:
No
Needs Merging:
No
Needs Automation:
No
Support Suite Ticket:
n/a
Hardware Configuration:

Description

With the actual limit of 47 bytes for the total name of the dataset, including path separators(*) it becomes essential to be able to rename dataset without loosing all it's snapshots and sub-datasets. This is doable and is supported by zfs itself, see zfs rename, so the only thing is needed is support for this operation in the middlewared and GUI.

  • When we accessing snapshot data it is automounted by ZFS inside the dataset. The total maximum length of the mount point is 87(?) bytes, plust terminating '\0'. Out of that 87 bytes 19 are used by mandatory /mnt/ and .zfs/snapshot/, 21 bytes are spared on snapshot name, like auto-20170716.1800-1y, leaving us with miserable 47 bytes for the datasets name hierarchy, including path separators. No wonder that frequently users can't access snapshots deep in the hierarchy.

This limitation should be lifted in the FreeBSD 12.0 up to 1024 bytes, but meanwhile...

Doc team should document this limitation more thoroughly, as current http://doc.freenas.org/11/intro.html#path-and-name-lengths doesn't explain all consequences of the bad dataset name selection.


Related issues

Related to FreeNAS - Bug #37550: No previous versions showing on a share when others workClosed

History

#1 Updated by Timur Bakeyev over 2 years ago

  • Related to Bug #37550: No previous versions showing on a share when others work added

#3 Updated by Dru Lavigne over 2 years ago

  • Subject changed from Add ability to rename dataset to Improve Path and Name Lengths section of Guide
  • Assignee changed from Release Council to Warren Block
  • Target version changed from Backlog to 11.2-RC1

#6 Updated by Warren Block over 2 years ago

  • Status changed from Unscreened to Screened

#7 Updated by Warren Block over 2 years ago

  • Target version changed from 11.2-RC1 to 11.2-RC2

#9 Updated by Dru Lavigne over 2 years ago

  • Target version changed from 11.2-RC2 to 11.2-U2

#10 Updated by Warren Block about 2 years ago

  • Status changed from Screened to Unscreened
  • Assignee changed from Warren Block to Timothy Moore II

#11 Updated by Timothy Moore II about 2 years ago

  • Status changed from Unscreened to Done
  • Needs QA changed from Yes to No
  • Needs Doc changed from Yes to No
  • Needs Merging changed from Yes to No

Ported previously missing notes about ZFS byte limitations into the angulargui branch of the guide: https://github.com/freenas/freenas-docs/pull/386. If further changes are needed, please leave a comment here or open a new issue.

#12 Updated by Dru Lavigne about 2 years ago

  • Target version changed from 11.2-U2 to 11.2-RC1

Also available in: Atom PDF