Project

General

Profile

Feature #38275

Improve Path and Name Lengths section of Guide

Added by Timur Bakeyev about 2 years ago. Updated over 1 year 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 about 2 years ago

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

#3 Updated by Dru Lavigne about 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 about 2 years ago

  • Status changed from Unscreened to Screened

#7 Updated by Warren Block almost 2 years ago

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

#9 Updated by Dru Lavigne almost 2 years ago

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

#10 Updated by Warren Block almost 2 years ago

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

#11 Updated by Timothy Moore II almost 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 over 1 year ago

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

Also available in: Atom PDF