Uploaded image for project: 'Satellite'
  1. Satellite
  2. SAT-29414

Create "Converting hosts to RHEL" guide

XMLWordPrintable

    • Icon: Story Story
    • Resolution: Unresolved
    • Icon: Normal Normal
    • None
    • None
    • Documentation
    • None

      Move Converting a host to RHEL (Managing hosts) to a standalone guide called "Converting hosts to RHEL".

      Use case: Converting many Oracle/CentOS Linux hosts to RHEL by using Satellite.

      Reasons for creating a separate book:

      • Converting multiple hosts to RHEL is not a routine task. It requires months of planning and is expensive.
      • Title should be plural to reflect the use case (RHEL guide procedures are for small numbers of hosts; Satellite is for large-scale conversion)
      • Prerequisites are complex. It would be better to break them into actual procedures.
      • Several steps in the current procedure (import Ansible role and variables, assign role to hosts) are actually separate procedures. This forces a user to jump between guides to perform a complex task, which is not a good user experience.

      Task scope:

      • Planning section:
        • Separate prerequisites from planning.  Planning includes tasks like reading documentation.
      • Prerequisites:
        • Try to avoid links. If they are procedures, re-use the existing procedure module.
        • True prerequisites are items that must be done in order for the conversion to succeed (installing convert2rhel, for example).
      • Procedure:
        • Begin with a high-level procedure or description.
        • Turn steps into procedures, where appropriate, reusing modules instead of linking to other docs.

              Unassigned Unassigned
              apinnick@redhat.com Avital Pinnick
              Votes:
              0 Vote for this issue
              Watchers:
              2 Start watching this issue

                Created:
                Updated: