Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Katello 4.15 release docs #3451

Open
wants to merge 1 commit into
base: 3.13
Choose a base branch
from
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
1 change: 1 addition & 0 deletions guides/doc-Release_Notes/master.adoc
Original file line number Diff line number Diff line change
Expand Up @@ -14,6 +14,7 @@ endif::[]

// Start inserting specific x.y.z releases here
include::topics/foreman-3.13.0.adoc[leveloffset=+1]
include::topics/katello-4.15.0.adoc[leveloffset=+1]

[appendix]
[id="foreman-contributors"]
Expand Down
110 changes: 110 additions & 0 deletions guides/doc-Release_Notes/topics/katello-4.15.0.adoc
Original file line number Diff line number Diff line change
@@ -0,0 +1,110 @@
= Katello 4.15.0

A full list of changes is available on https://projects.theforeman.org/issues?set_filter=1&sort=id%3Adesc&status_id=closed&f%5B%5D=cf_12&op%5Bcf_12%5D=%3D&v%5Bcf_12%5D%5B%5D=1843[Redmine]

== Katello

* pass:[Empty Error Pop Up related to structured APT on the RepositorySets page] - https://projects.theforeman.org/issues/38011[#38011]
* pass:["Manage Manifest" modal links to access.redhat.com] - https://projects.theforeman.org/issues/37889[#37889]
* pass:[Update global registration form for multi-env AK display] - https://projects.theforeman.org/issues/37881[#37881]
* pass:[Full Capsule Sync always trigger pulp optimised sync] - https://projects.theforeman.org/issues/37879[#37879]
* pass:[Unable to add subscription to the empty manifest] - https://projects.theforeman.org/issues/37876[#37876]
* pass:[Allow smart proxy content counting for an environment/content view] - https://projects.theforeman.org/issues/37871[#37871]
* pass:[Use memory fact instead of dmi] - https://projects.theforeman.org/issues/37866[#37866]
* pass:[Container push sometimes makes duplicate repos due to race condition] - https://projects.theforeman.org/issues/37785[#37785]
* pass:[Handle empty CVE in InfoProvider content_view_info] - https://projects.theforeman.org/issues/37779[#37779]
* pass:[Use :default_location_subscribed_hosts in registration] - https://projects.theforeman.org/issues/37703[#37703]
* pass:[Pagination within Packages wizard is wonky] - https://projects.theforeman.org/issues/37587[#37587]
* pass:[Support Zeitwerk loader] - https://projects.theforeman.org/issues/37471[#37471]

=== API

* pass:[apidoc doesn't allow to unset CV/LCE of an activationkey] - https://projects.theforeman.org/issues/38008[#38008]
* pass:[Add content view environment labels to host rabl] - https://projects.theforeman.org/issues/37957[#37957]

=== Activation Key

* pass:[Activation key doesn't get LCE/CV assigned to it on creation] - https://projects.theforeman.org/issues/37941[#37941]
* pass:[Multi-CV activation keys get their content view environments overwritten on any edit] - https://projects.theforeman.org/issues/37798[#37798]
* pass:[As a user, I want to be able to set multiple Content Views via a single Activation key] - https://projects.theforeman.org/issues/37795[#37795]
* pass:[Single activation key is not filled in on Register page] - https://projects.theforeman.org/issues/37572[#37572]

=== Content Credentials

* pass:[Unable to load gpg key using downloaded key file] - https://projects.theforeman.org/issues/37804[#37804]

=== Content Views

* pass:[Content view version errata page shows incorrect date for "updated at" value] - https://projects.theforeman.org/issues/37911[#37911]
* pass:[Content View publish from different pages gives inconsistent warning message] - https://projects.theforeman.org/issues/37886[#37886]
* pass:[Add a content view environments controller] - https://projects.theforeman.org/issues/37884[#37884]
* pass:[Update web UI for multi-CV activation key display] - https://projects.theforeman.org/issues/37861[#37861]
* pass:[Pagination component navigation within content view details pages does not function properly] - https://projects.theforeman.org/issues/37760[#37760]
* pass:[Make distributing archived content view repositories off by default] - https://projects.theforeman.org/issues/37006[#37006]

=== Errata Management

* pass:[Bold "Skip dependency solving for a significant speed increase" on incremental update page] - https://projects.theforeman.org/issues/37839[#37839]

=== Foreman Proxy Content

* pass:[Granular content counting on the UI] - https://projects.theforeman.org/issues/37945[#37945]
* pass:[If a smart proxy sync task fails in plan, for_resource helper does not work] - https://projects.theforeman.org/issues/37820[#37820]

=== Host Collections

* pass:[Issues when using Host Collection membership Management, the number of content hosts is not accurate] - https://projects.theforeman.org/issues/37934[#37934]

=== Hosts

* pass:[Katello tries to update the deleted Candlepin consumer during force register after deleting certificates] - https://projects.theforeman.org/issues/37966[#37966]
* pass:[As a user, I can see image-mode hosts' current and future image, manifest, tag via API] - https://projects.theforeman.org/issues/37888[#37888]
* pass:[getting hosts list performs redundantly huge query over duplicated host IDs] - https://projects.theforeman.org/issues/37842[#37842]
* pass:[Package profile is not updated when overriding reposet to enabled] - https://projects.theforeman.org/issues/37831[#37831]
* pass:[Registration without environments or environment_id param causes NoMethodError] - https://projects.theforeman.org/issues/37829[#37829]
* pass:[Large table titles show in All Hosts wizards] - https://projects.theforeman.org/issues/37788[#37788]
* pass:[Hammer host update false positive when assigning multiple environments] - https://projects.theforeman.org/issues/37772[#37772]
* pass:[Registration without environments or environment_id param causes NoMethodError] - https://projects.theforeman.org/issues/37763[#37763]
* pass:[Remote execution controller still uses old job invocation form] - https://projects.theforeman.org/issues/37728[#37728]
* pass:[Package update chooses latest version instead of input version] - https://projects.theforeman.org/issues/37072[#37072]

=== Repositories

* pass:[Upgrade Pulp Container to 2.22] - https://projects.theforeman.org/issues/37973[#37973]
* pass:[Upgrade Pulpcore to 3.63 and plugins] - https://projects.theforeman.org/issues/37950[#37950]
* pass:[Support on-demand for file repos] - https://projects.theforeman.org/issues/37929[#37929]
* pass:[Add RHEL 9 AppStream and BaseOS EUS repos under Recommeded Repositories ] - https://projects.theforeman.org/issues/37916[#37916]
* pass:[ Add to manifest lists and index is-bootable, is-flatpak, labels, and annotations fields ] - https://projects.theforeman.org/issues/37887[#37887]
* pass:[Org deletion fails if there are container repositories present] - https://projects.theforeman.org/issues/37863[#37863]
* pass:[Add depth option for OSTree repository type] - https://projects.theforeman.org/issues/37853[#37853]
* pass:[Update recommend repositories for RHEL 7 on Satellite GUI and add new client tools repo] - https://projects.theforeman.org/issues/37840[#37840]
* pass:[Active Only checkbox on Sync Status page does not work] - https://projects.theforeman.org/issues/37827[#37827]
* pass:[Creating a repository with duplicate name fails with confusing error] - https://projects.theforeman.org/issues/37822[#37822]
* pass:[Pagination broken on Redhat repos page and generic content tables] - https://projects.theforeman.org/issues/37777[#37777]
* pass:["Remove Repositories" button not shown for non-admin users with "destroy_repositories" permission] - https://projects.theforeman.org/issues/37732[#37732]
* pass:[No one needs migrated_pulp3_href on content tables anymore] - https://projects.theforeman.org/issues/36874[#36874]
* pass:[Container image manifests synced without tags triggers "no content added"] - https://projects.theforeman.org/issues/36404[#36404]
* pass:[Replace simple publisher with structured publisher for Debian Repositories] - https://projects.theforeman.org/issues/35959[#35959]

=== Roles and Permissions

* pass:[Improve the error message when listing/viewing capsules via API w/o permissions] - https://projects.theforeman.org/issues/37816[#37816]

=== Subscriptions

* pass:[Installed products report fails with Jail issue for #purpose_role and #purpose_usage] - https://projects.theforeman.org/issues/37921[#37921]
* pass:[Unable to change the system purpose for the hypervisor.] - https://projects.theforeman.org/issues/37899[#37899]
* pass:[Subscriptions page can retrieve stale manifest expiration date in certain situations] - https://projects.theforeman.org/issues/37832[#37832]
* pass:[Down migration in AddConvert2rhelToHostFacets has wrong table name for subscription facets] - https://projects.theforeman.org/issues/37815[#37815]
* pass:[Reuse the Foreman client SSL settings for Candlepin] - https://projects.theforeman.org/issues/30368[#30368]

=== Tooling

* pass:[ Upgrade theforeman-rubocop gem to the v0.1.0] - https://projects.theforeman.org/issues/37517[#37517]

=== Web UI

* pass:[Send events on angular translation load] - https://projects.theforeman.org/issues/37858[#37858]
* pass:[Managing errata from content hosts page disturbs Satellite web page alignment] - https://projects.theforeman.org/issues/37845[#37845]
* pass:[Align deb-package details with rpm-package details] - https://projects.theforeman.org/issues/37794[#37794]
* pass:[Refactor deprecated jquery functions] - https://projects.theforeman.org/issues/37671[#37671]
30 changes: 28 additions & 2 deletions guides/doc-Release_Notes/topics/katello.adoc
Original file line number Diff line number Diff line change
Expand Up @@ -4,12 +4,38 @@
[id="katello-headline-features"]
== Headline Features

There are no highlights with Katello {KatelloVersion}.
=== Granular Smart Proxy Content Counts

You can now update smart proxy content counts per lifecycle environment and per content view.
Smart proxy auto-syncs will now update only the lifecycle environment rather than all counts.
A substantial performance improvement is expected.

=== Multiple content view environments for hosts and activation keys

Hosts and (new in 4.15) activation keys can now be associated with multiple content view environments. To use this feature, turn on the allow_multiple_content_views Setting.
Copy link
Member

Choose a reason for hiding this comment

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

Suggested change
Hosts and (new in 4.15) activation keys can now be associated with multiple content view environments. To use this feature, turn on the allow_multiple_content_views Setting.
Hosts and (new in 4.15) activation keys can now be associated with multiple content view environments. To use this feature, turn on the `allow_multiple_content_views` Setting.

Multi-environment hosts and activation keys are displayed in the web UI, but currently can only be changed via Hammer. Use the new --content-view-environments or --content-view-environment-ids options in hammer activation-key create and hammer activation-key update.
Copy link
Member

Choose a reason for hiding this comment

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

Suggested change
Multi-environment hosts and activation keys are displayed in the web UI, but currently can only be changed via Hammer. Use the new --content-view-environments or --content-view-environment-ids options in hammer activation-key create and hammer activation-key update.
Multi-environment hosts and activation keys are displayed in the web UI, but currently can only be changed via Hammer. Use the new `--content-view-environments` or `--content-view-environment-ids` options in `hammer activation-key create` and `hammer activation-key update`.

To display multi-environment hosts in the new All Hosts list page, click 'Manage columns' and add the 'Content view environments' column. The existing content view and lifecycle environment columns will still work, but will only display the host's first content view environment.
Copy link
Member

Choose a reason for hiding this comment

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

Suggested change
To display multi-environment hosts in the new All Hosts list page, click 'Manage columns' and add the 'Content view environments' column. The existing content view and lifecycle environment columns will still work, but will only display the host's first content view environment.
To display multi-environment hosts in the new All Hosts list page, click **Manage columns** and add the **Content view environments** column.
The existing content view and lifecycle environment columns will still work, but will only display the host's first content view environment.

You can also set content view environments from a registered host with subscription-manager environments --set.
You can now view a list of available content view environments with a new Hammer command, hammer content-view-environment list.
Multi-environment information is now displayed in hammer host info and hammer activation-key info.
Copy link
Member

Choose a reason for hiding this comment

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

Suggested change
Multi-environment information is now displayed in hammer host info and hammer activation-key info.
Multi-environment information is now displayed in `hammer host info` and `hammer activation-key info`.

As part of this change, content view and lifecycle environment must be provided together when creating or updating activation keys. You can no longer assign only a content view or only a lifecycle environment.

=== Pulpcore upgraded to 3.63

Pulpcore has been upgraded to 3.63, which brings bug fixes and new features that Katello can integrate with.
As an example, the new Pulp Container now has container image compressed size and OS information available for Katello to show.
Copy link
Member

Choose a reason for hiding this comment

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

The RH style guide suggests writing out operating system (see eec780f as well). Perhaps good to apply that?

Suggested change
As an example, the new Pulp Container now has container image compressed size and OS information available for Katello to show.
As an example, the new Pulp Container now has container image compressed size and operating system information available for Katello to show.

Expect integration with this new data sometime in the near future.

=== New depth option for OSTree repositories

When creating OSTree repositories, users can now determine how much of the OSTree commit history gets synced and published.
Select the number of commits by entering a number in the new depth field.

[id="katello-upgrade-warnings"]
== Upgrade Warnings

There are no upgrade warnings with Katello {KatelloVersion}.
Container content users will want to run 'foreman-maintain advanced procedure run pulpcore-container-handle-image-metadata' to pre-migrate data to avoid a lengthy migration in the future. There will be multiple releases to allow this before it is mandatory.
Copy link
Member

Choose a reason for hiding this comment

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

Suggested change
Container content users will want to run 'foreman-maintain advanced procedure run pulpcore-container-handle-image-metadata' to pre-migrate data to avoid a lengthy migration in the future. There will be multiple releases to allow this before it is mandatory.
Container content users will want to run `foreman-maintain advanced procedure run pulpcore-container-handle-image-metadata` to pre-migrate data to avoid a lengthy migration in the future.
There will be multiple releases to allow this before it is mandatory.

This has been requested before, and it's back because new container manifest data is being made available in Pulp.

[id="katello-deprecations"]
== Deprecations
Expand Down
Loading