Bug 1676801

Summary:	stratis manpage is missing new cache size restriction
Product:	Red Hat Enterprise Linux 8	Reporter:	Jakub Krysl <jkrysl>
Component:	stratis-cli	Assignee:	mulhern <amulhern>
Status:	CLOSED ERRATA	QA Contact:	Storage QE <storage-qe>
Severity:	low	Docs Contact:
Priority:	unspecified
Version:	8.0	CC:	amulhern, dkeefe
Target Milestone:	rc	Flags:	pm-rhel: mirror+
Target Release:	8.0
Hardware:	Unspecified
OS:	Unspecified
Whiteboard:
Fixed In Version:		Doc Type:	If docs needed, set a value
Doc Text:		Story Points:	---
Clone Of:		Environment:
Last Closed:	2019-11-05 21:04:23 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:

Description Jakub Krysl 2019-02-13 09:39:39 UTC

Description of problem:

BZ 1641966 added 32TiB restriction on cache size, but manpage does not mention anything about this:
       pool add-cache <pool_name> <blockdev> [<blockdev>..]
           Add one or more blockdevs to an existing pool, to be used as a cache instead of additional storage. Typically, smaller and faster drives, such as SSDs, are used for this purpose.

Version-Release number of selected component (if applicable):
stratis-cli-1.0.2-1.el8.noarch

How reproducible:
100%

Steps to Reproduce:
1. man stratis

Actual results:
no mention of the new 32TiB size restriction on cache size in manpage.

Expected results:
32TiB restriction on cache size is mentioned in manpage 

Additional info:

Comment 1 mulhern 2019-02-13 14:06:30 UTC

https://github.com/stratis-storage/stratis-cli/issues/237

Comment 3 Jakub Krysl 2019-07-29 14:22:56 UTC

stratis-cli-1.0.4-2.el8.noarch

       pool add-cache <pool_name> <blockdev> [<blockdev>..]
           Add one or more blockdevs to an existing pool, to be used as a cache instead of additional storage. Typically, smaller and faster drives, such as SSDs, are used for this
           purpose. NOTE: There is a temporary restriction on the total size of the cache device of 32 TiB. Adding devices to the cache so that the cumulative size of all the devices in
           the cache exceeds 32 TiB will result in an error.

Comment 6 errata-xmlrpc 2019-11-05 21:04:23 UTC

Since the problem described in this bug report should be
resolved in a recent advisory, it has been closed with a
resolution of ERRATA.

For information on the advisory, and where to find the updated
files, follow the link below.

If the solution does not work for you, open a new bug report.

https://access.redhat.com/errata/RHBA-2019:3414