Bug 1371077

Summary: docs: Release note should mention that RHEL 7.2 needs to set ftype=1 to use OverlayFS on xfs
Product: Red Hat Enterprise Linux 7 Reporter: Kenjiro Nakayama <knakayam>
Component: Red_Hat_Enterprise_Linux-Release_Notes-7-en-USAssignee: Lenka Špačková <lkuprova>
Status: CLOSED CURRENTRELEASE QA Contact:
Severity: medium Docs Contact: Milan Navratil <mnavrati>
Priority: unspecified    
Version: 7.2CC: jeder, knakayam, lkuprova, mnavrati, rhel-docs
Target Milestone: rcKeywords: Documentation
Target Release: ---   
Hardware: All   
OS: Linux   
Whiteboard:
Fixed In Version: Doc Type: If docs needed, set a value
Doc Text:
Story Points: ---
Clone Of: Environment:
Last Closed: 2016-09-14 06:53:45 UTC Type: Bug
Regression: --- Mount Type: ---
Documentation: --- CRM:
Verified Versions: Category: ---
oVirt Team: --- RHEL 7.3 requirements from Atomic Host:
Cloudforms Team: --- Target Upstream Version:

Description Kenjiro Nakayama 2016-08-29 09:46:40 UTC 
Document URL:

  https://access.redhat.com/documentation/en-US/Red_Hat_Enterprise_Linux/7/html/7.2_Release_Notes/technology-preview-file_systems.html

Section Number and Name:
   ⁠
  Chapter 21. File Systems - OverlayFS

Describe the issue:

  OverlayFS on xfs need to explicitly add -n ftype=1 to any filesystems you create for use as overlay (e.g. if using the rootfs, it will need to be added to the Anaconda kickstart)." on this page.

  refer to https://bugzilla.redhat.com/show_bug.cgi?id=1288162#c38

Suggestions for improvement:

  Please note "OverlayFS on xfs need to explicitly add -n ftype=1 to any filesystems you create for use as overlay (e.g. if using the rootfs, it will need to be added to the Anaconda kickstart)." on this page.

Additional information:

  - To enable the option:
  # mkfs -t xfs -n ftype=1 /path/to/dev
  (Or, add to the anaconda kickstart.)

  - To check the option (Below is disabled as "ftype=0")
  # xfs_info /PATH/TO/DEV  |grep ftype
  naming   =version 2              bsize=4096   ascii-ci=0 ftype=0
Comment 7 Lenka Špačková 2016-09-14 06:53:45 UTC 
Thank you very much for providing the information.

RHEL 7.2 and 7.3 Beta Release Notes have been updated:

https://access.redhat.com/documentation/en-US/Red_Hat_Enterprise_Linux/7/html/7.2_Release_Notes/technology-preview-file_systems.html

https://access.redhat.com/documentation/en-US/Red_Hat_Enterprise_Linux/7-Beta/html/7.3_Release_Notes/technology_previews_file_systems.html