Note: This bug is displayed in read-only format because the product is no longer active in Red Hat Bugzilla.

Bug 1355849

Summary: [DOC] incorrect use of the CRMFPopClient command
Product: Red Hat Certificate System Reporter: Tomas Capek <tcapek>
Component: Doc-cli-tools-guideAssignee: Petr Bokoc <pbokoc>
Status: CLOSED MIGRATED QA Contact: Asha Akkiangady <aakkiang>
Severity: unspecified Docs Contact:
Priority: high    
Version: 9.0CC: alee, cfu, fhanzelk, gkimetto, jmagne, mharmsen, rhel-docs, ssidhaye
Target Milestone: rcKeywords: Documentation, MigratedToJIRA, Reopened
Target Release: certsys-9.1   
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: 2017-04-04 16:37:28 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 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 1 Petr Bokoc 2016-07-25 12:37:07 UTC 
The admonition now describes what actually happens.

Preview:

http://jenkinscat.gsslab.pnq.redhat.com:8080/job/doc-Red_Hat_Certificate_System-Command-Line_Tools_Guide%20(html-single)/lastSuccessfulBuild/artifact/tmp/en-US/html-single/index.html#CRMF_Pop_Request
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.
Comment 5 Filip Hanzelka 2017-04-04 16:37:28 UTC 
Fixed at 
https://access.redhat.com/documentation/en-US/Red_Hat_Certificate_System/9/html/Command-Line_Tools_Guide/CRMF_Pop_Request.html#CRMF_Pop_Request
Comment 8 RHEL Program Management 2025-06-05 15:34:40 UTC 
Issue migration from Bugzilla to Jira is in process at this time. This will be the last message in Jira copied from the Bugzilla bug.