Bug 1355849 - [DOC] incorrect use of the CRMFPopClient command
Summary: [DOC] incorrect use of the CRMFPopClient command
Keywords:
Status: CLOSED CURRENTRELEASE
Alias: None
Product: Red Hat Certificate System
Classification: Red Hat
Component: Doc-cli-tools-guide
Version: 9.0
Hardware: Unspecified
OS: Unspecified
high
unspecified
Target Milestone: rc
: 9.1
Assignee: Petr Bokoc
QA Contact: Asha Akkiangady
URL:
Whiteboard:
Depends On:
Blocks:
TreeView+ depends on / blocked
 
Reported: 2016-07-12 17:46 UTC by Tomas Capek
Modified: 2017-04-13 19:52 UTC (History)
7 users (show)

Fixed In Version:
Doc Type: If docs needed, set a value
Doc Text:
Clone Of:
Environment:
Last Closed: 2017-04-04 16:37:28 UTC
Target Upstream Version:
Embargoed:


Attachments (Terms of Use)

Description Tomas Capek 2016-07-12 17:46:17 UTC
From Red Hat Customer Service (CS Ticket 89521):

the use of the CRMFPopClient command at:
https://access.redhat.com/documentation/en-US/Red_Hat_Certificate_System/9/html/Command-Line_Tools_Guide/CRMF_Pop_Request.html

There is a call out NOTE which says:

'Key archival is done automatically based on whether a transport.txt file (containing the KRA's transport certificate) is in the directory from which the command is run. If the file is present, then the archival is automatically performed; if it is not, then no archival is attempted.
The transport.txt must have the entire base 64-encoded transport certificate on a single line with the header and footer removed'.



Based on our testing the description is incorrect. If the transport.txt file is _not_ present, the archival is attempted anyway and fails with the message:
ERROR: File 'transport.txt' does not exist<br>
Try 'CRMFPopClient --help' for more information.

Please change the documentation to reflect this or fix the product. As it stands it is inaccurate and misleading.

Comment 4 Sumedh Sidhaye 2016-10-12 11:01:07 UTC
The updated documentation describes the correct CRMFPopClient error message when transport.txt is not present in the directory from which the command is run.

Hence marking this verified.


Note You need to log in before you can comment on or make changes to this bug.