Skip to content

Split Administering hosts into multiple assemblies #4758

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.

Sign up for GitHub

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

Open
aneta-petrova wants to merge 1 commit into
base: master
Choose a base branch
from
Open

Split Administering hosts into multiple assemblies #4758

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
1 commit
Select commit
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
57 changes: 0 additions & 57 deletions guides/common/assembly_administering-hosts.adoc
View file
Open in desktop

This file was deleted.

9 changes: 9 additions & 0 deletions guides/common/assembly_configuring-tracer-and-application-restarts-on-hosts.adoc
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -0,0 +1,9 @@
:_mod-docs-content-type: ASSEMBLY

Check warning on line 1 in guides/common/assembly_configuring-tracer-and-application-restarts-on-hosts.adoc

View workflow job for this annotation

GitHub Actions / lint DITA 

[vale] reported by reviewdog 🐶
[AsciiDocDITA.DocumentTitle] The document title (a level 0 heading) is missing.

Raw Output:
{"message": "[AsciiDocDITA.DocumentTitle] The document title (a level 0 heading) is missing.", "location": {"path": "guides/common/assembly_configuring-tracer-and-application-restarts-on-hosts.adoc", "range": {"start": {"line": 1, "column": 1}}}, "severity": "WARNING"}

Check warning on line 1 in guides/common/assembly_configuring-tracer-and-application-restarts-on-hosts.adoc

View workflow job for this annotation

GitHub Actions / lint DITA 

[vale] reported by reviewdog 🐶
[AsciiDocDITA.ShortDescription] Assign [role="_abstract"] to a paragraph to use it as <shortdesc> in DITA.

Raw Output:
{"message": "[AsciiDocDITA.ShortDescription] Assign [role=\"_abstract\"] to a paragraph to use it as \u003cshortdesc\u003e in DITA.", "location": {"path": "guides/common/assembly_configuring-tracer-and-application-restarts-on-hosts.adoc", "range": {"start": {"line": 1, "column": 1}}}, "severity": "WARNING"}

include::modules/con_configuring-tracer-and-application-restarts-on-hosts.adoc[]

ifdef::katello,orcharhino,satellite[]
Copy link
Copy Markdown
Contributor

@maximiliankolb maximiliankolb Apr 9, 2026

Choose a reason for hiding this comment

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

I wonder if we should hide the whole assembly from foreman-el/foreman-deb? Is the concept module on its own of any value?

Copy link
Copy Markdown
Contributor

@Lennonka Lennonka Apr 9, 2026

Choose a reason for hiding this comment

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

+1

include::modules/proc_configuring-tracer-on-a-host.adoc[leveloffset=+1]

include::modules/proc_restarting-applications-on-a-host.adoc[leveloffset=+1]
endif::[]
15 changes: 15 additions & 0 deletions guides/common/assembly_managing-host-content-settings-and-system-purpose.adoc
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -0,0 +1,15 @@
:_mod-docs-content-type: ASSEMBLY

Check warning on line 1 in guides/common/assembly_managing-host-content-settings-and-system-purpose.adoc

View workflow job for this annotation

GitHub Actions / lint DITA 

[vale] reported by reviewdog 🐶
[AsciiDocDITA.ShortDescription] Assign [role="_abstract"] to a paragraph to use it as <shortdesc> in DITA.

Raw Output:
{"message": "[AsciiDocDITA.ShortDescription] Assign [role=\"_abstract\"] to a paragraph to use it as \u003cshortdesc\u003e in DITA.", "location": {"path": "guides/common/assembly_managing-host-content-settings-and-system-purpose.adoc", "range": {"start": {"line": 1, "column": 1}}}, "severity": "WARNING"}

Check warning on line 1 in guides/common/assembly_managing-host-content-settings-and-system-purpose.adoc

View workflow job for this annotation

GitHub Actions / lint DITA 

[vale] reported by reviewdog 🐶
[AsciiDocDITA.DocumentTitle] The document title (a level 0 heading) is missing.

Raw Output:
{"message": "[AsciiDocDITA.DocumentTitle] The document title (a level 0 heading) is missing.", "location": {"path": "guides/common/assembly_managing-host-content-settings-and-system-purpose.adoc", "range": {"start": {"line": 1, "column": 1}}}, "severity": "WARNING"}

include::modules/con_managing-host-content-settings-and-system-purpose.adoc[]

include::modules/proc_editing-the-system-purpose-of-a-host-by-using-web-ui.adoc[leveloffset=+1]

include::modules/proc_editing-the-system-purpose-of-a-host-by-using-cli.adoc[leveloffset=+1]

include::modules/proc_editing-the-system-purpose-of-multiple-hosts.adoc[leveloffset=+1]

include::modules/proc_changing-the-module-stream-for-a-host.adoc[leveloffset=+1]

include::modules/proc_enabling-custom-repositories-on-hosts.adoc[leveloffset=+1]

include::modules/proc_changing-the-content-source-of-a-host.adoc[leveloffset=+1]
13 changes: 13 additions & 0 deletions guides/common/assembly_managing-host-placement-and-associations.adoc
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -0,0 +1,13 @@
:_mod-docs-content-type: ASSEMBLY

Check warning on line 1 in guides/common/assembly_managing-host-placement-and-associations.adoc

View workflow job for this annotation

GitHub Actions / lint DITA 

[vale] reported by reviewdog 🐶
[AsciiDocDITA.ShortDescription] Assign [role="_abstract"] to a paragraph to use it as <shortdesc> in DITA.

Raw Output:
{"message": "[AsciiDocDITA.ShortDescription] Assign [role=\"_abstract\"] to a paragraph to use it as \u003cshortdesc\u003e in DITA.", "location": {"path": "guides/common/assembly_managing-host-placement-and-associations.adoc", "range": {"start": {"line": 1, "column": 1}}}, "severity": "WARNING"}

Check warning on line 1 in guides/common/assembly_managing-host-placement-and-associations.adoc

View workflow job for this annotation

GitHub Actions / lint DITA 

[vale] reported by reviewdog 🐶
[AsciiDocDITA.DocumentTitle] The document title (a level 0 heading) is missing.

Raw Output:
{"message": "[AsciiDocDITA.DocumentTitle] The document title (a level 0 heading) is missing.", "location": {"path": "guides/common/assembly_managing-host-placement-and-associations.adoc", "range": {"start": {"line": 1, "column": 1}}}, "severity": "WARNING"}

include::modules/con_managing-host-placement-and-associations.adoc[]

include::modules/proc_associating-a-virtual-machine-from-a-hypervisor.adoc[leveloffset=+1]

include::modules/proc_disassociating-a-virtual-machine-without-removing-it-from-a-hypervisor.adoc[leveloffset=+1]

include::modules/proc_assigning-a-host-to-a-specific-organization.adoc[leveloffset=+1]

include::modules/proc_assigning-a-host-to-a-specific-location.adoc[leveloffset=+1]

include::modules/proc_changing-the-environment-of-a-host.adoc[leveloffset=+1]
11 changes: 11 additions & 0 deletions guides/common/assembly_managing-host-records-in-project.adoc
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -0,0 +1,11 @@
:_mod-docs-content-type: ASSEMBLY

Check warning on line 1 in guides/common/assembly_managing-host-records-in-project.adoc

View workflow job for this annotation

GitHub Actions / lint DITA 

[vale] reported by reviewdog 🐶
[AsciiDocDITA.ShortDescription] Assign [role="_abstract"] to a paragraph to use it as <shortdesc> in DITA.

Raw Output:
{"message": "[AsciiDocDITA.ShortDescription] Assign [role=\"_abstract\"] to a paragraph to use it as \u003cshortdesc\u003e in DITA.", "location": {"path": "guides/common/assembly_managing-host-records-in-project.adoc", "range": {"start": {"line": 1, "column": 1}}}, "severity": "WARNING"}

Check warning on line 1 in guides/common/assembly_managing-host-records-in-project.adoc

View workflow job for this annotation

GitHub Actions / lint DITA 

[vale] reported by reviewdog 🐶
[AsciiDocDITA.DocumentTitle] The document title (a level 0 heading) is missing.

Raw Output:
{"message": "[AsciiDocDITA.DocumentTitle] The document title (a level 0 heading) is missing.", "location": {"path": "guides/common/assembly_managing-host-records-in-project.adoc", "range": {"start": {"line": 1, "column": 1}}}, "severity": "WARNING"}

include::modules/con_managing-host-records-in-project.adoc[]

include::modules/proc_cloning-hosts.adoc[leveloffset=+1]

include::modules/proc_changing-the-managed-status-of-a-host.adoc[leveloffset=+1]

include::modules/proc_removing-a-host-from-server-by-using-web-ui.adoc[leveloffset=+1]

include::modules/proc_removing-a-host-from-server-by-using-cli.adoc[leveloffset=+1]
7 changes: 7 additions & 0 deletions guides/common/assembly_managing-host-snapshots.adoc
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -0,0 +1,7 @@
:_mod-docs-content-type: ASSEMBLY

Check warning on line 1 in guides/common/assembly_managing-host-snapshots.adoc

View workflow job for this annotation

GitHub Actions / lint DITA 

[vale] reported by reviewdog 🐶
[AsciiDocDITA.DocumentTitle] The document title (a level 0 heading) is missing.

Raw Output:
{"message": "[AsciiDocDITA.DocumentTitle] The document title (a level 0 heading) is missing.", "location": {"path": "guides/common/assembly_managing-host-snapshots.adoc", "range": {"start": {"line": 1, "column": 1}}}, "severity": "WARNING"}

Check warning on line 1 in guides/common/assembly_managing-host-snapshots.adoc

View workflow job for this annotation

GitHub Actions / lint DITA 

[vale] reported by reviewdog 🐶
[AsciiDocDITA.ShortDescription] Assign [role="_abstract"] to a paragraph to use it as <shortdesc> in DITA.

Raw Output:
{"message": "[AsciiDocDITA.ShortDescription] Assign [role=\"_abstract\"] to a paragraph to use it as \u003cshortdesc\u003e in DITA.", "location": {"path": "guides/common/assembly_managing-host-snapshots.adoc", "range": {"start": {"line": 1, "column": 1}}}, "severity": "WARNING"}

include::modules/con_managing-host-snapshots.adoc[]

include::modules/proc_installing-the-snapshot-management-plugin.adoc[leveloffset=+1]

include::modules/proc_creating-snapshots-of-a-host.adoc[leveloffset=+1]
13 changes: 13 additions & 0 deletions guides/common/assembly_reviewing-hosts-in-project-web-ui.adoc
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -0,0 +1,13 @@
:_mod-docs-content-type: ASSEMBLY

include::modules/con_reviewing-hosts-in-project-web-ui.adoc[]

include::modules/con_browsing-hosts-in-web-ui.adoc[leveloffset=+1]

include::modules/proc_selecting-host-columns.adoc[leveloffset=+1]

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

include::modules/proc_displaying-rhel-lifecycle-status.adoc[leveloffset=+1]
endif::[]
7 changes: 0 additions & 7 deletions guides/common/modules/con_administering-hosts.adoc
View file
Open in desktop

This file was deleted.

7 changes: 7 additions & 0 deletions ...es/common/modules/con_configuring-tracer-and-application-restarts-on-hosts.adoc
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -0,0 +1,7 @@
:_mod-docs-content-type: CONCEPT

[id="configuring-tracer-and-application-restarts-on-hosts"]
= Configuring Tracer and application restarts on hosts

[role="_abstract"]
If Tracer is available for your hosts, you can see which services need restarts after package updates and restart them when you choose.
8 changes: 8 additions & 0 deletions guides/common/modules/con_managing-host-content-settings-and-system-purpose.adoc
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -0,0 +1,8 @@
:_mod-docs-content-type: CONCEPT

[id="managing-host-content-settings-and-system-purpose"]
= Managing host content settings and system purpose

[role="_abstract"]
You can set which content source and repositories a host uses and choose module streams for software versions.
You can configure system purpose so subscription usage on the host reflects its role and usage.
8 changes: 8 additions & 0 deletions guides/common/modules/con_managing-host-placement-and-associations.adoc
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -0,0 +1,8 @@
:_mod-docs-content-type: CONCEPT

[id="managing-host-placement-and-associations"]
= Managing host placement and associations

[role="_abstract"]
Use {Project} to link each host to a compute resource, organization, location, and content view environment.
Copy link
Copy Markdown
Contributor

@maximiliankolb maximiliankolb Apr 9, 2026

Choose a reason for hiding this comment

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

This feels very vague to me.

What does "link" mean? You cannot just say "move host A from Azure to GCE". Instead, you'd have to redeploy it and delete the old one. That only works well if you have its configuration as code.

Detach host records when hosts move or retire so your host list stays current.
Copy link
Copy Markdown
Contributor

@maximiliankolb maximiliankolb Apr 9, 2026

Choose a reason for hiding this comment

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

Suggested change
Detach host records when hosts move or retire so your host list stays current.
Detach host records when hosts move or retire so your host list stays current and {Project} no longer tries to manage it.

Unsure about this too. Does detach mean unregister on the Client or mark as unassociated in Foreman/delete in Foreman?

8 changes: 8 additions & 0 deletions guides/common/modules/con_managing-host-records-in-project.adoc
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -0,0 +1,8 @@
:_mod-docs-content-type: CONCEPT

[id="managing-host-records-in-project"]
= Managing host records in {Project}

[role="_abstract"]
You can add a host record by cloning an existing host and choose whether {Project} manages it.
You can remove the record from {ProjectServer} when the system is decommissioned or re-registered elsewhere.
7 changes: 7 additions & 0 deletions guides/common/modules/con_managing-host-snapshots.adoc
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -0,0 +1,7 @@
:_mod-docs-content-type: CONCEPT

[id="managing-host-snapshots"]
= Managing host snapshots

[role="_abstract"]
You can install the snapshot management plugin and create virtual machine snapshots from {Project} to capture a point-in-time state before risky changes.
Copy link
Copy Markdown
Contributor

@maximiliankolb maximiliankolb Apr 9, 2026

Choose a reason for hiding this comment

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

Suggested change
You can install the snapshot management plugin and create virtual machine snapshots from {Project} to capture a point-in-time state before risky changes.
You can install the Snapshot Management plugin and create virtual machine snapshots from {Project} to capture a point-in-time state before risky changes.

10 changes: 10 additions & 0 deletions guides/common/modules/con_reviewing-hosts-in-project-web-ui.adoc
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -0,0 +1,10 @@
:_mod-docs-content-type: CONCEPT

[id="reviewing-hosts-in-project-web-ui"]
= Reviewing hosts in {ProjectWebUI}

[role="_abstract"]
You can review hosts in the {ProjectWebUI} to see them in one place and select the columns you need for daily work.
ifdef::katello,satellite,orcharhino[]
When {RHEL} lifecycle data is available, check it in the same views to plan patches and track compliance.
Copy link
Copy Markdown
Contributor

@maximiliankolb maximiliankolb Apr 9, 2026

Choose a reason for hiding this comment

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

Suggested change
When {RHEL} lifecycle data is available, check it in the same views to plan patches and track compliance.
When {client-os} lifecycle data is available, check it in the same views to plan patches and track compliance.

This affects all Clients.

endif::[]
16 changes: 15 additions & 1 deletion guides/doc-Managing_Hosts/master.adoc
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -9,7 +9,21 @@ ifdef::satellite[]
include::common/modules/proc_providing-feedback-on-red-hat-documentation.adoc[leveloffset=+1]
endif::[]

include::common/assembly_administering-hosts.adoc[leveloffset=+1]
include::common/assembly_reviewing-hosts-in-project-web-ui.adoc[leveloffset=+1]

include::common/assembly_managing-host-placement-and-associations.adoc[leveloffset=+1]

ifdef::katello,orcharhino,satellite[]
include::common/assembly_managing-host-content-settings-and-system-purpose.adoc[leveloffset=+1]
endif::[]

include::common/assembly_managing-host-records-in-project.adoc[leveloffset=+1]

include::common/assembly_configuring-tracer-and-application-restarts-on-hosts.adoc[leveloffset=+1]

ifndef::satellite[]
include::common/assembly_managing-host-snapshots.adoc[leveloffset=+1]
endif::[]

include::common/assembly_working-with-host-groups.adoc[leveloffset=+1]

Expand Down
Loading