Note: This bug is displayed in read-only format because the product is no longer active in Red Hat Bugzilla.
RHEL Engineering is moving the tracking of its product development work on RHEL 6 through RHEL 9 to Red Hat Jira (issues.redhat.com). If you're a Red Hat customer, please continue to file support cases via the Red Hat customer portal. If you're not, please head to the "RHEL project" in Red Hat Jira and file new tickets here. Individual Bugzilla bugs in the statuses "NEW", "ASSIGNED", and "POST" are being migrated throughout September 2023. Bugs of Red Hat partners with an assigned Engineering Partner Manager (EPM) are migrated in late September as per pre-agreed dates. Bugs against components "kernel", "kernel-rt", and "kpatch" are only migrated if still in "NEW" or "ASSIGNED". If you cannot log in to RH Jira, please consult article #7032570. That failing, please send an e-mail to the RH Jira admins at rh-issues@redhat.com to troubleshoot your issue as a user management inquiry. The email creates a ServiceNow ticket with Red Hat. Individual Bugzilla bugs that are migrated will be moved to status "CLOSED", resolution "MIGRATED", and set with "MigratedToJIRA" in "Keywords". The link to the successor Jira issue will be found under "Links", have a little "two-footprint" icon next to it, and direct you to the "RHEL project" in Red Hat Jira (issue links are of type "https://issues.redhat.com/browse/RHEL-XXXX", where "X" is a digit). This same link will be available in a blue banner at the top of the page informing you that that bug has been migrated.

Bug 1495322

Summary: Integrate Permabit (VDO) docs into Storage Admin Guide
Product: Red Hat Enterprise Linux 7 Reporter: Stephen Gilson <sgilson>
Component: doc-Storage_Administration_GuideAssignee: Marek Suchánek <msuchane>
Status: CLOSED CURRENTRELEASE QA Contact: Jakub Krysl <jkrysl>
Severity: unspecified Docs Contact:
Priority: unspecified    
Version: 7.5CC: awalsh, coughlan, dkeefe, msuchane, rhel-docs
Target Milestone: rcKeywords: Documentation
Target Release: 7.5   
Hardware: Unspecified   
OS: Unspecified   
Whiteboard:
Fixed In Version: Doc Type: If docs needed, set a value
Doc Text:
Story Points: ---
Clone Of:
: 1507100 1552784 (view as bug list) Environment:
Last Closed: 2018-04-10 16:25:13 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:
Embargoed:
Bug Depends On: 1494639, 1494645, 1494647, 1496910, 1503710, 1508920, 1512155, 1523869, 1550626    
Bug Blocks: 1470091, 1552784    

Description Stephen Gilson 2017-09-25 19:51:23 UTC
RHEL 7.5 will be integrating the documentation that accompanied the acquisition of Permabit. The feature area, VDO (Virtual Data Optimization) will be added to RHEL 7.5 as part of the Filesystem & Storage subsystem(s). 

This product requirement is noted in the RHEL 7.5 PRD and is described as "Deduplication and Compression."

https://docs.google.com/document/d/1LkyrZZZrfddmdxp6fzmSo5kITQO_7eBYzih__fEjsCE/edit#heading=h.wbb6v5mv16om

Related BZ: https://bugzilla.redhat.com/show_bug.cgi?id=1029773

To integrate this material into the Storage Admin Guide, please take the docbook source in the attached archive from the following titles:

VDO Quick Start
VDO integration
VDO evaluation
VDO upgrade

The VDO Release Notes are not needed. The other titles in the archive that do not use the VDO prefix are also not needed.

These VDO titles can be integrated into the Storage Admin Guide as follows:
- Create a new Section called: "Data deduplication and compression with VDO"
- Create chapters in the new section for each of the VDO titles mentioned above in the most appropriate order. 


Contacts:
Filesystem & Storage subsystem lead: Tom Coughlan
Technical SME: Andy Walsh

Link to the archive file in case it's too big to be attached to BZ: 
http://file.bos.redhat.com/~sgilson/vdo-head-documentation.source.tgz

Comment 2 Marek Suchánek 2017-10-30 15:51:20 UTC
*** Bug 1497685 has been marked as a duplicate of this bug. ***

Comment 3 Marek Suchánek 2017-10-30 15:59:54 UTC
It has been decided to first release a VDO "Quick Start" guide by RHEL 7.5 Alpha. The documentation update is being tracked in BZ#1507100.

Comment 4 Marek Suchánek 2017-12-06 19:23:59 UTC
The VDO Quick Start Guide, which is our Alpha deliverable, is now published on the Customer Portal:
https://access.redhat.com/documentation/en-us/red_hat_enterprise_linux/7/html-single/storage_administration_guide/index#vdo-quick-start

Comment 5 Marek Suchánek 2018-01-05 18:49:04 UTC
The published Quick Start Guide has been extended to cover (very important) information on VDO write modes; see the built previews for the following two chapters:

* System Requirements: https://access.qa.redhat.com/documentation/en-us/red_hat_enterprise_linux/7/html/storage_administration_guide/vdo-qs-requirements

* Creating a VDO Volume: https://access.qa.redhat.com/documentation/en-us/red_hat_enterprise_linux/7/html/storage_administration_guide/vdo-qs-creating-a-volume

Meanwhile, I'm also working on adding the VDO Integration Guide. Currently, it's edited enough to build in our infrastructure, but content needs to be revised.

Comment 6 Marek Suchánek 2018-02-01 18:16:16 UTC
I'm currently editing the content of the Integration Guide to remove obsolete bits and to update the features that have changed since VDO became a Red Hat project.

The Integration Guide is still staying on a topic branch of the Storage Administration Guide.

* Built topic branch:
  http://ccs-jenkins.gsslab.brq.redhat.com:8080/job/doc-Red_Hat_Enterprise_Linux-7-Storage_Administration_Guide-branch-vdo-integration-guide-1495322/lastSuccessfulBuild/artifact/tmp/en-US/html-single/index.html#VDO-integration

* Google Doc with comments and requests by SMEs:
  https://docs.google.com/document/d/1NwOQmG1YOcgocKwTaIY8xdvigtNt9asWDIa41l2mpws/edit?usp=sharing

Comment 7 Marek Suchánek 2018-02-14 16:58:42 UTC
The Quick Start Guide and the Integration Guide are now merged into a coherent set of chapters without any duplication or redundancy.

Preview:
https://access.qa.redhat.com/documentation/en-us/red_hat_enterprise_linux/7/html-single/storage_administration_guide/#vdo

Comment 8 Marek Suchánek 2018-03-07 17:56:36 UTC
Content from the VDO Integration Guide is now published on the Customer Portal:

https://access.redhat.com/documentation/en-us/red_hat_enterprise_linux/7/html/storage_administration_guide/vdo

Comment 9 Marek Suchánek 2018-04-10 16:25:13 UTC
The complete VDO documentation is now published:
https://access.redhat.com/documentation/en-us/red_hat_enterprise_linux/7/html/storage_administration_guide/vdo

I'm closing this bug to reflect that.

More updates will be made to improve the content, but these will be made asynchronously.