Bug 2172610 - "Chapter 3. Cloning Satellite Server" of "Administering Red Hat Satellite" contains 6.12 repo information instead of 6.13
Summary: "Chapter 3. Cloning Satellite Server" of "Administering Red Hat Satellite" c...
Keywords:
Status: CLOSED CURRENTRELEASE
Alias: None
Product: Red Hat Satellite
Classification: Red Hat
Component: Documentation
Version: 6.13.0
Hardware: All
OS: All
high
high
Target Milestone: Unspecified
Assignee: Adam Lazik
QA Contact:
URL:
Whiteboard:
Depends On:
Blocks:
TreeView+ depends on / blocked
 
Reported: 2023-02-22 17:39 UTC by Sayan Das
Modified: 2023-08-03 17:35 UTC (History)
2 users (show)

Fixed In Version:
Doc Type: If docs needed, set a value
Doc Text:
Clone Of:
Environment:
Last Closed: 2023-05-03 20:51:39 UTC
Target Upstream Version:
Embargoed:


Attachments (Terms of Use)


Links
System ID Private Priority Status Summary Last Updated
Red Hat Issue Tracker SAT-16088 0 None None None 2023-02-22 17:39:51 UTC

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


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