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

Fix 3.9 branch commits and add more Katello 4.11 GA info #2644

Merged
merged 22 commits into from
Dec 20, 2023
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
22 commits
Select commit Hold shift + click to select a range
8da52a9
Fix Conversions title
Lennonka Nov 28, 2023
4f59e1b
Make local link into xref
Lennonka Nov 25, 2023
d557951
Add vCenter version requirement
Lennonka Nov 25, 2023
e70c43a
Document keyboard shortcuts
adamlazik1 Nov 16, 2023
262d459
Hide untested VMware vSphere for orcharhino (#2620)
maximiliankolb Dec 4, 2023
ec10303
Remove "the button" wording (#2622)
maximiliankolb Dec 5, 2023
edc37eb
Add fapolicyd to Foreman and Smart Proxy (#2616)
mjivraja Dec 6, 2023
3e943d3
Remove deprecated katello-agent (#2508)
bangelic Dec 6, 2023
15b93c3
Report no longer lists SCA hosts (#2612)
bangelic Nov 28, 2023
b495ca2
Add procedure for refreshing content counts (#2619)
bangelic Dec 7, 2023
35d438d
Use shellscript to add operating systems (#2614)
maximiliankolb Dec 7, 2023
43a2440
RH-supported SCAP contents (#2627)
Lennonka Dec 7, 2023
4867b60
Re-modularize the Monitoring Hosts section (#2555)
mjivraja Dec 7, 2023
c064245
Add expiring RHEL support (#2617)
bangelic Dec 7, 2023
bf0bf9b
Rename life cycle to lifecycle for consistency (#2633)
bangelic Dec 11, 2023
43e1e32
Remove references to Pulpcore module stream for Pulpcore 3.39 (#2597)
ianballou Dec 11, 2023
cbdb0f5
Add lifecycle to path in navigation (#2635)
bangelic Dec 13, 2023
54db9cc
Add Release Notes for Foreman 3.9
Griffin-Sullivan Nov 28, 2023
2827e9b
Add mqtt performance tuning (#2170)
Imaanpreet Dec 18, 2023
e2b199c
Add release notes for Katello 4.11
ianballou Nov 22, 2023
4a3d06e
Add KI BZ#2087067 Puppet fails re-enablement
Lennonka Dec 19, 2023
3eb3c92
Update docs for Katello 4.11.0 GA
ianballou Dec 19, 2023
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Jump to
Jump to file
Failed to load files.
Diff view
Diff view
8 changes: 8 additions & 0 deletions guides/common/assembly_administering-hosts.adoc
Expand Up @@ -59,3 +59,11 @@ include::modules/proc_installing-the-snapshot-management-plugin.adoc[leveloffset

include::modules/proc_creating-snapshots-of-a-managed-host.adoc[leveloffset=+1]
endif::[]

ifdef::katello,satellite,orcharhino[]
include::modules/con_lifecycle-status-of-rhel-hosts.adoc[leveloffset=+1]

include::modules/proc_displaying-rhel-lifecycle-status.adoc[leveloffset=+2]

include::modules/con_host-search-by-rhel-lifecycle-status.adoc[leveloffset=+2]
endif::[]
2 changes: 0 additions & 2 deletions guides/common/assembly_building_cloud-images.adoc
Expand Up @@ -8,8 +8,6 @@ include::modules/proc_configuring-a-host-for-registration.adoc[leveloffset=+1]

include::modules/proc_registering-a-host.adoc[leveloffset=+1]

include::modules/proc_installing-the-katello-agent.adoc[leveloffset=+1]

include::modules/proc_installing-and-configuring-puppet-agent-manually.adoc[leveloffset=+1]

include::modules/proc_completing-the-rhel7-image.adoc[leveloffset=+1]
Expand Down
2 changes: 2 additions & 0 deletions guides/common/assembly_importing-content.adoc
Expand Up @@ -114,6 +114,8 @@ include::modules/proc_changing-the-mirroring-policy-for-a-repository.adoc[levelo

include::modules/proc_uploading-content-to-custom-rpm-repositories.adoc[leveloffset=+1]

include::modules/proc_refreshing-content-counts-on-smart-proxy.adoc[leveloffset=+1]

ifdef::katello,satellite,orcharhino[]
include::modules/proc_configuring-selinux-to-permit-content-synchronization-on-custom-ports.adoc[leveloffset=+1]
endif::[]
Expand Down
4 changes: 4 additions & 0 deletions guides/common/assembly_installing-capsule-server.adoc
Expand Up @@ -25,6 +25,10 @@ ifdef::foreman-el,foreman-deb[]
include::modules/proc_configuring-repositories.adoc[leveloffset=+1]
endif::[]

include::modules/con_using-fapolicyd-on-server.adoc[leveloffset=+1]

include::modules/proc_installing-fapolicyd-on-server.adoc[leveloffset=+2]

// Installing {SmartProxyServer} Packages
include::modules/proc_installing-capsule-server-packages.adoc[leveloffset=+1]

Expand Down
Expand Up @@ -21,6 +21,10 @@ include::modules/proc_configuring-the-base-operating-system-with-offline-reposit

include::modules/proc_installing-from-the-offline-repositories.adoc[leveloffset=+1]

include::modules/con_using-fapolicyd-on-server.adoc[leveloffset=+1]

include::modules/proc_installing-fapolicyd-on-server.adoc[leveloffset=+2]

include::modules/proc_resolving-package-dependency-errors.adoc[leveloffset=+1]

include::modules/proc_synchronizing-the-system-clock-with-chronyd.adoc[leveloffset=+1]
Expand Down
4 changes: 4 additions & 0 deletions guides/common/assembly_installing-server-connected.adoc
Expand Up @@ -55,6 +55,10 @@ endif::[]

include::modules/proc_configuring-repositories.adoc[leveloffset=+1]

include::modules/con_using-fapolicyd-on-server.adoc[leveloffset=+1]

include::modules/proc_installing-fapolicyd-on-server.adoc[leveloffset=+2]

include::modules/proc_installing-the-satellite-server-packages.adoc[leveloffset=+1]

ifdef::foreman-el,katello,satellite[]
Expand Down
13 changes: 0 additions & 13 deletions guides/common/assembly_managing-application-life-cycles.adoc

This file was deleted.

13 changes: 13 additions & 0 deletions guides/common/assembly_managing-application-lifecycles.adoc
@@ -0,0 +1,13 @@
include::modules/con_managing-application-lifecycles.adoc[]

include::modules/con_introduction-to-application-lifecycle.adoc[leveloffset=+1]

include::modules/con_content-promotion-across-the-application-lifecycle.adoc[leveloffset=+1]

include::modules/proc_creating-a-lifecycle-environment-path.adoc[leveloffset=+1]

include::modules/proc_adding-lifecycle-environments.adoc[leveloffset=+1]

include::modules/proc_removing-lifecycle-environments-from-foreman.adoc[leveloffset=+1]

include::modules/proc_removing-lifecycle-environments-from-smart-proxy.adoc[leveloffset=+1]
Expand Up @@ -4,6 +4,14 @@ ifdef::orcharhino[]
include::modules/proc_installing-red-hat-cloud-plug-in.adoc[leveloffset=+1]
endif::[]

include::modules/proc_using-red-hat-insights.adoc[leveloffset=+1]
include::modules/ref_access-to-information-from-insights-in-project.adoc[leveloffset=+1]

include::modules/proc_creating-an-insights-plan-for-hosts.adoc[leveloffset=+1]
include::modules/proc_excluding-hosts-from-rh-cloud-and-insights-client-reports.adoc[leveloffset=+1]

include::modules/proc_deploying-red-hat-insights-using-the-ansible-role.adoc[leveloffset=+1]

include::modules/proc_configuring-synchronization-of-insights-recommendations-for-hosts.adoc[leveloffset=+1]

include::modules/proc_configuring-automatic-removal-of-hosts-from-the-insights-inventory.adoc[leveloffset=+1]

include::modules/proc_creating-an-insights-remediation-plan-for-hosts.adoc[leveloffset=+1]
Expand Up @@ -9,11 +9,6 @@ Use this chapter to configure additional settings on your {SmartProxyServer}.
// Configuring SmartProxy for Host Registration and Provisioning
include::modules/proc_configuring-smart-proxy-for-host-registration-and-provisioning.adoc[leveloffset=+1]

ifdef::katello,orcharhino,satellite[]
// Enabling Katello Agent Infrastructure
include::modules/proc_enabling-katello-agent.adoc[leveloffset=+1]
endif::[]

ifdef::foreman-el,foreman-deb,katello[]
include::modules/proc_enabling-remote-execution.adoc[leveloffset=+1]
endif::[]
Expand All @@ -28,8 +23,8 @@ include::modules/proc_enabling-openscap.adoc[leveloffset=+1]
endif::[]

ifdef::katello,satellite[]
// Adding Life Cycle Environments to {SmartProxyServers}
include::modules/proc_adding-life-cycle-environments.adoc[leveloffset=+1]
// Adding Lifecycle Environments to {SmartProxyServers}
include::modules/proc_adding-lifecycle-environments.adoc[leveloffset=+1]
endif::[]

// Enabling Power Management on Managed Hosts
Expand Down
2 changes: 0 additions & 2 deletions guides/common/assembly_registering-hosts.adoc
Expand Up @@ -43,8 +43,6 @@ include::modules/proc_providing-an-alternative-fqdn-for-the-host.adoc[leveloffse
endif::[]

// Host tools
include::modules/proc_installing-the-katello-agent.adoc[leveloffset=+1]

include::modules/proc_installing-tracer.adoc[leveloffset=+1]

include::modules/proc_installing-and-configuring-puppet-agent-during-host-registration.adoc[leveloffset=+1]
Expand Down
2 changes: 2 additions & 0 deletions guides/common/assembly_searching-and-bookmarking.adoc
Expand Up @@ -15,3 +15,5 @@ include::modules/con_managing-bookmarks.adoc[leveloffset=+1]
include::modules/proc_creating-bookmarks.adoc[leveloffset=+2]

include::modules/proc_deleting-bookmarks.adoc[leveloffset=+2]

include::modules/con_using-keyboard-shortcuts.adoc[leveloffset=+1]
1 change: 0 additions & 1 deletion guides/common/attributes-foreman-el.adoc
@@ -1,7 +1,6 @@
// Overrides for foreman-el build
:install-on-os: CentOS/RHEL
:dnf-module: foreman:el8
:dnf-modules: {dnf-module}

// Some documents are not ready for stable releases, but can be published on nightly
ifeval::["{DocState}" != "nightly"]
Expand Down
1 change: 0 additions & 1 deletion guides/common/attributes-katello.adoc
Expand Up @@ -3,7 +3,6 @@
:client-content-apt:
:client-content-zypper:
:dnf-module: katello:el8
:dnf-modules: {dnf-module} pulpcore:el8
:foreman-installer-package: foreman-installer-katello
:installer-log-file: /var/log/foreman-installer/katello.log
:installer-scenario-smartproxy: foreman-installer --scenario foreman-proxy-content
Expand Down
1 change: 0 additions & 1 deletion guides/common/attributes-orcharhino.adoc
Expand Up @@ -36,7 +36,6 @@
:customssl: custom SSL
:customssltitle: Custom SSL
:dnf-module: orcharhino:el8
:dnf-modules: {dnf-module}
:foreman-example-com: orcharhino.example.com
:installer-log-file: /var/log/foreman-installer/katello.log
:installer-scenario-smartproxy: orcharhino-installer --no-enable-foreman
Expand Down
3 changes: 1 addition & 2 deletions guides/common/attributes-satellite.adoc
Expand Up @@ -31,7 +31,7 @@
:APIDocURL: {BaseURL}api_guide/index#
:HammerDocURL: {BaseURL}hammer_cli_guide/index#
:ConfiguringVMSubscriptionsDocURL: {BaseURL}configuring_virtual_machine_subscriptions_in_red_hat_satellite/index#
:ConversionsToolkitDocURL: {BaseURL}converting_hosts_to_rhel_by_using_conversions_toolkit/index#
:ConversionsToolkitDocURL: {BaseURL}converting_hosts_to_rhel_by_using_satellite_conversions_toolkit/index#

// Overrides for satellite build
:ansible-collection-package: ansible-collection-redhat-satellite
Expand Down Expand Up @@ -147,4 +147,3 @@
:project-client-RHEL7-url: {RepoRHEL7ServerSatelliteToolsProjectVersion}
:project-client-RHEL8-url: {RepoRHEL8ServerSatelliteToolsProjectVersion}
:dnf-module: satellite:el8
:dnf-modules: {dnf-module}
2 changes: 1 addition & 1 deletion guides/common/attributes-titles.adoc
Expand Up @@ -32,7 +32,7 @@
:APIDocTitle: API Guide
:HammerDocTitle: Hammer CLI Guide
:ConfiguringVMSubscriptionsDocTitle: Configuring Virtual Machine Subscriptions in {ProjectName}
:ConversionsToolkitDocTitle: Converting Hosts to RHEL by Using Conversions Toolkit
:ConversionsToolkitDocTitle: Converting Hosts to RHEL by Using Satellite Conversions Toolkit

// Overrides for titles per product

Expand Down
6 changes: 0 additions & 6 deletions guides/common/modules/con_applying-errata-to-hosts.adoc
Expand Up @@ -13,10 +13,4 @@ For more information, see {ManagingHostsDocURL}Registering_Hosts_managing-hosts[
* Configure the host for remote execution.
For more information about running remote execution jobs, see {ManagingHostsDocURL}Configuring_and_Setting_Up_Remote_Jobs_managing-hosts[Configuring and Setting Up Remote Jobs] in _{ManagingHostsDocTitle}_.

[NOTE]
====
If the host is already configured to receive content updates with the deprecated Katello Agent, migrate to remote execution instead.
For more information, see {ManagingHostsDocURL}Migrating_Hosts_From_Katello_Agent_to_Remote_Execution_managing-hosts[Migrating From Katello Agent to Remote Execution] in _{ManagingHostsDocTitle}_.
====

The procedure to apply an erratum to a managed host depends on its operating system.
Expand Up @@ -42,7 +42,7 @@ For more information, see xref:Configuring_Keycloak_Authentication_with_CAC_Card
endif::[]

As well as providing access to {ProjectServer}, hosts provisioned with {Project} can also be integrated with {FreeIPA} realms.
{ProjectName} has a realm feature that automatically manages the life cycle of any system registered to a realm or domain provider.
{ProjectName} has a realm feature that automatically manages the lifecycle of any system registered to a realm or domain provider.
For more information, see xref:External_Authentication_for_Provisioned_Hosts_{context}[].

.Authentication Overview
Expand Down
Expand Up @@ -8,6 +8,6 @@ endif::[]

A host collection is a group of content hosts.
This feature enables you to perform the same action on multiple hosts at once.
These actions can include the installation, removal, and update of packages and errata, change of assigned life cycle environment, and change of Content View.
These actions can include the installation, removal, and update of packages and errata, change of assigned lifecycle environment, and change of Content View.
You can create host collections to suit your requirements, and those of your company.
For example, group hosts in host collections by function, department, or business unit.
@@ -1,17 +1,17 @@
[id="Content_Promotion_across_the_Application_Life_Cycle_{context}"]
= Content Promotion across the Application Life Cycle
[id="Content_Promotion_across_the_Application_Lifecycle_{context}"]
= Content Promotion across the Application Lifecycle

In the application life cycle chain, when content moves from one environment to the next, this is called _promotion_.
In the application lifecycle chain, when content moves from one environment to the next, this is called _promotion_.

.Example Content Promotion Across {Project} Life Cycle Environments
.Example Content Promotion Across {Project} Lifecycle Environments

Each environment contains a set of systems registered to {ProjectName}.
These systems only have access to repositories relevant to their environment.
When you promote packages from one environment to the next, the target environment's repositories receive new package versions.
As a result, each system in the target environment can update to the new package versions.

ifndef::satellite[]
This example uses a `.{client-pkg-ext}` package, but you can promote any type of content across the application life cycle.
This example uses a `.{client-pkg-ext}` package, but you can promote any type of content across the application lifecycle.
endif::[]

|===
Expand All @@ -21,7 +21,7 @@ endif::[]
|===

After completing development on the patch, you promote the package to the Testing environment so the Quality Engineering team can review the patch.
The application life cycle then contains the following package versions in each environment:
The application lifecycle then contains the following package versions in each environment:

|===
| Development | Testing | Production
Expand All @@ -30,7 +30,7 @@ The application life cycle then contains the following package versions in each
|===

While the Quality Engineering team reviews the patch, the Development team starts work on _example_software_ 2.0.
This results in the following application life cycle:
This results in the following application lifecycle:

|===
| Development | Testing | Production
Expand Down
2 changes: 1 addition & 1 deletion guides/common/modules/con_download-policies-overview.adoc
Expand Up @@ -26,7 +26,7 @@ endif::[]
ifndef::satellite[]
The lazy synchronization feature must be used only for `deb` and `yum` repositories.
endif::[]
You can add the packages to Content Views and promote to life cycle environments as normal.
You can add the packages to Content Views and promote to lifecycle environments as normal.

{SmartProxyServer} has the following policies:

Expand Down
Expand Up @@ -2,4 +2,4 @@
= Examples of Using Granular Permission Filters

As an administrator, you can allow selected users to make changes in a certain part of the environment path.
The following filter allows you to work with content while it is in the development stage of the application life cycle, but the content becomes inaccessible once is pushed to production.
The following filter allows you to work with content while it is in the development stage of the application lifecycle, but the content becomes inaccessible once is pushed to production.
@@ -0,0 +1,12 @@
[id="host_search_by_rhel_lifecycle_status_{context}"]
= Host Search by RHEL Lifecycle Status

You can use the *Search* field to search hosts by `rhel_lifecycle_status`.
It can have one of the following values:

* `full_support`
* `maintenance_support`
* `approaching_end_of_maintenance`
* `extended_support`
* `approaching_end_of_support`
* `support_ended`

This file was deleted.

@@ -0,0 +1,44 @@
[id="introduction_to_application_lifecycle_{context}"]
= Introduction to Application Lifecycle

The _application lifecycle_ is a concept central to {Project}'s content management functions.
The application lifecycle defines how a particular system and its software look at a particular stage.
For example, an application lifecycle might be simple; you might only have a development stage and production stage.
In this case the application lifecycle might look like this:

* Development
* Production

However, a more complex application lifecycle might have further stages, such as a phase for testing or a beta release.
This adds extra stages to the application lifecycle:

* Development
* Testing
* Beta Release
* Production

{Project} provides methods to customize each application lifecycle stage so that it suits your specifications.

Each stage in the application lifecycle is called an _environment_ in {Project}.
Each environment uses a specific collection of content.
{Project} defines these content collections as a Content View.
Each Content View acts as a filter where you can define what repositories, and packages to include in a particular environment.
This provides a method for you to define specific sets of content to designate to each environment.

For example, an email server might only require a simple application lifecycle where you have a production-level server for real-world use and a test server for trying out the latest mail server packages.
When the test server passes the initial phase, you can set the production-level server to use the new packages.

Another example is a development lifecycle for a software product.
To develop a new piece of software in a development environment, test it in a quality assurance environment, pre-release as a beta, then release the software as a production-level application.

ifdef::katello[]
image::application-lifecycle.png[title="The {Project} Application Lifecycle", alt="The {Project} Application Lifecycle"]
endif::[]

ifdef::satellite[]
image::application-lifecycle-satellite.png[title="The {Project} Application Lifecycle", alt="The {Project} Application Lifecycle"]
endif::[]

ifdef::orcharhino[]
image::application-lifecycle-orcharhino.svg[title="The {Project} Application Lifecycle", alt="The {Project} Application Lifecycle"]
endif::[]
Expand Up @@ -4,10 +4,10 @@
In the context of {Project}, _content_ is defined as the software installed on systems.
This includes, but is not limited to, the base operating system, middleware services, and end-user applications.
ifdef::satellite[]
With {ProjectName}, you can manage the various types of content for {RHEL} systems at every stage of the software life cycle.
With {ProjectName}, you can manage the various types of content for {RHEL} systems at every stage of the software lifecycle.
endif::[]
ifndef::satellite[]
With {Project}, you can manage the various types of content at every stage of the software life cycle.
With {Project}, you can manage the various types of content at every stage of the software lifecycle.
endif::[]

ifdef::foreman-el,katello[]
Expand Down