Skip to content

Document the current web UI steps for importing a subscription manifest - #5435

Open
Satellite-RedHat wants to merge 1 commit into
theforeman:masterfrom
Satellite-RedHat:update-manifest-import-web-ui
Open

Satellite-RedHat wants to merge 1 commit into
theforeman:masterfrom
Satellite-RedHat:update-manifest-import-web-ui

Conversation

@Satellite-RedHat

Copy link
Copy Markdown

What changes are you introducing?

Update the shared web UI procedure for importing a Red Hat subscription manifest.

Why are you introducing these changes? (Explanation, links to references, issues, etc.)

The Subscriptions page no longer uses Manage Manifest, Choose File, and Open. On a fresh installation, for both connected and disconnected servers, the empty state action is Import a Manifest. When a manifest is already imported, the same window is available from the actions menu as Manage manifest. In the Manage Manifest window, on the Manifest tab, click Upload and select the manifest .zip. The import starts when the file is selected.

This module is included by the connected install guide, the disconnected install guide, and Managing content, so one change updates all three.

Downstream tracking: https://redhat.atlassian.net/browse/SAT-51920

The new file control is in current Katello. Katello 4.21 and earlier still use a file input, so this should not be cherry-picked to those branches.

Anything else to add? (Considerations, potential downsides, alternative solutions you have explored, etc.)

The recommended path is Import a Manifest during installation. The actions-menu path is included because Managing content uses the same module after a manifest already exists.

Contributor checklists

  • I am okay with my commits getting squashed when you merge this PR.
  • I am familiar with the contributing guidelines.

Please cherry-pick my commits into:

  • Foreman 5.0/Katello 5.0
  • Foreman 3.19/Katello 4.21
  • Foreman 3.18/Katello 4.20 (Satellite 6.19; orcharhino 7.9 and 7.10)
  • Foreman 3.17/Katello 4.19
  • Foreman 3.16/Katello 4.18 (Satellite 6.18; orcharhino 7.6, 7.7, and 7.8)
  • Foreman 3.15/Katello 4.17
  • Foreman 3.14/Katello 4.16 (Satellite 6.17; orcharhino 7.4; orcharhino 7.5)

The Subscriptions page opens the manifest window from Import a Manifest
on a fresh installation, and selecting the .zip file starts the import.

Co-authored-by: Cursor <cursoragent@cursor.com>
@github-actions github-actions Bot added Needs tech review Requires a review from the technical perspective Needs style review Requires a review from docs style/grammar perspective Needs testing Requires functional testing labels Oct 7, 2026
Comment on lines +22 to +23

The import starts when you select the `.zip` file.

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
The import starts when you select the `.zip` file.

This seems redundant.

. In the *Manage Manifest* window, click *Choose File*.
. Navigate to the location that contains the Red{nbsp}Hat subscription manifest file, then click *Open*.
. If no manifest is imported, click *Import a Manifest*.
To import a manifest when one is already present, open the actions menu and click *Manage manifest*.

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
To import a manifest when one is already present, open the actions menu and click *Manage manifest*.
. Click *Import a Manifest*.

I think there is a bit of a problem here as the next step only applies for users who are following the Manage Manifest method.
I am wondering if we can keep this procedure only for users who are uploading a new manifest i.e. the empty state action, and update the procedure in proc_updating-and-refreshing-red-hat-subscription-manifests.adoc.
This module is rendered only for the Managing Content guide and I believe this information only belongs in that guide, and not in the Installation guides.

@pr-processor pr-processor Bot added Waiting on contributor Requires an action from the author and removed Not yet reviewed labels Oct 7, 2026
Comment on lines +17 to +18
. If no manifest is imported, click *Import a Manifest*.
To import a manifest when one is already present, open the actions menu and click *Manage manifest*.

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

another issue: If line 17 starts with "If ...", then users might not continue to read line 18. So IMO line 18 should also be a step. Maybe use two if statements:

Suggested change
. If no manifest is imported, click *Import a Manifest*.
To import a manifest when one is already present, open the actions menu and click *Manage manifest*.
. Import your manifest:
* If no manifest is imported, click *Import a Manifest*.
* If you already have a manifest imported to {Project}, open the actions menu and click *Manage manifest*.

Maybe it also makes sense to move line 19 under the second unordered list item.

This branch has not been deployed

No deployments
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

Needs style review Requires a review from docs style/grammar perspective Needs tech review Requires a review from the technical perspective Needs testing Requires functional testing Waiting on contributor Requires an action from the author

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants