Bug 1859505

Summary: "Replacing the oVirt Engine Apache CA Certificate": engine-backup part is broken
Product: [oVirt] ovirt-engine Reporter: Yedidyah Bar David <didi>
Component: DocumentationAssignee: Steve Goodman <sgoodman>
Status: CLOSED CURRENTRELEASE QA Contact: Lukas Svaty <lsvaty>
Severity: high Docs Contact:
Priority: high    
Version: 4.4.1CC: adahms, royoung, sgoodman
Target Milestone: ovirt-4.4.3Keywords: Documentation, EasyFix, NoDocsQEReview
Target Release: ---Flags: pm-rhel: ovirt-4.4+
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: 2020-09-06 10:56:14 UTC Type: Bug
Regression: --- Mount Type: ---
Documentation: --- CRM:
Verified Versions: Category: ---
oVirt Team: Integration RHEL 7.3 requirements from Atomic Host:
Cloudforms Team: --- Target Upstream Version:
Embargoed:
Bug Depends On:    
Bug Blocks: 1841203    

Description Yedidyah Bar David 2020-07-22 09:46:12 UTC
Description of problem:

In the procedure to replace Apache CA Cert, we recently added a step (14, currently). It says to create some file, with content:

=========================================================
BACKUP_PATHS="${BACKUP_PATHS}
/etc/ovirt-engine-backup"
cp -f /etc/pki/ovirt-engine/apache-ca.pem
/etc/pki/ca-trust/source/anchors/3rd-party-ca-cert.pem
update-ca-trust
=========================================================

This is broken - the third line and fourth line should be a single long line, or perhaps better, we should add a backslash, e.g.:

=========================================================
BACKUP_PATHS="${BACKUP_PATHS}
/etc/ovirt-engine-backup"
cp -f /etc/pki/ovirt-engine/apache-ca.pem \
    /etc/pki/ca-trust/source/anchors/3rd-party-ca-cert.pem
update-ca-trust
=========================================================

Or, even better, provide concrete command-lines, that users can copy/paste directly, e.g.:

=========================================================
Enable engine-backup to update the system on restore. You can replace '3rd-party-ca-cert' with a more suitable name:

mkdir -p /etc/ovirt-engine-backup/engine-backup-config.d
cat << __EOF__ > \
    /etc/ovirt-engine-backup/engine-backup-config.d/update-system-wide-pki.sh
BACKUP_PATHS="\${BACKUP_PATHS}
/etc/ovirt-engine-backup"
cp -f /etc/pki/ovirt-engine/apache-ca.pem \\
    /etc/pki/ca-trust/source/anchors/3rd-party-ca-cert.pem
update-ca-trust
__EOF__
=========================================================

Comment 2 Steve Goodman 2020-09-03 08:47:33 UTC
Reviewed by Didi in the merge request.

Merged.