Note: This bug is displayed in read-only format because the product is no longer active in Red Hat Bugzilla.
Red Hat Satellite engineering is moving the tracking of its product development work on Satellite 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 "Satellite project" in Red Hat Jira and file new tickets here. Individual Bugzilla bugs will be migrated starting at the end of May. 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 "Satellite project" in Red Hat Jira (issue links are of type "https://issues.redhat.com/browse/SAT-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 2172610

Summary: "Chapter 3. Cloning Satellite Server" of "Administering Red Hat Satellite" contains 6.12 repo information instead of 6.13
Product: Red Hat Satellite Reporter: Sayan Das <saydas>
Component: DocumentationAssignee: Adam Lazik <alazik>
Documentation sub component: default QA Contact:
Status: CLOSED CURRENTRELEASE Docs Contact:
Severity: high    
Priority: high CC: alazik, mdolezel
Version: 6.13.0Keywords: Triaged
Target Milestone: Unspecified   
Target Release: Unused   
Hardware: All   
OS: All   
Whiteboard:
Fixed In Version: Doc Type: If docs needed, set a value
Doc Text:
Story Points: ---
Clone Of: Environment:
Last Closed: 2023-05-03 20:51:39 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 Sayan Das 2023-02-22 17:39:33 UTC
Document URL: 

https://dxp-docp-prod.apps.ext-waf.spoke.prod.us-west-2.aws.paas.redhat.com/documentation/en-us/red_hat_satellite/6.13/html-single/administering_red_hat_satellite/index?lb_target=preview

Section Number and Name: 

Chapter 3. Cloning Satellite Server

Describe the issue: 

3.2. Prerequisites
~~
A backup from Satellite 6.12 that you make using the satellite-maintain backup script. You can use a backup with or without Pulp data.
~~

3.4.2. Cloning to the Target Server

Step 4:
~~
# subscription-manager register your_customer_portal_credentials
# subscription-manager attach --pool=pool_ID
# subscription-manager repos --disable=*
# subscription-manager repos --enable=rhel-8-for-x86_64-appstream-rpms \
--enable=satellite-6.12-for-rhel-8-x86_64-rpms \
--enable=satellite-maintenance-6.12-for-rhel-8-x86_64-rpms
~~

We mention the details of 6.12 instead of 6.13

Suggestions for improvement: 

Ensure that we are mentioning details about 6.13 instead of 6.12 in the highlighted sections. 

Additional information: 

NA

Comment 1 Adam Lazik 2023-02-23 12:22:33 UTC
Hello Sayan,
The Cloning Server chapter is (or rather was) built so that customers can create a backup of their server, which has a previous version, before upgrading to current product version.
What surprised me is that it is currently in Administering Satellite, because it used to be in Updating and Upgrading guide where it makes the most sense. After tracing back the PR (https://github.com/theforeman/foreman-documentation/pull/1965) it appears that it was removed from the Upgrading Guide because it was deemed unnecessary by the Stakeholders. So the most logical course of action right now would be to rewrite to chapter to clone the current version of the Satellite server; however; I will need to confirm this with management and other writers. Currently verifying the next course of action.
CC @mdolezel

Comment 2 Sayan Das 2023-02-23 12:43:21 UTC
Correct. 

The reason for raising the bug is the fact that we have the cloning process documented here in the Administration Guide. 

But cloning is not needed only for upgrades, If someone wants to migrate a Sat 6.13 from one VM to another, Cloning can be used there as well .

From that perspective, 

Upgrade guide of 6.13, can have the cloning instruction for 6.12

But Admnistration guide should have instructions for 6.13 only.

Comment 3 Adam Lazik 2023-02-23 12:56:44 UTC
Agreed.

I will update this ticket soon with the next steps.

Comment 4 Adam Lazik 2023-02-27 17:52:46 UTC
Created PR:
https://github.com/theforeman/foreman-documentation/pull/2029